Narzędzie AT-W38REV. 2026-A

Generator allowlisty Merkle’a: korzeń i dowody do mintu oraz airdropu

Allowlista Merkle’a zapisuje w inteligentnym kontrakcie tylko jeden skrót, czyli korzeń. Każdy adres z listy dostaje krótki dowód. Przy 10 000 adresów ma on 13 lub 14 skrótów. Podczas mintu lub odbioru tokenów kontrakt sprawdza na tej podstawie, czy adres jest uprawniony. Generator stosuje zasady OpenZeppelin, a wcześniej sprawdza zgodność adresów z EIP-55 i wyszukuje duplikaty.

  • bezpłatnie
  • bez rejestracji
  • liczy w przeglądarce

Wklej listę i sprawdź korzeń oraz dowody

Generator · korzeń Merkle’a i dowody

Narzędzie oblicza korzeń i dowody zgodnie z metodą OpenZeppelin. Proszę najpierw przetestować kontrakt i odbiór tokenów w sieci testowej, zanim będzie można przesyłać rzeczywiste aktywa. Proszę wpisywać wyłącznie adresy publiczne, nigdy klucz prywatny.

Krok 1Jak Państwa kontrakt oblicza liść?
Krok 2Jakie dane przypisać do każdego adresu?

0 oznacza, że ilości są już podane w najmniejszych jednostkach (wei). Przy 18 proszę wpisywać ilości w tokenach, np. 1.5. Narzędzie przeliczy je na najmniejsze jednostki. Proszę pomijać separatory tysięcy.

Krok 3Wklejenie listy

Format „0x…,ilość” lub wartości oddzielone średnikami, jak w Excelu. Nagłówek i komentarze zaczynające się od # są dozwolone. Limit to 100 000 wpisów. Można też wkleić plik drzewa OpenZeppelin (tree.json), a narzędzie ponownie go przeliczy.

Korzeń Merkle’a

—

Proszę wkleić listę i kliknąć „Oblicz korzeń”. Dostępny jest przykład do wypróbowania.

Weryfikacja dowoduCzy istniejący dowód pasuje do korzenia?

Przeprowadza obliczenie tak jak MerkleProof.verify w kontrakcie. Pomaga ustalić przyczynę błędu „InvalidProof” przy odbiorze tokenów.

Obliczenia odbywają się w Państwa przeglądarce. Lista nie jest wysyłana ani zapisywana.

Jeden korzeń w kontrakcie, jeden dowód na adres

Można by zapisać wszystkie uprawnione adresy bezpośrednio w kontrakcie, lecz to kosztowne. Nowe pole pamięci kosztuje co najmniej 20 000 jednostek gazu. Przy 10 000 adresów sam zapis kosztowałby więc 200 000 000 jednostek. Przy drzewie Merkle’a lista pozostaje poza łańcuchem, a kontrakt przechowuje pojedynczą wartość 32-bajtową.

Drzewo powstaje w kilku krokach. Z każdego wiersza listy oblicza się skrót, czyli liść. Liście haszuje się parami, następnie parami haszuje się wyniki i tak aż do uzyskania jednej wartości: korzenia. Zmiana choćby jednej cyfry w ilości zmienia korzeń. Pomysł pochodzi z metody podpisu z 1987 r., w której rozmiar podpisu rośnie logarytmicznie względem liczby wiadomości Merkle 1988.

Przy odbiorze tokenów odbiorca przesyła dowód (ang. proof), czyli skróty węzłów siostrzanych na każdym poziomie ścieżki od jego liścia do korzenia. Kontrakt odtwarza tę drogę i porównuje wynik z zapisanym korzeniem. Tak działają uwierzytelniane struktury danych. Nie trzeba ufać dostawcy danych, ponieważ odbiorca sam weryfikuje dowód Tamassia 2003. Strona do odbioru tokenów nie może więc dopisać wymyślonego wpisu. Kontrakt odrzuci błędny dowód.

KORZEŃ0xc09c…46a1WĘZEŁ 10xfc27…e996WĘZEŁ 20x6cac…7b41ARKUSZ0xa740…a34fARKUSZ0x9e7b…e6dcARKUSZ0x708e…e751ARKUSZ0x04c3…ad040x1111…11110x5aAe…eAed0x2222…22220xfB69…d359KRESKOWANIE: DOWÓD · POGRUBIONE: PONOWNIE OBLICZONE PRZEZ KONTRAKT

Rys. 1 · Skrócone rzeczywiste wartości z czterech adresów przykładowych (format standardowy, bez ilości). Dowód dla 0x2222…2222: dwa skróty.

