Sei Technical Reference
This guide serves as a comprehensive reference for Sei node operators and validators, providing detailed command syntax, configuration parameters, and troubleshooting procedures. For API documentation, please refer to our API Documentation section.
Command Line Interface Reference
The seid
binary provides extensive functionality for managing your Sei node.
Understanding these commands is essential for effective node operation and
troubleshooting.
Node Management Commands
These commands help you control and monitor your node’s operation:
# Start the node
seid start [flags]
# Show node status
seid status
# Show validator consensus key
seid tendermint show-validator
# Query node information
seid query node info
Key Management
Proper key management is crucial for security. These commands help you manage your keys effectively:
# Create new key
seid keys add <name> [flags]
# List all keys
seid keys list
# Delete key
seid keys delete <name>
# Export key (encrypted)
seid keys export <name>
# Import key
seid keys import <name> <keyfile>
# Show key address
seid keys show <name> -a
Transaction Commands
These commands allow you to interact with the blockchain:
# Send tokens
seid tx bank send <from-key> <to-address> <amount>usei [flags]
# Delegate tokens
seid tx staking delegate <validator-addr> <amount>usei --from <delegator-key>
# Withdraw rewards
seid tx distribution withdraw-rewards <validator-addr> --from <delegator-key>
# Edit validator
seid tx staking edit-validator [flags] --from <validator-key>
Configuration Parameters
Understanding configuration parameters is essential for optimizing your node’s performance and security.
App.toml Parameters
The app.toml file controls application-specific settings:
Complete app.toml Configuration
# Minimum gas prices for transaction acceptance
minimum-gas-prices = "0.01usei"
# 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
# State store configuration
[state-store]
ss-enable = true
ss-backend = "pebbledb"
ss-keep-recent = 100000
ss-prune-interval = 600
Config.toml Parameters
The config.toml file controls the core consensus engine and networking:
Complete config.toml Configuration
# P2P Configuration
[p2p]
laddr = "tcp://0.0.0.0:26656"
external_address = ""
seeds = ""
persistent_peers = ""
upnp = false
max_num_inbound_peers = 40
max_num_outbound_peers = 10
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
timeout_broadcast_tx_commit = "10s"
# 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
Network Parameters
Understanding network parameters helps you operate your node effectively.
Chain Parameters
These parameters define the network’s behavior:
Block Time: 1 second target
Max Validators: 100
Unbonding Period: 21 days
Slashing Conditions:
- Downtime: 0.01%
- Double Sign: 5%
- Oracle Miss: 0.01%
Minimum Self Delegation: 1 SEI
Maximum Commission Rate: 20%
Maximum Commission Change Rate: 1% per day
File Locations
Understanding the purpose and location of important files helps with maintenance and troubleshooting:
$HOME/.sei/
├── config/
│ ├── app.toml # Application configuration
│ ├── client.toml # Client configuration
│ ├── config.toml # Tendermint configuration
│ ├── genesis.json # Chain genesis file
│ ├── node_key.json # Node identity key
│ └── priv_validator_key.json # Validator signing key
├── data/
│ ├── application.db # Application state
│ ├── blockstore.db # Block data
│ ├── cs.wal/ # Consensus write-ahead logs
│ ├── evidence.db # Evidence of misbehavior
│ ├── state.db # Tendermint state
│ └── tx_index.db # Transaction index
└── keyring-file/ # Local key storage
This reference guide provides essential technical information for operating Sei nodes and validators. For API documentation and other detailed specifications, please refer to the respective sections in our documentation set.