Owlio
AR
→ المدونة
دليل عمليللمبتدئين

نجحت معاملة Ethereum لكن الرموز لم تصل: ما الذي تفحصه؟

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

نجاح معاملة Ethereum لا يثبت بمفرده أن رموز ERC-20 المقصودة وصلت إلى الحساب المقصود. يوضح النجاح ما إذا كانت المعاملة ككل قد اكتملت دون تراجع عن التنفيذ. تأكد من العملية التي نُفذت وعقد الرمز الصحيح والمستلم وأدلة التحويل قبل اعتبار الدفعة مكتملة.

ابدأ بتجزئة المعاملة الأصلية على Ethereum Mainnet. لا ترسل دفعة أخرى لمجرد اختبار عرض محفظة لم يتحدث. يصف هذا الدليل فحصاً للقراءة فقط لمعاملة أُدرجت في كتلة، وليس خدمة استرداد أو تعليمات لتوقيع معاملة أخرى.

اقرأ النجاح على المستوى الصحيح

يعرّف معيار EIP-658 حالة الإيصال بأنها نتيجة الاستدعاء على المستوى الأعلى. تعني الحالة 1 النجاح و0 الفشل؛ ويمثلهما JSON-RPC بالقيمتين 0x1 و0x0. هذا وصف للتنفيذ، وليس قائمة تؤكد تحقق كل النتائج التي أردتها من التطبيق.

يمكن للعقد معالجة عملية داخلية غير ناجحة دون التراجع عن المعاملة بأكملها. كما يلزم معيار ERC-20 صراحةً الجهات المستدعية بمعالجة القيمة المعادة false. لا تفترض أن كل تطبيق للرمز يبلّغ عن التحويلات غير الناجحة بالتراجع عن التنفيذ.

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

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

حدّد ما إذا كانت العملية تحويلاً

قد يطلب التطبيق منح إذن قبل تحويل أو مبادلة أو إيداع لاحق. في معيار ERC-20، تحدد دالة approve مقدار السماح بالإنفاق؛ ولا ترسل بنفسها المبلغ المسموح إلى الجهة المخولة بالإنفاق. لذلك قد تنجح معاملة منح الإذن ويبقى رصيد الرموز كما هو.

افحص العملية والمدخلات المفكوكة الترميز عند توفرها. سجّل عقد وجهة المعاملة والعملية التي قصدتها. قد يشير حقل To في المعاملة إلى عقد توجيه أو عقد آخر بدلاً من المستلم النهائي للرموز. لا تساوِ بين هذا الحقل والمستلم المسجل في تحويل الرمز.

الملاحظة ما تثبته ما يبقى للفحص
حالة الإيصال Success نجح التنفيذ على المستوى الأعلى نتيجة العملية المقصودة
نجاح منح الإذن نُفذت عملية السماح تحويل أو عملية بروتوكول منفصلة
سجل Transfer مطابق أصدر ذلك العقد سجل تحويل الهوية والمبلغ والحالة الناتجة
الرصيد الحالي للرمز كمية الحساب وقت القراءة النشاط الآخر ووقت الملاحظة

احتفظ بتجزئات الخطوات المنفصلة. منح إذن ناجح يتبعه تحويل يعني وجود سجلين؛ ولا يمكن لعلامة Success واحدة أن تمثل كليهما. كما لا تثبت رسالة اكتمال التطبيق أن منصة تداول قيّدت الإيداع أو أن جسراً اكتمل على سلسلة أخرى. تحتاج تلك الخدمات إلى سجلاتها وقواعدها الخاصة.

طابق سجل التحويل مع الرمز والمستلم الصحيحين

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

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

افحص المبلغ إلى جانب وجود الحدث. يشمل معيار ERC-20 تحويلات بقيمة صفر، لذلك لا يثبت العثور على حدث Transfer وجود دفعة بقيمة موجبة. إذا عرض السجل عدداً صحيحاً خاماً، فاستخدم مقياس المنازل العشرية المتحقق منه للرمز لتفسيره. لا تطبّق التنسيق مرتين ولا تخترع مقياساً عند غياب البيانات الوصفية.

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

قارن الحالة دون نسبة كل تغيير إلى هذه التجزئة

اقرأ رصيد المستلم لعقد الرمز نفسه على الشبكة نفسها. تعرض دالة balanceOf(account) في المعيار رصيد رموز الحساب، ولا تشرح ما الذي غيّرته معاملة واحدة. قد يتأخر معرض المحفظة أو إجمالي المحفظة الاستثمارية بعملة نقدية، أو يصف شيئاً آخر.

سجّل كتلة القراءة أو وقتها. قد يتضمن أحدث رصيد تحويلات لاحقة للمعاملة التي تفحصها. وحتى مقارنة الرصيد في الكتلة السابقة والكتلة التي تحتوي المعاملة قد تشمل معاملات أخرى في تلك الكتلة. لا تدّعِ أن فرقاً واحداً يعزل أثر هذه التجزئة دون فحص النشاط الآخر.

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

احتفظ بسجل قبل اتخاذ قرار بدفعة أخرى

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

  1. حدّد المعاملة الأصلية. احفظ شبكة Ethereum Mainnet والتجزئة الكاملة والمرسل والكتلة وحالة الإيصال الإجمالية.
  2. حدّد العملية الفعلية. ميّز منح الإذن عن التحويل أو المبادلة أو الإيداع. احفظ أي تجزئات منفصلة تخص تسلسل العمليات.
  3. طابق أدلة الرمز. سجّل العقد المُصدر للسجل ومرسل التحويل والمستلم والمبلغ بوحداته. قارنها بالأصل والحساب المقصودين.
  4. افحص الحالة الناتجة. اقرأ رصيد الرمز المحدد أو سجل البروتوكول ذي الصلة، وسجّل الكتلة أو الوقت والنشاط الآخر الذي قد يؤثر فيه.
  5. اترك الأجزاء غير المحسومة دون حسم. احتفظ بالسجلات المفقودة والقراءات الفاشلة والفروق غير المفسرة. استشر الدعم الرسمي للمحفظة أو البروتوكول مع تقديم تفاصيل المعاملة العامة قبل أن تقرر ما إذا كانت معاملة أخرى مناسبة.

يكتمل فحصك عندما تستطيع شرح ما نجح وما الأدلة التي تدعم الاستلام المقصود. إذا نجحت المعاملة لكن الدفعة لم تُتحقق بعد، فصِفها كذلك. شارة Success دليل مفيد؛ وليست إذناً بتجاهل الأصل أو المستلم أو المبلغ.

أسئلة شائعة

هل تعني الحالة 1 أن تحويل ERC-20 نجح بالتأكيد؟

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

هل يمكن قراءة true أو false التي أعادها الرمز من حالة الإيصال؟

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

هل أعيد إرسال الدفعة إذا لم تتحدث المحفظة؟

افحص أولاً تجزئة المعاملة الأصلية على الشبكة الصحيحة. قد تنشئ المعاملة الجديدة دفعة أخرى. احتفظ بالإيصال الأصلي وافحص الأصل والحساب الصحيحين قبل اتخاذ أي إجراء جديد.