independence-day

The auditable record of the GNOT genesis allocation.

This repository computes, from public chain snapshots and a published set of rules, how much GNOT every address receives at genesis. It produced the balance sheet that launched gnoland1 — 3,262,507 accounts, at commit 9dec38a4, totalling 1,002,461,998.383260 GNOT — and every input, intermediate and script used to get there is committed here so that anyone can re-derive the numbers independently.

Note that main has moved on since: the row count and the totals on this branch are not the ones that launched gnoland1. docs/history.md records which commit produced which chain.

Want to run a gnoland1 validator? That lives elsewhere: https://github.com/gnolang/gno/tree/chain/gnoland1/misc/deployments/gnoland1

---

Contents

• The allocation
• How your balance was computed
• Repository layout
• Reproducing the result
• Verifying your own line
• Stable paths
• Credits

---

The allocation

Constants live in one place: allocate/process_consolidated.go, in the const block at the top. They are the only place a bucket size is defined.

Bucket	GNOT	Where it goes
ATOM airdrop	350,000,000	Cosmos Hub ATOM holders, snapshot block 10562840 (2022-05-20 08:00 PDT)
AtomOne airdrop	231,000,000	AtomOne ATONE/PHOTON holders, snapshot block 6439117
Investors + NT LLC	632,000,000	g1pxj9x5jkklzam9v76q7sn7grm0xnuj69qu7lmf (nt1 multisig)
Contributions	117,648,000	g1sze988ga0a7sj5583cu3xt6m4vkxru4uwh6dmf (GovDAO T1 multisig)
GovDAO founders	7,000	1,000 each to 7 addresses
Non-airdrop premine	2,345,000	mkgenesis/non-airdrop.txt — charged to the Contributions bucket
Total	1,333,000,000

Two things are not separate buckets and surprise people:

• nt2 (g1sp27hn785v3kud6cg9dnhrng7wzp9cnljffhcg) is a sweep, not an allocation. The AiB addresses listed in aibCosmosAddrs / aibAtoneAddrs are removed from the airdrop and their combined entitlement is re-added under nt2. That GNOT comes out of the 350M + 231M, not on top.
• mkgenesis/non-airdrop.txt adds 2,345,000 GNOT of pre-airdrop premine (faucets, early contributors, GitHub requesters) at the very last step. It is dated 2022, and it is paid for by deducting the same amount from the Contributions bucket — which is why that row reads 117,648,000 rather than 119,993,000. Controlled by PREMINE_ABSORBED_FROM_CONTRIBS in allocate/process_consolidated.go. See docs/pipeline.md.

How your balance was computed

Cosmos Hub (ATOM)

Each address gets a weight from its liquid ATOM (uatom) and delegated ATOM (duatom) at the snapshot, modified by how it voted on Cosmos Hub Proposal 69:

Vote on prop 69	Weight
YES	uatom only — staked ATOM is excluded entirely
NO	uatom + duatom × 1.5
NO WITH VETO	uatom + duatom × 2
ABSTAIN, or did not vote	uatom + duatom

Then ugnot = weight / total_weight × 350,000,000 × 1,000,000, truncated (not rounded) to a whole ugnot.

AtomOne (ATONE / PHOTON)

No governance weighting. weight = uatone + duatone + uphoton / 7 (integer division), then the same proportional split against 231,000,000.

Exclusions

• policy/excluded.txt — addresses removed from the airdrop entirely.
• policy/ibc-escrow-addresses.txt — the 426 derived IBC transfer escrow accounts.
• policy/special-accounts.csv — annotation of CEX / custodial / validator / module addresses.

Read policy/README.md before assuming any of these is enforced — one of them is annotation only, and the exact enforcement status of each is documented there.

Repository layout

The tree reads in pipeline order.

inputs/      immutable chain snapshots + how they were captured   (never edited after capture)
policy/      human decisions: exclusions, annotations, escrow list
allocate/    the allocation engine (Go) -> genbalance.txt.gz
mkgenesis/   final merge with the premine -> balances.txt.gz      (the genesis file)
verify/      independent cross-checks of the outputs
archive/     historical material, kept for provenance; not part of the pipeline
docs/        allocation rules, pipeline detail, reproduction, history

Each directory has its own README.md explaining what is in it and whether it is live or historical.

Reproducing the result

Full detail — including rebuilding the snapshots from a gaiad export — is in docs/reproduce.md. The short version:

make            # allocate -> genbalance.txt.gz -> mkgenesis -> balances.txt.gz
make verify     # unit tests + independent cross-check + supply total

Requirements: Go 1.21+ and gzip. Both stages are Go, so there is nothing else to install.

The pipeline is bit-reproducible. Running make on a clean checkout regenerates allocate/genbalance.txt.gz byte-for-byte, and mkgenesis/balances.txt byte-for-byte. Verified on linux/amd64 and darwin/arm64. If your run differs, that is a bug and we want to hear about it.

Verifying your own line

See docs/verify-your-balance.md. It walks through, for one address: finding your row in the snapshot, reading your prop-69 vote, computing your weight by hand, and confirming it against the shipped balances.txt.gz.

Stable paths — do not move these

External tooling fetches raw URLs into this repository. These two paths are a public contract:

Path	Fetched by
mkgenesis/balances.txt.gz	gnolang/gno → misc/deployments/gnoland1/gen-genesis.sh, misc/deployments/test13.gno.land/gen-genesis.sh (pinned by commit sha), and misc/deployments/test{2,3}.gno.land/Makefile (unpinned, raw/main/...)
mkgenesis/non-airdrop.txt	same pipeline, indirectly

mkgenesis/ therefore keeps its historical name even though the rest of the tree was renamed for clarity. Anything that moves mkgenesis/balances.txt.gz breaks every unpinned consumer silently — the download just 404s. If it ever has to move, land the redirect first.

mkgenesis/README.md is generated by cd mkgenesis && go run . readme. Do not hand-edit it.

Credits

See CONTRIBUTIONS.md.