ابزار AT-W38REV.‎ 2026-A

سازندۀ Merkle Allowlist: ریشه و اثبات‌ها برای Mint و Airdrop

یک Merkle Allowlist تنها یک هش را در قرارداد هوشمند قرار می‌دهد: ریشه. هر آدرس لست یک اثبات کوتاه می‌گیرد؛ برای 10.000 آدرس، 13 یا 14 هش. قرارداد هنگام Mint یا Claim دوباره حساب می‌کند که آیا آدرس در لست شامل است یا خیر. سازنده ریشه و اثبات‌ها را مانند OpenZeppelin می‌سازد و پیش از آن هر آدرس را مطابق EIP-55 و از نظر تکراری بودن بررسی می‌کند.

  • رایگان
  • بدون ثبت نام
  • در براوزر حساب می‌کند

لست را وارد کنید، ریشه و اثبات‌ها را ببینید

سازنده · ریشۀ Merkle و اثبات‌ها

این ابزار ریشه و اثبات‌ها را مطابق روش OpenZeppelin حساب می‌کند. با این حال، پیش از آن‌که دارایی واقعی به قرارداد و Claim وابسته شود، هر دو را در یک شبکۀ آزمایشی امتحان کنید. تنها آدرس‌های عمومی را وارد کنید، هرگز کلید خصوصی را وارد نکنید.

قدم 1قرارداد شما برگ را چگونه می‌سازد؟
قدم 2چه چیزی به هر آدرس تعلق دارد؟

0 یعنی مقدارها از قبل به کوچک‌ترین واحد (wei) هستند. با انتخاب 18، مقدار را به واحد توکن، مثلاً 1.5، می‌نویسید و ابزار آن را تبدیل می‌کند. لطفاً نقطه‌های جداکنندۀ هزارگان را ننویسید.

قدم 3لست را وارد کنید

«0x…,مقدار» یا جداشده با نقطه‌ویرگول، مانند خروجی Excel.‎ سطر عنوان و توضیحات با # مشکلی ایجاد نمی‌کنند؛ تا 100.000 مورد. فایل درخت OpenZeppelin (tree.json) را نیز وارد کرده می‌توانید؛ ابزار آن را دوباره حساب می‌کند.

ریشۀ Merkle

—

لست را وارد کنید و «محاسبۀ ریشه» را فشار دهید. برای امتحان کردن، یک مثال موجود است.

بررسی اثباتآیا یک اثبات موجود با یک ریشه مطابقت دارد؟

مانند MerkleProof.verify در قرارداد حساب می‌کند. وقتی Claim با پیام «InvalidProof» ناکام می‌شود، کمک می‌کند.

در براوزر شما حساب می‌کند. لست فرستاده یا ذخیره نمی‌شود.

یک ریشه در قرارداد، یک اثبات برای هر آدرس

راه‌حل ابتدایی این است که تمام آدرس‌های مجاز در قرارداد ذخیره شوند. این کار پرهزینه می‌شود. هر جای تازۀ اشغال‌شده در حافظه حداقل 20.000 Gas هزینه دارد؛ برای 10.000 آدرس یعنی 200.000.000 Gas، تنها برای ثبت کردن. درخت Merkle این روش را برعکس می‌کند: لست بیرون از زنجیره می‌ماند و در قرارداد تنها یک مقدار 32 بایت ثبت می‌شود.

درخت این‌گونه ساخته می‌شود. از هر سطر لست یک هش ساخته می‌شود که برگ نام دارد. هش برگ‌ها را جفت‌جفت به هم پیوند می‌دهند و دوباره هش می‌کنند. همین کار برای جفت‌های حاصل ادامه می‌یابد تا تنها یک مقدار باقی بماند: ریشه. اگر حتی یک رقم در یک مقدار تغییر کند، ریشه تغییر می‌کند. این ایده از یک روش امضا در سال 1987 آمده است که در آن اندازۀ امضا با افزایش تعداد پیام‌ها تنها به‌صورت لگاریتمی رشد می‌کند Merkle 1988.

