Autheo Chain runs autheod, a single binary that combines the CometBFT consensus engine, Cosmos SDK application logic, and the Ethermint EVM runtime in one process.
Core layers
Module dependencies
Request lifecycle: staking
When a staking transaction arrives, it flows through x/licensedstaking MsgServer, which performs license pre-checks before delegating to the standard staking module. Upon successful delegation, the system triggers x/license.OnDelegationCreatedOrIncreased to transition licenses from BOUND to ACTIVE.
Per-block emissions
BeginBlocker executes two sequential routines each block:
- MintBlockRewards — Funds the community pool, subject to the global emissions cap.
- MintNFTBlockRewards — Scans all active licenses, checks validator jail status, and credits per-license KV balances.
JailInterceptor integration
The interceptor wraps staking keeper functions injected into the slashing module:
- On jail — Transitions licenses from
ACTIVE to BOUND.
- On unjail — Validates Sovereign license status before allowing state transitions.
EVM hook: ERC-721 license minting
When Ethermint processes ERC-721 Transfer events, the x/license EVM hook fires synchronously. It identifies the contract category, maps EVM to Cosmos addresses, and creates license records with ISSUED status. Duplicate minting is prevented by tracking (originChain, originContract, tokenId).
Key store layouts
Primary x/license KV store prefixes:
Storage backends
Network ports
Only port 26656 should be publicly accessible on validator nodes. All other ports must be firewalled to 127.0.0.1 or private network interfaces.