Długość dowodu i pamięć zajęta w kontrakcie
AdresySkróty w dowodzieMaks. rozmiar dowoduMaks. koszt calldataMin. koszt zapisu listy
1006 lub 7224 bajty3584 jednostki gazu2 000 000 jednostek gazu
1.0009 lub 10320 bajtów5120 jednostek gazu20 000 000 jednostek gazu
10.00013 lub 14448 bajtów7168 jednostek gazu200 000 000 jednostek gazu
100.00016 lub 17544 bajty8704 jednostki gazu2 000 000 000 jednostek gazu
1.000.00019 lub 20640 bajtów10 240 jednostek gazu20 000 000 000 jednostek gazu

Calldata: 16 jednostek gazu za bajt (EIP-2028). Pamięć kontraktu: 20 000 jednostek gazu za nowe pole (Yellow Paper, G_sset). Według EIP-2929 za pierwszy dostęp do pola dochodzi 2100 jednostek gazu. Stan na 14 listopada 2026 r.

Dowód rośnie więc bardzo wolno w stosunku do listy. Zwiększenie liczby adresów z 10 000 do miliona dodaje 6 skrótów. Koszt dowodu pokrywa odbiorca w swojej transakcji. W kontrakcie niezależnie od długości listy znajduje się tylko korzeń.

Jaki format wybrać? Decyduje kontrakt

Najważniejsza zasada: generator i kontrakt muszą obliczać liść tak samo. Różnica jednego bajtu sprawi, że każda próba odbioru zakończy się błędem „Invalid proof”. Dlatego w kroku 1 trzeba podać sposób obliczania stosowany w kontrakcie.

Dwa formaty, liść z adresu i ilości
FormatLiść w SolidityBajty przed haszowaniemPlik drzewaZastosowanie
OpenZeppelin StandardMerkleTreekeccak256(bytes.concat(keccak256(abi.encode(account, amount))))64standard-v1Nowe kontrakty. Plik drzewa wczytuje bezpośrednio StandardMerkleTree.load().
Prosty (abi.encodePacked)keccak256(abi.encodePacked(account, amount))52simple-v1Istniejące kontrakty, które weryfikują w ten sposób. Układ drzewa jak w SimpleMerkleTree.

Tylko adres: odpowiednio keccak256(bytes.concat(keccak256(abi.encode(account)))) lub keccak256(abi.encodePacked(account)). Według OpenZeppelin merkle-tree 1.0.8 i Contracts 5.7.0.

Dlaczego OpenZeppelin stosuje podwójne haszowanie

Węzeł wewnętrzny drzewa powstaje z 64 bajtów, czyli dwóch połączonych skrótów. Gdyby liść przed haszowaniem także miał 64 bajty, można by przedstawić węzeł wewnętrzny jako liść. Dokładnie tyle bajtów ma abi.encode(address, uint256). Drugi skrót zapobiega takiej zamianie. W dokumentacji MerkleProof OpenZeppelin wyraźnie ostrzega przed 64-bajtowymi wartościami liści haszowanymi jednokrotnie przez keccak256. Problem ten nie występuje w prostym formacie, ponieważ abi.encodePacked(address, uint256) daje tylko 52 bajty. Przy dodawaniu następnych pól do liścia warto obliczyć jego długość.

Uporządkowane pary i posortowane liście

W obu formatach skróty w każdej parze łączy się w kolejności rosnącej. Dowód nie musi więc określać, czy sąsiedni węzeł jest z lewej, czy z prawej strony. MerkleProof.verify z OpenZeppelin weryfikuje oba formaty. Generator sortuje również liście tak jak OpenZeppelin. Inne biblioteki, np. merkletreejs bez sortLeaves, układają drzewo inaczej. Ta sama lista daje wtedy inny korzeń. Oba wyniki mogą być poprawne, ale korzeń i dowody muszą pochodzić z tego samego narzędzia.

Nasz test po każdej zmianie sprawdza obliczenia na zgodność z OpenZeppelin. Przykład z README biblioteki, dwa adresy z ilościami, daje korzeń 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77, identyczny co do znaku. Generator przelicza pliki testowe z repozytorium OpenZeppelin węzeł po węźle. W kroku 3 można wkleić plik drzewa z Państwa projektu (tree.json), by sprawdzić, czy nadal odpowiada zapisanym wartościom.

Najczęstsze błędy na listach

  • Literówki w adresach. Według EIP-55 wielkość liter koduje sumę kontrolną. Jeśli się nie zgadza, generator wskazuje wiersz. Adresy zapisane w całości małymi literami nie mają tej sumy, więc literówka może pozostać niezauważona. Pojedyncze adresy porównuje znak po znaku narzędzie do sprawdzania adresu Ethereum.
  • Ilości z Excela. Excel zachowuje dokładność do 15 cyfr. Podczas eksportu 5000000000000000001 łatwo zmienia się w 5E+18, a końcowe cyfry znikają. Generator odrzuca taki zapis. W arkuszu proszę ustawić format tekstowy kolumny.
  • Tokeny lub najmniejsza jednostka. Token z 18 miejscami dziesiętnymi odpowiada 10¹⁸ najmniejszych jednostek (wei). W przypadku USDC jest 6 miejsc. Jeśli wpisują Państwo ilości w tokenach, w kroku 2 trzeba podać liczbę miejsc dziesiętnych. Dla kontroli wynik pokazuje sumę w obu jednostkach.
  • Duplikaty. Zapis małymi literami i zapis z sumą kontrolną tego samego adresu oznaczają dla kontraktu jeden adres. Generator wykrywa powtórzenia i na życzenie je scala. Usuwa identyczne wiersze i sumuje różne ilości.

