Paxeer X Modules
Native execution, custody, settlement, exchange, bridge, issuance, and attested data modules across Paxeer X.
Paxeer-X-Network/modules/README.mdUnified Paxeer X modules
Paxeer X combines EVM and Cosmos execution with the LayerX kernel, native custody, settlement, trading, asset issuance, and cross-chain connectivity. The chain modules below enforce the chain-side rules; the LayerX kernel supplies deterministic execution and proof-carrying state transitions.
| Module | Role in Paxeer X | EVM entry point |
|---|---|---|
layerxcustody | Native and token deposits, registered deposit roots, proof-carrying withdrawals, replay protection, forced exits, and custody-backed margin | 0x1013 |
layerxanchor | Checkpoint registration and finality, availability attestations, sequencer authorization, guarantor bonds, challenges, and slashing | 0x1014 |
layerxexchange | Order intents, cancellations, margin deposits and withdrawals, positions, markets, and settlement requests | 0x1015 |
layerxbridge | External-chain registry, threshold attestors, asset caps, bridge transfers, nullifiers, and emergency pause | 0x1016 |
launchpad | Tokenfactory-backed bonding-curve markets, buy and sell quotes, configurable fee strategies, burns, airdrops, and liquidity-provider rewards | 0x1017 |
layerxgov | Packaged governance messages for LayerX-facing modules and XWeb through the chain message router | Governance proposals |
xweb | Attested web requests, threshold-signed responses, callback delivery, fees, and refunds | 0x1019 |
Explore the unified network, asset model, settlement lifecycle, and bridge. modules/README.md and docs/system/chain-modules.md describe module ownership and parameter fields.
Module Overview
Paxeer X-specific chain modules live under Paxeer-X-Network/modules/. These extend the Cosmos SDK with functionality unique to Paxeer X’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 X’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 X-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