انتقل للمحتوىBlockAssay

جمع البيانات ومصدرها

P10-L02 · P10 · P10-M01

سجّل المعرّفات وارتفاعات الكتل والطوابع الزمنية وحدود المزود

ILLUSTRATIVE · needs_review

المتطلبات السابقة: 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

SPECIFICATION_ONLY · ILLUSTRATIVE

سجّل المعرّفات وارتفاعات الكتل والطوابع الزمنية وحدود المزود

يفصل المصدر التوضيحي وقت الحدث عن وقت جمع استجابة المزود.

خط زمني للمعاملة بمسارين: وقت الحدث المعلن ⁦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.

اختبر تعليلك

P10-L02-Q1 · تُجلب ⁦R⁩ عند ⁦12:12Z⁩ بوقت ترويسة ⁦12:00Z.⁩ أي طابع يصف سجل الحدث؟
P10-L02-Q2 · كيف تعرض ⁦2500000⁩ وحدة خام بست منازل عشرية؟
P10-L02-Q3 · ماذا يثبت ⁦SHA-256⁩ مطابق لبايتات مخزنة؟
P10-L02-Q4 · تتاح الصفحة ⁦1⁩ من ⁦2⁩ فقط. أي عبارة تصمد؟
P10-L02-Q5 · يطابق معرّف المعاملة الخام؛ الإدراج مجرد تسمية مفهرس. ماذا يبقى؟