حصص خزينة ERC-4626 والأصول: تحقق من معنى رصيدك

رصيد خزينة ERC-4626 هو عدد من الحصص، وليس تلقائيا العدد نفسه من الرموز الأساسية. حدّد أصل الخزينة، ثم ميّز التحويل العام عن معاينة الاسترداد وعن حد الاسترداد الخاص بالمالك. تجيب هذه الأرقام عن أسئلة مختلفة تخص مركزا واحدا.

إذا عرضت المحفظة 100 حصة بينما عرضت شاشة البروتوكول 120 رمزا أساسيا، فلا تبدأ بافتراض أن أحد الرصيدين خاطئ. تحقق أولا مما يقيسه كل رقم. هذا الدليل طريقة للقراءة فقط لمطابقة حيازة قائمة، وليس توصية بالإيداع في خزينة أو استرداد الحصص منها.

حدّد رمز الحصة وأصله الأساسي

يعرّف معيار ERC-4626 حصص الخزينة بأنها رموز ERC-20. تعدّ الدالة balanceOf(account) في الخزينة تلك الحصص؛ وتحدّد الدالة asset() عقد الرمز الأساسي. احتفظ بعنواني العقدين بجانب الشبكة والحساب اللذين تفحصهما.

لا يكفي رمز تداول مألوف. تأكد من النسخة المنشورة المحددة للخزينة عبر وثائق البروتوكول الرسمية أو معاملة معروفة، تصل إليها بطريق موثوق. ثم قارن عنوان الأصل الأساسي، لا اسمه فقط، بالرمز المقصود. فقد يعرض عقد مقلد أسماء دوال مألوفة دون أن يكون الخزينة التي تقصدها.

تحقق من الوحدات على الجانبين. يجب تفسير كمية الحصص الخام وفقا للمنازل العشرية لرمز الحصة، بينما تستخدم نتيجة الأصول الخام المنازل العشرية للرمز الأساسي. وليس من الضروري تطابقهما: يصف دليل الخزائن من OpenZeppelin تطبيقات بدقة إضافية للحصص. يشرح دليل المنازل العشرية للرموز كيفية تمييز عدد صحيح ما زال يحتاج إلى تنسيق. لا تطبّق تحجيم المنازل العشرية مرة ثانية على كمية منسّقة بالفعل.

اختر الرقم الذي يجيب عن سؤالك

استخدم القراءات الموثقة للعقد الذي تحققت منه بدلا من الضرب في معدل منسوخ من خزينة أخرى. يفصل مرجع واجهة OpenZeppelin بين دوال التحويل والمعاينة والحدود.

القراءة	وحدة النتيجة	السؤال الذي تجيب عنه
balanceOf(account)	حصص	كم حصة يملك هذا الحساب؟
convertToAssets(shares)	أصول أساسية	ما المكافئ العام من الأصول؟
previewRedeem(shares)	أصول أساسية	ما تقدير الاسترداد لهذه الحصص؟
maxRedeem(owner)	حصص	كم حصة يستطيع هذا المالك استردادها حاليا؟

تصف convertToAssets تحويلا مثاليا يستبعد الرسوم والانزلاق السعري للتبادل الفعلي. وهي ليست عرض سحب مخصصا للمالك. تشمل previewRedeem رسوم السحب وتعكس الظروف الحالية، لكنها تتجاهل حدود الاسترداد عمدا. لمعرفة تلك الحدود، اقرأ maxRedeem للمالك. وتوضح تعريفات الدوال في المعيار هذه الفروق صراحة.

لذلك قد تتزامن معاينة موجبة مع حد أصغر، أو حتى حد صفري. كما أن القراءة لا تحجز أموالا: قد تتغير الحالة قبل معاملة لاحقة. اتبع شروط السحب الموثقة للخزينة المعنية، بما فيها أي إجراء لطلب السحب يكون مطلوبا. والخزينة التي تستخدم امتدادا غير متزامن أو واجهة مختلفة تحتاج إلى تعليماتها الخاصة.

أبق حيازة واحدة في المقارنة

لنأخذ لقطة زمنية افتراضية، جميع أرقامها منسّقة مسبقا بوحدات قابلة للقراءة. يملك حساب 100 حصة. وتبلغ الخزينة عن 120 رمزا أساسيا عبر convertToAssets لتلك الكمية من الحصص، وعن 119 رمزا أساسيا عبر previewRedeem. وبشكل منفصل، تبلغ maxRedeem لذلك الحساب 40 حصة.

