To deploy a new Aave Earn Vault, follow these steps:
Vaults deployed through other methods will not be surfaced via Aave Labs' API or SDKs.
First, determine which reserve you want your vault to be based on.
Let's say we choose the WETH supply reserve of an Ethereum market.
Reserve
const reserve: Reserve = { __typename: "Reserve", market: { __typename: "MarketInfo", address: "0x87870bca3f3fd6335c3f4ce8392d69350b4fa4e2", chainId: 1, // … }, underlyingToken: { __typename: "Currency", symbol: "WETH", name: "Wrapped Ether", address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // … }, isFrozen: false, isPaused: false, // …};Ensure the reserve is not frozen or paused.
Next, define the configuration for deploying the vault.
The initialLockDeposit is permanently locked in the vault and cannot be withdrawn. It protects against inflation attacks by ensuring the share price cannot be manipulated immediately after deployment — and the protection strengthens as TVL grows.
The amount is derived from a TARGET_DONATION: the minimum raw asset units an attacker would need to donate to double the share price at deployment. A higher TARGET_DONATION raises the attack cost. Setting it to 1_000_000 raw units is a conservative default that is cheap for most assets while remaining meaningful.
initialLockDeposit = max(TARGET_DONATION / 10^decimals, 1e-9)
// With TARGET_DONATION = 1_000_000:// USDC (6 dec) → 1 USDC// WETH (18 dec) → 0.000000001 WETHYou can tune TARGET_DONATION upward for higher-value assets or increase it if you want a stronger guarantee at vault launch.
- React
- TypeScript
- GraphQL
The minimal configuration to deploy a vault is:
Minimal Configuration
import { bigDecimal, evmAddress, VaultDeployRequest } from "@aave/react";
// …
const request: VaultDeployRequest = { market: reserve.market.address, chainId: reserve.market.chain.chainId, underlyingToken: reserve.underlyingToken.address, deployer: evmAddress(walletClient!.account.address), // owner: evmAddress("0x1234…"), if different from deployer initialFee: bigDecimal(0), // 0% performance fee shareName: "Aave WETH Vault Shares", shareSymbol: "avWETH", initialLockDeposit: bigDecimal(0.000000001), // 0.000000001 WETH — permanently locked};Vaults deployed via Aave Labs' API or SDK can set the performance fee as low as 0%.
When a performance fee is set, 50% of that fee is automatically allocated to Aave Labs.
When a recipient is not specified, the fee revenue is distributed equally between the vault owner and Aave Labs.
Let's explore a more advanced recipient configuration with an example. Suppose you want to deploy a vault where you keep 70% of the fee revenue and share the remaining 30% with your partner.
Configuration with Fee Recipients
import { bigDecimal, evmAddress, VaultDeployRequest } from "@aave/react";
const request: VaultDeployRequest = { // … recipients: [ { address: evmAddress("0x1234…"), percent: bigDecimal(30), }, { address: evmAddress("0x4567…"), percent: bigDecimal(70), }, ],};If the vault generates 100 WETH in fee revenue, the distribution will be as follows:
partner: 15 WETH
owner: 35 WETH
Aave Labs: 50 WETH
Since Aave Labs retains 50% of the total fee revenue by default, the remaining 50% is divided between the owner and partner according to the specified percentages.
Finally, deploy the vault.
- React
- TypeScript
- GraphQL
Use the useVaultDeploy and useSendTransaction hooks with the wallet library of your choice to send the transactions.
Viem
import { useWalletClient } from "wagmi";import { errAsync, useVaultDeploy } from "@aave/react";import { useSendTransaction } from "@aave/react/viem";
// …
const { data: walletClient } = useWalletClient();
const [deployVault, deploying] = useVaultDeploy();const [sendTransaction, sending] = useSendTransaction(walletClient);
// …
// Optional: combine loading statesconst loading = deploying.loading || sending.loading;const error = deploying.error || sending.error;
// …
const result = await deployVault(request).andThen((plan) => { switch (plan.__typename) { case "TransactionRequest": // Single transaction execution return sendTransaction(plan);
case "ApprovalRequired": // Approval + transaction sequence return sendTransaction(plan.approval).andThen(() => sendTransaction(plan.originalTransaction), );
case "InsufficientBalanceError": return errAsync( new Error(`Insufficient balance: ${plan.required.value} required.`), ); }});
if (result.isErr()) { console.error("Vault deployment failed:", result.error);} else { console.log("Vault deployment successful with hash:", result.value);}