> ## Documentation Index
> Fetch the complete documentation index at: https://superform-cb7ef652-docs-manager-controls-language.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SuperVaults

> ERC-7540 tokenized vaults with operator-managed yield strategies, Merkle-verified execution, and validator-secured price-per-share.

SuperVaults are ERC-7540 tokenized vaults that let operators manage yield strategy execution through protocol-bounded roles. Depositors supply assets to vault contracts; operators configure and execute approved strategy actions within Merkle, PPS, fee, slippage, timelock, and accounting constraints.

## Key Properties

* **Non-custodial** — Depositor funds live in vault contracts, not operator-controlled wallets
* **ERC-4626 compatible** — Standard deposit/withdraw interface with async ERC-7540 extensions for cross-chain and illiquid positions
* **Merkle-verified execution** — Keepers can only call hooks that match leaves in the onchain Merkle tree
* **Automated operations** — Workers handle any actions, from deposits, redemptions, reward claims, swaps, and transaction management
* **Oracle-secured PPS** — Price-per-share is computed by validators, signed as EIP-712 typed data, and accepted onchain only after two-thirds weighted consensus

## How SuperVaults Work

<Steps>
  <Step title="Depositor Requests">
    A depositor submits a deposit or redemption request onchain via the ERC-7540 interface.
  </Step>

  <Step title="Keeper Workers Execute">
    Seven automated workers process requests: allocating deposits to configured yield sources, fulfilling redemptions, claiming rewards, and executing swaps.
  </Step>

  <Step title="Operator Manages Strategy">
    The operator sets allocation priorities, defines automated rebalancing rules, configures Merkle authorization for keeper operations, and monitors vault health within protocol-enforced constraints.
  </Step>

  <Step title="Validators Secure PPS">
    Off-chain validators compute price-per-share, sign EIP-712 attestations, and anyone can submit the update onchain. The oracle accepts updates only with supermajority validator consensus.
  </Step>
</Steps>

## Security Model

SuperVaults enforce safety at every layer:

* **Double-Merkle hook allowlisting and blacklisting** at both global and strategy levels ensures vaults can only perform pre-approved actions like depositing, redeeming, swapping, and bridging. Hook-root updates are proposal based, with the aggregator hook-root timelock defaulting to 15 minutes, and keepers still cannot execute anything outside approved leaves.
* **Clear role separation** across Managers, Validators, and Guardians. Managers operate through pre-approved hooks, validators attest price-per-share, and guardians retain emergency intervention powers such as pause controls.
* **Validator-signed price-per-share (PPS)** with quorum, signature, staleness, and deviation checks enforced onchain.
* **Timelocked sensitive parameters** such as fee changes, PPS expiration threshold updates, active PPS oracle changes after first set, and some governance actions, while other operational controls remain immediate.
* **Automated emergency controls** provide pause functionality, banned leaves, and emergency withdrawal paths using authorized hooks.

Managers cannot execute arbitrary calldata or withdraw depositor assets to arbitrary destinations. Secondary managers, session keys, and keepers are limited to role-authorized actions and pre-authorized Merkle leaves. Emergency withdrawal hooks are de-risking paths that move positions back through strategy/vault accounting, and redemption fulfillment remains bounded by ERC-7540 request state, PPS, slippage expectations, fee logic, and accounting updates.

## Efficiency

SuperVaults are engineered for scale:

* **Native ERC-7540 compliance** enables efficient flows for low-cost deposits and async withdrawals as well as onchain composability.
* **Cross-chain deposits** via the SuperBundler support 8+ networks with a single signature.
* **Modular hook engine** allows SuperVaults to access any yield source. Strategies can evolve as markets do, without redeployments or protocol upgrades.

## Transparency

Depositors do not have to trust; they can verify:

* A **live transparency dashboard** surfaces allocations, caps, validator signatures, and performance in real time.
* **PPS can be recomputed by anyone**, onchain or offchain, with circuit breakers that pause abnormal behavior automatically.
* All **underlying protocols can continuously be monitored** for exploit vectors and governance risk, and quickly allocated out of if needed.

## Architecture

<Frame>
  <img src="https://mintcdn.com/superform-cb7ef652-docs-manager-controls-language/b1KatBfnfrR0ywGC/images/supervault-architecture.png?fit=max&auto=format&n=b1KatBfnfrR0ywGC&q=85&s=eccccd09e56bfb3f9dc2b3e671f36613" alt="SuperVault Architecture" width="897" height="620" data-path="images/supervault-architecture.png" />
</Frame>

The architecture comprises three systems: vault triads, governance coordination, and PPS validation.

### Vault Triads

Each SuperVault deployment consists of three onchain contracts managed through the **SuperVaultAggregator** (factory, registry, PPS oracle forwarding, upkeep accounting, and governor-level constraints):

| Contract               | Purpose                                                                                                                                                             |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **SuperVault**         | ERC-7540 vault that holds depositor assets and issues share tokens. Entry-point for synchronous deposits and asynchronous redeems.                                  |
| **SuperVaultStrategy** | Execution engine that manages hook authorization via dual Merkle roots, tracks PPS high water mark, queues/fulfills redemption requests, and enforces fee policies. |
| **Escrow**             | Holds user shares during pending redemptions (allowing cancellation) and assets during fulfillment claims.                                                          |

### Governance & Coordination

| Component         | Role                                                                                                                                               |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **\$UP Token**    | Protocol token used for governance via sUP, funds SuperVault upkeep for PPS update writes, and gains validator-bonding utility in later phases.    |
| **SuperGovernor** | Central registry and access control hub. Manages role-based permissions, selected timelocked parameter updates, and emergency intervention powers. |
| **SuperBank**     | Protocol treasury that handles protocol fees and executes governance-approved hook operations.                                                     |

### PPS Validation

| Component             | Role                                                                                                                                       |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **ECDSAPPSOracle**    | Validates price-per-share updates using ECDSA signatures and forwards validated updates to the Aggregator.                                 |
| **Validator Network** | Validators monitor PPS updates and submit attestations, with consensus, signature, and quorum checks enforced before updates are accepted. |

## Supported Yield Sources

| Type        | Description              | Example                          |
| ----------- | ------------------------ | -------------------------------- |
| `erc4626`   | Standard ERC-4626 vaults | Morpho, Aave wrappers, Euler     |
| `pendle_pt` | Pendle Principal Tokens  | Fixed-rate yield via PT purchase |

ERC-7540 yield sources (async vaults) are on the roadmap.

## Live Deployments

SuperVaults are live on **Ethereum** and **Base** with flagship vaults for USDC, WETH, and WBTC. See [Deployment Addresses](/deployment-addresses) for the full contract list.

## Next Steps

<CardGroup cols={2}>
  <Card title="Transaction Lifecycle" icon="arrows-spin" href="/learn/supervaults/transaction-lifecycle">
    End-to-end flow from deposit request to yield accrual.
  </Card>

  <Card title="Economics" icon="chart-pie" href="/learn/supervaults/economics">
    Fee structure, \$UP upkeep, and protocol revenue.
  </Card>

  <Card title="Operate with SuperformOS" icon="gauge-high" href="/operate">
    Full technical guide for teams operating vaults.
  </Card>
</CardGroup>