الرقم 120 رمزا هو مكافئ عام. والرقم 119 رمزا هو معاينة لجميع الحصص البالغ عددها 100، وليس دليلا على إمكانية استردادها كلها الآن. أما حد 40 حصة فيُقاس بالحصص، ولا يجوز مقارنته كأنه 40 رمزا أساسيا. لفحص كمية الحصص المسموح بها، احصل على معاينتها الخاصة بدلا من افتراض أن معاينة كامل الرصيد تنطبق دون تغيير.

هذه الأرقام مثال مختلق على التسميات والنطاق، وليست عرضا حيا من خزينة أو جدول رسوم أو حسابا لمعدل بروتوكول بعينه. لم تُستعلم أي محفظة ولم تُنفّذ أي معاملة لهذا المثال.

لا تجمع 100 حصة وما يعادلها من 120 رمزا باعتبارهما حيازتين منفصلتين. إنهما يصفان المركز نفسه. إذا كانت المحفظة تحتفظ أيضا برموز أساسية خارج الخزينة، فسجّل رصيد المحفظة الفعلي هذا بشكل منفصل. عند مقارنة المجاميع بالعملة النقدية، تحقق من التمثيل الذي احتسبه المتتبع بالفعل قبل إضافة قيمة البروتوكول. يساعد دليل مطابقة المحفظة الأوسع على التمييز بين كمية مفقودة وسعر مفقود أو مركز غير مدعوم.

سجّل لقطة متسقة دون تحريك الأموال

استخدم مستكشفا أو قارئ عقود تثق به مسبقا. يصف هذا الإجراء فحصا يستند إلى الوثائق؛ ولم يُختبر على خزينة حية من أجل هذا المقال. جرت مراجعة المراجع الأولية في 25 أكتوبر 2026.

1. أكّد هوية المركز. سجّل الشبكة والحساب وعنوان عقد الخزينة كاملا. تحقق من أن النسخة المنشورة تستخدم واجهة ERC-4626 التي تقصد فحصها.
2. حدّد الأصل والوحدات. سجّل asset() ومقياس المنازل العشرية للحصص والأصول. اقرأ رصيد حصص الحساب، مع فصل الأعداد الصحيحة الخام عن الكميات المنسّقة.
3. اختر القراءة المناسبة. للمقارنة المحاسبية، سجّل convertToAssets لكمية الحصص المحددة نفسها. ولتقدير الاسترداد، سجّل previewRedeem وسمّه معاينة.
4. تحقق من حد المالك بشكل منفصل. اقرأ maxRedeem(owner) وشروط السحب في البروتوكول. لا تستبدل الحد غير المتاح برصيد الحصص، ولا تعامل المعاينة الموجبة باعتبارها إذنا بالاسترداد.
5. وحّد الملاحظات وسمّها. يُفضّل استخدام الكتلة نفسها للرصيد والتحويل والمعاينة والحد. إذا كان القارئ لا يوفّر إلا استدعاءات منفصلة لأحدث حالة، فاحفظ أوقاتها وسجّل أن اللقطات قد تختلف.
6. طابق مركزا واحدا. احتفظ بعدد حصصه ومكافئها من الأصول ومعلومات الاسترداد معا. علّم القراءة الفاشلة بأنها مجهولة، واحفظ خطأها، وافحص الحساب أو العقد أو الشبكة أو الواجهة قبل الاستنتاج بأن الكمية صفر.

لا تحتاج هذه القراءات العامة إلى توقيع أو موافقة أو عبارة استرداد أو تحويل. إذا طلب موقع أحدها لمجرد إظهار الرصيد، فأوقف ذلك المسار. يمكن لاستجابة العقد أن تساعد على تفسير العرض؛ لكنها لا تشهد بأمان العقد.

التحويل ليس عائدا أو سعر بيع

يجيب المكافئ من الأصول عن كيفية تعبير الخزينة عن كمية حصص برمزها الأساسي. ولا يثبت ربحا مقارنة بإيداعك الأصلي، أو سعر بيع في السوق، أو استردادا مستقبليا مضمونا. يجب تسجيل الرسوم والتقريب وتغيرات الخزينة وسعر الأصل الأساسي نفسه بصورة منفصلة.

لا تعمّم هذا الإجراء على كل رموز الإيصال. فمثلا، لدى stETH وwstETH طريقة محاسبة وتحويل موثقة خاصة بهما. وتشابه الرصيد ظاهريا لا يثبت اتباع سلوك ERC-4626.

يكتمل الفحص حين تستطيع تسمية الخزينة والأصل بدقة، وتحديد كمية الحصص واللقطة الزمنية، وشرح الشاشة التي تعرض تحويلا أو معاينة أو حدا. إذا لم تتوفر قراءة أساسية، فاترك ذلك الجزء غير متحقق منه. تحريك المركز قرار منفصل؛ وليس مطلوبا لتفسير رصيده المعروض.