System architecture

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:

1. MintBlockRewards — Funds the community pool, subject to the global emissions cap.
2. 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