spamoor CLAUDE.md

Project instructions for Spamoor, an Ethereum transaction spammer used to generate test transactions on Ethereum test networks.

In plain words
What is it for?
Use them when modifying Spamoor, its components, tests, build or deployment settings, or documentation, including its command-line, daemon, and REST API areas.
Why use it?
They give coding agents the project’s required structure, standards, development process, and documentation rules before changes are made.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/ethpandaops/spamoor/claude-md
Clone the repo
git clone --depth 1 https://github.com/ethpandaops/spamoor
Per session 868 This file is loaded in full into every session.
When invoked 868 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00868 $0.00868
Opus 5 $0.00434 $0.00434
Sonnet 5 $0.00174 $0.00174
Haiku 4.5 $0.00087 $0.00087

Measured yesterday against content hash f456b194cd2d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

spamoor CLAUDE.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **`docs/api-consumers.md`**: REST API documentation with bash/curl examples for all endpoints
CLAUDE.md · 73 lines

How it starts

The opening of the file, as written. The whole thing — 73 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Spamoor - Ethereum Transaction Spammer

Spamoor is a powerful tool for generating various types of random transactions on Ethereum testnets. It provides a modular, scenario-based architecture for stress testing, network validation, and continuous transaction testing.

Project Structure

Claude MUST read the .cursor/rules/project_architecture.mdc file before making any structural changes to the project.

Code Standards

Claude MUST read the .cursor/rules/code_standards.mdc file before writing any code in this project.

Development Workflow

Claude MUST read the .cursor/rules/development_workflow.mdc file before making changes to build, test, or deployment configurations.

Component Documentation

Individual components have their own CLAUDE.md files with component-specific rules. Always check for and read component-level documentation when working on specific parts of the codebase.

User Documentation

Comprehensive documentation is available in the docs/ directory for different user types:

  • docs/app-users.md: Complete guide for CLI usage, daemon mode, configuration, and troubleshooting
  • docs/api-consumers.md: REST API documentation with bash/curl examples for all endpoints
  • docs/scenario-developers.md: Comprehensive guide for implementing custom transaction scenarios

Before working on any scenario development or API integration, Claude MUST read the relevant documentation files to understand:

  • Critical development rules (no root wallet usage, proper nonce management, etc.)
  • Wallet management patterns and selection strategies
  • Transaction building and submission methods
  • Contract interaction patterns using abigen with BuildBoundTx
  • Balance management for internal transfers
  • Best practices for context handling, logging, and configuration

Key Features

  • Multiple Scenarios: 12+ different transaction types including EOA, ERC20, blob transactions, contract deployments, and more
  • Daemon Mode: Web-based interface for managing multiple concurrent spammers
  • Modular Architecture: Easy to extend with new scenario types
  • Docker Support: Containerized deployment and development
  • DevNet Integration: Quick development environment with make devnet-run
  • Metrics Collection: Prometheus integration for monitoring
  • Flexible Configuration: YAML files and command-line flags

Read the full file on GitHub · 73 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 73 lines · 868 tokens per session scan A f456b194cd2d

Subscribe to this mod's changes

spamoor CLAUDE.md is an instructions file published in the GitHub repository ethpandaops/spamoor (79 stars, last pushed 3d ago), licensed MIT. It adds 868 tokens to every session, about $0.0043 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.