6. الرموز على الجانبين
كيف يظهر رمز SPL واحد كغلاف ERC-20 لمحافظ EVM وكحساب رمز لمحافظ سولانا، والمنح لمرة واحدة التي تسمح للعقود بتحريكه.
الرموز هي أساس كل حالة استخدام في 2. ما الذي يمكنك بناؤه: فالمجمّع أو الخزنة أو سوق الإقراض كلها تتعامل مع الأصل نفسه الذي تحتفظ به محافظ Solana. يعرِض غلاف SPL عملية سكّ SPL عبر واجهة ERC-20. بالنسبة إلى الرموز التي تحتفظ بها محفظة، يقرأ الغلاف الرصيد من حساب الرموز المشتق من Rome الخاص بالمحفظة، لذا ترى Solana وSolidity الرصيد نفسه. يشرح هذا الدرس كيف يعمل ذلك وتفويضًا واحدًا يجب على كل مستخدم منحه قبل أن يتمكن عقدك من نقل رموزه.
ما ستتعلّمه
كيف يعرِض غلاف SPL رصيد رموز Solana الخاص بالمحفظة عبر أساليب ERC-20.
ماذا يفعل المصنع والغلاف، وأي غلاف يجب استخدامه.
كيف تختلف الرموز التي تحتفظ بها العقود عن الرموز التي تحتفظ بها المحافظ.
التفويض لمرة واحدة
approve_spl، وكيفية التحقق منه وكيف يَفشل.
قبل أن تبدأ
أنهِ 5. استدعِ سولانا من Solidity. تحتاج إلى فكرة PDA للسلطة الخارجية وHelper precompile.
امتلك محفظة Hadrian ممولة وعقدًا منشورًا. عناوين الأغلفة القياسية موجودة في
tokens.jsonفي السجل: الإدخال الذي يحتوي علىkind: "spl_wrapper"والرمزwUSDC. هادريان يرتبط بمجلد سجل السلسلة.حساب رموز USDC الذي أنشأته باستخدام
createMyAtaفي الدرس 5. يحتاج التفويض إلى أن يكون موجودًا.
رصيد واحد، ورؤيتان
لكل عنوان EVM PDA للسلطة الخارجية على Solana، ويمتلك ذلك الـPDA حسابات الرموز الخاصة بالعنوان. غلاف ERC-20 balanceOf يقرأ حساب الرموز الخاص بالمحفظة مباشرةً. totalSupply يقرأ عملية السكّ.
داخل Rome، يقرأ رمز SPL الخاص بالمحفظة وغلاف ERC-20 الخاص بها حساب الرموز نفسه. محفظة Solana التي تحتفظ بـ USDC وعنوان EVM الذي يحتفظ بـ USDC يمتلكان عملية السكّ نفسها، وكلاهما يتداول مقابل حسابات المجمّع نفسها. هكذا تبقى السيولة في مكان واحد على Rome. الصورة والتفاصيل موجودتان في التوافق البيني للرموز.
تحتفظ المحافظ والعقود بالرموز بطرق مختلفة
ينطبق الرصيد المشترك على المحافظ. أما العقود فمختلفة. لا يمكن للعقد إرسال التفويض لمرة واحدة الموضح أدناه نيابةً عن المستخدم، لذا تحتفظ الأغلفة العادية برموز العقد في حساب رموز تحت الضمان وتحتفظ بسجلّ لما يملكه كل عقد. أما أغلفة Token-2022 ذات الـhook فلا تحتفظ بسجل وتستخدم حساب الرموز الخاص بالعقد نفسه.
ويترتب على ذلك أمران:
يعرض غلافان فوق عملية السكّ نفسها رصيد المحفظة نفسه. وقد يختلفان بشأن رصيد العقد، لأن كلًا منهما يحتفظ بسجله الخاص.
بالنسبة إلى المجمعات والخزائن وأسواق الإقراض، استخدم الغلاف القياسي الذي يسميه السجل لكل عملية سكّ على كل سلسلة. لا تختر واحدًا بالاسم.
التحويل إلى عقد عبر الغلاف يضيف إلى ذلك السجل. لكنه لا يمنح العقد حساب رموز يمكنه الإنفاق منه. المسارات التي تحتاج إلى أن يتصرف العقد على Solana تستخدم المسار الوارد في دمج برنامج سولانا.
المصنع والغلاف
ERC20SPLFactory ينشر غلافًا لعملية سكّ SPL. يسمح كل مصنع بغلاف واحد لكل عملية سكّ. يوفّر الغلاف واجهة ERC-20 كاملة:
balanceOfوtotalSupplyقراءة حالة Solana.transferوtransferFromنقل الرموز على Solana.approveوallowanceالاحتفاظ بتفويضات ERC-20 العادية في تخزين EVM، لأن حساب الرموز لا يملك شيئًا من هذا القبيل.
نادراً ما تنشر غلافًا. فـRome والسجل يحتويان بالفعل على الأغلفة القياسية لـ USDC وETH وSOL. ولا تنشر واحدًا إلا عندما تجلب عملية سكّ جديدة. استدعاءا المصنع كلاهما في المصنع. يتعامل المصنع أيضًا مع عمليات سكّ Token-2022، لكن امتداداتها تغيّر التكامل: يعيد الغلاف المزود بـhook التراجع عند التحويل العادي transfer و transferFrom، ويمكن لعملية سكّ ذات رسوم تحويل أن توصل أقل مما ترسله. اقرأ صكوك Token-2022 قبل استخدام واحدٍ منها في خزنتك.
يجب أن تتسع المبالغ في uint64، لأن مبالغ SPL تتسع لذلك، والغلاف يرفض أي شيء أكبر. لرمز الغاز كسورُه العشرية الخاصة به، وتستخدم أرصدة الغاز الأصلي 18. يجب أن يكون التحويل بينهما دقيقًا. رمز الغاز على Hadrian وRubicon هو USDC.
التفويض لمرة واحدة
ينقل الغلاف رموز المستخدم بصفته المفوَّض SPL لحساب الرموز الخاص بالمستخدم. يجب أن يعيّن حساب الرموز ذلك المفوَّض قبل أن يتمكن الغلاف من نقل أي شيء. يفعل المستخدم ذلك مرة واحدة لكل غلاف باستدعاء واحد، وبالحد الأقصى للمبلغ:
approve_spl(wrapper, type(uint64).max, mint) على Helper precompile.
أربع تفاصيل مهمة عمليًا:
المستخدم هو من يرسله. يوقَّع التفويض بواسطة حساب المستخدم نفسه، ويُرسَل مباشرةً إلى Helper precompile. لا يمكن لعقدك إرساله نيابةً عنهم. أضف خطوة "Enable" إلى واجهة المستخدم لديك.
ينطبق على الجميع. تحتاج إليه محافظ MetaMask والعناوين الاصطناعية لمحافظ Solana، وذلك لكل غلاف يرغبون في نقل رموزه.
تحقق منه أولًا. تفويض الغلاف
isEnabled(user)يعيدtrueبمجرد أن يكون التفويض قائمًا. اقرأه قبل أي تحويل بدلًا من الافتراض.امنح الحد الأقصى.
isEnabledيبقىtrueما دام أي جزء من تفويض محدود لا يزال قائمًا. يفشل التفويض المحدود عمليات النقل العادية عندما ينخفض، ولن يعرف تطبيقك أن يطلبه مرة أخرى.
عملية السكّ التي يجب تمريرها هي mint_id() على الغلاف. توجد نسخة مطبَّقة للواجهة الأمامية لكلا نوعي المحافظ في مرة واحدة: امنح الغلاف.
كيف يفشل
لحساب الرموز مفوَّض واحد. إذا منح المستخدم جسرًا أو موجّهًا، فإن ذلك التفويض يحل محل تفويض الغلاف، ويتوقف الغلاف عن العمل لذلك المستخدم. العَرَض هو revert مع خطأ SPL 0x4، وهو عدم تطابق في المالك. الحل هو منح التفويض للغلاف مرة أخرى. لذا تحقّق من isEnabled قبل أي مسار يعتمد على الغلاف، وليس مرة واحدة عند التسجيل.
تجلب نسخة جديدة من المصنع غلافًا جديدًا، وتمنح كل محفظة الغلاف الجديد بالطريقة نفسها.
نقل الرموز إلى الخارج
لأن رصيد الغلاف هو بالفعل رصيد SPL، فإن نقل رمز إلى Solana هو تحويل SPL.
إلى محفظة Solana أخرى من محفظة EVM:
transfer_splتُرسَل مباشرةً من المحفظة إلى Helper precompile، أوRomeBridgeWithdraw.bridgeOutToSolana، والذي يحتاج أيضًا إلى تفويض لعقد الجسر. وكلاهما يتطلب وجود حساب الرموز الخاص بالمستلم.إلى المحفظة التي وقّعت المعاملة:
transfer_spl_to_signer. لا يصل إلى محفظة المستخدم الخاصة إلا عبر مسار Solana الموقَّع من المحفظة. ومن MetaMask يكون الموقّع هو الدافع الوكيل لـRome، لذا استخدم الطريقتين الأخريين.بالنسبة إلى رمز الغاز،
withdraw_to_ataوdeposit_from_ataحوّل بين الغاز الأصلي والرمز الموجود في حساب رموز.
على شبكة الاختبار، يربط Solgate أصول Solana بسلاسل AggLayer EVM في كلا الاتجاهين. تسجيل رمز SPL غير مقيّد. ويستخدم USDC CCTP. الدرس 10 يعود إلى التدفقات الواردة والجسر. قائمة الأساليب موجودة في الإيداع والسحب.
اختبر نفسك
على Hadrian، باستخدام المحفظة التي موّلتها:
اقرأ
isEnabledلعنوانك على الغلاف القياسي لـ wUSDC من السجل.تأكد من وجود حساب رموز USDC الخاص بك. إن
createMyAtaالاستدعاء في الدرس 5 هو الذي أنشأه. إذا تخطيت ذلك، فحوّل قليلًا من الغاز إلى wUSDC باستخدامwithdraw_to_ata، كما في التطبيق نفسه من MetaMask.إذا
isEnabledهوfalse، فأرسلapprove_splالتفويض إلى Helper precompile. استخدم الشيفرة الموجودة في دليل المسارين المرتبط أعلاه.اقرأ
isEnabledمرة أخرى. يجب أن يكون الآنtrue.اعثر على معاملة التفويض الخاصة بك على عبر المستكشف. ابحث عن SPL Token
ApproveCheckedعادية.
التالي
آخر تحديث
هل كان هذا مفيدا؟