هنگام Claim، دریافت‌کننده اثبات خود را همراه می‌فرستد (به انگلیسی Proof): هش گرۀ هم‌والد در هر قدم از مسیر برگ آن آدرس تا ریشه. قرارداد مسیر را دوباره حساب می‌کند و نتیجه را با ریشۀ ذخیره‌شده مقایسه می‌کند. این الگوی ساختارهای دادۀ تصدیق‌شده است که در آن لازم نیست عرضه‌کنندۀ داده قابل اعتماد باشد، چون دریافت‌کننده خودش اثبات را بررسی می‌کند Tamassia 2003. بنابراین صفحۀ Claim شما نمی‌تواند یک مورد ساختگی اضافه کند؛ قرارداد اثبات نادرست را رد می‌کند.

ریشه0xc09c…46a1گرۀ 10xfc27…e996گرۀ 20x6cac…7b41ورق0xa740…a34fورق0x9e7b…e6dcورق0x708e…e751ورق0x04c3…ad040x1111…11110x5aAe…eAed0x2222…22220xfB69…d359هاشورخورده: اثبات · ضخیم: دوباره محاسبه‌شده توسط قرارداد

تصویر 1 · مقادیر واقعی چهار آدرس مثال (قالب standard، تنها آدرس)، به‌شکل کوتاه‌شده. اثبات برای 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؛ مطابق EIP-2929 برای جای سرد 2.100 Gas اضافه می‌شود). آخرین بازنگری: 14 نومبر 2026.

پس اثبات با بزرگ شدن لست بسیار کم رشد می‌کند. از 10.000 تا یک میلیون آدرس، 6 هش اضافه می‌شود. دریافت‌کننده هزینۀ اثبات را با تراکنش خود می‌پردازد؛ در قرارداد تنها ریشه قرار دارد، هر قدر هم لست طولانی باشد.

کدام قالب؟ قرارداد تعیین می‌کند

مهم‌ترین قاعده در آغاز: سازنده و قرارداد باید برگ را دقیقاً یکسان بسازند. یک بایت تفاوت کافی است تا هر Claim با پیام «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 با بررسی Airdropهای سال‌های 2014 تا 2022 تحقیق کرده‌اند که چرا پروژه‌ها اصلاً توکن رایگان می‌دهند: عمدتاً برای بازاریابی و توزیع گسترده‌تر مالکیت و کنترول Allen و همکاران 2023. پس توزیع باید به افراد زیادی برسد و هزینۀ آن از منفعتش بیشتر نشود.

در اصل دو راه وجود دارد. در روش Push، توزیع‌کننده خودش به هر دریافت‌کننده انتقال می‌دهد. در روش Pull، دریافت‌کنندگان خودشان سهم‌شان را می‌گیرند؛ Merkle-Claim دقیقاً همین است. Fröwis و Böhme تعداد 35 سناریو را محاسبه کرده‌اند: Pull برای توزیع‌کننده صرفه‌جویی محدودی دارد و هزینۀ نامتناسبی را بر هر دریافت‌کننده تحمیل می‌کند. در مجموع، هزینۀ تمام روش‌ها تقریباً به‌صورت خطی با تعداد دریافت‌کنندگان افزایش می‌یابد Fröwis و Böhme 2019. بنابراین ارزش Merkle-Claim بیشتر در نظم‌دهی است تا صرفه‌جویی در کارمزد: لست بیرون از قرارداد می‌ماند و تنها چیزی دریافت می‌شود که کسی واقعاً آن را می‌خواهد.

سه راه برای توزیع توکن یا حق Mint
راهچه کسی کارمزد را می‌پردازدهزینۀ آغاز کارتغییر پس از آغاز
انتقال مستقیم (Push)توزیع‌کننده، یک انتقال برای هر دریافت‌کنندهبا هر آدرس افزایش می‌یابدممکن نیست؛ انتقال انجام‌شده برگشت‌پذیر نیست
ذخیرۀ لست در قراردادتوزیع‌کننده برای ثبت (از 20.000 Gas برای هر آدرس)، دریافت‌کننده برای Claimبا هر آدرس افزایش می‌یابدجداگانه، از طریق یک تابع مدیریتی
ریشۀ Merkle (Pull)دریافت‌کننده، برای Claim و اثباتیک جای حافظه برای ریشهتنها با یک ریشۀ جدید. اثبات‌ها را در برابر ریشۀ جدید بررسی کنید

