إذا كنت قادمًا من @solana/web3.js (الإصدار الأول)، أو
@solana/wallet-adapter-*، أو حزم framework-kit السابقة (@solana/client،
@solana/react-hooks، @solana/web3-compat)، فقد تم استبدال تلك الأساليب. تبني
التطبيقات الجديدة مباشرةً على @solana/kit وإضافات Kit. تقوم هذه الصفحة بتعيين
المفاهيم التي تعرفها بالفعل إلى مكافئاتها في Kit.
تعيين المفاهيم
| web3.js v1 / 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؟
إذا كنت تمتلك قاعدة بيانات كود ضخمة من @solana/web3.js الإصدار الأول وإعادة
الكتابة الكاملة إلى Kit ليست عملية حتى الآن، فإن web3.js v3 هو الجسر. يُشحن
حاليًا بوصفه @solana/web3.js@rc (سلسلة 3.0.0-rc) ويُعيد بناء واجهة برمجة
التطبيقات الكلاسيكية القائمة على الفئات — Connection، Keypair، Transaction
— فوق البنية الداخلية لـ @solana/kit. نظرًا لاستناده إلى Kit، فإن التشغيل
البيني وثيق: PublicKey هو اسم مستعار مهمل لـ Address، كما أن Keypair في v3
يستوفي هيكليًا شرط Kit KeyPairSigner، لذا يمكنك تمريره مباشرةً إلى واجهات
برمجة Kit والإضافات والعملاء المولّدين بواسطة Codama.
لا يزال v3 في مرحلة مرشح الإصدار — ثبّت الإصدارات الدقيقة وتوقع بعض التغييرات في واجهة برمجة التطبيقات بين مرشحي الإصدار. إنه مسار تشغيل بيني مع الإصدارات القديمة، وليس الخيار الافتراضي للعمل الجديد؛ يجب أن تبني التطبيقات الجديدة مباشرةً على Kit. للتعمق في عملية الترحيل، راجع دليل الترحيل الرسمي من 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?