init package

Overview

Package init provides basic user registration.

SECURITY: every public function in this package is genesis-only. The realm exists to seed initial users into r/sys/users at chain genesis and to register itself as a controller. After genesis (block height > 0), no caller may use these functions.

Without the genesis-only gate, the wide-open `RegisterUser` wrapper would let any EOA land-grab any name (including reserved-sounding names like "administrator" or "vitalik") to any address — for free, without the namereg/v1 payment, blacklist, or canonical-collision checks. The gate closes that bypass.

Post-genesis user registration must go through a whitelisted controller that enforces its own policy (e.g. r/sys/namereg/v1).

Functions

Bootstrap


              func Bootstrap(cur realm)

Bootstrap registers this package as a controller in r/sys/users. Genesis-only via AddControllerAtGenesis's own height==0 gate.

Command

# WARNING: This command is running in an INSECURE mode.
# It is strongly recommended to use a hardware device for signing
# and avoid trusting any computer connected to the internet,
# as your private keys could be exposed.

gnokey maketx call -pkgpath "gno.land/r/sys/users/init" -func "Bootstrap" -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "topaz-1" -remote "https://rpc.topaz.testnets.gno.land" ADDRESSgnokey query -remote "https://rpc.topaz.testnets.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/sys/users/init" -func "Bootstrap" -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "topaz-1" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.topaz.testnets.gno.land" call.tx

RegisterUser


              func RegisterUser(cur realm, name string, addr address)

RegisterUser registers a new user in r/sys/users at chain genesis. PANICS if called after genesis (height > 0).

Uses RegisterUserIgnoreCanonical: the genesis seed set is curated, and any deliberate confusable reservations (e.g. registering both `vitalik` and `vital1k` to two different addresses) must not abort chain bring- up. Decision #14 (later-wins) applies, so order in genesis_txs.jsonl determines which name owns the canonical pointer when stems collide.

Command

# WARNING: This command is running in an INSECURE mode.
# It is strongly recommended to use a hardware device for signing
# and avoid trusting any computer connected to the internet,
# as your private keys could be exposed.

gnokey maketx call -pkgpath "gno.land/r/sys/users/init" -func "RegisterUser" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "topaz-1" -remote "https://rpc.topaz.testnets.gno.land" ADDRESSgnokey query -remote "https://rpc.topaz.testnets.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/sys/users/init" -func "RegisterUser" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "topaz-1" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.topaz.testnets.gno.land" call.tx

Overview

Functions

Command

Params

Command