For step-by-step configuration guides, see Pre-Genesis & Genesis Setup and Runtime Configuration & Launch.
Pre-Genesis Parameters (Source Code)
Parameters set in source code before building the binary. Require rebuild to change.Show View Parameters
Show View Parameters
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 |
Copy
Ask AI
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 |
| Source | crypto/hd/hdpath.go |
Copy
Ask AI
Bip44CoinType uint32 = 60
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 |
| Source | config/config.go |
Copy
Ask AI
const EVMChainID = 262144
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 |
server/config/migration/v0.50-app.toml:11- minimum-gas-pricesx/vm/types/params.go:21-25- EVM module defaultsconfig/constants.go:5-8- Example chain constants
Genesis Parameters
Parameters configured ingenesis.json after init. Location: ~/.yourchain/config/genesis.json
Show View All Genesis Parameters
Show View All Genesis Parameters
Root Level
Show View Parameters
Show View Parameters
chain_id
| Attribute | Value |
|---|---|
| Description | Cosmos chain identifier |
| Genesis Path | chain_id |
| Default | User-defined during init |
| Type | String |
| Adjustable | Immutable |
Copy
Ask AI
"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 |
Copy
Ask AI
"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)
Show View Parameters
Show View Parameters
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 |
Copy
Ask AI
"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 |
Copy
Ask AI
"extended_denom_options": {
"extended_denom": "atoken"
}
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 |
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 |
Copy
Ask AI
"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 |
Copy
Ask AI
"active_static_precompiles": [
"0x0000000000000000000000000000000000000100",
"0x0000000000000000000000000000000000000400"
]
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 |
Copy
Ask AI
"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 |
Copy
Ask AI
"access_control": {
"create": {
"access_type": 0,
"access_control_list": []
},
"call": {
"access_type": 0,
"access_control_list": []
}
}
0 = Permissionless, 1 = Restricted (blocklist), 2 = Permissioned (allowlist)FeeMarket Module (x/feemarket)
Show View Parameters
Show View Parameters
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 |
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 |
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 |
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 |
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 |
ERC20 Module (x/erc20)
Show View Parameters
Show View Parameters
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 |
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 |
native_precompiles
| Attribute | Value |
|---|---|
| Description | ERC20 precompile addresses for native tokens |
| Genesis Path | app_state.erc20.native_precompiles |
| Default | [] |
| Type | Array of hex addresses |
Copy
Ask AI
"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 |
Copy
Ask AI
"token_pairs": [{
"erc20_address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
"denom": "atoken",
"enabled": true,
"contract_owner": 1
}]
0 = External, 1 = ModuleBank Module
Show View Parameters
Show View Parameters
denom_metadata
| Attribute | Value |
|---|---|
| Description | Token denomination metadata |
| Genesis Path | app_state.bank.denom_metadata |
| Default | [] |
| Type | Array of metadata objects |
| Adjustable | Governance |
Copy
Ask AI
"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
Show View Parameters
Show View Parameters
bond_denom
| Attribute | Value |
|---|---|
| Description | Denomination for staking |
| Genesis Path | app_state.staking.params.bond_denom |
| Default | "stake" |
| Type | String |
| Adjustable | Governance (not recommended) |
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
Show View Parameters
Show View Parameters
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
Show View Parameters
Show View Parameters
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 |
Copy
Ask AI
"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
Show View Parameters
Show View Parameters
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) |
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
Show View Parameters
Show View Parameters
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
Show View All app.toml Parameters
Show View All app.toml Parameters
Base Configuration
Show View Parameters
Show View Parameters
minimum-gas-prices
| Attribute | Value |
|---|---|
| Description | Node minimum gas price |
| Section | Root |
| Adjustable | Per Node |
| Default | "0aatom" |
| Format | <amount><denom> |
| Source | server/config/migration/v0.50-app.toml:11 |
Copy
Ask AI
minimum-gas-prices = "1000000000atoken"
pruning
| Attribute | Value |
|---|---|
| Description | State pruning strategy |
| Section | Root |
| Adjustable | Per Node |
| Default | "default" |
| Options | default, nothing, everything, custom |
default (keep 362,880 states), nothing (archive), everything (keep 2), custompruning-keep-recent / pruning-interval
| Attribute | Value |
|---|---|
| Description | Custom pruning parameters |
| Section | Root |
| Adjustable | Per Node |
| Default | "0" / "0" |
| Type | Integer |
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
Show View Parameters
Show View Parameters
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 |
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 |
cache-preimage
| Attribute | Value |
|---|---|
| Description | Track SHA3 preimages |
| Section | [evm] |
| Adjustable | Per Node |
| Default | false |
| Type | Boolean |
| Source | server/config/config.go:59 |
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 |
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 |
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 |
EVM Mempool
Show View Parameters
Show View Parameters
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 |
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 |
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 |
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 |
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 |
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 |
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 |
JSON-RPC Configuration
Show View Parameters
Show View Parameters
enable
| Attribute | Value |
|---|---|
| Description | Enable JSON-RPC server |
| Section | [json-rpc] |
| Adjustable | Per Node |
| Default | false |
| Type | Boolean |
| Source | server/config/config.go:236 |
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 |
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 |
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 |
Copy
Ask AI
api = ["eth", "net", "web3", "txpool"]
eth, net, web3, txpool, debug, personal, minergas-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 |
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 |
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 |
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 |
filter-cap
| Attribute | Value |
|---|---|
| Description | Max filters |
| Section | [json-rpc] |
| Adjustable | Per Node |
| Default | 200 |
| Type | int32 |
| Source | server/config/config.go:80 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
TLS Configuration
Show View Parameters
Show View Parameters
Telemetry Configuration
Show View Parameters
Show View Parameters
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
Show View All config.toml Parameters
Show View All config.toml Parameters
P2P Configuration
Show View Parameters
Show View Parameters
Consensus Configuration
Show View Parameters
Show View Parameters
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
Show View Parameters
Show View Parameters
laddr
| Attribute | Value |
|---|---|
| Description | CometBFT RPC address |
| Section | [rpc] |
| Adjustable | Per Node |
| Default | "tcp://127.0.0.1:26657" |
| Format | tcp://host:port |
Instrumentation
Runtime Configuration (client.toml)
CLI client configuration. Location:~/.yourchain/config/client.toml
Show View All client.toml Parameters
Show View All client.toml Parameters
chain-id
| Attribute | Value |
|---|---|
| Description | Chain ID for CLI operations |
| Section | Root |
| Adjustable | Per Node |
| Default | "" (must be set) |
| Type | String |
keyring-backend
| Attribute | Value |
|---|---|
| Description | Keyring storage backend |
| Section | Root |
| Adjustable | Per Node |
| Default | "os" |
| Options | os, file, test |
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 |
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 |