برای مقدارهای کم ممکن است کارمزد Claim از ارزش چیزی که دریافت می‌شود بیشتر باشد. در این حالت بهتر است توزیع در یک زنجیرۀ ارزان Layer-2 انجام شود یا حداقل مقدار تعیین گردد. حساب‌گر Gas هزینۀ Claim را با قیمت‌های فعلی Gas حساب می‌کند.

NFT-Mint: Allowlist به‌جای رقابت در پیشنهاد کارمزد

در یک Mint آزاد با تعداد محدود، خریداران با پیشنهاد کارمزد Gas بالاتر از هم پیشی می‌گیرند. این کار کارمزد را برای همه بالا می‌برد و Gas را هدر می‌دهد؛ تحقیقی دربارۀ آغاز عرضۀ NFT این موضوع را نشان می‌دهد و قرعه‌کشی را به‌عنوان راه‌حل پیشنهاد می‌کند Ko و همکاران 2023. یک Allowlist با بازۀ زمانی مشخص نیز این رقابت را از بین می‌برد. بات‌هایی در پیشی گرفتن تخصص دارند که تراکنش‌های در انتظار را می‌خوانند و با کارمزد بالاتر از آن‌ها جلو می‌زنند Daian و همکاران 2020.

از این موضوع یک قاعده برای قرارداد به دست می‌آید: آدرس داخل برگ و دریافت‌کننده باید یکسان باشند. ساده‌ترین راه این است که قرارداد برگ را از msg.sender بسازد، همان‌طور که در قطعۀ کود Solidity سازنده آمده است. در این صورت اثباتی که کسی در Mempool می‌خواند، برای دریافت سهم به نفع خودش سودی ندارد.

آنچه لست انجام نمی‌دهد: حساب‌های متعدد و حفاظت از معلومات

درخت Merkle بررسی می‌کند که آیا یک آدرس در لست است یا خیر. نمی‌داند که پشت ده آدرس، ده نفر قرار دارند یا یک نفر. این یکی از یافته‌های قدیمی علوم کمپیوتر است: بدون مرجعی که هویت‌ها را تایید کند، نمی‌توان از هویت‌های متعدد (حملات Sybil) جلوگیری کرد، مگر با فرض‌های غیرواقعی Douceur 2002. به همین دلیل بررسی موارد تکراری تنها آدرس یکسان را پیدا می‌کند، حتی اگر به شکل دیگری نوشته شده باشد.

  • شکارچیان Airdrop پدیدۀ رایجی هستند. Fan و همکاران در Airdrop مربوط به ParaSwap چندین الگوی کسب سهم اضافی توسط شرکت‌کنندگان را شرح می‌دهند؛ روش معمول شناسایی نتوانسته بود آن‌ها را به‌اندازۀ کافی حذف کند Fan و همکاران 2023. روش‌های بهتر، گراف‌های تراکنش و فراداده‌ها را تحلیل می‌کنند Zhou و همکاران 2024؛ این کار به داده‌های زنجیره نیاز دارد و لست به‌تنهایی کافی نیست.
  • از قواعد تا آخرین حد استفاده می‌شود. به‌محض روشن شدن معیارها، کاربران خود را با آن‌ها عیار می‌کنند. به همین دلیل Allen پیچیده‌تر شدن معیارها را مشاهده می‌کند و انتظار Airdrop در چندین دور را دارد Allen 2024. هر دور ریشۀ خودش را دارد. اعتبار اثبات باید در برابر ریشۀ همان دور بررسی شود.
  • حجم معاملات معیار قابل اتکایی نیست. در 52 مجموعۀ بزرگ NFT، تعداد 3,93 درصد آدرس‌ها الگوهایی داشتند که شبیه معاملات صوری به نظر می‌رسید؛ بیشتر به‌صورت رفت‌وبرگشت میان چند آدرس محدود von Wachter و همکاران 2023.
  • وظیفه‌ها اسکریپت‌ها را جذب می‌کنند. یک سیستم Quest با 80 میلیون وظیفۀ انجام‌شده، جمع‌آوری خودکار پاداش و بات‌ها را جذب کرد و جدا کردن کاربران واقعی از اسکریپت‌ها دشوار بود Al-Chami و Clark 2025. معیارهایی که اسکریپت نتواند با هزینۀ کم برآورده کند، بیشتر دوام می‌آورند.
  • راه‌های مقابله بیرون از لست قرار دارند. اثبات این‌که پشت یک آدرس انسان قرار دارد، مثلاً از طریق ضمانت اشخاص و رای‌گیری در جامعه، حوزۀ جداگانه‌ای با ضعف‌های خاص خود است Siddarth و همکاران 2020.

