P10-L02 · P10 · P10-M01
سجّل المعرّفات وارتفاعات الكتل والطوابع الزمنية وحدود المزود
المتطلبات السابقة: P10-L01
أهداف التعلم
- سجّل المعرّفات وارتفاعات الكتل والطوابع الزمنية وحدود المزود
- احفظ وقت الحدث ووقت الاسترجاع وتغطية المزود في حقول منفصلة.
أهمية الموضوع
قد تبدو صورة ثابتة فيما يغير مزودها تسميات أو تأكيدات. قد يجعل طابع زمني بلا أساس وقت حدثًا قديمًا يبدو رصدًا جديدًا.
الشرح
عامل كل استرجاع حزمة أدلة صغيرة: طريقة الطلب وURL الدقيق والشبكة ومعرّف السجل ومرجع الكتلة أو الفتحة وحالة الاستجابة ووقت الجمع الفعلي UTC وبايتات الاستجابة ومجموع تحقق تشفيري. افصل حقل وقت الحدث لدى المزود. خزّن البيانات أولًا ثم اشتق جدولًا؛ وإلا لا يميز القراء لاحقًا محتوى المزود من تحرير المحلل. لا تضمّن بيانات دخول أو مواد جلسة خاصة في حزمة عامة مطلقًا.
يعيد مجموع تحقق المعرّف البايتات، لا الحقيقة. يثبت معرّف معاملة أعيد حسابه محليًا أن التسلسل الخام المقدم يطابق المعرّف؛ لا يثبت وحده الإدراج في السلسلة المعتمدة أو النهائية أو الهوية البشرية. لوسم «مؤكد» لدى المفهرس حد مصدر خاص. سجّل صفحات مفقودة وبترًا وسياسة إعادة تنظيم السلسلة وأنواع أحداث غير مدعومة بدل تسويتها خفية.
اذكر الوحدة والعملية للقيم المشتقة. احفظ الأعداد الصحيحة الخام قبل العرض العشري. قد يساعد Wallet Intelligence في فحص سجلات، لكن لا ينشئ الدرس تقريرًا فعليًا أو يستنتج تغطية الأداة من الواجهة. يتبع المصدر كل ادعاء من الاستجابة المخزنة حتى الحساب.
المصطلحات الأساسية
وقت الاسترجاع: وقت جمع استجابة.
وقت الحدث: طابع زمني يعلنه سجل الحدث بالسلسلة.
مجموع التحقق: بصمة بايتات مخزنة.
التغطية: السجلات وأنواع الأحداث التي يشملها مزود.
مثال تاريخي
ILLUSTRATIVE: تسمي الاستجابة R الكتلة 500 بوقت ترويسة 12:00Z. تُجلب عند 12:12Z وتدرج 2500000 وحدة خام بست منازل عشرية. يبلغ المزود P الصفحة 1 من 2؛ الصفحة 2 غير متاحة. العرض المشتق 2.5 وحدة، لا 2,500,000 رمز كامل. تفترض البيانات هذه القيم؛ لم يجر طلب.
مواصفات العناصر البصرية
خط زمني للمعاملة بمسارين: وقت الحدث المعلن 12:00Z والاسترجاع 12:12Z. أرفق تحويل الوحدة الخام وفجوة صفحة-2 بارزة.
التعليق: يفصل المصدر التوضيحي وقت الحدث عن وقت جمع استجابة المزود.
SPECIFICATION_ONLY — لم يُنتج الرسم المعروض أو يُراجع مستقلًا.
ما تثبته الأدلة
تسند البيانات تحويل وحدات قابلًا للتكرار ورصد صفحة-1 محدودًا بوضوح. لوقت الجمع ووقت الحدث معنيان مسجلان مختلفان.
ما لا تثبته الأدلة
لا يصدّق مجموع تحقق مطابق صحة المزود. تمنع الصفحة 2 المفقودة ادعاء عدد أحداث كاملًا؛ لا يثبت وقت الترويسة زمن وصول ساعة حقيقيًا دقيقًا.
الأخطاء الشائعة
تجزئة صورة بدل حفظ الاستجابة؛ استبدال وقت الحدث بوقت الاسترجاع؛ حذف الوحدات الخام؛ والإبلاغ عن عدد كامل من صفحة واحدة متاحة.
تمرين عملي
اكتب صف مصدر لـ R واحسب مبلغ عرضها وأعد صياغة «وقعت كل الأحداث عند 12:12Z». أدرج الصفحة غير المتاحة وخطوة تحقق مستقلة واحدة.
عرض التصحيح المشروح
استخدم URL/السجل الخيالي R والشبكة N والكتلة 500 وeventTime بقيمة 12:00Z (معلن بالترويسة) وretrievedAt بقيمة 12:12Z والمزود P وrawAmount بقيمة 2500000 وdecimals بقيمة 6 وdisplayAmount بقيمة 2.5 والتغطية صفحة 1/2 مع الصفحة 2 غير المتاحة. العبارة الصحيحة «استُرجعت R عند 12:12Z؛ وقت كتلتها المعلن 12:00Z». احفظ بايتات الاستجابة ومجموع التحقق بعينهما؛ تحقق مستقلًا من التسلسل الخام ومرجع الكتلة قبل توسيع ادعاءات التأكيد. يبقى دليل عدد الأحداث الكامل غير كافٍ.
قائمة التحقق
- احفظ المعرّفات الدقيقة والوحدات الخام.
- افصل طوابع الحدث والاسترجاع.
- احفظ البايتات قبل الاشتقاق.
- اكشف تقسيم الصفحات الناقص والنهائية المفهرسة.
الملخص
يربط المصدر السجلات والاسترجاعات والادعاءات المشتقة دون تحويل مجموع تحقق إلى شهادة حقيقة.
الملخص
- احفظ بايتات الاستجابة وسياق الطلب.
- يصاحب أساس الوقت والوحدة كل قيمة.
- لا تسند التغطية الجزئية عددًا كاملًا.
الدرس التالي
P10-L03
الأدوات
استخدم أداة BlockAssay المسماة سياقًا لقراءة الأدلة فقط. لا ينشئ الدرس ناتج أداة أو جلسة حساب أو استحقاقًا. تمرين دون اتصال؛ لا توقّع أو تنشر أو توافق أو تموّل شيئًا.
المصادر وحدود الادعاءات
- API: مواصفات واجهة Esplora العامة — مسارات GET وساتوشيات صحيحة وحقول تأكيد/إنفاق مخرجات مفهرسة. الحد: توثيق آلية فقط؛ القيم التوضيحية الأصلية مفترضة، لا أرصاد. للسجلات التاريخية مصدر مجمد منفصل وفجوات جمع صريحة.
- BTC: دليل مطوري Bitcoin — المعاملات — تحدد مراجع المدخلات مخرجات معاملات سابقة؛ لا تحدد النصوص البرمجية إنسانًا. الحد: توثيق آلية فقط؛ القيم التوضيحية الأصلية مفترضة، لا أرصاد. للسجلات التاريخية مصدر مجمد منفصل وفجوات جمع صريحة.
تصنيفات الأدلة
ILLUSTRATIVE — مدخلات خيالية تمامًا دون اتصال؛ لا رصد حاليًا.
تاريخ الرصد
null — لا رصد حقيقيًا
إصدار المحتوى
1
تاريخ المراجعة
null
حالة المراجعة
needs_review
مواصفات العناصر البصرية
P10-L02-V01
سجّل المعرّفات وارتفاعات الكتل والطوابع الزمنية وحدود المزود
يفصل المصدر التوضيحي وقت الحدث عن وقت جمع استجابة المزود.
خط زمني للمعاملة بمسارين: وقت الحدث المعلن 12:00Z والاسترجاع 12:12Z. أرفق تحويل الوحدة الخام وفجوة صفحة-2 بارزة.
خط زمني للمعاملة بمسارين: وقت الحدث المعلن 12:00Z والاسترجاع 12:12Z. أرفق تحويل الوحدة الخام وفجوة صفحة-2 بارزة.
رصّ الأرصاد والافتراضات والفجوات والنتيجة عند 390 px؛ احفظ المعرّفات كاملة ومكافئًا نصيًا كاملًا. يتمرر أي جدول عريض محليًا.
يمكن أن يتبع النثر RTL؛ تبقى المعرّفات والكميات ومحاور الوقت LTR. احفظ اتجاه الاعتماد.
P10-L02-ILLUSTRATIVE-v1
المصادر وحدود الادعاءات
API · PRIMARY_DOCUMENTATION
مواصفات واجهة Esplora العامة
- الادعاء المدعوم
- مسارات GET وساتوشيات صحيحة وحقول تأكيد/إنفاق مخرجات مفهرسة.
- حدود التحقق
- توثيق آلية فقط؛ القيم التوضيحية الأصلية مفترضة، لا أرصاد. للسجلات التاريخية مصدر مجمد منفصل وفجوات جمع صريحة.
- تاريخ التحقق
- 2026-10-02
https://github.com/Blockstream/esplora/blob/master/API.md
BTC · PRIMARY_DOCUMENTATION
دليل مطوري Bitcoin — المعاملات
- الادعاء المدعوم
- تحدد مراجع المدخلات مخرجات معاملات سابقة؛ لا تحدد النصوص البرمجية إنسانًا.
- حدود التحقق
- توثيق آلية فقط؛ القيم التوضيحية الأصلية مفترضة، لا أرصاد. للسجلات التاريخية مصدر مجمد منفصل وفجوات جمع صريحة.
- تاريخ التحقق
- 2026-10-02
https://developer.bitcoin.org/devguide/transactions.html
منشأ مجموعة البيانات
id: P10-L02-ILLUSTRATIVE-v1
dataStatus: ILLUSTRATIVE
observedAt: null
source: Original offline scenario in realOrHistoricalExample
scope: Fictional stipulated labels and values. No wallet, deployment, transaction, token launch or production observation.