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：サポートされている操作の全一覧