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

ساخت Merkle Allowlist: ریشه و اثبات برای مینت و ایردراپ

Allowlist مرکل فقط یک هش را در قرارداد هوشمند ذخیره می‌کند: ریشه. هر آدرس در فهرست یک اثبات کوتاه می‌گیرد؛ برای 10,000 آدرس، 13 یا 14 هش. قرارداد هنگام مینت یا دریافت سهم محاسبه می‌کند که آیا آدرس عضو فهرست است یا نه. این ابزار ریشه و اثبات‌ها را مانند OpenZeppelin می‌سازد و پیش از آن، هر آدرس را بر اساس EIP-55 و از نظر تکراری بودن بررسی می‌کند.

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

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

ابزار ساخت · ریشه مرکل و اثبات‌ها

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

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

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

مرحله 3فهرست را وارد کنید

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

ریشه مرکل

—

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

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

مانند MerkleProof.verify در قرارداد محاسبه می‌کند. وقتی دریافت سهم با خطای «InvalidProof» ناموفق می‌شود، به شما کمک می‌کند.

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

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

راه‌حل اولیه این است که همه آدرس‌های مجاز را در قرارداد ذخیره کنیم. اما این کار گران تمام می‌شود. هر محل ذخیره‌سازی که تازه اشغال می‌شود، حداقل 20,000 Gas هزینه دارد؛ برای 10,000 آدرس، فقط ثبت کردن آن‌ها 200,000,000 Gas می‌خواهد. درخت مرکل روش را برعکس می‌کند: فهرست خارج از بلاکچین می‌ماند و فقط یک مقدار 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 · مقادیر واقعی از چهار آدرس نمونه (قالب 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 هش اضافه می‌شود. هزینه اثبات را دریافت‌کننده همراه تراکنش خود می‌پردازد؛ در قرارداد فقط ریشه قرار دارد، صرف‌نظر از طول فهرست.

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

مهم‌ترین قاعده را اول بگوییم: ابزار و قرارداد باید برگ را دقیقاً یکسان بسازند. یک بایت تفاوت کافی است تا هر دریافت سهم با خطای «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، دریافت‌کنندگان خودشان سهمشان را می‌گیرند؛ دریافت سهم با مرکل دقیقاً همین است. 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 می‌بیند، برای دریافت سهم خودش به کار نمی‌آید.

آنچه فهرست انجام نمی‌دهد: حساب‌های متعدد و حریم خصوصی

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

چطور یک Allowlist پیاده‌سازی کنید

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

ابزار ساخت تا کجا کمک می‌کند

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

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

پژوهش‌ها در این باره چه می‌گویند

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

  • اثبات به‌شکل لگاریتمی رشد می‌کند. به همین دلیل برای 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؛ به همین دلیل درباره انتشار فهرست توضیح داده‌ایم.

استفاده از این ابزار از طریق دستیار هوش مصنوعی

دستیارهایی مثل 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 آمده است.

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

این ابزار بر چه پایه‌ای است

مقادیر راهنما و نکته‌های بالا بر این 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

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

    در ابزار مبنای توضیح این موضوع است که چرا طول اثبات برای 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)، صرفه‌جویی محدودی برای توزیع‌کننده دارند و هزینه نامتناسبی به هر دریافت‌کننده تحمیل می‌کنند.

    در ابزار مبنای بخش «توزیع کنید یا بگذارید خودشان دریافت کنند؟» است: دریافت سهم با مرکل یک روش 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: پروژه‌ها بیشتر به دو دلیل توکن توزیع می‌کنند؛ بازاریابی، یعنی جذب کاربر و حفظ جامعه کاربران، و غیرمتمرکز کردن مالکیت و کنترل.

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

  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»). این کار کارمزد را برای همه بالا می‌برد و 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 تا 17

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

+49 3744 4399760[email protected]

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

اجرای فهرست مجاز را به ما بسپارید
+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 که سایت را به دست شما می‌رساند؛ فونت‌ها، اسکریپت‌ها و تصویرها روی سرور خود ماست. IT شما را هم همین‌طور می‌سازیم.

خارج از ساعت کاری

باز هم با خیال راحت زنگ بزنید

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

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

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

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

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

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

عیب‌یابی · AT-K2

چه پیش آمده؟

↵ انتخابESC بستنتماس: ‎+49 3744 4399760

تنظیمات دلخواه

کدام سرویس‌ها اجازه بارگذاری دارند؟

از نظر فنی ضروری

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