Spamoor the Transaction Spammer

Spamoor is a powerful tool for generating various types of random transactions on Ethereum testnets. Perfect for stress testing, network validation, or continuous transaction testing.

Quick Start

# Using Docker
docker run ethpandaops/spamoor

# Building from source
git clone https://github.com/ethpandaops/spamoor.git
cd spamoor
make
./bin/spamoor

Usage

spamoor <scenario> [flags]

All scenarios require:

• --privkey - Private key for the sending wallet
• --rpchost - RPC endpoint(s) to send transactions to

Scenarios

Spamoor provides multiple scenarios for different transaction types:

Daemon Mode

Spamoor also includes a daemon mode with web UI for managing multiple spammers. It allows you to create, monitor, and control spammers through a user interface or programmatically via HTTP endpoints.

Usage

spamoor-daemon [flags]

Flags

-d, --db string         The file to store the database in (default "spamoor.db")
    --debug             Run the tool in debug mode
-h, --rpchost strings   The RPC host to send transactions to
    --rpchost-file      File with a list of RPC hosts to send transactions to
-p, --privkey string    The private key of the wallet to send funds from
-P, --port int          The port to run the webui on (default 8080)
-v, --verbose           Run the tool with verbose output
    --trace             Run the tool with tracing output

Web Interface

The web interface runs on http://localhost:8080 by default and provides:

• Dashboard for managing spammers
• Real-time log streaming
• Configuration management
• Start/pause/delete functionality

API

The daemon exposes a REST API for programmatic control. See the API Documentation in the spamoor web interface for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.