زمان نمایان شدن آدرس‌ها و اثبات‌ها

به‌محض این‌که ریشه در قرارداد ثبت شود، عمومی است. یک Claim آدرس، اثبات و در صورت لزوم مقدار را در زنجیره آشکار می‌کند. فایل درخت با قالب استاندارد و فایل اثبات، همۀ آدرس‌ها و مقدارهای واردشده برای هر یک را دربر می‌گیرند. فایل درخت با قالب ساده، برگ‌ها را به‌صورت هش ذخیره می‌کند. تحقیقی دربارۀ Clam-Airdrop سال 2014 نشان می‌دهد که از چنین داده‌هایی چه اندازه معلومات به دست می‌آید: از طریق فعالیت در زنجیرۀ جدید، می‌توان آدرس‌های مربوط به یک شخص را در سه بلاکچین دیگر به هم پیوند داد Harrigan و همکاران 2018. اگر لست از فایل مشتریان شما آمده است، نشر آن باید پیشاپیش از نظر حفاظت از معلومات بررسی شود. خود سازنده چیزی نمی‌فرستد؛ در براوزر شما حساب می‌کند.

چگونه یک Allowlist را پیاده کنید

  1. معیارها و تاریخ مبنا را مکتوب کنید. چه کسی چقدر می‌گیرد و انتخاب بر کدام بلاک استوار است؟ پیش از ساختن لست این موارد را بنویسید؛ در غیر آن بعداً نمی‌توان توضیح داد که چرا یک آدرس موجود نیست.
  2. از لست خروجی درست بگیرید. مقدارها را به‌صورت متن، نه عدد، و به‌روشنی به کوچک‌ترین واحدها یا واحد توکن ثبت کنید.
  3. قالب را مطابق قرارداد انتخاب کنید. قرارداد جدید: قالب OpenZeppelin.‎ قرارداد موجود: ببینید برگ را چگونه می‌سازد و قدم 1 را مطابق آن تنظیم کنید.
  4. دریافت را در شبکۀ آزمایشی انجام دهید. ریشه را در قرارداد قرار دهید، سپس بگذارید دو یا سه آدرس واقعاً Claim کنند، از جمله آدرسی که در لست نیست. اگر دریافت سهم ناکام شد، بخش بررسی اثبات مسیر محاسبه و مطابقت نتیجۀ آن با ریشه را نشان می‌دهد.
  5. لست و فایل درخت را نگه دارید. سازنده از دقیقاً همان لست، دوباره همان ریشه را حساب می‌کند. اگر یک سطر تغییر کند، دیگر هیچ‌چیز مطابقت ندارد.
  6. پایان کار را از همان آغاز پلان کنید. مهلت Claim و تابعی که باقی‌مانده‌ها را پس بگیرد، باید پیش از فعال شدن قرارداد در آن باشند. در قراردادی که قابل ارتقا نیست، نمی‌توان این‌ها را بعداً اضافه کرد.

جایی که کار سازنده تمام می‌شود

  • حساب‌های متعدد را بررسی نمی‌کند. آدرس‌های یکسان را پیدا می‌کند، نه چند آدرس متعلق به یک شخص را.
  • یک ساختار درخت. ساختار OpenZeppelin با برگ‌های مرتب‌شده. درخت‌های کتابخانه‌های دیگر را بازسازی نمی‌کند؛ با این حال بخش بررسی اثبات، اثبات‌های جداگانۀ آن‌ها را بررسی می‌کند.
  • برگ‌ها از address و uint256 ساخته می‌شوند. فیلدهای دیگر مانند شمارۀ ترتیبی، اثبات‌های گروهی (Multiproof) و تابع‌های هش اختصاصی شامل نیستند.
  • زنجیره را بررسی نمی‌کند. نه موجودی‌ها را می‌خواند و نه قراردادها را و جای بررسی قرارداد را نمی‌گیرد.

قرارداد، صفحۀ Claim و اتصال به کیف پول‌ها را در بخش انکشاف Web3 می‌سازیم. رمزگشای Calldata پیش از امضای تراکنش نشان می‌دهد که آن تراکنش واقعاً چه چیزی را فراخوانی می‌کند. تمام ابزارهای Web3 در نمای کلی Web3 آمده‌اند.

