// Generated Jest tests from MDX files

it('slippage', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "enso",
      action: "slippage",
      args: {
        bps: "100", // 1% maximum slippage (100 basis points)
        amountOut: { "useOutputOfCallAt": 0 } // Reference previous action's output
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('route', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "enso",
      action: "route",
      args: {
        tokenIn: "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", // ETH address
        tokenOut: "0xae7ab96520de3a18e5e111b5eaab095312d7fe84", // stETH address
        amountIn: "1000000000000000000", // Amount in wei (1 ETH)
        slippage: "300", // 3% slippage tolerance (in basis points)
        receiver: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e", // Optional: Receiver address
        primaryAddress: "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", // Optional: Primary contract address
        poolFee: "3000" // Optional: Pool fee in basis points (e.g., 3000 for 0.3%)
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('swap', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "uniswap-v2",
      action: "swap",
      args: {
        tokenIn: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH
        tokenOut: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
        amountIn: "1000000000000000000", // 1 WETH (18 decimals)
        primaryAddress: "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", // Uniswap V2 Router
        receiver: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e", // Receiver
        slippage: "100", // Optional: 1% slippage (100 basis points)
        poolFee: "3000" // Optional: Pool fee in basis points (e.g., 3000 for 0.3%)
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('call', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "enso",
      action: "call",
      args: {
        address: "0xD0aF6F692bFa10d6a535A3A321Dc8377F4EeEF12", // Contract address
        method: "percentMul", // Method name
        abi: "function percentMul(uint256,uint256) external", // ABI signature
        args: [
          "1000000000000000000", // 1 ETH (first argument)
          "7000" // 70% (second argument)
        ]
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('deposit', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "aave-v3",
      action: "deposit",
      args: {
        tokenIn: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", // WETH address
        tokenOut: "0x4d5F47FA6A74757f35C14fD3a6Ef8E3C9BC514E8", // aWETH address (optional)
        amountIn: "1000000000000000000", // Amount in wei (1 WETH)
        primaryAddress: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2", // Aave V3 pool
        receiver: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e" // Optional: Receiver address
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('depositCLMM', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "uniswap-v3",
      action: "depositclmm",
      args: {
        tokenIn: [
          "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH
          "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"  // USDC
        ],
        tokenOut: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88", // UNI-V3-POS NFT
        amountIn: [
          "1000000000000000000", // 1 WETH (18 decimals)
          "1000000"  // 1 USDC (6 decimals)
        ],
        ticks: ["-76800", "-73728"], // Lower and upper tick bounds
        poolFee: "3000", // 0.3% fee tier
        receiver: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e" // Optional: Receiver
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('withdraw', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "erc4626",
      action: "withdraw",
      args: {
        primaryAddress: "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0", // Vault address
        tokenIn: "0x6b175474e89094c44da98b954eedeac495271d0f", // Token to withdraw (e.g. yvDAI)
        tokenOut: "0x6b175474e89094c44da98b954eedeac495271d0f", // Output token (e.g. DAI)
        amountOut: "1000000000000000000", // Amount to withdraw in wei (1 DAI)
        receiver: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e" // Optional: Receiver
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('redeem', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "erc4626",
      action: "redeem",
      args: {
        tokenIn: "0xdA816459F1AB5631232FE5e97a05BBBb94970c95", // yvDAI (optional)
        tokenOut: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", // USDC
        amountIn: "1000000000000000000", // Amount of shares to redeem (1 yvDAI)
        primaryAddress: "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0", // ERC4626 vault
        receiver: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e" // Optional: Receiver
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('redeemCLMM', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "uniswap-v3",
      action: "redeemclmm",
      args: {
        tokenIn: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88", // UNI-V3-POS NFT
        tokenOut: [
          "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH
          "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"  // USDC
        ],
        liquidity: "1000000000000", // Liquidity amount to withdraw
        tokenId: "123456", // The NFT token ID
        receiver: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e" // Optional: Receiver
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('borrow', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "aave-v3",
      action: "borrow",
      args: {
        collateral: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", // WETH address (collateral)
        tokenOut: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", // USDC address (to borrow)
        amountOut: "1000000000", // Amount to borrow in wei (1000 USDC with 6 decimals)
        primaryAddress: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2" // Aave V3 pool
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('repay', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "aave-v3",
      action: "repay",
      args: {
        tokenIn: "0xdac17f958d2ee523a2206206994597c13d831ec7", // USDT address
        amountIn: "100000000", // Amount to repay in wei (100 USDT with 6 decimals)
        primaryAddress: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2" // Aave V3 pool
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('harvest', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "curve-gauge",
      action: "harvest",
      args: {
        token: "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0", // Token address (LP token or gauge token)
        primaryAddress: "0x182B723a58739a9c974cFDB385ceaDb237453c28" // Curve gauge address
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('approve', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "erc20",
      action: "approve",
      args: {
        token: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", // WETH address
        spender: "0xe592427a0aece92de3edee1f18e0157c05861564", // Spender address (e.g., Uniswap router)
        amount: "1000000000000000000000000" // Amount to approve in wei (1M WETH)
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('transfer', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "erc20",
      action: "transfer",
      args: {
        token: "0xd26114cd6EE289AccF82350c8d8487fedB8A0C07", // OMG token address
        receiver: "0x80eba3855878739f4710233a8a19d89bdd2ffb8e", // Recipient address
        amount: "1000000000000000000", // Amount to transfer in wei (1 OMG)
        id: "1234" // Optional: ID for ERC721 or ERC1155 tokens
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('transferFrom', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "erc20",
      action: "transferfrom",
      args: {
        token: "0xd26114cd6EE289AccF82350c8d8487fedB8A0C07", // OMG token address
        sender: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", // Sender address
        receiver: "0x93621DCA56fE26Cdee86e4F6B18E116e9758Ff11", // Recipient address
        amount: "1000000000000000000", // Amount to transfer in wei (1 OMG)
        id: "1234" // Optional: ID for ERC721 or ERC1155 tokens
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('permitTransferFrom', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "permit2",
      action: "permittransferfrom",
      args: {
        token: "0xd26114cd6EE289AccF82350c8d8487fedB8A0C07", // Token address
        amount: "1000000000000000000", // Amount in wei (1 token)
        sender: "0xb67f3CE46bB9E1a1127796c27f38DbaB9f643ec0", // Sender address
        receiver: "0x35a2839b617F7da6534d636f22945f6Cb6137130", // Receiver address
        nonce: "1", // Nonce to prevent replay attacks
        deadline: "1710150268", // Timestamp deadline for signature validity
        signature: "0x..." // Permit signature
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('bridge', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "stargate",
      action: "bridge",
      args: {
        primaryAddress: "0x38EA452219524Bb87e18dE1C24D3bB59510BD783", // Source pool address
        destinationChainId: 42161, // Target chain ID (e.g., Arbitrum)
        tokenIn: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // Source token address (USDC)
        amountIn: "1000000000", // Amount to bridge (1000 USDC with 6 decimals)
        receiver: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", // Destination address
        callback: [ // Optional array of actions to execute on destination chain
          {
            protocol: "enso",
            action: "balance",
            args: {
              token: "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8" // Destination token address
            }
          },
          // Additional callback actions can reference the balance output...
        ]
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('fee', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "enso",
      action: "fee",
      args: {
        token: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        amount: "1000000000000",
        bps: "500",
        receiver: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('split', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "enso",
      action: "split",
      args: {
        tokenIn: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH
        tokenOut: [
          "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH portion 1
          "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH portion 2
          "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"  // WETH portion 3
        ],
        amountIn: "1000000000000000000", // 1 ETH (18 decimals)
        receiver: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('merge', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "enso",
      action: "merge",
      args: {
        tokenIn: [
          "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH
          "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // WETH
          "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"  // WETH
        ],
        tokenOut: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", // Combined WETH
        amountIn: [
          "100000000000000000", // 0.1 ETH
          "200000000000000000", // 0.2 ETH
          "300000000000000000"  // 0.3 ETH
        ],
        receiver: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('balance', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "enso",
      action: "balance",
      args: {
        token: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" // USDC
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});

it('minamountout', async () => {
 const bundle = await client.getBundleData(
  {
    chainId: 1,
    fromAddress: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    routingStrategy: "delegate"
  },
  [
    {
      protocol: "enso",
      action: "minamountout",
      args: {
        amountOut: { "useOutputOfCallAt": 0 }, // Reference to previous action's output
        minAmountOut: { "useOutputOfCallAt": 1 } // Strict reference to another action's output
      }
    }
  ]
);
 console.log(JSON.stringify(bundle, null, 2));
});



Returns total USD and transactions volume for the given chainId.

Chain and transactions volume

Enso Developer Documentation

Enso Shortcuts APIs convert high-level specifications of desired DeFi outcomes into calldata.

Get Started

Find optimal paths for crosschain entering/exiting DeFi positions or swapping ERC20 tokens.

DeFi and Swap Routing

Bundle several DeFi actions into a single transaction using the `bundle` API.

Bundling Actions

Access DeFi protocols and tokens data through Enso's API

Get Protocol Data

Get balances of tokens in a wallet address.

Get Balances

Obtain Enso API key to access the Enso API.

Authentication

Explore shortcuts for common DeFi workflows.

Shortcuts Library

Get calldata for routing to non-tokenized positions.

Non-tokenized DeFi Positions

Get calldata for bridging tokens across chains.

Bridging

Tag requests with a referral code to track usage and rewards.

Request Tracking

Actions are interactions with DeFi protocols Enso supports.

Actions

Understand `delegate` and `route` routing strategies for shortcuts APIs.

Routing Strategies

Supported Networks

Understand Enso's core concepts and how they work.

Concepts

Deployments

Understand the legal aspects of using Enso API.

Licence & Legal

Whitepaper

Learn about Enso API and its capabilities.

Overview

Enso SDK is a JavaScript library for interacting with Enso API.

Swagger

Ready-to-use components and applications that leverage Enso's APIs for immediate integration into your frontend.

A React component and web app for cross-chain routing of DeFi positions and tokens.

Cross-chain Route Widget

A React component and web app that enables migration of base tokens and DeFi positions from Uniswap V3 to V4 across all supported chains.

Uniswap Migrator

A React component that integrates the Enso API to provide token swapping and DeFi operations directly in your application.

Route Widget

A UI to navigate projects, protocols, and positions in the Enso ecosystem, always up-to-date with live integrations.

Enso DeFi Navigator

A DeFi application that optimizes returns by migrating yield-bearing positions between protocols using the Enso SDK.

Yield Migrator

A dApp that helps users diversify into random tokens from selected sectors using the Enso SDK.

Feeling Lucky

Enso Network

Tokenomics

Participants who secure the Enso Network by validating solutions and maintaining integrity

Validators

Individuals who build algorithms to solve consumer requests on the Enso Network

Graphers

Developers who publish smart contract abstractions on the Enso Network

Action Providers

Latest updates on API changes, supported protocols, positions, and chains in Enso.

Api Reference

Reference

Chain and transactions volume

Path Parameters