P08-L02 · P08 · P08-M01
حوّل الأرصدة الخام بالمنازل العشرية المتحقق منها وسوّ مقاييس العرض
المتطلبات السابقة: P08-L01
أهداف التعلم
- حوّل أرصدة الأعداد الصحيحة الخام بالمنازل العشرية المتحقق منها.
- سوّ الإجماليات والاستبعادات والأحداث المغيرة للعرض.
- اشرح تعارضات التغذيات دون اختلاق تخصيص.
النسخة المصدرية EN · P08-L02 · المدة المقدرة 45 دقيقة · needs_review
أهمية الموضوع
قد يحوّل خطأ عشري تسعة آلاف رمز إلى تسعة رموز دون تغيير رصيد أساسي واحد. وقد يجعل تعريف عرض مسمى خطأً حسابين صحيحين يبدوان متناقضين. قبل تقييم أصل أو وصف توزيعه، حدد الوحدات والسياق والاستبعادات.
يعلم هذا الدرس التحويل الدقيق من الخام إلى المعروض وتسوية العرض. يبني على هوية متحقق منها بدل افتراض استخدام كل رمز ثماني عشرة منزلة عشرية.
الشرح
أبق الأعداد الصحيحة والعرض منفصلين
لتكن R كمية صحيحة خامًا و d عدد المنازل المتحقق منه. كميتها المعروضة المعتادة R مقسومة على 10^d. الوحدة الخام وحدة المحاسبة غير القابلة للتجزئة في هذا النموذج؛ وتحدد المنازل دقة العرض، لا عدد المالكين أو سعر السوق. تشمل حالة حساب إصدار Solana العرض والمنازل [S08-TOKENS]. طريقة decimals لدى ERC-20 اختيارية في المعيار [S08-ERC20]؛ ولا تُستبدل البيانات الوصفية غير المتاحة بافتراض افتراضي مخمن.
استخدم سلاسل أعداد صحيحة أو حسابًا عشريًا دقيقًا. قد يقرّب جدول بيانات أو عدد بفاصلة عائمة في JavaScript قيمة خامًا كبيرة قبل قسمتها. خزّن العدد الأصلي وعدد المنازل والسياق والقيمة المعروضة حقولًا متمايزة. إذا أبلغت أداة قيمة عرض مقربة، فاحسب من المدخل الخام بدل اعتبار المعروض دقيقًا.
يختلف الصفر المبلغ عنه عن نتيجة مفقودة. الصفر قياس صالح بمصدر/سياق معلن؛ وتصف null أو انتهاء المهلة أدلة مفقودة. يمنع غياب عدد المنازل تحويلًا موثوقًا للوحدات المعتادة حتى مع توافر الأرصدة الخام. سجّل المقدار الخام دون ادعاء كمية رموز.
سوّ المقاييس قبل مقارنتها
يصف العرض الكلي مقياس محاسبة البروتوكول بسياق محدد. يحتاج العرض المتداول سياسة إدراج معرفة. قد يعامل ناشرون مختلفون مخزون الخزينة والاستحقاق التدريجي وحفظ الجسور بطرق مختلفة. لا تحسم تسمية دون سياسة اختلافًا.
تعيد Solana getTokenSupply المقدار الخام والمنازل بسياق استجابة [S08-SUPPLY]. ليس هذا مقياس تداول معرفًا بصورة مستقلة. لا تطرح عرض ناشر معدلًا بالفعل من الإجماليات الخام دون فحص ما استبعده.
في بيانات محاسبة قياسية مغلقة، ينبغي تسوية الأرصدة مع الإجمالي المقدم. يجب في التحقيق الحقيقي فحص شمول التصدير وتطابق سياقاته وفك الامتدادات صحيحًا. تعقد بعض آليات الرموز الجمع البسيط للأرصدة؛ اذكر الحد بدل فرض هذا النموذج على كل أصل.
لا تدمر الاستبعادات رموزًا. ينتج استبعاد وحدات الخزينة من مقام تحليلي إحصاءً معدلًا، لا حدث سجل يغير العرض. كذلك ليس تحويل إلى عنوان موصوف بعنوان حرق خفضًا تلقائيًا لـ totalSupply البروتوكول. تحتاج آلية الحرق وتغير المحاسبة الفعليان أدلة.
تتبع التغيرات دون تغيير الوحدة
يزيد الإصدار العرض المحاسبي الكلي في البيانات. يخفضه حرق بروتوكول. تعيد التحويلات العادية بين حسابات مدرجة ترتيب الملكية دون تغيير الإجمالي. إذا اكتمل التسلسل المقدم، يساوي العرض الجديد القديم زائد وحدات مصدرة ناقص وحدات محروقة.
اربط كل حدث ومقدار بسياق. إذا اختلفت لقطة لاحقة عن مجموع الأحداث، فاختبر نقص التغطية أو حساب إصدار غير متسق أو دقة خاطئة قبل إعلان تلاعب. الفرق فشل تسوية يحتاج تحقيقًا؛ لا حكم نية.
يجب التحقق من المنازل للكائن والسياق بعينهما. قد يختلف أصلان بالرمز المختصر نفسه في الدقة. قد ينتج إعداد تغذية خاطئ فرقًا بمعامل ألف حين تختلف d بثلاث. لا «تصلح» الرصيد الخام ليتفق مع موقع.
استخدم جسر مقارنة
حين يختلف تقريران، اعرض المقدار الخام والمنازل والتحويل وسياق اللقطة وسياسة الاستبعاد بأعمدة. يظهر ذلك الأسئلة المختلفة. قد يصح تقرير للعرض الكلي وآخر لمقام معدل. ينبغي تسميتهما منفصلين، لا أخذ متوسطهما.
إذا ادعى مصدران التعريف نفسه بالسياق نفسه وظلا مختلفين، فاحفظ السجلين والاختلاف غير المحسوم. لا تختر الأكبر لأنه يبدو أكثر أمانًا أو الأصغر لأنه يحسن نسبة التركّز. تذكر نتيجة محدودة عدم التطابق والفحص التالي.
تلغي النسب العامل العشري المشترك فقط حين يشير البسط والمقام إلى دقة الرمز ونطاقه نفسيهما. تنتج مقارنة بسط خام بمقام معروض نتيجة بلا معنى. قد تنتظم رقميًا وتبقى خاطئة.
أوصل الكميات بصورة قابلة لإعادة الإنتاج
اكتب الوحدات في كل صف. قد تعني «2,500» وحدها وحدات خامًا أو رموزًا أو دولارات. يستخدم الدرس وحدات رموز خيالية ولا يقدم سعر سوق أو تقييمًا بالدولار. لا تقول تسوية عرض صحيحة شيئًا عن سيولة قابلة للتنفيذ أو ارتفاع سعر أو شرعية مُصدر.
احفظ الدقة الكاملة في مفتاح الإجابة وقرّب للعرض فقط. اشرح سياسة التقريب حين يتكرر الكسر. تنتهي تحويلات هذه البيانات بدقة، فلا حاجة لإخفاء باقٍ مقرب.
المصطلحات الأساسية
- المقدار الخام: وحدات محاسبة صحيحة.
- المنازل العشرية: دقة عرض بأساس عشرة.
- العرض الكلي: مقياس محاسبة البروتوكول بسياق.
- العرض المعدل: مقياس استبعاد معلن للمحلل.
- التسوية: مقارنة مجاميع وتغيرات متوافقة.
- سياق اللقطة: حد الحالة للملاحظة.
مثال تاريخي
ILLUSTRATIVE — FIX-P08-02. MINT-SUPPLY على SIM-SOL-A، نموذج محاسبة قياسي أساسي، d=6 عند S0 اصطناعية. أرصدة شاملة مقدمة؛ وكل المعرّفات تسميات غير صالحة.
| السجل | فئة الحساب | المقدار الخام | الرموز المعروضة |
|---|---|---|---|
| B1 | المالك A | 2,500,000,000 | 2,500 |
| B2 | المالك B | 1,500,000,000 | 1,500 |
| B3 | الخزينة، مستبعدة وفق السياسة E | 3,000,000,000 | 3,000 |
| B4 | الاستحقاق التدريجي، مستبعد وفق السياسة E | 2,000,000,000 | 2,000 |
إجمالي T0 الخام 9,000,000,000. تضبط التغذية F1 خطأً d=9 وتعرض 9. تستبعد السياسة E فقط B3/B4. يحرق تسلسل أحداث اصطناعي كامل إلى S1 مقدار 500,000,000 وحدة خام ويصدر 750,000,000؛ دون تغيرات عرض أخرى. لم يُقدم تخصيص حسابات S1.
ما تثبته الأدلة
OBSERVED في البيانات: قُدمت دقة S0 وإجماليها وأرصدتها. تستخدم F1 الدقة الخاطئة.
INFERRED: إجمالي S0 هو 9,000 رمز؛ والكمية المعدلة بالسياسة E هي 4,000. تقتضي الأحداث الكاملة إجمالي S1 من 9,250 رمزًا.
ما لا تثبته الأدلة
UNKNOWN: أي مقياس تداول حقيقي أو تخصيص S1 أو سعر أو سيولة.
INSUFFICIENT EVIDENCE: ليست 4,000 المعدلة حرق بروتوكول أو عرضًا متداولًا عالميًا. عدم تطابق المنازل ليس دليل نية خبيثة.
الأخطاء الشائعة
افتراض ثماني عشرة منزلة وخلط وحدات خام/عرض وعدّ الاستبعادات حروقًا واستيراد أعداد صحيحة مقربة ومقارنة سياقات غير متطابقة وتسمية مقياس معدل بسياسة «العرض المتداول» المطلق.
تمرين عملي
حوّل T0 والأرصدة الأربعة. سوّ S0. احسب مقام السياسة E وحصة المالك A من الإجمالي والكمية المعدلة وإجمالي S1. اشرح خطأ معامل F1 وهل يمكن حساب تركّز حائزي S1.
عرض التصحيح المشروح
التصحيح المحلول والتعليل المتوقع
اقسم كل مقدار خام على 1,000,000. مجموع الأرصدة 2,500+1,500+3,000+2,000=9,000. تزيل السياسة E مقدار 5,000 وتترك 4,000. A هي 2,500/9,000=27.7778% من الإجمالي مقربة إلى أربع منازل، و 2,500/4,000=62.5% من المقام المعدل.
تقسم F1 على 1,000,000,000 فتجعل قيمتها أصغر بألف مرة. احفظ الخام 9,000,000,000 وصحح تفسير الدقة، لا المقدار الأساسي.
إجمالي S1 الخام = 9,000,000,000−500,000,000+750,000,000=9,250,000,000، أو 9,250 رمزًا. تركّز S1 مجهول لغياب تخصيص الحسابات الجديد. لا تعد استخدام أرصدة S0 كلقطة لاحقة.
التقييم من عشر درجات: التحويلات/التسوية (ثلاث)، والاستبعادات والحصتان (ثلاث)، ومجموع الأحداث (اثنتان)، والمعامل وحد تخصيص لاحق (اثنتان).
قائمة التحقق
- تحقق من الأصل وعدد المنازل بعينهما.
- احفظ الأعداد الصحيحة الخام.
- سمّ الوحدات والتقريب.
- سوّ السياقات المتطابقة.
- اذكر كل استبعاد وسياسته.
- أبق الأرصدة اللاحقة المفقودة مجهولة.
الملخص
تسبق الدقة والتعريف مقارنة العرض. يغير استبعاد بسياسة المقام التحليلي؛ ويغير حدث سجل العرض المحاسبي.
الملخص
الوحدات الخام ليست رموزًا معروضة. تجيب سياسات عرض مختلفة عن أسئلة مختلفة. لا يوفر إجمالي صحيح توزيعًا حاليًا أو سيولة.
مواصفات العناصر البصرية
اعرض سلم تحويل raw→display مع d=6 وتسوية أرصدة S0 وعمودي الإجمالي 9,000 والسياسة E4,000 منفصلين. سمّ F1 d=9 عدم تطابق دقة؛ واعرض إجمالي S1 من 9,250 دون رسم حائزين مختلق.
وحدات وسياسات عرض توضيحية؛ لا سعر أو تقدير تداول حقيقي.
استخدم SVG/HTML حتميًا أو رسومًا ببدائل نصية، وكحليًا داكنًا/أسود مع سماوي وأزرق كهربائي وبنفسجي باعتدال. سمّ كل كمية وعدم يقين. عند 390px رتّب اللوحات رأسيًا؛ يبقى تحقق 768px/سطح المكتب و RTL العربي عملًا مستقبليًا للأصول. أبق المعرّفات LTR والمحاور الواقعية/اتجاهات الروابط دون تغيير. استخدم علامة BlockAssay الرسمية المقدمة وحدها إذا أُضيفت العلامة التجارية. كلا السجلين مواصفات، لا أصول مسلّمة.
الأدوات
استخدم RADAR لغرض الدرس التعليمي المحدود فقط إذا تحقق دعم الشبكة والهوية الدقيقة والحقول والمصدر والسياق. لا يقرر هذا المحتوى نقطة نهاية وقت تشغيل أو قدرة مزود. استخدم البيانات المضمنة دون اتصال ودون وصول مدفوع. تبقى البيانات المفقودة مجهولة؛ ولا حاجة لاتصال محفظة أو توقيع معاملة أو إطلاق رمز أو تداول مباشر. لا يغير التقدم في Academy والمدفوعات والإحالات أدلة Radar أبدًا. يحفظ Diagnostic Passport الملاحظات والحدود، لا توقع سعر أو شهادة سلامة.
المصادر وحدود الادعاءات
- [أصول Solana](https://solana.com/docs/tokens) — هوية حساب الإصدار/الحساب/البرنامج والمنازل العشرية؛ ميّز حقول ملكية الحساب. فُحص 2026-09-30.
- [Solana getTokenSupply](https://solana.com/docs/rpc/http/gettokensupply) — العرض الخام والمنازل وسياق استجابة RPC؛ لا تعريف عرض متداول. فُحص 2026-09-30.
- [معيار رموز ERC-20](https://eips.ethereum.org/EIPS/eip-20) — واجهة قياسية؛ اسم ورمز مختصر ومنازل عشرية اختيارية؛ لا شهادة امتياز أو هوية. فُحص 2026-09-30.
تدعم الوثائق الآليات، لا قيم البيانات الخيالية. جميع الأمثلة وسجلات التمارين مادة ILLUSTRATIVE أصلية مجمدة في هذا الملف. S0/S1 تسميات سياق اصطناعية؛ observedAt هي null إذ لم يُجمع قياس لسجل مباشر أو تاريخي. أعد مراجعة الوثائق والسلوك المنشور الفعلي قبل أي نشر أو تكامل.
الدرس التالي
P08-L03 بعد التمرين المحلول ومراجعة الاختبار.
مواصفات العناصر البصرية
P08-L02-V01
أين يغير تحويل الوحدات والاستبعاد المقياس المبلغ عنه؟
وحدات وسياسات عرض توضيحية؛ لا سعر أو تقدير تداول حقيقي.
اعرض سلم تحويل raw→display مع d=6 وتسوية أرصدة S0 وعمودي الإجمالي 9,000 والسياسة E4,000 منفصلين. سمّ F1 d=9 عدم تطابق دقة؛ واعرض إجمالي S1 من 9,250 دون رسم حائزين مختلق.
مجموع أربعة أرصدة 9,000 رمز؛ تترك الاستبعادات 4,000؛ ويعطي مجموع الأحداث 9,250 لاحقًا بتخصيص مجهول.
لوحات متراصة عند 390px مع مكافئ نصي؛ تحقق لاحقًا من 768px وسطح المكتب
تسميات وتنقل RTL؛ المعرّفات معزولة LTR؛ احفظ المحاور العددية وترتيب الأحداث واتجاه الروابط الواقعي.
FIX-P08-02
P08-L02-V02
أي ادعاء مسنود أو مشروط أو مجهول أو غير مسنود؟
حدود أدلة توضيحية؛ لا حكم سلامة أو استثمار.
أربعة صفوف مسماة OBSERVED/INFERRED/UNKNOWN/INSUFFICIENT EVIDENCE مرتبطة بادعاءات هذا الدرس ومعرّفات سجلاته. الملاحظات سجلات خيالية مقدمة، لا قياسات مباشرة.
أربعة صفوف لحالات الأدلة مع مواضع السجلات وخطوات التحقق التالية.
لوحات متراصة عند 390px مع مكافئ نصي؛ تحقق لاحقًا من 768px وسطح المكتب
تسميات وتنقل RTL؛ المعرّفات معزولة LTR؛ احفظ المحاور العددية وترتيب الأحداث واتجاه الروابط الواقعي.
FIX-P08-02
المصادر وحدود الادعاءات
S08-TOKENS · official_documentation_or_standard
أصول Solana
- الادعاء المدعوم
- هوية حساب الإصدار/الحساب/البرنامج والمنازل العشرية؛ ميّز حقول ملكية الحساب.
- حدود التحقق
- فُحصت الصفحة الأولية لدعم الآلية تحريريًا؛ ولم يُقَس أصل منشور أو مجموعة بيانات سجل بصورة مستقلة.
- تاريخ التحقق
- 2026-09-30
https://solana.com/docs/tokens
S08-SUPPLY · official_documentation_or_standard
Solana getTokenSupply
- الادعاء المدعوم
- العرض الخام والمنازل وسياق استجابة RPC؛ لا تعريف عرض متداول.
- حدود التحقق
- فُحصت الصفحة الأولية لدعم الآلية تحريريًا؛ ولم يُقَس أصل منشور أو مجموعة بيانات سجل بصورة مستقلة.
- تاريخ التحقق
- 2026-09-30
https://solana.com/docs/rpc/http/gettokensupply
S08-ERC20 · official_documentation_or_standard
معيار رموز ERC-20
- الادعاء المدعوم
- واجهة قياسية؛ اسم ورمز مختصر ومنازل عشرية اختيارية؛ لا شهادة امتياز أو هوية.
- حدود التحقق
- فُحصت الصفحة الأولية لدعم الآلية تحريريًا؛ ولم يُقَس أصل منشور أو مجموعة بيانات سجل بصورة مستقلة.
- تاريخ التحقق
- 2026-09-30
https://eips.ethereum.org/EIPS/eip-20
منشأ مجموعة البيانات
id: FIX-P08-02
dataStatus: ILLUSTRATIVE
observedAt: null
source: Original frozen educational fixture embedded in lesson
timeBasis: Synthetic S0/S1 snapshots, not UTC observations or real blocks
identifiers: Deliberately invalid fictional network, asset and account labels; never use as transaction targets
scope: Exhaustive fictional raw balances, explicit exclusion policy and complete mint/burn sequence.