用途
Bankr x402 SDK 是一套面向区块链操作的开发工具包,允许开发者通过自然语言提示(prompt)驱动链上操作。SDK 接收自然语言输入,返回可供执行的交易数据,由调用方钱包完成实际交易发送。
主要能力
SDK 支持的操作按类别划分如下:
兑换(Swaps)
- 代币兑换:如 "Swap 0.1 ETH to USDC"
- 按金额买入:如 "Buy $100 of DEGEN"
- 按比例兑换:如 "Swap 50% of my ETH to USDC"
转账(Transfers)
- ERC20 转账:如 "Send 100 USDC to 0x..."
- ETH 转账:如 "Send 0.1 ETH to @username"
- NFT 转账:如 "Send my Bored Ape #123 to 0x..."
包装(Wrapping)
- 包装 ETH:如 "Wrap 1 ETH"
- 解包 WETH:如 "Unwrap 1 WETH"
跨链(Cross-Chain)
- 跨链桥(仅限 EVM):如 "Bridge 100 USDC from Ethereum to Base"
杠杆(Leverage)
- 做多:如 "Buy $50 of ETH/USD with 5x leverage"
- 做空:如 "Short $10 of GOLD"
- 平仓:如 "Close all my BTC/USD positions"
NFT
- 购买 NFT:如 "Buy the cheapest Tiny Dino NFT"
- 挂单出售:如 "List my Bored Ape for 10 ETH"
- Manifold 铸造:如 "Mint from Manifold at 0x..."
- SeaDrop 铸造:如 "Mint from SeaDrop at 0x..."
质押(Staking)
- 质押 BNKR:如 "Stake 1000 BNKR"
- 解除质押:如 "Unstake my BNKR"
查询(Queries)
- 余额查询:如 "What are my balances?"
- NFT 持有查询:如 "What NFTs do I own?"
- 代币价格:如 "Price of ETH"
- 代币分析:如 "Analyze DEGEN"
使用方式
通过 npm 包 @bankr/sdk 引入 BankrClient,使用私钥初始化客户端,然后调用 promptAndWait 方法传入自然语言提示。返回结果中若 status 为 completed 且包含 transactions,即可用钱包发送返回的交易数据。示例代码:
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) {
// Execute the returned transaction with your wallet
await wallet.sendTransaction(result.transactions[0].metadata.transaction);
}
支持的链
| 链 | 原生代币 | 是否默认 |
|---|---|---|
| Base | ETH | 是 |
| Ethereum | ETH | 否 |
| Polygon | MATIC | 否 |
费用
每次请求通过 x402 微支付收取 0.01 USDC。交易的 Gas 费需另行支付。
不支持的功能
| 功能 | 替代方案 |
|---|---|
| Polymarket 下注 | 直接使用 https://bankr.bot |
| 限价单 | 使用 https://swap.bankr.bot |
| DCA/TWAP 订单 | 使用 https://swap.bankr.bot |
| Solana 跨链 | 仅支持 EVM 链 |
| Bankr Earn | 使用 Bankr 终端 |
相关技能
- sdk-token-swaps:代币兑换模式与授权处理
- sdk-transaction-builder:构建转账、NFT 操作、跨链桥
- sdk-balance-queries:投资组合与余额查询
限制
跨链桥仅支持 EVM 链,不支持 Solana 跨链。Polymarket 下注、限价单、DCA/TWAP 订单及 Bankr Earn 均不在 SDK 支持范围内,需使用对应的替代方案。