Node OperationsGenesis Initialization

Genesis Initialization

Genesis initialization creates the genesis manifest — accounts, validators, fee routing, and economic parameters — and writes it to the data directory.

Initialize

omne-node init \
  --data-dir ~/.omne/data \
  --network devnet \
  --auto-treasury

This reads the network profile defaults (devnet: 2 genesis validators, 15–28 OGT stake range, 3s commerce / 9m security cadence) and produces ~/.omne/data/genesis.toml.

Custom treasury allocations

omne-node init \
  --data-dir ~/.omne/data \
  --network devnet \
  --auto-treasury \
  --treasury-omc-quar 10000000000000000000 \
  --treasury-ogt-gluu 25000000

External genesis manifest

You can supply your own genesis manifest by placing a genesis.toml at <data-dir>/genesis.toml before running omne-node init. The init step detects it and skips generation.

What init produces

ArtefactDescription
config.tomlNode configuration
genesis.tomlGenesis manifest (accounts, validators, economics)
SQLite archivesReward distribution tracking
RocksDB directoriesPersistent state storage

Re-genesis guard

Running init twice against the same directory is guarded to prevent accidental re-genesis. Remove the directory if you need a clean slate:

rm -rf ~/.omne/data
omne-node init --data-dir ~/.omne/data --network devnet --auto-treasury

Network profiles

NetworkCommerce cadenceSecurity cadenceValidatorsStake range
devnet3 seconds9 minutes2 genesis15–28 OGT
testum3 seconds9 minutesTBDTBD
principalis3 seconds9 minutesTBDTBD