| name | @1390/woofi-yield |
| version | 1.0.0 |
| description | Comprehensive yield protocol reference covering Aave V3/V4, Spark (Savings + SparkLend), and Morpho V2 vaults — deposit/withdraw flows, contract interfaces, pool registries, and GraphQL APIs across 10+ chains. Essential for WOOFi ecosystem DeFi yield strategies. |
| author | woonetwork |
| tags | ["yield","defi","aave","spark","morpho","lending","vaults","erc-4626","woofi"] |
Woofi Yield Skill — Aave, Spark & Morpho Deposit / Withdraw
Aave
Aave V3
1. Overview
Aave V3 is the largest decentralized lending protocol. Users supply an underlying asset (e.g. USDC) and receive an aToken in return. aTokens are minted 1:1 with the supplied asset; their balance grows automatically over time to reflect accrued interest.
Key points:
- V3 uses
supply() (renamed from V2's deposit())
- aToken balances rebase — no need to claim rewards separately
supplyWithPermit() is available for gasless approvals on EIP-2612 tokens
Supported chains:
| Chain | chainId |
|---|
| Ethereum | 1 |
| Arbitrum | 42161 |
| Optimism | 10 |
| Polygon | 137 |
| Avalanche | 43114 |
| Base | 8453 |
| BNB Chain | 56 |
| Gnosis | 100 |
| Scroll | 534352 |
| Linea | 59144 |
| Sonic | 146 |
2. Pool & Token Registry
Pool Addresses
| Chain | chainId | Pool Address |
|---|
| Ethereum | 1 | 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 |
| Arbitrum | 42161 | 0x794a61358D6845594F94dc1DB02A252b5b4814aD |
| Optimism | 10 | 0x794a61358D6845594F94dc1DB02A252b5b4814aD |
| Polygon | 137 | 0x794a61358D6845594F94dc1DB02A252b5b4814aD |
| Avalanche | 43114 | 0x794a61358D6845594F94dc1DB02A252b5b4814aD |
| Base | 8453 | 0xA238Dd80C259a72e81d7e4664a9801593F98d1c5 |
| BNB Chain | 56 | 0x6807dc923806fE8Fd134338EABCA509979a7e0cB |
| Gnosis | 100 | 0xb50201558B00496A145fE76f7424749556E326D8 |
| Scroll | 534352 | 0x11fCfe756c05AD438e312a7fd934381537D3cFfe |
| Linea | 59144 | 0xc47b8C00b0f69a36fa203Ffeac0334874574a8Ac |
USDC Reserves
| Chain | Underlying | aToken |
|---|
| Ethereum | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 | 0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c |
| Arbitrum | 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 | 0x625E7708f30cA75bfd92586e17077590C60eb4cD |
| Optimism | 0x7F5c764cBc14f9669B88837ca1490cCa17c31607 | 0x625E7708f30cA75bfd92586e17077590C60eb4cD |
| Polygon | 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 | 0x625E7708f30cA75bfd92586e17077590C60eb4cD |
| Avalanche | 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E | 0x625E7708f30cA75bfd92586e17077590C60eb4cD |
| Base | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | 0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB |
| BNB Chain | 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d | 0x00901a076785e0906d1028c7d6372d247bec7d61 |
| Gnosis | 0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83 | 0xc6B7AcA6DE8a6044E0e32d0c841a89244A10D284 |
| Scroll | 0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4 | 0x1D738a3436A8C49CefFbaB7fbF04B660fb528CbD |
| Linea | 0x176211869cA2b568f2A7D4EE941E073a821EE1ff | 0x374D7860c4f2f604De0191298dD393703Cce84f3 |
| Sonic | 0x29219dd400f2Bf60E5a23d13Be72B486D4038894 | 0x578Ee1ca3a8E1b54554Da1Bf7C583506C4CD11c6 |
USDT Reserves
Sonic, Scroll, and Gnosis do not have USDT reserves on Aave V3.
| Chain | Underlying | aToken |
|---|
| Ethereum | 0xdAC17F958D2ee523a2206206994597C13D831ec7 | 0x23878914EFE38d27C4D67Ab83ed1b93A74D4086a |
| Arbitrum | 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 | 0x6ab707Aca953eDAeFBc4fD23bA73294241490620 |
| Optimism | 0x94b008aA00579c1307B0EF2c499aD98a8ce58e58 | 0x6ab707Aca953eDAeFBc4fD23bA73294241490620 |
| Polygon | 0xc2132D05D31c914a87C6611C10748AEb04B58e8F | 0x6ab707Aca953eDAeFBc4fD23bA73294241490620 |
| Avalanche | 0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7 | 0x6ab707Aca953eDAeFBc4fD23bA73294241490620 |
| BNB Chain | 0x55d398326f99059fF775485246999027B3197955 | 0xa9251ca9DE909CB71783723713B21E4233fbf1B1 |
| Linea | 0xA219439258ca9da29E9Cc4cE5596924745e12B93 | 0x88231dfEC71D4FF5c1e466D08C321944A7adC673 |
WETH Reserves
| Chain | Underlying | aToken | Note |
|---|
| Ethereum | 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 | 0x4d5F47FA6A74757f35C14fD3a6Ef8E3C9BC514E8 | |
| Arbitrum | 0x82aF49447D8a07e3bd95BD0d56f35241523fBab1 | 0xe50fA9b3c56FfB159cB0FCA61F5c9D750e8128c8 | |
| Optimism | 0x4200000000000000000000000000000000000006 | 0xe50fA9b3c56FfB159cB0FCA61F5c9D750e8128c8 | |
| Polygon | 0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619 | 0xe50fA9b3c56FfB159cB0FCA61F5c9D750e8128c8 | |
| Avalanche | 0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB | 0xe50fA9b3c56FfB159cB0FCA61F5c9D750e8128c8 | WETH.e |
| Base | 0x4200000000000000000000000000000000000006 | 0xD4a0e0b9149BCee3C920d2E00b5dE09138fd8bb7 | |
| BNB Chain | 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 | 0x2E94171493fAbE316b6205f1585779C887771E2F | ETH |
| Gnosis | 0x6A023CCd1ff6F2045C3309768eAd9E68F978f6e1 | 0xa818F1B57c201E092C4A2017A91815034326Efd1 | |
| Scroll | 0x5300000000000000000000000000000000000004 | 0xf301805bE1Df81102C957f6d4Ce29d2B8c056B2a | |
| Linea | 0xe5D7C2a44FfDDf6b295A15c148167daaAf5Cf34f | 0x787897dF92703BB3Fc4d9Ee98e15C0b8130Bf163 | |
| Sonic | 0x50c42dEAcD8Fc9773493ED674b675bE577f2634b | 0xe18Ab82c81E7Eecff32B8A82B1b7d2d23F1EcE96 | |
WBTC / BTC Reserves
Sonic, Scroll, and Gnosis do not have WBTC reserves on Aave V3.
| Chain | Underlying | aToken | Note |
|---|
| Ethereum | 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 | 0x5Ee5bf7ae06D1Be5997A1A72006FE6C607eC6DE8 | WBTC |
| Arbitrum | 0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f | 0x078f358208685046a11C85e8ad32895DED33A249 | WBTC |
| Optimism | 0x68f180fcCe6836688e9084f035309E29Bf0A2095 | 0x078f358208685046a11C85e8ad32895DED33A249 | WBTC |
| Polygon | 0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6 | 0x078f358208685046a11C85e8ad32895DED33A249 | WBTC |
| Avalanche | 0x50b7545627a5162F82A992c33b87aDc75187B218 | 0x078f358208685046a11C85e8ad32895DED33A249 | WBTC.e |
| Base | 0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf | 0xBdb9300b7CDE636d9cD4AFF00f6F009fFBBc8EE6 | cbBTC |
| BNB Chain | 0x7130d2A12B9BCbFAe4f2634d864A1Ee1Ce3Ead9c | 0x56a7ddc4e848EbF43845854205ad71D5D5F72d3D | BTCB |
| Linea | 0x3aAB2285ddcDdaD8edf438C1bAB47e1a9D05a9b4 | 0x37f7E06359F98162615e016d0008023D910bB576 | WBTC |
3. Pool Contract Interface
Write Functions
// Supply `amount` of `asset` to the pool on behalf of `onBehalfOf`
// referralCode is deprecated — pass 0
function supply(
address asset,
uint256 amount,
address onBehalfOf,
uint16 referralCode
) external;
// Withdraw `amount` of `asset` from the pool, sending to `to`
// Pass type(uint256).max to withdraw the entire balance
function withdraw(
address asset,
uint256 amount,
address to
) external returns (uint256);
// Supply with EIP-2612 permit (gasless approval)
function supplyWithPermit(
address asset,
uint256 amount,
address onBehalfOf,
uint16 referralCode,
uint256 deadline,
uint8 permitV,
bytes32 permitR,
bytes32 permitS
) external;
ERC-20 Approve (prerequisite for supply)
// Approve the Pool to spend underlying tokens on behalf of msg.sender
IERC20(underlying).approve(poolAddress, amount);
4. Operation Flows
Deposit Flow
1. Resolve the Pool address and underlying token address for the target chain/asset.
2. Check user balance:
balance_raw = IERC20(underlying).balanceOf(user)
3. Approve Pool to spend underlying:
IERC20(underlying).approve(pool_address, amount_raw)
4. Execute supply:
pool.supply(underlying, amount_raw, user, 0)
→ User receives aTokens automatically (1:1 with supplied amount)
Withdraw Flow
1. Resolve the Pool address and underlying token address.
2. Check aToken balance (= withdrawable amount):
aBalance_raw = IERC20(aToken).balanceOf(user)
3. Execute withdraw:
pool.withdraw(underlying, amount_raw, user)
→ aTokens are burned, underlying tokens sent to `user`
For full withdrawal, pass type(uint256).max as amount:
pool.withdraw(underlying, type(uint256).max, user)
Native ETH Handling
Aave V3 does not accept native ETH directly. To supply/withdraw native ETH, use the WrappedTokenGatewayV3 contract:
// Deposit native ETH (wraps to WETH internally)
function depositETH(address pool, address onBehalfOf, uint16 referralCode) external payable;
// Withdraw to native ETH (unwraps WETH internally)
// User must approve aWETH to the gateway first
function withdrawETH(address pool, uint256 amount, address to) external;
5. Aave V3 GraphQL API
Endpoint: https://api.v3.aave.com/graphql
Query Reserve APY
query {
reserves {
chain { name chainId }
asset { underlying { symbol address } }
summary { supplyApy { normalized } borrowApy { normalized } }
canBorrow
canSupply
}
}
The supplyApy.normalized field returns the annualized supply rate as a decimal (e.g. 0.035 = 3.5% APY).
Aave V4
1. Overview
Aave V4 launched on Ethereum mainnet on 2026-03-30. It introduces a Hub-and-Spoke architecture: users interact with Spoke contracts, and funds flow to a shared Liquidity Hub. This replaces V3's per-chain isolated Pool model.
Key points:
- Users call
supply() / withdraw() on a Spoke contract (not a Pool)
- Reserves are identified by
reserveId (uint256) instead of asset address
- No
referralCode parameter
- Three Hubs: Core, Prime, Plus — each Spoke is connected to one Hub
- Currently Ethereum only
Supported chains:
2. Hub & Spoke Registry
Hub Addresses (Ethereum)
| Hub | Address |
|---|
| Core | 0xCca852Bc40e560adC3b1Cc58CA5b55638ce826c9 |
| Plus | 0x06002e9c4412CB7814a791eA3666D905871E536A |
| Prime | 0x943827DCA022D0F354a8a8c332dA1e5Eb9f9F931 |
Spoke Addresses (Ethereum)
| Spoke | Address |
|---|
| Main | 0x94e7A5dCbE816e498b89aB752661904E2F56c485 |
| Bluechip | 0x973a023A77420ba610f06b3858aD991Df6d85A08 |
| Lido E | 0xe1900480ac69f0B296841Cd01cC37546d92F35Cd |
| EtherFi E | 0xbF10BDfE177dE0336aFD7fcCF80A904E15386219 |
| Kelp E | 0x3131FE68C4722e726fe6B2819ED68e514395B9a4 |
| Ethena Correlated | 0x58131E79531caB1d52301228d1f7b842F26B9649 |
| Ethena Ecosystem | 0xba1B3D55D249692b669A164024A838309B7508AF |
| Lombard BTC | 0x7EC68b5695e803e98a21a9A05d744F28b0a7753D |
| Forex | 0xD8B93635b8C6d0fF98CbE90b5988E3F2d1Cd9da1 |
| Gold | 0x65407b940966954b23dfA3caA5C0702bB42984DC |
Peripheral Contracts (Ethereum)
| Contract | Address |
|---|
| Native Token Gateway | 0xe68ab4F90Fe026B9873F5F276eD2d7efBbbE42Be |
| Signature Gateway | 0xfbC184337Dc6595D8bf62968Bda46e7De7AF9c3d |
Token Addresses (Ethereum)
| Token | Address |
|---|
| USDC | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
| USDT | 0xdAC17F958D2ee523a2206206994597C13D831ec7 |
| WETH | 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 |
| WBTC | 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 |
3. Spoke Contract Interface
Write Functions
// Supply `amount` of the reserve identified by `reserveId` on behalf of `onBehalfOf`
// Returns (suppliedAmount, mintedShares)
function supply(
uint256 reserveId,
uint256 amount,
address onBehalfOf
) external returns (uint256, uint256);
// Withdraw `amount` of the reserve identified by `reserveId` on behalf of `onBehalfOf`
// Returns (withdrawnAmount, burnedShares)
function withdraw(
uint256 reserveId,
uint256 amount,
address onBehalfOf
) external returns (uint256, uint256);
ERC-20 Approve (prerequisite for supply)
// Approve the Spoke contract to spend underlying tokens on behalf of msg.sender
IERC20(underlying).approve(spokeAddress, amount);
4. Operation Flows
Deposit Flow
1. Identify the target Spoke address and look up the reserveId for the asset (see Section 5).
2. Check user balance:
balance_raw = IERC20(underlying).balanceOf(user)
3. Approve Spoke to spend underlying:
IERC20(underlying).approve(spoke_address, amount_raw)
4. Execute supply:
(suppliedAmount, mintedShares) = spoke.supply(reserveId, amount_raw, user)
Withdraw Flow
1. Identify the target Spoke address and look up the reserveId for the asset (see Section 5).
2. Execute withdraw:
(withdrawnAmount, burnedShares) = spoke.withdraw(reserveId, amount_raw, user)
→ Underlying tokens are sent to `user`
Native ETH Handling
Aave V4 provides a Native Token Gateway for supplying/withdrawing native ETH without manual wrapping:
Gateway address: 0xe68ab4F90Fe026B9873F5F276eD2d7efBbbE42Be
5. Reserve ID Lookup
Aave V4 identifies reserves by reserveId (uint256), not by asset address. To obtain the reserveId for a given asset, perform a two-step on-chain lookup:
Function Signatures
// Step 1 — on the Hub contract
// Returns the Hub-internal asset ID for the given underlying token address
function getAssetId(address underlying) external view returns (uint256);
// Step 2 — on the Spoke contract
// Maps (hub, assetId) → reserveId used in supply()/withdraw()
function getReserveId(address hub, uint256 assetId) external view returns (uint256);
Lookup Example
hub_address = <Hub address from Section 2> // e.g. Core Hub
spoke_address = <Spoke address from Section 2> // e.g. Main Spoke
// Step 1: get the Hub-internal asset ID
assetId = hub.getAssetId(USDC_ADDRESS)
// Step 2: convert to Spoke-specific reserveId
reserveId = spoke.getReserveId(hub_address, assetId)
// Now use reserveId in supply()/withdraw()
spoke.supply(reserveId, amount, user)
Note: reserveId values are per-Spoke — the same underlying asset can have different reserveId values across different Spokes. Always look up the reserveId for the specific Spoke you intend to interact with.
Additional View Functions on Spoke
| Function | Returns | Description |
|---|
getReserve(uint256 reserveId) | Reserve struct | Full reserve details: underlying address, hub, assetId, decimals, collateralRisk, flags |
getReserveCount() | uint256 | Total number of reserves in the Spoke |
getReserveConfig(uint256 reserveId) | ReserveConfig | Collateral risk parameters, paused/frozen status |
6. Aave V4 GraphQL API
Endpoint: https://api.v4.aave.com/graphql
Query Reserve APY
query {
reserves {
chain { name chainId }
asset { underlying { symbol address } }
summary { supplyApy { normalized } borrowApy { normalized } }
canBorrow
canSupply
}
}
The supplyApy.normalized field returns the annualized supply rate as a decimal (e.g. 0.035 = 3.5% APY).
7. Key Differences from V3
| Aspect | Aave V3 | Aave V4 |
|---|
| Architecture | Isolated Pool per chain | Hub-and-Spoke, shared Liquidity Hub |
| Entry point | Pool.supply(asset, ...) | Spoke.supply(reserveId, ...) |
| Reserve identifier | address asset | uint256 reserveId |
| Referral code | uint16 referralCode (pass 0) | Removed |
| Return values | None (supply) / uint256 (withdraw) | (uint256, uint256) tuple for both |
| Chains | 10+ chains | Ethereum only (as of 2026-04) |
| Liquidity sharing | None — isolated per deployment | Cross-Spoke via shared Hub |
| Native ETH gateway | WrappedTokenGatewayV3 | Native Token Gateway |
Spark
1. Overview
Spark is a DeFi platform within the Sky (formerly MakerDAO) ecosystem, comprising two product lines:
- Spark Savings — ERC-4626 vaults (spUSDC, spUSDT, spETH, etc.) that optimize yield via the Spark Liquidity Layer
- SparkLend (Markets) — Aave V3 fork lending pool; supply assets to receive spTokens
Savings products span 6 chains; SparkLend is deployed only on Ethereum and Gnosis.
Supported chains:
| Chain | chainId | Savings | SparkLend |
|---|
| Ethereum | 1 | Yes | Yes |
| Base | 8453 | Yes | No |
| Arbitrum | 42161 | Yes | No |
| Optimism | 10 | Yes | No |
| Unichain | 130 | Yes | No |
| Gnosis | 100 | Yes | Yes |
2. Spark Savings — Vault Registry
Product categories:
- V2 Vaults (spUSDC, spUSDT, spETH) — Spark-native ERC-4626 vaults deploying strategies via the Liquidity Layer
- Legacy (sUSDS, sDAI) — Sky protocol Savings Rate wrappers (not listed here)
Only USDC / USDT / ETH / BTC related vaults are listed below.
spUSDC (Spark USDC Vault)
| Chain | Vault Address | Underlying (USDC) |
|---|
| Ethereum | 0x28B3a8fb53B741A8Fd78c0fb9A6B2393d896a43d | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
| Avalanche | 0x28B3a8fb53B741A8Fd78c0fb9A6B2393d896a43d | 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E |
Note: Avalanche has spUSDC in the address registry. Base / Arbitrum / Optimism / Unichain have a different savings product (sUSDC) that is a USDS-backed wrapper, not a direct USDC vault.
sUSDC (Savings USDC — USDS-backed)
| Chain | Vault Address | Underlying (USDC) |
|---|
| Base | 0x3128a0F7f0ea68E7B7c9B00AFa7E41045828e858 | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| Arbitrum | 0x940098b108fB7D0a7E374f6eDED7760787464609 | 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 |
| Optimism | 0xCF9326e24EBfFBEF22ce1050007A43A3c0B6DB55 | 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85 |
| Unichain | 0x14d9143BEcC348920b68D123687045db49a016C6 | 0x078D782b760474a361dDA0AF3839290b0EF57AD6 |
spUSDT (Spark USDT Vault — Ethereum only)
| Chain | Vault Address | Underlying (USDT) |
|---|
| Ethereum | 0xe2e7a17dFf93280dec073C995595155283e3C372 | 0xdAC17F958D2ee523a2206206994597C13D831ec7 |
spETH (Spark ETH Vault — Ethereum only)
| Chain | Vault Address | Underlying (WETH) |
|---|
| Ethereum | 0xfE6eb3b609a7C8352A241f7F3A21CEA4e9209B8f | 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 |
BTC
No Spark Savings vault exists for BTC.
3. Spark Savings — ERC-4626 Contract Interface
All Spark Savings vaults (spUSDC, spUSDT, spETH, sUSDC) implement the standard ERC-4626 interface.
Read Functions (view)
// Returns the address of the underlying ERC-20 asset
function asset() external view returns (address);
// Total amount of the underlying asset managed by the vault
function totalAssets() external view returns (uint256);
// Vault share balance of `account`
function balanceOf(address account) external view returns (uint256);
// Convert `shares` to asset amount (no fees, no slippage)
function convertToAssets(uint256 shares) external view returns (uint256);
// Convert `assets` to share amount (no fees, no slippage)
function convertToShares(uint256 assets) external view returns (uint256);
// Preview how many shares a deposit of `assets` would yield
function previewDeposit(uint256 assets) external view returns (uint256);
// Preview how many assets a redeem of `shares` would yield
function previewRedeem(uint256 shares) external view returns (uint256);
Write Functions (state-changing)
// Deposit `assets` of underlying token, mint shares to `receiver`
function deposit(uint256 assets, address receiver) external returns (uint256 shares);
// Withdraw exactly `assets`, burning shares from `owner`, sending assets to `receiver`
function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);
// Redeem exactly `shares`, sending resulting assets to `receiver` (preferred for full withdrawal)
function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);
ERC-20 Approve (prerequisite for deposit)
// Approve the vault to spend underlying tokens on behalf of msg.sender
IERC20(underlying).approve(vaultAddress, amount);
4. Spark Savings — Operation Flows
Deposit Flow
1. Query underlying token address:
underlying = vault.asset()
2. Check user balance:
balance_raw = IERC20(underlying).balanceOf(user)
3. Approve vault to spend underlying:
IERC20(underlying).approve(vault_address, amount_raw)
4. Preview expected shares:
expected_shares = vault.previewDeposit(amount_raw)
5. Execute deposit:
shares = vault.deposit(amount_raw, receiver)
Withdraw Flow (prefer redeem)
Using redeem is preferred over withdraw because it operates on shares (which the user holds) rather than a specific asset amount, avoiding rounding issues.
1. Check user share balance:
shares = vault.balanceOf(user)
2. Preview expected assets:
expected_assets = vault.previewRedeem(shares)
3. Execute redeem:
assets = vault.redeem(shares, receiver, owner)
Full Withdrawal
vault.redeem(vault.balanceOf(user), user, user)
Liquidity Notes
- No lock-up period
- V2 vaults retain ~10% idle liquidity for instant withdrawals
- Large withdrawals are handled via Savings Liquidity Intents (typically fulfilled within minutes)
5. SparkLend (Markets) — Pool & Token Registry
SparkLend is an Aave V3 fork deployed only on Ethereum and Gnosis.
Pool Addresses
| Chain | chainId | Pool Address | WETH Gateway |
|---|
| Ethereum | 1 | 0xC13e21B648A5Ee794902342038FF3aDAB66BE987 | 0xBD7D6a9ad7865463DE44B05F04559f65e3B11704 |
| Gnosis | 100 | 0x2Dae5307c5E3FD1CF5A72Cb6F698f915860607e0 | 0xBD7D6a9ad7865463DE44B05F04559f65e3B11704 |
Ethereum Token Reserves
| Asset | Underlying | spToken |
|---|
| USDC | 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 | 0x377C3bd93f2a2984E1E7bE6A5C22c525eD4A4815 |
| USDT | 0xdAC17F958D2ee523a2206206994597C13D831ec7 | 0xe7dF13b8e3d6740fe17CBE928C7334243d86c92f |
| WETH | 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 | 0x59cD1C87501baa753d0B5B5Ab5D8416A45cD71DB |
| WBTC | 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 | 0x4197ba364AE6698015AE5c1468f54087602715b2 |
Gnosis Token Reserves
| Asset | Underlying | spToken |
|---|
| USDC | 0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83 | 0x5850D127a04ed0B4F1FCDFb051b3409FB9Fe6B90 |
| USDT | 0x4ECaBa5870353805a9F068101A40E0f32ed605C6 | 0x08B0cAebE352c3613302774Cd9B82D08afd7bDC4 |
| WETH | 0x6A023CCd1ff6F2045C3309768eAd9E68F978f6e1 | 0x629D562E92fED431122e865Cc650Bc6bdE6B96b0 |
Note: Gnosis does not have a WBTC reserve.
6. SparkLend — Pool Contract Interface
SparkLend uses the same interface as Aave V3 (it is an Aave V3 fork).
Read Functions (view)
// Returns reserve data including aToken address, liquidity index, current rates
function getReserveData(address asset) external view returns (DataTypes.ReserveData memory);
// Returns user account data (total collateral, total debt, available borrows, etc.)
function getUserAccountData(address user) external view returns (
uint256 totalCollateralBase,
uint256 totalDebtBase,
uint256 availableBorrowsBase,
uint256 currentLiquidationThreshold,
uint256 ltv,
uint256 healthFactor
);
Write Functions (state-changing)
// Supply `amount` of `asset` on behalf of `onBehalfOf`; referralCode is currently inactive (pass 0)
function supply(address asset, uint256 amount, address onBehalfOf, uint16 referralCode) external;
// Supply with ERC-2612 permit (single tx approve + supply)
function supplyWithPermit(
address asset, uint256 amount, address onBehalfOf, uint16 referralCode,
uint256 deadline, uint8 permitV, bytes32 permitR, bytes32 permitS
) external;
// Withdraw `amount` of `asset` to `to`; pass type(uint256).max for full withdrawal
function withdraw(address asset, uint256 amount, address to) external returns (uint256);
ERC-20 Approve (prerequisite for supply)
// Approve the Pool to spend underlying tokens on behalf of msg.sender
IERC20(underlying).approve(poolAddress, amount);
7. SparkLend — Operation Flows
Deposit (Supply) Flow
1. Check user balance:
balance_raw = IERC20(underlying).balanceOf(user)
2. Approve Pool to spend underlying:
IERC20(underlying).approve(pool_address, amount_raw)
3. Execute supply:
pool.supply(underlying, amount_raw, user, 0)
// referralCode = 0 (inactive)
Withdraw Flow
1. Check user spToken balance:
sp_balance = IERC20(spToken).balanceOf(user)
2. Execute withdraw:
pool.withdraw(underlying, amount_raw, user)
Full Withdrawal
pool.withdraw(underlying, type(uint256).max, user)
Native ETH via WETH Gateway
For native ETH deposits/withdrawals, use the WETH Gateway contract instead of the Pool directly:
// Deposit native ETH
IWETHGateway(gateway).depositETH{value: amount}(pool_address, onBehalfOf, 0);
// Withdraw to native ETH (requires spWETH approval to gateway)
IWETHGateway(gateway).withdrawETH(pool_address, amount, to);
8. Spark API
- No dedicated REST/GraphQL API (unlike Aave or Morpho)
- Rate queries: via on-chain
getReserveData() or The Graph subgraph
- Savings rates: via ERC-4626
convertToAssets() method or SSR Oracle
9. Data Sources
All contract addresses sourced from:
github.com/sparkdotfi/spark-address-registry (Ethereum.sol, Base.sol, Arbitrum.sol, Optimism.sol, Unichain.sol, Gnosis.sol)github.com/marsfoundation/sparklend-deployments (primary-latest.json for chain 1 and 100)- Etherscan / GnosisScan verification
Morpho
1. Overview
Morpho V2 vaults are ERC-4626 standard tokenized vaults. Users deposit an underlying asset (e.g. USDC) and receive vault shares representing their proportional claim on the vault's total assets.
Supported chains:
| Chain | chainId |
|---|
| Ethereum | 1 |
| Monad | 143 |
2. Vault Registry
All vaults below are Morpho V2; V1 is excluded.
USDC Vaults
USDT Vaults
ETH Vaults
BTC Vaults
3. ERC-4626 Contract Interface
All Morpho V2 vaults implement the ERC-4626 standard. Below are the core function signatures.
Read Functions (view)
// Returns the address of the underlying ERC-20 asset
function asset() external view returns (address);
// Total amount of the underlying asset managed by the vault
function totalAssets() external view returns (uint256);
// Vault share balance of `account`
function balanceOf(address account) external view returns (uint256);
// Convert `shares` to asset amount (no fees, no slippage)
function convertToAssets(uint256 shares) external view returns (uint256);
// Convert `assets` to share amount (no fees, no slippage)
function convertToShares(uint256 assets) external view returns (uint256);
// Preview how many shares a deposit of `assets` would yield
function previewDeposit(uint256 assets) external view returns (uint256);
// Preview how many assets a redeem of `shares` would yield
function previewRedeem(uint256 shares) external view returns (uint256);
Write Functions (state-changing)
// Deposit `assets` of underlying token, mint shares to `receiver`
function deposit(uint256 assets, address receiver) external returns (uint256 shares);
// Withdraw exactly `assets`, burning shares from `owner`, sending assets to `receiver`
function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);
// Redeem exactly `shares`, sending resulting assets to `receiver` (preferred for full withdrawal)
function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);
ERC-20 Approve (prerequisite for deposit)
// Approve the vault to spend underlying tokens on behalf of msg.sender
IERC20(underlying).approve(vaultAddress, amount);
4. Operation Flows
Deposit Flow
1. Query underlying token address:
underlying = vault.asset()
2. Check user balance:
balance_raw = IERC20(underlying).balanceOf(user)
3. Approve vault to spend underlying:
IERC20(underlying).approve(vault_address, amount_raw)
4. Preview expected shares:
expected_shares = vault.previewDeposit(amount_raw)
5. Execute deposit:
shares = vault.deposit(amount_raw, receiver)
Withdraw Flow (prefer redeem)
Using redeem is preferred over withdraw because it operates on shares (which the user holds) rather than a specific asset amount, avoiding rounding issues.
1. Check user share balance:
shares = vault.balanceOf(user)
2. Preview expected assets:
expected_assets = vault.previewRedeem(shares)
3. Execute redeem:
assets = vault.redeem(shares, receiver, owner)
Full Withdrawal
vault.redeem(vault.balanceOf(user), user, user)
5. Morpho GraphQL API
Endpoint: https://api.morpho.org/graphql
Query Vault APY
query {
vaultByAddress(address: "0xBEeFF047C03714965a54b671A37C18beF6b96210", chainId: 1) {
address
symbol
asset {
symbol
decimals
address
}
state {
totalAssets
apy
netApy
}
}
}
Batch Query (all tracked vaults)
Use multiple vaultByAddress calls with GraphQL aliases:
query {
steakhouseUSDC: vaultByAddress(address: "0xBEeFF047C03714965a54b671A37C18beF6b96210", chainId: 1) {
address
symbol
state { apy netApy totalAssets }
}
skymoneyUSDC: vaultByAddress(address: "0x56bfa6f53669B836D1E0Dfa5e99706b12c373ecf", chainId: 1) {
address
symbol
state { apy netApy totalAssets }
}
}
