How foundry-rs/foundry works
Foundry is a Rust toolkit for Ethereum development, centered on Forge, Cast, Anvil, and Chisel. A developer can build and test Solidity projects with Forge, inspect or interact with chains using Cast, run a local node with Anvil, and experiment interactively in Chisel. Shared EVM execution, compilation, configuration, and trace facilities support those workflows. The README documents the major product capabilities; the tree supports subsystem placement, but unsampled implementation details do not establish additional call relationships.
Main entry points: src/args.rs Forge commands · src/args.rs Cast commands · build.rs Build and compile · mod.rs Chain backend
Components 28
Forge
- Forge CLI
crates/forge/bin/main.rs - Forge commands
crates/forge/src/args.rs - Build and compile
crates/forge/src/cmd/build.rs - Test and fuzz
crates/forge/src/runner.rs - Debug and inspect
crates/debugger/src/debugger.rs - Editor integration
crates/forge/src/cmd/lsp.rs
Cast
- Cast CLI
crates/cast/bin/main.rs - Cast commands
crates/cast/src/args.rs - Chain RPC
crates/cast/src/cmd/rpc.rs - Transactions
crates/cast/src/cmd/send.rs - Chain queries
crates/cast/src/cmd/call.rs - Storage decoding
crates/cast/src/cmd/storage.rs
Anvil
- Anvil CLI
crates/anvil/bin/main.rs - Node service
crates/anvil/src/service.rs - RPC handlers
crates/anvil/src/server/rpc_handlers.rs - Chain backend
crates/anvil/src/eth/backend/mod.rs - Block state
crates/anvil/src/eth/backend/mem/storage.rs
Chisel
- Chisel CLI
crates/chisel/bin/main.rs - REPL dispatcher
crates/chisel/src/dispatcher.rs - REPL session
crates/chisel/src/session.rs - Code execution
crates/chisel/src/executor.rs
Shared runtime
- Solidity compilation
crates/common/src/compile.rs - EVM execution
crates/evm/core/src/evm/mod.rs - Execution traces
crates/evm/traces/src/lib.rs
Other components
- Developer
- Ethereum RPC
- Ethereum network
- Solidity project
Connections 33
- Developer → Forge CLI: invokes
- Forge CLI → Forge commands: runs
- Forge commands → Build and compile: dispatches
- Forge commands → Test and fuzz: dispatches
- Forge commands → Debug and inspect: dispatches
- Forge commands → Editor integration: dispatches
- Build and compile → Solidity compilation: compiles
- Test and fuzz → EVM execution: executes tests
- Debug and inspect → Execution traces: uses traces
- Developer → Cast CLI: invokes
- Cast CLI → Cast commands: runs
- Cast commands → Chain RPC: dispatches
- Cast commands → Transactions: dispatches
- Cast commands → Chain queries: dispatches
- Cast commands → Storage decoding: dispatches
- Chain RPC → Ethereum RPC: sends requests
- Transactions → Ethereum RPC: broadcasts transactions
- Chain queries → Ethereum RPC: queries
- Storage decoding → Ethereum RPC: reads slots
- Ethereum RPC → Ethereum network: connects to
- Developer → Anvil CLI: starts
- Anvil CLI → Node service: runs
- Node service → RPC handlers: serves
- RPC handlers → Chain backend: handles requests
- Chain backend → EVM execution: executes transactions
- Chain backend → Block state: reads and writes
- Developer → Chisel CLI: invokes
- Chisel CLI → REPL dispatcher: runs
- REPL dispatcher → REPL session: manages
- REPL dispatcher → Code execution: dispatches
- Code execution → Solidity compilation: compiles input
- Code execution → EVM execution: executes input
- Build and compile → Solidity project: builds