Updated
Updated
Updated
Updated
The `route` API might be the simpler way to route your assets. Before using the bundle API, check if `route` would work using [happypath](https://happypath.enso.build).
enso| E((AUSD)) B -->|keep as
USDC| F((USDC)) end E -->|depositclmm via
sushiswap-v3| G((LP NFT)) F -->|depositclmm via
sushiswap-v3| G ``` **Bundle Design**: * Input of 100 `USDC` must be split into 2 tokens: `AUSD` and `USDC`, using Enso's `split` action that converts 50% of USDC into AUSD, and keeps the rest untouched * Deposit using `depositclmm` action of `sushiswap-v3` protocol. * `tokenIn` are the pool's tokens (`USDC/AUSD`) * `amountIn` is an array of amounts obtained from the split into `USDC` and `AUSD` respectively, using dynamic quantity reference (`useOutputOfCallAt`). * The `tokenOut` value is the address of Sushiswap's position manager contract. * Provide correct fee and ticks. ```ts linenums="1" theme={null} export async function sushiswapV3() { const chainId = 747474; const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; const tokenIn_USDC = "0x203A662b0BD271A6ed5a60EdFbd04bFce608FD36"; const tokenOut_AUSD = "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a"; const sushiswapManager = "0x2659C6085D26144117D904C46B48B6d180393d27"; const amountIn = parseUnits("100", 6); // 100 USDC const bundle = await client.getBundleData( { chainId, fromAddress, routingStrategy: "router", }, [ { // Split USDC into 2 parts for the LP position protocol: "enso", action: "split", args: { tokenIn: tokenIn_USDC, tokenOut: [tokenOut_AUSD, tokenIn_USDC], amountIn: amountIn.toString(), }, }, { protocol: "sushiswap-v3", action: "depositclmm", args: { tokenOut: sushiswapManager, ticks: [-114, -86], poolFee: "100", tokenIn: [tokenOut_AUSD, tokenIn_USDC], amountIn: [ { useOutputOfCallAt: 0, index: 0 }, // AUSD from split { useOutputOfCallAt: 0, index: 1 }, // USDC from split ], }, }, ] ); const approvalData = await client.getApprovalData({ amount: amountIn.toString(), chainId, fromAddress, tokenAddress: tokenIn_USDC, }); // Approve Enso Router contract to operate with USDC await sendEoa(approvalData.tx, approvalData.gas); // Execute the bundle transaction await sendEoa(bundle.tx, bundle.gas); return bundle; } ``` ### Staking Pipeline Chain multiple actions together to create a complete Curve LP staking workflow. **Example**: Creating a staked Curve 3pool position starting with 1 ETH * **Input**: 1 ETH * **Final Output**: 3pool LP tokens staked in Curve gauge * **Process**: 1. Swap 1 ETH to USDC 2. Deposit USDC into Curve 3pool to get 3pool LP tokens 3. Stake 3pool LP tokens in the Curve gauge
Updated
Updated
Updated
Updated
check| USDC_ETH((USDC)) subgraph ethereum ["🌐 Ethereum"] USDC_ETH((USDC)) -->|reservoir
deposit| rUSD_ETH((rUSD)) end rUSD_ETH -.-> |balance
check|rUSD_BERA((rUSD)) subgraph berachain ["🐻 Berachain"] rUSD_BERA((rUSD)) -->|euler-v2
deposit| erUSD((erUSD)) end ``` ## Solana destinations The Route API supports EVM → Solana transfers. Enso can compose operations on the source EVM chain; the route ends with token delivery on Solana, without destination callbacks or composition. See [Solana routing](/pages/build/get-started/solana-routing) for the request requirements, example, route modes, and delivery tracking. ## Quick Start
bridge| B1 subgraph base ["🔵 Base"] B1(( )) -->|balance
check| USDC((USDC)) end ```
bridge| B1 subgraph base ["🔵 Base"] B1(( )) -->|balance
check| ETH_B((ETH)) ETH_B --> |ether.fi
deposit|WEETH((weETH)) end ``` ```typescript theme={null} const route = await ensoClient.getRouteData({ fromAddress: "0x...", chainId: 1, // Ethereum destinationChainId: 8453, // Base tokenIn: ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"], // USDC Ethereum tokenOut: ["0x04C0599Ae5A44757c0af6F9eC3b93da8976c150A"], // weETH vault on Base amountIn: ["1000000000"], // 1,000 USDC slippage: "500", // 5% (complex operation) routingStrategy: "delegate", }); // Bridge + vault entry in one transaction await wallet.sendTransaction(route.tx); ``` ### 3. Cross-Chain Position Minting Crosschain routing enables you to mint positions on different chains and bridge them back, while signing only once. In this example, we'll bridge USDC from Berachain to Ethereum, mint e-rUSD using Reservoir protocol, then bridge rUSD back to Berachain. **About Reservoir**: Reservoir is a stablecoin protocol that mints rUSD (a USD-pegged stablecoin) by accepting USDC as collateral on Ethereum mainnet. ```mermaid theme={null} flowchart LR subgraph berachain ["🐻 Berachain"] USDC_BERA((USDC)) --> A1(( )) end A1 -.-> B1 subgraph ethereum ["🌐 Ethereum"] B1(( )) -->|balance
check| USDC_ETH((USDC)) USDC_ETH -->|reservoir
deposit| A2(( )) --> rUSD_ETH((rUSD)) end rUSD_ETH -.-> C1 subgraph berachain ["🐻 Berachain"] C1(( )) -->|balance
check| rUSD_BERA((rUSD)) end ```
check| USDC_ETH((USDC)) subgraph ethereum ["🌐 Ethereum"] USDC_ETH((USDC)) -->|reservoir
deposit| rUSD_ETH((rUSD)) end rUSD_ETH -.-> |balance
check|rUSD_BERA((rUSD)) subgraph berachain ["🐻 Berachain"] rUSD_BERA((rUSD)) -->|euler-v2
deposit| erUSD((erUSD)) end ``` ```typescript mintOnBeraDepositOnMainnet.ts highlight={50, 57, 81, 89, 23, 29} lines theme={null} const BERACHAIN_ID = 80094; const ETHEREUM_ID = 1; // Common addresses const WALLET_ADDRESS = "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11"; // User wallet // Token addresses const USDC_BERACHAIN = "0x549943e04f40284185054145c6E4e9568C1D3241"; const USDC_ETHEREUM = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const RUSD_ETHEREUM = "0x09D4214C03D01F49544C0448DBE3A27f768F2b34"; const RUSD_BERACHAIN = "0x09D4214C03D01F49544C0448DBE3A27f768F2b34"; // Protocol addresses const RESERVOIR_MINTING_CONTRACT = "0x4809010926aec940b550D34a46A52739f996D75D"; const EULER_VAULT_E_RUSD_BERACHAIN = "0x109D6D1799f62216B4a7b0c6e245844AbD4DD281"; // Euler vault for e-rUSD on Berachain (need actual address) const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY!, }); const usdcBeraToEthPools = await client.getLayerZeroPool({ chainId: BERACHAIN_ID, token: USDC_BERACHAIN, destinationChainId: ETHEREUM_ID + "", }); const rusdEthToBeraPools = await client.getLayerZeroPool({ chainId: ETHEREUM_ID, token: RUSD_ETHEREUM, destinationChainId: BERACHAIN_ID + "", }); if (!(usdcBeraToEthPools.length && usdcBeraToEthPools.length)) { throw new Error("Required pools not available"); } const bundle = await client.getBundleData( { chainId: BERACHAIN_ID, fromAddress: WALLET_ADDRESS, spender: WALLET_ADDRESS, routingStrategy: "router", refundReceiver: WALLET_ADDRESS, }, [ { protocol: "stargate", action: "bridge", args: { primaryAddress: rusdEthToBeraPools[0].pool, destinationChainId: ETHEREUM_ID, tokenIn: USDC_BERACHAIN, amountIn: parseUnits("1000", 6).toString(), // 1000 USDC receiver: WALLET_ADDRESS, callback: [ // Step 1: Check USDC balance on Ethereum after bridge { protocol: "enso", action: "balance", args: { token: USDC_ETHEREUM, }, }, // Step 2: Mint e-rUSD using bridged USDC on Ethereum { protocol: "reservoir", action: "deposit", args: { primaryAddress: RESERVOIR_MINTING_CONTRACT, tokenIn: USDC_ETHEREUM, tokenOut: RUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 0 }, // Use USDC from balance check receiver: WALLET_ADDRESS, }, }, // Step 3: Bridge newly minted e-rUSD back to Berachain { protocol: "stargate", action: "bridge", args: { primaryAddress: rusdEthToBeraPools[0].pool, destinationChainId: BERACHAIN_ID, tokenIn: RUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 1 }, // Use e-rUSD from minting receiver: WALLET_ADDRESS, // Callback executes on Berachain after e-rUSD arrives callback: [ // Step 4: Check e-rUSD balance on Berachain { protocol: "enso", action: "balance", args: { token: RUSD_BERACHAIN, }, }, // Step 5: Deposit e-rUSD into Euler vault on Berachain { protocol: "euler-v2", action: "deposit", args: { primaryAddress: EULER_VAULT_E_RUSD_BERACHAIN, tokenIn: RUSD_BERACHAIN, tokenOut: EULER_VAULT_E_RUSD_BERACHAIN, // ERC4626 vault token amountIn: { useOutputOfCallAt: 0 }, // Use e-rUSD from balance check receiver: WALLET_ADDRESS, }, }, ], }, }, ], }, }, ], ); ``` ### 5. CCIP Bridge with Callback Use CCIP for ERC20 token bridging with larger callback payloads. This example bridges SolvBTC from BNB Chain to Base, then swaps it to native ETH. ```mermaid theme={null} flowchart LR subgraph bnb ["🟡 BNB Chain"] SOLVBTC_BNB((SolvBTC)) --> A1(( )) end A1 -.->|ccip
bridge| B1 subgraph base ["🔵 Base"] B1(( )) -->|balance
check| SOLVBTC_BASE((SolvBTC)) SOLVBTC_BASE -->|enso
route| ETH((ETH)) end ```
bridge| B1 subgraph ethereum ["🌐 Ethereum"] B1(( )) -->|balance| USDT_ETH((USDT)) USDT_ETH -->|route| syrupUSDT((syrupUSDT)) end syrupUSDT -.->|ccip
bridge| C1 subgraph plasma ["🟣 Plasma"] C1(( )) -->|aave-v3
deposit| asUSDT((asUSDT)) end ``` ```typescript mixedBridgeProtocols.ts theme={null} const PLASMA_CHAIN_ID = 9745; const ETHEREUM_ID = 1; const WALLET_ADDRESS = "0x..."; // Token addresses const USDT_PLASMA = "0x..."; const USDT_ETHEREUM = "0xdac17f958d2ee523a2206206994597c13d831ec7"; const SYRUP_USDT_ETHEREUM = "0x..."; const SYRUP_USDT_PLASMA = "0x..."; const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY! }); // Get pool addresses for both bridges const stargatePool = await client.getLayerZeroPool({ chainId: PLASMA_CHAIN_ID, token: USDT_PLASMA, destinationChainId: ETHEREUM_ID + "", }); const ccipRouter = await client.getCcipRouter({ chainId: ETHEREUM_ID, }); const bundle = await client.getBundleData( { chainId: PLASMA_CHAIN_ID, fromAddress: WALLET_ADDRESS, routingStrategy: "router", }, [ { protocol: "stargate", action: "bridge", args: { primaryAddress: stargatePool[0].pool, destinationChainId: ETHEREUM_ID, tokenIn: USDT_PLASMA, amountIn: "1000000000", // 1000 USDT receiver: WALLET_ADDRESS, callback: [ // Step 1: Check USDT balance on Ethereum { protocol: "enso", action: "balance", args: { token: USDT_ETHEREUM }, }, // Step 2: Swap USDT to syrupUSDT on Ethereum { protocol: "enso", action: "route", args: { tokenIn: USDT_ETHEREUM, tokenOut: SYRUP_USDT_ETHEREUM, amountIn: { useOutputOfCallAt: 0 }, }, }, // Step 3: Bridge syrupUSDT back to Plasma via CCIP { protocol: "ccip", action: "bridge", args: { primaryAddress: ccipRouter.router, destinationChainId: PLASMA_CHAIN_ID, tokenIn: SYRUP_USDT_ETHEREUM, amountIn: { useOutputOfCallAt: 1 }, receiver: WALLET_ADDRESS, // Callback on Plasma after CCIP bridge callback: [ { protocol: "enso", action: "balance", args: { token: SYRUP_USDT_PLASMA }, }, { protocol: "aave-v3", action: "deposit", args: { primaryAddress: "0x...", // AAVE V3 Plasma pool tokenIn: SYRUP_USDT_PLASMA, amountIn: { useOutputOfCallAt: 0 }, receiver: WALLET_ADDRESS, }, }, ], }, }, ], }, }, ], ); ``` ### 7. Relay Bridge with Callback Use Relay for bridging with dynamic amount resolution. This example bridges ETH from Ethereum to Arbitrum and wraps it to WETH. ```mermaid theme={null} flowchart LR subgraph ethereum ["🌐 Ethereum"] USDC((USDC)) -->|route| ETH_ETH((ETH)) ETH_ETH --> A1(( )) end A1 -.->|relay
bridge| B1 subgraph arbitrum ["🔷 Arbitrum"] B1(( )) -->|balance| ETH_ARB((ETH)) ETH_ARB -->|wrap| WETH((WETH)) end ``` ```typescript relayBridge.ts theme={null} const ETHEREUM_ID = 1; const ARBITRUM_ID = 42161; const WALLET_ADDRESS = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; const USDC_ETHEREUM = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"; const WETH_ARBITRUM = "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"; const NATIVE_TOKEN = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"; const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY! }); const bundle = await client.getBundleData( { chainId: ETHEREUM_ID, fromAddress: WALLET_ADDRESS, routingStrategy: "router", }, [ // Step 1: Swap USDC to ETH on Ethereum { protocol: "enso", action: "route", args: { tokenIn: USDC_ETHEREUM, tokenOut: NATIVE_TOKEN, amountIn: "10000000", // 10 USDC }, }, // Step 2: Bridge ETH to Arbitrum via Relay { protocol: "relay", action: "bridge", args: { primaryAddress: "0xa5f565650890fba1824ee0f21ebbbf660a179934", destinationChainId: ARBITRUM_ID, tokenIn: NATIVE_TOKEN, // Relay supports native tokens amountIn: { useOutputOfCallAt: 0 }, receiver: WALLET_ADDRESS, callback: [ // Step 3: Check ETH balance on Arbitrum { protocol: "enso", action: "balance", args: { token: NATIVE_TOKEN }, }, // Step 4: Wrap ETH to WETH on Arbitrum { protocol: "wrapped-native", action: "deposit", args: { primaryAddress: WETH_ARBITRUM, tokenIn: NATIVE_TOKEN, tokenOut: WETH_ARBITRUM, amountIn: { useOutputOfCallAt: 0 }, }, }, ], }, }, ], ); ``` ### 8. CCTP Bridge Bridge native USDC across chains with Circle's CCTP — burn on the source, mint on the destination. Both fast and standard transfers are auto-relayed by Circle's Forwarding Service, so the receiver never needs destination gas. ```mermaid theme={null} flowchart LR subgraph ethereum ["🌐 Ethereum"] USDC_ETH((USDC)) --> A1(( )) end A1 -.->|cctp
burn + forward| B1 subgraph arbitrum ["🔷 Arbitrum"] B1(( )) -->|mint| USDC_ARB((USDC)) end ```
Updated
Updated
Updated
The `route` API might be the simpler way to route your assets. Before using the bundle API, check if `route` would work using [happypath](https://happypath.enso.build).
Updated
Optional swaps or position exits"] --> B["Bridge"] B --> C["Solana receiver
Requested output token"] ``` Request a route with an EVM input asset and a Solana output token. Enso returns a transaction to sign and submit on the source EVM chain. Depending on the route mode, this transaction can include swaps or position exits before bridging. The requested output token arrives at `receiver` on Solana. The receiver does not sign a Solana transaction for this transfer. Enso does not execute destination callbacks or compose additional actions on Solana. ## Request requirements | Parameter | Requirement | | - | - | | `chainId` | The supported source EVM chain ID. | |
destinationChainId | `1861167595`, the current Enso identifier for Solana. |
| `fromAddress` | The source EVM wallet address. |
| `tokenIn` | Exactly one source-chain asset address. |
| `amountIn` | Exactly one positive, fixed integer string in the input token's base unit. Dynamic amounts and placeholders are unsupported. |
| `tokenOut` | Exactly one case-sensitive Solana mint address, or the native SOL identifier below. |
| `receiver` | An explicit, case-sensitive Solana recipient address. |
| `refundReceiver` | An explicit, nonzero EVM address on the source chain for bridge refunds. |
| `slippage` | Slippage tolerance in basis points. `"50"` means 0.5%. Use this instead of `minAmountOut`. |
Preserve the original case of Solana addresses throughout your integration, including requests, storage, and display. The Solana `receiver` and EVM `refundReceiver` are separate addresses on different chains.
## Example: Ethereum USDC to Solana USDC
Set `ENSO_API_KEY` to your Enso API key, `EVM_ADDRESS` to your source wallet, and `SOLANA_ADDRESS` to the recipient's Solana wallet address.
This request routes 100 USDC from Ethereum to USDC on Solana with 0.5% slippage.
```bash theme={null}
curl --request POST \
--url https://api.enso.build/api/v1/shortcuts/route \
--header "Authorization: Bearer $ENSO_API_KEY" \
--header 'Content-Type: application/json' \
--data @- <Updated
Updated
Updated
Updated
| Network | Router V2 | Delegate V2 | EnsoShortcuts |
|---|---|---|---|
| Ethereum `1` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Optimism `10` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Binance `56` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Gnosis `100` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Unichain `130` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Polygon `137` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Monad `143` | `0xCfBAa9Cfce952Ca4F4069874fF1Df8c05e37a3c7` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x0d14f7c957bd15f5Bec423F9b1B51E122D90Fc76` |
| Sonic `146` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| ZkSync `324` | `0x1BD8CefD703CF6b8fF886AD2E32653C32bc62b5C` | `0x4CB2f9B3F3FE141C6283bAA9F210B2A1dba047c3` | `0x62Ff58620B2b004c6AA51B050E5d73236DA538dB` |
| World `480` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Hyper `999` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Sei `1329` | `0x300b3D30aaBf46b05983284f0297D966E92bbeB2` | `0x23116881a725d3C43c8310A6C5c8fbE769DD322E` | `0xE532C864B7eD73B5188B8410AD2Acd4a7ed7BA26` |
| Soneium `1868` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Tempo `4217` | `0xCfBAa9Cfce952Ca4F4069874fF1Df8c05e37a3c7` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x0d14f7c957bd15f5Bec423F9b1B51E122D90Fc76` |
| MegaETH `4326` | `0xCfBAa9Cfce952Ca4F4069874fF1Df8c05e37a3c7` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x0d14f7c957bd15f5Bec423F9b1B51E122D90Fc76` |
| Robinhood `4663` | `0xCfBAa9Cfce952Ca4F4069874fF1Df8c05e37a3c7` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x0d14f7c957bd15f5Bec423F9b1B51E122D90Fc76` |
| Arc `5042` | `0xCfBAa9Cfce952Ca4F4069874fF1Df8c05e37a3c7` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x0d14f7c957bd15f5Bec423F9b1B51E122D90Fc76` |
| Base `8453` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Plasma `9745` | `0xCfBAa9Cfce952Ca4F4069874fF1Df8c05e37a3c7` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x0d14f7c957bd15f5Bec423F9b1B51E122D90Fc76` |
| Arbitrum `42161` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Avalanche `43114` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Ink `57073` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Linea `59144` | `0xA146d46823f3F594B785200102Be5385CAfCE9B5` | `0x82309f58B39C4c27Cf2594801Ba5E8Fd34f641B8` | `0xdf4bb23FE9367F9f66247CE35f82ebB17785528C` |
| Berachain `80094` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0x4Fe93ebC4Ce6Ae4f81601cC7Ce7139023919E003` |
| Plume `98866` | `0x3067BDBa0e6628497d527bEF511c22DA8b32cA3F` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0xdC0f215C6E6cbb900AA00AFDeC299d88C15fF743` |
| Katana `747474` | `0x3067BDBa0e6628497d527bEF511c22DA8b32cA3F` | `0xA2F4f9C6ec598CA8c633024f8851c79CA5F43e48` | `0xdC0f215C6E6cbb900AA00AFDeC299d88C15fF743` |
| Sepolia `11155111` | `0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf` | `0x7663fd40081dcCd47805c00e613B6beAc3B87F08` | - |
| Network | EnsoWalletV2Factory | EnsoWalletV2 implementation |
|---|---|---|
| Ethereum `1` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Optimism `10` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Binance `56` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Gnosis `100` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Unichain `130` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Polygon `137` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Monad `143` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Sonic `146` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| ZkSync `324` | `0x716754ad80A79032999F28c3bcDA608dC5EeDF90` | `0xD872e707E1f09F30Ec0cf20658E6A7fEb7b98B7d` |
| World `480` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Hyper `999` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Sei `1329` | `0x8c224B65f92523fC3df8B162504311B23E03dDba` | `0xA22f65d8799164C2636aFb0BD36a776Bf72Af360` |
| Soneium `1868` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Tempo `4217` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| MegaETH `4326` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Robinhood `4663` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Arc `5042` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Base `8453` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Plasma `9745` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Arbitrum `42161` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Avalanche `43114` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Ink `57073` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Linea `59144` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Berachain `80094` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Plume `98866` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Katana `747474` | `0xC914A663837Eb21c5a650716E015659686597E55` | `0xA04df79c7e91f393B64e7BfECbfFA13A9f9F2829` |
| Network | EnsoRouterFlashloanAdapter (`router`) |
EnsoWalletFlashloanAdapter (`ensowallet-v2`) |
EnsoSafeFlashloanAdapter (`safe`) |
|---|---|---|---|
| Ethereum `1` | `0x66a6dA113AeE7cc1682e41599fFC2d2f492FaB88` | `0x24654fF626B73B276c846459d0bD83ef9271B166` | `0x21c056a4578f36dAF7A7c0181eCa93e53EB75e6A` |
| Optimism `10` | `0x55F26dDd1f55B61ce6495b55e6C9498E3eb36a2f` | `0x41eAe9A93B5f72E899aFaCF389fc1f74e841e354` | `0xFc8837EcFC9EA9761A24629eEEeCB7c53D73dBc0` |
| Binance `56` | `0xb48fC56fC15B4d5770255dE0F0BBD5b1691e510F` | `0x21f7e08aDBf70A93Cc473E3679b609F53418DDf1` | `0x4128e8a87EbEb08899675b7029843dD00F3b60f8` |
| Gnosis `100` | - | - | - |
| Unichain `130` | `0x5b3278a0Fe58c5496b15B1fC67d44d4d90Bb3C16` | `0x47E9994c89E88e8c387AAD19395a06876958c321` | `0x718bDEBA6Bd50F4830B130E9918e3045Da76C985` |
| Polygon `137` | `0x2133cedc35c751A3905Fff6C8555BD1c255FC671` | `0xA0Bb75D2A827aCd8FE45F70B298ecF897cbd98fE` | `0x4a3E0A7E044942CDAFCE0297ef36Fe4eA3227181` |
| Monad `143` | `0x8C2A814789649Fe0F10ff87cE91954a99bf4E022` | `0xa2Aeb0e28fB73E5a5DBC348C3debA4b72bE26DC9` | `0x79C185EDEAb72626427D50274E5CA3d697dD6A5c` |
| Sonic `146` | `0xacc2187a09f80469b7700Ce40E5B7aE70ab37288` | `0xce6D5FC746B9cb9ed8fceF54c7ab5C85A3996670` | `0xB7AcdeA0063144b7D710e6A0ABe2C40C27cf6014` |
| ZkSync `324` | - | - | - |
| World `480` | `0x882fb836F26ac98C2884a4E0a0A20b69A559Bc82` | `0x3819FBe6356ABf6AddDcF51E520C09507AB1FB63` | `0xCDC75847689e82914D8b185fAD0cD170D626139c` |
| Hyper `999` | `0x9f5fE8ae43c43a246EaC572528469767ED28Df58` | `0xDa6b071fD3864675089DD10951c19532D5a50BD1` | `0x4CdDbEe54a7537ea9f6Db14aEB8c2aFdE51fbFf0` |
| Sei `1329` | - | - | - |
| Soneium `1868` | `0x8DdA8F1C511378D3D618E72AbcB311CdFBb7c72E` | `0x8d3CAd582d32969Bc98d61fAE3a4aD30f527b171` | `0xA54272b452dF9E7A8135dB08Fd9d1FB0E4349e55` |
| Tempo `4217` | - | - | - |
| MegaETH `4326` | `0xd0F18846a49af116cbe71D0B9aA4A72A14035994` | `0xd0269e1BA96b4f5c79B4116b7f35C641B6ad806D` | `0x3c104FD1e135F6bF58AB216637A6B7803C2AcC82` |
| Robinhood `4663` | `0x4ee6203F8444F11322B47BFF8a4338E618965354` | `0x1FD99982260c00a035f61301D3254a582b8E5691` | `0x5D484FEAE61680Ac3e22a9Fb6Ad1eab1c86cdE6e` |
| Arc `5042` | `0xB984D4CD8df0c1E105472068cc346E95EE1f8c35` | `0x97Dc177a5a472c82ebBFe9Ae39A03c677568599C` | `0xd977B7d439cC7E1C0Ca3d790bD5480DAD82E1c0B` |
| Base `8453` | `0xC787596E969462abDb70813Be1FaE21C6e7DeD80` | `0x60E5cc50AbecFB82B50550cc402C79622D5180b3` | `0x7AB775FC8927EDebC0819447D75b4da0d2A44552` |
| Plasma `9745` | `0xb8732c7c3EB0D7d2A60a6217a8C8bc75a0235312` | `0x9bF80063a902e2bC1e870139d35214F45eE636dF` | `0x26C4D638555b3ac5961D32716caadFd3e1eBE990` |
| Arbitrum `42161` | `0xb11ab56e8Aa3a33f71374aF8B5791b0f1C70A624` | `0xcbDbF3CF33F3af8866b41A678Cc0e3d2D03C73E6` | `0x5208BCc6836516745dde5eC78b1F622B3D442Dd4` |
| Avalanche `43114` | `0xdaC73b1C14f0E6e3C7cE53b217324Fa9E2C94472` | `0x26765346136C4906FEaf819bb04c3d3C33a5F6e4` | `0x4cFeeeD0a0af4A38549016197e166Ab04B86C209` |
| Ink `57073` | `0xF3A1d35e74673CDf3dB8da2F55300a299425C8A6` | `0x04fB919047Ae39a396Cb3944b504E5b3a45D5654` | `0x3e6A44037f91026117ba7E5106b3ec68D00cA7B9` |
| Linea `59144` | - | - | - |
| Berachain `80094` | `0x8E7E3c038352B0902F28525794478F4e1ACA0115` | `0xdA08A7EF668A19f76352b3E545D40F05b0645d47` | `0x27146d6F54C4318d1c2DA9F209612f2c4aAA7164` |
| Plume `98866` | `0x2Dd9e1649Bb6eAfEc979Edf2123f027E88a1cbf1` | `0x11F854B0D4fAc3433fd8D4246B9C474c796440e5` | `0xa388d9b7ccD8098D7DDaeE28c48f7A5BaD533D55` |
| Katana `747474` | `0x4F9d724B214C4DB1eA30Efaa060B18F1fF9BAd3a` | `0x0eE6B77DDE9017F3e46B7Cb9219e54bD66e35B7D` | `0xDd5c930F182C6252Df34a13AE2Dbe2858ab8a6ba` |
| Network | LayerZeroReceiver | EnsoCCIPReceiver |
|---|---|---|
| Ethereum `1` | `0xbF7773Ad9d1aBCC0a01981e3bff7E6408a775939` | `0x46d0fF229e0a0eA5c4DCc639Ce8f5Cf75967122d` |
| Optimism `10` | `0xbF7773Ad9d1aBCC0a01981e3bff7E6408a775939` | `0x45f8E18B2879E813F51Ff935C43742aC316b7700` |
| Binance `56` | `0xbF7773Ad9d1aBCC0a01981e3bff7E6408a775939` | `0x74dE5135dF38493e1637c268E7e58Daae7937332` |
| Gnosis `100` | `0xbF7773Ad9d1aBCC0a01981e3bff7E6408a775939` | `0x611dA0E509468cEb39db1e28F48Ef63a8054AA79` |
| Unichain `130` | `0xB0a9813b000E8D45E04CbD3e7abb673eBE17c36d` | `0xF222c30589f209A3Da1cb67D8302Dd8a1181FA37` |
| Polygon `137` | `0xbF7773Ad9d1aBCC0a01981e3bff7E6408a775939` | `0x5416b5Da1a832E31bB83BF7F5f3f112CdD02B0FB` |
| Monad `143` | `0xbe0adcC42632df829eD70dfA40D488939D886ACf` | `0xBd1526Eef90712F875f9bf5BE7EF8Ddb4eBb2429` |
| Sonic `146` | `0xB0a9813b000E8D45E04CbD3e7abb673eBE17c36d` | `0x41320ee506761b8FF971c1e5eB4d94C8Fa9be7C5` |
| ZkSync `324` | `0x32755753d0d02A2210eF7A331B43C07a419F6444` | `0x189EDE5Aa3fb2d90e0437052b1e195b97dD2Ae9f` |
| World `480` | `0xB0a9813b000E8D45E04CbD3e7abb673eBE17c36d` | `0x9aCA77030f10c55485Aa5E1406e04E72ba4e965a` |
| Hyper `999` | `0xaB0D527A03Af5626FBf845C6C929d34991634f0e` | `0x3C3378529f39BC601F08BBEb87C72413DCd4E739` |
| Sei `1329` | `0x7A1C91392462c55FB7F2eA98905eA8CeEEA04579` | `0x5b8051C48877d08c890d86054d933BaF24222816` |
| Soneium `1868` | `0xC486d2e656c14a9c0954D7B175F91DA76154FB90` | `0xCD9493861c52e887F3669E78fC8CE97ddE4DAb3f` |
| Tempo `4217` | `0x47A87Fa2249aAe0eCcE782e0356b6Cb7979a0c01` | `0x1A1185368D77E8789A76862345b0cD822df8aF18` |
| MegaETH `4326` | `0xbe0adcC42632df829eD70dfA40D488939D886ACf` | `0x07f1199ed46ae0314DCD8BF1a02cE21b348c497F` |
| Robinhood `4663` | `0xaeE4C3Abf37a379FBd33070a314D331A8941AE3c` | `0x2aB4AdAdCFc106d785bDfae2f863d83ca260b892` |
| Arc `5042` | `0xaeE4C3Abf37a379FBd33070a314D331A8941AE3c` | `0x0576400f1e3bcA8eC1cdCF81caA9293ADc07DbEB` |
| Base `8453` | `0xbF7773Ad9d1aBCC0a01981e3bff7E6408a775939` | `0xf0De2DaD7d10273d59ceA9aD7eDbB18070cA7105` |
| Plasma `9745` | `0xbe0adcC42632df829eD70dfA40D488939D886ACf` | `0x206eC253b9a26f5b6b565ba3B4EB039c88BE4596` |
| Arbitrum `42161` | `0xbF7773Ad9d1aBCC0a01981e3bff7E6408a775939` | `0xa31E1D91E6FF7b7eDF6841D9914F2A31d638c9c8` |
| Avalanche `43114` | `0xbF7773Ad9d1aBCC0a01981e3bff7E6408a775939` | `0xd60707E1dc74FF5C91E89C74b26964CaD49d2E32` |
| Ink `57073` | `0x508FFd4cEAf7a5556b61817456b2d0f220DA79A3` | `0x21d8786ac4aa2c0db259A0c6e44E827A54de1B8a` |
| Linea `59144` | `0x06A23c1bB3F8b7b055Ede21Af66eEAf0E40c1D59` | `0xF7630285184768f575699B8e6B3Ca58CA2046d41` |
| Berachain `80094` | `0xB0a9813b000E8D45E04CbD3e7abb673eBE17c36d` | `0xEEA06801d20D898465887AbaF510675F79d872FE` |
| Plume `98866` | `0x9538527a14936681a4B545cCFc4784Bff36875b0` | `0x80E3FD89840aE6d34D50576a8757aEaB9D15Ec04` |
| Katana `747474` | `0x090db4bAD7Cd034083e7da27c76f6649C7285E55` | `0xfE9B4ECeE3d8D752865d5a9c8C3012F2c5ab0D9B` |
| Network | UniswapV4Helpers | UniswapV4SwapHelpers |
|---|---|---|
| Ethereum `1` | `0x1ab9a6D2192407a5B641DA1f809a3B81c2e27237` | `0x4A381087756b8CCaA7c89Cf041D044ff387a8C2b` |
| Optimism `10` | `0x004177fd57f4FF78c7541cCBCC35C8E96DE54D78` | `0x12c7bAc2Ec4cd4921Fa0748ECC572D5d77085647` |
| Binance `56` | `0x65BB51C4FFe70fcCF7D431e435907Be7320327b3` | `0xa5c0c7b103b38520032a3468D5f825d3643D3bE4` |
| Unichain `130` | `0x2913B0067862635e3070003dd47b9BD8271C35A7` | `0xa4Bf9419D7Aa47143f41EE62a3a790CC5b09c38c` |
| Polygon `137` | `0x151fC2b1E5eA5611eD9dA6323012a72Dfc60014B` | `0xf30e9F2266c748Da73D1f926001D9D231ddd86b1` |
| Monad `143` | `0x6d30D04E8f89a0e2cAbB8c292b4a2f631D1783E2` | `0x02256aE59EaCa4C7Bd77E908B63F642E10DD23F5` |
| World `480` | `0x2913B0067862635e3070003dd47b9BD8271C35A7` | `0x0158b1a05b5Ae87F255D227f5752659FdA6Cd6Cd` |
| Soneium `1868` | `0x2913B0067862635e3070003dd47b9BD8271C35A7` | `0xe03E6FA95874B5F09d8EBFEeE278558652Ad819e` |
| Tempo `4217` | `0xc56d1694eb8Ab55b81178A38D8E4D401f92AA7bb` | `0x1d45d0F3135e7D9dc5D9c98EC7dD3dAa29168516` |
| Robinhood `4663` | `0x03279866e8c3afDe201242462F3bCbf16a2Aa327` | `0x516C5c15CB5569E37602A689BdbB73aDb841B32F` |
| Arc `5042` | `0x03279866e8c3afDe201242462F3bCbf16a2Aa327` | `0x2a1315187E205B9C5301C38D6b2BFd3e08Ba70fD` |
| Base `8453` | `0xe3E970560026be21fB546a85368B78096B6311a0` | `0xffc000363232b5e46657fc3Ad5C5672aaab83fB3` |
| Arbitrum `42161` | `0xca5D736E51f706A0A9b9069154F536d722c6e0d9` | `0xC0c89BC290e4Ddb1C46f3896c17716e84d55c615` |
| Avalanche `43114` | `0x853e8798DA3B06c05ebF44Fc24cc005714eA988a` | `0x68520E9a218086f95396d280145b091d03099410` |
| Ink `57073` | `0x2913B0067862635e3070003dd47b9BD8271C35A7` | `0x22c8EA6D5c17225e9168F080891773a849E87BA1` |
| Network | Router V1 | Delegate V1 |
|---|---|---|
| Ethereum `1` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Optimism `10` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Binance `56` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Gnosis `100` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Unichain `130` | - | - |
| Polygon `137` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Monad `143` | - | - |
| Sonic `146` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| ZkSync `324` | `0xd12ecDD67300D5ef0A68576CfDF038bAB5b5054a` | `0x43BD12326142568D5Cc33c7326A68Ca4e0be9292` |
| World `480` | - | - |
| Hyper `999` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Sei `1329` | - | - |
| Soneium `1868` | - | - |
| Tempo `4217` | - | - |
| MegaETH `4326` | - | - |
| Robinhood `4663` | - | - |
| Arc `5042` | - | - |
| Base `8453` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Plasma `9745` | - | - |
| Arbitrum `42161` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Avalanche `43114` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Ink `57073` | - | - |
| Linea `59144` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Berachain `80094` | `0x80EbA3855878739F4710233A8a19d89Bdd2ffB8E` | `0x38147794FF247e5Fc179eDbAE6C37fff88f68C52` |
| Plume `98866` | - | - |
| Katana `747474` | - | - |
| Sepolia `11155111` | - | - |
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
Updated
2. The user initiates the migration.
2.1. The user initiates the migration.
Enso issues a [transaction bundle](/pages/build/get-started/bundling-actions) that:
2.2. [Redeems](/pages/build/reference/actions#redeem) the assets underlying the user's position on Uniswap V3.
2.3. Swaps the assets to bridge tokens.
3. Bridging takes place
3.1. Enso sends the assets to Stargate.
3.2. Stargate bridges them to the destination chain.
3.3. Stargate notifies Layer0, which notifies Enso.
4. Enso issues a transaction on the destination chain that deposits the assets into the destination V4 pool.
Updated
Updated
redeem| yHONEY((yHONEY)) yHONEY -->|bearn
redeem| HONEY((HONEY)) HONEY -->|openocean
swap| BERA((BERA)) ``` ```javascript theme={null} import { Address, EnsoClient, RouteParams } from "@ensofinance/sdk"; const BERACHAIN_MAINNET = 80094; const userAddress = "your-wallet-address" as Address; const styHONEY = "0x99d6A0FB9420F3995fD07dCc36AC827a8E146cf9" as Address; const yHONEY = "0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC" as Address; const HONEY = "0xfcbd14dc51f0a4d49d5e53c2e0950e0bc26d0dce" as Address; const BERA = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_MAINNET, amountIn: ["1000000000000000000"], // 1 styHONEY tokenIn: [styHONEY], tokenOut: [BERA], routingStrategy: "delegate", slippage: "300", // 3% slippage for redemption referralCode: "styhoney-bera", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` *** ### Withdraw Yearn Curve mUSD Vault to USDC Unwind a Yearn Curve `mUSD` vault position back to the base asset, `USDC`, on Ethereum. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0x8cc94ccd0f3841a468184aca3cc478d2148e1757\&tokenOut=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) ```javascript theme={null} const CurveMUSD_yVault = "0x8cc94ccd0f3841a468184aca3cc478d2148e1757" as Address; // Yearn Curve mUSD Pool yVault const USDC = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // Example amount for yVault token tokenIn: [CurveMUSD_yVault], tokenOut: [USDC], routingStrategy: "delegate", slippage: "100", // 1% slippage }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Redeem from Yearn Curve mUSD Pool yVault ( `0x8cc94ccd0f3841a468184aca3cc478d2148e1757` ) to receive Curve mUSD LP tokens * Redeem from Curve.fi mUSD Pool ( `0x8474ddbe98f5aa3179b3b3f5942d724afcdec9f6` ) to receive Curve 3pool LP tokens * Redeem from Curve.fi 3pool ( `0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7` ) to receive USDC *** ### Withdraw Yearn Curve alUSD Vault to USDC Unwind a Yearn Curve `alUSD` vault position back to the base asset, `USDC`, on Ethereum. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xa74d4b67b3368e83797a35382afb776baae4f5c8\&tokenOut=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48) ```javascript theme={null} const CurveAlUSD_yVault = "0xa74d4b67b3368e83797a35382afb776baae4f5c8" as Address; // Yearn Curve alUSD Pool yVault const USDC = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // Example amount for yVault token tokenIn: [CurveAlUSD_yVault], tokenOut: [USDC], routingStrategy: "delegate", slippage: "100", // 1% slippage }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Redeem from Yearn Curve alUSD Pool yVault ( `0xa74d4b67b3368e83797a35382afb776baae4f5c8` ) to receive Curve alUSD LP tokens * Redeem from Curve.fi alUSD Pool ( `0x43b4fdfd4ff969587185cdb6f0bd875c5fc83f8c` ) to receive Curve 3pool LP tokens * Redeem from Curve.fi 3pool ( `0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7` ) to receive USDC *** ### Withdraw Rooster LP (nALPHA/pUSD) to Native Plume Completely unwind a Rooster YAP LP (`nALPHA`/`pUSD`) position back to the native `Plume` token on Plume. [**Try this route →**](https://happypath.enso.build/?chainId=98866\&tokenIn=0xfc3bd0e01b4e755aedd2a4087ccdb90c4d28f038\&tokenOut=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee) ```javascript theme={null} const ROOSTER_YAP_NALPHA_PUSD = "0xfc3bd0e01b4e755aedd2a4087ccdb90c4d28f038" as Address; const PLUME = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ROOSTER_CHAIN, amountIn: ["100000000000000000000"], // 100 Rooster YAP tokens tokenIn: [ROOSTER_YAP_NALPHA_PUSD], tokenOut: [PLUME], routingStrategy: "delegate", slippage: "100", // 1% slippage referralCode: "rooster-exit-native", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Redeem Rooster YAP pool tokens to underlying PUSD and nALPHA * Merge tokens using the enso.merge action * Swap PUSD to native Plume via internal exchange * Swap nALPHA to native Plume via internal exchange * Consolidate native Plume tokens in user wallet *** ### Unstake kHYPE to USDT0 Unstake `kHYPE` and convert the underlying assets to the `USDT0` stablecoin on HyperEVM. [**Try this route →**](https://happypath.enso.build/?chainId=999\&tokenIn=0xfd739d4e423301ce9385c1fb8850539d657c296d\&tokenOut=0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb) ```javascript theme={null} const KHYPE = "0xfd739d4e423301ce9385c1fb8850539d657c296d" as Address; const USDT0 = "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: HYPEREVM_CHAIN, amountIn: ["1000000000000000000"], // 1 kHYPE tokenIn: [KHYPE], tokenOut: [USDT0], routingStrategy: "delegate", slippage: "100", // 1% slippage referralCode: "kinetiq-withdraw", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Unstake kHYPE to HYPE via Kinetiq Protocol * Swap HYPE to USDT0 via internal exchange * Transfer USDT0 to user wallet *** ### Unstake kHYPE to Native HYPE Unstake `kHYPE` back to the native `HYPE` token on HyperEVM. [**Try this route →**](https://happypath.enso.build/?chainId=999\&tokenIn=0xfd739d4e423301ce9385c1fb8850539d657c296d\&tokenOut=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee) ```javascript theme={null} const KHYPE = "0xfd739d4e423301ce9385c1fb8850539d657c296d" as Address; const HYPE = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: HYPEREVM_CHAIN, amountIn: ["1000000000000000000"], // 1 kHYPE tokenIn: [KHYPE], tokenOut: [HYPE], routingStrategy: "delegate", slippage: "50", // 0.5% slippage referralCode: "kinetiq-unstake-native", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Unstake kHYPE to native HYPE. *** ### Unstake kHYPE to KEI Unstake `kHYPE` and convert the underlying assets to Wrapped Ethereum (`KEI`) on HyperEVM. [**Try this route →**](https://happypath.enso.build/?chainId=999\&tokenIn=0xfd739d4e423301ce9385c1fb8850539d657c296d\&tokenOut=0xb5fe77d323d69eb352a02006ea8ecc38d882620c) ```javascript theme={null} const KHYPE = "0xfd739d4e423301ce9385c1fb8850539d657c296d" as Address; const KEI = "0xb5fe77d323d69eb352a02006ea8ecc38d882620c" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: HYPEREVM_CHAIN, amountIn: ["1000000000000000000"], // 1 kHYPE tokenIn: [KHYPE], tokenOut: [KEI], routingStrategy: "delegate", slippage: "100", // 1% slippage referralCode: "kinetiq-unstake-weth", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Unstake kHYPE to HYPE and swap to KEI (WETH). *** ### Unstake kHYPE to UBTC Unstake `kHYPE` and convert the underlying assets to Wrapped Bitcoin (`UBTC`) on HyperEVM. [**Try this route →**](https://happypath.enso.build/?chainId=999\&tokenIn=0xfd739d4e423301ce9385c1fb8850539d657c296d\&tokenOut=0x9fdbda0a5e284c32744d2f17ee5c74b284993463) ```javascript theme={null} const KHYPE = "0xfd739d4e423301ce9385c1fb8850539d657c296d" as Address; const UBTC = "0x9fdbda0a5e284c32744d2f17ee5c74b284993463" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: HYPEREVM_CHAIN, amountIn: ["1000000000000000000"], // 1 kHYPE tokenIn: [KHYPE], tokenOut: [UBTC], routingStrategy: "delegate", slippage: "100", // 1% slippage referralCode: "kinetiq-unstake-wbtc", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Unstake kHYPE to HYPE and swap to UBTC. ### Zap PLUME into Mystic myUSDC Vault Deposit native PLUME and convert it into a myUSDC vault position on Mystic. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x6c92efa3F77760619bb13d395836415ac18C86dc) ```javascript theme={null} // SDK Example const client = new EnsoClient({ apiKey: 'your-api-key' }); const routeData = await client.getRouteData({ fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', chainId: 98866, amountIn: ['1000000000000000000'], slippage: '300', tokenIn: ['0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'], tokenOut: ['0x6c92efa3F77760619bb13d395836415ac18C86dc'], routingStrategy: 'router' }); // If using 'router' strategy, approval is often required for the input token. await sendEoa(client.getApprovalData(routeData.route.tokenIn[0])); await sendEoa(routeData.tx, routeData.gas); ``` **Route Mechanics:** * swap PLUME (input token) for USDC.e * deposit USDC.e into the myUSDC pool, interacting with primary `0xCE192A6E105cD8dd97b8Dedc5B5b263B52bb6AE0` *** ### Deposit native PLUME into Solera aPlunALPHA Deposit native PLUME and convert it into a Solera aPlunALPHA vault position. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x5d0EC9B10e6759719CeFE14b8c881634678b32f2) ```javascript theme={null} // SDK Example const client = new EnsoClient({ apiKey: 'your-api-key' }); const routeData = await client.getRouteData({ fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', chainId: 98866, amountIn: ['1000000000000000'], slippage: '300', tokenIn: ['0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'], tokenOut: ['0x5d0EC9B10e6759719CeFE14b8c881634678b32f2'], routingStrategy: 'router' }); // If using 'router' strategy, approval is often required for the input token. await sendEoa(client.getApprovalData(routeData.route.tokenIn[0])); await sendEoa(routeData.tx, routeData.gas); ``` **Route Mechanics:** * swap PLUME for PUSD using `enso.swap` action * deposit `PUSD` into `NALPHA Nucleus` pool, interacting with primary `0xc9f6a492fb1d623690dc065bbced6dfb4a324a35` * deposit `NALPHA` into the `Solera` pool, interacting with primary `0x5d0ec9b10e6759719cefe14b8c881634678b32f2` *** ### Deposit USDC.e into Nucleus nYIELD Vault Deposit bridged USDC.e and convert it into an nYIELD vault position on Nucleus. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0x78adD880A697070c1e765Ac44D65323a0DcCE913\&tokenOut=0x892DFf5257B39f7afB7803dd7C81E8ECDB6af3E8) ```javascript theme={null} // SDK Example const client = new EnsoClient({ apiKey: 'your-api-key' }); const routeData = await client.getRouteData({ fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', chainId: 98866, amountIn: ['1000000000'], slippage: '300', tokenIn: ['0x78adD880A697070c1e765Ac44D65323a0DcCE913'], tokenOut: ['0x892DFf5257B39f7afB7803dd7C81E8ECDB6af3E8'], routingStrategy: 'delegate' }); await sendSmartWallet(routeData.tx, routeData.gas); ``` **Route Mechanics:** * swap `USDC` for `PUSD` using `enso.swap` action * deposit `PUSD` into `nYIELD Nucleus` pool, interacting with primary `0x92a735f600175fe9ba350a915572a86f68ebbe66` to get `nUSDY` *** ### Deposit USDC.e into Tempest PUSD Vault Deposit bridged USDC.e and convert it into a Tempest PUSD vault position. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0x78adD880A697070c1e765Ac44D65323a0DcCE913\&tokenOut=0x3C4F9804ce0810821F61289Eb4F92c8E5007c119) ```javascript theme={null} // SDK Example const client = new EnsoClient({ apiKey: 'your-api-key' }); const routeData = await client.getRouteData({ fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', chainId: 98866, amountIn: ['1000000000'], slippage: '300', tokenIn: ['0x78adD880A697070c1e765Ac44D65323a0DcCE913'], tokenOut: ['0x3C4F9804ce0810821F61289Eb4F92c8E5007c119'], routingStrategy: 'delegate' }); await sendSmartWallet(routeData.tx, routeData.gas); ``` **Route Mechanics:** * swap `USDC.e` for `PUSD` using `enso.swap` action * deposit `PUSD` into `Tempest pool`, interacting with primary `0x3C4F9804ce0810821F61289Eb4F92c8E5007c119` *** ### Stake PLUME for pETH on Dinero Deposit native PLUME and convert it into the pETH liquid staking derivative on Dinero. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x39d1F90eF89C52dDA276194E9a832b484ee45574) ```javascript theme={null} // SDK Example const client = new EnsoClient({ apiKey: 'your-api-key' }); const routeData = await client.getRouteData({ fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', chainId: 98866, amountIn: ['1000000000'], slippage: '300', tokenIn: ['0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'], tokenOut: ['0x39d1F90eF89C52dDA276194E9a832b484ee45574'], routingStrategy: 'delegate' }); await sendSmartWallet(routeData.tx, routeData.gas); ``` *** ### Deposit PUSD into Rooster (nALPHA/PUSD) LP Deposit PUSD and convert it into a Rooster (nALPHA/PUSD) LP position. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0xdddd73f5df1f0dc31373357beac77545dc5a6f3f\&tokenOut=0xfc3bd0e01b4e755aedd2a4087ccdb90c4d28f038) ```javascript theme={null} // SDK Example const client = new EnsoClient({ apiKey: 'your-api-key' }); const routeData = await client.getRouteData({ fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', chainId: 98866, amountIn: ['1000000000'], slippage: '300', tokenIn: ['0xdddd73f5df1f0dc31373357beac77545dc5a6f3f'], tokenOut: ['0xfc3bd0e01b4e755aedd2a4087ccdb90c4d28f038'], routingStrategy: 'delegate' }); await sendSmartWallet(routeData.tx, routeData.gas); ``` **Route Mechanics:** * split `PUSD` to `NALPHA` and `PUSD` using the `enso.split` action * deposit `NALPHA` and `PUSD` into the `Rooster pool`, interacting with primary `0xfc3bd0e01b4e755aedd2a4087ccdb90c4d28f038` *** ### Deposit WETH into the Nest Alpha Vault Deposit WETH and convert it into a Nest Alpha Vault position. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0xca59ca09e5602fae8b629dee83ffa819741f14be\&tokenOut=0x593ccca4c4bf58b7526a4c164ceef4003c6388db) ```javascript theme={null} // SDK Example const client = new EnsoClient({ apiKey: 'your-api-key' }); const routeData = await client.getRouteData({ fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', chainId: 98866, amountIn: ['1000000000'], slippage: '300', tokenIn: ['0xca59ca09e5602fae8b629dee83ffa819741f14be'], tokenOut: ['0x593ccca4c4bf58b7526a4c164ceef4003c6388db'], routingStrategy: 'delegate' }); await sendSmartWallet(routeData.tx, routeData.gas); ``` **Route Mechanics:** * swap `WETH` for `PUSD` using the `enso.swap` action * deposit `PUSD` into the `Nest Vault`, interacting with primary `0xc9f6a492fb1d623690dc065bbced6dfb4a324a35` *** ### Deposit USDC to get yDAI (Yearn) Convert USDC to DAI and deposit it into the Yearn DAI v2 Vault. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\&tokenOut=0xda816459f1ab5631232fe5e97a05bbbb94970c95) ```javascript theme={null} const USDC = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" as Address; const yvDAI = "0xda816459f1ab5631232fe5e97a05bbbb94970c95" as Address; // Yearn DAI v2 Vault token const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000"], // 1000 USDC tokenIn: [USDC], tokenOut: [yvDAI], routingStrategy: "delegate", slippage: "100", // 1% slippage }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `USDC` to `DAI` via Enso DEX Aggregator * Deposit `DAI` into Yearn DAI v2 Vault (`0xda816459f1ab5631232fe5e97a05bbbb94970c95`) *** ### HONEY to yHONEY Zap Deposit HONEY into the Bearn yHONEY vault. [**Try this route →**](https://happypath.enso.build?chainId=80094\&tokenIn=0xfcbd14dc51f0a4d49d5e53c2e0950e0bc26d0dce\&tokenOut=0xc82971bcff09171e16ac08aee9f4ea3fb16c3bdc) ```javascript theme={null} import { Address, EnsoClient, RouteParams } from "@ensofinance/sdk"; const BERACHAIN_MAINNET = 80094; const userAddress = "your-wallet-address" as Address; const HONEY = "0xfcbd14dc51f0a4d49d5e53c2e0950e0bc26d0dce" as Address; const yHONEY = "0xc82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_MAINNET, amountIn: ["1000000000000000000"], // 1 HONEY tokenIn: [HONEY], tokenOut: [yHONEY], routingStrategy: "delegate", slippage: "50", // 0.5% slippage for stable yield referralCode: "bearn-deposit", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `HONEY` to `HONEY` through Enso's routing. * Deposit `HONEY` into Bearn yHONEY vault. *** ### BERA to yHONEY Yield Zap Convert native BERA into a Bearn yHONEY vault position. [**Try this route →**](https://happypath.enso.build?chainId=80094\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC) ```javascript theme={null} import { Address, EnsoClient, RouteParams } from "@ensofinance/sdk"; const BERACHAIN_MAINNET = 80094; const userAddress = "your-wallet-address" as Address; const BERA = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE" as Address; const yHONEY = "0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_MAINNET, amountIn: ["1500000000000000000"], // 1.5 BERA tokenIn: [BERA], tokenOut: [yHONEY], routingStrategy: "delegate", slippage: "100", // 1% slippage referralCode: "bera-yhoney", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `BERA` to `HONEY` through Enso's routing. * Deposit `HONEY` into Bearn yHONEY vault. *** ### USDCe to yHONEY Vault Zap Convert bridged USDC.e into a Bearn yHONEY vault position. [**Try this route →**](https://happypath.enso.build?chainId=80094\&tokenIn=0x549943e04f40284185054145c6E4e9568C1D3241\&tokenOut=0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC) ```javascript theme={null} import { Address, EnsoClient, RouteParams } from "@ensofinance/sdk"; const BERACHAIN_MAINNET = 80094; const userAddress = "your-wallet-address" as Address; const USDCe = "0x549943e04f40284185054145c6E4e9568C1D3241" as Address; const HONEY = "0xfcbd14dc51f0a4d49d5e53c2e0950e0bc26d0dce" as Address; const yHONEY = "0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_MAINNET, amountIn: ["1000000000"], // 1,000 USDCe tokenIn: [USDCe], tokenOut: [yHONEY], routingStrategy: "delegate", slippage: "200", // 2% slippage for bridge + swap referralCode: "bridge-yhoney", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `USDCe` to `HONEY` through Enso's routing. * Deposit `HONEY` into Bearn yHONEY vault. *** ### iBGT to yHONEY Vault Zap Convert iBGT governance tokens into a Bearn yHONEY vault position. [**Try this route →**](https://happypath.enso.build?chainId=80094\&tokenIn=0xac03CABA51e17c86c921E1f6CBFBdC91F8BB2E6b\&tokenOut=0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC) ```javascript theme={null} import { Address, EnsoClient, RouteParams } from "@ensofinance/sdk"; const BERACHAIN_MAINNET = 80094; const userAddress = "your-wallet-address" as Address; const iBGT = "0xac03CABA51e17c86c921E1f6CBFBdC91F8BB2E6b" as Address; const yHONEY = "0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_MAINNET, amountIn: ["500000000000000000"], // 0.5 iBGT tokenIn: [iBGT], tokenOut: [yHONEY], routingStrategy: "delegate", slippage: "400", // 4% slippage for governance token referralCode: "ibgt-yield", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `iBGT` to `HONEY` through Enso's routing. * Deposit `HONEY` into Bearn `yHONEY` vault. *** ### YEET to styHONEY Yield Zap Convert YEET tokens into a staked yield position (styHONEY). [**Try this route →**](https://happypath.enso.build?chainId=80094\&tokenIn=0x08A38Caa631DE329FF2DAD1656CE789F31AF3142\&tokenOut=0x99d6A0FB9420F3995fD07dCc36AC827a8E146cf9) ```javascript theme={null} import { Address, EnsoClient, RouteParams } from "@ensofinance/sdk"; const BERACHAIN_MAINNET = 80094; const userAddress = "your-wallet-address" as Address; const YEET = "0x08A38Caa631DE329FF2DAD1656CE789F31AF3142" as Address; const styHONEY = "0x99d6A0FB9420F3995fD07dCc36AC827a8E146cf9" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_MAINNET, amountIn: ["100000000000000000000"], // 100 YEET tokenIn: [YEET], tokenOut: [styHONEY], routingStrategy: "delegate", slippage: "500", // 5% slippage for volatile meme token referralCode: "yeet-styhoney", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `YEET` to `HONEY` through Enso's routing. * Deposit `HONEY` into Bearn `yHONEY` vault. * Stake `yHONEY` to receive `styHONEY`. *** ### Layer AUSD into Morpho bbqAUSD Vault Deposit AUSD into a Yearn vault and subsequently into a Morpho Blue bbqAUSD vault. [**Try this route →**](https://happypath.enso.build?chainId=747474\&tokenIn=0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a\&tokenOut=0xdE6a4F28Acfe431DD1CfA2D9c7A3d8301624a841) ```mermaid theme={null} flowchart LR yvUSDC_v3((yvUSDC_v3)) --> A1 A1[yearn-v3.redeem] --> USDC_bridged((USDC_bridged)) A2[vault-bridge.redeem] --> USDC_native((USDC_native)) A3[vault-bridge.deposit] --> USDC_bridged_new((USDC_bridged)) A4[morpho-blue-vaults.deposit] --> morphoUSDC((morphoUSDC)) USDC_bridged --> A2 USDC_native --> A3 USDC_bridged_new --> A4 ``` ```javascript theme={null} import { Address, EnsoClient, RouteParams } from "@ensofinance/sdk"; const KATANA_MAINNET = 747474; const userAddress = "your-wallet-address" as Address; const AUSD = "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a" as Address; const bbqAUSD = "0xdE6a4F28Acfe431DD1CfA2D9c7A3d8301624a841" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: KATANA_MAINNET, amountIn: ["1000000000"], // 1,000 AUSD tokenIn: [AUSD], tokenOut: [bbqAUSD], routingStrategy: "delegate", slippage: "150", // 1.5% slippage for multi-step referralCode: "ausd-morpho", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Deposit AUSD into Yearn AUSD vault to receive yvAUSD. * Deposit yvAUSD into Morpho Blue bbqAUSD vault for enhanced yield. *** ### USDS to steakUSDC Prime Vault Convert USDS into a Morpho Steakhouse prime USDC vault position. [**Try this route →**](https://happypath.enso.build?chainId=747474\&tokenIn=0x203a662b0bd271a6ed5a60edfbd04bfce608fd36\&tokenOut=0x61d4f9d3797ba4da152238c53a6f93fb665c3c1d) ```javascript theme={null} const USDC_VB = "0x203a662b0bd271a6ed5a60edfbd04bfce608fd36" as Address; // Assuming USDS input is USDC_VB const steakUSDC = "0x61d4f9d3797ba4da152238c53a6f93fb665c3c1d" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: KATANA_MAINNET, amountIn: ["1000000000"], // 1,000 USDS tokenIn: [USDC_VB], tokenOut: [steakUSDC], routingStrategy: "delegate", slippage: "150", // 1.5% slippage for prime vault referralCode: "usds-prime", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Convert USDC to USDS for stablecoin diversification. * Deposit USDS into Yearn vault for base yield. * Deposit vault tokens into Morpho steakUSDC prime vault. *** ### Convert LBTC into Yearn WBTC Vault Convert Liquid Bitcoin (LBTC) into a Yearn WBTC vault position. [**Try this route →**](https://happypath.enso.build?chainId=747474\&tokenIn=0x203a662b0bd271a6ed5a60edfbd04bfce608fd36\&tokenOut=0x61d4f9d3797ba4da152238c53a6f93fb665c3c1d) ```javascript theme={null} const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: KATANA_MAINNET, amountIn: ["100000000"], // 1 LBTC tokenIn: [LBTC], tokenOut: [yvvbWBTC], routingStrategy: "delegate", slippage: "200", // 2% slippage for BTC yield referralCode: "lbtc-yield", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Convert LBTC to WBTC through liquidity protocols. * Deposit WBTC into Yearn vault for Bitcoin yield farming. *** ### Compound KAT Rewards into Yearn USDC Vault Convert KAT reward tokens into a Yearn USDC vault position. [**Try this route →**](https://happypath.enso.build?chainId=747474\&tokenIn=0x7f1f4b4b29f5058fa32cc7a97141b8d7e5abdc2d\&tokenOut=0x80c34bd3a3569e126e7055831036aa7b212cb159) ```javascript theme={null} const KAT = "0x7f1f4b4b29f5058fa32cc7a97141b8d7e5abdc2d" as Address; const yvvbUSDC = "0x80c34bd3a3569e126e7055831036aa7b212cb159" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: KATANA_MAINNET, amountIn: ["10000000000000000000000"], // 10,000 KAT tokenIn: [KAT], tokenOut: [yvvbUSDC], routingStrategy: "delegate", slippage: "500", // 5% slippage for native token referralCode: "kat-compound", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Convert KAT rewards to USDC through DEX protocols. * Deposit USDC into Yearn vault for optimized yield. * Compound rewards automatically through vault strategies. *** ### Zap PUSD into Rooster Stablecoin LP (USDT/pUSD) Deposit PUSD to create a stablecoin LP position (USDT/pUSD) on Rooster Finance. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0xdddd73f5df1f0dc31373357beac77545dc5a6f3f\&tokenOut=0xd5c02efe86ebbc03126281e07b4d43f0b1021065) ```javascript theme={null} const PLUME_USD = "0xdddd73f5df1f0dc31373357beac77545dc5a6f3f" as Address; const ROOSTER_YAP_USDT_PUSD = "0xd5c02efe86ebbc03126281e07b4d43f0b1021065" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ROOSTER_CHAIN, amountIn: ["100000000000000000000"], // 100 PUSD tokenIn: [PLUME_USD], tokenOut: [ROOSTER_YAP_USDT_PUSD], routingStrategy: "delegate", slippage: "50", // 0.5% slippage referralCode: "rooster-usdt-pusd", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Split Plume USD between USDT and pUSD paths using the `enso.split` action * Swap portion of PUSD to USDT via internal exchange * Keep portion as pUSD (direct conversion) * Deposit USDT and pUSD into Rooster YAP stablecoin liquidity pool *** ### Zap Plume USD into Rooster (nALPHA/pUSD) LP Deposit Plume USD to create a balanced LP position (nALPHA/pUSD) on Rooster Finance. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0xdddd73f5df1f0dc31373357beac77545dc5a6f3f\&tokenOut=0xfc3bd0e01b4e755aedd2a4087ccdb90c4d28f038) ```javascript theme={null} const PLUME_USD = "0xdddd73f5df1f0dc31373357beac77545dc5a6f3f" as Address; const ROOSTER_YAP_NALPHA_PUSD = "0xfc3bd0e01b4e755aedd2a4087ccdb90c4d28f038" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ROOSTER_CHAIN, amountIn: ["100000000000000000000"], // 100 PUSD tokenIn: [PLUME_USD], tokenOut: [ROOSTER_YAP_NALPHA_PUSD], routingStrategy: "delegate", slippage: "100", // 1% slippage referralCode: "rooster-nalpha-pusd", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Split `Plume USD` between `pUSD` and `nALPHA` paths using the `enso.split` action * Keep portion as `pUSD` (direct conversion) * Swap portion of `PUSD` to `nALPHA` via internal exchange * Deposit `pUSD` and `nALPHA` into Rooster YAP `nALPHA/pUSD` pool *** ### Zap Plume Native into Rooster (USDC.e/XAUM) LP Deposit native `PLUME` to create a multi-asset LP position (USDC.e/XAUM) on Rooster Finance. [**Try this route →**](https://happypath.enso.build?chainId=98866\&tokenIn=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\&tokenOut=0xd9822928f894b12e5e4ea1ec2890ac233b9fd871) ```javascript theme={null} const PLUME = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" as Address; const ROOSTER_YAP_USDC_XAUM = "0xd9822928f894b12e5e4ea1ec2890ac233b9fd871" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ROOSTER_CHAIN, amountIn: ["100000000000000000000"], // 100 PLUME tokenIn: [PLUME], tokenOut: [ROOSTER_YAP_USDC_XAUM], routingStrategy: "delegate", slippage: "100", // 1% slippage referralCode: "rooster-yap-zap", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Split native `PLUME` between `USDC.e` and `XAUM` conversion paths using the `enso.split` action * Swap portion of `PLUME` to `USDC.e` via internal exchange * Swap portion of `PLUME` to XAUM via internal exchange * Deposit `USDC.e` and `XAUM` into Rooster `YAP-USDC.e-XAUM` pool *** ### Convert UETH to Staked HYPE (kHYPE) Convert UETH stablecoin into a staked HYPE position (kHYPE). [**Try this route →**](https://happypath.enso.build?chainId=999\&tokenIn=0xbe6727b535545c67d5caa73dea54865b92cf7907\&tokenOut=0xfd739d4e423301ce9385c1fb8850539d657c296d) ```javascript theme={null} const UETH = "0xbe6727b535545c67d5caa73dea54865b92cf7907" as Address; const KHYPE = "0xfd739d4e423301ce9385c1fb8850539d657c296d" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: HYPEREVM_CHAIN, amountIn: ["1000000000000000000"], // 1 DAI tokenIn: [UETH], tokenOut: [KHYPE], routingStrategy: "delegate", slippage: "100", // 1% slippage referralCode: "kinetiq-dai-stake", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `UETH` for `HYPE` and stake to `kHYPE`. # Zap to Deposit Source: https://docs.enso.build/pages/use-cases/deposits/zap-to-deposit Maximize user deposits by accepting any token and zapping it directly into a staking or vault position ## Zap 3Crv LP into Convex Finance This use case allows a user to stake Curve LP tokens in Convex for boosted rewards. **Bundle Mechanics:** This is a multi-step bundle * it redeems the 3Crv from curve-dex to get USDT. * it deposits the USDT back into curve-dex for a different LP token, * deposits the resulting token into the convex-lp protocol to get the final cvx3Crv token. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0x6c3F90f043a72FA612cbac8115EE7e52BDe6E490\&tokenOut=0xa1c3492b71938e144ad8be4c2fb6810b01a43dd8) ```mermaid theme={null} flowchart LR 3CRV((3CRV)) -->|curve-dex
redeem| USDT((USDT)) USDT -->|curve-dex
deposit| STECRV((steCRV)) STECRV -->|convex-lp
deposit| cvxSTECRV((cvxsteCRV)) ``` ```ts theme={null} export async function deposit3crvToConvex(): Promise<{ route: any; tx: any }> { const ThreeCrv: Address = "0x6c3F90f043a72FA612cbac8115EE7e52BDe6E490"; const cvx3Crv: Address = "0xa1c3492b71938e144ad8be4c2fb6810b01a43dd8"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // 1 3Crv tokenIn: [ThreeCrv], tokenOut: [cvx3Crv], routingStrategy: 'router' }; happyPathLog(routeParams); const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Zap into Infrared iETH on Berachain This use case allows a user to zap into the Infrared liquid restaking token on Berachain. [**Try this route →**](https://happypath.enso.build?chainId=80094\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x9b6761bf2397bb5a6624a856cc84a3a14dcd3fe5) **Bundle Mechanics:** The bundle consists of a single action: * a swap from BERA to iBERA using the ooga-booga protocol ```mermaid theme={null} flowchart LR BERA((BERA)) -->|ooga-booga
swap| iBERA((iBERA)) ``` ```ts theme={null} export async function depositBeraToInfrared(): Promise<{ route: any; tx: any }> { const BERA: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const iBERA: Address = "0x9b6761bf2397bb5a6624a856cc84a3a14dcd3fe5"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_CHAIN, amountIn: ["1000000000000000000"], // 1 BERA tokenIn: [BERA], tokenOut: [iBERA], routingStrategy: 'router' }; happyPathLog(routeParams); const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Stake PLUME for pETH on Dinero This use case deposits native PLUME and converts it into the pETH liquid staking derivative on Dinero. **Route Mechanics:** The route consists of a single action, a swap from PLUME to pETH using the rooster protocol. ```mermaid theme={null} flowchart LR PLUME((PLUME)) -->|rooster
swap| DINERO((DINERO)) ``` ```ts theme={null} export async function depositPlumeToDinero(): Promise<{ route: any; tx: any }> { const PLUME: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const pETH: Address = "0x39d1F90eF89C52dDA276194E9a832b484ee45574"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: PLUME_CHAIN, amountIn: ["1000000000000000000"], // 1 PLUME tokenIn: [PLUME], tokenOut: [pETH], routingStrategy: 'router' }; happyPathLog(routeParams); const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Zap ETH into Renzo's ezETH This use case allows a user to enter the Renzo liquid restaking ecosystem. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0xbf5495Efe5DB9ce00f80364C8B423567e58d2110) **Bundle Mechanics:** The bundle consists of a single action: a swap from ETH to ezETH using the barter protocol. ```mermaid theme={null} flowchart LR ETH((ETH)) -->|barter
swap| ezETH((ezETH)) ``` ```ts theme={null} export async function depositEthToRenzo(): Promise<{ route: any; tx: any }> { const ETH: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const ezETH: Address = "0xbf5495Efe5DB9ce00f80364C8B423567e58d2110"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [ezETH], routingStrategy: 'router' }; happyPathLog(routeParams); const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ### Zap ETH into Swell's swETH This use case allows a user to enter the Swell liquid staking ecosystem. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0xf951E335afb289353dc249e82926178EaC7DEd78) **Bundle Mechanics:** The bundle consists of a single action: a swap from ETH to swETH. ```mermaid theme={null} flowchart LR ETH((ETH)) -->|swap| swETH((swETH)) ``` ```ts theme={null} export async function depositEthToSwell(): Promise<{ route: any; tx: any }> { const ETH: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const swETH: Address = "0xf951E335afb289353dc249e82926178EaC7DEd78"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [swETH], routingStrategy: 'router' }; happyPathLog(routeParams); const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Zap ETH into Stakestone's STONE This use case allows a user to enter the StakeStone liquid staking ecosystem. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x094c0e36210634c3cfa25dc11b96b562e0b07624) **Bundle Mechanics:** The bundle involves a two-step process: * a swap from ETH to an intermediate token using barter, * followed by a deposit into the stakestone-sbtc protocol to get the final STONE token. ```mermaid theme={null} flowchart LR ETH((ETH)) -->|barter
swap| SBTC((SBTC)) SBTC -->|stakestone-sbtc
deposit| STONE((STONE)) ``` ```ts theme={null} export async function depositEthToStakestone(): Promise<{ route: any; tx: any }> { const ETH: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const STONE: Address = "0x094c0e36210634c3cfa25dc11b96b562e0b07624"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [STONE], routingStrategy: 'router' }; happyPathLog(routeParams); const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ### Zap ETH into Bedrock's uniETH This use case allows a user to enter the Bedrock liquid staking ecosystem. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x2ec37d45fcae65d9787ecf71dc85a444968f6646) **Bundle Mechanics:** The bundle consists of a single action: a swap from ETH to BRBTC using the barter protocol ```mermaid theme={null} flowchart LR ETH((ETH)) -->|barter
swap| uniBTC((uniBTC)) ``` ```ts theme={null} export async function depositEthToBedrock(): Promise<{ route: any; tx: any }> { const ETH: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const BRBTC: Address = "0x2ec37d45fcae65d9787ecf71dc85a444968f6646"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [BRBTC], routingStrategy: 'router' }; happyPathLog(routeParams); const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Zap Balancer LP into Aura Finance This use case allows a user to stake Balancer LP tokens in Aura for boosted rewards. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0x32296969Ef14EB0c6d29669C550D4a0449130230\&tokenOut=0x08129a472dfb92a1596bbe31f27c53914a990563) **Route mechanics:** * Redeem the Balancer v2 LP position to get WETH * Redeem WETH using wrapped native protocol to get native ETH * Deposit native ETH back into wrapped native to get WETH * Deposit WETH into Balancer v2 to create FIXME (0xfd1cf6fd41f229ca86ada0584c63c49c3d66bbc9) LP * Deposit the LP into Aura protocol to receive the Aura staked position ```mermaid theme={null} flowchart LR BAURA((B-AURA)) -->|balancer-v2
redeem| WETH((WETH)) WETH -->|wrapped-native
redeem| ETH((ETH)) ETH -->|wrapped-native
deposit| WETH_new((WETH)) WETH_new -->|balancer-v2
deposit| WETHUSDC((WETH-USDC)) WETHUSDC -->|aura
deposit| auraWETHUSDC((auraWETH-USDC)) ``` ```ts theme={null} export async function depositBalancerLpToAura(): Promise<{ route: any; tx: any }> { const BPT_wstETH_WETH: Address = "0x32296969Ef14EB0c6d29669C550D4a0449130230"; const auraBPT: Address = "0x08129a472dfb92a1596bbe31f27c53914a990563"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // 1 BPT tokenIn: [BPT_wstETH_WETH], tokenOut: [auraBPT], routingStrategy: 'router' }; happyPathLog(routeParams); const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` ## Zap WETH to Balancer stEUR/Eure LP on Gnosis Zaps WETH into the Balancer stEUR/Eure liquidity pool on Gnosis. [**Try this route →**](https://happypath.enso.build/?tokenIn=0x6A023CCd1ff6F2045C3309768eAd9E68F978f6e1\&outChainId=100\&chainId=100\&tokenOut=0x06135A9Ae830476d3a941baE9010B63732a055F4\&amountIn=1000000000000000000) ```javascript theme={null} const WETH = "0x6A023CCd1ff6F2045C3309768eAd9E68F978f6e1" as Address; const stEurEure = "0x06135A9Ae830476d3a941baE9010B63732a055F4" as Address; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: GNOSIS_CHAIN, amountIn: ["1000000000000000000"], tokenIn: [WETH], tokenOut: [stEurEure], routingStrategy: "router", }; const route = await client.getRouteData(routeParams); await sendEoa(client.getApprovalData(route)); await sendEoa(route.tx, route.gas); ``` **Route Mechanics:** * Swap `WETH` to `EURE` via Enso. * Deposit `EURE` into Balancer v2 to get the LP token. *** ## Provide Liquidity to Yearn Curve mUSD Vault with ETH Deposit `ETH` and provide liquidity to the Yearn Curve `mUSD` Pool yVault on Ethereum. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\&tokenOut=0x8cc94ccd0f3841a468184aca3cc478d2148e1757) ```mermaid theme={null} flowchart LR ETH((ETH)) -->|enso
route| DAI((DAI)) DAI -->|curve
deposit| 3CRV((3CRV LP)) 3CRV -->|curve
deposit| mUSD_LP((mUSD LP)) mUSD_LP -->|yearn-v2
deposit| yvmUSD((yvmUSD)) ``` ```javascript theme={null} const ETH = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" as Address; const CurveMUSD_yVault = "0x8cc94ccd0f3841a468184aca3cc478d2148e1757" as Address; // Yearn Curve mUSD Pool yVault const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["100000000000000000"], // 0.1 ETH tokenIn: [ETH], tokenOut: [CurveMUSD_yVault], routingStrategy: "delegate", slippage: "100", // 1% slippage }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `ETH` to DAI via Enso DEX Aggregator * Deposit `DAI` into Curve.fi 3pool ( `0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7` ) to receive Curve 3pool LP tokens * Deposit `Curve 3pool LP tokens` into Curve.fi mUSD Pool ( `0x8474ddbe98f5aa3179b3b3f5942d724afcdec9f6` ) to receive Curve mUSD LP tokens * Deposit `Curve mUSD LP tokens` into Yearn Curve mUSD yVault ( `0x8cc94ccd0f3841a468184aca3cc478d2148e1757` ) *** ## ETH to Curve stETH Factory yVault Deposit `ETH` and provide liquidity to the Yearn Curve `stETH` Factory yVault on Ethereum. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\&tokenOut=0x5b8c556b8b2a78696f0b9b830b3d67623122e270) ```mermaid theme={null} flowchart LR ETH((ETH)) -->|curve
deposit| stETH_LP((stETH LP)) stETH_LP -->|yearn-v2
deposit| yvstETH((yvstETH)) ``` ```javascript theme={null} const ETH = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" as Address; const CurveStETH_yVault = "0x5b8c556b8b2a78696f0b9b830b3d67623122e270" as Address; // Yearn Curve stETH Factory yVault const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["100000000000000000"], // 0.1 ETH tokenIn: [ETH], tokenOut: [CurveStETH_yVault], routingStrategy: "delegate", slippage: "100", // 1% slippage }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Deposit `ETH` into Curve.fi stETH Pool ( `0xdc24316b9ae028f1497c275eb9192a3ea0f67022` ) to receive Curve stETH LP tokens * Deposit `Curve stETH LP tokens` into Yearn Curve stETH Factory yVault ( `0x5b8c556b8b2a78696f0b9b830b3d67623122e270` ) *** ## ETH to Balancer cbETH-wstETH Factory yVault Deposit `ETH` and provide liquidity to the Yearn Balancer (`cbETH`/`wstETH`) yVault on Ethereum. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\&tokenOut=0xc325849908d482550b87f96ef60271b95f92c861) ```mermaid theme={null} flowchart LR ETH((ETH)) --> SPLIT{enso.split} SPLIT -->|enso
route| wstETH((wstETH)) SPLIT -->|enso
route| cbETH((cbETH)) wstETH -->|balancer-v2
deposit| BAL_LP((cbETH/wstETH LP)) cbETH -->|balancer-v2
deposit| BAL_LP BAL_LP -->|yearn-v2
deposit| yvBAL((yvBAL)) ``` ```javascript theme={null} const ETH = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" as Address; const BalancerCBETHwstETH_yVault = "0xc325849908d482550b87f96ef60271b95f92c861" as Address; // Yearn Balancer cbETH-wstETH Factory yVault const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["100000000000000000"], // 0.1 ETH tokenIn: [ETH], tokenOut: [BalancerCBETHwstETH_yVault], routingStrategy: "delegate", slippage: "100", // 1% slippage }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Split `ETH`: * Swap `ETH` to wstETH via Enso DEX Aggregator * Swap `ETH` to cbETH via Enso DEX Aggregator * Deposit `wstETH` and `cbETH` into Balancer V2 pool ( `0xba12222222228d8ba445958a75a0704d566bf2c8` ) to receive Balancer cbETH-wstETH LP tokens * Deposit `Balancer cbETH-wstETH LP tokens` into Yearn Balancer cbETH-wstETH Factory yVault ( `0xc325849908d482550b87f96ef60271b95f92c861` ) *** ## ETH to Curve TriCryptoLLAMA Factory yVault Deposit `ETH` and provide liquidity to the Yearn Curve `TriCryptoLLAMA` yVault on Ethereum. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\&tokenOut=0xe2cad35cfd1a9b5acd557558f44b096ef8340c1b) ```mermaid theme={null} flowchart LR ETH((ETH)) -->|enso
route| tBTC((tBTC)) tBTC -->|curve
deposit| TRICRYPTO_LP((TriCrypto LP)) TRICRYPTO_LP -->|yearn-v2
deposit| yvTRICRYPTO((yvTriCrypto)) ``` ```javascript theme={null} const ETH = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" as Address; const CurveTriCryptoLLAMA_yVault = "0xe2cad35cfd1a9b5acd557558f44b096ef8340c1b" as Address; // Yearn Curve TriCryptoLLAMA Factory yVault const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["100000000000000000"], // 0.1 ETH tokenIn: [ETH], tokenOut: [CurveTriCryptoLLAMA_yVault], routingStrategy: "delegate", slippage: "100", // 1% slippage }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Swap `ETH` to tBTC via Enso DEX Aggregator * Deposit `tBTC` into Curve.fi TriCryptoLLAMA Pool ( `0x2889302a794da87fbf1d6db415c1492194663d13` ) to receive Curve TriCryptoLLAMA LP tokens * Deposit `Curve TriCryptoLLAMA LP tokens` into Yearn Curve TriCryptoLLAMA Factory yVault ( `0xe2cad35cfd1a9b5acd557558f44b096ef8340c1b` ) *** # Curve Convex Yield Farming Source: https://docs.enso.build/pages/use-cases/dexes-aggregators/convex-yield-farming Deposit into Curve pools and stake LP tokens in Convex for boosted CRV rewards ## Deposit ETH into Curve stETH/ETH Pool and Stake in Convex This use case automates the complete yield farming workflow for Curve's liquid staking pool with Convex rewards. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\&tokenOut=0x182B723a58739a9c974cFDB385ceaDb237453c28) **Route Mechanics:** * Deposit native ETH into the Curve stETH/ETH liquidity pool * Receive Curve LP tokens representing your pool share * Automatically stake the LP tokens in the corresponding Curve Gauge * Earn both trading fees from the pool and CRV rewards from the gauge ```mermaid theme={null} flowchart LR ETH((ETH)) -->|curve
deposit| LP_TOKEN((stETH/ETH LP)) LP_TOKEN -->|curve-gauge
deposit| GAUGE_TOKEN((Gauge Token)) ``` ```typescript theme={null} const chainId = 1; // Ethereum mainnet const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; // Token addresses const tokenInEth = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"; const lpTokenStethEth = "0x06325440d014e39736583c165c2963ba99faf14e"; // stETH/ETH Curve LP token const stEthEthPool = "0xDC24316b9AE028F1497c275EB9192a3Ea0f67022"; // stETH/ETH Curve Pool const stEthGauge = "0x182B723a58739a9c974cFDB385ceaDb237453c28"; // stETH/ETH Curve Gauge const amountIn = parseUnits("1000", 6); // 1000 USDC const bundle = await client.getBundleData( { chainId, fromAddress, routingStrategy: "delegate", }, [ { // Step 1: Deposit into Curve stETH/ETH pool using standard "deposit" action protocol: "curve", action: "deposit", args: { tokenIn: [tokenInEth], tokenOut: lpTokenStethEth, // stETH/ETH LP token amountIn: [amountIn.toString()], primaryAddress: stEthEthPool, // Curve stETH pool address }, }, { // Step 2: Stake LP tokens in Curve Gauge for CRV rewards protocol: "curve-gauge", action: "deposit", args: { tokenIn: lpTokenStethEth, // stETH/ETH LP token tokenOut: stEthGauge, // stETH/ETH Gauge amountIn: { useOutputOfCallAt: 0, // Use LP tokens from Curve deposit }, primaryAddress: stEthGauge, // Gauge address }, }, ] ); await sendEoa(bundle.tx, bundle.gas); ```
Updated
route| ETH_ETH((ETH)) ETH_ETH -->|enso
fee| ETH_AFTER_FEE((ETH)) end ETH_AFTER_FEE -.->|stargate
bridge| ETH_BASE((ETH)) subgraph base ["🔵 Base"] ETH_BASE --> SPLIT{enso.split} SPLIT -->|enso
route| DAI_BASE((DAI)) SPLIT -->|enso
route| USDC_BASE((USDC)) DAI_BASE -->|uniswap-v4
depositclmm| LP_POSITION((Uni V4 LP)) USDC_BASE -->|uniswap-v4
depositclmm| LP_POSITION end ``` ```typescript theme={null} // Chain IDs const ETHEREUM_CHAIN_ID = 1; const BASE_CHAIN_ID = 8453; // Common addresses const ETH_ADDRESS = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"; // Native ETH representation const WALLET_ADDRESS = "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11"; // User wallet/fee receiver // Ethereum Mainnet Token Addresses const USDC_ETHEREUM = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"; // USDC on Ethereum // Stargate Addresses const STARGATE_POOL_NATIVE_ETHEREUM = "0x77b2043768d28e9c9ab44e1abfc95944bce57931"; // StargatePoolNative on Ethereum // Base Chain Token Addresses const DAI_BASE = "0x50c5725949a6f0c72e6c4a641f24049a917db0cb"; // L2 Standard Bridged DAI on Base const USDC_BASE = "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"; // USDC on Base // Uniswap V4 Addresses const UNISWAP_V4_POSITION_MANAGER_BASE = "0x7c5f5a4bbd8fd63184577525326123b519429bdc"; // Uniswap V4 PositionManager on Base const bundle = await client.getBundleData( { chainId: ETHEREUM_CHAIN_ID, fromAddress: WALLET_ADDRESS, spender: WALLET_ADDRESS, routingStrategy: "router", }, [ { protocol: "enso", action: "route", args: { tokenIn: USDC_ETHEREUM, amountIn: parseUnits("1000", 6).toString(), // 1000 USDC tokenOut: ETH_ADDRESS, }, }, { protocol: "enso", action: "fee", args: { token: ETH_ADDRESS, amount: { useOutputOfCallAt: 0 }, bps: 25, // 0.25% fee receiver: WALLET_ADDRESS, }, }, { protocol: "stargate", action: "bridge", args: { primaryAddress: STARGATE_POOL_NATIVE_ETHEREUM, destinationChainId: BASE_CHAIN_ID, tokenIn: ETH_ADDRESS, amountIn: { useOutputOfCallAt: 1 }, receiver: WALLET_ADDRESS, callback: [ { protocol: "enso", action: "balance", args: { token: ETH_ADDRESS, }, }, { protocol: "enso", action: "split", args: { tokenIn: ETH_ADDRESS, tokenOut: [DAI_BASE, USDC_BASE], amountIn: { useOutputOfCallAt: 0 }, }, }, { protocol: "enso", action: "slippage", args: { amountOut: { useOutputOfCallAt: 1, index: 0 }, bps: 50, // 0.5% slippage }, }, { protocol: "enso", action: "slippage", args: { amountOut: { useOutputOfCallAt: 1, index: 1 }, bps: 50, // 0.5% slippage }, }, { protocol: "uniswap-v4", action: "depositclmm", args: { tokenOut: UNISWAP_V4_POSITION_MANAGER_BASE, ticks: [-276842, -275842], tokenIn: [DAI_BASE, USDC_BASE], poolFee: "100", // 0.01% fee tier amountIn: [ { useOutputOfCallAt: 1, index: 0 }, { useOutputOfCallAt: 1, index: 1 }, ], }, }, { protocol: "enso", action: "slippage", args: { amountOut: { useOutputOfCallAt: 4 }, bps: 200, // 2% slippage }, }, ], }, }, ] ); ```
Updated
swap| PUSD((PUSD)) SPLIT -->|keep as
NALPHA| NALPHA((NALPHA)) PUSD -->|rooster-yap
deposit| ROOSTER_LP((ROOSTER_LP)) NALPHA -->|rooster-yap
deposit| ROOSTER_LP ``` ```ts theme={null} const BERACHAIN_CHAIN = 80094; const OPTIMISM_CHAIN = 10; const ARBITRUM_CHAIN = 42161; const ETHEREUM_CHAIN = 1; const PLUME_CHAIN = 98866; const userAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" as Address; /** * Rebalances a Nest Alpha Vault position into a Rooster Finance YAP (nALPHA/pUSD) liquidity pool on Plume. * @returns The route and transaction objects. */ export async function rebalanceNestToRoosterLp(): { const NestAlphaVault: Address = "0x593ccca4c4bf58b7526a4c164ceef4003c6388db"; const RoosterYAPLP: Address = "0xfc3bd0e01b4e755aedd2a4087ccdb90c4d28f038"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: PLUME_CHAIN, amountIn: ["1000000000"], // 1000 NALPHA tokens tokenIn: [NestAlphaVault], tokenOut: [RoosterYAPLP], routingStrategy: 'router' }; const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Rebalance yHONEY Vault into Kodiak HONEY/WBERA LP Redeem yHONEY vault shares and use the underlying assets to create a Kodiak BERA/HONEY LP position. [**Try this route →**](https://happypath.enso.build?chainId=80094\&tokenIn=0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC\&tokenOut=0x9659dc8c1565E0bd82627267e3b4eEd1a377ebE6) ```mermaid theme={null} flowchart LR yHONEY((yHONEY)) -->|bearn
redeem| HONEY((HONEY)) HONEY --> SPLIT{enso.split} SPLIT -->|enso
route| WBERA((WBERA)) SPLIT -->|keep as
HONEY| HONEY_KEPT((HONEY)) WBERA -->|kodiak-islands
deposit| LP((HONEY/WBERA LP)) HONEY_KEPT -->|kodiak-islands
deposit| LP ``` ```javascript theme={null} import { Address, EnsoClient, RouteParams } from "@ensofinance/sdk"; const BERACHAIN_MAINNET = 80094; const userAddress = "your-wallet-address" as Address; const yHONEY = "0xC82971BcFF09171e16Ac08AEE9f4EA3fB16C3BDC" as Address; const HONEY_WBERA_POOL = "0x9659dc8c1565E0bd82627267e3b4eEd1a377ebE6" as Address; // HONEY/WBERA LP const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_MAINNET, amountIn: ["1500000000000000000"], // 1.5 yHONEY tokenIn: [yHONEY], tokenOut: [HONEY_WBERA_POOL], routingStrategy: "delegate", slippage: "200", // 2% slippage for yield token pairing referralCode: "yhoney-island", }; const route = await client.getRouteData(routeParams); await sendSmartWallet(route.tx, route.gas); ``` **Route Mechanics:** * Redeem `yHONEY` vault shares to receive `HONEY`. * Split `HONEY` into `HONEY` and `WBERA` through internal routing. * Deposit balanced tokens into Kodiak Islands `HONEY/WBERA` pool. ***
Updated
swap| WETH((WETH)) SPLIT -->|keep as
AAVE| AAVE_KEPT((AAVE)) WETH -->|uniswap-v3
depositclmm| LP_POSITION((LP Position)) AAVE_KEPT -->|uniswap-v3
depositclmm| LP_POSITION ``` ```typescript theme={null} const chainId = 42161; // Arbitrum const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; // Token and Protocol Addresses const tokenIn_AAVE = "0xba5ddd1f9d7f570dc94a51479a000e3bce967196"; const tokenOut_WETH = "0x82af49447d8a07e3bd95bd0d56f35241523fbab1"; const uniswapManager = "0xc36442b4a4522e871399cd717abdd847ab11fe88"; // Define amount const amountIn = parseUnits("10", 18); // 10 AAVE const bundle = await client.getBundleData( { chainId, fromAddress, routingStrategy: "router", }, [ { // Split AAVE into 2 equal parts // Converts the first half into WETH // needed for AAVE/WETH pool protocol: "enso", action: "split", args: { tokenIn: tokenIn_AAVE, tokenOut: [tokenOut_WETH, tokenIn_AAVE], amountIn: amountIn.toString(), }, }, { protocol: "uniswap-v3", action: "depositclmm", args: { tokenOut: uniswapManager, ticks: [25320, 25980], tokenIn: [tokenOut_WETH, tokenIn_AAVE], poolFee: "3000", amountIn: [ // use output from the split call { useOutputOfCallAt: 0, index: 0 }, { useOutputOfCallAt: 0, index: 1 }, ], }, }, ] ); const approvalData = await client.getApprovalData({ amount: amountIn.toString(), chainId, fromAddress, tokenAddress: tokenIn_AAVE, }); ``` **Important Considerations:** * Tick ranges determine the price range for concentrated liquidity * Pool fee tier affects trading volume and potential returns * Position requires active management as price moves outside the range
Updated
swap| HONEY((HONEY)) SPLIT -->|infrared-ibera
deposit| iBERA((iBERA)) SPLIT -->|openocean
swap| USDC((USDC)) HONEY -->|bex
deposit| BEX_LP((BEX_LP)) iBERA -->|bex
deposit| BEX_LP USDC -->|bex
deposit| BEX_LP ``` ```ts theme={null} const BERACHAIN_CHAIN = 80094; const OPTIMISM_CHAIN = 10; const ARBITRUM_CHAIN = 42161; const ETHEREUM_CHAIN = 1; const PLUME_CHAIN = 98866; const userAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" as Address; /** * Zaps native BERA into the BEX WBERA/HONEY liquidity pool on Berachain. * @returns The route and transaction objects. */ export async function zapBeraToBexLp(): { const BERA: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const BEX_WBERA_HONEY_LP: Address = "0x0277d40b08ac168518c524418f1b3c16adae0f0d"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_CHAIN, amountIn: ["1000000000000000000"], // 1 BERA tokenIn: [BERA], tokenOut: [BEX_WBERA_HONEY_LP], routingStrategy: 'router' }; const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Zap ETH into a Velodrome LP on Optimism This use case demonstrates a single transaction to provide liquidity to a Velodrome v2 pool. [**Try this route →**](https://happypath.enso.build?chainId=10\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0xa3031D9FD5010496a2bAF8AFCE27Ef6f3849FB10) **Route Mechanics:** * splits the input ETH token. One portion is wrapped into WETH using wrapped-native, while the other is swapped for wstETH using the openocean protocol. * both assets are deposited into a velodrome-v2 liquidity pool ```mermaid theme={null} flowchart LR ETH((ETH)) --> SPLIT{enso.split} SPLIT -->|wrapped-native
deposit| WETH((WETH)) SPLIT -->|openocean
swap| OP((OP)) WETH -->|velodrome-v2
deposit| VELO_LP((VELO_LP)) OP -->|velodrome-v2
deposit| VELO_LP ``` ```ts theme={null} const BERACHAIN_CHAIN = 80094; const OPTIMISM_CHAIN = 10; const ARBITRUM_CHAIN = 42161; const ETHEREUM_CHAIN = 1; const PLUME_CHAIN = 98866; const userAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" as Address; /** * Zaps ETH into a Velodrome wstETH/WETH liquidity pool on Optimism. * @returns The route and transaction objects. */ export async function zapEthToVelodromeLp(): { const ETH: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const veloWstethWethLp: Address = "0xa3031D9FD5010496a2bAF8AFCE27Ef6f3849FB10"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: OPTIMISM_CHAIN, amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [veloWstethWethLp], routingStrategy: 'router' }; const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Zap ETH to SushiSwap ARB/WETH LP on Arbitrum This use case provides liquidity to a popular v3 pool on Sushiswap. [**Try this route →**](https://happypath.enso.build?chainId=42161\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x905dfcd5649217c42684f23958568e533c711aa3) **Route Mechanics:** * Split ETH into two portions using enso internal routing: * First portion: swap ETH to USDC.e using 1inch protocol * Second portion: deposit ETH into wrapped native to get WETH * Deposit both USDC.e and WETH into SushiSwap v2 to create the LP position ```mermaid theme={null} flowchart LR ETH((ETH)) --> SPLIT{enso.split} SPLIT -->|1inch
swap| USDC_e((USDC.e)) SPLIT -->|wrapped-native
deposit| WETH((WETH)) USDC_e -->|sushiswap-v2
deposit| SUSHI_LP((SUSHI_LP)) WETH -->|sushiswap-v2
deposit| SUSHI_LP ``` ```ts theme={null} const BERACHAIN_CHAIN = 80094; const OPTIMISM_CHAIN = 10; const ARBITRUM_CHAIN = 42161; const ETHEREUM_CHAIN = 1; const PLUME_CHAIN = 98866; const userAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" as Address; /** * Zaps ETH to a SushiSwap ARB/WETH liquidity pool on Arbitrum. * @returns The route and transaction objects. */ export async function zapEthToSushiswapLp(): { const ETH: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const SLP_ARB_WETH: Address = "0x905dfcd5649217c42684f23958568e533c711aa3"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ARBITRUM_CHAIN, amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [SLP_ARB_WETH], routingStrategy: 'router' }; const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Zap ETH to Balancer WETH/BAL LP on Mainnet This use case provides liquidity to a classic Balancer weighted pool. [**Try this route →**](https://happypath.enso.build?chainId=1\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x5c6Ee304399DBdB9C8Ef030aB642B10820DB8F56) **Route Mechanics:** * Deposit ETH into wrapped native protocol to get WETH * Deposit WETH into Balancer v2 pool to create the WETH/BAL LP position ```mermaid theme={null} flowchart LR ETH((ETH)) --> SPLIT{enso.split} SPLIT -->|1inch
swap| USDC_e((USDC.e)) SPLIT -->|wrapped-native
deposit| WETH((WETH)) USDC_e -->|sushiswap-v2
deposit| SUSHI_LP((SUSHI_LP)) WETH -->|sushiswap-v2
deposit| SUSHI_LP ``` ```ts theme={null} const BERACHAIN_CHAIN = 80094; const OPTIMISM_CHAIN = 10; const ARBITRUM_CHAIN = 42161; const ETHEREUM_CHAIN = 1; const PLUME_CHAIN = 98866; const userAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" as Address; /** * Zaps ETH to a Balancer WETH/BAL weighted pool on Ethereum Mainnet. * @returns The route and transaction objects. */ export async function zapEthToBalancerLp(): { const ETH: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const BPT_WETH_BAL: Address = "0x5c6Ee304399DBdB9C8Ef030aB642B10820DB8F56"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ETHEREUM_CHAIN, amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [BPT_WETH_BAL], routingStrategy: 'router' }; const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` *** ## Zap ETH to Camelot GRAIL/WETH LP on Arbitrum This use case provides liquidity to a core pool on Camelot DEX. [**Try this route →**](https://happypath.enso.build?chainId=42161\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0xbfca4230115de8341f3a3d5e8845ffb3337b2be3) Route Mechanics: * the bundle first splits the input ETH token. * tne portion is swapped for GRAIL * the other is wrapped into WETH using the wrapped-native protocol. * the two assets are then deposited into the camelot-v2 protocol to form the LP position ```mermaid theme={null} flowchart LR ETH((ETH)) --> SPLIT{enso.split} SPLIT -->|swap| PENDLE((PENDLE)) SPLIT -->|wrapped-native
deposit| WETH((WETH)) PENDLE -->|camelot-v2
deposit| CAMELOT_LP((CAMELOT_LP)) WETH -->|camelot-v2
deposit| CAMELOT_LP ``` ```ts theme={null} import { EnsoClient, RouteParams, Address } from "@ensofinance/sdk"; import * as dotenv from "dotenv"; import { happyPathLog } from "../../tools"; import { sendEoa } from "../utils"; dotenv.config(); // Initialize EnsoClient with your API key const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY!, }); // Define common constants const BERACHAIN_CHAIN = 80094; const OPTIMISM_CHAIN = 10; const ARBITRUM_CHAIN = 42161; const ETHEREUM_CHAIN = 1; const PLUME_CHAIN = 98866; const userAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" as Address; /** * Zaps ETH to a Camelot GRAIL/WETH liquidity pool on Arbitrum. * @returns The route and transaction objects. */ export async function zapEthToCamelotLp(): { const ETH: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const spLP_GRAIL_WETH: Address = "0xbfca4230115de8341f3a3d5e8845ffb3337b2be3"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: ARBITRUM_CHAIN, amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [spLP_GRAIL_WETH], routingStrategy: 'router' }; const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` ***
Updated
Find Enso routes and bundles for different DeFi use cases and the run strategies you need.
route| aUSDC((aUSDC)) aUSDC -->|aave-v3
borrow| WETH((WETH)) ``` ```ts lines theme={null} const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; const USDC_ADDRESS = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const AUSDC_ADDRESS = "0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c"; const WETH_ADDRESS = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"; const AAVE_V3 = "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"; const usdcAmountIn = parseUnits("10000", 6).toString(); const wethAmountOut = parseUnits("0.025", 18).toString(); const chainId = 1; const bundle = await client.getBundleData( { chainId, fromAddress, routingStrategy: "delegate", receiver: fromAddress, }, [ { protocol: "enso", action: "route", args: { amountIn: usdcAmountIn, tokenIn: USDC_ADDRESS, tokenOut: AUSDC_ADDRESS, }, }, { protocol: "aave-v3", action: "borrow", args: { primaryAddress: AAVE_V3, collateral: USDC_ADDRESS, tokenOut: WETH_ADDRESS, amountOut: wethAmountOut, }, }, ] ); console.log(JSON.stringify(bundle.bundle, null, 2)); await sendEoa(approvalData.tx, approvalData.gas); // sending the actual transaction await sendEoa(bundle.tx, bundle.gas); ``` # Collateral Swap Source: https://docs.enso.build/pages/use-cases/lending-markets/collateral-swap Switch the collateral backing your debt without closing the debt position
redeem| WETH((WETH)) WETH -->|enso
route| WBTC((WBTC)) WBTC -->|aave-v3
deposit| aWBTC((aWBTC)) ``` ```ts theme={null} const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" as Address; const aWETH = "0x4d5F47FA6A74757f35C14fD3a6Ef8E3C9BC514E8"; const WETH = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"; const WBTC = "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"; const aWBTC = "0x5Ee5bf7ae06D1Be5997A1A72006FE6C607eC6DE8"; // aave v3 position manager const AAVE_V3 = "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"; const bundle = await client.getBundleData( { chainId: 1, fromAddress, routingStrategy: "delegate", }, [ { protocol: "aave-v3", action: "redeem", args: { primaryAddress: AAVE_V3, tokenIn: aWETH, tokenOut: WETH, amountIn: "1000000000000000000", }, }, { protocol: "enso", action: "route", args: { tokenIn: WETH, tokenOut: WBTC, amountIn: { useOutputOfCallAt: 0 }, }, }, { protocol: "aave-v3", action: "deposit", args: { primaryAddress: AAVE_V3, tokenIn: WBTC, tokenOut: aWBTC, amountIn: { useOutputOfCallAt: 1 }, }, }, ] ); console.log(JSON.stringify(bundle, null, 2)); ``` # Deposit with Leverage Source: https://docs.enso.build/pages/use-cases/lending-markets/deposit-with-leverage Depositing with leverage amplifies exposure by redepositing the same collateral: * deposits initial collateral (WETH), * borrows against it (USDC), * swaps the borrowed funds for more collateral (USDC → WETH), * and repeats this process. ```mermaid theme={null} flowchart LR WETH((WETH)) -->|aave-v3
deposit| aWETH((aWETH)) aWETH -->|aave-v3
borrow| USDC((USDC)) USDC -->|enso
route| WETH_2((WETH)) WETH_2 -->|aave-v3
deposit| aWETH_2((aWETH)) ``` ```ts lines highlight={32-33, 42-43, 52-53} theme={null} const chainId = 1; const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; // Token and Protocol Addresses const WETH: Address = "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"; const aWETH: Address = "0x4d5F47FA6A74757f35C14fD3a6Ef8E3C9BC514E8"; const USDC: Address = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"; const aaveV3Pool: Address = "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"; // Define amounts const initialDeposit = parseUnits("1", 18); const borrowAmount = parseUnits("1000", 6); const bundle = await client.getBundleData( { chainId, fromAddress, routingStrategy: "delegate", }, [ { protocol: "aave-v3", action: "deposit", args: { tokenIn: WETH, tokenOut: aWETH, amountIn: initialDeposit.toString(), primaryAddress: aaveV3Pool, }, }, { protocol: "aave-v3", action: "borrow", args: { collateral: aWETH, tokenOut: USDC, amountOut: borrowAmount.toString(), primaryAddress: aaveV3Pool, }, }, { protocol: "enso", action: "route", args: { tokenIn: USDC, tokenOut: WETH, amountIn: borrowAmount.toString(), slippage: "100", }, }, { protocol: "aave-v3", action: "deposit", args: { tokenIn: WETH, tokenOut: aWETH, amountIn: { useOutputOfCallAt: 2 }, primaryAddress: aaveV3Pool, }, }, ] ); console.log(JSON.stringify(bundle.bundle, null, 2)); await sendSmartWallet(bundle.tx, bundle.gas); ``` # Overview Source: https://docs.enso.build/pages/use-cases/lending-markets/index Shortcuts for Lending Markets Operations
redeem| USDC((USDC)) USDC -->|compound-v3
deposit| cUSDC((cUSDC)) ``` ```ts lines theme={null} const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; const USDC_ADDRESS = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const AUSDC_ADDRESS = "0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c"; const CUSDC_ADDRESS = "0xc3d688B66703497DAA19211EEdff47f25384cdc3"; const AAVE_V3 = "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"; const aUsdcAmountIn = parseUnits("5000", 6).toString(); // 5,000 aUSDC to withdraw const chainId = 1; const bundle = await client.getBundleData( { chainId, fromAddress, routingStrategy: "delegate", }, // Migrate USDC lending position from Aave to Compound [ { protocol: "aave-v3", action: "redeem", args: { tokenIn: AUSDC_ADDRESS, tokenOut: USDC_ADDRESS, amountIn: aUsdcAmountIn, primaryAddress: AAVE_V3, }, }, { protocol: "compound-v3", action: "deposit", args: { tokenIn: USDC_ADDRESS, tokenOut: CUSDC_ADDRESS, amountIn: aUsdcAmountIn, primaryAddress: CUSDC_ADDRESS, }, }, ] ); console.log(JSON.stringify(bundle.bundle, null, 2)); await sendSmartWallet(bundle.tx, bundle.tx); ``` ## Migrating to different base position Switch Aave lending position from USDC collateral to WETH collateral in a single transaction. Bundle design: * `redeem` existing USDC collateral on AAVE * swap USDC to WETH using `route` action * `deposit` resulting WETH to AAVE (using the `{useOutputOfCallAt: 1}` to reference the swap) ```mermaid theme={null} flowchart LR aUSDC((aUSDC)) -->|aave-v3
redeem| USDC((USDC)) USDC -->|enso
route| WETH((WETH)) WETH -->|aave-v3
deposit| aWETH((aWETH)) ``` ```ts lines theme={null} const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; const USDC_ADDRESS = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const AUSDC_ADDRESS = "0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c"; const WETH_ADDRESS = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"; const AWETH_ADDRESS = "0x4d5F47FA6A74757f35C14fD3a6Ef8E3C9BC514E8"; const AAVE_V3 = "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"; const aUsdcAmountIn = parseUnits("3000", 6).toString(); const chainId = 1; const bundle = await client.getBundleData( { chainId, fromAddress, routingStrategy: "delegate", }, // Switch collateral within Aave from USDC to WETH [ { protocol: "aave-v3", action: "redeem", args: { tokenIn: AUSDC_ADDRESS, tokenOut: USDC_ADDRESS, amountIn: aUsdcAmountIn, primaryAddress: AAVE_V3, }, }, { protocol: "enso", action: "route", args: { tokenIn: USDC_ADDRESS, tokenOut: WETH_ADDRESS, amountIn: aUsdcAmountIn, }, }, { protocol: "aave-v3", action: "deposit", args: { tokenIn: WETH_ADDRESS, tokenOut: AWETH_ADDRESS, amountIn: {useOutputOfCallAt: 1}, primaryAddress: AAVE_V3, }, }, ] ); console.log(JSON.stringify(bundle.bundle, null, 2)); await sendSmartWallet(bundle.tx, bundle.tx); ``` # Withdraw & Swap Source: https://docs.enso.build/pages/use-cases/lending-markets/withdraw-and-swap Redeem asssets and swap them directly to an arbitrary token in a single transaction Enso [GET `route`](/pages/build/get-started/route) API allows withdrawing (redeeming) from a curated vault position to an arbitrary DeFi or base asset. ## Withdraw PT and swap to USDC This route redeems ezETH PT into USDC, performing any necessary withdrawals and swaps. [Try this route →](https://happypath.enso.build/?tokenIn=0xeEE8aED1957ca1545a0508AfB51b53cCA7e3c0d1\&outChainId=1\&chainId=1\&tokenOut=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\&amountIn=10000000000000000000) **Route mechanics:** * Redeem from `PT_ezETH` to get `SY_ezETH` * Redeem from `SY_ezETH` to obtain the deposited `ezETH` * Swap `ezETH` to desired `USDC` ```mermaid theme={null} flowchart LR PT((PT_Token)) -->|pendle-pt
redeem| SY((SY_Token)) SY -->|pendle-sy
redeem| ezETH((ezETH)) ezETH -->|barter
swap| USDC((USDC)) ``` ```ts lines theme={null} const PT_ezETH_25APR2024 = "0xeEE8aED1957ca1545a0508AfB51b53cCA7e3c0d1"; const USDC: Address = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const amountIn = parseUnits("10", 18).toString(); const chainId = 1; const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; const routeParams: RouteParams = { chainId, amountIn: [amountIn], fromAddress, tokenIn: [PT_ezETH_25APR2024], tokenOut: [USDC], routingStrategy: "router", receiver: fromAddress, slippage: "500", }; const route = await client.getRouteData(routeParams); console.log(JSON.stringify(route, null, 2)); const approvalData = await client.getApprovalData({ chainId, fromAddress, amount: amountIn, tokenAddress: PT_ezETH_25APR2024, }); await sendEoa(approvalData.tx, approvalData.gas); // sending the actual transaction await sendEoa(route.tx, route.gas); ``` ## Withdraw ADAI to USDC This sample withdraws `ADAI` and swaps it to USDC in a single transaction. [Try this route →](https://happypath.enso.build/?tokenIn=0xeEE8aED1957ca1545a0508AfB51b53cCA7e3c0d1\&outChainId=1\&chainId=1\&tokenOut=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\&amountIn=10000000000000000000) **Route mechanics:** * Withdraw deposited `ADAI` to the underlying `DAI` * Swaps `DAI` to `USDC` * The `receiver` gets the resulting funds ```mermaid theme={null} flowchart LR aDAI((aDAI)) -->|aave-v3
redeem| DAI((DAI)) DAI -->|swap| USDC((USDC)) ``` ```ts lines theme={null} const ADAI_ADDRESS = "0x018008bfb33d285247A21d44E50697654f754e63"; const USDC: Address = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const amountIn = parseUnits("100", 18).toString(); const chainId = 1; const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"; const routeParams: RouteParams = { chainId, destinationChainId: chainId, amountIn: [amountIn], fromAddress, tokenIn: [ADAI_ADDRESS], tokenOut: [USDC], routingStrategy: "router", receiver: fromAddress, slippage: "500", }; const route = await client.getRouteData(routeParams); console.log(JSON.stringify(route, null, 2)); const approvalData = await client.getApprovalData({ chainId, fromAddress, amount: amountIn, tokenAddress: ADAI_ADDRESS, }); await sendEoa(approvalData.tx, approvalData.gas); // sending the actual transaction await sendEoa(route.tx, route.gas); ``` # Zap Repay Debt Source: https://docs.enso.build/pages/use-cases/lending-markets/zap-repay-behalf-of Zap to repay debt from any position
onBehalfOf] USDC --> A2 end ``` ```ts lines highlight={16-17, 26-27, 31, 32, 46} theme={null} const AAVE_v3 = "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2"; const fromAddress = "0x93621dca56fe26cdee86e4f6b18e116e9758ff11"; const USDC_ADDRESS = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"; const WETH_ADDRESS: Address = "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"; const WETH_AMOUNT_IN = parseUnits("0.001", 18).toString(); const bundle = await client.getBundleData( { chainId: 1, fromAddress, routingStrategy: "router", }, [ { protocol: "enso", action: "route", args: { tokenIn: WETH_ADDRESS, tokenOut: USDC_ADDRESS, amountIn: WETH_AMOUNT_IN, }, }, { // FIX: could not simulate TX protocol: "aave-v3", action: "repay", args: { primaryAddress: AAVE_v3, tokenIn: USDC_ADDRESS, amountIn: { useOutputOfCallAt: 0 }, onBehalfOf: fromAddress, }, }, ] ); const approval = await client.getApprovalData({ tokenAddress: WETH_ADDRESS, amount: WETH_AMOUNT_IN, chainId: 1, fromAddress, }); console.log(JSON.stringify(bundle.bundle)); await sendEoa(approval.tx, approval.gas); await sendEoa(bundle.tx, bundle.gas); ``` # Zap to Collateral Source: https://docs.enso.build/pages/use-cases/lending-markets/zap-to-collateral Automatically zap any input token as collateral to arbitrary vault tokens Automatically convert any token into the required vault token and deposit as collateral in a single transaction. In this example, we're zapping WETH to an AAVE `aUSDT` position. ```mermaid theme={null} flowchart LR WETH((WETH)) -->|barter
swap| USDT((USDT)) USDT -->|aave-v3
deposit| aUSDT((aUSDT)) ``` ```typescript lines theme={null} const WETH: Address = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"; // WETH const aUSDT: Address = "0x23878914EFE38d27C4D67Ab83ed1b93A74D4086a"; const fromAddress = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" as Address; const routeParams: RouteParams = { tokenIn: [WETH], tokenOut: [aUSDT], amountIn: ["1000000000000000000"], chainId: 1, routingStrategy: "router", fromAddress, }; const approvalData = await client.getApprovalData({ amount: routeParams.amountIn[0], chainId: 1, tokenAddress: WETH, fromAddress, }); const route = await client.getRouteData(routeParams); await sendEoa(approvalData.tx, approvalData.gas); await sendEoa(route.tx, route.gas); ``` ## Zap Deposits ### **Zap ETH to lend on Aave V3 on Arbitrum** Deposit WETH into Aave on Arbitrum. [Try this route →](https://happypath.enso.build/?tokenIn=0x82aF49447D8a07e3bd95BD0d56f35241523fBab1\&outChainId=42161\&chainId=42161\&tokenOut=0xe50fA9b3c56FfB159cB0FCA61F5c9D750e8128c8\&amountIn=1000000000000000000) **Route Mechanics:** * **Deposit into Aave V3**: The input `WETH` is deposited into the Aave V3 protocol, and in return, you receive `aWETH`, representing your lending position. ```mermaid theme={null} flowchart LR WETH((WETH)) -->|aave-v3
deposit| aWETH((aWETH)) ``` ```javascript lines theme={null} const WETH = "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"; const aWETH = "0xe50fA9b3c56FfB159cB0FCA61F5c9D750e8128c8"; const routeParams = { fromAddress: userAddress, receiver: userAddress, chainId: 42161, // Arbitrum amountIn: ["1000000000000000000"], // 1 WETH tokenIn: [WETH], tokenOut: [aWETH], routingStrategy: "router", }; const route = await client.getRouteData(routeParams); const approval = await client.getApprovalData({ chainId: 42161, fromAddress: userAddress, amount: "1000000000000000000", tokenAddress: WETH, }); // Approval transaction for `router` strategy await sendEoa(approval.tx, approval.gas); // Sending the actual transaction await sendEoa(route.tx, route.gas); ``` *** ### **Zap ETH to lend on Euler V2 on Mainnet** Supply ETH to the Euler V2 lending market on the Ethereum Mainnet. This route provides a seamless way to start earning interest on your ETH. [Try this route →](https://happypath.enso.build/?tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&outChainId=1\&chainId=1\&tokenOut=0xb3b36220fA7d12f7055dab5c9FD18E860e9a6bF8\&amountIn=1000000000000000000) **Route Mechanics:** * **Wrap**: The input `ETH` is first wrapped into `WETH`. * **Deposit**: The `WETH` is then deposited into the Euler V2 protocol, and you receive `eWETH` in return. ```mermaid theme={null} flowchart LR ETH((ETH)) -->|wrapped-native
deposit| WETH((WETH)) WETH -->|euler-v2
deposit| eWETH((eWETH)) ``` ```javascript lines theme={null} const ETH = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const eWETH = "0xb3b36220fA7d12f7055dab5c9FD18E860e9a6bF8"; const routeParams = { fromAddress: userAddress, receiver: userAddress, chainId: 1, // Ethereum amountIn: ["1000000000000000000"], // 1 ETH tokenIn: [ETH], tokenOut: [eWETH], routingStrategy: "router", }; const route = await client.getRouteData(routeParams); // Approval transaction for `router` strategy const approval = await client.getApprovalData({ chainId: 1, fromAddress: userAddress, amount: "1000000000000000000", tokenAddress: ETH, }); // Approval transaction for `router` strategy await sendEoa(approval.tx, approval.gas); // Sending the actual transaction await sendEoa(route.tx, route.gas); ``` *** ### **Lend USDC on Spark on Gnosis** Supply USDC to Spark's money market on the Gnosis chain. This route provides a direct way to enter a lending position. [Try this route →](https://happypath.enso.build/?tokenIn=0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83\&outChainId=100\&chainId=100\&tokenOut=0x5850d127a04ed0b4f1fcdfb051b3409fb9fe6b90\&amountIn=100000000) **Route Mechanics:** * **Deposit into Spark**: Your `USDC` is deposited into the Spark-lend protocol, and you receive `spUSDC` in return, which represents your share in the lending pool. ```mermaid theme={null} flowchart LR USDC((USDC)) -->|spark-lend
deposit| spUSDC((spUSDC)) ``` ```javascript lines theme={null} const USDC = "0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83"; const spUSDC = "0x5850d127a04ed0b4f1fcdfb051b3409fb9fe6b90"; const routeParams = { fromAddress: userAddress, receiver: userAddress, chainId: 100, // Gnosis amountIn: ["100000000"], // 100 USDC tokenIn: [USDC], tokenOut: [spUSDC], routingStrategy: "router", }; const route = await client.getRouteData(routeParams); // approval TX const approvalData = await client.getApprovalData({ chainId: 100, fromAddress: userAddress, amount: "100000000", tokenAddress: USDC, }); await sendEoa(approvalData.tx, approvalData.gas); // Sending the actual transaction await sendEoa(route.tx, route.gas); ``` *** # DEX Market Making Source: https://docs.enso.build/pages/use-cases/market-makers/dex-market-making Automate DEX market making, responding to market conditions programmatically to improve capital efficiency. ## Zap BERA into a Kodiak WBERA/HONEY position This use case automates splitting BERA, swapping for HONEY, and depositing into a concentrated liquidity range on Kodiak. [**Try this route →**](https://happypath.enso.build?chainId=80094\&tokenIn=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\&tokenOut=0x9659dc8c1565E0bd82627267e3b4eEd1a377ebE6) **Route Mechanics:** * Split native BERA into two portions using enso internal routing: * First portion: deposit BERA into wrapped native to get WBERA * Second portion: swap BERA to HONEY using openocean protocol * Deposit both WBERA and HONEY into Kodiak Islands to create the LP position ```mermaid theme={null} flowchart LR BERA((BERA)) --> SPLIT{enso.split} SPLIT -->|wrapped-native
deposit| WBERA((WBERA)) SPLIT -->|openocean
swap| STGUSDC((STGUSDC)) WBERA -->|kodiak-islands
deposit| KODIAK_LP((KODIAK_LP)) STGUSDC -->|kodiak-islands
deposit| KODIAK_LP ``` ```ts theme={null} export async function marketMakeBeraToKodiakLp(): { const BERA: Address = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"; const Kodiak_LP: Address = "0x9659dc8c1565E0bd82627267e3b4eEd1a377ebE6"; const routeParams: RouteParams = { fromAddress: userAddress, receiver: userAddress, chainId: BERACHAIN_CHAIN, amountIn: ["1000000000000000000"], // 1 BERA tokenIn: [BERA], tokenOut: [Kodiak_LP], routingStrategy: 'router' }; const route = await client.getRouteData(routeParams); await sendEoa(route.tx, route.gas); return route; } ``` # Overview Source: https://docs.enso.build/pages/use-cases/market-makers/index
check| USDC_ETH((USDC)) subgraph ethereum ["🌐 Ethereum"] USDC_ETH((USDC)) -->|reservoir
deposit| rUSD_ETH((rUSD)) end rUSD_ETH -.-> |balance
check|rUSD_BERA((rUSD)) subgraph berachain ["🐻 Berachain"] rUSD_BERA((rUSD)) -->|dolomite
deposit| dsrUSD((Dolomite LP)) end ``` **Route Mechanics:** This bundle consists of 2 atomic crosschain transactions: * Bridge USDCe from Berachain to Ethereum using Stargate * Check USDC balance on Ethereum after successful bridge completion * Mint rUSD using the bridged USDC through Reservoir's minting contract * Route rUSD for srUSD on Ethereum * Bridge the newly minted rUSD back to Berachain via a Stargate bridge * Check srUSD balance on Berachain post-bridging * Deposit rUSD into Dolomite sRUSD vault for yield
Updated
check| USDC_ETH((USDCe)) subgraph ethereum ["🌐 Ethereum"] USDC_ETH((USDC)) -->|reservoir
deposit| rUSD_ETH((rUSD)) end rUSD_ETH -.-> |balance
check|rUSD_BERA((rUSD)) subgraph berachain ["🐻 Berachain"] rUSD_BERA((rUSD)) -->|euler-v2
deposit| esrUSD((esrUSD)) end ``` Route Mechanics: This advanced bundle orchestrates a complete crosschain yield strategy through multiple atomic transactions: * Bridge USDCe from Berachain to Ethereum using Stargate protocol * Check USDCe balance on Ethereum after successful bridge completion * Mint rUSD using the bridged USDCe through Reservoir's minting contract * Bridge newly minted rUSD back to Berachain via Stargate bridge * Check rUSD balance on Berachain after bridging * Deposit rUSD into Euler V2 vault for automated yield generation ```typescript mintOnBeraDepositOnMainnet.ts highlight={23, 51, 59,83, 91} lines theme={null} const BERACHAIN_ID = 80094; const ETHEREUM_ID = 1; // Common addresses const WALLET_ADDRESS = "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11"; // User wallet // Token addresses const USDCE_BERACHAIN = "0x549943e04f40284185054145c6E4e9568C1D3241"; const USDC_ETHEREUM = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const RUSD_ETHEREUM = "0x09D4214C03D01F49544C0448DBE3A27f768F2b34"; const RUSD_BERACHAIN = "0x09D4214C03D01F49544C0448DBE3A27f768F2b34"; // Protocol addresses const RESERVOIR_MINTING_CONTRACT = "0x4809010926aec940b550D34a46A52739f996D75D"; const EULER_VAULT_E_RUSD_BERACHAIN = "0xB8064453B25a91D7a4e8b7e7883A817D5742dE34"; // Euler vault srUSD/USDe on Berachain (need actual address) const srUSD = "0x5475611dffb8ef4d697ae39df9395513b6e947d7"; const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY!, }); const usdcBeraToEthPools = await client.getLayerZeroPool({ chainId: BERACHAIN_ID, token: USDCE_BERACHAIN, destinationChainId: ETHEREUM_ID + "", }); const rusdEthToBeraPools = await client.getLayerZeroPool({ chainId: ETHEREUM_ID, token: RUSD_ETHEREUM, destinationChainId: BERACHAIN_ID + "", }); if (!(usdcBeraToEthPools.length && usdcBeraToEthPools.length)) { throw new Error("Required pools not available"); } const bundle = await client.getBundleData( { chainId: BERACHAIN_ID, fromAddress: WALLET_ADDRESS, spender: WALLET_ADDRESS, routingStrategy: "router", }, [ { protocol: "stargate", action: "bridge", args: { primaryAddress: usdcBeraToEthPools[0].pool, destinationChainId: ETHEREUM_ID, tokenIn: USDCE_BERACHAIN, amountIn: parseUnits("1000", 6).toString(), // 1000 USDC receiver: WALLET_ADDRESS, callback: [ // Step 1: Check USDCe balance on Ethereum after bridge { protocol: "enso", action: "balance", args: { token: USDC_ETHEREUM, }, }, // Step 2: Mint rUSD using bridged USDCe on Ethereum { protocol: "reservoir", action: "deposit", args: { primaryAddress: RESERVOIR_MINTING_CONTRACT, tokenIn: USDC_ETHEREUM, tokenOut: RUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 0 }, // Use USDCe from balance check receiver: WALLET_ADDRESS, }, }, // Step 3: Bridge newly minted rUSD back to Berachain { protocol: "stargate", action: "bridge", args: { primaryAddress: rusdEthToBeraPools[0].pool, destinationChainId: BERACHAIN_ID, tokenIn: RUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 1 }, // Use rUSD from minting receiver: WALLET_ADDRESS, // Callback executes on Berachain after rUSD arrives callback: [ // Step 1: Check rUSD balance on Berachain { protocol: "enso", action: "balance", args: { token: RUSD_BERACHAIN, }, }, // Step 2: Route rUSD to srUSD { protocol: "enso", action: "route", args: { tokenIn: RUSD_BERACHAIN, tokenOut: srUSD, amountIn: { useOutputOfCallAt: 0 }, }, }, // Step 3: deposit into Euler v2 srUSD vault { protocol: "euler-v2", action: "deposit", args: { primaryAddress: EULER_VAULT_E_RUSD_BERACHAIN, tokenIn: srUSD, tokenOut: EULER_VAULT_E_RUSD_BERACHAIN, amountIn: [{ useOutputOfCallAt: 1 }], // Use e-rUSD from balance check receiver: WALLET_ADDRESS, }, }, ], }, }, ], }, }, ] ); ``` **Important Considerations** * All crosschain operations execute atomically - if any step fails, the entire transaction reverts and funds are safely returned * Gas costs for all destination chains are calculated and paid upfront using LayerZero's native drop feature * Bridge fees and slippage may cause slight variations in final amounts received ## Related Documentation * [Bridge Action Reference](/pages/build/reference/actions#bridge) - Technical details on crosschain bridging * [Crosschain Bridging Guide](/pages/build/examples/bridging) - Getting started with multi-chain workflows * [getLayerZeroPool SDK Method](https://github.com/EnsoBuild/sdk-ts?tab=readme-ov-file#bridging-pool-address) - Finding available bridge pools programmatically
Updated
route| wsrUSD_ETH((wsrUSD)) end wsrUSD_ETH -.->|stargate
bridge| wsrUSD_KATANA((wsrUSD)) subgraph katana ["⚔️ Katana"] wsrUSD_KATANA -->|morpho-markets-v1
deposit| MORPHO_SHARES((Morpho
wsrUSD/vbUSD)) end style MORPHO_SHARES stroke-dasharray: 5 5 ``` \*\*Route Mechanics: \*\*This bundle facilitates stablecoin diversification across chains through a the following process: * Convert USDC to wsrUSD\_ETH on Ethereum using Enso's routing * Bridge the newly minted rUSD from Ethereum to Katana chain via Stargate * Check wsrUSD balance on Katana after bridge completion * Deposit wsrUSD to [wsrUSD/vbUSD Morpho position](https://app.morpho.org/katana/market/0xd8a93a4cd16f843c385391e208a9a9f2fd75aedfcca05e4810e5fbfcaa6baec6/wsrusd-vbusdc) The strategy enables users to access Katana's DeFi ecosystem while starting with familiar USDC on Ethereum and relying on Reservoir Stablecoin. ```typescript lines highlight={} theme={null} const KATANA_ID = 747474; const ETHEREUM_ID = 1; // Common addresses const WALLET_ADDRESS = "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11"; // User wallet // Token addresses const MORPHO = "0xD50F2DffFd62f94Ee4AEd9ca05C61d0753268aBc"; const USDC_ETHEREUM = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const wsrUSD_KATANA = "0x4809010926aec940b550D34a46A52739f996D75D"; const wsrUSD_ETHEREUM = "0xd3fd63209fa2d55b07a0f6db36c2f43900be3094"; const wsrUSD_MORPHO_POSITION_ID = "0xd8a93a4cd16f843c385391e208a9a9f2fd75aedfcca05e4810e5fbfcaa6baec6"; const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY!, }); // LayerZero pool addresses const wsrEthToKatanaPools = await client.getLayerZeroPool({ chainId: ETHEREUM_ID, token: wsrUSD_ETHEREUM, destinationChainId: KATANA_ID, destinationToken: wsrUSD_KATANA, }); console.log(JSON.stringify(wsrEthToKatanaPools), !wsrEthToKatanaPools.length); if (!wsrEthToKatanaPools.length) { throw new Error("Required pools not available"); } const bundle = await client.getBundleData( { chainId: ETHEREUM_ID, fromAddress: WALLET_ADDRESS, spender: WALLET_ADDRESS, routingStrategy: "router", }, [ // mint wsrUSD on Ethereum { protocol: "enso", action: "route", args: { amountIn: parseUnits("1000", 6).toString(), // 1000 USDC tokenIn: USDC_ETHEREUM, receiver: WALLET_ADDRESS, tokenOut: wsrUSD_ETHEREUM, }, }, { protocol: "stargate", action: "bridge", args: { primaryAddress: wsrEthToKatanaPools[0].pool as Address, destinationChainId: KATANA_ID, tokenIn: wsrUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 0 }, receiver: WALLET_ADDRESS, callback: [ // Step 1: Check wsrUSD balance on Katana after bridge { protocol: "enso", action: "balance", args: { token: wsrUSD_KATANA, }, }, { protocol: "morpho-markets-v1", action: "deposit", args: { amountIn: { useOutputOfCallAt: 0 }, tokenIn: wsrUSD_KATANA, receiver: WALLET_ADDRESS, primaryAddress: MORPHO, positionId: wsrUSD_MORPHO_POSITION_ID, }, }, ], }, }, ] ); ``` **Important Considerations** * Bridge operations execute sequentially - Katana operations only proceed after successful Ethereum minting * LayerZero bridge fees apply for transfers between Ethereum and Katana * Gas costs for both chains are paid from the originating Ethereum transaction ## Resources: * [Bridge Action Reference](/pages/build/reference/actions#bridge) - Technical details on crosschain bridging * [Route Action Reference](/pages/build/reference/actions#route) - Using Enso's routing aggregation * [Deposit Action Reference](/pages/build/reference/actions#deposit) - Using Enso's deposit action * [getLayerZeroPool SDK Method](https://github.com/EnsoBuild/sdk-ts?tab=readme-ov-file#bridging-pool-address) - Finding available bridge pools programmatically * [Crosschain Bridging Guide](/pages/build/examples/bridging) - Getting started with multi-chain workflows
Updated
route| wsrUSD_ETH((wsrUSD)) end wsrUSD_ETH -.->|stargate
bridge| wsrUSD_KAT((wsrUSD)) subgraph katana ["⚔️ Katana"] wsrUSD_KAT -->|enso
route| vbUSDC_KAT((vbUSDC)) vbUSDC_KAT -->|yearn-v3
deposit| yvvbUSDC((yvvbUSDC)) end ``` **Route Mechanics:** This yield strategy orchestrates multiple protocols across Ethereum Mainnet and Katana: * Convert USDC to wsrUSD on Ethereum using Enso's swap routing * Bridge wsrUSD from Ethereum to Katana chain via Stargate protocol * Check wsrUSD balance on Katana after bridge completion * Swap wsrUSD for vault-bridged USDC (vbUSDC) using Enso routing * Deposit vbUSDC into Yearn V3 vault for automated yield optimization strategies ```typescript lines highlight={} theme={null} const KATANA_ID = 747474; const ETHEREUM_ID = 1; // Common addresses const WALLET_ADDRESS = "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11"; // User wallet // Token addresses const yvvbUSDC_KATANA = "0x80c34BD3A3569E126e7055831036aa7b212cB159"; const vbUSDC_KATANA = "0x203A662b0BD271A6ed5a60EdFbd04bFce608FD36"; const USDC_ETHEREUM = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const wsrUSD_KATANA = "0x4809010926aec940b550D34a46A52739f996D75D"; const wsrUSD_ETHEREUM = "0xd3fd63209fa2d55b07a0f6db36c2f43900be3094"; const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY!, }); // LayerZero pool addresses const wsrEthToKatanaPools = await client.getLayerZeroPool({ chainId: ETHEREUM_ID, token: wsrUSD_ETHEREUM, destinationChainId: KATANA_ID, destinationToken: wsrUSD_KATANA, }); console.log(JSON.stringify(wsrEthToKatanaPools), !wsrEthToKatanaPools.length); if (!wsrEthToKatanaPools.length) { throw new Error("Required pools not available"); } const bundle = await client.getBundleData( { chainId: ETHEREUM_ID, fromAddress: WALLET_ADDRESS, spender: WALLET_ADDRESS, routingStrategy: "router", }, [ // mint wsrUSD on Ethereum { protocol: "enso", action: "route", args: { amountIn: parseUnits("1000", 6).toString(), // 1000 USDC tokenIn: USDC_ETHEREUM, receiver: WALLET_ADDRESS, tokenOut: wsrUSD_ETHEREUM, }, }, { protocol: "stargate", action: "bridge", args: { primaryAddress: wsrEthToKatanaPools[0].pool as Address, destinationChainId: KATANA_ID, tokenIn: wsrUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 0 }, receiver: WALLET_ADDRESS, callback: [ // Step 1: Check wsrUSD balance on Katana after bridge { protocol: "enso", action: "balance", args: { token: wsrUSD_KATANA, }, }, // Step 2: Swap wsrUSD to vbUSDC for Yearn compatibility { protocol: "enso", action: "route", args: { amountIn: { useOutputOfCallAt: 0 }, tokenIn: wsrUSD_KATANA, tokenOut: vbUSDC_KATANA, receiver: WALLET_ADDRESS, }, }, // Step 3: Deposit vbUSDC into Yearn V3 vault { protocol: "yearn-v3", action: "deposit", args: { amountIn: { useOutputOfCallAt: 1 }, tokenIn: vbUSDC_KATANA, receiver: WALLET_ADDRESS, primaryAddress: yvvbUSDC_KATANA, }, }, ], }, }, ] ); ``` **Important Considerations** * Yearn vault strategies automatically optimize yield through multiple DeFi protocols on Katana * Bridge operations execute sequentially - Katana operations only proceed after successful Ethereum minting * LayerZero bridge fees apply for transfers between Ethereum and Katana * Vault deposit generates yvvbUSDC tokens representing your share of the yield-bearing position * Gas costs for both chains are paid from the originating Ethereum transaction ## Related Documentation * [Crosschain Bridging Guide](/pages/build/examples/bridging) - Getting started with multi-chain workflows * [Bridge Action Reference](/pages/build/reference/actions#bridge) - Technical details on crosschain bridging * [Route Action Reference](/pages/build/reference/actions#route) - Using Enso's routing aggregation * [Deposit Action Reference](/pages/build/reference/actions#deposit) - Vault deposit mechanics * [getLayerZeroPool SDK Method](https://github.com/EnsoBuild/sdk-ts?tab=readme-ov-file#bridging-pool-address) - Finding available bridge pools programmatically
Updated
bridge| B1 subgraph ethereum ["🌐 Ethereum"] B1(( )) -->|balance
check| USDC_ETH((USDC)) USDC_ETH -->|reservoir
deposit| A2(( )) --> rUSD_ETH((rUSD)) rUSD_ETH -.->|stargate
bridge| C1 end subgraph berachain ["🐻 Berachain"] C1(( )) -->|balance
check| rUSD_BERA((rUSD)) end ``` **Route Mechanics:** This bundle orchestrates a complete crosschain yield strategy through multiple atomic operations: * Bridge USDCe from Berachain to Ethereum using Stargate protocol * Check USDCebalance on Ethereum after successful bridge completion * Mint rUSD using the bridged USDCethrough Reservoir's minting contract * Bridge newly minted rUSD back to Berachain via Stargate bridge * Check rUSD balance on Berachain after the bridge returns ```typescript mintOnBeraFromMainnet.ts highlight={21, 27, 47, 54, 63, 75} lines theme={null} // Chain IDs const BERACHAIN_ID = 80094; const ETHEREUM_ID = 1; // Common addresses const WALLET_ADDRESS = "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11"; // User wallet // Token addresses const USDCE_BERACHAIN = "0x549943e04f40284185054145c6E4e9568C1D3241"; const USDC_ETHEREUM = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const RUSD_ETHEREUM = "0x09D4214C03D01F49544C0448DBE3A27f768F2b34"; // Protocol addresses const RESERVOIR_MINTING_CONTRACT = "0x4809010926aec940b550D34a46A52739f996D75D"; const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY || "your-api-key-here", }); const usdcBeraToEthPools = await client.getLayerZeroPool({ chainId: BERACHAIN_ID, token: USDCE_BERACHAIN, destinationChainId: ETHEREUM_ID + "", }); const rusdEthToBeraPools = await client.getLayerZeroPool({ chainId: ETHEREUM_ID, token: RUSD_ETHEREUM, destinationChainId: BERACHAIN_ID + "", }); if (!(usdcBeraToEthPools.length && usdcBeraToEthPools.length)) { throw new Error("Required pools not available"); } const bundle = await client.getBundleData( { chainId: BERACHAIN_ID, fromAddress: WALLET_ADDRESS, spender: WALLET_ADDRESS, routingStrategy: "router", }, [ { protocol: "stargate", action: "bridge", args: { primaryAddress: usdcBeraToEthPools[0].pool, destinationChainId: ETHEREUM_ID, tokenIn: USDCE_BERACHAIN, amountIn: parseUnits("1000", 6).toString(), // 1000 USDC receiver: WALLET_ADDRESS, callback: [ // Step 1: Check USDCebalance on Ethereum after bridge { protocol: "enso", action: "balance", args: { token: USDC_ETHEREUM, }, }, // Step 2: Mint rUSD using bridged USDC { protocol: "reservoir", action: "deposit", args: { primaryAddress: RESERVOIR_MINTING_CONTRACT, tokenIn: USDC_ETHEREUM, tokenOut: RUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 0 }, // Use USDCefrom balance check receiver: WALLET_ADDRESS, }, }, // Step 3: Bridge newly minted rUSD back to Berachain { protocol: "stargate", action: "bridge", args: { primaryAddress: rusdEthToBeraPools[0].pool, destinationChainId: BERACHAIN_ID, tokenIn: RUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 1 }, // Use e-rUSD from minting receiver: WALLET_ADDRESS, }, }, ], }, }, ] ); return bundle; ``` **Important considerations** * This bundle executes multiple crosschain operations atomically - if any step fails, the entire transaction reverts * LayerZero bridge fees apply for both USDCe and rUSD transfers between chains * Gas costs for Ethereum minting and Berachain vault deposit are calculated upfront * Bridge timing may vary based on network congestion on both chains ## Resources: * [Bridge Action Reference](/pages/build/reference/actions#bridge) - Technical details on crosschain bridging * [Crosschain Routing Guide](/pages/build/get-started/crosschain-routing) - Getting started with multi-chain workflows * [getLayerZeroPool SDK Method](https://github.com/EnsoBuild/sdk-ts?tab=readme-ov-file#bridging-pool-address) - Finding available bridge pools programmatically * [Bundle Actions Guide](/pages/build/get-started/bundling-actions) - Creating complex multi-step transactions
Updated
route| rUSD_ETH((rUSD)) end rUSD_ETH -.->|stargate
bridge| rUSD_KAT((rUSD)) subgraph katana ["⚔️ Katana"] rUSD_KAT -->|enso
route| VBUSDC((vbUSDC)) end ``` \*\*Route Mechanics: \*\* This bundle facilitates stablecoin diversification across chains through a the following process: * Convert USDC to rUSD on Ethereum using Enso's routing aggregation * Bridge the newly minted rUSD from Ethereum to Katana chain via Stargate * Check rUSD balance on Katana after bridge completion * Swap rUSD for vault-bridged USDC (vbUSDC) on Katana The strategy enables users to access Katana's DeFi ecosystem while starting with familiar USDC on Ethereum and relying on Reservoir Stablecoin. ```typescript lines highlight={} theme={null} const KATANA_ID = 747474; const ETHEREUM_ID = 1; // Common addresses const WALLET_ADDRESS = "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11"; // User wallet // Token addresses const rUSD_ETHEREUM = "0x09D4214C03D01F49544C0448DBE3A27f768F2b34"; const rUSD_KATANA = "0x09D4214C03D01F49544C0448DBE3A27f768F2b34"; const USDC_ETHEREUM = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"; const VBUSDC_KATANA = "0x203A662b0BD271A6ed5a60EdFbd04bFce608FD36"; const client = new EnsoClient({ apiKey: process.env.ENSO_API_KEY!, }); // LayerZero pool addresses const wsrEthToKatanaPools = await client.getLayerZeroPool({ chainId: ETHEREUM_ID, token: rUSD_ETHEREUM, destinationChainId: KATANA_ID, destinationToken: rUSD_KATANA, }); // LayerZero pool addresses const rUsdKatanaToEthRUsd = await client.getLayerZeroPool({ chainId: ETHEREUM_ID, token: rUSD_ETHEREUM, destinationChainId: KATANA_ID, destinationToken: rUSD_KATANA, }); console.log(JSON.stringify(wsrEthToKatanaPools), !wsrEthToKatanaPools.length); if (!wsrEthToKatanaPools.length) { throw new Error("Required pools not available"); } const bundle = await client.getBundleData( { chainId: ETHEREUM_ID, fromAddress: WALLET_ADDRESS, spender: WALLET_ADDRESS, routingStrategy: "router", }, [ // mint wsrUSD on Ethereum { protocol: "enso", action: "route", args: { amountIn: parseUnits("1000", 6).toString(), // 1000 USDC tokenIn: USDC_ETHEREUM, receiver: WALLET_ADDRESS, tokenOut: rUSD_ETHEREUM, }, }, { protocol: "stargate", action: "bridge", args: { primaryAddress: wsrEthToKatanaPools[0].pool as Address, destinationChainId: KATANA_ID, tokenIn: rUSD_ETHEREUM, amountIn: { useOutputOfCallAt: 0 }, receiver: WALLET_ADDRESS, callback: [ // Step 1: Check wsrUSD balance on Katana after bridge { protocol: "enso", action: "balance", args: { token: rUSD_KATANA, }, }, // Step 2: Swap wsrUSD to vbUSDC { protocol: "enso", action: "route", args: { tokenIn: rUSD_KATANA, tokenOut: VBUSDC_KATANA, amountIn: { useOutputOfCallAt: 0 }, // Use wsrUSD_KATANA from balance check receiver: WALLET_ADDRESS, }, }, ], }, }, ] ); ``` **Important Considerations** * Bridge operations execute sequentially - Katana operations only proceed after successful Ethereum minting * LayerZero bridge fees apply for transfers between Ethereum and Katana * Gas costs for both chains are paid from the originating Ethereum transaction ## Resources: * [Bridge Action Reference](/pages/build/reference/actions#bridge) - Technical details on crosschain bridging * [Route Action Reference](/pages/build/reference/actions#route) - Using Enso's routing aggregation * [getLayerZeroPool SDK Method](https://github.com/EnsoBuild/sdk-ts?tab=readme-ov-file#bridging-pool-address) - Finding available bridge pools programmatically * [Crosschain Bridging Guide](/pages/build/examples/bridging) - Getting started with multi-chain workflows
Updated