تحقیقات علمی در این باره چه می‌گوید

پنج یافته پشتوانۀ نکته‌های سازنده هستند. لست کامل همراه با یادداشت بررسی در پایین آمده است.

  • اثبات به‌صورت لگاریتمی رشد می‌کند. به همین دلیل برای 10.000 آدرس، 13 یا 14 هش کافی است Merkle 1988 و قرارداد خودش آن‌ها را بررسی می‌کند Tamassia 2003.
  • دریافت توسط خود کاربران، هزینه را منتقل می‌کند. Pull برای توزیع‌کننده صرفه‌جویی محدودی دارد و به هر دریافت‌کننده هزینه تحمیل می‌کند Fröwis و Böhme 2019؛ به همین دلیل دربارۀ مقدارهای کم نکته‌ای آمده است.
  • یک آدرس برابر با یک شخص نیست. بدون مرجع تایید هویت، داشتن حساب‌های متعدد همچنان ممکن است Douceur 2002 و شواهد کافی دربارۀ شکارچیان Airdrop وجود دارد Fan و همکاران 2023.
  • تراکنش‌های در انتظار را دیگران می‌خوانند. بات‌ها برای جایگاه در ترتیب تراکنش‌ها رقابت می‌کنند Daian و همکاران 2020؛ به همین دلیل برگ در قطعۀ کود Solidity به msg.sender وابسته است.
  • داده‌های Airdrop ارتباط‌ها را آشکار می‌کنند. می‌توان میان آدرس‌های یک شخص در زنجیره‌های مختلف ارتباط برقرار کرد 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…,Menge». سطر عنوان، سطرهای خالی و توضیحات با # مجاز هستند؛ حداکثر 10000 مورد. به‌جای لست، فایل درخت OpenZeppelin (standard-v1 یا simple-v1) را نیز به‌صورت متن JSON در این‌جا وارد کرده می‌توانید؛ در آن صورت دوباره محاسبه می‌شود.
formatنخیر«standard» (پیش‌فرض) = OpenZeppelin StandardMerkleTree، برگ keccak256(bytes.concat(keccak256(abi.encode(…)))). «einfach» = keccak256(abi.encodePacked(…))، جفت‌های مرتب‌شده.
inhaltنخیر«adresse» (پیش‌فرض): برگ تنها از آدرس ساخته می‌شود، مثلاً برای Mint-Allowlist.‎ «menge»: آدرس و مقدار (uint256)، مثلاً برای Airdrop.‎
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» با inhalt برابر «menge»: مقدار به کوچک‌ترین واحدها به‌صورت عدد صحیح، مثلاً «5000000000000000000».
beweisنخیربرای «pruefen»: هش‌های اثبات از برگ تا ریشه، هر کدام شامل 0x و 64 نویسۀ هگزادسیمال.

سوال‌هایی که دستیار باید با آن‌ها این ابزار را صدا بزند

  • «برای این Allowlist یک ریشۀ Merkle به قالب OpenZeppelin بساز و اثبات آدرس اول را به من بده.»
  • «ریشۀ Merkle این Airdrop با آدرس و مقدار به wei چیست و برگ را در Solidity چگونه بررسی کنم؟»
  • «آیا این اثبات Merkle با ریشۀ من مطابقت دارد، یا قرارداد من با abi.encodePacked به‌جای abi.encode حساب می‌کند؟»
  • «آیا tree.json من از StandardMerkleTree هنوز با مقادیر داخل آن مطابقت دارد؟»

این‌که اتصال چطور کار می‌کند و MCP در شرکت خود شما چه کرده می‌تواند، در صفحۀ ادغام MCP نوشته شده است.

سوال‌های رایج دربارۀ ریشۀ Merkle، Proof و Allowlist

Merkle Allowlist چیست؟

لستی از آدرس‌های مجاز است که در قرارداد هوشمند تنها یک هش از آن ثبت می‌شود: ریشۀ Merkle.‎ هر آدرس یک اثبات شامل چند هش می‌گیرد؛ برای 10.000 آدرس، 13 یا 14 هش. هنگام Mint یا دریافت سهم (Claim)، آدرس این اثبات را همراه می‌فرستد و قرارداد دوباره حساب می‌کند که آیا به ریشه می‌رسد یا خیر. خود لست بیرون از زنجیره می‌ماند.

