Công cụ AT-W38REV. 2026-A
Trình tạo Merkle allowlist: root và proof cho mint và airdrop
Merkle allowlist chỉ đặt một hash duy nhất vào smart contract, tức root. Mỗi địa chỉ trong danh sách nhận một proof ngắn, với 10.000 địa chỉ là 13 hoặc 14 hash, và khi mint hoặc claim, contract tự tính lại xem địa chỉ đó có thuộc danh sách không. Trình tạo dựng root và proof giống OpenZeppelin, và trước đó kiểm tra từng địa chỉ theo EIP-55 cũng như địa chỉ trùng.
- miễn phí
- không cần đăng ký
- tính ngay trong trình duyệt
01 / TRÌNH TẠO
Dán danh sách, đọc root và proof
Trình tạo · Merkle root và proof
Công cụ tính root và proof theo cách của OpenZeppelin. Dù vậy, anh chị vẫn nên thử contract và claim trên testnet trước khi có giá trị thật gắn vào. Chỉ nhập địa chỉ công khai, không bao giờ nhập khóa riêng tư.
Xóa các dòng không hợp lệ và mục trùng; các địa chỉ trùng nhưng khác số lượng sẽ được cộng lại. Sau đó tính lại.
Proof cho một địa chỉ
Xuất file
File cây được StandardMerkleTree.load() hoặc SimpleMerkleTree.load() đọc. File proof chứa số lượng, leaf và proof của từng địa chỉ, đúng như một trang claim cần.
Kiểm tra trong contract (Solidity)
Chạy trong trình duyệt của anh chị. Danh sách không bị gửi đi hay lưu lại.
02 / NỀN TẢNG
Một root trong contract, một proof cho mỗi địa chỉ
Cách dễ nghĩ ra là lưu mọi địa chỉ được phép trong contract. Cách đó rất tốn kém. Mỗi ô lưu trữ mới tốn ít nhất 20.000 gas, với 10.000 địa chỉ là 200.000.000 gas, chỉ để ghi vào. Merkle tree đảo ngược điều đó: danh sách nằm ngoài chain, trong contract chỉ có một giá trị 32 byte.
Cây được tạo như sau. Từ mỗi dòng của danh sách tạo ra một hash, gọi là leaf. Cứ hai leaf được hash cùng nhau, rồi cứ hai kết quả đó lại hash cùng nhau, cho đến khi còn một giá trị, tức root. Chỉ cần đổi một chữ số trong một số lượng là root đổi. Ý tưởng bắt nguồn từ một phương pháp chữ ký năm 1987, trong đó chữ ký chỉ tăng theo logarit so với số lượng thông điệp Merkle 1988.
Khi claim, người nhận gửi kèm proof của mình: các hash anh em nằm trên đường từ leaf của họ đến root. Contract tính lại đường đi và so kết quả với root đã lưu. Đây là mẫu của các cấu trúc dữ liệu có xác thực, trong đó bên cung cấp dữ liệu không cần đáng tin vì người nhận tự kiểm tra proof Tamassia 2003. Vì vậy trang claim của anh chị không thể bịa ra một mục nào; proof sai sẽ bị contract từ chối.
Hình 1 · Giá trị thật từ bốn địa chỉ của ví dụ (định dạng standard, chỉ địa chỉ), đã rút gọn. Proof cho 0x2222…2222: hai hash.
| Địa chỉ | Số hash mỗi proof | Proof tối đa | Calldata tối đa | Danh sách trong contract, tối thiểu |
|---|---|---|---|---|
| 100 | 6 hoặc 7 | 224 Byte | 3.584 Gas | 2.000.000 Gas |
| 1.000 | 9 hoặc 10 | 320 Byte | 5.120 Gas | 20.000.000 Gas |
| 10.000 | 13 hoặc 14 | 448 Byte | 7.168 Gas | 200.000.000 Gas |
| 100.000 | 16 hoặc 17 | 544 Byte | 8.704 Gas | 2.000.000.000 Gas |
| 1.000.000 | 19 hoặc 20 | 640 Byte | 10.240 Gas | 20.000.000.000 Gas |
Calldata tính 16 gas mỗi byte (EIP-2028), lưu trữ tính 20.000 gas cho mỗi ô mới (Yellow Paper, G_sset; theo EIP-2929, một ô “lạnh” cộng thêm 2.100 gas). Cập nhật ngày 14 tháng 11 năm 2026.
Như vậy proof gần như không tăng theo danh sách. Từ 10.000 lên một triệu địa chỉ chỉ thêm 6 hash. Người nhận trả phí proof trong giao dịch của họ; trong contract chỉ có root, dù danh sách dài bao nhiêu.
03 / ĐỊNH DẠNG
Chọn định dạng nào? Contract quyết định
Quy tắc quan trọng nhất trước: trình tạo và contract phải tạo leaf giống hệt nhau. Lệch một byte là mọi claim đều báo lỗi “Invalid proof”. Vì thế Bước 1 không hỏi sở thích, mà hỏi trong contract đang ghi gì.
| Định dạng | Leaf trong Solidity | Số byte trước khi hash | File cây | Dùng khi |
|---|---|---|---|---|
| OpenZeppelin StandardMerkleTree | keccak256(bytes.concat(keccak256(abi.encode(account, amount)))) | 64 | standard-v1 | Contract mới. File cây nạp thẳng bằng StandardMerkleTree.load(). |
| Đơn giản (abi.encodePacked) | keccak256(abi.encodePacked(account, amount)) | 52 | simple-v1 | Contract hiện có đang kiểm tra theo cách này. Bố cục cây như SimpleMerkleTree. |
Chỉ địa chỉ: keccak256(bytes.concat(keccak256(abi.encode(account)))) hoặc keccak256(abi.encodePacked(account)). Theo OpenZeppelin merkle-tree 1.0.8, Contracts 5.7.0.
Vì sao OpenZeppelin hash hai lần
Một nút bên trong của cây được tạo từ 64 byte, tức hai hash nối liền nhau. Nếu trước khi hash, một leaf cũng dài 64 byte thì có thể giả một nút bên trong thành leaf. abi.encode(address, uint256) dài đúng như vậy. Với lần hash thứ hai, khả năng này bị loại bỏ, và trong tài liệu về MerkleProof, OpenZeppelin cảnh báo rõ về giá trị leaf dài 64 byte khi chỉ dùng keccak256 một lần. Định dạng đơn giản không có vấn đề này vì abi.encodePacked(address, uint256) chỉ cho ra 52 byte. Ai đưa thêm trường vào leaf thì nên tính lại độ dài.
Cặp đã sắp xếp, leaf đã sắp xếp
Cả hai định dạng đều nối hai hash của một cặp theo thứ tự, hash nhỏ hơn đứng trước. Nhờ vậy proof không cần cho biết nút anh em nằm bên trái hay bên phải, và MerkleProof.verify của OpenZeppelin kiểm tra được cả hai định dạng. Trình tạo cũng sắp xếp các leaf giống OpenZeppelin. Các thư viện khác sắp xếp khác, ví dụ merkletreejs khi không có sortLeaves; cùng một danh sách sẽ cho root khác ở đó. Điều đó không sai. Chỉ là root và proof không được lấy từ hai công cụ khác nhau.
Việc trình tạo có thật sự tính như OpenZeppelin hay không, bài kiểm thử của chúng tôi kiểm tra sau mỗi lần thay đổi. Ví dụ trong README của thư viện, hai địa chỉ kèm số lượng, cho ra root 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77, giống từng ký tự với bên đó. Các file kiểm thử trong repository của OpenZeppelin, trình tạo tính lại từng nút một. File cây từ dự án của anh chị (tree.json) có thể dán vào ở Bước 3; trình tạo sẽ cho biết file còn khớp với các giá trị của nó hay không.
Những lỗi thường gặp nhất trong danh sách
- Lỗi gõ trong địa chỉ. Theo EIP-55, cách viết hoa viết thường chứa một checksum. Nếu không khớp, trình tạo báo dòng đó. Địa chỉ viết toàn chữ thường không mang checksum, lỗi gõ ở đó không bị phát hiện; từng địa chỉ riêng lẻ thì công cụ kiểm tra địa chỉ Ethereum so sánh từng ký tự.
- Số lượng từ Excel. Excel tính với độ chính xác 15 chữ số. Từ 5000000000000000001, khi xuất file rất dễ thành 5E+18 và các chữ số cuối mất hết. Trình tạo từ chối cách viết này; trong bảng tính, hãy định dạng cột là văn bản.
- Token hay đơn vị nhỏ nhất. Một token có 18 chữ số thập phân là 10¹⁸ đơn vị nhỏ nhất (wei), với USDC là 6 chữ số. Nếu anh chị ghi số lượng theo đơn vị token, hãy nhập số chữ số thập phân ở Bước 2; kết quả hiện tổng theo cả hai đơn vị để đối chiếu.
- Địa chỉ trùng. Cùng một địa chỉ, một lần viết chữ thường, một lần viết có checksum, với contract là một địa chỉ. Trình tạo tìm ra chúng và nếu anh chị muốn thì gộp lại; dòng giống hệt thì xóa, số lượng khác nhau thì cộng lại.
04 / PHÂN PHÁT
Phát đi hay để người nhận tự lấy?
Vì sao các dự án lại tặng token, Allen, Berg và Lane đã nghiên cứu trên các airdrop từ 2014 đến 2022: chủ yếu để làm marketing và để phân tán rộng hơn quyền sở hữu và quyền kiểm soát Allen và cs. 2023. Như vậy việc phân phối cần tiếp cận được nhiều người mà không tốn hơn lợi ích mang lại.
Về cơ bản có hai cách. Với push, bên phát tự chuyển cho từng người nhận. Với pull, người nhận tự đến lấy, và đó chính là một Merkle claim. Fröwis và Böhme đã tính 35 kịch bản: pull chỉ giúp bên phát tiết kiệm vừa phải và đặt lên mỗi người nhận một chi phí cao không cân xứng, còn tổng chi phí của mọi phương pháp tăng gần như tuyến tính theo số người nhận Fröwis và Böhme 2019. Vì vậy Merkle claim đáng làm không nhiều vì phí mà vì sự gọn gàng: danh sách không nằm trong contract, và chỉ ai thật sự muốn thì mới đến lấy.
| Cách làm | Ai trả phí | Công sức lúc bắt đầu | Sửa về sau |
|---|---|---|---|
| Chuyển trực tiếp (push) | Bên phát, một giao dịch chuyển cho mỗi người nhận | tăng theo từng địa chỉ | không được, đã gửi là đã gửi |
| Lưu danh sách trong contract | Bên phát khi ghi vào (từ 20.000 gas mỗi địa chỉ), người nhận khi claim | tăng theo từng địa chỉ | từng mục, qua một hàm quản trị |
| Merkle root (pull) | Người nhận, cho claim và proof | một ô lưu trữ cho root | chỉ bằng root mới. Kiểm tra proof đối chiếu với root mới |
Với số tiền nhỏ, có thể xảy ra chuyện phí claim cao hơn số nhận được. Khi đó nên phát trên một chain layer 2 rẻ hoặc đặt một mức tối thiểu. Một claim tốn bao nhiêu ở giá gas hiện tại thì công cụ tính phí gas sẽ tính.
NFT mint: allowlist thay vì đấu giá phí
Ở một đợt mint mở với số lượng ít, người mua đua nhau trả phí gas cao hơn. Điều đó đẩy phí lên cho mọi người và lãng phí gas, như một nghiên cứu về các đợt ra mắt NFT cho thấy; nghiên cứu này đề xuất bốc thăm làm lối thoát Ko và cs. 2023. Một allowlist có khung giờ cố định cũng loại bỏ cuộc đua đó. Việc chen ngang là sở trường của các bot đọc trộm giao dịch đang chờ và vượt lên bằng phí cao hơn Daian và cs. 2020.
Từ đó suy ra một quy tắc cho contract: địa chỉ trong leaf và người nhận phải là cùng một địa chỉ. Đơn giản nhất là contract tạo leaf từ msg.sender, như trong đoạn Solidity của trình tạo. Khi đó một proof mà ai đó đọc được trong mempool không giúp họ dùng cho chính mình.
05 / NHIỀU TÀI KHOẢN
Danh sách không làm được gì: nhiều tài khoản và quyền riêng tư
Merkle tree kiểm tra một địa chỉ có trong danh sách hay không. Còn mười địa chỉ là mười người hay một người thì nó không biết. Đó là một kết quả cũ của tin học: nếu không có một nơi xác nhận danh tính, không thể ngăn nhiều danh tính giả (tấn công Sybil), trừ khi dựa trên những giả định không thực tế Douceur 2002. Vì vậy phần kiểm tra trùng chỉ tìm ra cùng một địa chỉ, kể cả khi viết khác đi.
- Săn airdrop là chuyện thường. Ở airdrop của ParaSwap, Fan và cộng sự mô tả nhiều kiểu mà người tham gia dùng để vét, và cách nhận diện thông thường không lọc được đủ Fan và cs. 2023. Các phương pháp tốt hơn phân tích đồ thị giao dịch và metadata Zhou và cs. 2024; muốn vậy cần dữ liệu của chain, chỉ danh sách thì không đủ.
- Quy tắc bị khai thác tối đa. Hễ tiêu chí được biết, người dùng sẽ thích nghi. Vì vậy Allen quan sát thấy các tiêu chí ngày càng rắc rối và dự đoán airdrop sẽ chia thành nhiều đợt Allen 2024. Mỗi đợt có root riêng; proof của đợt cũ khi đó không còn giá trị.
- Khối lượng giao dịch không phải tiêu chí sạch. Trong 52 bộ sưu tập NFT lớn nhất, 3,93 phần trăm địa chỉ nổi lên với các mẫu giống giao dịch giả, thường chỉ qua lại giữa vài địa chỉ von Wachter và cs. 2023.
- Nhiệm vụ thu hút script. Một hệ thống quest với 80 triệu nhiệm vụ hoàn thành đã thu hút farming và bot, và người dùng thật khó tách khỏi script Al-Chami và Clark 2025. Tiêu chí mà script không đáp ứng được với giá rẻ thì bền hơn.
- Biện pháp nằm ngoài danh sách. Các cách chứng minh đằng sau một địa chỉ có một con người, ví dụ qua người bảo lãnh và bỏ phiếu trong cộng đồng, là một lĩnh vực riêng với những điểm yếu riêng Siddarth và cs. 2020.
Khi nào địa chỉ và proof trở nên hiển thị
Ngay khi root được đưa vào contract, nó sẽ công khai. Một claim làm lộ địa chỉ, proof và tùy trường hợp là số lượng trên chain. File cây ở định dạng chuẩn và file proof chứa tất cả địa chỉ cùng các số lượng đã nhập tương ứng. File cây ở định dạng đơn giản lưu các lá dưới dạng hash. Lượng thông tin có thể đọc ra từ những dữ liệu này được thể hiện qua một nghiên cứu về airdrop Clam năm 2014: qua hoạt động trên chain mới, có thể liên kết các địa chỉ của cùng một người trên ba blockchain khác Harrigan và cs. 2018. Nếu danh sách lấy từ hồ sơ khách hàng của anh chị, việc công bố cần được đưa qua khâu kiểm tra bảo vệ dữ liệu trước. Bản thân trình tạo không gửi gì đi, nó tính trong trình duyệt của anh chị.
06 / CÁCH LÀM
Cách triển khai một allowlist
- Chốt tiêu chí và ngày chốt. Ai nhận bao nhiêu, và việc chọn dựa trên block nào? Ghi ra giấy trước khi lập danh sách; nếu không, sau này không giải thích được vì sao một địa chỉ bị thiếu.
- Xuất danh sách cho sạch. Số lượng ghi dạng văn bản, không phải số, và nói rõ là theo đơn vị nhỏ nhất hay token nguyên.
- Chọn định dạng theo contract. Contract mới: định dạng của OpenZeppelin. Contract hiện có: xem nó tạo leaf thế nào rồi chỉnh Bước 1 theo đó.
- Thử claim trên testnet. Đưa root vào contract, rồi cho hai, ba địa chỉ claim thật, kể cả một địa chỉ không có trong danh sách. Nếu có gì hỏng, phần kiểm tra proof cho thấy đường đi đứt ở đâu.
- Giữ lại danh sách và file cây. Từ đúng danh sách đó, trình tạo sẽ tính lại cùng một root. Đổi một dòng là không còn gì khớp.
- Tính luôn cả phần kết thúc. Thời hạn claim và một hàm thu hồi phần còn lại cần có trong contract trước khi nó chạy. Với contract không nâng cấp được, sau này không thêm vào được.
Trình tạo dừng lại ở đâu
- Không kiểm tra nhiều tài khoản. Nó tìm ra các địa chỉ giống nhau, không tìm ra nhiều địa chỉ của một người.
- Một bố cục cây. Bố cục của OpenZeppelin với leaf đã sắp xếp. Cây từ các thư viện khác thì nó không dựng lại; nhưng từng proof của chúng thì phần kiểm tra proof vẫn kiểm được.
- Leaf từ address và uint256. Các trường khác như số thứ tự, multiproof và hàm hash riêng không có.
- Không nhìn vào chain. Nó không đọc số dư hay contract và không thay thế việc kiểm tra contract.
Contract, trang claim và kết nối với ví, chúng tôi xây dựng trong mục Phát triển Web3. Một giao dịch thực sự gọi gì trước khi ai đó ký, công cụ giải mã calldata sẽ cho thấy. Mọi công cụ Web3 có trong trang tổng quan Web3.
07 / NGHIÊN CỨU
Các nghiên cứu nói gì về việc này
Năm kết quả nghiên cứu làm nền cho các lưu ý trong trình tạo. Danh sách đầy đủ kèm ghi chú kiểm tra nằm ở phía dưới.
- Proof tăng theo logarit. Vì thế với 10.000 địa chỉ, 13 hoặc 14 hash là đủ Merkle 1988, và chính contract tự kiểm tra chúng Tamassia 2003.
- Để người nhận tự lấy là chuyển chi phí. Pull tiết kiệm vừa phải cho bên phát và đè lên mỗi người nhận Fröwis và Böhme 2019; vì thế có lưu ý về số tiền nhỏ.
- Một địa chỉ không phải một người. Không có nơi xác nhận danh tính thì nhiều tài khoản vẫn có thể xảy ra Douceur 2002, và việc săn airdrop đã được ghi nhận rõ Fan và cs. 2023.
- Giao dịch đang chờ bị đọc trộm. Bot đấu giá nhau để giành thứ tự Daian và cs. 2020; vì thế leaf trong đoạn Solidity gắn với msg.sender.
- Dữ liệu airdrop để lộ mối liên hệ. Địa chỉ của cùng một người có thể được liên kết giữa các chain Harrigan và cs. 2018; vì thế có lưu ý khi công bố danh sách.
08 / DÀNH CHO TRỢ LÝ AI
Dùng công cụ này từ một trợ lý AI
Các trợ lý như Claude hoặc ChatGPT có hỗ trợ Model Context Protocol (MCP) có thể gọi thẳng phép tính của trang này thay vì tự dựng lại. Máy chủ này công khai, không cần đăng nhập và không lưu lại gì. Câu trả lời luôn kèm đường link đến trang này, ngày cập nhật dữ liệu và giới hạn của kết quả.
- Endpoint
https://aureum-tech.com/mcp- Công cụ
werkzeug_merkle_allowlist- Phương thức truyền
- Streamable HTTP, chỉ đọc
| Tên | Bắt buộc | Ý nghĩa |
|---|---|---|
aktion | không | “erzeugen” (mặc định): root và proof từ một danh sách. “pruefen”: kiểm tra một proof có sẵn so với một root. |
liste | không | Cho “erzeugen”: mỗi mục một dòng, “0x…” hoặc “0x…,số lượng”. Được phép có dòng tiêu đề, dòng trống và chú thích #, tối đa 10000 mục. Thay cho danh sách, ở đây cũng có thể là file cây của OpenZeppelin (standard-v1 hoặc simple-v1) dưới dạng văn bản JSON; khi đó nó được tính lại để đối chiếu. |
format | không | “standard” (mặc định) = OpenZeppelin StandardMerkleTree, leaf keccak256(bytes.concat(keccak256(abi.encode(…)))). “einfach” = keccak256(abi.encodePacked(…)), các cặp đã sắp xếp. |
inhalt | không | “adresse” (mặc định): leaf chỉ từ địa chỉ, ví dụ cho allowlist mint. “menge”: địa chỉ và số lượng (uint256), ví dụ cho airdrop. |
dezimalstellen | không | Chỉ với “menge”: số chữ số thập phân của token. 0 (mặc định) = số lượng đã ghi bằng đơn vị nhỏ nhất; 18 = số lượng tính theo đơn vị token, quy đổi sang wei. |
beweise_fuer | không | Các địa chỉ cần trả về proof. Nếu bỏ trống thì trả về tất cả, khi danh sách có tối đa 20 mục. |
mit_baumdatei | không | Gửi kèm file cây theo định dạng của OpenZeppelin (StandardMerkleTree.load / SimpleMerkleTree.load), tối đa 1000 mục. |
root | không | Cho “pruefen”: Merkle root, 0x và 64 ký tự hex. |
adresse | không | Cho “pruefen”: địa chỉ có proof cần kiểm tra, hoặc trực tiếp hash của một leaf (bytes32). |
menge | không | Cho “pruefen” với inhalt “menge”: số lượng theo đơn vị nhỏ nhất, là số nguyên, ví dụ “5000000000000000000”. |
beweis | không | Cho “pruefen”: các hash của proof, từ leaf đến root, mỗi hash gồm 0x và 64 ký tự hex. |
Những câu hỏi mà trợ lý nên gọi công cụ này
- “Hãy tạo một Merkle root cho allowlist này theo định dạng của OpenZeppelin và cho tôi proof của địa chỉ đầu tiên.”
- “Merkle root của airdrop này với địa chỉ và số lượng tính bằng wei là gì, và tôi kiểm tra leaf trong Solidity như thế nào?”
- “Merkle proof này có khớp với root của tôi không, hay contract của tôi tính bằng abi.encodePacked thay vì abi.encode?”
- “File tree.json của tôi từ StandardMerkleTree có còn khớp với các giá trị bên trong không?”
Cách kết nối hoạt động ra sao và MCP làm được gì cho cơ sở của anh chị, anh chị xem ở trang Tích hợp MCP.
09 / CÂU HỎI THƯỜNG GẶP
Câu hỏi thường gặp về Merkle root, proof và allowlist
Merkle allowlist là gì?
Đó là danh sách các địa chỉ được phép, trong smart contract chỉ lưu đúng một giá trị hash, tức Merkle root. Mỗi địa chỉ nhận một proof gồm vài hash, với 10.000 địa chỉ là 13 hoặc 14 hash. Khi mint hoặc claim, địa chỉ gửi kèm proof, và contract tự tính lại xem proof có dẫn đến root hay không. Bản thân danh sách nằm ngoài chain.
Vì sao OpenZeppelin hash leaf hai lần?
Một nút bên trong của cây được tạo từ 64 byte, tức hai hash nối liền nhau. Nếu trước khi hash, một leaf cũng dài 64 byte thì có thể giả một nút bên trong thành leaf. abi.encode(address, uint256) dài đúng 64 byte. Lần hash thứ hai loại bỏ khả năng này; trong MerkleProof, OpenZeppelin cảnh báo rõ về giá trị leaf dài 64 byte khi chỉ dùng keccak256 một lần.
Claim của tôi báo lỗi "Invalid proof". Nguyên nhân là gì?
Thường là contract tạo leaf khác với công cụ đã tạo proof: abi.encode thay vì abi.encodePacked, một lần hash thay vì hai, hoặc số lượng tính bằng token nguyên thay vì đơn vị nhỏ nhất. Nguyên nhân thứ hai là root lấy từ phiên bản cũ của danh sách. Phần kiểm tra proof bên dưới trình tạo sẽ tính lại từng bước; anh chị hãy thử cả hai định dạng và cả hai đơn vị ở đó.
Kết quả có tương thích với OpenZeppelin StandardMerkleTree không?
Có. Leaf, cách sắp xếp và bố cục cây giống nhau, file cây định dạng standard-v1 có thể nạp thẳng bằng StandardMerkleTree.load(). Ví dụ trong README của thư viện cho ra root 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77 ở trình tạo này, giống như ở OpenZeppelin. Định dạng đơn giản dùng bố cục của SimpleMerkleTree (simple-v1).
Merkle proof dài bao nhiêu với 10.000 địa chỉ?
13 hoặc 14 hash, mỗi hash 32 byte, tức tối đa 448 byte. Phần calldata tốn tối đa 7.168 gas, tính theo 16 gas mỗi byte theo EIP-2028. Với một triệu địa chỉ là 20 hash. Ngược lại, lưu cả danh sách trong contract tốn ít nhất 20.000 gas cho mỗi địa chỉ.
Sau khi deploy, tôi còn sửa được danh sách không?
Chỉ bằng một root mới. Chỉ cần một số lượng thay đổi là sẽ có một root mới. Hãy kiểm tra các proof đối chiếu với root mới này, ngay cả khi từng proof riêng lẻ vẫn không thay đổi. Contract cần có một hàm để người có quyền thay root; nếu không có, danh sách giữ nguyên như cũ. Ai phát theo từng đợt thì cho mỗi đợt một root riêng và ghi lại trong contract ai đã nhận ở đợt nào.
Merkle allowlist có chống được bot và nhiều tài khoản không?
Với các địa chỉ không có trong danh sách thì có. Với nhiều tài khoản thì không: ai đưa hai mươi địa chỉ vào danh sách sẽ qua được hai mươi lần. Việc lọc phải làm trước khi dùng trình tạo, ở khâu chọn địa chỉ, và các nghiên cứu về airdrop cho thấy những quy tắc đơn giản là không đủ.
Trình tạo Merkle làm được đến đâu?
Công cụ tính root, proof và các file, kiểm tra địa chỉ và địa chỉ trùng, tất cả trong trình duyệt. Công cụ không nhận ra nhiều tài khoản của một người, không đọc gì từ chain, chỉ dựng bố cục của OpenZeppelin và không thay thế việc kiểm tra contract. Contract, trang claim và phần thử trên testnet, chúng tôi nhận làm nếu anh chị muốn giao cho chúng tôi.
10 / NGHIÊN CỨU VÀ NGUỒN
Công cụ này dựa trên những gì
Các giá trị tham khảo và lưu ý ở trên dựa vào 14 công trình khoa học sau đây. Mỗi công trình đều đã được kiểm tra qua mã DOI hoặc trang của nhà xuất bản (lần gần nhất: ngày 14 tháng 11 năm 2026): công trình có thật, không bị rút lại, và kết luận của nó đến nay vẫn còn giá trị cho câu hỏi này.
Merkle, R. C. (1988): A Digital Signature Based on a Conventional Encryption Function. Advances in Cryptology – CRYPTO ’87, LNCS 293, tr. 369–378
Kết quả Công trình mà Merkle tree bắt nguồn từ đó: nhiều giá trị được gắn vào một giá trị duy nhất qua một cây hash. Kích thước chữ ký chỉ tăng theo logarit so với số thông điệp được ký.
Trong công cụ Nền tảng của lời giải thích vì sao với 10.000 địa chỉ, proof chỉ dài 13 hoặc 14 hash (bảng về độ dài proof).
doi.org/10.1007/3-540-48184-2_32 · Báo cáo hội nghị
Tamassia, R. (2003): Authenticated Data Structures. Algorithms – ESA 2003, LNCS 2832, tr. 2–5
Kết quả Tổng quan về các cấu trúc dữ liệu có xác thực: một bên thứ ba không đáng tin trả lời truy vấn thay cho một nguồn đáng tin và gửi kèm một proof mà người dùng tự kiểm tra.
Trong công cụ Làm nền cho mô hình vai trò trong bài: danh sách nằm ở website, root nằm trong contract, và contract tự kiểm tra proof được gửi kèm.
doi.org/10.1007/978-3-540-39658-1_2 · Bài tổng quan
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, tr. 255–270
Kết quả Mô phỏng 35 kịch bản airdrop: có thể tiết kiệm gấp hai lần, nhưng cần chuẩn bị sẵn trong contract của token. Các phương pháp để người nhận tự lấy (pull) chỉ giúp bên phát tiết kiệm vừa phải và đặt lên mỗi người nhận chi phí cao không cân xứng.
Trong công cụ Làm nền cho phần “Phát đi hay để người nhận tự lấy?”: Merkle claim là phương pháp pull, và phí gas do người nhận chịu.
doi.org/10.1007/978-3-030-31500-9_17 · Báo cáo hội nghị
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), tr. 63–70
Kết quả Qua airdrop Clam năm 2014, các tác giả cho thấy có thể liên kết địa chỉ của cùng một người trên Bitcoin, Litecoin và Dogecoin qua hoạt động trên chain mới. Airdrop được coi là không rủi ro với người nhận, còn hệ quả với quyền riêng tư thì bị bỏ qua.
Trong công cụ Làm cơ sở cho lưu ý rằng file cây và file proof phơi bày mọi địa chỉ cùng số lượng của nó ngay khi được công bố.
doi.org/10.1109/ICDMW.2018.00017 · Báo cáo hội nghị
Allen, D. W. E.; Berg, C.; Lane, A. M. (2023): Why airdrop cryptocurrency tokens?. Journal of Business Research 163, Art. 113945
Kết quả Nghiên cứu tình huống về các airdrop nổi tiếng từ 2014 đến 2022: các dự án phát token chủ yếu vì hai lý do, làm marketing (thu hút người dùng, giữ cộng đồng) và phân tán quyền sở hữu và quyền kiểm soát.
Trong công cụ Đặt vào bối cảnh trong bài việc doanh nghiệp lập allowlist hay airdrop để làm gì, trước khi nói đến kỹ thuật.
doi.org/10.1016/j.jbusres.2023.113945 · Tạp chí chuyên ngành
Allen, D. W. E. (2024): Crypto airdrops: An evolutionary approach. Journal of Evolutionary Economics 34 (4–5), tr. 849–872
Kết quả Chín nghiên cứu tình huống: tiêu chí cho airdrop ngày càng rắc rối, vì người dùng thích nghi với mọi quy tắc để nhận được nhiều hơn. Công trình dự đoán sẽ có nhiều đợt thay vì một airdrop duy nhất, để các dự án học hỏi thêm.
Trong công cụ Đứng sau lời khuyên chốt tiêu chí trước khi lập danh sách và tạo một root riêng cho mỗi đợt.
doi.org/10.1007/s00191-024-00874-6 · Tạp chí chuyên ngành
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, tr. 1–16
Kết quả Phân tích vai trò dựa trên dữ liệu ở airdrop của ParaSwap: ai nhận nhiều hơn thì thường hành động vì lợi ích cộng đồng hơn. Các tác giả mô tả nhiều kiểu mà người tham gia dùng để vét, và cho thấy cách nhận diện thông thường không lọc được đủ những người săn airdrop.
Trong công cụ Giải thích vì sao công cụ nói rõ là không hứa kiểm tra Sybil: danh sách phải sạch trước khi vào trình tạo.
doi.org/10.1145/3544548.3581173 · Báo cáo hội nghị
Zhou, C.; Chen, H.; Wu, H.; và cs. (2024): ARTEMIS: Detecting Airdrop Hunters in NFT Markets with a Graph Learning System. Proceedings of the ACM Web Conference 2024 (WWW ’24), tr. 1824–1834
Kết quả Người săn airdrop cố tình gom nhiều địa chỉ ví để nhận nhiều lần khi phân phối. Với sàn Blur làm ví dụ, một phương pháp học đồ thị nhận ra họ từ chuỗi giao dịch và metadata NFT tốt hơn hẳn các cách trước.
Trong công cụ Bằng chứng cho phần về các mẫu Sybil: nhận diện cần dữ liệu giao dịch của chain mà một trình tạo danh sách không có.
doi.org/10.1145/3589334.3645597 · Báo cáo hội nghị
Douceur, J. R. (2002): The Sybil Attack. Peer-to-Peer Systems (IPTPS 2002), LNCS 2429, tr. 251–260
Kết quả Ai có thể trưng ra nhiều danh tính thì kiểm soát được một phần lớn của một hệ thống phân tán. Nếu không có một nơi tập trung về mặt logic để xác nhận danh tính, những cuộc tấn công như vậy luôn có thể xảy ra, trừ khi dựa trên những giả định không thực tế.
Trong công cụ Giải thích vì sao “một địa chỉ, một claim” không có nghĩa là “một người, một claim”; phần kiểm tra trùng chỉ tìm ra các địa chỉ giống nhau.
doi.org/10.1007/3-540-45748-8_24 · Báo cáo hội nghị
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, Art. 590171
Kết quả Tổng quan về các giao thức muốn chống tấn công Sybil mà không cần cơ quan cấp giấy tờ, qua bỏ phiếu, bảo lãnh và đánh giá bởi những người tham gia khác, kèm điểm mạnh và điểm yếu của từng cách.
Trong công cụ Nêu trong bài những cách ngoài danh sách (chứng minh là con người, bảo lãnh) để hạn chế nhiều danh tính.
doi.org/10.3389/fbloc.2020.590171 · Bài tổng quan
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, tr. 299–311
Kết quả Trong 52 bộ sưu tập NFT có doanh thu cao nhất (từ 2018 đến tháng 11 năm 2021), 3,93 phần trăm địa chỉ với 2,04 phần trăm lượng bán bị nghi là thao túng thị trường; đa số mẫu chỉ qua lại giữa vài địa chỉ.
Trong công cụ Cho thấy khối lượng giao dịch dùng làm tiêu chí cho allowlist có thể bị làm sai lệch, vì một người dễ dàng điều khiển nhiều địa chỉ.
doi.org/10.1007/978-3-031-32415-4_20 · Báo cáo hội nghị
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, tr. 196–211
Kết quả Phân tích một hệ thống quest với 43 nhiệm vụ và 80 triệu lượt hoàn thành trong mười tháng. Công trình mô tả farming và bot, cùng lý do vì sao người dùng thật khó tách khỏi script tự động.
Trong công cụ Làm cơ sở cho lời khuyên chọn tiêu chí mà script không đáp ứng được với giá rẻ, trước khi đưa địa chỉ vào trình tạo.
doi.org/10.1007/978-3-032-00495-6_10 · Báo cáo hội nghị
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), tr. 1–5
Kết quả Khi các bộ sưu tập NFT được ưa chuộng ra mắt, người mua đua nhau trả phí gas (“Gas War”), đẩy phí lên cho mọi người và lãng phí gas. Ra mắt bằng bốc thăm giải quyết việc này trong công trình và tiết kiệm ít nhất 15,5 phần trăm gas.
Trong công cụ Giải thích trong bài vì sao một đợt mint có allowlist hoặc bốc thăm diễn ra êm hơn một đợt mint mở theo kiểu “ai đến trước được trước”.
doi.org/10.1109/ICBC56567.2023.10174918 · Báo cáo hội nghị
Daian, P.; Goldfeder, S.; Kell, T.; và cs. (2020): Flash Boys 2.0: Frontrunning in Decentralized Exchanges, Miner Extractable Value, and Consensus Instability. 2020 IEEE Symposium on Security and Privacy (SP), tr. 910–927
Kết quả Bot theo dõi các giao dịch đang chờ và đấu giá nhau trong “Priority Gas Auctions” để vào block trước người khác. Công trình đo điều này trên các sàn phi tập trung và cho thấy thứ tự giao dịch bị khai thác.
Trong công cụ Vì thế đoạn Solidity gắn leaf với msg.sender: một proof mà ai đó đọc được trong mempool không giúp họ dùng cho chính mình.
doi.org/10.1109/SP40000.2020.00040 · Báo cáo hội nghị
Tiêu chuẩn, cơ quan nhà nước và thông tin của nhà sản xuất
- merkle-tree 1.0.8: StandardMerkleTree, SimpleMerkleTree, file cây và hash hai lần · OpenZeppelin
- Contracts 5.x: MerkleProof và Hashes.commutativeKeccak256, cảnh báo về leaf 64 byte · OpenZeppelin
- Vector kiểm thử: file cây cho ví dụ README trong bản viết lại bằng Go của thư viện · FantasyJony (GitHub)
- EIP-55: Mixed-case checksum address encoding · Ethereum Improvement Proposals
- EIP-2028: Transaction data gas cost reduction (16 gas mỗi byte) · Ethereum Improvement Proposals
- EIP-2929: Gas cost increases for state access opcodes · Ethereum Improvement Proposals
- Ethereum Yellow Paper, Phụ lục G: G_sset = 20.000 · Ethereum
- Solidity ABI Specification: abi.encode và Non-standard Packed Mode · Solidity
- Thông số kỹ thuật và giới hạn trong Excel: độ chính xác của số là 15 chữ số · Microsoft
11 / CÔNG CỤ KHÁC
Anh chị còn thắc mắc điều gì?
Mọi công cụ về ví, contract và token có trong trang tổng quan Web3.
- AT-W32 · Doanh nghiệp
Kiểm tra mức phù hợp với blockchain
Dự án của anh chị có thật sự cần blockchain không, hay một cơ sở dữ liệu là đủ? - AT-W33 · Doanh nghiệp
Kiểm tra MiCA
Token của anh chị có thuộc phạm vi MiCA không, và kéo theo những nghĩa vụ nào? - AT-W34 · Cá nhân và doanh nghiệp
Tính phí gas
Một giao dịch trên Ethereum, Arbitrum, Optimism, Base hoặc Polygon tốn bao nhiêu? - AT-W35 · Cá nhân và doanh nghiệp
Kiểm tra địa chỉ Ethereum
Địa chỉ Ethereum này có hợp lệ và viết đúng không? Kiểm tra checksum theo EIP-55 và so sánh hai địa chỉ. - AT-W36 · Doanh nghiệp
Tính selector và topic
Function selector hoặc event topic nào ứng với chữ ký Solidity này, và ngược lại? - AT-W37 · Doanh nghiệp
Giải mã calldata
Giao dịch này làm gì? Chuyển calldata thành dạng đọc được trước khi anh chị ký.
Anh chị đã có root và proof? Chúng tôi xây contract đi kèm, trang claim có kết nối ví, và thử mọi thứ trên testnet trước khi có giá trị thật gắn vào. Từ Rodewisch, cho các dự án trên toàn nước Đức.
+49 3744 4399760[email protected]Thứ Hai–thứ Sáu, 8–17 giờ · Straße der Jugend 5, 08228 Rodewisch