sei-load

Quick Start

1. Build

make build

2. Create Config

cp profiles/local.json my-config.json

{
 "endpoints": ["http://localhost:8545"],
 "chainId": 713714,
 "scenarios": [
 {"name": "EVMTransfer", "weight": 100}
 ],
 "accounts": {
 "count": 100,
 "newAccountRate": 0.1
 },
 "settings": {
 "workers": 5,
 "tps": 100,
 "statsInterval": "10s",
 "bufferSize": 1000,
 "trackUserLatency": true
 }
}

3. Run

./seiload --config my-config.json

Command Line Options

Examples

Basic Load Test

./seiload --config my-config.json --workers 5 --tps 100

High Throughput Test

./seiload --config my-config.json --workers 20 --buffer-size 2000

Debug Mode

./seiload --config my-config.json --debug --dry-run

With Receipt Tracking

./seiload --config my-config.json --track-receipts --track-blocks

User Latency Monitoring

./seiload --config my-config.json --track-user-latency --stats-interval 5s

Configuration

Basic Structure

{
 "endpoints": ["http://localhost:8545"],
 "chainId": 713714,
 "scenarios": [...],
 "accounts": {...},
 "settings": {...}
}

Scenarios

"scenarios": [
 {"name": "EVMTransfer", "weight": 50},
 {"name": "ERC20", "weight": 30},
 {"name": "ERC721", "weight": 20}
]

Account Management

"accounts": {
 "count": 100,
 "newAccountRate": 0.1
}

Settings

"settings": {
 "workers": 5,
 "tps": 100,
 "statsInterval": "10s",
 "bufferSize": 1000,
 "trackUserLatency": true
}

Available Scenarios

Output

Standard Metrics

throughput tps=133.00, txs=1330, latency(avg=8ms p50=5ms p99=27ms max=494ms)

User Latency (with --track-user-latency)

user latency height=5191 txs=32 min=1s p50=2s max=5s

Block Stats (with --track-blocks)

blocks height=5191 time(p50=2s p99=5s max=8s) gas(p50=21000 p99=50000 max=100000)

Development

Build

make build

Test

make test

Lint

make lint

Clean

make clean

Troubleshooting

Connection Issues

Low Performance

Memory Issues