چرا OpenZeppelin برگ را دو بار هش می‌کند؟

یک گرۀ داخلی درخت از 64 بایت ساخته می‌شود؛ یعنی دو هش که به هم پیوسته‌اند. اگر طول برگ پیش از هش شدن نیز 64 بایت باشد، می‌توان یک گرۀ داخلی را به‌جای برگ ارائه کرد. طول abi.encode(address, uint256) دقیقاً 64 بایت است. هش دوم این امکان را از بین می‌برد؛ OpenZeppelin در MerkleProof صریحاً دربارۀ مقادیر برگ با طول 64 بایت و یک بار keccak256 هش شدن هشدار می‌دهد.

Claim من با پیام «Invalid proof» ناکام می‌شود. علت چیست؟

بیشتر اوقات قرارداد برگ را به روشی متفاوت از ابزار سازندۀ اثبات‌ها می‌سازد: abi.encode به‌جای abi.encodePacked، یک هش به‌جای دو هش، یا مقدار به واحد توکن به‌جای کوچک‌ترین واحدها. علت دوم، استفاده از ریشۀ نسخۀ قبلی لست است. بخش بررسی اثبات در زیر سازنده، مسیر را قدم به قدم دوباره حساب می‌کند؛ هر دو قالب و هر دو واحد را در آن‌جا امتحان کنید.

آیا نتیجه با OpenZeppelin StandardMerkleTree سازگار است؟

بلی. برگ، ترتیب و ساختار درخت یکسان‌اند و StandardMerkleTree.load() فایل درخت با قالب standard-v1 را مستقیماً بار می‌کند. مثال README کتابخانه در این سازنده ریشۀ 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77 را می‌دهد، درست مانند OpenZeppelin.‎ قالب ساده از ساختار SimpleMerkleTree (simple-v1) استفاده می‌کند.

اندازۀ اثبات Merkle برای 10.000 آدرس چقدر است؟

13 یا 14 هش، هر کدام 32 بایت؛ یعنی حداکثر 448 بایت. هزینۀ آن به‌عنوان Calldata حداکثر 7.168 Gas است، با حساب 16 Gas برای هر بایت مطابق EIP-2028. برای یک میلیون آدرس، 20 هش لازم است. در مقابل، ذخیرۀ تمام لست در قرارداد حداقل 20.000 Gas برای هر آدرس هزینه دارد.

آیا پس از استقرار قرارداد هم می‌توانم لست را تغییر دهم؟

تنها با یک ریشۀ جدید. تغییرِ حتی یک مقدار نیز ریشۀ جدیدی ایجاد می‌کند. اثبات‌ها را در برابر این ریشۀ جدید بررسی کنید، حتی اگر بعضی از اثبات‌ها بدون تغییر مانده باشند. قرارداد برای این کار به تابعی نیاز دارد که یک شخص مجاز با آن ریشه را عوض کند؛ بدون آن، لست همان‌طور می‌ماند. اگر توزیع در چند دور انجام می‌شود، برای هر دور یک ریشۀ جداگانه تعیین کنید و در قرارداد ثبت کنید چه کسی سهم خود را در کدام دور گرفته است.

آیا Merkle Allowlist در برابر بات‌ها و حساب‌های متعدد محافظت می‌کند؟

در برابر آدرس‌هایی که در لست نیستند، بلی. در برابر حساب‌های متعدد، نخیر: کسی که با بیست آدرس وارد لست شده باشد، بیست بار پذیرفته می‌شود. حذف این موارد باید پیش از استفاده از سازنده، هنگام انتخاب آدرس‌ها انجام شود؛ تحقیقات Airdrop نشان می‌دهد که قواعد ساده برای این کار کافی نیست.

کار سازندۀ Merkle در کجا پایان می‌یابد؟

ریشه، اثبات‌ها و فایل‌ها را حساب می‌کند و آدرس‌ها و موارد تکراری را بررسی می‌کند؛ همه در براوزر. حساب‌های متعدد را شناسایی نمی‌کند، چیزی از زنجیره نمی‌خواند، تنها ساختار OpenZeppelin را می‌سازد و جای بررسی قرارداد را نمی‌گیرد. اگر ترجیح می‌دهید این کار را به ما بسپارید، قرارداد، صفحۀ Claim و آزمایش در شبکۀ آزمایشی را ما انجام می‌دهیم.

