Bankr x402 SDK - Token Swaps

SDK 代币兑换

使用 AI 驱动的 0x 路由构建并执行代币兑换。

提示词模式

模式	示例
按数量	“将 0.1 ETH 兑换为 USDC”
按价值	“购买价值 $100 的 DEGEN”
按百分比	“将我 50% 的 ETH 兑换为 USDC”
全部卖出	“卖出我的所有 DEGEN”
指定链	“在 Polygon 上将 ETH 兑换为 USDC”

# Amount Swaps
"Swap 0.1 ETH to USDC"
"Exchange 100 USDC for WETH"
"Swap 1000 DEGEN to ETH"

# Value Swaps
"Buy $100 worth of DEGEN"
"Purchase $50 of ETH"

# Percentage Swaps
"Swap 50% of my ETH to USDC"
"Sell 25% of my DEGEN"

# Chain-Specific
"Swap 0.1 ETH to USDC on Base"
"Exchange 100 USDC for WETH on Ethereum"

ERC20 授权处理

对于 ERC20 兑换（卖出 ETH 以外的代币），需要先授权，然后才能兑换。

const result = await client.promptAndWait({
  prompt: "Swap 100 USDC to WETH",
});

const swapTx = result.transactions?.find(tx => tx.type === "swap");

// Check if approval is needed
if (swapTx?.metadata.approvalRequired) {
  // Execute pre-built approval transaction first
  await wallet.sendTransaction(swapTx.metadata.approvalTx);
}

// Then execute the swap
await wallet.sendTransaction(swapTx.metadata.transaction);

授权字段

字段	描述
approvalRequired	兑换前是否需要授权
approvalTx	预构建的授权交易（可直接发送）
allowanceTarget	0x AllowanceHolder 地址（用于手动授权）

用法

import { BankrClient } from "@bankr/sdk";

const client = new BankrClient({
  privateKey: process.env.BANKR_PRIVATE_KEY as `0x${string}`,
});

const result = await client.promptAndWait({
  prompt: "Swap 0.1 ETH to USDC on Base",
});

if (result.status === "completed" && result.transactions?.length) {
  const tx = result.transactions[0].metadata.transaction;
  await wallet.sendTransaction(tx);
}

支持的链

链	原生代币	默认
Base	ETH	是
Ethereum	ETH	否
Polygon	MATIC	否
Solana	SOL	否

相关技能

• sdk-capabilities：支持的操作完整列表
• sdk-transaction-builder：其他交易类型（转账、NFT）
• sdk-wallet-operations：客户端设置和配置