# silo-finance/silo-contracts-v3 architecture

> Architecture diagram of the GitHub repository silo-finance/silo-contracts-v3, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/silo-finance/silo-contracts-v3
- Repository: https://github.com/silo-finance/silo-contracts-v3

## Overview

Silo V3 is a Solidity lending-protocol monorepo with core markets, oracle and vault packages, and related incentives, hooks, routing, and leverage functionality. The documented operator workflow is to prepare a market configuration, test a deployment on a local fork, then broadcast the deployment to a chain. Major contract subsystems are represented from the repository tree; their internal call relationships were not sampled, so no contract-to-contract call edges are asserted. The graph also includes the deployment-check scripts shown in the source index.

Main entry points: [`scripts/rpc_multicall.py`](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/rpc_multicall.py) (RPC multicall), [`silo-core/deploy/silo/SiloDeployWithDeployerOwner.s.sol`](https://github.com/silo-finance/silo-contracts-v3/blob/develop/silo-core/deploy/silo/SiloDeployWithDeployerOwner.s.sol) (Silo deploy script), [`scripts/check_deployments_admin_is_dao.py`](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_admin_is_dao.py) (Deployment checks), [`silo-core/deploy/input`](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/deploy/input) (Market configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deploy["Market deployment"]
  node_market_config["Market configuration"]
  node_market_import["CSV market import<br/>[marketImport.py]"]
  node_deploy_script["Silo deploy script"]
end

subgraph group_protocol["Lending protocol"]
  node_core_markets["Silo markets"]
  node_interest_models["Interest models"]
  node_silo_lens["Silo Lens"]
end

subgraph group_integrations["Protocol integrations"]
  node_oracle_contracts["Price oracles"]
  node_vault_contracts["Vaults"]
  node_hooks["Silo hooks"]
  node_incentives["Incentives"]
  node_router["Silo router"]
  node_leverage["Leverage"]
end

subgraph group_ops["Deployment checks"]
  node_deployment_checks["Deployment checks"]
  node_freshness_check["Broadcast freshness"]
  node_owner_check["DAO owner check"]
  node_version_check["On-chain versions"]
  node_rpc_multicall["RPC multicall<br/>[rpc_multicall.py]"]
  node_permissioned_deploy["Permissioned liquidation deploy"]
  node_liquidation_smoke["Liquidation smoke tests"]
  node_liquidation_sync["Incentive deployment sync"]
end

node_operator(("Protocol operator"))
node_chain[("EVM chain")]

node_operator -->|"prepares"| node_market_config
node_operator -->|"runs locally or broadcasts"| node_deploy_script
node_market_import -->|"produces JSON"| node_market_config
node_deploy_script -->|"deploys contracts"| node_chain
node_chain -.->|"provides deployment data"| node_deployment_checks
node_deployment_checks -->|"uses RPC helper"| node_rpc_multicall
node_freshness_check -->|"uses RPC helper"| node_rpc_multicall
node_owner_check -->|"uses RPC helper"| node_rpc_multicall
node_version_check -->|"uses RPC helper"| node_rpc_multicall
node_liquidation_smoke -->|"uses RPC helper"| node_rpc_multicall
node_liquidation_sync -->|"uses RPC helper"| node_rpc_multicall

click node_market_config "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/deploy/input"
click node_market_import "https://github.com/silo-finance/silo-contracts-v3/blob/develop/silo-core/deploy/input/_importFromCsv/marketImport.py"
click node_deploy_script "https://github.com/silo-finance/silo-contracts-v3/blob/develop/silo-core/deploy/silo/SiloDeployWithDeployerOwner.s.sol"
click node_core_markets "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts"
click node_interest_models "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/interestRateModel"
click node_silo_lens "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts"
click node_oracle_contracts "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-oracles/contracts"
click node_vault_contracts "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-vaults"
click node_hooks "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/hooks"
click node_incentives "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/incentives"
click node_router "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/silo-router"
click node_leverage "https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/leverage"
click node_deployment_checks "https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_admin_is_dao.py"
click node_freshness_check "https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_freshness_from_broadcast.py"
click node_owner_check "https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_owner_is_dao.py"
click node_version_check "https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_version_on_chain.py"
click node_rpc_multicall "https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/rpc_multicall.py"
click node_permissioned_deploy "https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/tasks/set-permissioned-liquidation/4_deploy_permissioned_liquidation_controllers.py"
click node_liquidation_smoke "https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/tasks/set-permissioned-liquidation/6_test_permissioned_liquidation.py"
click node_liquidation_sync "https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/tasks/set-permissioned-liquidation/7_sync_failed_with_incentive_deployments.py"

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_market_config,node_market_import,node_deploy_script toneBlue
class node_core_markets,node_interest_models,node_silo_lens,node_chain toneAmber
class node_oracle_contracts,node_vault_contracts,node_hooks,node_incentives,node_router,node_leverage toneMint
class node_deployment_checks,node_freshness_check,node_owner_check,node_version_check,node_rpc_multicall,node_permissioned_deploy,node_liquidation_smoke,node_liquidation_sync toneRose
class node_operator toneIndigo
```

## Components

### Market deployment

- [Market configuration](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/deploy/input): `silo-core/deploy/input`
- [CSV market import](https://github.com/silo-finance/silo-contracts-v3/blob/develop/silo-core/deploy/input/_importFromCsv/marketImport.py): `silo-core/deploy/input/_importFromCsv/marketImport.py`
- [Silo deploy script](https://github.com/silo-finance/silo-contracts-v3/blob/develop/silo-core/deploy/silo/SiloDeployWithDeployerOwner.s.sol): `silo-core/deploy/silo/SiloDeployWithDeployerOwner.s.sol`

### Lending protocol

- [Silo markets](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts): `silo-core/contracts`
- [Interest models](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/interestRateModel): `silo-core/contracts/interestRateModel`
- [Silo Lens](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts): `silo-core/contracts`

### Protocol integrations

- [Price oracles](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-oracles/contracts): `silo-oracles/contracts`
- [Vaults](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-vaults): `silo-vaults`
- [Silo hooks](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/hooks): `silo-core/contracts/hooks`
- [Incentives](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/incentives): `silo-core/contracts/incentives`
- [Silo router](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/silo-router): `silo-core/contracts/silo-router`
- [Leverage](https://github.com/silo-finance/silo-contracts-v3/tree/develop/silo-core/contracts/leverage): `silo-core/contracts/leverage`

### Deployment checks

- [Deployment checks](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_admin_is_dao.py): `scripts/check_deployments_admin_is_dao.py`
- [Broadcast freshness](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_freshness_from_broadcast.py): `scripts/check_deployments_freshness_from_broadcast.py`
- [DAO owner check](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_owner_is_dao.py): `scripts/check_deployments_owner_is_dao.py`
- [On-chain versions](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/check_deployments_version_on_chain.py): `scripts/check_deployments_version_on_chain.py`
- [RPC multicall](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/rpc_multicall.py): `scripts/rpc_multicall.py`
- [Permissioned liquidation deploy](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/tasks/set-permissioned-liquidation/4_deploy_permissioned_liquidation_controllers.py): `scripts/tasks/set-permissioned-liquidation/4_deploy_permissioned_liquidation_controllers.py`
- [Liquidation smoke tests](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/tasks/set-permissioned-liquidation/6_test_permissioned_liquidation.py): `scripts/tasks/set-permissioned-liquidation/6_test_permissioned_liquidation.py`
- [Incentive deployment sync](https://github.com/silo-finance/silo-contracts-v3/blob/develop/scripts/tasks/set-permissioned-liquidation/7_sync_failed_with_incentive_deployments.py): `scripts/tasks/set-permissioned-liquidation/7_sync_failed_with_incentive_deployments.py`

### Other components

- **Protocol operator**
- **EVM chain**

## Connections

- Protocol operator → Market configuration: prepares (evidence: `README.md`)
- Protocol operator → Silo deploy script: runs locally or broadcasts (evidence: `README.md`)
- CSV market import → Market configuration: produces JSON (evidence: `silo-core/deploy/input/_importFromCsv/marketImport.py`)
- Silo deploy script → EVM chain: deploys contracts (evidence: `README.md`)
- EVM chain → Deployment checks: provides deployment data
- Deployment checks → RPC multicall: uses RPC helper (evidence: `scripts/check_deployments_admin_is_dao.py`)
- Broadcast freshness → RPC multicall: uses RPC helper (evidence: `scripts/check_deployments_freshness_from_broadcast.py`)
- DAO owner check → RPC multicall: uses RPC helper (evidence: `scripts/check_deployments_owner_is_dao.py`)
- On-chain versions → RPC multicall: uses RPC helper (evidence: `scripts/check_deployments_version_on_chain.py`)
- Liquidation smoke tests → RPC multicall: uses RPC helper (evidence: `scripts/tasks/set-permissioned-liquidation/6_test_permissioned_liquidation.py`)
- Incentive deployment sync → RPC multicall: uses RPC helper (evidence: `scripts/tasks/set-permissioned-liquidation/7_sync_failed_with_incentive_deployments.py`)
