تأكيدات Ethereum والنهائية: افحص الكتلة لا علامة Success وحدها

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

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

افصل بين الإدراج والتنفيذ والنهائية

يعيد مرجع إيصال JSON-RPC رقم الكتلة التي تضم المعاملة وتجزئتها، مع حالة التنفيذ. المعاملة المعلقة ليس لها بعد إيصال إدراج في كتلة. تشير الحالة 1، المعروضة بصيغة 0x1 في JSON-RPC الخام، إلى نجاح التنفيذ؛ وتشير 0 أو 0x0 إلى الفشل.

لا تمثل أي من القيمتين علامة للنهائية. قد تكون المعاملة التي تراجع تنفيذها ضمن كتلة نهائية. وفي المقابل قد يكون التنفيذ الناجح ضمن كتلة حديثة لم تصبح نهائية بعد. انتظار النهائية لن يحول الإجراء المتراجع عنه إلى إجراء ناجح.

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

إن كانت المعاملة لا تزال معلقة، استخدم دليل المعاملة المعلقة قبل التفكير في إجراء آخر. وإن نجحت لكن الرموز المقصودة لم تظهر، يعالج دليل أدلة التحويل هذا السؤال المنفصل.

ماذا تعني النهائية في Ethereum

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

يميز شرح Ethereum Foundation لطبقة التطبيقات الرأس safe عن الكتل finalized. تمثل safe حالة ثقة وسيطة، وليست مرادفا للنهائية. تتيح واجهة التنفيذ وسوم الكتل latest وsafe وfinalized لطلب الرأس المعني.

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

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

قارن المعاملة بالسلسلة النهائية

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

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

يوفر توثيق البحث عن الكتل رقم الكتلة وتجزئتها. لا يكفي الارتفاع وحده عند اختلاف السجلات: قد تشغل كتلتان مختلفتان الارتفاع نفسه عبر إعادة تنظيم السلسلة. احتفظ بالتجزئة مع الرقم كي تحدد المقارنة الكتلة التي احتوت المعاملة.

اقرأ تغير عدد التأكيدات بحذر

لنفترض أن إيصالا افتراضيا يضع المعاملة في الكتلة 100، بينما يبلغ القارئ عن رأس نهائي عند 98. قد تعرض المعاملة Success بالفعل، لكن ملاحظة الرأس النهائي هذه لا تشمل الكتلة 100. إذا أبلغت قراءة لاحقة متسقة عن رأس نهائي عند 102، فتحقق من أن الكتلة المعتمدة عند 100 لا تزال تحمل تجزئة الإيصال قبل تسجيل أن النهائية تشمل كتلة المعاملة.

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

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

احتفظ بسجل كتلة مؤرخ

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

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

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