إذا كنت قادمًا من @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 v3 بالأسماء المعتمدة على الأصناف (classes) المذكورة أعلاه — Connection وKeypair وTransaction وPublicKey — كطبقات تغليف خفيفة فوق المكونات الداخلية لـ Kit، لذا فإن عمود Kit يصف أيضًا ما تقوم به هذه الأصناف في الخلفية في الإصدار 3.
قادم من web3.js؟
إذا كنت تتولى صيانة قاعدة شيفرة كبيرة تعتمد على @solana/web3.js (القديمة) وكانت إعادة الكتابة الكاملة
إلى Kit غير عملية، فإن web3.js v3 هي الجسر المناسب. ثبّتها باستخدام
@solana/web3.js@3. فهي تعيد بناء واجهة برمجة التطبيقات الكلاسيكية المعتمدة على الأصناف — Connection و
Keypair وTransaction وPublicKey — فوق المكونات الداخلية لـ @solana/kit.
ولأنها تعتمد على Kit، فإن التوافق معه وثيق: فـ PublicKey هو نوع العنوان الأساسي
وتُرجع الدالة .toBase58() الخاصة به سلسلة Address الموسومة (branded) من 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?