Wysyłać tokeny czy pozwolić je odebrać?

Allen, Berg i Lane zbadali, dlaczego projekty rozdają tokeny, analizując airdropy z lat 2014–2022. Główne cele to promocja oraz szersze rozproszenie własności i kontroli Allen i in. 2023. Dystrybucja powinna więc dotrzeć do wielu osób, a jej koszt nie powinien przewyższać korzyści.

Są dwa główne sposoby. W modelu push organizator przekazuje tokeny każdemu odbiorcy. W modelu pull odbiorcy odbierają je samodzielnie, jak w przypadku odbioru z dowodem Merkle’a. Fröwis i Böhme przeanalizowali 35 scenariuszy. Pull tylko umiarkowanie obniża koszty organizatora, a nakłada nieproporcjonalnie duży koszt na każdego odbiorcę. W sumie koszty każdego sposobu rosną mniej więcej liniowo z liczbą odbiorców Fröwis i Böhme 2019. Atutem odbioru z dowodem Merkle’a jest organizacja dystrybucji: lista pozostaje poza kontraktem, a odbierane są tylko tokeny, których ktoś faktycznie chce.

Trzy sposoby dystrybucji tokenów lub praw do mintu
DrogaKto ponosi opłatęNakład pracy przy uruchomieniuPóźniejsze zmiany
Bezpośredni transfer (push)Organizator, jeden transfer na odbiorcęrośnie z każdym adresembrak możliwości cofnięcia wysłanych transferów
Lista zapisana w kontrakcieOrganizator płaci za dodanie wpisów (od 20 000 jednostek gazu na adres), odbiorca za odbiórrośnie z każdym adresempojedyncze wpisy przez funkcję administracyjną
Korzeń Merkle’a (pull)Odbiorca płaci za odbiór i weryfikację dowodujedno pole pamięci na korzeńtylko przez ustawienie nowego korzenia. Weryfikuj dowody względem nowego korzenia

Przy małych kwotach opłata za odbiór może przewyższać wartość odbieranych tokenów. Wtedy warto użyć tańszego łańcucha warstwy 2 lub ustalić minimalną ilość. Koszt odbioru przy aktualnych stawkach obliczy kalkulator opłat gas.

Mint NFT: lista uprawnionych ogranicza licytację opłat

Przy otwartym mincie z ograniczoną pulą kupujący przebijają się opłatami za gaz. Zwiększa to opłaty wszystkich i marnuje gaz, jak pokazuje badanie startów NFT, które proponuje losowanie jako rozwiązanie Ko i in. 2023. Allowlista ze stałym oknem czasowym również eliminuje wyścig. Wyprzedzaniem zajmują się boty, które obserwują oczekujące transakcje i wyprzedzają je wyższymi opłatami Daian i in. 2020.

Dla kontraktu wynika z tego zasada: adres w liściu i adres odbiorcy muszą być identyczne. Najłatwiej obliczyć liść z msg.sender, tak jak we fragmencie Solidity z generatora. Dowód zauważony w puli oczekujących transakcji nie umożliwi wtedy odebrania tokenów na inny adres.

Ograniczenia listy: wiele kont i ochrona danych

Drzewo Merkle’a sprawdza, czy adres znajduje się na liście. Nie rozpoznaje, czy dziesięć adresów należy do jednej osoby czy do dziesięciu. To znany wynik informatyki: bez podmiotu potwierdzającego tożsamość nie można zapobiec wielokrotnym tożsamościom (atakom Sybil), chyba że przyjmie się nierealistyczne założenia Douceur 2002. Weryfikacja duplikatów wykrywa więc tylko ten sam adres, również w innej pisowni.

  • Łowcy airdropów są powszechni. Fan i współautorzy opisali kilka wzorców masowego pozyskiwania tokenów na przykładzie airdropu ParaSwap. Standardowe wykrywanie nie odsiało ich dostatecznie skutecznie Fan i in. 2023. Skuteczniejsze metody analizują grafy transakcji i metadane Zhou i in. 2024. Wymagają danych z łańcucha. Sama lista nie wystarcza.
  • Użytkownicy wykorzystują reguły. Gdy kryteria stają się znane, użytkownicy się do nich dostosowują. Allen zauważa przez to coraz bardziej złożone kryteria i spodziewa się airdropów w kilku rundach Allen 2024. Każda runda dostaje własny korzeń. Dowody z wcześniejszej rundy przestają pasować.
  • Wolumen obrotu nie jest pewnym kryterium. W 52 największych kolekcjach NFT w przypadku 3,93 procent adresów zauważono wzorce sugerujące pozorny handel, najczęściej pomiędzy kilkoma adresami von Wachter i in. 2023.
  • Zadania przyciągają skrypty. System z 80 milionami ukończonych zadań przyciągał farming i boty. Prawdziwych użytkowników trudno było odróżnić od skryptów Al-Chami i Clark 2025. Kryteria, których skrypt nie może spełnić niskim kosztem, pozostają skuteczne dłużej.
  • Zabezpieczenia wykraczają poza listę. Sposoby potwierdzania, że za adresem stoi człowiek, np. poręczenia i głosowanie społeczności, stanowią osobny obszar z własnymi ograniczeniami Siddarth i in. 2020.

