ابزار AT-W38REV. 2026-A
ساخت Merkle Allowlist: ریشه و اثبات برای مینت و ایردراپ
Allowlist مرکل فقط یک هش را در قرارداد هوشمند ذخیره میکند: ریشه. هر آدرس در فهرست یک اثبات کوتاه میگیرد؛ برای 10,000 آدرس، 13 یا 14 هش. قرارداد هنگام مینت یا دریافت سهم محاسبه میکند که آیا آدرس عضو فهرست است یا نه. این ابزار ریشه و اثباتها را مانند OpenZeppelin میسازد و پیش از آن، هر آدرس را بر اساس EIP-55 و از نظر تکراری بودن بررسی میکند.
- رایگان
- بدون ثبتنام
- محاسبه در مرورگر
01 / ابزار ساخت
فهرست را وارد کنید، ریشه و اثباتها را ببینید
ابزار ساخت · ریشه مرکل و اثباتها
این ابزار ریشه و اثباتها را با روش OpenZeppelin محاسبه میکند. با این حال، پیش از آنکه دارایی واقعی در میان باشد، قرارداد و دریافت سهم را در یک شبکه آزمایشی امتحان کنید. فقط آدرسهای عمومی را وارد کنید، هرگز کلید خصوصی را وارد نکنید.
سطرهای نامعتبر و ورودیهای تکراری را حذف میکند؛ مقدارهای متفاوت برای آدرسهای تکراری با هم جمع میشوند. سپس دوباره محاسبه کنید.
اثبات برای یک آدرس
خروجی
فایل درخت با StandardMerkleTree.load() یا SimpleMerkleTree.load() خوانده میشود. فایل اثبات برای هر آدرس شامل مقدار، برگ و اثبات است؛ همان اطلاعاتی که صفحه دریافت سهم نیاز دارد.
بررسی در قرارداد (Solidity)
در مرورگر شما محاسبه میکند. فهرست ارسال یا ذخیره نمیشود.
02 / مبنا
یک ریشه در قرارداد، یک اثبات برای هر آدرس
راهحل اولیه این است که همه آدرسهای مجاز را در قرارداد ذخیره کنیم. اما این کار گران تمام میشود. هر محل ذخیرهسازی که تازه اشغال میشود، حداقل 20,000 Gas هزینه دارد؛ برای 10,000 آدرس، فقط ثبت کردن آنها 200,000,000 Gas میخواهد. درخت مرکل روش را برعکس میکند: فهرست خارج از بلاکچین میماند و فقط یک مقدار 32 بایتی در قرارداد قرار میگیرد.
ساخت آن اینطور است: از هر سطر فهرست یک هش ساخته میشود که برگ نام دارد. هشِ برگها را جفتجفت به هم وصل میکنند و دوباره هش میگیرند. همین روند را برای جفتهای حاصل ادامه میدهند تا یک مقدار باقی بماند: ریشه. اگر حتی یک رقم در یک مقدار عوض شود، ریشه تغییر میکند. این ایده از یک روش امضا در سال 1987 آمده است که در آن اندازه امضا فقط بهشکل لگاریتمی با تعداد پیامها رشد میکند Merkle 1988.
هنگام دریافت سهم، دریافتکننده اثبات خود را هم میفرستد؛ به انگلیسی Proof: هشِ گره هموالد در هر گام از مسیر برگِ آن آدرس تا ریشه. قرارداد مسیر را دوباره محاسبه میکند و نتیجه را با ریشه ذخیرهشده مقایسه میکند. این همان الگوی ساختارهای داده احرازشده است که در آن لازم نیست ارائهدهنده داده قابلاعتماد باشد، چون دریافتکننده خودش اثبات را بررسی میکند Tamassia 2003. بنابراین صفحه دریافت سهم شما نمیتواند ورودی ساختگی اضافه کند؛ قرارداد اثبات نادرست را رد میکند.
شکل 1 · مقادیر واقعی از چهار آدرس نمونه (قالب standard، فقط آدرس)، بهشکل کوتاهشده. اثبات برای 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؛ طبق EIP-2929 برای یک محل سرد، 2,100 Gas اضافه میشود). آخرین بهروزرسانی: 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، دریافتکنندگان خودشان سهمشان را میگیرند؛ دریافت سهم با مرکل دقیقاً همین است. Fröwis و Böhme تعداد 35 سناریو را محاسبه کردهاند: Pull فقط صرفهجویی محدودی برای توزیعکننده دارد و هزینه نامتناسبی به هر دریافتکننده تحمیل میکند. در مجموع هم هزینه همه روشها تقریباً بهشکل خطی با تعداد دریافتکنندگان رشد میکند Fröwis و Böhme 2019. بنابراین مزیت دریافت سهم با مرکل بیشتر در نظم کار است تا کارمزد: فهرست وارد قرارداد نمیشود و فقط چیزی دریافت میشود که کسی واقعاً آن را میخواهد.
| راه | چه کسی کارمزد را میپردازد | هزینه و کار لازم در شروع | تغییر پس از شروع |
|---|---|---|---|
| انتقال مستقیم (Push) | توزیعکننده، یک انتقال برای هر دریافتکننده | با هر آدرس بیشتر میشود | ممکن نیست؛ آنچه ارسال شده، ارسال شده است |
| ذخیره فهرست در قرارداد | توزیعکننده برای ثبت (از 20,000 Gas بهازای هر آدرس)، دریافتکننده برای دریافت سهم | با هر آدرس بیشتر میشود | تکبهتک، از طریق یک تابع مدیریتی |
| ریشه مرکل (Pull) | دریافتکننده، برای دریافت سهم و اثبات | یک محل ذخیرهسازی برای ریشه | فقط با یک ریشه جدید. اثباتها را در برابر ریشه جدید بررسی کنید |
برای مقدارهای کم ممکن است کارمزد دریافت سهم از ارزش سهم دریافتی بیشتر شود. در این حالت بهتر است توزیع روی یک بلاکچین لایه 2 ارزان انجام شود یا حداقل مقدار تعیین کنید. محاسبهگر کارمزد Gas هزینه دریافت سهم با قیمتهای فعلی Gas را محاسبه میکند.
مینت NFT: استفاده از Allowlist بهجای رقابت بر سر کارمزد
در مینت عمومی با تعداد محدود، خریداران با کارمزد Gas بالاتر از هم پیشی میگیرند. این کار کارمزد را برای همه بالا میبرد و Gas را هدر میدهد؛ پژوهشی درباره عرضه NFT این موضوع را نشان میدهد و قرعهکشی را راهحل پیشنهاد میکند Ko و همکاران 2023. Allowlist با بازه زمانی مشخص هم این رقابت را از بین میبرد. رباتهایی در جلو زدن تخصص دارند: تراکنشهای در انتظار را میخوانند و با کارمزد بالاتر از آنها جلو میزنند Daian و همکاران 2020.
از این موضوع یک قاعده برای قرارداد به دست میآید: آدرس داخل برگ و دریافتکننده باید یکی باشند. سادهترین راه این است که قرارداد برگ را از msg.sender بسازد، همانطور که در قطعهکد Solidity ابزار آمده است. در این صورت اثباتی که کسی در Mempool میبیند، برای دریافت سهم خودش به کار نمیآید.
05 / حسابهای متعدد
آنچه فهرست انجام نمیدهد: حسابهای متعدد و حریم خصوصی
درخت مرکل بررسی میکند که آیا یک آدرس در فهرست هست یا نه. نمیداند پشت ده آدرس، ده نفر هستند یا یک نفر. این یکی از نتایج قدیمی علوم کامپیوتر است: بدون مرجعی برای تأیید هویتها، نمیتوان جلوی هویتهای متعدد (حملههای Sybil) را گرفت، مگر با فرضهای غیرواقعی Douceur 2002. به همین دلیل، بررسی موارد تکراری فقط همان آدرس را پیدا میکند، حتی اگر بهشکل دیگری نوشته شده باشد.
- شکارچیان ایردراپ پدیدهای رایجاند. Fan و همکارانش در بررسی ایردراپ ParaSwap چند الگوی برداشت سود توسط شرکتکنندگان را توصیف کردهاند که روشهای تشخیص معمول بهاندازه کافی حذفشان نمیکردند Fan و همکاران 2023. روشهای بهتر، گراف تراکنشها و فرادادهها را تحلیل میکنند Zhou و همکاران 2024؛ این کار به دادههای بلاکچین نیاز دارد و فهرست بهتنهایی کافی نیست.
- از قواعد تا حد ممکن استفاده میشود. بهمحض مشخص شدن معیارها، کاربران خود را با آنها تطبیق میدهند. به همین دلیل، Allen پیچیدهتر شدن معیارها را مشاهده کرده و انتظار دارد ایردراپها در چند دور انجام شوند Allen 2024. هر دور ریشه خودش را دارد و اثباتهای دور قبلی دیگر معتبر نیستند.
- حجم معاملات معیار قابلاتکایی نیست. در 52 مجموعه بزرگ NFT، الگوهایی شبیه معاملات صوری در 3.93 درصد آدرسها دیده شد؛ بیشتر بهشکل رفتوبرگشت میان چند آدرس محدود von Wachter و همکاران 2023.
- وظایف، اسکریپتها را جذب میکنند. یک سیستم مأموریت با 80 میلیون وظیفه انجامشده، فعالیت برای جمعآوری پاداش و رباتها را جذب کرد و جدا کردن کاربران واقعی از اسکریپتها دشوار بود Al-Chami و Clark 2025. معیارهایی که انجامشان با اسکریپت ارزان تمام نمیشود، بیشتر دوام میآورند.
- راههای مقابله خارج از فهرست هستند. اثبات اینکه پشت یک آدرس انسان قرار دارد، مثلاً با معرفی ضامن و رأیگیری در جامعه، حوزهای جداگانه با ضعفهای خودش است Siddarth و همکاران 2020.
زمان آشکار شدن آدرسها و اثباتها
بهمحض اینکه ریشه در قرارداد قرار گیرد، عمومی است. یک Claim آدرس، اثبات و در صورت لزوم مقدار را روی زنجیره آشکار میکند. فایل درخت با قالب استاندارد و فایل اثبات شامل همه آدرسها و مقدارهای واردشده برای هر یک هستند. فایل درخت با قالب ساده، برگها را بهصورت هش ذخیره میکند. پژوهش ایردراپ Clam در سال 2014 نشان میدهد چه مقدار اطلاعات میتوان از چنین دادههایی به دست آورد: با بررسی فعالیت در زنجیره جدید، آدرسهای یک فرد در سه بلاکچین دیگر به هم مرتبط شدند Harrigan و همکاران 2018. اگر فهرست از پرونده مشتریان شما آمده است، انتشار آن باید از قبل از نظر حریم خصوصی بررسی شود. خود ابزار چیزی ارسال نمیکند و در مرورگر شما محاسبه میکند.
06 / روش کار
چطور یک Allowlist پیادهسازی کنید
- معیارها و زمان مبنا را مشخص و ثبت کنید. چه کسی چقدر میگیرد و انتخاب بر اساس کدام بلوک است؟ این موارد را پیش از ساخت فهرست بنویسید؛ وگرنه بعداً نمیتوان توضیح داد چرا آدرسی در فهرست نیست.
- از فهرست خروجی درست بگیرید. مقدارها را بهصورت متن ذخیره کنید، نه عدد، و مشخص کنید برحسب کوچکترین واحد هستند یا واحد توکن.
- قالب را بر اساس قرارداد انتخاب کنید. قرارداد جدید: قالب OpenZeppelin. قرارداد موجود: ببینید برگ را چطور میسازد و مرحله 1 را مطابق آن تنظیم کنید.
- در شبکه آزمایشی سهم را دریافت کنید. ریشه را در قرارداد قرار دهید، سپس با دو یا سه آدرس واقعاً دریافت سهم را انجام دهید؛ یک آدرس خارج از فهرست را هم امتحان کنید. اگر مشکلی پیش بیاید، بخش بررسی اثبات نشان میدهد مسیر کجا قطع میشود.
- فهرست و فایل درخت را نگه دارید. ابزار از دقیقاً همان فهرست دوباره همان ریشه را میسازد. اگر یک سطر تغییر کند، دیگر هیچچیز با هم سازگار نیست.
- پایان کار را هم از ابتدا در نظر بگیرید. مهلت دریافت سهم و تابع بازگرداندن باقیمانده باید پیش از فعال شدن قرارداد در آن باشند. در قراردادی که قابلیت ارتقا ندارد، بعداً نمیتوان این امکانات را اضافه کرد.
ابزار ساخت تا کجا کمک میکند
- حسابهای متعدد را بررسی نمیکند. آدرسهای یکسان را پیدا میکند، نه چند آدرس متعلق به یک نفر را.
- فقط یک چیدمان درخت. چیدمان OpenZeppelin با برگهای مرتبشده. درختهای کتابخانههای دیگر را بازسازی نمیکند؛ با این حال، بخش بررسی اثبات، اثباتهای تکی آنها را بررسی میکند.
- برگها از address و uint256 ساخته میشوند. فیلدهای اضافی مانند شماره ترتیبی، اثبات گروهی (Multiproof) و توابع هش اختصاصی پشتیبانی نمیشوند.
- بلاکچین را نمیخواند. نه موجودیها را میخواند و نه قراردادها را، و جای بررسی قرارداد را نمیگیرد.
در خدمات توسعه Web3، قرارداد، صفحه دریافت سهم و اتصال به کیف پولها را میسازیم. رمزگشای Calldata نشان میدهد یک تراکنش پیش از امضا دقیقاً چه چیزی را فراخوانی میکند. همه ابزارهای Web3 در فهرست Web3 آمدهاند.
07 / پژوهش
پژوهشها در این باره چه میگویند
پنج یافته پشتوانه نکتههای این ابزار هستند. فهرست کامل همراه با یادداشت بررسی در ادامه آمده است.
- اثبات بهشکل لگاریتمی رشد میکند. به همین دلیل برای 10,000 آدرس، 13 یا 14 هش کافی است 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) کار میکنند، میتوانند محاسبه این صفحه را مستقیم فراخوانی کنند، بهجای آنکه خودشان آن را بازسازی کنند. سرور عمومی است، ثبتنام لازم ندارد و چیزی ذخیره نمیکند. پاسخ همیشه لینک این صفحه، تاریخ بهروزرسانی دادهها و محدودیتهای نتیجه را در بر دارد.
- نقطه اتصال
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» (پیشفرض): برگ فقط از آدرس ساخته میشود، مثلاً برای Allowlist مینت. «menge»: آدرس و مقدار (uint256)، مثلاً برای ایردراپ. |
dezimalstellen | نه | فقط برای «menge»: تعداد رقمهای اعشار توکن. 0 (پیشفرض) = مقدارها از قبل برحسب کوچکترین واحد هستند؛ 18 = مقدارها بر حسب واحد توکن هستند و به wei تبدیل میشوند. |
beweise_fuer | نه | آدرسهایی که باید اثباتشان برگردانده شود. اگر مشخص نکنید و فهرست حداکثر 20 ورودی داشته باشد، اثبات همه برگردانده میشود. |
mit_baumdatei | نه | فایل درخت با قالب OpenZeppelin نیز همراه خروجی ارائه شود (StandardMerkleTree.load / SimpleMerkleTree.load)، تا 1000 ورودی. |
root | نه | برای «pruefen»: ریشه مرکل، شامل 0x و 64 کاراکتر هگز. |
adresse | نه | برای «pruefen»: آدرسی که اثباتش بررسی میشود، یا مستقیماً یک هش برگ (bytes32). |
menge | نه | برای «pruefen» با inhalt برابر با «menge»: مقدار برحسب کوچکترین واحد بهصورت عدد صحیح، مثلاً «5000000000000000000». |
beweis | نه | برای «pruefen»: هشهای اثبات، از برگ تا ریشه، هرکدام شامل 0x و 64 کاراکتر هگز. |
پرسشهایی که دستیار باید برایشان این ابزار را فراخوانی کند
- «برای این Allowlist یک ریشه مرکل با قالب OpenZeppelin بساز و اثبات اولین آدرس را به من بده.»
- «ریشه مرکل این ایردراپ با آدرس و مقدار برحسب wei چیست و چطور برگ را در Solidity بررسی کنم؟»
- «آیا این اثبات مرکل با ریشه من سازگار است یا قرارداد من بهجای abi.encode با abi.encodePacked محاسبه میکند؟»
- «آیا فایل tree.json من از StandardMerkleTree هنوز با مقادیر داخل آن مطابقت دارد؟»
اینکه اتصال چطور کار میکند و MCP در کسبوکار شما چه کاری از پیش میبرد، در صفحه یکپارچهسازی با MCP آمده است.
09 / پرسشهای متداول
پرسشهای متداول درباره ریشه مرکل، اثبات و Allowlist
Allowlist مرکل چیست؟
فهرستی از آدرسهای مجاز است که فقط یک هش از آن در قرارداد هوشمند ذخیره میشود: ریشه مرکل. هر آدرس یک اثبات شامل چند هش دریافت میکند؛ برای 10,000 آدرس، 13 یا 14 هش. هنگام مینت یا دریافت سهم، آدرس این اثبات را همراه درخواست میفرستد و قرارداد محاسبه میکند که آیا به ریشه میرسد یا نه. خود فهرست خارج از بلاکچین میماند.
چرا OpenZeppelin برگ را دو بار هش میکند؟
هر گره داخلی درخت از 64 بایت، یعنی دو هش چسبیده به هم، ساخته میشود. اگر طول یک برگ پیش از هش شدن هم 64 بایت باشد، میتوان یک گره داخلی را بهجای برگ جا زد. طول abi.encode(address, uint256) دقیقاً 64 بایت است. هش دوم جلوی این کار را میگیرد؛ OpenZeppelin در مستندات MerkleProof صریحاً درباره مقادیر برگ با طول 64 بایت و یک بار هش شدن با keccak256 هشدار میدهد.
دریافت سهم من با خطای «Invalid proof» ناموفق میشود. علت چیست؟
معمولاً قرارداد برگ را متفاوت از ابزاری میسازد که اثباتها را تولید کرده است: abi.encode بهجای abi.encodePacked، یک هش بهجای دو هش، یا مقدار بر حسب واحد توکن بهجای کوچکترین واحد. علت دیگر، استفاده از ریشه نسخه قدیمیتر فهرست است. بخش بررسی اثبات زیر ابزار، مسیر را قدمبهقدم دوباره محاسبه میکند؛ هر دو قالب و هر دو واحد را در آن امتحان کنید.
آیا نتیجه با OpenZeppelin StandardMerkleTree سازگار است؟
بله. برگ، مرتبسازی و چیدمان درخت یکسان هستند و StandardMerkleTree.load() فایل درخت با قالب standard-v1 را مستقیم بارگذاری میکند. نمونه README کتابخانه در این ابزار، درست مانند OpenZeppelin، ریشه 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77 را میدهد. قالب ساده از چیدمان SimpleMerkleTree (simple-v1) استفاده میکند.
حجم اثبات مرکل برای 10,000 آدرس چقدر است؟
13 یا 14 هش، هرکدام 32 بایت؛ یعنی حداکثر 448 بایت. هزینه آن در Calldata با نرخ 16 Gas برای هر بایت طبق EIP-2028، حداکثر 7,168 Gas است. برای یک میلیون آدرس، 20 هش لازم است. در مقابل، ذخیره کل فهرست در قرارداد حداقل 20,000 Gas بهازای هر آدرس هزینه دارد.
آیا بعد از استقرار قرارداد هم میتوانم فهرست را تغییر دهم؟
فقط با یک ریشه جدید. حتی تغییر یک مقدار نیز ریشه جدیدی ایجاد میکند. اثباتها را در برابر این ریشه جدید بررسی کنید، حتی اگر برخی اثباتها بدون تغییر باقی بمانند. برای این کار قرارداد باید تابعی داشته باشد که یک فرد مجاز بتواند با آن ریشه را جایگزین کند؛ بدون آن، فهرست همانطور میماند. اگر توزیع در چند دور انجام میشود، باید هر دور ریشه خودش را داشته باشد و قرارداد ثبت کند چه کسی در کدام دور سهمش را دریافت کرده است.
آیا Allowlist مرکل جلوی رباتها و حسابهای متعدد را میگیرد؟
جلوی آدرسهایی را که در فهرست نیستند میگیرد، اما جلوی حسابهای متعدد را نه: کسی که با بیست آدرس وارد فهرست شده، بیست بار پذیرفته میشود. حذف این موارد باید پیش از استفاده از ابزار و هنگام انتخاب آدرسها انجام شود. پژوهشهای ایردراپ نشان میدهند که قواعد ساده برای این کار کافی نیستند.
محدودیتهای ابزار ساخت مرکل چیست؟
ریشه، اثباتها و فایلها را میسازد و آدرسها و موارد تکراری را بررسی میکند؛ همه در مرورگر. حسابهای متعدد را تشخیص نمیدهد، چیزی از بلاکچین نمیخواند، فقط چیدمان 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
یافته پژوهشی که درخت مرکل از آن سرچشمه میگیرد: تعداد زیادی مقدار از طریق یک درخت هش به یک مقدار واحد پیوند داده میشوند. اندازه امضا فقط بهشکل لگاریتمی با تعداد پیامهای امضاشده رشد میکند.
در ابزار مبنای توضیح این موضوع است که چرا طول اثبات برای 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)، صرفهجویی محدودی برای توزیعکننده دارند و هزینه نامتناسبی به هر دریافتکننده تحمیل میکنند.
در ابزار مبنای بخش «توزیع کنید یا بگذارید خودشان دریافت کنند؟» است: دریافت سهم با مرکل یک روش 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: پروژهها بیشتر به دو دلیل توکن توزیع میکنند؛ بازاریابی، یعنی جذب کاربر و حفظ جامعه کاربران، و غیرمتمرکز کردن مالکیت و کنترل.
در ابزار پیش از پرداختن به فناوری، در متن توضیح میدهد که کسبوکارها اصلاً برای چه هدفی Allowlist یا ایردراپ راه میاندازند.
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»). این کار کارمزد را برای همه بالا میبرد و 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: Mixed-case checksum address encoding · Ethereum Improvement Proposals
- EIP-2028: کاهش هزینه Gas دادههای تراکنش (16 Gas برای هر بایت) · Ethereum Improvement Proposals
- EIP-2929: افزایش هزینه Gas برای کدهای عملیاتی دسترسی به وضعیت · Ethereum Improvement Proposals
- Ethereum Yellow Paper، پیوست G: G_sset = 20,000 · Ethereum
- مشخصات ABI در Solidity: abi.encode و حالت بستهبندی غیراستاندارد · Solidity
- مشخصات و محدودیتهای Excel: دقت اعداد تا 15 رقم · Microsoft
11 / ابزارهای دیگر
هنوز سؤالی دارید؟
همه ابزارهای مربوط به کیف پولها، قراردادها و توکنها در صفحه ابزارهای Web3 قرار دارند.
- AT-W32 · کسبوکارها
بررسی مناسب بودن بلاکچین
طرح شما واقعاً بلاکچین لازم دارد یا یک پایگاه داده کافی است؟ - AT-W33 · کسبوکارها
بررسی MiCA
آیا توکن شما مشمول MiCA میشود و چه تعهداتی از آن ناشی میشود؟ - AT-W34 · کاربران خانگی و کسبوکارها
محاسبهگر کارمزد Gas
یک تراکنش روی Ethereum، Arbitrum، Optimism، Base یا Polygon چقدر هزینه دارد؟ - AT-W35 · کاربران خانگی و کسبوکارها
بررسی آدرس Ethereum
این آدرس Ethereum معتبر است و درست نوشته شده؟ بررسی Checksum طبق EIP-55 و مقایسه دو آدرس. - AT-W36 · کسبوکارها
محاسبهگر Selector و Topic
کدام Function Selector یا Event Topic به این امضای Solidity تعلق دارد، و برعکس؟ - AT-W37 · کسبوکارها
رمزگشای Calldata
این تراکنش چه کاری انجام میدهد؟ Calldata را پیش از امضا خوانا کنید.
ریشه و اثباتها را دارید؟ ما قرارداد مربوط به آن، صفحه دریافت توکن با اتصال به کیف پول را میسازیم و پیش از درگیر شدن داراییهای واقعی، همه چیز را روی یک شبکه آزمایشی تست میکنیم. از رودویش (Rodewisch)، برای پروژهها در سراسر آلمان.
+49 3744 4399760[email protected]دوشنبه تا جمعه 8 تا 17 · Straße der Jugend 5, 08228 Rodewisch