How 0xkoiner/deterministic-deployer-evm works
This Rust CLI deploys contracts deterministically to selected EVM chains, optionally verifying source code afterward. The documented workflow selects a registry contract or Foundry artifact, configures chain-specific clients, runs pre-flight checks and gas simulation, broadcasts deployments in parallel, then can submit verification and provide explorer links. Source excerpts show client construction, contract lookup, CREATE2 checks, pre-checks, and verifier integrations; deployment orchestration details are limited to README documentation and the SOURCE INDEX.
Main entry points: main.rs CLI entry · deploy.rs Parallel deployment · pre_conditions.rs Pre-flight checks · public_client.rs RPC client
Components 20
CLI workflow
- CLI entry
src/main.rs
Contract inputs
- Contract resolver
src/helpers/contract_searcher.rs - Contract registry
src/data/contracts/registry.rs - Artifact loader
src/utils/artifact.rs - CREATE2 address
src/utils/create_2.rs - Encrypted keystore
src/utils/create_keystore.rs
Chain access
- Wallet clients
src/client/wallet_client.rs - RPC configuration
src/utils/init_rpc.rs - RPC client
src/client/public_client.rs
Deployment
- Pre-flight checks
src/helpers/pre_conditions.rs - Code checker
src/helpers/code_checker.rs - Balance checker
src/helpers/balance_checker.rs - Parallel deployment
src/utils/deploy.rs - Explorer links
src/utils/init_explorers.rs
Verification
- Source verification
src/utils/verifier.rs
Other components
- Operator
- EVM RPC nodes
- CREATE2 deployer
- Etherscan API
- Foundry forge
Connections 22
- Operator → CLI entry: runs
README.md - CLI entry → Contract resolver: resolves input
src/helpers/contract_searcher.rs - Contract resolver → Contract registry: looks up
src/helpers/contract_searcher.rs - CLI entry → Artifact loader: loads artifact
README.md - Contract registry → CREATE2 address: computes address
src/data/contracts/registry.rs - CLI entry → Encrypted keystore: uses keystore
README.md - CLI entry → Wallet clients: creates deployers
README.md - Wallet clients → RPC client: creates signed client
src/client/wallet_client.rs - RPC client → RPC configuration: loads endpoint
src/client/public_client.rs - RPC client → EVM RPC nodes: sends RPC requests
src/client/public_client.rs - CLI entry → Pre-flight checks: runs checks
README.md - Pre-flight checks → Code checker: checks code
src/helpers/pre_conditions.rs - Pre-flight checks → CREATE2 address: validates address
src/helpers/pre_conditions.rs - Pre-flight checks → Explorer links: gets address link
src/helpers/pre_conditions.rs - Parallel deployment → Balance checker: checks balance
src/utils/deploy.rs - Parallel deployment → Code checker: checks deployed code
src/utils/deploy.rs - CLI entry → Parallel deployment: deploys in parallel
README.md - Parallel deployment → CREATE2 deployer: broadcasts CREATE2
README.md - Parallel deployment → Explorer links: builds transaction links
src/utils/deploy.rs - CLI entry → Source verification: requests verification
README.md - Source verification → Etherscan API: submits source
src/utils/verifier.rs - Source verification → Foundry forge: may invoke forge
src/utils/verifier.rs