این ابزار بر چه تکیه دارد

اندازه‌های رهنما و نکته‌های بالا بر این 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 سناریوی Airdrop: کاهش هزینه تا نصف ممکن است، اما به تدابیری در قرارداد توکن نیاز دارد. روش‌هایی که دریافت‌کنندگان خودشان سهم‌شان را می‌گیرند (Pull)، برای توزیع‌کننده صرفه‌جویی محدودی دارند و هزینۀ نامتناسبی را بر هر دریافت‌کننده تحمیل می‌کنند.

    در ابزار مبنای بخش «توزیع کنید یا بگذارید خودشان دریافت کنند»: Merkle-Claim یک روش 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-Airdrop سال 2014 نشان می‌دهند که از طریق فعالیت در زنجیرۀ جدید می‌توان میان آدرس‌های یک شخص در Bitcoin، Litecoin و Dogecoin ارتباط برقرار کرد. Airdropها برای دریافت‌کنندگان بی‌خطر شمرده می‌شوند، اما پیامدهای آن‌ها برای حریم خصوصی نادیده گرفته می‌شود.

    در ابزار دلیل این نکته است که با نشر فایل درخت یا فایل اثبات، هر آدرس با مقدار آن آشکار می‌شود.

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

    یافته مطالعات موردی Airdropهای شناخته‌شده از 2014 تا 2022: پروژه‌ها عمدتاً به دو دلیل توکن توزیع می‌کنند؛ برای بازاریابی (جذب کاربر و حفظ جامعه) و برای غیرمتمرکز کردن مالکیت و کنترول.

    در ابزار پیش از پرداختن به تخنیک، در متن توضیح می‌دهد که شرکت‌ها اصلاً برای چه Allowlist یا Airdrop ایجاد می‌کنند.

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

    یافته نه مطالعۀ موردی: معیارهای Airdrop پیوسته پیچیده‌تر می‌شوند، چون کاربران خود را با هر قاعده عیار می‌کنند تا سهم بیشتری بگیرند. این پژوهش به‌جای یک Airdrop واحد، چندین دور را پیش‌بینی می‌کند تا پروژه‌ها از تجربه بیاموزند.

    در ابزار پشتوانۀ این توصیه است که معیارها پیش از ساختن لست مکتوب شوند و برای هر دور یک ریشۀ جداگانه ساخته شود.

  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

    یافته تحلیل نقش‌ها بر اساس داده‌های Airdrop مربوط به ParaSwap: کسانی که بیشتر دریافت کردند، بیشتر در راستای منافع جامعه عمل کردند. نویسندگان چندین الگوی کسب سهم اضافی توسط شرکت‌کنندگان را شرح می‌دهند و نشان می‌دهند که روش معمول شناسایی، شکارچیان Airdrop را به‌اندازۀ کافی حذف نمی‌کند.

    در ابزار توضیح می‌دهد که چرا ابزار صریحاً وعدۀ بررسی 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

    یافته شکارچیان Airdrop عمداً آدرس‌های زیاد کیف پول جمع می‌کنند تا در توزیع‌ها چند بار سهم بگیرند. در مثال صرافی Blur، یک روش یادگیری گراف با استفاده از توالی تراکنش‌ها و فراداده‌های NFT، آن‌ها را به‌مراتب بهتر از روش‌های قبلی شناسایی می‌کند.

    در ابزار شاهدی در بخش الگوهای Sybil: شناسایی به داده‌های تراکنش زنجیره نیاز دارد که یک سازندۀ لست در اختیار ندارد.

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

    یافته کسی که بتواند چندین هویت ارائه کند، بخش بزرگی از یک سیستم توزیع‌شده را کنترول می‌کند. بدون مرجعی که از نظر منطقی مرکزی باشد و هویت‌ها را تایید کند، چنین حملاتی همیشه ممکن‌اند، مگر با فرض‌های غیرواقعی.

    در ابزار توضیح می‌دهد که چرا «یک آدرس، یک Claim» به معنای «یک شخص، یک Claim» نیست؛ بررسی موارد تکراری تنها آدرس‌های یکسان را پیدا می‌کند.

  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 درصد فروش‌ها به‌عنوان موارد احتمالی دستکاری بازار شناسایی شدند؛ در بیشتر الگوها، معاملات میان چند آدرس محدود رفت و برگشت دارند.

    در ابزار نشان می‌دهد که حجم معاملات به‌عنوان معیار ورود به Allowlist می‌تواند دستکاری شده باشد، زیرا یک نفر به‌آسانی چندین آدرس را کنترول می‌کند.

  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 صرفه‌جویی می‌شود.

    در ابزار در متن توضیح می‌دهد که چرا مینت با Allowlist یا قرعه‌کشی آرام‌تر از مینت آزاد بر اساس اصل «هر که زودتر برسد» پیش می‌رود.

  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 پیوند می‌دهد: اثباتی که کسی در Mempool می‌بیند، برای خودش قابل استفاده نیست.

