الأداة AT-W38REV.‎ 2026-A

مولّد قائمة السماح Merkle: الجذر والإثباتات للسكّ والتوزيع المجاني

يُحفَظ من قائمة سماح Merkle في العقد الذكي ناتج تجزئة واحد فقط، هو الجذر. ويحصل كل عنوان في القائمة على إثبات قصير يتألف من 13 أو 14 ناتج تجزئة عند وجود 10,000 عنوان. ويتحقق العقد عند السكّ أو المطالبة من أهلية العنوان. يُنشئ المولّد الجذر والإثباتات بطريقة OpenZeppelin، بعد فحص كل عنوان وفق EIP-55 والتحقق من التكرار.

  • مجاني
  • دون تسجيل
  • الحساب يتم في المتصفح

ألصقوا القائمة للحصول على الجذر والإثباتات

المولّد · جذر Merkle والإثباتات

تحسب الأداة الجذر والإثباتات وفق طريقة OpenZeppelin.‎ ومع ذلك، اختبروا العقد والمطالبة على شبكة تجريبية قبل ربطهما بأصول حقيقية. أدخلوا العناوين العامة فقط، وأبقوا المفاتيح الخاصة سرّية.

الخطوة 1كيف يحسب عقدكم الورقة؟
الخطوة 2ما البيانات التي تُربَط بكل عنوان؟

تعني 0 أن الكميات محددة مسبقًا بأصغر الوحدات (wei). وإذا اخترتم 18، فأدخلوا الكميات بوحدات الرمز، مثل 1.5، وتتولّى الأداة التحويل. اكتبوا الأرقام دون فواصل الآلاف.

الخطوة 3ألصقوا القائمة

أدخلوا «0x…,الكمية» بفاصلة عادية، أو افصلوا بفاصلة منقوطة كما في Excel.‎ تدعم الأداة سطر العناوين والتعليقات التي تبدأ بـ # وما يصل إلى 100,000 إدخال. ويمكنكم أيضًا لصق ملف شجرة من OpenZeppelin ‏(tree.json) لتعيد الأداة حسابه.

جذر Merkle

—

ألصقوا القائمة واضغطوا «احسبوا الجذر». ويمكنكم استخدام المثال للتجربة.

التحقق من الإثباتهل يطابق الإثبات المتاح جذرًا معينًا؟

تجري الأداة الحساب بالطريقة نفسها التي تتّبعها MerkleProof.verify في العقد. ويفيد ذلك عندما تفشل المطالبة وتظهر رسالة «InvalidProof».

تجري الحسابات في متصفحكم. ولا تُرسل القائمة أو تُحفظ.

جذر واحد في العقد وإثبات لكل عنوان

قد يبدو تخزين كل العناوين المؤهلة داخل العقد هو الحل الأبسط، لكنه مكلف. يكلّف كل موضع تخزين جديد 20,000 وحدة Gas على الأقل. وعند وجود 10,000 عنوان، يبلغ ذلك 200,000,000 وحدة Gas لمجرد إدراجها. أما شجرة Merkle فتتيح إبقاء القائمة خارج سلسلة الكتل وتخزين قيمة واحدة طولها 32 بايت في العقد.

تبدأ العملية بتجزئة كل سطر من القائمة للحصول على ورقة. وبعد ذلك تُجزّأ كل ورقتين معًا وتُكرّر العملية مع كل زوج من النتائج حتى تبقى قيمة واحدة هي الجذر. وإذا تغيّر رقم واحد فقط في إحدى الكميات، يتغيّر الجذر. وتعود الفكرة إلى طريقة توقيع من عام 1987 ينمو فيها حجم التوقيع لوغاريتميًا مع عدد الرسائل Merkle 1988.

عند المطالبة، يرسل المستفيد الإثبات (Proof بالإنجليزية)، وهو نواتج تجزئة العقد الشقيقة على طول المسار من ورقته إلى الجذر. ويعيد العقد حساب المسار ويقارن النتيجة بالجذر المحفوظ. وهذا مبدأ بنى البيانات الموثَّقة، إذ يستطيع المستلِم التحقق من الإثبات بنفسه من دون الوثوق بمصدر البيانات Tamassia 2003. لذا لا تستطيع صفحة المطالبة اختلاق إدخال، لأن العقد يرفض الإثبات الخاطئ.

