HANS Docs
Tokens & governance

Governance: minting, timelock & Safes

New HANS (or UBAI) supply can only be created through a single, fully on-chain pipeline. Nobody — not the founders, not the deployer, not the treasury — can mint by themselves.

The three keys #

Role Who holds it Power
Governance Safe (proposer) A Gnosis Safe multisig — 2-of-3 on testnet, expanding to 3-of-5 before real funds The only address that can propose a mint by scheduling it on the timelock
Timelock (owner of the tokens) An OpenZeppelin TimelockController Holds the mint power. Executes only proposals that have waited out the full delay
Guardian (canceller) A separate cold-storage key Can cancel any queued proposal during the delay. Cannot propose anything

Execution is open: once the delay has passed, anyone can execute a queued mint — there is no privileged executor to go missing.

The lifecycle of a mint #

  1. The Governance Safe collects its signatures and schedules the mint on the timelock, naming the amount and the memo hash of the published acquisition memo.
  2. The proposal is now public and cannot execute until the delay passes — 72 hours on mainnet, 600 seconds on the test network.
  3. During the delay the guardian can cancel it. This is the emergency brake against a compromised or coerced Safe.
  4. After the delay, anyone executes it. The token contract mints to the treasury and emits the memo hash.

Both halves of this were rehearsed for real on Base Sepolia: a full mint of 1,000 HANS ran the entire pipeline, and a second queued mint was successfully vetoed by the guardian key with supply untouched.

Accepted trade-offs (documented, not hidden) #

  • A hostile guardian can only stall, never mint. The guardian's sole power is cancellation. The worst case is a deadlock on new mints until the key is replaced — and replacing it goes through the same timelock, which a hostile guardian could keep vetoing. This is a known, accepted property: stalling supply growth is the safe failure mode.
  • Renouncing ownership would permanently freeze supply. If the timelock ever renounced ownership of the token, minting would be impossible forever. That's treated as a feature — an available, irreversible "supply lock" — not a bug.

Future on-chain governance #

The timelock administers its own roles. When the society is ready for token-holder voting, a Governor contract can be granted the proposer role through the timelock itself — proposals that pass a public vote would then queue mints through this same pipeline. No change to the token contracts is required, and this path is covered by the test suite.

Addresses (Base Sepolia rehearsal) #

Timelock 0xb79827304058Ddc7425ae39425A538BDa6Ee93F2 (delay 600s)
Governance Safe 0xbc768e681a06a91208247e7ee9f434fce3bd71a9
Treasury Safe 0x74aed8787ba283fa283f875dfe76632e00e9e7b7

The treasury Safe is the destination for all mints, the source of merge-offer escrow, and the recipient of everything swapped in.