الترحيل إلى Kit

إذا كنت قادمًا من @solana/web3.js (الإصدار القديم)، أو @solana/wallet-adapter-*، أو حزم framework-kit السابقة (@solana/client، @solana/react-hooks، @solana/web3-compat)، فنحن نشجعك على الانتقال إلى إضافات @solana/kit أو @solana/web3.js الإصدار 3 (أو أعلى).

تربط هذه الصفحة المفاهيم التي تعرفها بالفعل بما يعادلها في Kit.

تعيين المفاهيم

web3.js (الإصدار القديم) / wallet-adapterKit
new Connection(url)createSolanaRpc(url)، أو .use(solanaRpc({ rpcUrl })) على العميل
PublicKeyAddress — حوّل سلسلة نصية باستخدام address("...")
KeypairgenerateKeyPairSigner() أو إضافات @solana/kit-plugin-signer
SystemProgram.transfer(...)getTransferSolInstruction(...) من @solana-program/system
LAMPORTS_PER_SOL mathlamports(...) من @solana/kit
Transaction / VersionedTransactionرسائل المعاملات يبنيها ويحزمها مخطط المعاملات
sendAndConfirmTransaction(...)client.sendTransaction([...]) (يوقّع المخطط ويرسل ويؤكد)
@solana/wallet-adapter-*@solana/kit-plugin-wallet + اكتشاف Wallet Standard

يحتفظ web3.js الإصدار 3 بالأسماء القائمة على الفئات المذكورة أعلاه — Connection وKeypair و Transaction وPublicKey — كطبقات تغليف رقيقة فوق المكوّنات الداخلية لـ Kit، لذا فإن عمود Kit يصف أيضًا ما تفعله هذه الفئات خلف الكواليس في الإصدار 3.

قادم من web3.js؟

إذا كنت تدير قاعدة شيفرة كبيرة تعتمد على @solana/web3.js (الإصدار القديم) وكانت إعادة الكتابة الكاملة إلى Kit غير عملية، فإن web3.js الإصدار 3 هو الجسر المناسب. ثبّته باستخدام @solana/web3.js@3. فهو يعيد بناء واجهة برمجة التطبيقات الكلاسيكية القائمة على الفئات — Connection و Keypair وTransaction وPublicKey — فوق المكوّنات الداخلية لـ @solana/kit. ولأنه مبني على Kit، فإن قابلية التشغيل البيني وثيقة: إذ يُعد PublicKey نوع العنوان الأساسي وتعيد الدالة .toBase58() الخاصة به سلسلة Address الموسومة من Kit، كما يطبّق Keypair في الإصدار 3 الواجهة KeyPairSigner من Kit، لذا يمكنك تمريره مباشرةً إلى واجهات Kit البرمجية والإضافات والعملاء المولَّدين بواسطة Codama.

معاملات v1 وweb3.js (الإصدار القديم)

إذا كنت ترسل معاملات v1 باستخدام web3.js، فيجب عليك استخدام الإصدار 3 أو أحدث.

للاطلاع على الترحيل نفسه، راجع دليل الترحيل الرسمي من web3.js v1 إلى v3.

المحافظ

لا يستخدم Kit محوّل المحفظة (wallet-adapter). يكتشف @solana/kit-plugin-wallet المحافظ المتوافقة مع Wallet Standard ويعرضها من خلال client.wallet وReact hooks. تُعلن المحافظ الحديثة (Phantom وSolflare وBackpack وغيرها) عن نفسها عبر Wallet Standard، لذا لا حاجة إلى حزمة محوّل خاصة بكل محفظة.

يمكنك أيضاً استخدام أدوات جاهزة مثل @solana/connector، التي تستخدم مكوّنات Kit الأساسية مباشرةً للاتصال بالمحافظ.

لا تزال تستخدم wallet-adapter؟

إذا كنت تُدير تطبيقاً مبنياً على @solana/wallet-adapter-* ولست مستعداً للترحيل، يظل مستودع wallet-adapter المرجعَ الأساسي لتلك البنية. لأي مشروع جديد، يُفضَّل استخدام مكوّن Kit للمحافظ.

إلى أين تتجه بعد ذلك

  • عميل Kit — قم بتجميع عميل من المكوّنات الإضافية.
  • React — روابط @solana/react وخطافات المحافظ.
  • درس Next.js — تطبيق كامل من البداية إلى النهاية.

Is this page helpful?

جدول المحتويات

تعديل الصفحة