Kiedy adresy i dowody stają się widoczne

Gdy korzeń znajdzie się w kontrakcie, jest publiczny. Odbiór ujawnia w łańcuchu adres, dowód, a w stosownych przypadkach także ilość. Plik drzewa w standardowym formacie oraz plik dowodów zawierają wszystkie adresy i wprowadzone dla nich ilości. Plik drzewa w prostym formacie zapisuje liście jako hashe. Badanie airdropu Clam z 2014 r. pokazuje, ile można z takich danych odczytać: aktywność w nowym łańcuchu pozwoliła powiązać adresy tej samej osoby w trzech innych łańcuchach Harrigan i in. 2018. Jeśli lista pochodzi z Państwa bazy klientów, jej publikację trzeba najpierw zweryfikować pod kątem ochrony danych. Generator niczego nie wysyła — obliczenia wykonuje w Państwa przeglądarce.

Jak wdrożyć allowlistę

  1. Ustalenie kryteriów i daty odniesienia. Kto ile dostaje i który blok stanowi podstawę wyboru? Proszę ustalić to na piśmie przed utworzeniem listy. Inaczej trudno będzie wyjaśnić brak konkretnego adresu.
  2. Prawidłowy eksport listy. Ilości należy eksportować jako tekst zamiast liczb. Proszę jasno ustalić, czy są to najmniejsze jednostki, czy ilości wyrażone w tokenach.
  3. Wybór formatu zgodnego z kontraktem. Dla nowego kontraktu proszę wybrać format OpenZeppelin. W istniejącym kontrakcie proszę sprawdzić sposób obliczania liścia i odpowiednio ustawić krok 1.
  4. Odbiór w sieci testowej. Proszę zapisać korzeń w kontrakcie i wykonać rzeczywiste próby odbioru z dwóch lub trzech adresów, w tym jednego spoza listy. Jeśli coś się nie powiedzie, weryfikator dowodu pokaże, gdzie obliczenie się rozchodzi.
  5. Zachowanie listy i pliku drzewa. Z tej samej listy generator ponownie obliczy ten sam korzeń. Zmiana jednego wiersza powoduje niezgodność.
  6. Zaplanowanie zakończenia. Przed uruchomieniem trzeba wpisać do kontraktu termin odbioru i funkcję odzyskania pozostałych tokenów. W kontrakcie bez możliwości aktualizacji nie da się ich później dodać.

Ograniczenia generatora

  • Brak wykrywania wielu kont. Generator wykrywa identyczne adresy. Nie łączy różnych adresów jednej osoby.
  • Jeden układ drzewa. Generator stosuje układ OpenZeppelin z posortowanymi liśćmi. Nie odtwarza drzew innych bibliotek, ale weryfikator sprawdza ich pojedyncze dowody.
  • Liście z address i uint256. Dodatkowe pola, np. kolejny numer, wielodowody ani własne funkcje skrótu nie są obsługiwane.
  • Brak odczytu z łańcucha. Generator nie odczytuje sald ani kontraktów. Nie zastępuje sprawdzenia kontraktu.

Kontrakt, stronę odbioru i integrację z portfelami tworzymy w ramach rozwiązań Web3. Dekoder calldata pokazuje, co transakcja naprawdę wywoła, zanim zostanie podpisana. Wszystkie narzędzia Web3 są w przeglądzie Web3.

Co mówią na ten temat badania

Wskazówki generatora opierają się na pięciu ustaleniach z badań. Pełna lista z uwagami o weryfikacji znajduje się poniżej.

  • Dowód rośnie logarytmicznie. Dlatego przy 10 000 adresów wystarcza 13 lub 14 skrótów Merkle 1988, które kontrakt weryfikuje samodzielnie Tamassia 2003.
  • Samodzielny odbiór przenosi część kosztów. Pull tylko umiarkowanie obniża koszt organizatora i obciąża każdego odbiorcę Fröwis i Böhme 2019. Stąd uwaga dotycząca małych kwot.
  • Adres nie oznacza jednej osoby. Bez potwierdzenia tożsamości można korzystać z wielu kont Douceur 2002, a przypadki łowców airdropów są dobrze udokumentowane Fan i in. 2023.
  • Oczekujące transakcje można obserwować. Boty konkurują o kolejność Daian i in. 2020. Dlatego liść we fragmencie Solidity jest powiązany z msg.sender.
  • Dane z airdropu ujawniają powiązania. Adresy tej samej osoby można powiązać między łańcuchami Harrigan i in. 2018. Stąd uwaga o publikacji listy.

