# Paxeer Modules Paxeer-specific chain modules that extend the Cosmos SDK base. **Source:** `paxeer-network/modules/README.md` ## Module 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`](https://docs.paxeer.app/evm) | Native EVM execution, address association, receipts, pointers, and precompile integration | | [`epoch`](https://docs.paxeer.app/modules/epoch) | Time-based hooks and epoch lifecycle management | | [`mint`](https://docs.paxeer.app/modules/mint) | Inflation and native-token minting policy | | [`oracle`](https://docs.paxeer.app/modules/oracle) | Validator exchange-rate voting and price aggregation | | [`store`](https://docs.paxeer.app/modules/store) | Module-level store integration helpers | | [`tokenfactory`](https://docs.paxeer.app/modules/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](https://docs.paxeer.app/evm) 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](https://docs.paxeer.app/modules/epoch) 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](https://docs.paxeer.app/modules/mint) 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](https://docs.paxeer.app/modules/oracle) 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](https://docs.paxeer.app/modules/store) 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](https://docs.paxeer.app/modules/tokenfactory) 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