Imported from ethereum/state-actor (
AGENTS.md). Install upstream withnpx skills add ethereum/state-actor. Copyright stays with the author.
AGENTS.md
state-actor generates client-ready Ethereum databases for geth, reth, besu, nethermind, ethrex, and erigon without going through each client's init path.
The agent-facing canonical doc is docs/SKILL.md — read it first. This file is a pointer.
[!IMPORTANT] The canonical reference for everything
--speccan express isexamples/full-matrix-spec-feature.yaml. CI keeps it correct:TestBuildFullMatrixpins the 22-entity count and the cross-clientPreAlloccount equality (byte-identity is enforced downstream by the cross-client-genesis-root aggregator job); every per-clientTestE2ESuiteloads it. If you need to know what shape a spec can take, read that file first — it is the syntax reference.docs/SPEC.mdis the schema reference; read them together.
Quick pointers
| Topic | Where |
|---|---|
| How to do common tasks (with full recipes) | docs/SKILL.md |
| Spec YAML schema reference | docs/SPEC.md |
| Client boot recipes (per-client) | docs/RUNBOOK.md |
Internal architecture; per-package doc.go |
docs/ARCHITECTURE.md |
| Example specs (with picker) | examples/README.md |
| Canonical syntax reference (every feature, CI-pinned — see callout above) | examples/full-matrix-spec-feature.yaml |
| Full CLI flag list | state-actor --help |
Three load-bearing flags
--client (which client format to write), --spec (YAML state declaration), --target-size (upper bound on the whole DB). Everything else has a sane default.
Tool-specific notes
- Claude Code also reads
CLAUDE.md, which redirects here. - Cursor, Codex, Aider, Gemini CLI:
AGENTS.mdis the open standard you're reading.