EVM Transaction Spammer

High-performance transaction load generator for EVM networks.

Documentation

Read the full documentation here: https://tx-spammer.vercel.app/

The documentation includes:

• Architecture: How the SpamOrchestrator, Worker Pool, and GasGuardian work together.
• Strategies: Configuring Mixed, Write, Read, and Deploy strategies.
• Reference: Full TypeScript API documentation.

Quick Start

Installation

npm install @developeruche/tx-spammer-sdk

Usage

import { SpamOrchestrator } from '@developeruche/tx-spammer-sdk';
import { parseEther } from 'viem';

const orchestrator = new SpamOrchestrator({
    rpcUrl: 'http://127.0.0.1:8545',
    maxGasLimit: 29_000_000n,
    concurrency: 50, // 50 concurrent workers
    strategy: {
        mode: 'transfer',
        amountPerTx: parseEther('0.001')
    }
}, process.env.PRIVATE_KEY);

await orchestrator.setup(parseEther('1')); // Fund workers
await orchestrator.start(); // Unleash the flood

Features

• Mass Concurrency: Spawns hundreds of lightweight, ephemeral wallets.
• Gas Guardian: Atomic state management to enforce strict block/sequence gas limits.
• Mixed Strategy: Define complex load profiles (e.g., "60% Writes, 30% Reads, 10% Deploys").
• Zero Config: Works out-of-the-box with Anvil and other Foundry tools.

Development

# Install dependencies
pnpm install

# Build SDK
pnpm --filter sdk build

# Run Docs
pnpm --filter docs dev