Korzystanie z tego narzędzia przez asystenta AI

Asystenci, tacy jak Claude czy ChatGPT, którzy obsługują Model Context Protocol (MCP), mogą wywołać obliczenia tej strony bezpośrednio, zamiast je odtwarzać. Serwer jest publiczny, nie wymaga logowania i niczego nie zapisuje. Odpowiedź zawsze zawiera link do tej strony, stan danych i granice wyniku.

Endpoint
https://aureum-tech.com/mcp
Narzędzie
werkzeug_merkle_allowlist
Transport
Streamable HTTP, tylko odczyt
Dane wejściowe
NazwaWymaganeZnaczenie
aktionnie„erzeugen” (domyślnie): korzeń i dowody z listy. „pruefen”: sprawdzenie istniejącego dowodu względem korzenia.
listenieDla „erzeugen”: jeden wpis na wiersz, „0x…” lub „0x…,ilość”. Można dodać nagłówek, puste wiersze i komentarze z #. Limit wynosi 10000 wpisów. Zamiast listy można też podać plik drzewa OpenZeppelin (standard-v1 lub simple-v1) jako tekst JSON. Narzędzie wyliczy go ponownie.
formatnie„standard” (domyślnie) = OpenZeppelin StandardMerkleTree, liść keccak256(bytes.concat(keccak256(abi.encode(…)))). „einfach” = keccak256(abi.encodePacked(…)), uporządkowane pary.
inhaltnie„adresse” (domyślnie): liść wyłącznie z adresu, np. w allowliście do mintu. „menge”: adres i ilość (uint256), np. do airdropu.
dezimalstellennieTylko przy „menge”: miejsca dziesiętne tokena. 0 (domyślnie) = ilości podano w najmniejszych jednostkach. 18 = ilości podano w tokenach i będą przeliczane na wei.
beweise_fuernieAdresy, dla których narzędzie ma zwrócić dowody. Bez podania adresów zwróci wszystkie, jeśli lista ma najwyżej 20 wpisów.
mit_baumdateinieDołącz plik drzewa w formacie OpenZeppelin (StandardMerkleTree.load / SimpleMerkleTree.load), do 1000 wpisów.
rootnieDla „pruefen”: korzeń Merkle’a, 0x i 64 znaki szesnastkowe.
adressenieDla „pruefen”: adres, którego dowód jest sprawdzany, lub bezpośrednio skrót liścia (bytes32).
mengenieDla „pruefen” z inhalt „menge”: ilość w najmniejszych jednostkach jako liczba całkowita, np. „5000000000000000000”.
beweisnieDla „pruefen”: skróty dowodu od liścia do korzenia, każdy jako 0x i 64 znaki szesnastkowe.

Pytania, przy których asystent powinien go użyć

  • „Wygeneruj korzeń Merkle’a dla tej allowlisty w formacie OpenZeppelin i podaj dowód dla pierwszego adresu.”
  • „Jaki jest korzeń Merkle’a dla tego airdropu z adresem i ilością w wei i jak zweryfikować liść w Solidity?”
  • „Czy ten dowód Merkle’a pasuje do mojego korzenia, czy kontrakt używa abi.encodePacked zamiast abi.encode?”
  • „Czy mój plik tree.json z StandardMerkleTree nadal odpowiada zapisanym w nim wartościom?”

Jak działa połączenie i co MCP może dać we własnej firmie, opisujemy na stronie Integracje MCP.

Częste pytania o korzeń Merkle’a, dowody i allowlisty

Co to jest allowlista oparta na drzewie Merkle’a?

To lista uprawnionych adresów, którą w inteligentnym kontrakcie reprezentuje jeden skrót: korzeń Merkle’a. Każdy adres otrzymuje dowód złożony z kilku skrótów. Dla listy 10 000 adresów jest ich 13 lub 14. Przy mincie lub odbiorze tokenów adres przekazuje dowód, a kontrakt sprawdza, czy prowadzi on do korzenia. Sama lista pozostaje poza łańcuchem.

Dlaczego OpenZeppelin oblicza skrót liścia dwa razy?

Węzeł wewnętrzny drzewa powstaje z 64 bajtów, czyli dwóch połączonych skrótów. Gdyby liść przed haszowaniem miał także 64 bajty, można by podstawić węzeł wewnętrzny jako liść. Wynik abi.encode(address, uint256) ma dokładnie 64 bajty. Podwójne haszowanie zapobiega takiej zamianie. OpenZeppelin w MerkleProof wyraźnie przestrzega przed 64-bajtowymi wartościami liści haszowanymi jednokrotnie przez keccak256.

