Contender

High-performance Ethereum transaction spammer and benchmarking tool.

🚀 Quick Start

Install:

cargo install --git https://github.com/flashbots/contender --locked

Run a simple spam scenario:

contender spam --tps 50 -r $RPC_URL fill-block

Run a bundled scenario from the repo:

contender setup scenario:stress.toml -r $RPC_URL -p $PRIVATE_KEY
contender spam  scenario:stress.toml -r $RPC_URL --tps 10 -d 3

See examples for more usage patterns.

⚙️ Prerequisites

• Rust toolchain (latest stable)
• SQLite development headers (libsqlite3-dev on Linux)
• A JSON-RPC endpoint for the target Ethereum node

📚 Docs

Contender is a high-performance Ethereum transaction spammer and benchmarking tool, built for repeatable load tests against EL clients and live networks. It supports both per-second (TPS) and per-block (TPB) timing, seeded fuzzing for reproducibility, and SQLite-backed state for contracts, runs, and reports.

1. Introduction

• Overview

2. Getting Started

• Installation
• CLI Reference
• Example Commands

3. Writing Scenarios

• Scenario File Structure
• Placeholders
• Creating a New Scenario

4. Advanced Usage

• Engine API Spamming
• Reports, Database, and Admin Tools
• Using Contender as a Library

5. Internals

• Architecture