Skip to main content

Benchmark your blockchain infrastructure

Flexible load testing tool for blockchain nodes. Test Ethereum, Solana, and 14+ chains with real data, custom profiles, and powerful monitoring.

Get startedLearn more

Quick start

Get up and running with Chainbench in minutes

1

Install Chainbench

Install via pip or Poetry to get started quickly.
pip
pip install chainbench
Poetry
poetry add chainbench
Requires Python 3.10+ and Poetry 1.7+
2

Run your first test

Start a simple benchmark against your blockchain node.
chainbench start eth_blockNumber \
  --users 50 \
  --workers 2 \
  --test-time 5m \
  --target https://your-node-url \
  --headless \
  --autoquit
This runs a 5-minute load test with 50 simulated users calling eth_blockNumber.
3

View results

Results are automatically saved to the ./results directory with detailed metrics including:
  • Request rates and response times
  • Failure rates and error types
  • Percentile distributions (50th, 75th, 95th, 99th)
  • Time-series data for visualization
For web UI mode, omit the --headless flag to access real-time metrics at http://localhost:8089.

Explore by topic

Everything you need to benchmark blockchain infrastructure

Core concepts

Learn about profiles, test data, load shapes, and monitoring

Supported blockchains

Built-in support for Ethereum, Solana, BSC, Polygon, and more

Command reference

Complete reference for all commands and options

Custom profiles

Create custom profiles for any EVM-compatible blockchain

Key features

Built for comprehensive blockchain infrastructure testing

🔗

14+ blockchain profiles

Pre-configured profiles for Ethereum, BSC, Polygon, Solana, Base, Arbitrum, Avalanche, and more

📊

Dynamic test data

Generate call parameters from real chain data for realistic load testing scenarios

🎯

Flexible load patterns

Built-in ramp-up, step, and spike patterns to simulate different traffic scenarios

📈

Real-time monitoring

Web UI mode with live metrics or headless mode for automated testing pipelines

Resources

Learn more about Chainbench and get involved

GitHub repository

View source code, report issues, and contribute

Contributing guide

Learn how to contribute to Chainbench development

Chainstack platform

Deploy and manage blockchain infrastructure

Ready to benchmark your nodes?

Install Chainbench and start load testing your blockchain infrastructure in minutes

Get started