Przy odbiorze dostaję błąd „Invalid proof”. Co go powoduje?

Zwykle kontrakt oblicza liść inaczej niż narzędzie, które wygenerowało dowody. Może używać abi.encode zamiast abi.encodePacked, jednego skrótu zamiast dwóch albo liczyć w pełnych tokenach zamiast w najmniejszych jednostkach. Inną przyczyną bywa korzeń ze starszej wersji listy. Weryfikator pod generatorem wykonuje obliczenie krok po kroku. Można w nim sprawdzić oba formaty i obie jednostki.

Czy wynik jest zgodny z OpenZeppelin StandardMerkleTree?

Tak. Liście, sortowanie i układ drzewa są identyczne. Plik drzewa w formacie standard-v1 wczytuje bezpośrednio StandardMerkleTree.load(). Przykład z README biblioteki daje korzeń 0xd4dee0beab2d53f2cc83e567171bd2820e49898130a22622b10ead383e90bd77, tak samo jak w OpenZeppelin. Prosty format używa układu SimpleMerkleTree (simple-v1).

Jak duży jest dowód Merkle’a przy 10 000 adresów?

Składa się z 13 lub 14 skrótów po 32 bajty, czyli ma najwyżej 448 bajtów. Przesłanie go w calldata kosztuje najwyżej 7168 jednostek gazu, przy 16 jednostkach za bajt zgodnie z EIP-2028. Dla miliona adresów dowód zawiera 20 skrótów. Zapisanie całej listy w kontrakcie kosztowałoby co najmniej 20 000 jednostek gazu na adres.

Czy można zmienić listę po wdrożeniu kontraktu?

Tylko przez ustawienie nowego korzenia. Już zmiana jednej ilości skutkuje nowym korzeniem. Weryfikuj dowody względem tego nowego korzenia, nawet jeśli poszczególne dowody pozostają niezmienione. Kontrakt potrzebuje funkcji, za pomocą której uprawniona osoba może podmienić korzeń; bez niej lista pozostaje bez zmian. Przy dystrybucji w rundach każda runda powinna mieć własny korzeń, a kontrakt zapisuje, kto już odebrał tokeny w danej rundzie.

Czy allowlista Merkle’a chroni przed botami i wieloma kontami?

Blokuje adresy spoza listy. Nie chroni przed wieloma kontami: jeśli ktoś umieścił na liście dwadzieścia adresów, może odebrać tokeny dwadzieścia razy. Adresy trzeba odsiewać przed wprowadzeniem ich do generatora. Badania nad airdropami wskazują, że proste reguły nie wystarczają.

Jakie ograniczenia ma generator drzewa Merkle’a?

Oblicza korzeń i dowody, tworzy pliki oraz sprawdza adresy i duplikaty w przeglądarce. Nie rozpoznaje wielu kont jednej osoby i nie odczytuje danych z łańcucha. Buduje wyłącznie drzewa o układzie OpenZeppelin i nie zastępuje kontroli kontraktu. Na życzenie zajmiemy się kontraktem, stroną odbioru i próbą w sieci testowej.

Na czym opiera się to narzędzie

