الأداة AT-W38REV. 2026-A
مولّد قائمة السماح Merkle: الجذر والإثباتات للسكّ والتوزيع المجاني
يُحفَظ من قائمة سماح Merkle في العقد الذكي ناتج تجزئة واحد فقط، هو الجذر. ويحصل كل عنوان في القائمة على إثبات قصير يتألف من 13 أو 14 ناتج تجزئة عند وجود 10,000 عنوان. ويتحقق العقد عند السكّ أو المطالبة من أهلية العنوان. يُنشئ المولّد الجذر والإثباتات بطريقة OpenZeppelin، بعد فحص كل عنوان وفق EIP-55 والتحقق من التكرار.
- مجاني
- دون تسجيل
- الحساب يتم في المتصفح
01 / المولّد
ألصقوا القائمة للحصول على الجذر والإثباتات
المولّد · جذر Merkle والإثباتات
تحسب الأداة الجذر والإثباتات وفق طريقة OpenZeppelin. ومع ذلك، اختبروا العقد والمطالبة على شبكة تجريبية قبل ربطهما بأصول حقيقية. أدخلوا العناوين العامة فقط، وأبقوا المفاتيح الخاصة سرّية.
يحذف هذا الخيار الأسطر غير الصالحة والإدخالات المكررة، ويجمع الكميات المختلفة للعناوين المكررة. أعيدوا الحساب بعد ذلك.
إثبات لأحد العناوين
التصدير
يمكن قراءة ملف الشجرة باستخدام StandardMerkleTree.load() أو SimpleMerkleTree.load() بحسب التنسيق. ويضم ملف الإثباتات لكل عنوان الكمية والورقة والإثبات، وهي البيانات التي تحتاج إليها صفحة المطالبة.
التحقق داخل العقد (Solidity)
تجري الحسابات في متصفحكم. ولا تُرسل القائمة أو تُحفظ.
02 / الأساس
جذر واحد في العقد وإثبات لكل عنوان
قد يبدو تخزين كل العناوين المؤهلة داخل العقد هو الحل الأبسط، لكنه مكلف. يكلّف كل موضع تخزين جديد 20,000 وحدة Gas على الأقل. وعند وجود 10,000 عنوان، يبلغ ذلك 200,000,000 وحدة Gas لمجرد إدراجها. أما شجرة Merkle فتتيح إبقاء القائمة خارج سلسلة الكتل وتخزين قيمة واحدة طولها 32 بايت في العقد.
تبدأ العملية بتجزئة كل سطر من القائمة للحصول على ورقة. وبعد ذلك تُجزّأ كل ورقتين معًا وتُكرّر العملية مع كل زوج من النتائج حتى تبقى قيمة واحدة هي الجذر. وإذا تغيّر رقم واحد فقط في إحدى الكميات، يتغيّر الجذر. وتعود الفكرة إلى طريقة توقيع من عام 1987 ينمو فيها حجم التوقيع لوغاريتميًا مع عدد الرسائل Merkle 1988.
عند المطالبة، يرسل المستفيد الإثبات (Proof بالإنجليزية)، وهو نواتج تجزئة العقد الشقيقة على طول المسار من ورقته إلى الجذر. ويعيد العقد حساب المسار ويقارن النتيجة بالجذر المحفوظ. وهذا مبدأ بنى البيانات الموثَّقة، إذ يستطيع المستلِم التحقق من الإثبات بنفسه من دون الوثوق بمصدر البيانات Tamassia 2003. لذا لا تستطيع صفحة المطالبة اختلاق إدخال، لأن العقد يرفض الإثبات الخاطئ.
الشكل 1 · قيم فعلية مختصرة لأربعة عناوين من المثال (التنسيق القياسي، العنوان فقط). إثبات 0x2222…2222 يتألّف من ناتجَي تجزئة.
| العناوين | نواتج التجزئة لكل إثبات | الحد الأقصى لحجم الإثبات | الحد الأقصى لتكلفة Calldata | الحد الأدنى لتكلفة حفظ القائمة في العقد |
|---|---|---|---|---|
| 100 | 6 أو 7 | 224 بايت | 3,584 وحدة Gas | 2,000,000 وحدة Gas |
| 1.000 | 9 أو 10 | 320 بايت | 5,120 وحدة Gas | 20,000,000 وحدة Gas |
| 10.000 | 13 أو 14 | 448 بايت | 7,168 وحدة Gas | 200,000,000 وحدة Gas |
| 100.000 | 16 أو 17 | 544 بايت | 8,704 وحدة Gas | 2,000,000,000 وحدة Gas |
| 1.000.000 | 19 أو 20 | 640 بايت | 10,240 وحدة Gas | 20,000,000,000 وحدة Gas |
تُحسب تكلفة Calldata على أساس 16 وحدة Gas لكل بايت (EIP-2028)، والتخزين على أساس 20,000 وحدة Gas لكل موضع جديد (Yellow Paper، G_sset). وتُضاف 2,100 وحدة Gas عند الوصول إلى موضع بارد وفق EIP-2929. البيانات حتى 14 نوفمبر 2026.
يزداد حجم الإثبات ببطء مع حجم القائمة. فالانتقال من 10,000 عنوان إلى مليون يضيف 6 نواتج تجزئة. ويتحمّل المستفيد تكلفة الإثبات في معاملته، بينما يحتفظ العقد بالجذر وحده مهما بلغ طول القائمة.
03 / التنسيق
العقد يحدّد التنسيق
يجب أن يحسب المولّد والعقد الورقة بالطريقة نفسها تمامًا. إذ يكفي اختلاف بايت واحد لتفشل كل مطالبة برسالة «Invalid proof». لذا اختاروا في الخطوة 1 التنسيق الذي يستخدمه العقد.
| التنسيق | الورقة في Solidity | البايتات قبل التجزئة | ملف الشجرة | الاستخدام |
|---|---|---|---|---|
| OpenZeppelin StandardMerkleTree | keccak256(bytes.concat(keccak256(abi.encode(account, amount)))) | 64 | standard-v1 | للعقود الجديدة. ويمكن تحميل ملف الشجرة مباشرةً بواسطة StandardMerkleTree.load(). |
| بسيط (abi.encodePacked) | keccak256(abi.encodePacked(account, amount)) | 52 | simple-v1 | للعقود الحالية التي تتحقق بهذه الطريقة. تطابق بنية الشجرة بنية SimpleMerkleTree. |
العنوان فقط: keccak256(bytes.concat(keccak256(abi.encode(account)))) أو keccak256(abi.encodePacked(account)) بحسب التنسيق. وفق OpenZeppelin merkle-tree 1.0.8 وContracts 5.7.0.
لماذا يستخدم OpenZeppelin التجزئة المزدوجة؟
تنتج العقدة الداخلية عن تجزئة 64 بايت تتألف من ناتجَي تجزئة متتابعين. وإذا كانت الورقة قبل التجزئة بطول 64 بايت أيضًا، فقد يحدث التباس بين الورقة والعقدة الداخلية. وهذا هو طول abi.encode(address, uint256) بالضبط. وتمنع التجزئة الثانية هذا الالتباس، وتحذّر وثائق OpenZeppelin في MerkleProof صراحةً من تجزئة قيم أوراق بطول 64 بايت مرة واحدة باستخدام keccak256. ولا يواجه التنسيق البسيط هذه المشكلة، لأن abi.encodePacked(address, uint256) ينتج 52 بايت فقط. احسبوا الطول مجددًا عند إضافة حقول أخرى إلى الورقة.
ترتيب الأزواج والأوراق
يرتّب التنسيقان ناتجَي التجزئة في كل زوج قبل دمجهما، فيأتي الأصغر أولًا. وبذلك لا يحتاج الإثبات إلى بيان جهة العقدة الشقيقة، وتتحقّق MerkleProof.verify من OpenZeppelin من التنسيقين. ويرتّب المولّد الأوراق أيضًا كما يفعل OpenZeppelin. وقد تتبّع مكتبات أخرى ترتيبًا مختلفًا، مثل merkletreejs من دون sortLeaves، فتنتج القائمة نفسها جذرًا مختلفًا. وفي هذه الحالة استخدموا الأداة نفسها للجذر والإثباتات.
يتحقق اختبارنا عند كل تغيير من تطابق طريقة حساب المولّد مع OpenZeppelin. فمثال README للمكتبة، المكوّن من عنوانين مع كميتين، ينتج الجذر 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77 المطابق للأصل محرفًا بمحرف. ويعيد الاختبار حساب ملفات الاختبار من مستودع OpenZeppelin عقدةً عقدةً. ويمكنكم لصق ملف شجرة من مشروعكم (tree.json) في الخطوة 3 ليبيّن المولّد ما إذا كان يطابق قيمه الأصلية.
أخطاء شائعة في القوائم
- أخطاء كتابة العناوين. وفق EIP-55، يتضمّن نمط الحروف الكبيرة والصغيرة قيمة تحقق. وإذا لم تطابق القيمة العنوان، يشير المولّد إلى السطر. أما العناوين المكتوبة كلها بحروف صغيرة فلا تحمل قيمة تحقق، وبالتالي قد تمرّ أخطاء الكتابة دون اكتشاف. يقارن مدقّق عناوين Ethereum العناوين الفردية محرفًا بمحرف.
- الكميات المصدّرة من Excel. يحسب Excel بدقة 15 خانة. فعند التصدير قد يتحوّل 5000000000000000001 إلى 5E+18، وتضيع الخانات الأخيرة. يرفض المولّد هذا الترميز. اضبطوا تنسيق العمود في الجدول على «نص».
- الرمز أم أصغر وحدة. يعادل رمز واحد له 18 منزلة عشرية مقدار 10¹⁸ من أصغر الوحدات (wei)، بينما يبلغ عدد المنازل في USDC ستًا (6). وعند إدخال الكميات بوحدات الرمز، حدّدوا المنازل العشرية في الخطوة 2. وتعرض النتيجة المجموع بالوحدتين للتحقق.
- العناوين المكررة. يتعامل العقد مع العنوان المكتوب بحروف صغيرة والعنوان نفسه المكتوب بقيمة تحقق بوصفهما عنوانًا واحدًا. ويكشف المولّد التكرار ويمكنه دمج الإدخالات عند الطلب. فيحذف الأسطر المتماثلة ويجمع الكميات المختلفة.
04 / التوزيع
هل توزّعون الرموز مباشرةً أم تتيحون المطالبة بها؟
درس Allen وBerg وLane أسباب توزيع المشاريع للرموز مجانًا في عمليات من 2014 إلى 2022. وتبيّن أن أبرزها التسويق وتوسيع نطاق الملكية والتحكم Allen وآخرون، 2023. والهدف أن يصل التوزيع إلى عدد كبير من الأشخاص بتكلفة لا تفوق فائدته.
هناك طريقتان أساسيتان. في الإرسال المباشر (Push)، يحوّل الموزّع الرموز لكل مستفيد بنفسه. وفي الاستلام عند الطلب (Pull)، يطالب المستفيدون بمخصّصاتهم، وهذا هو نمط المطالبة باستخدام Merkle. حلّل Fröwis وBöhme 35 سيناريو ووجدا أن الاستلام عند الطلب يوفّر للموزّع قدرًا محدودًا، ويحمّل كل مستفيد تكلفة مرتفعة نسبيًا. وبوجه عام، تزيد التكاليف في كل الطرق تقريبًا بالتناسب مع عدد المستفيدين Fröwis وBöhme، 2019. لذا تتمثّل الفائدة الرئيسية للمطالبة باستخدام Merkle في تنظيم التوزيع. فتبقى القائمة خارج العقد، ولا يستلم المستفيدون إلا المخصّصات التي يطالبون بها.
| الطريقة | من يدفع الرسوم | الجهد عند الإطلاق | التغيير لاحقًا |
|---|---|---|---|
| التحويل المباشر (Push) | الموزّع، بتحويل مستقل لكل مستفيد | يزداد مع كل عنوان | غير ممكن بعد إرسال التحويل |
| تخزين القائمة في العقد | الموزّع يدفع تكلفة التسجيل (ابتداءً من 20,000 وحدة Gas لكل عنوان)، والمستفيد يدفع تكلفة المطالبة | يزداد مع كل عنوان | تعديل كل إدخال على حدة عبر دالة إدارية |
| جذر Merkle (Pull) | المستفيد يدفع تكلفة المطالبة والإثبات | موضع تخزين واحد للجذر | فقط عبر جذر جديد. تحقّق من الإثباتات مقارنةً بالجذر الجديد |
قد تفوق رسوم المطالبة قيمة المخصّصات الصغيرة. ويمكنكم حينئذٍ التوزيع على سلسلة من الطبقة الثانية (Layer-2) أقل تكلفة أو تحديد كمية دنيا. وتقدّر حاسبة Gas تكلفة المطالبة بأسعار Gas الحالية.
سكّ NFT: قائمة سماح بدل المزايدة على الرسوم
عندما يكون السكّ مفتوحًا والكمية محدودة، يتنافس المشترون برفع رسوم Gas، فترتفع الرسوم للجميع ويُهدر الغاز. وقد أظهرت دراسة لإطلاقات NFT ذلك، واقترحت إجراء قرعة Ko وآخرون، 2023. وتزيل قائمة السماح ذات النافذة الزمنية المحددة هذا السباق أيضًا. وقد تخصّصت روبوتات في مراقبة المعاملات المعلّقة وتجاوزها برسوم أعلى Daian وآخرون، 2020.
لذلك يجب أن يتطابق عنوان الورقة مع عنوان المستفيد في العقد. ومن أبسط الطرق أن يحسب العقد الورقة من msg.sender كما في مقتطف Solidity الذي يقدّمه المولّد. وعندئذٍ لا يستطيع من يرى الإثبات في مجموعة المعاملات المعلّقة (Mempool) استخدامه لمنفعته الشخصية.
05 / الحسابات المتعددة
حدود القائمة: الحسابات المتعددة والخصوصية
تتحقّق شجرة Merkle من ورود العنوان في القائمة، لكنها لا تحدّد ما إذا كانت عشرة عناوين تعود إلى عشرة أشخاص أو إلى شخص واحد. وهذه نتيجة معروفة في علوم الحاسوب: من دون جهة تثبت الهويات، لا يمكن منع الهويات المتعددة (هجمات Sybil) إلا بافتراضات غير واقعية Douceur 2002. لذا يقتصر فحص التكرار على العنوان نفسه ولو كُتب بصورة مختلفة.
- صيد التوزيعات المجانية شائع. وصف Fan وزملاؤه في دراسة لتوزيع ParaSwap عدة أنماط لاستحواذ المشاركين على المخصّصات، لم تكشفها طرق الفرز المعتادة بما يكفي Fan وآخرون، 2023. وتحلّل الطرق الأفضل الرسوم البيانية للمعاملات والبيانات الوصفية Zhou وآخرون، 2024. وذلك يحتاج إلى بيانات من السلسلة، فالقائمة وحدها لا تكفي.
- يبحث المشاركون عن طرق لاستغلال القواعد. بمجرد إعلان المعايير، يتكيّف المستخدمون معها. ويلاحظ Allen أن المعايير تزداد تعقيدًا ويتوقّع توزيع المخصّصات على جولات Allen 2024. وتحصل كل جولة على جذر مستقل، فلا تعود إثباتات الجولة القديمة صالحة.
- حجم التداول معيار غير موثوق. ظهرت لدى 3.93 بالمئة من العناوين في أكبر 52 مجموعة NFT أنماط تشبه التداول الصوري، في الغالب عبر تداولات متبادلة بين عدد قليل من العناوين von Wachter وآخرون، 2023.
- المهام تجذب البرامج الآلية. اجتذب نظام مهام شهد إتمام 80 مليون مهمة مزارعي المكافآت والروبوتات، وكان من الصعب التمييز بين المستخدمين الفعليين والبرامج الآلية Al-Chami وClark، 2025. وتدوم فاعلية المعايير التي يصعب أتمتتها بتكلفة منخفضة مدة أطول.
- وسائل الحماية تقع خارج نطاق القائمة. إثبات وجود شخص حقيقي وراء العنوان، مثل الاعتماد على التزكية والتصويت في المجتمع، مجال مستقل له نقاط ضعفه Siddarth وآخرون، 2020.
متى تصبح العناوين والإثباتات مرئية
بمجرد إدراج الجذر في العقد، يصبح علنيًا. وتكشف المطالبة العنوان والإثبات، والكمية عند الاقتضاء، على السلسلة. يحتوي ملف الشجرة بالتنسيق القياسي وملف الإثباتات على جميع العناوين والكميات المُدخلة لكل منها. ويحفظ ملف الشجرة بالتنسيق البسيط الأوراق على هيئة تجزئات. وتُظهر دراسة لتوزيع رموز Clam المجاني (Airdrop) لعام 2014 مقدار ما يمكن استنتاجه من هذه البيانات: فمن خلال النشاط على السلسلة الجديدة، أمكن ربط عناوين الشخص نفسه عبر ثلاث سلاسل كتل أخرى Harrigan وآخرون، 2018. وإذا كانت القائمة مستمدة من ملف عملائكم، فينبغي إدراج نشرها مسبقًا في مراجعة حماية البيانات. ولا يرسل المولّد نفسه أي شيء؛ بل يجري العمليات الحسابية في متصفحكم.
06 / طريقة العمل
كيفية إعداد قائمة سماح
- وثّقوا المعايير والموعد المرجعي. من يحصل على أي كمية، وأي كتلة تُتّخذ مرجعًا للاختيار؟ دوّنوا الإجابات قبل إعداد القائمة حتى يمكن تفسير غياب عنوان لاحقًا.
- صدّروا القائمة بدقة. احفظوا الكميات بصيغة النص حتى تبقى الخانات كاملة، وحدّدوا ما إذا كانت بأصغر الوحدات أو بوحدات الرمز.
- اختاروا التنسيق وفق العقد. للعقد الجديد، اختاروا تنسيق OpenZeppelin. وللعقد الحالي، راجعوا كيف يحسب الورقة واضبطوا الخطوة 1 وفق ذلك.
- اختبروا المطالبة على شبكة تجريبية. سجّلوا الجذر في العقد واختبروا المطالبة فعليًا بعنوانين أو ثلاثة، بينها عنوان غير مدرج. وإذا فشلت إحدى المطالبات، تُظهر أداة التحقق الموضع الذي يتوقف عنده المسار.
- احتفظوا بالقائمة وملف الشجرة. يعيد المولّد حساب الجذر نفسه عند استخدام القائمة المطابقة تمامًا. وتغيير سطر واحد يجعل النتائج مختلفة.
- خطّطوا لنهاية التوزيع منذ البداية. أضيفوا إلى العقد قبل تشغيله مهلة للمطالبة ودالة لاسترجاع المخصّصات المتبقية. فإذا كان العقد غير قابل للترقية، يتعذّر إضافة ذلك لاحقًا.
حدود المولّد
- يقتصر الفحص على التكرار. يكشف المولّد العناوين المتطابقة دون تحديد ما إذا كانت عدة عناوين تعود إلى شخص واحد.
- يدعم بنية شجرة واحدة. وهي بنية OpenZeppelin ذات الأوراق المرتّبة. ولا يعيد المولّد بناء أشجار المكتبات الأخرى، لكن أداة التحقق تستطيع فحص إثباتاتها الفردية.
- الأوراق من النوعين address وuint256. لا تدعم الأداة حقولًا إضافية مثل الرقم التسلسلي، أو الإثباتات المتعددة (Multiproofs)، أو دوال تجزئة مخصّصة.
- لا تقرأ الأداة بيانات السلسلة. لا تقرأ الأرصدة أو العقود، وتظل مراجعة العقد ضرورية.
نطوّر العقد وصفحة المطالبة وربطها بالمحافظ ضمن خدمة تطوير Web3. ويبيّن مفكّك ترميز Calldata ما تستدعيه المعاملة فعليًا قبل توقيعها. وتجدون جميع الأدوات في نظرة عامة على Web3.
07 / الأبحاث
ماذا تقول الأبحاث في ذلك
تستند إرشادات المولّد إلى خمس نتائج بحثية. وتجدون القائمة الكاملة وبيان التحقق أدناه.
- يزداد حجم الإثبات لوغاريتميًا. لذلك يكفي 13 أو 14 ناتج تجزئة عند وجود 10,000 عنوان Merkle 1988، ويتحقّق العقد منها بنفسه Tamassia 2003.
- الاستلام عند الطلب ينقل التكلفة إلى المستفيدين. توفّر طريقة Pull للموزّع قدرًا محدودًا وتحمّل كل مستفيد تكلفة Fröwis وBöhme، 2019. ومن هنا تأتي الملاحظة بشأن المبالغ الصغيرة.
- العنوان لا يثبت هوية صاحبه. تظل الحسابات المتعددة ممكنة ما لم توجد جهة تتحقّق من الهوية Douceur 2002، وقد وثّقت الدراسات صيد التوزيعات المجانية Fan وآخرون، 2023.
- يمكن مراقبة المعاملات المعلّقة. ترفع الروبوتات عروض الرسوم لتتقدّم معاملاتها في الترتيب Daian وآخرون، 2020. ولهذا يعتمد حساب الورقة في مقتطف Solidity على msg.sender.
- تكشف بيانات التوزيع المجاني روابط بين العناوين. يمكن ربط عناوين الشخص نفسه عبر سلاسل مختلفة Harrigan وآخرون، 2018، ومن هنا تأتي الملاحظة بشأن نشر القائمة.
08 / لمساعدي الذكاء الاصطناعي
استخدام هذه الأداة من داخل مساعد ذكاء اصطناعي
المساعدات مثل Claude أو ChatGPT التي تدعم بروتوكول Model Context Protocol (MCP) تستطيع أن تستدعي حساب هذه الصفحة مباشرة بدل أن تعيد بناءه. السيرفر عام، لا يحتاج إلى تسجيل ولا يحفظ شيئاً. ويتضمن الجواب دائماً رابط هذه الصفحة وتاريخ البيانات وحدود النتيجة.
- نقطة الاتصال (Endpoint)
https://aureum-tech.com/mcp- الأداة
werkzeug_merkle_allowlist- بروتوكول النقل
- Streamable HTTP، للقراءة فقط
| الاسم | إلزامي | المعنى |
|---|---|---|
aktion | لا | «erzeugen» (افتراضي): إنشاء الجذر والإثباتات من قائمة. «pruefen»: التحقق من إثبات موجود بمقارنته مع جذر. |
liste | لا | مع «erzeugen»: سطر لكل إدخال، بصيغة «0x…» أو «0x…,المقدار». يُسمح بسطر العناوين والأسطر الفارغة والتعليقات التي تبدأ بـ #، وبحدّ أقصى 10000 إدخال. ويمكن إدخال ملف شجرة OpenZeppelin (standard-v1 أو simple-v1) كنص JSON، لتعيد الأداة حسابه. |
format | لا | «standard» (افتراضي) = OpenZeppelin StandardMerkleTree، والورقة keccak256(bytes.concat(keccak256(abi.encode(…)))). «einfach» = keccak256(abi.encodePacked(…)) مع ترتيب الأزواج. |
inhalt | لا | «adresse» (افتراضي): تُحسب الورقة من العنوان وحده، مثل قائمة سماح للسكّ. «menge»: العنوان والكمية (uint256)، مثل التوزيع المجاني. |
dezimalstellen | لا | مع «menge» فقط: المنازل العشرية للرمز. 0 (افتراضي) = الكميات بأصغر الوحدات مسبقًا. 18 = الكميات بوحدات الرمز وتُحوَّل إلى wei. |
beweise_fuer | لا | العناوين التي يُطلب إرجاع إثباتها. وإذا لم تُحدّد، تُعاد إثباتات جميع العناوين عندما لا تتجاوز القائمة 20 إدخالًا. |
mit_baumdatei | لا | أرفقوا ملف الشجرة بتنسيق OpenZeppelin (StandardMerkleTree.load / SimpleMerkleTree.load) لما يصل إلى 1000 إدخال. |
root | لا | مع «pruefen»: جذر Merkle، بصيغة 0x متبوعة بـ64 محرفًا سداسيًا عشريًا. |
adresse | لا | مع «pruefen»: العنوان المطلوب التحقق من إثباته، أو ناتج تجزئة الورقة مباشرةً (bytes32). |
menge | لا | مع «pruefen» والمحتوى «menge»: الكمية بأصغر الوحدات على شكل عدد صحيح، مثل «5000000000000000000». |
beweis | لا | مع «pruefen»: نواتج تجزئة الإثبات مرتّبة من الورقة إلى الجذر، وكل منها بالصيغة 0x متبوعةً بـ64 محرفًا سداسيًا عشريًا. |
أسئلة يُفترض أن يستدعي المساعد الأداة عندها
- «أنشئ جذر Merkle لقائمة السماح هذه بتنسيق OpenZeppelin وأعطني إثبات العنوان الأول».
- «ما جذر Merkle لهذا التوزيع المجاني الذي يتضمن العنوان والكمية بوحدة wei؟ وكيف أتحقق من الورقة في Solidity؟»
- «هل يطابق إثبات Merkle هذا جذري، أم أن عقدي يستخدم abi.encodePacked بدلًا من abi.encode؟»
- «هل لا يزال ملف tree.json من StandardMerkleTree يطابق القيم التي يحتويها؟»
كيف يتم الربط، وما الذي يمكن أن يقدمه MCP في شركتكم: تجدون ذلك في صفحة تكاملات MCP.
09 / الأسئلة الشائعة
أسئلة شائعة حول جذر Merkle والإثبات وقائمة السماح
ما قائمة سماح Merkle؟
قائمة بالعناوين المؤهلة يُحفَظ منها في العقد الذكي ناتج تجزئة واحد فقط، هو جذر Merkle. ويحصل كل عنوان على إثبات مكوّن من بضعة نواتج تجزئة، مثل 13 أو 14 عند وجود 10,000 عنوان. ويُرسل الإثبات عند السكّ أو المطالبة، فيتحقق العقد من أنه يقود إلى الجذر. وتبقى القائمة خارج سلسلة الكتل.
لماذا يُجري OpenZeppelin تجزئةً مزدوجة للورقة؟
تنتج العقدة الداخلية في الشجرة عن تجزئة 64 بايت تتألف من ناتجَي تجزئة متتابعين. ولو كانت الورقة قبل التجزئة بطول 64 بايت أيضًا، لأمكن تقديم عقدة داخلية على أنها ورقة. ويبلغ طول abi.encode(address, uint256) بالضبط 64 بايت. تمنع التجزئة الثانية هذا الالتباس. وتحذّر وثائق OpenZeppelin في MerkleProof صراحةً من استخدام keccak256 مرة واحدة لقيم أوراق طولها 64 بايت.
لماذا تفشل المطالبة وتظهر رسالة «Invalid proof»؟
غالبًا ما يبني العقد الورقة بطريقة تختلف عن أداة إنشاء الإثباتات، مثل استخدام abi.encode بدلًا من abi.encodePacked، أو التجزئة مرة واحدة بدلًا من مرتين، أو تسجيل الكمية بالرموز الكاملة بدلًا من أصغر وحداتها. وقد يكون الجذر مأخوذًا أيضًا من إصدار سابق للقائمة. وتعيد أداة التحقق أسفل المولّد حساب المسار خطوة بخطوة. جرّبوا فيها التنسيقين والوحدتين.
هل تتوافق النتيجة مع OpenZeppelin StandardMerkleTree؟
نعم. تتطابق الورقة وترتيبها وبنية الشجرة، وتحمّل StandardMerkleTree.load() ملف الشجرة بتنسيق standard-v1 مباشرةً. ويُنتج مثال README الخاص بالمكتبة في المولّد الجذر نفسه الذي يُنتجه OpenZeppelin، وهو 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77. ويستخدم التنسيق البسيط بنية SimpleMerkleTree (simple-v1).
ما حجم إثبات Merkle في قائمة تضم 10,000 عنوان؟
يتألف من 13 أو 14 ناتج تجزئة، طول كل منها 32 بايت، أي 448 بايت على الأكثر. وتبلغ تكلفة إرسالها كبيانات استدعاء 7,168 وحدة Gas على الأكثر، بحساب 16 وحدة Gas لكل بايت وفق EIP-2028. وعند وجود مليون عنوان، يتألف الإثبات من 20 ناتج تجزئة. في المقابل، قد يكلّف حفظ القائمة كاملةً في العقد 20,000 وحدة Gas على الأقل لكل عنوان.
هل يمكنني تغيير القائمة بعد نشر العقد؟
لا يتم ذلك إلا عبر جذر جديد. فحتى تغيير كمية واحدة ينتج عنه جذر جديد. تحقّقوا من الإثباتات مقارنةً بهذا الجذر الجديد، حتى إن بقيت بعض الإثباتات دون تغيير. يحتاج العقد إلى دالة تتيح لشخص مخوّل استبدال الجذر؛ ومن دونها تبقى القائمة كما هي. ومن يوزّع على جولات يخصّص لكل جولة جذرًا خاصًا ويسجّل في العقد من استلم بالفعل في كل جولة.
هل تحمي قائمة سماح Merkle من الروبوتات والحسابات المتعددة؟
تمنع العناوين الغائبة عن القائمة. لكنها لا تمنع إنشاء حسابات متعددة، إذ يمكن لمن أدرج عشرين عنوانًا أن يجتاز التحقق عشرين مرة. لذا تُفرَز العناوين قبل إدخالها في المولّد، وتبيّن دراسات التوزيع المجاني أن القواعد البسيطة لا تكفي لذلك.
ما حدود مولّد Merkle؟
يحسب الجذر والإثباتات ويُنشئ الملفات ويفحص العناوين والتكرار، وكل ذلك في المتصفح. ولا يكشف الحسابات المتعددة أو يقرأ بيانات من السلسلة. ويستخدم بنية OpenZeppelin وحدها، وتظل مراجعة العقد ضرورية. ويمكنكم تكليفنا بإعداد العقد وصفحة المطالبة والاختبار على شبكة تجريبية.
10 / دراسات ومصادر
على ماذا تستند الأداة
القيم التقريبية والملاحظات أعلاه تستند إلى هذه الأبحاث العلمية الـ 14. وقد تحققنا من كل بحث عبر رقم DOI الخاص به أو عبر صفحة الناشر (آخر مرة في 14 تشرين الثاني/نوفمبر 2026): البحث موجود، ولم يُسحب، وما توصل إليه ما زال صالحاً للإجابة عن السؤال اليوم.
Merkle, R. C. (1988): A Digital Signature Based on a Conventional Encryption Function. Advances in Cryptology – CRYPTO ’87, LNCS 293، ص. 369–378
النتيجة هذه هي الدراسة التي ترجع إليها شجرة Merkle. إذ تُربَط قيم كثيرة بقيمة واحدة باستخدام شجرة من نواتج التجزئة. ويزداد حجم التوقيع لوغاريتميًا مع عدد الرسائل الموقّعة.
في الأداة أساس شرح سبب اقتصار إثبات قائمة من 10,000 عنوان على 13 أو 14 ناتج تجزئة، كما في جدول طول الإثبات.
doi.org/10.1007/3-540-48184-2_32 · ورقة مؤتمر
Tamassia, R. (2003): Authenticated Data Structures. Algorithms – ESA 2003, LNCS 2832، ص. 2–5
النتيجة مراجعة لبنى البيانات الموثَّقة، إذ يجيب طرف ثالث غير موثوق عن الاستفسارات نيابةً عن مصدر موثوق، ويرفق إثباتًا يتحقق منه المستخدم بنفسه.
في الأداة تفسّر النتيجة توزيع الأدوار. يحتفظ الموقع بالقائمة، ويحتفظ العقد بالجذر ويتحقق بنفسه من الإثبات المرفق.
doi.org/10.1007/978-3-540-39658-1_2 · دراسة مراجعة
Fröwis, M.; Böhme, R. (2019): The Operational Cost of Ethereum Airdrops. Data Privacy Management, Cryptocurrencies and Blockchain Technology (DPM/CBT 2019), LNCS 11737، ص. 255–270
النتيجة أظهرت محاكاة 35 سيناريو للتوزيع المجاني إمكان خفض التكلفة إلى النصف، لكن ذلك يتطلّب ترتيبات في عقد الرمز. وتوفّر طرق الاستلام عند الطلب (Pull) قدرًا محدودًا للموزّع، وتحمّل كل مستفيد تكلفة مرتفعة نسبيًا.
في الأداة أساس المقارنة بين التوزيع المباشر والاستلام عند الطلب. وتُعدّ المطالبة باستخدام Merkle من نمط Pull، ويتحمّل المستفيد رسوم Gas.
doi.org/10.1007/978-3-030-31500-9_17 · ورقة مؤتمر
Harrigan, M.; Shi, L.; Illum, J. (2018): Airdrops and Privacy: A Case Study in Cross-Blockchain Analysis. 2018 IEEE International Conference on Data Mining Workshops (ICDMW)، ص. 63–70
النتيجة أظهر المؤلّفون في دراسة لتوزيع Clam في 2014 أنه يمكن ربط عناوين الشخص نفسه على Bitcoin وLitecoin وDogecoin من خلال النشاط على السلسلة الجديدة. وغالبًا ما يُنظر إلى التوزيع المجاني على أنه بلا مخاطر على المستفيدين، مما يؤدي إلى إغفال آثاره على الخصوصية.
في الأداة تفسّر النتيجة التنبيه إلى أن ملف الشجرة وملف الإثبات يكشفان كل عنوان والكمية المخصّصة له بمجرد نشرهما.
doi.org/10.1109/ICDMW.2018.00017 · ورقة مؤتمر
Allen, D. W. E.; Berg, C.; Lane, A. M. (2023): Why airdrop cryptocurrency tokens?. Journal of Business Research 163، المقالة 113945
النتيجة في دراسات حالات لتوزيعات مجانية معروفة من 2014 إلى 2022، كان أبرز دوافع توزيع الرموز هو التسويق لاجتذاب المستخدمين والحفاظ على المجتمع، وتوزيع الملكية والتحكم على نطاق أوسع.
في الأداة توضّح النتيجة أسباب إنشاء الشركات قائمة سماح أو تنظيم توزيع مجاني قبل الخوض في التفاصيل التقنية.
doi.org/10.1016/j.jbusres.2023.113945 · مجلة علمية
Allen, D. W. E. (2024): Crypto airdrops: An evolutionary approach. Journal of Evolutionary Economics 34 (4–5)، ص. 849–872
النتيجة أظهرت تسع دراسات حالة أن معايير التوزيع المجاني تزداد تعقيدًا لأن المستخدمين يتكيّفون مع كل قاعدة للحصول على المزيد. وتتوقّع الدراسة أن تنظّم المشاريع عدة جولات بدل توزيع واحد لكي تستفيد مما تتعلّمه.
في الأداة تدعم النتيجة توثيق المعايير قبل إنشاء القائمة، وإنشاء جذر مستقل لكل جولة.
doi.org/10.1007/s00191-024-00874-6 · مجلة علمية
Fan, S.; Min, T.; Wu, X.; Cai, W. (2023): Altruistic and Profit-oriented: Making Sense of Roles in Web3 Community from Airdrop Perspective. Proceedings of the 2023 CHI Conference on Human Factors in Computing Systems، ص. 1–16
النتيجة في تحليل لأدوار المشاركين في توزيع ParaSwap يستند إلى البيانات، كان من حصلوا على كميات أكبر أميل إلى العمل لصالح المجتمع. ووصف المؤلّفون أنماطًا متعددة لاستحواذ المشاركين على المخصّصات، وبيّنوا أن طريقة التحقّق المعتادة لا تستبعد صائدي التوزيعات بكفاءة كافية.
في الأداة تفسّر النتيجة حدود كشف هجمات Sybil. ينبغي فرز القائمة قبل إدخالها في المولّد.
doi.org/10.1145/3544548.3581173 · ورقة مؤتمر
Zhou, C.; Chen, H.; Wu, H.; وآخرون (2024): ARTEMIS: Detecting Airdrop Hunters in NFT Markets with a Graph Learning System. Proceedings of the ACM Web Conference 2024 (WWW ’24)، ص. 1824–1834
النتيجة يجمع صائدو التوزيعات المجانية عناوين محافظ متعددة بقصد الاستفادة من التوزيع أكثر من مرة. وفي مثال سوق Blur، كشفهم أسلوب تعلّم على الرسوم البيانية يعتمد على تسلسل المعاملات والبيانات الوصفية لـNFT بكفاءة أعلى بكثير من الأساليب السابقة.
في الأداة تؤكّد النتيجة أن كشف أنماط Sybil يتطلّب بيانات معاملات من السلسلة، وهي بيانات لا يملكها مولّد القوائم.
doi.org/10.1145/3589334.3645597 · ورقة مؤتمر
Douceur, J. R. (2002): The Sybil Attack. Peer-to-Peer Systems (IPTPS 2002), LNCS 2429، ص. 251–260
النتيجة يمكن لمن يقدّم هويات متعددة السيطرة على جزء كبير من نظام موزّع. وتظل هذه الهجمات ممكنة من دون جهة مركزية منطقيًا تتحقّق من الهويات، إلا في ظل افتراضات غير واقعية.
في الأداة تبيّن النتيجة حدود قاعدة «مطالبة واحدة لكل عنوان»، إذ يقتصر فحص التكرار على العناوين المتطابقة وقد تكون لشخص واحد عناوين متعددة.
doi.org/10.1007/3-540-45748-8_24 · ورقة مؤتمر
Siddarth, D.; Ivliev, S.; Siri, S.; Berman, P. (2020): Who Watches the Watchmen? A Review of Subjective Approaches for Sybil-Resistance in Proof of Personhood Protocols. Frontiers in Blockchain 3، المقالة 590171
النتيجة مراجعة لبروتوكولات تهدف إلى مقاومة هجمات Sybil دون جهة لإصدار إثبات الهوية، عبر التصويت والتزكية وتقييم المشاركين لبعضهم بعضًا، مع بيان نقاط القوة والضعف لكل نهج.
في الأداة تبيّن النتيجة الطرق التي تقع خارج نطاق القائمة للحد من تعدّد الهويات، مثل إثبات الشخص والتزكية.
doi.org/10.3389/fbloc.2020.590171 · دراسة مراجعة
von Wachter, V.; Jensen, J. R.; Regner, F.; Ross, O. (2023): NFT Wash Trading: Quantifying Suspicious Behaviour in NFT Markets. Financial Cryptography and Data Security. FC 2022 International Workshops, LNCS 13412، ص. 299–311
النتيجة في أكبر 52 مجموعة NFT بحسب حجم التداول (من 2018 إلى نوفمبر 2021)، ظهرت مؤشرات تلاعب محتمل بالسوق لدى 3.93 بالمئة من العناوين، تمثّل 2.04 بالمئة من المبيعات. وكانت معظم الأنماط معاملات متبادلة بين عدد قليل من العناوين.
في الأداة تبيّن النتيجة أن حجم التداول قد يكون مؤشرًا مضللًا لاختيار عناوين قائمة السماح، لأن شخصًا واحدًا يمكنه التحكّم في عدة عناوين بسهولة.
doi.org/10.1007/978-3-031-32415-4_20 · ورقة مؤتمر
Al-Chami, J.; Clark, J. (2025): Quest Love: A First Look at Blockchain Loyalty Programs. Financial Cryptography and Data Security. FC 2025 International Workshops, LNCS 15754، ص. 196–211
النتيجة حلّلت الدراسة نظامًا يضم 43 مهمة سُجّل إتمامها 80 مليون مرة خلال عشرة أشهر. وتصف جمع المكافآت على نطاق واسع والروبوتات، وتشرح صعوبة التمييز بين المستخدمين الفعليين والبرامج الآلية.
في الأداة تدعم النتيجة اختيار معايير يصعب استيفاؤها آليًا بتكلفة منخفضة قبل إدخال العناوين في المولّد.
doi.org/10.1007/978-3-032-00495-6_10 · ورقة مؤتمر
Ko, K.; Jeong, T.; Woo, J.; Hong, J. W.-K. (2023): Alleviating Crypto Gas War in NFT Launching. 2023 IEEE International Conference on Blockchain and Cryptocurrency (ICBC)، ص. 1–5
النتيجة عند إطلاق مجموعات NFT الرائجة، يتنافس المشترون برفع رسوم Gas في ما يُسمّى «Gas War»، ما يرفع الرسوم للجميع ويهدر Gas. وفي الدراسة، عالج الإطلاق عبر القرعة هذه المشكلة ووفّر 15.5 بالمئة على الأقل من Gas.
في الأداة توضّح النتيجة لماذا يكون السكّ بقائمة سماح أو بالقرعة أقل ازدحامًا من السكّ المفتوح بحسب أسبقية الوصول.
doi.org/10.1109/ICBC56567.2023.10174918 · ورقة مؤتمر
Daian, P.; Goldfeder, S.; Kell, T.; وآخرون (2020): Flash Boys 2.0: Frontrunning in Decentralized Exchanges, Miner Extractable Value, and Consensus Instability. 2020 IEEE Symposium on Security and Privacy (SP)، ص. 910–927
النتيجة تراقب الروبوتات المعاملات المعلّقة وتزايد في «Priority Gas Auctions» لتحصل معاملاتها على موضع أسبق داخل الكتلة. وتَقيس الدراسة هذه الظاهرة في منصّات التداول اللامركزية وتوضّح أن ترتيب المعاملات يُستغلّ.
في الأداة لهذا يربط مقتطف Solidity الورقة بـ msg.sender. وعندها لا يستفيد من يطّلع على إثبات في المعاملات المعلّقة منه لنفسه.
doi.org/10.1109/SP40000.2020.00040 · ورقة مؤتمر
معايير وجهات رسمية وبيانات الشركات المصنِّعة
- merkle-tree 1.0.8: StandardMerkleTree وSimpleMerkleTree وملف الشجرة والتجزئة المزدوجة · OpenZeppelin
- Contracts 5.x: MerkleProof وHashes.commutativeKeccak256، وتحذير بشأن أوراق بطول 64 بايت · OpenZeppelin
- بيانات الاختبار: ملف الشجرة لمثال README ضمن تطبيق المكتبة بلغة Go · FantasyJony (GitHub)
- EIP-55: ترميز عنوان التحقق بمزيج الأحرف الكبيرة والصغيرة · Ethereum Improvement Proposals
- EIP-2028: Transaction data gas cost reduction (16 وحدة Gas لكل بايت) · Ethereum Improvement Proposals
- EIP-2929: Gas cost increases for state access opcodes · Ethereum Improvement Proposals
- Ethereum Yellow Paper، الملحق G: G_sset = 20,000 · Ethereum
- Solidity ABI Specification: abi.encode وNon-standard Packed Mode · Solidity
- مواصفات Excel وحدوده: دقة الأرقام 15 خانة · Microsoft
11 / أدوات أخرى
بقي عندكم سؤال؟
تجدون جميع الأدوات المتعلّقة بالمحافظ والعقود والرموز في نظرة عامة على Web3.
- AT-W32 · للشركات
فحص ملاءمة البلوك تشين
هل يحتاج مشروعكم فعلاً إلى بلوك تشين، أم تكفي قاعدة بيانات؟ - AT-W33 · للشركات
فحص MiCA
هل يخضع الـ Token الخاص بكم لقانون MiCA، وما الالتزامات المترتبة على ذلك؟ - AT-W34 · للأفراد والشركات
حاسبة رسوم Gas
كم تكلف المعاملة على Ethereum أو Arbitrum أو Optimism أو Base أو Polygon؟ - AT-W35 · للأفراد والشركات
فاحص عناوين Ethereum
هل عنوان Ethereum هذا صالح ومكتوب بشكل صحيح؟ فحص المجموع الاختباري وفق EIP-55 ومقارنة عنوانين. - AT-W36 · للشركات
حاسبة Selector و Topic
أي Selector للدالة أو Topic للحدث يقابل توقيع Solidity هذا، والعكس؟ - AT-W37 · للشركات
مفكِّك Calldata
ماذا تفعل هذه المعاملة؟ حوّلوا Calldata إلى نص مقروء قبل أن توقّعوا.
هل أعددتم الجذر والإثباتات؟ نطوّر العقد المناسب وصفحة المطالبة المتصلة بالمحافظ، ونختبرها جميعًا على شبكة تجريبية قبل ربطها بأصول حقيقية. نقدّم الخدمة من رودفيش لمشاريع في أنحاء ألمانيا.
+49 3744 4399760[email protected]الاثنين–الجمعة، 8:00–17:00 · Straße der Jugend 5, 08228 Rodewisch