alloy-node-bindings

Builders for launching local Anvil, Geth, and Reth child processes.

The node binaries are not bundled: install them on PATH, or select an executable explicitly with the builder's at or path method. Prefer try_spawn when startup failures should be returned; spawn unwraps the result and therefore panics on any startup error. try_spawn waits until the node's startup output reports its RPC service ready before returning an instance handle. Readiness output is consumed synchronously, so a live child that emits no newline can delay a configured startup timeout.

use alloy_node_bindings::Anvil;

# fn main() -> Result<(), alloy_node_bindings::NodeError> {
let anvil = Anvil::new().try_spawn()?;
println!("Anvil is listening at {}", anvil.endpoint());

// Dropping the handle shuts down the child process.
drop(anvil);
# Ok(())
# }

Keep the returned instance alive for as long as the node is needed. Anvil and Geth default their HTTP port to zero; use the returned instance's port or endpoint method to read the OS-assigned port.