Wartości orientacyjne i wskazówki powyżej opierają się na tych 14 pracach naukowych. Każdą sprawdziliśmy przez jej DOI lub stronę wydawcy (ostatnio 14 listopada 2026): istnieje, nie została wycofana, a jej wnioski nadal odpowiadają na to pytanie.

  1. Merkle, R. C. (1988): A Digital Signature Based on a Conventional Encryption Function. Advances in Cryptology – CRYPTO ’87, LNCS 293, s. 369–378

    Wynik Od tej pracy wywodzi się drzewo Merkle’a. Wiele wartości powiązano z jedną wartością przez drzewo skrótów. Rozmiar podpisu rośnie tylko logarytmicznie względem liczby podpisanych wiadomości.

    W narzędziu To podstawa wyjaśnienia, dlaczego przy 10 000 adresów dowód zawiera tylko 13 lub 14 skrótów (tabela długości dowodów).

  2. Tamassia, R. (2003): Authenticated Data Structures. Algorithms – ESA 2003, LNCS 2832, s. 2–5

    Wynik Przegląd uwierzytelnianych struktur danych. Niezaufany pośrednik odpowiada na zapytania w imieniu zaufanego źródła i dołącza dowód, który użytkownik sam sprawdza.

    W narzędziu To podstawa podziału ról. Lista znajduje się na stronie, korzeń w kontrakcie, a kontrakt sam weryfikuje dołączony dowód.

  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, s. 255–270

    Wynik Symulacja 35 scenariuszy airdropów. Możliwe są oszczędności rzędu połowy kosztów, lecz wymagają zmian w kontrakcie tokena. Dystrybucja przez samodzielny odbiór (pull) daje organizatorowi umiarkowaną oszczędność i przenosi nieproporcjonalnie wysokie koszty na poszczególnych odbiorców.

    W narzędziu To podstawa sekcji o wysyłaniu i odbiorze. Odbiór z dowodem Merkle’a to metoda pull, w której opłatę za gaz ponosi odbiorca.

  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), s. 63–70

    Wynik Na przykładzie airdropu Clam z 2014 r. autorzy pokazują, że aktywność w nowym łańcuchu pozwala powiązać adresy tej samej osoby w Bitcoinie, Litecoinie i Dogecoinie. Airdropy są uznawane za pozbawione ryzyka dla odbiorców, a ich skutki dla prywatności bywają pomijane.

    W narzędziu To uzasadnia ostrzeżenie, że publikacja pliku drzewa lub dowodów ujawnia wszystkie adresy wraz z ilościami.

  5. Allen, D. W. E.; Berg, C.; Lane, A. M. (2023): Why airdrop cryptocurrency tokens?. Journal of Business Research 163, art. 113945

    Wynik Studia przypadków znanych airdropów z lat 2014–2022. Projekty rozdają tokeny głównie z dwóch powodów: w celach marketingowych (żeby pozyskać użytkowników i utrzymać społeczność) oraz by decentralizować własność i kontrolę.

    W narzędziu To wyjaśnia przed omówieniem techniki, po co firmy tworzą allowlisty lub organizują airdropy.

  6. Allen, D. W. E. (2024): Crypto airdrops: An evolutionary approach. Journal of Evolutionary Economics 34 (4–5), s. 849–872

    Wynik Dziewięć studiów przypadków. Kryteria airdropów stają się coraz bardziej skomplikowane, bo użytkownicy dostosowują się do każdej reguły, by uzyskać więcej tokenów. Autor spodziewa się kilku rund zamiast jednego airdropu, aby projekty mogły uczyć się na bieżąco.

    W narzędziu Stąd zalecenie, żeby ustalić kryteria przed stworzeniem listy i obliczać osobny korzeń dla każdej rundy.

  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, s. 1–16

    Wynik Analiza ról na podstawie danych z airdropu ParaSwap. Osoby, które dostały więcej tokenów, częściej działały na rzecz społeczności. Autorzy opisują kilka wzorców masowego pozyskiwania tokenów. Standardowe metody wykrywania nie odsiewały łowców airdropów dostatecznie skutecznie.

    W narzędziu Dlatego narzędzie wyraźnie nie obiecuje wykrywania ataków Sybil. Adresy trzeba przefiltrować przed wprowadzeniem do generatora.

  8. Zhou, C.; Chen, H.; Wu, H. i in. (2024): ARTEMIS: Detecting Airdrop Hunters in NFT Markets with a Graph Learning System. Proceedings of the ACM Web Conference 2024 (WWW ’24), s. 1824–1834

    Wynik Łowcy airdropów celowo gromadzą wiele adresów portfeli, żeby wielokrotnie odbierać tokeny. Na przykładzie giełdy Blur metoda uczenia na grafach wykrywała ich na podstawie sekwencji transakcji i metadanych NFT wyraźnie lepiej niż wcześniejsze podejścia.

    W narzędziu To ustalenie dotyczy wzorców ataków Sybil. Do ich wykrycia potrzebne są dane o transakcjach w łańcuchu, których generator list nie ma.

  9. Douceur, J. R. (2002): The Sybil Attack. Peer-to-Peer Systems (IPTPS 2002), LNCS 2429, s. 251–260

    Wynik Osoba posługująca się wieloma tożsamościami może kontrolować dużą część systemu rozproszonego. Bez logicznie centralnego podmiotu potwierdzającego tożsamość takie ataki pozostają możliwe, chyba że przyjmie się nierealistyczne założenia.

    W narzędziu Zasada „jeden adres, jeden odbiór” nadal dopuszcza wiele odbiorów przez jedną osobę. Kontrola duplikatów rozpoznaje tylko identyczne adresy.

  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, art. 590171

    Wynik Przegląd protokołów, które próbują przeciwdziałać atakom Sybil bez urzędu potwierdzającego tożsamość. Stosują głosowanie, poręczenia i oceny innych uczestników. Autorzy omawiają mocne i słabe strony tych podejść.

    W narzędziu To podstawa omówienia ochrony wykraczającej poza listę, np. potwierdzenia, że za adresem stoi człowiek, lub poręczenia, które pomagają ograniczyć wiele tożsamości.

  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, s. 299–311

    Wynik W 52 kolekcjach NFT z największym obrotem (od 2018 r. do listopada 2021 r.) wzorce potencjalnej manipulacji rynkiem dotyczyły 3,93 procent adresów i 2,04 procent sprzedaży. Najczęściej transakcje krążyły między kilkoma adresami.

    W narzędziu Pokazuje, że wolumen obrotu jako kryterium allowlisty może być zawyżony, ponieważ jedna osoba łatwo kontroluje kilka adresów.

  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, s. 196–211

    Wynik Analiza systemu z 43 zadaniami i 80 milionami ukończeń w ciągu dziesięciu miesięcy. Autorzy opisują farming, boty i powody, dla których trudno odróżnić prawdziwych użytkowników od skryptów.

    W narzędziu To podstawa zalecenia, by jeszcze przed wprowadzeniem adresów do generatora wybierać kryteria, których nie da się spełnić tanio za pomocą skryptu.

  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), s. 1–5

    Wynik Przy starcie popularnych kolekcji NFT kupujący przebijają się opłatami za gaz („Gas War”). Zwiększa to opłaty wszystkim i marnuje gaz. Uruchomienie w drodze losowania rozwiązało problem w badaniu i pozwoliło oszczędzić co najmniej 15,5 procent gazu.

    W narzędziu Wyjaśnia, dlaczego mint z allowlistą lub losowaniem przebiega spokojniej niż otwarty mint rozstrzygany według kolejności zgłoszeń.

  14. Daian, P.; Goldfeder, S.; Kell, T. i in. (2020): Flash Boys 2.0: Frontrunning in Decentralized Exchanges, Miner Extractable Value, and Consensus Instability. 2020 IEEE Symposium on Security and Privacy (SP), s. 910–927

    Wynik Boty obserwują oczekujące transakcje i konkurują o priorytetową opłatę za gaz („Priority Gas Auctions”), by ich transakcje wcześniej trafiły do bloku. Badanie mierzy to na giełdach zdecentralizowanych i pokazuje, jak wykorzystywana jest kolejność transakcji.

    W narzędziu Dlatego fragment w Solidity wiąże liść z msg.sender. Samo zauważenie dowodu w puli oczekujących transakcji nie daje nikomu prawa odbioru dla siebie.