الجذر0xc09c…46a1العقدة 10xfc27…e996العقدة 20x6cac…7b41الصفحة0xa740…a34fالصفحة0x9e7b…e6dcالصفحة0x708e…e751الصفحة0x04c3…ad040x1111…11110x5aAe…eAed0x2222…22220xfB69…d359المظلّل: الإثبات · الخط الغليظ: القيم التي يعيد العقد حسابها

الشكل 1 · قيم فعلية مختصرة لأربعة عناوين من المثال (التنسيق القياسي، العنوان فقط). إثبات 0x2222…2222 يتألّف من ناتجَي تجزئة.

طول الإثبات والتخزين في العقد
العناويننواتج التجزئة لكل إثباتالحد الأقصى لحجم الإثباتالحد الأقصى لتكلفة Calldataالحد الأدنى لتكلفة حفظ القائمة في العقد
1006 أو 7224 بايت3,584 وحدة Gas2,000,000 وحدة Gas
1.0009 أو 10320 بايت5,120 وحدة Gas20,000,000 وحدة Gas
10.00013 أو 14448 بايت7,168 وحدة Gas200,000,000 وحدة Gas
100.00016 أو 17544 بايت8,704 وحدة Gas2,000,000,000 وحدة Gas
1.000.00019 أو 20640 بايت10,240 وحدة Gas20,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 نواتج تجزئة. ويتحمّل المستفيد تكلفة الإثبات في معاملته، بينما يحتفظ العقد بالجذر وحده مهما بلغ طول القائمة.

العقد يحدّد التنسيق

يجب أن يحسب المولّد والعقد الورقة بالطريقة نفسها تمامًا. إذ يكفي اختلاف بايت واحد لتفشل كل مطالبة برسالة «Invalid proof». لذا اختاروا في الخطوة 1 التنسيق الذي يستخدمه العقد.

التنسيقان لحساب الورقة من العنوان والكمية
التنسيقالورقة في Solidityالبايتات قبل التجزئةملف الشجرةالاستخدام
OpenZeppelin StandardMerkleTreekeccak256(bytes.concat(keccak256(abi.encode(account, amount))))64standard-v1للعقود الجديدة. ويمكن تحميل ملف الشجرة مباشرةً بواسطة StandardMerkleTree.load().
بسيط (abi.encodePacked)keccak256(abi.encodePacked(account, amount))52simple-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. وتعرض النتيجة المجموع بالوحدتين للتحقق.
  • العناوين المكررة. يتعامل العقد مع العنوان المكتوب بحروف صغيرة والعنوان نفسه المكتوب بقيمة تحقق بوصفهما عنوانًا واحدًا. ويكشف المولّد التكرار ويمكنه دمج الإدخالات عند الطلب. فيحذف الأسطر المتماثلة ويجمع الكميات المختلفة.

هل توزّعون الرموز مباشرةً أم تتيحون المطالبة بها؟

درس 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) استخدامه لمنفعته الشخصية.

حدود القائمة: الحسابات المتعددة والخصوصية

تتحقّق شجرة 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. وإذا كانت القائمة مستمدة من ملف عملائكم، فينبغي إدراج نشرها مسبقًا في مراجعة حماية البيانات. ولا يرسل المولّد نفسه أي شيء؛ بل يجري العمليات الحسابية في متصفحكم.

كيفية إعداد قائمة سماح

  1. وثّقوا المعايير والموعد المرجعي. من يحصل على أي كمية، وأي كتلة تُتّخذ مرجعًا للاختيار؟ دوّنوا الإجابات قبل إعداد القائمة حتى يمكن تفسير غياب عنوان لاحقًا.
  2. صدّروا القائمة بدقة. احفظوا الكميات بصيغة النص حتى تبقى الخانات كاملة، وحدّدوا ما إذا كانت بأصغر الوحدات أو بوحدات الرمز.
  3. اختاروا التنسيق وفق العقد. للعقد الجديد، اختاروا تنسيق OpenZeppelin.‎ وللعقد الحالي، راجعوا كيف يحسب الورقة واضبطوا الخطوة 1 وفق ذلك.
  4. اختبروا المطالبة على شبكة تجريبية. سجّلوا الجذر في العقد واختبروا المطالبة فعليًا بعنوانين أو ثلاثة، بينها عنوان غير مدرج. وإذا فشلت إحدى المطالبات، تُظهر أداة التحقق الموضع الذي يتوقف عنده المسار.
  5. احتفظوا بالقائمة وملف الشجرة. يعيد المولّد حساب الجذر نفسه عند استخدام القائمة المطابقة تمامًا. وتغيير سطر واحد يجعل النتائج مختلفة.
  6. خطّطوا لنهاية التوزيع منذ البداية. أضيفوا إلى العقد قبل تشغيله مهلة للمطالبة ودالة لاسترجاع المخصّصات المتبقية. فإذا كان العقد غير قابل للترقية، يتعذّر إضافة ذلك لاحقًا.

