Bankr x402 SDK - Job Management

SDK 任务管理

管理异步任务：提交、轮询、检查状态、取消和批量操作。

SDK 方法

方法	描述	使用场景
promptAndWait()	提交并等待结果	大多数情况下推荐使用
prompt()	提交后立即返回	后台处理
pollJob()	轮询直到任务完成	手动跟踪任务
getJobStatus()	检查一次状态	自定义轮询逻辑
cancelJob()	取消待处理或正在处理的任务	停止不需要的任务

任务生命周期

pending → processing → completed
                    ↘ failed
                    ↘ cancelled

状态	可取消	描述
pending	是	等待处理
processing	是	正在处理
completed	否	已成功完成
failed	否	遇到错误
cancelled	否	已由用户取消

使用示例

推荐：promptAndWait

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

if (result.status === "completed") {
  console.log(result.response);
}

手动控制任务

// Submit without waiting
const { jobId } = await client.prompt({ prompt: "What are trending tokens?" });

// Check status later
const status = await client.getJobStatus(jobId);

// Or poll until complete
const result = await client.pollJob({ jobId, timeout: 60000 });

取消任务

const { jobId } = await client.prompt({ prompt: "..." });
await client.cancelJob(jobId);

批量处理

const prompts = ["Price of ETH", "Price of BTC", "Price of SOL"];

// Submit all in parallel
const jobs = await Promise.all(
  prompts.map(prompt => client.prompt({ prompt }))
);

// Wait for all to complete
const results = await Promise.all(
  jobs.map(job => client.pollJob({ jobId: job.jobId }))
);

时间指南

操作	典型耗时	推荐超时时间
价格查询	2-5s	15s
余额检查	2-5s	15s
代币兑换	5-15s	60s
跨链桥接	10-30s	120s
NFT 操作	5-15s	60s

相关技能

• sdk-wallet-operations：客户端设置和配置
• sdk-capabilities：支持的操作完整列表