Bankr x402 SDK - Wallet Operations

SDK 钱包操作

初始化并配置 BankrClient，正确设置钱包。

双钱包系统

钱包	用途	必需
支付（privateKey）	为 x402 微支付签名（$0.01/次请求）	是
上下文（walletAddress）	接收兑换后的代币、NFT	否（默认使用支付钱包）

基本设置

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

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

const result = await client.promptAndWait({
  prompt: "What are my balances?",
});

分开使用钱包（推荐）

为增强安全性，支付和接收使用不同的钱包：

const client = new BankrClient({
  // Hot wallet with minimal USDC for payments
  privateKey: process.env.PAYMENT_WALLET_PK as `0x${string}`,
  // Cold/trading wallet receives tokens
  walletAddress: process.env.RECEIVING_WALLET,
});

配置选项

选项	类型	必需	描述
privateKey	0x${string}	是	支付钱包私钥
walletAddress	string	否	覆盖接收钱包
baseUrl	string	否	API 端点（默认为生产环境）
timeout	number	否	请求超时时间（毫秒，默认为 600000）

SDK 方法

方法	描述
promptAndWait()	提交提示词并等待结果
prompt()	提交提示词并立即返回
pollJob()	轮询，直到任务完成
getJobStatus()	检查一次任务状态
cancelJob()	取消待处理或正在处理的任务
getWalletAddress()	获取上下文钱包地址

单次请求覆盖

// Override wallet for a single request
const result = await client.promptAndWait({
  prompt: "Swap 0.1 ETH to USDC",
  walletAddress: "0xDifferentWallet...",
});

环境设置

# Required
BANKR_PRIVATE_KEY=0x...your_payment_wallet_key...

# Optional
BANKR_WALLET_ADDRESS=0x...your_receiving_wallet...

安全最佳实践

1. 切勿提交私钥——使用环境变量
2. 尽量减少支付钱包余额——仅保留 $1-2 USDC
3. 使用独立钱包——支付（热钱包）与接收（冷钱包）
4. 定期轮换密钥——支付钱包遭到泄露时

相关技能

• sdk-capabilities：支持的操作完整列表
• sdk-job-management：异步任务处理与轮询