> ## Documentation Index
> Fetch the complete documentation index at: https://cosmos-docs-selective-ibc-merge.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuration Parameter Reference
> Complete technical reference of all configurable parameters in Cosmos EVM - source code settings, genesis parameters, and runtime configuration.
Technical reference for all Cosmos EVM chain parameters organized by configuration phase and module.
For step-by-step configuration guides, see [Pre-Genesis & Genesis Setup](/docs/evm/v0.5.0/documentation/getting-started/build-a-chain/pre-genesis-and-genesis-setup) and [Runtime Configuration & Launch](/docs/evm/v0.5.0/documentation/getting-started/build-a-chain/runtime-and-launch).
***
## Pre-Genesis Parameters (Source Code)
Parameters set in source code before building the binary. Require rebuild to change.
### Bech32 Address Prefix
| Attribute | Value |
| --------------- | ---------------------------------------------------------------------------------- |
| **Description** | Address format prefix for all Cosmos addresses |
| **Location** | `config/config.go:62` |
| **Default** | `cosmos` |
| **Type** | String (lowercase alphanumeric) |
| **Adjustable** | Immutable |
| **Source** | [`config/config.go`](https://github.com/cosmos/evm/blob/main/config/config.go#L62) |
```go theme={"system"}
const Bech32Prefix = "yourchain"
```
***
### BIP44 Coin Type
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------- |
| **Description** | HD wallet derivation path coin type |
| **Location** | `crypto/hd/hdpath.go:9` |
| **Default** | `60` (Ethereum) |
| **Type** | uint32 |
| **Adjustable** | Immutable |
| **Standard** | [SLIP-0044](https://github.com/satoshilabs/slips/blob/master/slip-0044.md) |
| **Source** | [`crypto/hd/hdpath.go`](https://github.com/cosmos/evm/blob/main/crypto/hd/hdpath.go#L9) |
```go theme={"system"}
Bip44CoinType uint32 = 60
```
**Common Values:** `60` (Ethereum/EVM), `118` (Cosmos), `330` (Terra)
***
### EVM Chain ID
| Attribute | Value |
| --------------- | ---------------------------------------------------------------------------------- |
| **Description** | EIP-155 replay protection chain ID |
| **Location** | `config/config.go:78` |
| **Default** | `262144` |
| **Type** | uint64 |
| **Adjustable** | Immutable |
| **Standard** | [EIP-155](https://eips.ethereum.org/EIPS/eip-155) |
| **Source** | [`config/config.go`](https://github.com/cosmos/evm/blob/main/config/config.go#L78) |
```go theme={"system"}
const EVMChainID = 262144
```
**Note:** Must be unique. Check [chainlist.org](https://chainlist.org) before mainnet.
***
### Default Denominations
| Attribute | Value |
| --------------- | ---------------------------------------------------------------------------------------------------- |
| **Description** | Default token denominations in config templates |
| **Location** | Multiple files |
| **Default** | `aatom` (extended), `uatom` (base), `atom` (display) |
| **Type** | String |
| **Adjustable** | Pre-Genesis |
| **Source** | [`x/vm/types/params.go:21-25`](https://github.com/cosmos/evm/blob/main/x/vm/types/params.go#L21-L25) |
**Files:**
* `server/config/migration/v0.50-app.toml:11` - minimum-gas-prices
* `x/vm/types/params.go:21-25` - EVM module defaults
* `config/constants.go:5-8` - Example chain constants
***
## Genesis Parameters
Parameters configured in `genesis.json` after `init`. Location: `~/.yourchain/config/genesis.json`
### Root Level
#### chain\_id
| Attribute | Value |
| ---------------- | -------------------------- |
| **Description** | Cosmos chain identifier |
| **Genesis Path** | `chain_id` |
| **Default** | User-defined during `init` |
| **Type** | String |
| **Adjustable** | Immutable |
```json theme={"system"}
"chain_id": "mychain-1"
```
***
#### genesis\_time
| Attribute | Value |
| ---------------- | ----------------------------- |
| **Description** | UTC timestamp for chain start |
| **Genesis Path** | `genesis_time` |
| **Default** | Auto-generated |
| **Type** | RFC3339 timestamp |
| **Adjustable** | Immutable |
```json theme={"system"}
"genesis_time": "2024-12-01T00:00:00Z"
```
***
#### initial\_height
| Attribute | Value |
| ---------------- | --------------------- |
| **Description** | Starting block height |
| **Genesis Path** | `initial_height` |
| **Default** | `"1"` |
| **Type** | String (numeric) |
| **Adjustable** | Immutable |
***
### VM Module (x/vm)
#### evm\_denom
| Attribute | Value |
| ---------------- | --------------------------------------------------------------------------------------------- |
| **Description** | Denomination for EVM gas payments |
| **Genesis Path** | `app_state.evm.params.evm_denom` |
| **Default** | `"aatom"` |
| **Type** | String |
| **Adjustable** | Governance |
| **Source** | [`x/vm/types/params.go:21`](https://github.com/cosmos/evm/blob/main/x/vm/types/params.go#L21) |
```json theme={"system"}
"evm_denom": "atoken"
```
***
#### extended\_denom\_options
| Attribute | Value |
| ---------------- | --------------------------------------------------------------------------------------------- |
| **Description** | Extended denomination for non-18 decimal tokens |
| **Genesis Path** | `app_state.evm.params.extended_denom_options` |
| **Default** | `null` |
| **Type** | Object |
| **Required For** | 6-decimal or 8-decimal tokens |
| **Adjustable** | Governance |
| **Source** | [`x/vm/types/params.go:76`](https://github.com/cosmos/evm/blob/main/x/vm/types/params.go#L76) |
```json theme={"system"}
"extended_denom_options": {
"extended_denom": "atoken"
}
```
**Note:** Requires `x/precisebank` module for non-18 decimal tokens.
***
#### history\_serve\_window
| Attribute | Value |
| ---------------- | --------------------------------------------------------------------------------------------- |
| **Description** | Number of blocks to keep historical state |
| **Genesis Path** | `app_state.evm.params.history_serve_window` |
| **Default** | `8192` |
| **Type** | Integer |
| **Adjustable** | Governance |
| **Source** | [`x/vm/types/params.go:50`](https://github.com/cosmos/evm/blob/main/x/vm/types/params.go#L50) |
***
#### extra\_eips
| Attribute | Value |
| ---------------- | --------------------------------------------------------------------------------------------- |
| **Description** | Additional EIPs to enable beyond default |
| **Genesis Path** | `app_state.evm.params.extra_eips` |
| **Default** | `[]` |
| **Type** | Array of integers |
| **Adjustable** | Governance |
| **Source** | [`x/vm/types/params.go:33`](https://github.com/cosmos/evm/blob/main/x/vm/types/params.go#L33) |
```json theme={"system"}
"extra_eips": [1153]
```
***
#### active\_static\_precompiles
| Attribute | Value |
| ---------------- | -------------------------------------------------------------------------------------------------------------- |
| **Description** | Enabled precompiled contracts |
| **Genesis Path** | `app_state.evm.params.active_static_precompiles` |
| **Default** | `[]` |
| **Type** | Array of hex addresses (must be sorted) |
| **Adjustable** | Governance |
| **Source** | [`x/vm/types/precompiles.go:22-32`](https://github.com/cosmos/evm/blob/main/x/vm/types/precompiles.go#L22-L32) |
```json theme={"system"}
"active_static_precompiles": [
"0x0000000000000000000000000000000000000100",
"0x0000000000000000000000000000000000000400"
]
```
**Available:** `0x0100` (P256), `0x0400` (Bech32), `0x0800` (Staking), `0x0801` (Distribution), `0x0802` (ICS20), `0x0803` (Vesting), `0x0804` (Bank), `0x0805` (Gov), `0x0806` (Slashing)
***
#### evm\_channels
| Attribute | Value |
| ---------------- | ----------------------------------- |
| **Description** | IBC channels to EVM chains |
| **Genesis Path** | `app_state.evm.params.evm_channels` |
| **Default** | `[]` |
| **Type** | Array of IBC channel IDs |
| **Adjustable** | Governance |
```json theme={"system"}
"evm_channels": ["channel-0"]
```
***
#### access\_control
| Attribute | Value |
| ---------------- | -------------------------------------------------------------------------------------------------------- |
| **Description** | Contract deployment and call permissions |
| **Genesis Path** | `app_state.evm.params.access_control` |
| **Default** | Permissionless (type 0) |
| **Type** | Object |
| **Adjustable** | Governance |
| **Source** | [`x/vm/types/params.go:160-165`](https://github.com/cosmos/evm/blob/main/x/vm/types/params.go#L160-L165) |
```json theme={"system"}
"access_control": {
"create": {
"access_type": 0,
"access_control_list": []
},
"call": {
"access_type": 0,
"access_control_list": []
}
}
```
**Types:** `0` = Permissionless, `1` = Restricted (blocklist), `2` = Permissioned (allowlist)
***
### FeeMarket Module (x/feemarket)
#### no\_base\_fee
| Attribute | Value |
| ---------------- | ----------------------------------------------------------------------------------------------------------- |
| **Description** | Disable EIP-1559 base fee mechanism |
| **Genesis Path** | `app_state.feemarket.params.no_base_fee` |
| **Default** | `false` |
| **Type** | Boolean |
| **Adjustable** | Governance |
| **Source** | [`x/feemarket/types/params.go:21`](https://github.com/cosmos/evm/blob/main/x/feemarket/types/params.go#L21) |
***
#### base\_fee
| Attribute | Value |
| ---------------- | ----------------------------------------------------------------------------------------------------------- |
| **Description** | Initial base fee per gas (wei) |
| **Genesis Path** | `app_state.feemarket.params.base_fee` |
| **Default** | `"1000000000"` (1 gwei) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
| **Source** | [`x/feemarket/types/params.go:13`](https://github.com/cosmos/evm/blob/main/x/feemarket/types/params.go#L13) |
***
#### base\_fee\_change\_denominator
| Attribute | Value |
| ---------------- | -------------------------------------------------------- |
| **Description** | Max base fee % change per block = 1/denominator |
| **Genesis Path** | `app_state.feemarket.params.base_fee_change_denominator` |
| **Default** | `8` (±12.5% max) |
| **Type** | uint32 |
| **Adjustable** | Governance |
***
#### elasticity\_multiplier
| Attribute | Value |
| ---------------- | -------------------------------------------------- |
| **Description** | Gas target = max\_gas / elasticity\_multiplier |
| **Genesis Path** | `app_state.feemarket.params.elasticity_multiplier` |
| **Default** | `2` (50% target) |
| **Type** | uint32 |
| **Adjustable** | Governance |
***
#### min\_gas\_price
| Attribute | Value |
| ---------------- | ----------------------------------------------------------------------------------------------------------- |
| **Description** | Network-wide minimum gas price floor |
| **Genesis Path** | `app_state.feemarket.params.min_gas_price` |
| **Default** | `"0"` |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
| **Source** | [`x/feemarket/types/params.go:17`](https://github.com/cosmos/evm/blob/main/x/feemarket/types/params.go#L17) |
***
#### min\_gas\_multiplier
| Attribute | Value |
| ---------------- | ----------------------------------------------------------------------------------------------------------- |
| **Description** | Minimum gas price as fraction of base fee |
| **Genesis Path** | `app_state.feemarket.params.min_gas_multiplier` |
| **Default** | `"0.5"` (50%) |
| **Type** | String (decimal, 0-1) |
| **Adjustable** | Governance |
| **Source** | [`x/feemarket/types/params.go:15`](https://github.com/cosmos/evm/blob/main/x/feemarket/types/params.go#L15) |
***
#### enable\_height
| Attribute | Value |
| ---------------- | ----------------------------------------------------------------------------------------------------------- |
| **Description** | Block height to activate EIP-1559 |
| **Genesis Path** | `app_state.feemarket.params.enable_height` |
| **Default** | `0` (enabled from genesis) |
| **Type** | int64 |
| **Adjustable** | Governance |
| **Source** | [`x/feemarket/types/params.go:19`](https://github.com/cosmos/evm/blob/main/x/feemarket/types/params.go#L19) |
***
### ERC20 Module (x/erc20)
#### enable\_erc20
| Attribute | Value |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Enable ERC20 module functionality |
| **Genesis Path** | `app_state.erc20.params.enable_erc20` |
| **Default** | `true` |
| **Type** | Boolean |
| **Adjustable** | Governance |
| **Source** | [`x/erc20/types/params.go:26`](https://github.com/cosmos/evm/blob/main/x/erc20/types/params.go#L26) |
***
#### permissionless\_registration
| Attribute | Value |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Allow anyone to register token pairs |
| **Genesis Path** | `app_state.erc20.params.permissionless_registration` |
| **Default** | `true` |
| **Type** | Boolean |
| **Adjustable** | Governance |
| **Source** | [`x/erc20/types/params.go:27`](https://github.com/cosmos/evm/blob/main/x/erc20/types/params.go#L27) |
***
#### native\_precompiles
| Attribute | Value |
| ---------------- | -------------------------------------------- |
| **Description** | ERC20 precompile addresses for native tokens |
| **Genesis Path** | `app_state.erc20.native_precompiles` |
| **Default** | `[]` |
| **Type** | Array of hex addresses |
```json theme={"system"}
"native_precompiles": ["0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"]
```
***
#### token\_pairs
| Attribute | Value |
| ---------------- | ---------------------------------------- |
| **Description** | Registered Cosmos denom ↔ ERC20 mappings |
| **Genesis Path** | `app_state.erc20.token_pairs` |
| **Default** | `[]` |
| **Type** | Array of token pair objects |
```json theme={"system"}
"token_pairs": [{
"erc20_address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
"denom": "atoken",
"enabled": true,
"contract_owner": 1
}]
```
**contract\_owner:** `0` = External, `1` = Module
***
### Bank Module
#### denom\_metadata
| Attribute | Value |
| ---------------- | ------------------------------- |
| **Description** | Token denomination metadata |
| **Genesis Path** | `app_state.bank.denom_metadata` |
| **Default** | `[]` |
| **Type** | Array of metadata objects |
| **Adjustable** | Governance |
```json theme={"system"}
"denom_metadata": [{
"description": "Native token",
"denom_units": [
{"denom": "atoken", "exponent": 0},
{"denom": "token", "exponent": 18}
],
"base": "atoken",
"display": "token",
"name": "Token",
"symbol": "TKN"
}]
```
***
### Staking Module
#### bond\_denom
| Attribute | Value |
| ---------------- | ------------------------------------- |
| **Description** | Denomination for staking |
| **Genesis Path** | `app_state.staking.params.bond_denom` |
| **Default** | `"stake"` |
| **Type** | String |
| **Adjustable** | Governance (not recommended) |
**Note:** Must match `evm_denom` and `mint_denom`.
***
#### unbonding\_time
| Attribute | Value |
| ---------------- | ----------------------------------------- |
| **Description** | Duration tokens locked after unstaking |
| **Genesis Path** | `app_state.staking.params.unbonding_time` |
| **Default** | `"1814400s"` (21 days) |
| **Type** | Duration string |
| **Adjustable** | Governance |
***
#### max\_validators
| Attribute | Value |
| ---------------- | ----------------------------------------- |
| **Description** | Maximum active validators |
| **Genesis Path** | `app_state.staking.params.max_validators` |
| **Default** | `100` |
| **Type** | uint32 |
| **Adjustable** | Governance |
***
#### max\_entries
| Attribute | Value |
| ---------------- | ----------------------------------------------- |
| **Description** | Max concurrent unbonding/redelegations per pair |
| **Genesis Path** | `app_state.staking.params.max_entries` |
| **Default** | `7` |
| **Type** | uint32 |
| **Adjustable** | Governance |
***
#### historical\_entries
| Attribute | Value |
| ---------------- | --------------------------------------------- |
| **Description** | Historical validator set entries to keep |
| **Genesis Path** | `app_state.staking.params.historical_entries` |
| **Default** | `10000` |
| **Type** | uint32 |
| **Adjustable** | Governance |
***
#### min\_commission\_rate
| Attribute | Value |
| ---------------- | ---------------------------------------------- |
| **Description** | Minimum validator commission rate |
| **Genesis Path** | `app_state.staking.params.min_commission_rate` |
| **Default** | `"0.000000000000000000"` (0%) |
| **Type** | String (decimal, 18 places) |
| **Adjustable** | Governance |
***
### Slashing Module
#### signed\_blocks\_window
| Attribute | Value |
| ---------------- | ------------------------------------------------ |
| **Description** | Blocks tracked for validator liveness |
| **Genesis Path** | `app_state.slashing.params.signed_blocks_window` |
| **Default** | `"10000"` |
| **Type** | String (integer) |
| **Adjustable** | Governance |
***
#### min\_signed\_per\_window
| Attribute | Value |
| ---------------- | ------------------------------------------------- |
| **Description** | Minimum fraction of blocks to sign |
| **Genesis Path** | `app_state.slashing.params.min_signed_per_window` |
| **Default** | `"0.500000000000000000"` (50%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### downtime\_jail\_duration
| Attribute | Value |
| ---------------- | -------------------------------------------------- |
| **Description** | Jail duration for downtime |
| **Genesis Path** | `app_state.slashing.params.downtime_jail_duration` |
| **Default** | `"600s"` (10 minutes) |
| **Type** | Duration string |
| **Adjustable** | Governance |
***
#### slash\_fraction\_double\_sign
| Attribute | Value |
| ---------------- | ------------------------------------------------------ |
| **Description** | Stake % slashed for double-signing |
| **Genesis Path** | `app_state.slashing.params.slash_fraction_double_sign` |
| **Default** | `"0.050000000000000000"` (5%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### slash\_fraction\_downtime
| Attribute | Value |
| ---------------- | --------------------------------------------------- |
| **Description** | Stake % slashed for downtime |
| **Genesis Path** | `app_state.slashing.params.slash_fraction_downtime` |
| **Default** | `"0.010000000000000000"` (1%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
### Governance Module
#### min\_deposit
| Attribute | Value |
| ---------------- | ---------------------------------- |
| **Description** | Minimum deposit to submit proposal |
| **Genesis Path** | `app_state.gov.params.min_deposit` |
| **Default** | Chain-specific |
| **Type** | Array of coin objects |
| **Adjustable** | Governance |
```json theme={"system"}
"min_deposit": [{"denom": "atoken", "amount": "10000000000000000000"}]
```
***
#### max\_deposit\_period
| Attribute | Value |
| ---------------- | ----------------------------------------- |
| **Description** | Time to reach minimum deposit |
| **Genesis Path** | `app_state.gov.params.max_deposit_period` |
| **Default** | `"172800s"` (2 days) |
| **Type** | Duration string |
| **Adjustable** | Governance |
***
#### voting\_period
| Attribute | Value |
| ---------------- | ------------------------------------ |
| **Description** | Voting duration for proposals |
| **Genesis Path** | `app_state.gov.params.voting_period` |
| **Default** | `"172800s"` (2 days) |
| **Type** | Duration string |
| **Adjustable** | Governance |
***
#### expedited\_voting\_period
| Attribute | Value |
| ---------------- | ---------------------------------------------- |
| **Description** | Voting duration for expedited proposals |
| **Genesis Path** | `app_state.gov.params.expedited_voting_period` |
| **Default** | `"86400s"` (1 day) |
| **Type** | Duration string |
| **Adjustable** | Governance |
***
#### quorum
| Attribute | Value |
| ---------------- | ---------------------------------------- |
| **Description** | Minimum participation for valid proposal |
| **Genesis Path** | `app_state.gov.params.quorum` |
| **Default** | `"0.334"` (33.4%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### threshold
| Attribute | Value |
| ---------------- | -------------------------------- |
| **Description** | Minimum Yes votes to pass |
| **Genesis Path** | `app_state.gov.params.threshold` |
| **Default** | `"0.5"` (50%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### veto\_threshold
| Attribute | Value |
| ---------------- | ------------------------------------- |
| **Description** | NoWithVeto votes to reject |
| **Genesis Path** | `app_state.gov.params.veto_threshold` |
| **Default** | `"0.334"` (33.4%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### expedited\_threshold
| Attribute | Value |
| ---------------- | ------------------------------------------ |
| **Description** | Yes votes required for expedited proposals |
| **Genesis Path** | `app_state.gov.params.expedited_threshold` |
| **Default** | `"0.667"` (66.7%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### expedited\_min\_deposit
| Attribute | Value |
| ---------------- | -------------------------------------------- |
| **Description** | Minimum deposit for expedited proposals |
| **Genesis Path** | `app_state.gov.params.expedited_min_deposit` |
| **Default** | 5x standard min\_deposit |
| **Type** | Array of coin objects |
| **Adjustable** | Governance |
***
### Mint Module
#### mint\_denom
| Attribute | Value |
| ---------------- | ---------------------------------- |
| **Description** | Denomination of minted tokens |
| **Genesis Path** | `app_state.mint.params.mint_denom` |
| **Default** | `"stake"` |
| **Type** | String |
| **Adjustable** | Governance (not recommended) |
**Note:** Must match `bond_denom` and `evm_denom`.
***
#### inflation\_rate\_change
| Attribute | Value |
| ---------------- | --------------------------------------------- |
| **Description** | Max annual inflation rate change |
| **Genesis Path** | `app_state.mint.params.inflation_rate_change` |
| **Default** | `"0.130000000000000000"` (13%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### inflation\_max
| Attribute | Value |
| ---------------- | ------------------------------------- |
| **Description** | Maximum annual inflation rate |
| **Genesis Path** | `app_state.mint.params.inflation_max` |
| **Default** | `"0.200000000000000000"` (20%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### inflation\_min
| Attribute | Value |
| ---------------- | ------------------------------------- |
| **Description** | Minimum annual inflation rate |
| **Genesis Path** | `app_state.mint.params.inflation_min` |
| **Default** | `"0.070000000000000000"` (7%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### goal\_bonded
| Attribute | Value |
| ---------------- | ----------------------------------- |
| **Description** | Target bonded token ratio |
| **Genesis Path** | `app_state.mint.params.goal_bonded` |
| **Default** | `"0.670000000000000000"` (67%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### blocks\_per\_year
| Attribute | Value |
| ---------------- | --------------------------------------- |
| **Description** | Expected blocks per year |
| **Genesis Path** | `app_state.mint.params.blocks_per_year` |
| **Default** | `"6311520"` (\~5s blocks) |
| **Type** | String (integer) |
| **Adjustable** | Governance |
***
### Distribution Module
#### community\_tax
| Attribute | Value |
| ---------------- | --------------------------------------------- |
| **Description** | Rewards percentage to community pool |
| **Genesis Path** | `app_state.distribution.params.community_tax` |
| **Default** | `"0.020000000000000000"` (2%) |
| **Type** | String (decimal) |
| **Adjustable** | Governance |
***
#### withdraw\_addr\_enabled
| Attribute | Value |
| ---------------- | ----------------------------------------------------- |
| **Description** | Allow custom withdraw addresses |
| **Genesis Path** | `app_state.distribution.params.withdraw_addr_enabled` |
| **Default** | `true` |
| **Type** | Boolean |
| **Adjustable** | Governance |
***
#### base\_proposer\_reward
| Attribute | Value |
| ---------------- | ---------------------------------------------------- |
| **Description** | **Deprecated** - Set to zero |
| **Genesis Path** | `app_state.distribution.params.base_proposer_reward` |
| **Default** | `"0.000000000000000000"` |
| **Type** | String (decimal) |
***
#### bonus\_proposer\_reward
| Attribute | Value |
| ---------------- | ----------------------------------------------------- |
| **Description** | **Deprecated** - Set to zero |
| **Genesis Path** | `app_state.distribution.params.bonus_proposer_reward` |
| **Default** | `"0.000000000000000000"` |
| **Type** | String (decimal) |
***
## Runtime Configuration (app.toml)
Node-specific parameters. Location: `~/.yourchain/config/app.toml`
### Base Configuration
#### minimum-gas-prices
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Description** | Node minimum gas price |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `"0aatom"` |
| **Format** | `` |
| **Source** | [`server/config/migration/v0.50-app.toml:11`](https://github.com/cosmos/evm/blob/main/server/config/migration/v0.50-app.toml#L11) |
```toml theme={"system"}
minimum-gas-prices = "1000000000atoken"
```
***
#### pruning
| Attribute | Value |
| --------------- | -------------------------------------------- |
| **Description** | State pruning strategy |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `"default"` |
| **Options** | `default`, `nothing`, `everything`, `custom` |
**Values:** `default` (keep 362,880 states), `nothing` (archive), `everything` (keep 2), `custom`
***
#### pruning-keep-recent / pruning-interval
| Attribute | Value |
| --------------- | ------------------------- |
| **Description** | Custom pruning parameters |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `"0"` / `"0"` |
| **Type** | Integer |
**Only used if** `pruning = "custom"`
***
#### halt-height / halt-time
| Attribute | Value |
| --------------- | ---------------------------- |
| **Description** | Graceful halt at height/time |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `0` |
| **Type** | Integer / Unix timestamp |
***
#### min-retain-blocks
| Attribute | Value |
| --------------- | ----------------------------------- |
| **Description** | Minimum blocks for CometBFT pruning |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `0` |
| **Type** | Integer |
***
#### inter-block-cache
| Attribute | Value |
| --------------- | -------------------------- |
| **Description** | Enable inter-block caching |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `true` |
| **Type** | Boolean |
***
#### index-events
| Attribute | Value |
| --------------- | ---------------------------------- |
| **Description** | Event types to index (empty = all) |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `[]` |
| **Type** | Array of strings |
***
#### iavl-cache-size
| Attribute | Value |
| --------------- | ---------------------------- |
| **Description** | IAVL tree cache size (nodes) |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `781250` |
| **Type** | Integer |
***
#### iavl-disable-fastnode
| Attribute | Value |
| --------------- | ---------------------- |
| **Description** | Disable IAVL fast node |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
***
#### app-db-backend
| Attribute | Value |
| --------------- | ---------------------------------- |
| **Description** | Database backend |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `""` (use CometBFT default) |
| **Options** | `goleveldb`, `rocksdb`, `pebbledb` |
***
### EVM Configuration
#### tracer
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | VM tracer type |
| **Section** | `[evm]` |
| **Adjustable** | Per Node |
| **Default** | `""` |
| **Options** | `""`, `"json"`, `"markdown"`, `"struct"`, `"access_list"` |
| **Source** | [`server/config/config.go:56`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L56) |
***
#### max-tx-gas-wanted
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Max gas per transaction |
| **Section** | `[evm]` |
| **Adjustable** | Per Node |
| **Default** | `0` (unlimited) |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:62`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L62) |
***
#### cache-preimage
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Track SHA3 preimages |
| **Section** | `[evm]` |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
| **Source** | [`server/config/config.go:59`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L59) |
***
#### evm-chain-id
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | EIP-155 chain ID (read-only) |
| **Section** | `[evm]` |
| **Adjustable** | Per Node |
| **Default** | From source code |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:149`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L149) |
**Note:** Written during `init`, do not manually edit.
***
#### min-tip
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Minimum priority fee (wei) |
| **Section** | `[evm]` |
| **Adjustable** | Per Node |
| **Default** | `0` |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:68`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L68) |
***
#### geth-metrics-address
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Geth metrics server address |
| **Section** | `[evm]` |
| **Adjustable** | Per Node |
| **Default** | `"127.0.0.1:8100"` |
| **Format** | `host:port` |
| **Source** | [`server/config/config.go:71`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L71) |
***
### EVM Mempool
#### price-limit
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Minimum gas price (wei) |
| **Section** | `[evm.mempool]` |
| **Adjustable** | Per Node |
| **Default** | `1` |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:179`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L179) |
***
#### price-bump
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Price increase % to replace tx |
| **Section** | `[evm.mempool]` |
| **Adjustable** | Per Node |
| **Default** | `10` (10%) |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:180`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L180) |
***
#### account-slots
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Executable slots per account |
| **Section** | `[evm.mempool]` |
| **Adjustable** | Per Node |
| **Default** | `16` |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:181`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L181) |
***
#### global-slots
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Max executable slots (all accounts) |
| **Section** | `[evm.mempool]` |
| **Adjustable** | Per Node |
| **Default** | `5120` |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:182`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L182) |
***
#### account-queue
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Non-executable slots per account |
| **Section** | `[evm.mempool]` |
| **Adjustable** | Per Node |
| **Default** | `64` |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:183`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L183) |
***
#### global-queue
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Non-executable slots (all accounts) |
| **Section** | `[evm.mempool]` |
| **Adjustable** | Per Node |
| **Default** | `1024` |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:184`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L184) |
***
#### lifetime
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Max time for queued txs |
| **Section** | `[evm.mempool]` |
| **Adjustable** | Per Node |
| **Default** | `"3h0m0s"` |
| **Type** | Duration string |
| **Source** | [`server/config/config.go:185`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L185) |
***
### JSON-RPC Configuration
#### enable
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Enable JSON-RPC server |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
| **Source** | [`server/config/config.go:236`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L236) |
***
#### address
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | HTTP server address |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `"127.0.0.1:8545"` |
| **Format** | `host:port` |
| **Source** | [`server/config/config.go:47`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L47) |
***
#### ws-address
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | WebSocket server address |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `"127.0.0.1:8546"` |
| **Format** | `host:port` |
| **Source** | [`server/config/config.go:50`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L50) |
***
#### api
| Attribute | Value |
| --------------- | -------------------------------------------------------------------------------------------------------------- |
| **Description** | Enabled JSON-RPC namespaces |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `["eth", "net", "web3"]` |
| **Type** | Array of strings |
| **Source** | [`server/config/config.go:304-310`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L304-L310) |
```toml theme={"system"}
api = ["eth", "net", "web3", "txpool"]
```
**Available:** `eth`, `net`, `web3`, `txpool`, `debug`, `personal`, `miner`
***
#### gas-cap
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Gas limit for eth\_call |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `25000000` |
| **Type** | uint64 |
| **Source** | [`server/config/config.go:74`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L74) |
***
#### allow-insecure-unlock
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Allow account unlocking via HTTP |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `true` |
| **Type** | Boolean |
| **Source** | [`server/config/config.go:77`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L77) |
***
#### evm-timeout
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Timeout for eth\_call |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `"5s"` |
| **Type** | Duration string |
| **Source** | [`server/config/config.go:92`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L92) |
***
#### txfee-cap
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Tx fee cap (token units) |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `1.0` |
| **Type** | Float |
| **Source** | [`server/config/config.go:95`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L95) |
***
#### filter-cap
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Max filters |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `200` |
| **Type** | int32 |
| **Source** | [`server/config/config.go:80`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L80) |
***
#### feehistory-cap
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Max blocks for fee history |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `100` |
| **Type** | int32 |
| **Source** | [`server/config/config.go:83`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L83) |
***
#### logs-cap
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Max results from eth\_getLogs |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `10000` |
| **Type** | int32 |
| **Source** | [`server/config/config.go:86`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L86) |
***
#### block-range-cap
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Max block range for eth\_getLogs |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `10000` |
| **Type** | int32 |
| **Source** | [`server/config/config.go:89`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L89) |
***
#### http-timeout
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | HTTP read/write timeout |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `"30s"` |
| **Type** | Duration string |
| **Source** | [`server/config/config.go:98`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L98) |
***
#### http-idle-timeout
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | HTTP idle timeout |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `"2m0s"` |
| **Type** | Duration string |
| **Source** | [`server/config/config.go:101`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L101) |
***
#### allow-unprotected-txs
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Allow non-EIP155 txs |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
| **Source** | [`server/config/config.go:104`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L104) |
***
#### batch-request-limit
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Max requests in batch |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `1000` |
| **Type** | Integer |
| **Source** | [`server/config/config.go:108`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L108) |
***
#### batch-response-max-size
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Max batch response bytes |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `25000000` (25 MB) |
| **Type** | Integer |
| **Source** | [`server/config/config.go:112`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L112) |
***
#### max-open-connections
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Max simultaneous connections |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `0` (unlimited) |
| **Type** | Integer |
| **Source** | [`server/config/config.go:115`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L115) |
***
#### enable-indexer
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Enable EVM tx indexer |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
| **Source** | [`server/config/config.go:256`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L256) |
***
#### metrics-address
| Attribute | Value |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Description** | Metrics server address |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `"127.0.0.1:6065"` |
| **Format** | `host:port` |
| **Source** | [`server/config/config.go:53`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L53) |
***
#### ws-origins
| Attribute | Value |
| --------------- | -------------------------------------------------------------------------------------------------------------- |
| **Description** | Allowed WebSocket origins |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `["127.0.0.1", "localhost"]` |
| **Type** | Array of strings |
| **Source** | [`server/config/config.go:120-122`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L120-L122) |
***
#### enable-profiling
| Attribute | Value |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Description** | Enable profiling in debug namespace |
| **Section** | `[json-rpc]` |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
| **Source** | [`server/config/config.go:124`](https://github.com/cosmos/evm/blob/main/server/config/config.go#L124) |
**Warning:** Never enable on public nodes.
***
### TLS Configuration
#### certificate-path
| Attribute | Value |
| --------------- | ------------------------- |
| **Description** | TLS certificate .pem path |
| **Section** | `[tls]` |
| **Adjustable** | Per Node |
| **Default** | `""` (disabled) |
| **Type** | File path |
***
#### key-path
| Attribute | Value |
| --------------- | ----------------- |
| **Description** | TLS key .pem path |
| **Section** | `[tls]` |
| **Adjustable** | Per Node |
| **Default** | `""` (disabled) |
| **Type** | File path |
***
### Telemetry Configuration
#### service-name
| Attribute | Value |
| --------------- | ------------------- |
| **Description** | Service name prefix |
| **Section** | `[telemetry]` |
| **Adjustable** | Per Node |
| **Default** | `""` |
| **Type** | String |
***
#### enabled
| Attribute | Value |
| --------------- | ---------------- |
| **Description** | Enable telemetry |
| **Section** | `[telemetry]` |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
***
#### enable-hostname / enable-hostname-label / enable-service-label
| Attribute | Value |
| --------------- | ----------------------------------- |
| **Description** | Include hostname/service in metrics |
| **Section** | `[telemetry]` |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
***
## Runtime Configuration (config.toml)
CometBFT configuration. Location: `~/.yourchain/config/config.toml`
### P2P Configuration
#### persistent\_peers
| Attribute | Value |
| --------------- | ---------------------------------- |
| **Description** | Persistent peer connections |
| **Section** | `[p2p]` |
| **Adjustable** | Per Node |
| **Default** | `""` |
| **Format** | `node_id@ip:port,node_id2@ip:port` |
***
#### laddr
| Attribute | Value |
| --------------- | ----------------------- |
| **Description** | P2P listen address |
| **Section** | `[p2p]` |
| **Adjustable** | Per Node |
| **Default** | `"tcp://0.0.0.0:26656"` |
| **Format** | `tcp://host:port` |
***
### Consensus Configuration
#### timeout\_commit
| Attribute | Value |
| --------------- | ------------------------------- |
| **Description** | Time before starting next block |
| **Section** | `[consensus]` |
| **Adjustable** | Per Node |
| **Default** | `"5s"` |
| **Type** | Duration string |
***
#### timeout\_propose / timeout\_prevote / timeout\_precommit
| Attribute | Value |
| --------------- | ------------------------ |
| **Description** | Consensus phase timeouts |
| **Section** | `[consensus]` |
| **Adjustable** | Per Node |
| **Default** | `"3s"` / `"1s"` / `"1s"` |
| **Type** | Duration string |
***
### RPC Configuration
#### laddr
| Attribute | Value |
| --------------- | ------------------------- |
| **Description** | CometBFT RPC address |
| **Section** | `[rpc]` |
| **Adjustable** | Per Node |
| **Default** | `"tcp://127.0.0.1:26657"` |
| **Format** | `tcp://host:port` |
***
### Instrumentation
#### prometheus
| Attribute | Value |
| --------------- | ------------------------- |
| **Description** | Enable Prometheus metrics |
| **Section** | `[instrumentation]` |
| **Adjustable** | Per Node |
| **Default** | `false` |
| **Type** | Boolean |
***
#### prometheus\_listen\_addr
| Attribute | Value |
| --------------- | -------------------------- |
| **Description** | Prometheus metrics address |
| **Section** | `[instrumentation]` |
| **Adjustable** | Per Node |
| **Default** | `":26660"` |
| **Format** | `:port` |
***
## Runtime Configuration (client.toml)
CLI client configuration. Location: `~/.yourchain/config/client.toml`
#### chain-id
| Attribute | Value |
| --------------- | --------------------------- |
| **Description** | Chain ID for CLI operations |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `""` (must be set) |
| **Type** | String |
**Note:** Required for node startup. Must match genesis.
***
#### keyring-backend
| Attribute | Value |
| --------------- | ----------------------- |
| **Description** | Keyring storage backend |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `"os"` |
| **Options** | `os`, `file`, `test` |
**Values:** `os` (production), `file` (encrypted), `test` (dev only)
***
#### output
| Attribute | Value |
| --------------- | ----------------- |
| **Description** | CLI output format |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `"text"` |
| **Options** | `text`, `json` |
***
#### node
| Attribute | Value |
| --------------- | ------------------------- |
| **Description** | CometBFT RPC endpoint |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `"tcp://localhost:26657"` |
| **Format** | `tcp://host:port` |
***
#### broadcast-mode
| Attribute | Value |
| --------------- | -------------------------- |
| **Description** | Transaction broadcast mode |
| **Section** | Root |
| **Adjustable** | Per Node |
| **Default** | `"sync"` |
| **Options** | `sync`, `async`, `block` |
**Values:** `sync` (recommended), `async` (fast), `block` (wait for inclusion)
***
## Summary
### By Configuration Phase
| Phase | When | Changeability |
| --------------- | --------------------------- | ---------------- |
| **Pre-Genesis** | Before `init` | Rebuild required |
| **Genesis** | After `init`, before launch | Via governance |
| **Runtime** | After launch | Restart node |
### Critical (Immutable After Genesis)
| Parameter | Reason |
| ------------------- | ----------------------------- |
| **EVM Chain ID** | Transaction replay protection |
| **Bech32 Prefix** | Address format |
| **BIP44 Coin Type** | Wallet derivation |
***
## Related Documentation
Configuration guide
Launch procedures
EVM module docs
Fee market docs
ERC20 module docs
Precision handling