ابزار AT-W38REV. 2026-A
سازندۀ Merkle Allowlist: ریشه و اثباتها برای Mint و Airdrop
یک Merkle Allowlist تنها یک هش را در قرارداد هوشمند قرار میدهد: ریشه. هر آدرس لست یک اثبات کوتاه میگیرد؛ برای 10.000 آدرس، 13 یا 14 هش. قرارداد هنگام Mint یا Claim دوباره حساب میکند که آیا آدرس در لست شامل است یا خیر. سازنده ریشه و اثباتها را مانند OpenZeppelin میسازد و پیش از آن هر آدرس را مطابق EIP-55 و از نظر تکراری بودن بررسی میکند.
- رایگان
- بدون ثبت نام
- در براوزر حساب میکند
01 / سازنده
لست را وارد کنید، ریشه و اثباتها را ببینید
سازنده · ریشۀ Merkle و اثباتها
این ابزار ریشه و اثباتها را مطابق روش OpenZeppelin حساب میکند. با این حال، پیش از آنکه دارایی واقعی به قرارداد و Claim وابسته شود، هر دو را در یک شبکۀ آزمایشی امتحان کنید. تنها آدرسهای عمومی را وارد کنید، هرگز کلید خصوصی را وارد نکنید.
سطرهای نامعتبر و موارد تکراری را حذف میکند؛ مقدارهای متفاوت برای آدرسهای تکراری با هم جمع میشوند. پس از آن دوباره محاسبه کنید.
اثبات برای یک آدرس
خروجی
StandardMerkleTree.load() یا SimpleMerkleTree.load() فایل درخت را میخواند. فایل اثبات برای هر آدرس شامل مقدار، برگ و اثبات است، همانطور که صفحۀ Claim به آن نیاز دارد.
بررسی در قرارداد (Solidity)
در براوزر شما حساب میکند. لست فرستاده یا ذخیره نمیشود.
02 / اساس
یک ریشه در قرارداد، یک اثبات برای هر آدرس
راهحل ابتدایی این است که تمام آدرسهای مجاز در قرارداد ذخیره شوند. این کار پرهزینه میشود. هر جای تازۀ اشغالشده در حافظه حداقل 20.000 Gas هزینه دارد؛ برای 10.000 آدرس یعنی 200.000.000 Gas، تنها برای ثبت کردن. درخت Merkle این روش را برعکس میکند: لست بیرون از زنجیره میماند و در قرارداد تنها یک مقدار 32 بایت ثبت میشود.
درخت اینگونه ساخته میشود. از هر سطر لست یک هش ساخته میشود که برگ نام دارد. هش برگها را جفتجفت به هم پیوند میدهند و دوباره هش میکنند. همین کار برای جفتهای حاصل ادامه مییابد تا تنها یک مقدار باقی بماند: ریشه. اگر حتی یک رقم در یک مقدار تغییر کند، ریشه تغییر میکند. این ایده از یک روش امضا در سال 1987 آمده است که در آن اندازۀ امضا با افزایش تعداد پیامها تنها بهصورت لگاریتمی رشد میکند Merkle 1988.
هنگام Claim، دریافتکننده اثبات خود را همراه میفرستد (به انگلیسی Proof): هش گرۀ هموالد در هر قدم از مسیر برگ آن آدرس تا ریشه. قرارداد مسیر را دوباره حساب میکند و نتیجه را با ریشۀ ذخیرهشده مقایسه میکند. این الگوی ساختارهای دادۀ تصدیقشده است که در آن لازم نیست عرضهکنندۀ داده قابل اعتماد باشد، چون دریافتکننده خودش اثبات را بررسی میکند Tamassia 2003. بنابراین صفحۀ Claim شما نمیتواند یک مورد ساختگی اضافه کند؛ قرارداد اثبات نادرست را رد میکند.
تصویر 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 / قالب
کدام قالب؟ قرارداد تعیین میکند
مهمترین قاعده در آغاز: سازنده و قرارداد باید برگ را دقیقاً یکسان بسازند. یک بایت تفاوت کافی است تا هر Claim با پیام «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 با بررسی Airdropهای سالهای 2014 تا 2022 تحقیق کردهاند که چرا پروژهها اصلاً توکن رایگان میدهند: عمدتاً برای بازاریابی و توزیع گستردهتر مالکیت و کنترول Allen و همکاران 2023. پس توزیع باید به افراد زیادی برسد و هزینۀ آن از منفعتش بیشتر نشود.
در اصل دو راه وجود دارد. در روش Push، توزیعکننده خودش به هر دریافتکننده انتقال میدهد. در روش Pull، دریافتکنندگان خودشان سهمشان را میگیرند؛ Merkle-Claim دقیقاً همین است. Fröwis و Böhme تعداد 35 سناریو را محاسبه کردهاند: Pull برای توزیعکننده صرفهجویی محدودی دارد و هزینۀ نامتناسبی را بر هر دریافتکننده تحمیل میکند. در مجموع، هزینۀ تمام روشها تقریباً بهصورت خطی با تعداد دریافتکنندگان افزایش مییابد Fröwis و Böhme 2019. بنابراین ارزش Merkle-Claim بیشتر در نظمدهی است تا صرفهجویی در کارمزد: لست بیرون از قرارداد میماند و تنها چیزی دریافت میشود که کسی واقعاً آن را میخواهد.
| راه | چه کسی کارمزد را میپردازد | هزینۀ آغاز کار | تغییر پس از آغاز |
|---|---|---|---|
| انتقال مستقیم (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 میخواند، برای دریافت سهم به نفع خودش سودی ندارد.
05 / حسابهای متعدد
آنچه لست انجام نمیدهد: حسابهای متعدد و حفاظت از معلومات
درخت 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. اگر لست از فایل مشتریان شما آمده است، نشر آن باید پیشاپیش از نظر حفاظت از معلومات بررسی شود. خود سازنده چیزی نمیفرستد؛ در براوزر شما حساب میکند.
06 / روش کار
چگونه یک Allowlist را پیاده کنید
- معیارها و تاریخ مبنا را مکتوب کنید. چه کسی چقدر میگیرد و انتخاب بر کدام بلاک استوار است؟ پیش از ساختن لست این موارد را بنویسید؛ در غیر آن بعداً نمیتوان توضیح داد که چرا یک آدرس موجود نیست.
- از لست خروجی درست بگیرید. مقدارها را بهصورت متن، نه عدد، و بهروشنی به کوچکترین واحدها یا واحد توکن ثبت کنید.
- قالب را مطابق قرارداد انتخاب کنید. قرارداد جدید: قالب OpenZeppelin. قرارداد موجود: ببینید برگ را چگونه میسازد و قدم 1 را مطابق آن تنظیم کنید.
- دریافت را در شبکۀ آزمایشی انجام دهید. ریشه را در قرارداد قرار دهید، سپس بگذارید دو یا سه آدرس واقعاً Claim کنند، از جمله آدرسی که در لست نیست. اگر دریافت سهم ناکام شد، بخش بررسی اثبات مسیر محاسبه و مطابقت نتیجۀ آن با ریشه را نشان میدهد.
- لست و فایل درخت را نگه دارید. سازنده از دقیقاً همان لست، دوباره همان ریشه را حساب میکند. اگر یک سطر تغییر کند، دیگر هیچچیز مطابقت ندارد.
- پایان کار را از همان آغاز پلان کنید. مهلت Claim و تابعی که باقیماندهها را پس بگیرد، باید پیش از فعال شدن قرارداد در آن باشند. در قراردادی که قابل ارتقا نیست، نمیتوان اینها را بعداً اضافه کرد.
جایی که کار سازنده تمام میشود
- حسابهای متعدد را بررسی نمیکند. آدرسهای یکسان را پیدا میکند، نه چند آدرس متعلق به یک شخص را.
- یک ساختار درخت. ساختار OpenZeppelin با برگهای مرتبشده. درختهای کتابخانههای دیگر را بازسازی نمیکند؛ با این حال بخش بررسی اثبات، اثباتهای جداگانۀ آنها را بررسی میکند.
- برگها از address و uint256 ساخته میشوند. فیلدهای دیگر مانند شمارۀ ترتیبی، اثباتهای گروهی (Multiproof) و تابعهای هش اختصاصی شامل نیستند.
- زنجیره را بررسی نمیکند. نه موجودیها را میخواند و نه قراردادها را و جای بررسی قرارداد را نمیگیرد.
قرارداد، صفحۀ Claim و اتصال به کیف پولها را در بخش انکشاف Web3 میسازیم. رمزگشای Calldata پیش از امضای تراکنش نشان میدهد که آن تراکنش واقعاً چه چیزی را فراخوانی میکند. تمام ابزارهای Web3 در نمای کلی Web3 آمدهاند.
07 / تحقیق
تحقیقات علمی در این باره چه میگوید
پنج یافته پشتوانۀ نکتههای سازنده هستند. لست کامل همراه با یادداشت بررسی در پایین آمده است.
- اثبات بهصورت لگاریتمی رشد میکند. به همین دلیل برای 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؛ به همین دلیل دربارۀ نشر لست نکتهای آمده است.
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…,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 نوشته شده است.
09 / سوالهای رایج
سوالهای رایج دربارۀ ریشۀ 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 و آزمایش در شبکۀ آزمایشی را ما انجام میدهیم.
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 سناریوی Airdrop: کاهش هزینه تا نصف ممکن است، اما به تدابیری در قرارداد توکن نیاز دارد. روشهایی که دریافتکنندگان خودشان سهمشان را میگیرند (Pull)، برای توزیعکننده صرفهجویی محدودی دارند و هزینۀ نامتناسبی را بر هر دریافتکننده تحمیل میکنند.
در ابزار مبنای بخش «توزیع کنید یا بگذارید خودشان دریافت کنند»: Merkle-Claim یک روش 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-Airdrop سال 2014 نشان میدهند که از طریق فعالیت در زنجیرۀ جدید میتوان میان آدرسهای یک شخص در Bitcoin، Litecoin و Dogecoin ارتباط برقرار کرد. Airdropها برای دریافتکنندگان بیخطر شمرده میشوند، اما پیامدهای آنها برای حریم خصوصی نادیده گرفته میشود.
در ابزار دلیل این نکته است که با نشر فایل درخت یا فایل اثبات، هر آدرس با مقدار آن آشکار میشود.
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
یافته مطالعات موردی Airdropهای شناختهشده از 2014 تا 2022: پروژهها عمدتاً به دو دلیل توکن توزیع میکنند؛ برای بازاریابی (جذب کاربر و حفظ جامعه) و برای غیرمتمرکز کردن مالکیت و کنترول.
در ابزار پیش از پرداختن به تخنیک، در متن توضیح میدهد که شرکتها اصلاً برای چه Allowlist یا Airdrop ایجاد میکنند.
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
یافته نه مطالعۀ موردی: معیارهای Airdrop پیوسته پیچیدهتر میشوند، چون کاربران خود را با هر قاعده عیار میکنند تا سهم بیشتری بگیرند. این پژوهش بهجای یک Airdrop واحد، چندین دور را پیشبینی میکند تا پروژهها از تجربه بیاموزند.
در ابزار پشتوانۀ این توصیه است که معیارها پیش از ساختن لست مکتوب شوند و برای هر دور یک ریشۀ جداگانه ساخته شود.
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
یافته تحلیل نقشها بر اساس دادههای Airdrop مربوط به ParaSwap: کسانی که بیشتر دریافت کردند، بیشتر در راستای منافع جامعه عمل کردند. نویسندگان چندین الگوی کسب سهم اضافی توسط شرکتکنندگان را شرح میدهند و نشان میدهند که روش معمول شناسایی، شکارچیان Airdrop را بهاندازۀ کافی حذف نمیکند.
در ابزار توضیح میدهد که چرا ابزار صریحاً وعدۀ بررسی 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
یافته شکارچیان Airdrop عمداً آدرسهای زیاد کیف پول جمع میکنند تا در توزیعها چند بار سهم بگیرند. در مثال صرافی 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
یافته کسی که بتواند چندین هویت ارائه کند، بخش بزرگی از یک سیستم توزیعشده را کنترول میکند. بدون مرجعی که از نظر منطقی مرکزی باشد و هویتها را تایید کند، چنین حملاتی همیشه ممکناند، مگر با فرضهای غیرواقعی.
در ابزار توضیح میدهد که چرا «یک آدرس، یک Claim» به معنای «یک شخص، یک Claim» نیست؛ بررسی موارد تکراری تنها آدرسهای یکسان را پیدا میکند.
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 درصد فروشها بهعنوان موارد احتمالی دستکاری بازار شناسایی شدند؛ در بیشتر الگوها، معاملات میان چند آدرس محدود رفت و برگشت دارند.
در ابزار نشان میدهد که حجم معاملات بهعنوان معیار ورود به Allowlist میتواند دستکاری شده باشد، زیرا یک نفر بهآسانی چندین آدرس را کنترول میکند.
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 صرفهجویی میشود.
در ابزار در متن توضیح میدهد که چرا مینت با Allowlist یا قرعهکشی آرامتر از مینت آزاد بر اساس اصل «هر که زودتر برسد» پیش میرود.
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 پیوند میدهد: اثباتی که کسی در Mempool میبیند، برای خودش قابل استفاده نیست.
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