# 0xkoiner/deterministic-deployer-evm architecture

> Architecture diagram of the GitHub repository 0xkoiner/deterministic-deployer-evm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/0xkoiner/deterministic-deployer-evm
- Repository: https://github.com/0xkoiner/deterministic-deployer-evm

## Overview

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: [`src/main.rs`](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/main.rs) (CLI entry), [`src/utils/deploy.rs`](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/deploy.rs) (Parallel deployment), [`src/helpers/pre_conditions.rs`](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/pre_conditions.rs) (Pre-flight checks), [`src/client/public_client.rs`](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/client/public_client.rs) (RPC client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_cli_entry["CLI entry<br/>[main.rs]"]
end

subgraph group_contracts["Contract inputs"]
  node_contract_search["Contract resolver"]
  node_registry["Contract registry<br/>[registry.rs]"]
  node_artifact["Artifact loader<br/>[artifact.rs]"]
  node_create2["CREATE2 address<br/>[create_2.rs]"]
  node_keystore["Encrypted keystore<br/>[create_keystore.rs]"]
end

subgraph group_chain["Chain access"]
  node_wallet["Wallet clients<br/>[wallet_client.rs]"]
  node_rpc_config["RPC configuration<br/>[init_rpc.rs]"]
  node_public_client["RPC client<br/>[public_client.rs]"]
end

subgraph group_deploy["Deployment"]
  node_prechecks["Pre-flight checks<br/>[pre_conditions.rs]"]
  node_code_check["Code checker<br/>[code_checker.rs]"]
  node_balance_check["Balance checker<br/>[balance_checker.rs]"]
  node_deployment["Parallel deployment<br/>[deploy.rs]"]
  node_explorer_config["Explorer links<br/>[init_explorers.rs]"]
end

subgraph group_verify["Verification"]
  node_verification["Source verification<br/>[verifier.rs]"]
end

node_operator(("Operator"))
node_evm_rpc{{"EVM RPC nodes"}}
node_deployer_contract{{"CREATE2 deployer"}}
node_etherscan{{"Etherscan API"}}
node_forge{{"Foundry forge"}}

node_operator -->|"runs"| node_cli_entry
node_cli_entry -->|"resolves input"| node_contract_search
node_contract_search -->|"looks up"| node_registry
node_cli_entry -->|"loads artifact"| node_artifact
node_registry -->|"computes address"| node_create2
node_cli_entry -->|"uses keystore"| node_keystore
node_cli_entry -->|"creates deployers"| node_wallet
node_wallet -->|"creates signed client"| node_public_client
node_public_client -->|"loads endpoint"| node_rpc_config
node_public_client -->|"sends RPC requests"| node_evm_rpc
node_cli_entry -->|"runs checks"| node_prechecks
node_prechecks -->|"checks code"| node_code_check
node_prechecks -->|"validates address"| node_create2
node_prechecks -->|"gets address link"| node_explorer_config
node_deployment -->|"checks balance"| node_balance_check
node_deployment -->|"checks deployed code"| node_code_check
node_cli_entry -->|"deploys in parallel"| node_deployment
node_deployment -->|"broadcasts CREATE2"| node_deployer_contract
node_deployment -->|"builds transaction links"| node_explorer_config
node_cli_entry -->|"requests verification"| node_verification
node_verification -->|"submits source"| node_etherscan
node_verification -->|"may invoke forge"| node_forge

click node_cli_entry "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/main.rs"
click node_contract_search "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/contract_searcher.rs"
click node_registry "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/data/contracts/registry.rs"
click node_artifact "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/artifact.rs"
click node_create2 "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/create_2.rs"
click node_keystore "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/create_keystore.rs"
click node_wallet "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/client/wallet_client.rs"
click node_rpc_config "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/init_rpc.rs"
click node_public_client "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/client/public_client.rs"
click node_prechecks "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/pre_conditions.rs"
click node_code_check "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/code_checker.rs"
click node_balance_check "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/balance_checker.rs"
click node_deployment "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/deploy.rs"
click node_explorer_config "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/init_explorers.rs"
click node_verification "https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/verifier.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli_entry toneBlue
class node_contract_search,node_registry,node_artifact,node_create2,node_keystore toneAmber
class node_wallet,node_rpc_config,node_public_client,node_etherscan toneMint
class node_prechecks,node_code_check,node_balance_check,node_deployment,node_explorer_config toneRose
class node_verification,node_operator,node_evm_rpc,node_deployer_contract,node_forge toneIndigo
```

## Components

### CLI workflow

- [CLI entry](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/main.rs): `src/main.rs`

### Contract inputs

- [Contract resolver](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/contract_searcher.rs): `src/helpers/contract_searcher.rs`
- [Contract registry](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/data/contracts/registry.rs): `src/data/contracts/registry.rs`
- [Artifact loader](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/artifact.rs): `src/utils/artifact.rs`
- [CREATE2 address](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/create_2.rs): `src/utils/create_2.rs`
- [Encrypted keystore](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/create_keystore.rs): `src/utils/create_keystore.rs`

### Chain access

- [Wallet clients](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/client/wallet_client.rs): `src/client/wallet_client.rs`
- [RPC configuration](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/init_rpc.rs): `src/utils/init_rpc.rs`
- [RPC client](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/client/public_client.rs): `src/client/public_client.rs`

### Deployment

- [Pre-flight checks](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/pre_conditions.rs): `src/helpers/pre_conditions.rs`
- [Code checker](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/code_checker.rs): `src/helpers/code_checker.rs`
- [Balance checker](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/helpers/balance_checker.rs): `src/helpers/balance_checker.rs`
- [Parallel deployment](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/deploy.rs): `src/utils/deploy.rs`
- [Explorer links](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/init_explorers.rs): `src/utils/init_explorers.rs`

### Verification

- [Source verification](https://github.com/0xkoiner/deterministic-deployer-evm/blob/main/src/utils/verifier.rs): `src/utils/verifier.rs`

### Other components

- **Operator**
- **EVM RPC nodes**
- **CREATE2 deployer**
- **Etherscan API**
- **Foundry forge**

## Connections

- Operator → CLI entry: runs (evidence: `README.md`)
- CLI entry → Contract resolver: resolves input (evidence: `src/helpers/contract_searcher.rs`)
- Contract resolver → Contract registry: looks up (evidence: `src/helpers/contract_searcher.rs`)
- CLI entry → Artifact loader: loads artifact (evidence: `README.md`)
- Contract registry → CREATE2 address: computes address (evidence: `src/data/contracts/registry.rs`)
- CLI entry → Encrypted keystore: uses keystore (evidence: `README.md`)
- CLI entry → Wallet clients: creates deployers (evidence: `README.md`)
- Wallet clients → RPC client: creates signed client (evidence: `src/client/wallet_client.rs`)
- RPC client → RPC configuration: loads endpoint (evidence: `src/client/public_client.rs`)
- RPC client → EVM RPC nodes: sends RPC requests (evidence: `src/client/public_client.rs`)
- CLI entry → Pre-flight checks: runs checks (evidence: `README.md`)
- Pre-flight checks → Code checker: checks code (evidence: `src/helpers/pre_conditions.rs`)
- Pre-flight checks → CREATE2 address: validates address (evidence: `src/helpers/pre_conditions.rs`)
- Pre-flight checks → Explorer links: gets address link (evidence: `src/helpers/pre_conditions.rs`)
- Parallel deployment → Balance checker: checks balance (evidence: `src/utils/deploy.rs`)
- Parallel deployment → Code checker: checks deployed code (evidence: `src/utils/deploy.rs`)
- CLI entry → Parallel deployment: deploys in parallel (evidence: `README.md`)
- Parallel deployment → CREATE2 deployer: broadcasts CREATE2 (evidence: `README.md`)
- Parallel deployment → Explorer links: builds transaction links (evidence: `src/utils/deploy.rs`)
- CLI entry → Source verification: requests verification (evidence: `README.md`)
- Source verification → Etherscan API: submits source (evidence: `src/utils/verifier.rs`)
- Source verification → Foundry forge: may invoke forge (evidence: `src/utils/verifier.rs`)