معیارها، ادارات و معلومات تولیدکنندگان

دوشنبه تا جمعه، 8 تا 17

ریشه و اثبات‌ها را دارید؟ ما قرارداد مربوط به آن، صفحۀ دریافت با اتصال به کیف پول را می‌سازیم و پیش از آن‌که دارایی واقعی به آن وابسته شود، همه چیز را در یک شبکۀ آزمایشی امتحان می‌کنیم. از رودویش (Rodewisch)، برای پروژه‌ها در سراسر آلمان.

+49 3744 4399760[email protected]

دوشنبه تا جمعه، ساعت 8 تا 17 · Straße der Jugend 5, 08228 Rodewisch

پیاده‌سازی Allowlist را به ما بسپارید
+49 3744 4399760دوشنبه تا جمعه، 8 تا 17
زنگ بزنیدتماس برگشتی

لست اجزا · ورق 1/1

این صفحه از چه ساخته شده است

اندازه‌ها هنگام ساختن صفحه گرفته شده — با JavaScript براوزر شما دوباره و زنده اندازه می‌گیرد.

ردیفجزءنوعاندازه
01index.htmlسند≈ 29 kB
02styles.cssاستایل‌شیت≈ 20 kB
03scripts.jsاسکریپت≈ 13 kB
04archivo-variable.woff2فونت≈ 58 kB
05ibm-plex-mono.woff2فونت≈ 30 kB
06favicon.svgگرافیک< 1 kB

کوکی‌های اعلانی یا تحلیلی: هیچ. بدون اجازۀ شما این صفحه از سرورهای بیرونی چیزی بار نمی‌کند، به جز خدمات رسانندۀ ما Cloudflare — فونت‌ها، اسکریپت‌ها و گرافیک‌ها نزد خود ماست. آی‌تی شما را هم همین‌طور می‌سازیم.

بیرون از ساعات کاری

با این هم زنگ زده می‌توانید

به طور عادی دوشنبه تا جمعه، ساعت 8 تا 17 در دفتر هستیم.

شمارۀ ما شام‌ها و آخر هفته هم به ما انتقال می‌یابد و اکثراً کسی جواب می‌دهد. این را وعده داده نمی‌توانیم.

اگر کسی جواب نداد، یک پیام صوتی کوتاه بگذارید: نام، شماره و موضوع. هر چه زودتر زنگ می‌زنیم، حداکثر تا روز کاری بعدی.

خود تماس پولی ندارد. اگر بیرون از ساعات کاری کسی باید فوراً کار کند، اضافه‌پول مطابق لست قیمت‌ها حساب می‌شود.

همین حالا زنگ بزنید+49 3744 4399760

نوشتن را ترجیح می‌دهید؟ از طریق فورم تماس یا به [email protected]. آن را روز کاری بعدی می‌خوانیم.

تشخیص · AT-K2

چه مشکلی دارید؟

↵ انتخابESC بستنزنگ بزنید: +49 3744 4399760

تنظیمات شخصی

کدام خدمات اجازۀ بار شدن دارند؟

از نظر تخنیکی ضروری

تصمیمی که این‌جا می‌گیرید، و تنظیمات رنگ و حرکت. این معلومات به شکل چند ثبت کوچک روی دستگاه شما می‌ماند و هرگز به سرور فرستاده نمی‌شود. برای کار صفحه لازم است و از همین خاطر خاموش شده نمی‌تواند.