> For the complete documentation index, see [llms.txt](https://docs.liquidcollective.io/eth/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts.md).

# Smart Contracts

Per-contract reference for the deployed Liquid Collective protocol

Reference documentation for the Liquid Collective protocol contracts, generated from the contract NatSpec in [liquid-collective-protocol](https://github.com/liquid-collective/liquid-collective-protocol).

The core contracts are:

| Contract                                                                                                               | Role                                                                                                                                         |
| ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [RiverV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/riverv1.md)                         | The protocol's core contract and the LsETH ERC-20. Holds the deposit buffer, commits ETH to the consensus layer, and applies oracle reports. |
| [OperatorsRegistryV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/operatorsregistryv1.md) | Registry of Node Operators and their validator keys; selects keys to fund and signals exits.                                                 |
| [OracleV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/oraclev1.md)                       | Collects quorum-based consensus layer reports from Oracle Operators.                                                                         |
| [RedeemManagerV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/redeemmanagerv1.md)         | The redemption queue and withdrawal stack for converting LsETH back to ETH.                                                                  |
| [WithdrawV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/withdrawv1.md)                   | Receives skimmed and withdrawn ETH from the consensus layer. Validator withdrawal credentials point here.                                    |
| [AllowlistV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/allowlistv1.md)                 | The KYC/AML permission list governing protocol access.                                                                                       |
| [CoverageFundV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/coveragefundv1.md)           | Holds funds used to cover slashing penalties.                                                                                                |
| [ELFeeRecipientV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/elfeerecipientv1.md)       | Receives execution layer fees, including MEV.                                                                                                |
| [TLCV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/tlcv1.md)                             | The TLC governance token and its vesting schedules.                                                                                          |
| [ProtocolMetricsV1](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/protocolmetricsv1.md)     | Exposes protocol-level metrics such as the conversion rate.                                                                                  |

Supporting contracts — [Administrable](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/administrable.md), [Firewall](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/firewall.md), [Initializable](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/initializable.md), and [TUPProxy](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/tupproxy.md) — provide access control, upgradeability, and initialization.

The remaining subsections document [Components](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/components.md) (shared logic inherited by the core contracts), [Interfaces](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/interfaces.md), [Libraries](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/libraries.md), and [State](https://docs.liquidcollective.io/eth/technical-reference/smart-contracts/state.md) (the unstructured storage slots each contract uses).