حدود المولّد

  • يقتصر الفحص على التكرار. يكشف المولّد العناوين المتطابقة دون تحديد ما إذا كانت عدة عناوين تعود إلى شخص واحد.
  • يدعم بنية شجرة واحدة. وهي بنية OpenZeppelin ذات الأوراق المرتّبة. ولا يعيد المولّد بناء أشجار المكتبات الأخرى، لكن أداة التحقق تستطيع فحص إثباتاتها الفردية.
  • الأوراق من النوعين address وuint256. لا تدعم الأداة حقولًا إضافية مثل الرقم التسلسلي، أو الإثباتات المتعددة (Multiproofs)، أو دوال تجزئة مخصّصة.
  • لا تقرأ الأداة بيانات السلسلة. لا تقرأ الأرصدة أو العقود، وتظل مراجعة العقد ضرورية.

نطوّر العقد وصفحة المطالبة وربطها بالمحافظ ضمن خدمة تطوير Web3. ويبيّن مفكّك ترميز Calldata ما تستدعيه المعاملة فعليًا قبل توقيعها. وتجدون جميع الأدوات في نظرة عامة على Web3.

ماذا تقول الأبحاث في ذلك

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

  • يزداد حجم الإثبات لوغاريتميًا. لذلك يكفي 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، ومن هنا تأتي الملاحظة بشأن نشر القائمة.

استخدام هذه الأداة من داخل مساعد ذكاء اصطناعي

المساعدات مثل 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.

أسئلة شائعة حول جذر 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 وحدها، وتظل مراجعة العقد ضرورية. ويمكنكم تكليفنا بإعداد العقد وصفحة المطالبة والاختبار على شبكة تجريبية.

على ماذا تستند الأداة

القيم التقريبية والملاحظات أعلاه تستند إلى هذه الأبحاث العلمية الـ 14. وقد تحققنا من كل بحث عبر رقم DOI الخاص به أو عبر صفحة الناشر (آخر مرة في 14 تشرين الثاني/نوفمبر 2026): البحث موجود، ولم يُسحب، وما توصل إليه ما زال صالحاً للإجابة عن السؤال اليوم.

  1. 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 ناتج تجزئة، كما في جدول طول الإثبات.

  2. Tamassia, R.‎ (2003): Authenticated Data Structures. Algorithms – ESA 2003, LNCS 2832، ص. 2–5

    النتيجة مراجعة لبنى البيانات الموثَّقة، إذ يجيب طرف ثالث غير موثوق عن الاستفسارات نيابةً عن مصدر موثوق، ويرفق إثباتًا يتحقق منه المستخدم بنفسه.

    في الأداة تفسّر النتيجة توزيع الأدوار. يحتفظ الموقع بالقائمة، ويحتفظ العقد بالجذر ويتحقق بنفسه من الإثبات المرفق.

  3. 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.‎

  4. 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 من خلال النشاط على السلسلة الجديدة. وغالبًا ما يُنظر إلى التوزيع المجاني على أنه بلا مخاطر على المستفيدين، مما يؤدي إلى إغفال آثاره على الخصوصية.

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

  5. Allen, D.‎ W.‎ E.; Berg, C.; Lane, A.‎ M.‎ (2023): Why airdrop cryptocurrency tokens?. Journal of Business Research 163، المقالة 113945

    النتيجة في دراسات حالات لتوزيعات مجانية معروفة من 2014 إلى 2022، كان أبرز دوافع توزيع الرموز هو التسويق لاجتذاب المستخدمين والحفاظ على المجتمع، وتوزيع الملكية والتحكم على نطاق أوسع.

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

  6. Allen, D.‎ W.‎ E.‎ (2024): Crypto airdrops: An evolutionary approach. Journal of Evolutionary Economics 34 (4–5)، ص. 849–872

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

    في الأداة تدعم النتيجة توثيق المعايير قبل إنشاء القائمة، وإنشاء جذر مستقل لكل جولة.

  7. 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.‎ ينبغي فرز القائمة قبل إدخالها في المولّد.

  8. 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 يتطلّب بيانات معاملات من السلسلة، وهي بيانات لا يملكها مولّد القوائم.

  9. Douceur, J.‎ R.‎ (2002): The Sybil Attack. Peer-to-Peer Systems (IPTPS 2002), LNCS 2429، ص. 251–260

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

    في الأداة تبيّن النتيجة حدود قاعدة «مطالبة واحدة لكل عنوان»، إذ يقتصر فحص التكرار على العناوين المتطابقة وقد تكون لشخص واحد عناوين متعددة.

  10. 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 دون جهة لإصدار إثبات الهوية، عبر التصويت والتزكية وتقييم المشاركين لبعضهم بعضًا، مع بيان نقاط القوة والضعف لكل نهج.

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

  11. 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 بالمئة من المبيعات. وكانت معظم الأنماط معاملات متبادلة بين عدد قليل من العناوين.

    في الأداة تبيّن النتيجة أن حجم التداول قد يكون مؤشرًا مضللًا لاختيار عناوين قائمة السماح، لأن شخصًا واحدًا يمكنه التحكّم في عدة عناوين بسهولة.

  12. 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 مليون مرة خلال عشرة أشهر. وتصف جمع المكافآت على نطاق واسع والروبوتات، وتشرح صعوبة التمييز بين المستخدمين الفعليين والبرامج الآلية.

    في الأداة تدعم النتيجة اختيار معايير يصعب استيفاؤها آليًا بتكلفة منخفضة قبل إدخال العناوين في المولّد.

  13. 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.‎

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

  14. 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.‎ وعندها لا يستفيد من يطّلع على إثبات في المعاملات المعلّقة منه لنفسه.

