Building actions

import { swap } from "0xtrails";

swap({
  tokenIn: "USDC",
  tokenOut: "WETH",
  amountIn: "100",       // EXACT_INPUT: spend exactly 100 USDC
  // amountOut: "0.05",  // EXACT_OUTPUT: receive exactly 0.05 WETH
  feeTier: 3000,         // optional; default 0.3%
  slippage: 0.005,       // optional; default from provider config
})

import { lend } from "0xtrails";

lend({
  marketId: "aave-v3-usdc-polygon",
  token: "USDC",
  amount: dynamic(), // consume whatever arrived from the previous step
})

import { deposit } from "0xtrails";

deposit({
  marketId: "morpho-usdc-vault",
  token: "USDC",
  amount: "500",
})

import { assertCondition } from "0xtrails";

assertCondition({
  type: "balance",
  token: "USDC",
  minAmount: "90", // revert if less than 90 USDC arrived
})

import { custom } from "0xtrails";
import { encodeFunctionData } from "viem";

custom({
  target: "0xCONTRACT_ADDRESS",
  calldata: encodeFunctionData({
    abi: MY_ABI,
    functionName: "myFunction",
    args: [arg1, arg2],
  }),
  value: 0n, // optional ETH value
})

import { erc20Utils } from "0xtrails";

// Canonical USDC address and decimals on Base
const { address, decimals } = erc20Utils.USDC.onChain("base");

// Generic symbol lookup
const weth = erc20Utils.token("WETH").onChain(137);

import { approve, transfer, buildApproveAndCall } from "0xtrails";

// Generate approve calldata (raw bigint amount)
const approveTx = approve({ spender: "0xSPENDER", amount: 1000000n });

// Bundle an approve + downstream call
const [approveTx, callTx] = buildApproveAndCall({
  token: "0xUSDC",
  spender: "0xSPENDER",
  call: { target: "0xCONTRACT", calldata: "0x..." },
  // amount defaults to maxUint256 if omitted
});

import { getAmountWithSlippage } from "0xtrails";

// Apply 50 bps slippage to a minimum output amount
const minOut = getAmountWithSlippage({ amount: 1000000n, slippageBps: 50 });