إذا كنت قادمًا من @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-adapter | Kit |
|---|---|
new Connection(url) | createSolanaRpc(url)، أو .use(solanaRpc({ rpcUrl })) على العميل |
PublicKey | Address — حوّل سلسلة نصية باستخدام address("...") |
Keypair | generateKeyPairSigner() أو إضافات @solana/kit-plugin-signer |
SystemProgram.transfer(...) | getTransferSolInstruction(...) من @solana-program/system |
LAMPORTS_PER_SOL math | lamports(...) من @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?