معايير وجهات رسمية وبيانات الشركات المصنِّعة

الاثنين–الجمعة، 8:00–17:00

هل أعددتم الجذر والإثباتات؟ نطوّر العقد المناسب وصفحة المطالبة المتصلة بالمحافظ، ونختبرها جميعًا على شبكة تجريبية قبل ربطها بأصول حقيقية. نقدّم الخدمة من رودفيش لمشاريع في أنحاء ألمانيا.

+49 3744 4399760[email protected]

الاثنين–الجمعة، 8:00–17:00 · Straße der Jugend 5, 08228 Rodewisch

اطلبوا تنفيذ قائمة السماح
+49 3744 4399760الاثنين–الجمعة، 8:00–17:00
اتصلوا بنانتصل بكم

قائمة المكوّنات · صفحة 1/1

ممَّ تتكوّن هذه الصفحة

القيم مقيسة عند بناء الصفحة، ومع تفعيل JavaScript يعيد متصفحكم القياس مباشرة.

رقمالمكوّنالنوعالحجم
01index.htmlمستند≈ 29 كيلوبايت
02styles.cssورقة أنماط≈ 20 كيلوبايت
03scripts.jsسكربت≈ 13 كيلوبايت
04archivo-variable.woff2خط≈ 58 كيلوبايت
05ibm-plex-mono.woff2خط≈ 30 كيلوبايت
06favicon.svgرسمأقل من 1 كيلوبايت

ملفات ارتباط (Cookies) للإعلانات أو التحليل: لا يوجد. من دون موافقتكم لا تحمّل الصفحة شيئاً من سيرفرات خارجية، ما عدا خدمة التوزيع Cloudflare التي نستخدمها. الخطوط والسكربتات والرسوم محفوظة عندنا. وبالطريقة نفسها نبني أنظمتكم.

خارج أوقات الدوام

اتصلوا مع ذلك ولا تترددوا

دوامنا المعتاد في المكتب من الاثنين إلى الجمعة، من 8:00 إلى 17:00.

في المساء وفي عطلة نهاية الأسبوع يُحوَّل الاتصال إلينا أيضاً، وكثيراً ما يرد أحدنا. لكننا لا نستطيع أن نعدكم بذلك.

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

المكالمة مجانية. وإذا احتجتم خارج أوقات الدوام إلى من يباشر العمل فوراً، تُحسب الزيادة المذكورة في قائمة الأسعار.

اتصلوا الآن+49 3744 4399760

تفضّلون الكتابة؟ راسلونا عبر نموذج التواصل أو على [email protected]. نقرأ الرسالة في يوم العمل التالي.

تشخيص · AT-K2

بماذا نساعدكم؟

↵ اختيارESC إغلاقللاتصال: ‎+49 3744 4399760

إعدادات مخصّصة

أي الخدمات تسمحون بتحميلها؟

ضرورية تقنياً

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