وسیله AT-W38نسخه 2026-A
د Merkle Allowlist جوړونکی: د Mint او Airdrop لپاره Root او ثبوتونه
Merkle-Allowlist په سمارټ قرارداد کې یوازې یو هش، یعنې Root، ساتي. په لېست کې هره پته یو لنډ ثبوت هم ترلاسه کوي؛ د 10.000 پتو لپاره 13 یا 14 هشونه. قرارداد د Mint یا Claim پر مهال محاسبه کوي چې ایا پته په لېست کې شامله ده. جوړونکی Root او ثبوتونه د OpenZeppelin په څېر جوړوي او له دې مخکې هره پته د EIP-55 له مخې او د تکرار له پلوه ګوري.
- وړیا
- له نوم لیکنې پرته
- په براوزر کې محاسبه کوي
01 / جوړونکی
لېست ور دننه کړئ، Root او ثبوتونه وګورئ
جوړونکی · Merkle-Root او ثبوتونه
وسیله Root او ثبوتونه د OpenZeppelin په طریقه محاسبه کوي. بیا هم قرارداد او Claim په ازمایښتي شبکه کې وازمویئ، مخکې له دې چې ریښتینې شتمنۍ ورسره وتړل شي. یوازې عامه پتې دننه کېږي، هېڅکله شخصي کیلي مه دننه کوئ.
ناسمې کرښې او تکراري ننوتنې لرې کوي؛ د بېلابېلو اندازو لرونکو تکراري ننوتنو اندازې سره جمع کوي. وروسته بیا محاسبه وکړئ.
د یوې پتې ثبوت
صادرول
StandardMerkleTree.load() یا SimpleMerkleTree.load() د ونې فایل لولي. د ثبوتونو فایل د هرې پتې لپاره اندازه، پاڼه او ثبوت لري، په هغه بڼه چې د Claim پاڼه ورته اړتیا لري.
په قرارداد کې کتنه (Solidity)
ستاسو په براوزر کې محاسبه کوي. لېست نه لېږل کېږي او نه ساتل کېږي.
02 / بنسټ
په قرارداد کې یوه Root، د هرې پتې لپاره یو ثبوت
تر ټولو نېغه حل لاره به دا وي چې ټولې مجازې پتې په قرارداد کې وساتل شي. خو دا ګران تمامېږي. د حافظې هر نوی کارېدونکی ځای لږ تر لږه 20.000 Gas لګښت لري؛ نو د 10.000 پتو لپاره 200.000.000 Gas، یوازې د ثبتولو لپاره. د Merkle ونه دا طریقه بدلوي: لېست له چین څخه بهر پاتې کېږي او په قرارداد کې یوازې د 32 Byte یو ارزښت ساتل کېږي.
دا داسې جوړېږي: د لېست له هرې کرښې څخه یو هش جوړېږي، چې پاڼه بلل کېږي. هرې دوې پاڼې یوځای هش کېږي، بیا د دې پایلو هره جوړه، تر دې چې یو ارزښت پاتې شي، یعنې Root. که په یوه اندازه کې یوازې یو رقم هم بدل شي، Root بدلېږي. دا مفکوره د 1987 د لاسلیک له یوې طریقې راوتلې، چې پکې د پیغامونو د شمېر له زیاتېدو سره د لاسلیک اندازه یوازې په لوګاریتمي ډول لوړېږي Merkle 1988.
د Claim پر مهال ترلاسه کوونکی خپل ثبوت (په انګلیسي Proof) هم ورسره لېږي: له خپلې پاڼې څخه تر Root پورې په لاره کې د څنګ غوټو هشونه. قرارداد دا لاره بیا محاسبه کوي او پایله له ساتل شوې Root سره پرتله کوي. دا د تصدیق کېدونکو ډېټا جوړښتونو نمونه ده، چې پکې د ډېټا برابرونکی اړ نه دی د باور وړ وي، ځکه ترلاسه کوونکی خپله ثبوت ګوري Tamassia 2003. نو ستاسو د Claim پاڼه جعلي ننوتنه نه شي جوړولای؛ قرارداد ناسم ثبوت ردوي.
انځور 1 · د بېلګې له څلورو پتو څخه ریښتیني ارزښتونه (standard بڼه، یوازې پته)، لنډ شوي. د 0x2222…2222 لپاره ثبوت: دوه هشونه.
| پتې | په هر ثبوت کې هشونه | د ثبوت تر ټولو لویه اندازه | د Calldata تر ټولو لوړ لګښت | په قرارداد کې د لېست لږ تر لږه لګښت |
|---|---|---|---|---|
| 100 | 6 یا 7 | 224 Byte | 3.584 Gas | 2.000.000 Gas |
| 1.000 | 9 یا 10 | 320 Byte | 5.120 Gas | 20.000.000 Gas |
| 10.000 | 13 یا 14 | 448 Byte | 7.168 Gas | 200.000.000 Gas |
| 100.000 | 16 یا 17 | 544 Byte | 8.704 Gas | 2.000.000.000 Gas |
| 1.000.000 | 19 یا 20 | 640 Byte | 10.240 Gas | 20.000.000.000 Gas |
Calldata د هر Byte لپاره په 16 Gas (EIP-2028)، او حافظه د هر نوي ځای لپاره په 20.000 Gas حساب شوې (Yellow Paper، G_sset؛ د EIP-2929 له مخې هغه ځای ته چې په روانه ټرانزکشن کې لا نه وي کارول شوی، 2.100 Gas نور هم ورزیاتېږي). تازه حالت: 14 نومبر 2026.
نو د لېست له لویېدو سره ثبوت ډېر لږ غټېږي. له 10.000 څخه تر یو میلیون پتو پورې یوازې 6 هشونه ورزیاتېږي. د ثبوت لګښت ترلاسه کوونکی د خپلې ټرانزکشن له لارې ورکوي؛ په قرارداد کې یوازې Root ساتل کېږي، که لېست هر څومره اوږد وي.
03 / بڼه
کومه بڼه؟ دا قرارداد ټاکي
لومړی تر ټولو مهمه قاعده: جوړونکی او قرارداد باید پاڼه کټ مټ په یو ډول جوړه کړي. د یو Byte توپیر هم هر Claim د «Invalid proof» له پیغام سره ناکاموي. له همدې امله په ګام 1 کې ستاسو خوښه نه پوښتل کېږي، بلکې دا پوښتل کېږي چې په قرارداد کې څه دي.
| بڼه | پاڼه په Solidity کې | له هش مخکې Byte | د ونې فایل | کارونه |
|---|---|---|---|---|
| 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 Byte څخه جوړېږي، یعنې دوه هشونه چې یو په بل پسې نښلول شوي وي. که یوه پاڼه هم له هش کېدو مخکې 64 Byte اوږده وای، نو داخلي غوټه د پاڼې په توګه وړاندې کېدای شوه. abi.encode(address, uint256) کټ مټ همدومره اوږد دی. دویم هش دا امکان له منځه وړي، او OpenZeppelin د MerkleProof په اسنادو کې په څرګنده د هغو 64 Byte اوږدو پاڼو د ارزښتونو په اړه خبرداری ورکوي چې یوازې یو keccak256 پرې کارول شوی وي. ساده بڼه دا ستونزه نه لري، ځکه abi.encodePacked(address, uint256) یوازې 52 Byte ورکوي. که څوک پاڼې ته نورې ساحې ورزیاتوي، غوره ده چې اوږدوالی یې بیا محاسبه کړي.
ترتیب شوې جوړې، ترتیب شوې پاڼې
دواړه بڼې د هرې جوړې دوه هشونه په ترتیب سره یو په بل پسې نښلوي او کوچنی هش لومړی ږدي. په دې توګه په ثبوت کې دې ته اړتیا نشته چې د څنګ غوټې چپ یا ښی لوری وښودل شي، او د OpenZeppelin MerkleProof.verify دواړه بڼې ګوري. جوړونکی د OpenZeppelin په څېر پاڼې هم ترتیبوي. نور کتابتونونه په بل ډول ترتیب کوي، لکه merkletreejs له sortLeaves پرته؛ هماغه لېست هلته بله Root ورکوي. دا ناسم کار نه دی. خو بیا Root او ثبوتونه باید له دوو بېلابېلو وسیلو څخه نه وي اخیستل شوي.
زموږ ازموینه له هر بدلون سره ګوري چې ایا جوړونکی په رښتیا د OpenZeppelin په څېر محاسبه کوي. د کتابتون د README بېلګه، یعنې له اندازې سره دوه پتې، Root 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77 ورکوي، چې توری په توري له هلته ورکړل شوې Root سره یو شان ده. د 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 د Airdrop بېلګو له لارې څېړلي چې پروژې ولې ټوکنونه وړیا ورکوي: تر ډېره د بازارموندنې لپاره او د دې لپاره چې مالکیت او کنټرول په پراخه کچه ووېشي 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-Root (Pull) | ترلاسه کوونکی، د Claim او ثبوت لپاره | د Root لپاره د حافظې یو ځای | یوازې د نوې Root په توګه. ثبوتونه د نوې Root پر وړاندې وازمویئ |
په کوچنیو اندازو کې کېدای شي د Claim فیس تر هغې شتمنۍ لوړ وي چې اخیستل کېږي. په دې حالت کې غوره ده چې پر ارزانه Layer-2 چین ووېشل شي یا لږ تر لږه اندازه وټاکل شي. د Gas محاسبه ګر ښيي چې په اوسنیو Gas بیو کې د Claim لګښت څومره دی.
NFT-Mint: د سیالې بیې لوړولو پر ځای Allowlist
په پرانیستي Mint کې چې مقدار محدود وي، پېرودونکي د Gas فیسونو په لوړولو له یو بل مخکې کېږي. دا د ټولو فیسونه لوړوي او Gas ضایع کوي، لکه د NFT د پیلونو په اړه یوه څېړنه چې دا ښيي او پچه اچونه د حل لارې په توګه وړاندیز کوي Ko او همکاران 2023. د ټاکلي وخت لرونکې Allowlist هم دا سیالي له منځه وړي. بوټونه په مخکې کېدو کې ځانګړې وړتیا لري: پرانیستې ټرانزکشنونه لولي او په لوړو فیسونو ترې مخکې کېږي Daian او همکاران 2020.
له دې څخه د قرارداد لپاره یوه قاعده راووځي: په پاڼه کې پته او ترلاسه کوونکی باید یو وي. تر ټولو اسانه لاره دا ده چې قرارداد پاڼه له msg.sender څخه جوړه کړي، لکه د جوړونکي د Solidity کوډ په برخه کې. بیا هغه ثبوت چې څوک یې په Mempool کې لولي، د خپلې ګټې لپاره نه شي کارولای.
05 / ګڼ حسابونه
لېست څه نه شي کولای: ګڼ حسابونه او د ډېټا محرمیت
د Merkle ونه ګوري چې ایا پته په لېست کې ده. خو نه پوهېږي چې د لسو پتو تر شا لس کسان دي که یو. دا د کمپیوټرپوهنې یوه پخوانۍ پایله ده: له داسې مرجع پرته چې هویتونه تایید کړي، د ګڼو هویتونو (Sybil بریدونو) مخنیوی نه شي کېدای، مګر د غیرواقعي فرضیو پر بنسټ Douceur 2002. له همدې امله د تکراري ننوتنو کتنه یوازې هماغه پته مومي، حتی که په بله بڼه لیکل شوې وي.
- د Airdrop ښکاریان عام دي. Fan او همکاران د ParaSwap د Airdrop په بېلګه کې څو طریقې تشریح کوي چې ګډونوال پرې ډېرې برخې خپلوي، او معمولې پېژندنې هغوی په کافي اندازه نه وو چاڼ کړي Fan او همکاران 2023. غوره طریقې د ټرانزکشنونو ګرافونه او مېټاډېټا ارزوي Zhou او همکاران 2024؛ دې کار ته د چین ډېټا پکار ده، یوازې لېست بسنه نه کوي.
- له قواعدو اعظمي ګټه اخیستل کېږي. چې معیارونه معلوم شي، کاروونکي ځان ورسره عیاروي. له همدې امله Allen د معیارونو لا پېچلي کېدل ویني او تمه لري چې Airdrops به په څو پړاوونو کې وي Allen 2024. هر پړاو خپله Root لري؛ بیا د پخواني پړاو ثبوتونه اعتبار نه لري.
- د معاملاتو حجم باوري معیار نه دی. په 52 تر ټولو لویو NFT ټولګو کې 3,93 سلنه پتو داسې بڼې لرلې چې صوري معاملاتو ته ورته وې، تر ډېره د څو محدودو پتو ترمنځ تګ راتګ von Wachter او همکاران 2023.
- دندې سکریپټونه راجلبوي. د Quest یوه سیستم چې 80 میلیونه دندې پکې بشپړې شوې وې، د انعامونو راټولول او بوټونه راجلب کړل، او له سکریپټونو څخه د ریښتینو کاروونکو بېلول ګران وو Al-Chami او Clark 2025. هغه معیارونه ډېر دوام کوي چې سکریپټ یې په لږ لګښت نه شي پوره کولای.
- د مخنیوي لارې له لېست څخه بهر دي. دا ثابتول چې د یوې پتې تر شا انسان دی، لکه د ضامنانو او په ټولنه کې د رایې ورکولو له لارې، یوه جلا څانګه ده چې خپلې کمزورۍ لري Siddarth او همکاران 2020.
کله پتې او ثبوتونه ښکاره کېږي
کله چې Root په قرارداد کې ځای پر ځای شي، عامه کېږي. یو Claim پته، ثبوت او د اړتیا په صورت کې مقدار پر چین ښکاره کوي. د ونې فایل په معیاري بڼه او د ثبوت فایل ټولې پتې او د هرې پتې لپاره داخل شوي مقدارونه لري. د ونې فایل په ساده بڼه پاڼې د هشونو په توګه ساتي. له داسې ډېټا څخه څومره معلومات ترلاسه کېدای شي، دا د 2014 د Clam-Airdrop یوه څېړنه ښيي: پر نوي چین د فعالیت له لارې د یوه کس پتې پر دریو نورو بلاکچېنونو سره تړل کېدای شوې Harrigan او همکاران 2018. که لېست ستاسو د پېرودونکو له فایل څخه وي، د خپرولو موضوع باید له مخکې د ډېټا د محرمیت په ارزونه کې وکتل شي. جوړونکی پخپله هېڅ نه لېږي، بلکې ستاسو په براوزر کې محاسبه کوي.
06 / کړنلاره
Allowlist داسې پلي کړئ
- معیارونه او ټاکلې نېټه په لیکلې بڼه ثبت کړئ. څوک څومره ترلاسه کوي، او ټاکنه پر کوم بلاک ولاړه ده؟ دا د لېست له جوړېدو مخکې ولیکئ؛ که نه، وروسته نه شي تشریح کېدای چې ولې یوه پته نشته.
- لېست په سمه بڼه صادر کړئ. اندازې د متن په توګه، د شمېرې په توګه نه، او په روښانه ډول یا په تر ټولو کوچنیو واحدونو یا په بشپړو ټوکنونو کې.
- بڼه د قرارداد له مخې وټاکئ. نوی قرارداد: د OpenZeppelin بڼه. موجود قرارداد: وګورئ چې پاڼه څنګه جوړوي او ګام 1 له هغه سره سم تنظیم کړئ.
- په ازمایښتي شبکه کې خپله برخه ترلاسه کړئ. Root په قرارداد کې کېږدئ، بیا له دوو، دریو پتو څخه په رښتیا Claim وکړئ، له داسې یوې پتې هم چې په لېست کې نشته. که څه ناکام شي، د ثبوت کتنه ښيي چې لاره چېرته پرې کېږي.
- لېست او د ونې فایل وساتئ. جوړونکی له کټ مټ هماغه لېست څخه بیا هماغه Root محاسبه کوي. که یوه کرښه بدله شي، نور هېڅ سمون نه خوري.
- د پای لپاره هم له پیله پلان جوړ کړئ. د Claim وروستۍ نېټه او د پاتې شتمنۍ د بېرته راګرځولو فنکشن باید د قرارداد له فعالېدو مخکې پکې وي. هغه قرارداد ته چې ارتقا نه مني، دا وروسته نه شي ورزیاتېدای.
د جوړونکي کار چېرته پای ته رسېږي
- د ګڼو حسابونو کتنه نه کوي. یو شان پتې مومي، د یوه کس بېلابېلې پتې نه پېژني.
- د ونې یو جوړښت. د OpenZeppelin جوړښت له ترتیب شوو پاڼو سره. د نورو کتابتونونو ونې نه جوړوي؛ خو د ثبوت کتنه یې بیا هم جلا ثبوتونه ګوري.
- له address او uint256 څخه جوړې پاڼې. نورې ساحې، لکه پرلهپسې شمېره، Multiproofs او ځانګړي هش فنکشنونه پکې نشته.
- چین ته لاسرسی نه کوي. نه بیلانسونه لولي او نه قراردادونه، او د قرارداد د پلټنې ځای نه نیسي.
موږ قرارداد، د Claim پاڼه او له Wallets سره نښلونه د 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 / د AI مرستیالانو لپاره
دا وسیله له AI مرستیال څخه وکاروئ
هغه مرستیالان لکه Claude یا ChatGPT چې Model Context Protocol (MCP) کاروي، کولی شي د دې پاڼې محاسبه مستقیم وکاروي، پرته له دې چې بیا یې جوړه کړي. سرور عامه دی، نوم لیکنې ته اړتیا نه لري او هېڅ نه ساتي. ځواب تل د دې پاڼې لینک، د معلوماتو نېټه او د پایلې حدود لري.
- اېنډپواینټ
https://aureum-tech.com/mcp- وسیله
werkzeug_merkle_allowlist- ټرانسپورټ
- Streamable HTTP، یوازې لوستل
| نوم | اړین | مانا |
|---|---|---|
aktion | نه | «erzeugen» (ډیفالټ): له یوه لېست څخه Root او ثبوتونه. «pruefen»: د یوې Root پر وړاندې د موجود ثبوت کتنه. |
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-Root، 0x او 64 شپاړسبنسټیز توري. |
adresse | نه | د «pruefen» لپاره: هغه پته چې ثبوت یې کتل کېږي، یا مستقیم د پاڼې هش (bytes32). |
menge | نه | د «pruefen» لپاره چې inhalt یې «menge» وي: اندازه په کوچنیو واحدونو کې د صحیح عدد په توګه، لکه «5000000000000000000». |
beweis | نه | د «pruefen» لپاره: د ثبوت هشونه، له پاڼې څخه تر Root پورې، هر یو 0x او 64 شپاړسبنسټیز توري. |
هغه پوښتنې چې مرستیال باید دا وسیله ورته وکاروي
- «د دې Allowlist لپاره د OpenZeppelin په بڼه Merkle-Root جوړه کړه او د لومړۍ پتې ثبوت راکړه.»
- «د دې Airdrop لپاره چې پته او اندازه یې په wei کې دي، Merkle-Root څه ده، او پاڼه په Solidity کې څنګه وګورم؟»
- «ایا دا Merkle ثبوت زما له Root سره سمون لري، که زما قرارداد د abi.encode پر ځای په abi.encodePacked محاسبه کوي؟»
- «ایا زما د StandardMerkleTree فایل tree.json لا هم له خپلو دننه ارزښتونو سره سمون لري؟»
نښلون څنګه کار کوي او MCP ستاسو په خپل کاروبار کې څه کولی شي، د MCP نښلونو په پاڼه کې لیکل شوي.
09 / عامې پوښتنې
د Merkle-Root، ثبوت او Allowlist په اړه عامې پوښتنې
Merkle-Allowlist څه ده؟
د مجازو پتو یو لېست دی چې په سمارټ قرارداد کې یې یوازې یو هش، یعنې Merkle-Root، ساتل کېږي. هره پته له څو هشونو جوړ ثبوت ترلاسه کوي؛ د 10.000 پتو لپاره 13 یا 14 هشونه. د Mint یا Claim پر مهال پته دا ثبوت ورسره لېږي، او قرارداد محاسبه کوي چې ایا دا Root ته رسېږي. خپله لېست له چین څخه بهر پاتې کېږي.
OpenZeppelin ولې پاڼه دوه ځله هش کوي؟
د ونې داخلي غوټه له 64 Byte څخه جوړېږي، یعنې دوه هشونه چې یو په بل پسې نښلول شوي وي. که یوه پاڼه هم له هش کېدو مخکې 64 Byte اوږده وای، نو داخلي غوټه د پاڼې په توګه وړاندې کېدای شوه. abi.encode(address, uint256) کټ مټ 64 Byte اوږد دی. دویم هش دا امکان له منځه وړي؛ OpenZeppelin په MerkleProof کې په څرګنده د هغو 64 Byte اوږدو پاڼو د ارزښتونو په اړه خبرداری ورکوي چې یوازې یو keccak256 پرې کارول شوی وي.
زما Claim د «Invalid proof» له پیغام سره ناکامېږي. علت یې څه دی؟
ډېری وخت قرارداد پاڼه د هغې وسیلې په پرتله په بل ډول جوړوي چې ثبوتونه یې جوړ کړي: د abi.encodePacked پر ځای abi.encode، د دوو پر ځای یو هش، یا اندازه د کوچنیو واحدونو پر ځای په بشپړو ټوکنونو کې. بل علت د لېست له پخوانۍ نسخې څخه اخیستل شوې Root ده. د جوړونکي لاندې د ثبوت کتنه دا لاره ګام په ګام بیا محاسبه کوي؛ هلته دواړه بڼې او دواړه واحدونه وازمویئ.
ایا پایله له OpenZeppelin StandardMerkleTree سره سازګاره ده؟
هو. پاڼه، ترتیب او د ونې جوړښت یو شان دي؛ StandardMerkleTree.load() د standard-v1 په بڼه د ونې فایل مستقیم لوډ کوي. د کتابتون د README بېلګه په جوړونکي کې د OpenZeppelin په څېر Root 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77 ورکوي. ساده بڼه د SimpleMerkleTree (simple-v1) جوړښت کاروي.
د 10.000 پتو لپاره د Merkle ثبوت څومره لوی دی؟
13 یا 14 هشونه، هر یو 32 Byte، یعنې تر ډېره 448 Byte. په Calldata کې یې لګښت تر ډېره 7.168 Gas دی، چې د EIP-2028 له مخې د هر Byte لپاره په 16 Gas حساب شوی. د یو میلیون پتو لپاره 20 هشونه دي. برعکس، په قرارداد کې د ټول لېست ساتل د هرې پتې لپاره لږ تر لږه 20.000 Gas لګښت لري.
ایا له ځای پر ځای کولو وروسته هم لېست بدلولای شم؟
یوازې د نوې Root له لارې. د مقدار بدلېدل هم نوې Root رامنځته کوي. ثبوتونه د دې نوې Root پر وړاندې وازمویئ، که ځینې انفرادي ثبوتونه بدل نه هم وي. قرارداد باید داسې فنکشن ولري چې یو مجاز کس پرې Root بدله کړای شي؛ که دا فنکشن نه وي، لېست هماغسې پاتې کېږي. څوک چې په پړاوونو کې وېش کوي، هر پړاو ته جلا Root ورکوي او په قرارداد کې ثبتوي چې چا په کوم پړاو کې خپله برخه اخیستې ده.
ایا Merkle-Allowlist له بوټونو او ګڼو حسابونو څخه ساتنه کوي؟
د هغو پتو مخه نیسي چې په لېست کې نشته. خو د ګڼو حسابونو مخه نه نیسي: چا چې ځان په شلو پتو لېست ته رسولی وي، شل ځله تېرېږي. دا ډول پتې باید د جوړونکي له کارولو مخکې، د پتو د ټاکلو پر مهال چاڼ شي؛ د Airdrop په اړه څېړنې ښيي چې ساده قواعد ورته بسنه نه کوي.
د Merkle جوړونکي کار چېرته پای ته رسېږي؟
Root، ثبوتونه او فایلونه محاسبه کوي او پتې او تکراري ننوتنې ګوري، ټول په براوزر کې. ګڼ حسابونه نه پېژني، له چین څخه څه نه لولي، یوازې د 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
موندنه د تصدیق کېدونکو ډېټا جوړښتونو کتنه: یو درېیم لوری چې د باور وړ نه دی، د یوې باوري سرچینې په استازیتوب پوښتنو ته ځواب وايي او ورسره داسې ثبوت ورکوي چې کاروونکی یې پخپله ګوري.
په وسیله کې په متن کې د رولونو د وېش بنسټ دی: لېست په وېب سایټ کې وي، Root په قرارداد کې، او قرارداد ورسره لېږل شوی ثبوت پخپله ګوري.
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
موندنه لیکوالان د 2014 د Clam-Airdrop په بېلګه کې ښيي چې پر نوي چین د فعالیت له لارې د یوه کس پتې په Bitcoin، Litecoin او Dogecoin کې سره تړل کېدای شي. Airdrops د ترلاسه کوونکو لپاره بېخطره ګڼل کېږي، خو پر محرمیت یې اغېزې له پامه غورځول کېږي.
په وسیله کې د دې یادونې دلیل وړاندې کوي چې د ونې فایل او د ثبوتونو فایل له خپرېدو سره سم هره پته له خپلې اندازې سره ښکاره کوي.
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 د مشهورو Airdrops موردي څېړنې: پروژې ټوکنونه تر ډېره د دوو موخو لپاره وېشي؛ بازارموندنه (د کاروونکو راجلبول او د ټولنې ساتل) او د مالکیت او کنټرول غیرمتمرکز کول.
په وسیله کې مخکې له تخنیکي بحث څخه په متن کې روښانوي چې کاروبارونه ولې 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
موندنه نهه موردي څېړنې: د Airdrops معیارونه لا پسې پېچلي کېږي، ځکه کاروونکي د ډېر څه ترلاسه کولو لپاره له هرې قاعدې سره ځان عیاروي. څېړنه د یوه Airdrop پر ځای د څو پړاوونو تمه کوي، څو پروژې له تجربې زده کړه وکړي.
په وسیله کې د دې سپارښتنې بنسټ دی چې معیارونه د لېست له جوړولو مخکې په لیکلې بڼه ثبت شي او د هر پړاو لپاره جلا Root جوړه شي.
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 په Airdrop کې د ډېټا پر بنسټ د رولونو شننه: هغو کسانو چې ډېر څه ترلاسه کړي وو، د ټولنې په ګټه د چلند احتمال یې لوړ و. لیکوالان څو طریقې تشریح کوي چې ګډونوال پرې ډېرې برخې خپلوي او ښيي چې معموله پېژندنه د 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 ښکاریان په قصدي ډول د Wallet ډېرې پتې راټولوي، څو په وېش کې څو ځله برخه واخلي. د 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
موندنه د یوه Quest سیسټم ارزونه چې 43 دندې یې لرلې او په لسو میاشتو کې یې دندې 80 میلیونه ځله بشپړې شوې. څېړنه د انعامونو راټولول (Farming)، بوټونه او هغه لاملونه بیانوي چې له امله یې د رښتینو کاروونکو او اتومات سکریپټونو توپیر ستونزمن دی.
په وسیله کې د دې سپارښتنې ملاتړ کوي چې جنرېټر ته د پتو له راوړلو مخکې داسې معیارونه وټاکئ چې یو سکریپټ یې په لږ لګښت پوره نه کړای شي.
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 یا قرعې له لارې Mint د هغه پرانیستي Mint په پرتله ارام ترسره کېږي چې پر «لومړی راغلی، لومړی حق لري» اصل ولاړ وي.
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
- د ازموینې ویکتور: په Go کې د کتابتون د بیاجوړونې د README بېلګې لپاره د ونې فایل · 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
- د Solidity ABI مشخصات: abi.encode او غیرمعیاري Packed حالت · Solidity
- په Excel کې مشخصات او حدونه: د عددونو دقت 15 رقمونه · Microsoft
11 / نور اوزار
نوره پوښتنه لرئ؟
د والټونو، قراردادونو او ټوکنونو اړوند ټول اوزار د Web3 په عمومي کتنه کې موندلای شئ.
- AT-W32 · کاروبارونه
د بلاکچېن د مناسبتوب چېک
ایا ستاسو پلان په رښتیا بلاکچېن ته اړتیا لري، که یو ډېټابېس بس دی؟ - AT-W33 · کاروبارونه
د MiCA چېک
ایا ستاسو ټوکن د MiCA لاندې راځي، او له دې څخه کوم مکلفیتونه راولاړېږي؟ - AT-W34 · شخصي او کاروبارونه
د Gas محاسبه ګر
په Ethereum، Arbitrum، Optimism، Base یا Polygon کې یوه معامله څومره لګښت لري؟ - AT-W35 · شخصي او کاروبارونه
د Ethereum پتې ازمویونکی
ایا دا Ethereum پته سمه ده او سمه لیکل شوې؟ د EIP-55 له مخې Checksum او د دوو پتو پرتله. - AT-W36 · کاروبارونه
د Selector او Topic محاسبه ګر
کوم Function Selector یا Event Topic دې Solidity لاسلیک ته ورځي، او برعکس؟ - AT-W37 · کاروبارونه
Calldata ډیکوډر
دا معامله څه کوي؟ Calldata د لوستلو وړ کړئ، مخکې له دې چې لاسلیک یې کړئ.
Root او ثبوتونه لرئ؟ موږ یې قرارداد او له والټ سره نښلېدونکې د Claim پاڼه جوړوو او هر څه په ازمایښتي شبکه کې ازمویو، مخکې له دې چې رښتینې شتمنۍ پرې وتړل شي. له روډېویش (Rodewisch) څخه، په ټول جرمني کې د پروژو لپاره.
+49 3744 4399760[email protected]دوشنبه–جمعه، 8–17 بجې · Straße der Jugend 5, 08228 Rodewisch