Sei Technical Reference

# Minimum gas prices for transaction acceptance
minimum-gas-prices = "0.02usei"

# API configuration
[api]
enable = true
swagger = true
address = "tcp://0.0.0.0:1317"
max-open-connections = 1000

# State sync configuration
[state-sync]
snapshot-interval = 1000
snapshot-keep-recent = 2

# Memory management
[mempool]
size = 5000
max-txs-bytes = 1073741824
cache-size = 10000



#### Block-Failed Transaction Re-Entry Protection

The mempool tracks transactions that fail during block execution to prevent them from re-entering the mempool indefinitely. Some transactions consistently fail before fee charging in `DeliverTx`, which historically let them be re-submitted without limit and waste block and proxy-app resources.

The mempool now applies the following policy on top of the existing `keep-invalid-txs-in-cache` setting:

- When a committed transaction succeeds (`Code == OK`), it is kept in the cache and its entry in the block-failure tracker is cleared.
- When a committed transaction fails and `keep-invalid-txs-in-cache` is `false`:
  - **First block failure:** the transaction is removed from the cache, allowing it to be re-submitted and retried once.
  - **Second (and subsequent) block failure:** the transaction is left in the cache. Any attempt to re-submit it is rejected by `CheckTx` with `ErrTxInCache`, preventing infinite re-entry.
- A successful block inclusion resets the failure tracker, so a transaction that later succeeds regains its first-failure grace period.

The block-failure tracker uses an LRU cache sized to match the mempool `cache-size`. When `cache-size` is `0`, tracking is disabled. This behavior is automatic and requires no additional configuration.


# State commit configuration (SeiDB). State-commit is mandatory:
# the node will panic on startup if sc-enable is false.
[state-commit]
sc-enable = true

# State store configuration
[state-store]
ss-enable = true
ss-backend = "pebbledb"
ss-keep-recent = 100000
ss-prune-interval = 600

# Receipt store configuration
[state-store.receipt-store]
# Backend defines the receipt store backend.
# The only supported backend is pebbledb (aka pebble), which is also the
# default. The parquet/DuckDB backend has been removed; setting rs-backend to
# "parquet" now returns an error.
rs-backend = "pebbledb"

# AsyncWriteBuffer defines the async queue length for commits applied to the
# receipt store. Applies only when rs-backend = "pebbledb". Set <= 0 for
# synchronous writes. Defaults to 100.
async-write-buffer = 100

# Interval in seconds to trigger pruning. Receipt retention is controlled by
# the global min-retain-blocks flag. Defaults to 600 seconds.
prune-interval-seconds = 600

# P2P Configuration
[p2p]
laddr = "tcp://0.0.0.0:26656"
external-address = ""
seeds = ""
persistent_peers = ""
upnp = false
# Total connection budget. Inbound and outbound connections are now tracked in
# fully separate pools, so a single peer may hold both an inbound and an
# outbound connection at the same time.
max-connections = 100
# Maximum number of outbound connections to regular (non-persistent) peers.
# Defaults to min(20, (max-connections+1)/2). Inbound capacity is derived as
# max-connections - max-outbound-connections. Persistent and unconditional
# peers are not counted against either limit.
max-outbound-connections = 20
allowed_pools = ""
max_packet_msg_payload_size = 10240
handshake_timeout = "20s"
dial_timeout = "3s"

# RPC Configuration
[rpc]
laddr = "tcp://0.0.0.0:26657"
cors_allowed_origins = []
cors_allowed_methods = ["HEAD", "GET", "POST"]
cors_allowed_headers = ["Origin", "Accept", "Content-Type", "X-Requested-With", "X-Server-Time"]
max_open_connections = 900
# Maximum time to wait for a BroadcastTxCommit request to complete. When set to
# a value greater than 0, the BroadcastTxCommit RPC now enforces this as a
# context deadline on the request: if CheckTx and DeliverTx do not complete
# within this duration, the request context is cancelled and the call returns a
# timeout error. Set to "0s" to disable the timeout.
timeout_broadcast_tx_commit = "10s"
# Timeout to read HTTP request headers; mitigates slowloris attacks by limiting
# the time allowed to read request headers. Set to "0s" to disable (not
# recommended). Defaults to 10s.
timeout-read-header = "10s"
# HTTP write timeout; acts as a hard backstop for all handlers. Must be greater
# than timeout_broadcast_tx_commit when non-zero. Set to "0s" to disable (not
# recommended). Defaults to 30s.
timeout-write = "30s"


# Maximum number of results returned by the tx_search and block_search RPC
# endpoints. The cap is applied after results are sorted, so the top matches
# (per order_by) are preserved, and TotalCount reflects the post-cap count.
# Must not be negative. Set to 0 to disable the cap (not recommended on public
# nodes). Defaults to 10000.
max-tx-search-results = 10000

# Consensus Configuration
[consensus]
wal_file = "data/cs.wal/wal"
timeout_propose = "3s"
timeout_propose_delta = "500ms"
timeout_prevote = "1s"
timeout_prevote_delta = "500ms"
timeout_precommit = "1s"
timeout_precommit_delta = "500ms"
timeout_commit = "1s"
double_sign_check_height = 0