Normy, urzędy i dane producentów

pon.–pt. 8–17

Mają Państwo korzeń i dowody? Przygotujemy kontrakt oraz stronę odbioru z integracją portfeli. Wszystko przetestujemy w sieci testowej, zanim będzie obsługiwać rzeczywiste aktywa. Działamy z Rodewisch i realizujemy projekty na terenie całych Niemiec.

+49 3744 4399760[email protected]

pon.–pt. 8–17 · Straße der Jugend 5, 08228 Rodewisch

Zamów wdrożenie allowlisty
+49 3744 4399760pon.–pt. 8–17
ZadzwońOddzwonimy

WYKAZ CZĘŚCI · ARKUSZ 1/1

Z czego składa się ta strona

Wartości zmierzone podczas budowania strony – z JavaScriptem Państwa przeglądarka mierzy je na bieżąco.

POZ.ELEMENTTYPROZMIAR
01index.htmlDokument≈ 29 kB
02styles.cssArkusz stylów≈ 20 kB
03scripts.jsSkrypt≈ 13 kB
04archivo-variable.woff2Czcionka≈ 58 kB
05ibm-plex-mono.woff2Czcionka≈ 30 kB
06favicon.svgGrafika< 1 kB

Pliki cookie reklamowe ani analityczne: brak. Bez Państwa zgody strona nie pobiera niczego z obcych serwerów poza naszą usługą dostarczania treści Cloudflare – czcionki, skrypty i grafiki są u nas. Tak samo budujemy Państwa IT.

POZA GODZINAMI PRACY

Mimo to proszę śmiało dzwonić

Zwykle jesteśmy w biurze pon.–pt. 8–17.

Wieczorem i w weekend numer też jest do nas przekierowany i często ktoś odbiera. Obiecać tego nie możemy.

Jeśli nikt nie odbierze, proszę zostawić krótką wiadomość na poczcie głosowej: imię i nazwisko, numer i czego dotyczy sprawa. Oddzwonimy jak najszybciej, najpóźniej następnego dnia roboczego.

Sama rozmowa nic nie kosztuje. Jeśli poza godzinami pracy ktoś musi zająć się sprawą od razu, obowiązuje dopłata z cennika.

Zadzwoń teraz+49 3744 4399760

Wolą Państwo napisać? Przez formularz kontaktowy albo na [email protected]. Przeczytamy to następnego dnia roboczego.

DIAGNOZA · AT-K2

W czym możemy pomóc?

↵ WYBIERZESC ZAMKNIJTELEFON: +49 3744 4399760

Ustawienia indywidualne

Które usługi mogą się ładować?

Niezbędne technicznie

Podjęta tutaj decyzja oraz ustawienia schematu kolorów i animacji. Te dane zostają jako małe wpisy na Państwa urządzeniu i nigdy nie są wysyłane na serwer. Są potrzebne do działania strony, dlatego nie można ich wyłączyć.