Paxeer Modules
Paxeer-specific chain modules that extend the Cosmos SDK base.
paxeer-network/modules/README.mdModule Overview
Paxeer-specific chain modules live under paxeer-network/modules/. These extend the Cosmos SDK with functionality unique to Paxeer's EVM L1 design.
Module List
| Module | Purpose |
|---|---|
evm | Native EVM execution, address association, receipts, pointers, and precompile integration |
epoch | Time-based hooks and epoch lifecycle management |
mint | Inflation and native-token minting policy |
oracle | Validator exchange-rate voting and price aggregation |
store | Module-level store integration helpers |
tokenfactory | Permissioned creation and management of native token denominations |
Framework Modules
Framework-provided modules (bank, staking, distribution, governance, etc.) remain under sdk/x/. Interchain application modules live under interchain/modules/.
EVM Module
The evm module is Paxeer's core EVM execution layer:
- EVM execution: Runs Ethereum transactions with full opcode compatibility
- Address association: Maps Cosmos addresses to EVM addresses
- Receipts: Generates EVM transaction receipts
- Pointers: Bridging between Cosmos and EVM state
- Precompiles: Integration with Paxeer-specific precompiled contracts
See EVM documentation for details.
Epoch Module
The epoch module provides time-based lifecycle hooks:
- Epoch boundaries: Define periods for validator set changes, parameter updates
- Hooks: Other modules register callbacks to run at epoch boundaries
- Time coordination: Synchronize periodic tasks across the chain
See Epoch documentation for details.
Mint Module
The mint module manages native token issuance:
- Inflation policy: Configurable inflation rate for PAX
- Minting schedule: Block-by-block or epoch-based minting
- Distribution: Newly minted tokens distributed to validators and stakers
See Mint documentation for details.
Oracle Module
The oracle module enables validator-based price feeds:
- Exchange rate voting: Validators submit price observations
- Aggregation: Median or weighted-average price computation
- Slashing: Penalties for validators submitting bad data
- Use cases: PAX/USD price for gas estimation, USDL valuation
See Oracle documentation for details.
Store Module
The store module provides store integration helpers:
- Key formatting: Standardized key prefixes for module stores
- Iterator utilities: Common patterns for range queries
- Codec helpers: Marshaling and unmarshaling state
See Store documentation for details.
Token Factory Module
The tokenfactory module enables permissioned token creation:
- Native denominations: Create new token types on Paxeer
- Permissioned: Controlled by module parameters or governance
- Management: Mint, burn, transfer hooks
- Use cases: Wrapped assets, synthetic tokens, protocol-managed denominations
See Token Factory documentation for details.
Module Integration
Modules are registered in the application through node/app.go:
- Module manager: Coordinates module initialization and upgrades
- Begin/end block: Modules register hooks for block lifecycle
- Message routing: Module-specific transactions routed to handlers
- Query routing: Module-specific queries routed to keepers