Skip to main content
Configure EVM-specific settings in ~/.evmd/config/app.toml. This guide covers parameters unique to the EVM implementation.
  • EVM
  • Mempool
  • JSON-RPC
  • Runtime Flags
  • Application Config
  • Genesis Config
  • Validator Nodes
EVM execution environment configuration.
​
tracer
string
default:""
Controls VM execution tracing for debugging.Valid Options:
  • "" - Disabled (default)
  • "json" - Full execution trace in JSON format, used by debug_traceTransaction RPC
  • "struct" - Go struct format for programmatic processing
  • "access_list" - Generates EIP-2930 access lists for gas optimization
  • "markdown" - Human-readable format for manual analysis
Source: server/config/config.go:139 Implementation: x/vm/keeper/state_transition.go:150-157
​
max-tx-gas-wanted
number
default:"0"
Limits gas for transactions in CheckTx mode to prevent DoS attacks.When set to 0, any gas amount is accepted which can lead to mempool spam.Source: server/config/config.go:141 Testnet Default: Set by evmd/cmd/evmd/cmd/testnet.go:303
​
cache-preimage
boolean
default:"false"
Enables SHA3 preimage recording in the VM for debugging tools to reverse hash lookups.Increases memory usage when enabled.Source: server/config/config.go:143
​
evm-chain-id
number
default:"262144"
EIP-155 replay protection chain ID.Must match the expected network chain ID. Used for transaction signing validation.Source: server/config/config.go:145 Used in: x/vm/genesis.go:22
​
min-tip
number
default:"0"
Minimum priority fee (tip) required for transaction inclusion in mempool.Transactions with tips below this value may be rejected. Set to 0 to disable filtering.Flag: EVMMinTip Source: server/config/config.go:150 Type: Converted to uint256.Int internally
​
geth-metrics-address
string
default:"127.0.0.1:8100"
Address for go-ethereum metrics server.Emits EVM-specific metrics in Prometheus format on a separate server from Cosmos SDK metrics.Source: server/config/config.go:152 New in: v0.5.0