Bankr x402 SDK - Wallet Operations

SDK ウォレット操作

適切なウォレットを設定して BankrClient を初期化・構成します。

2 ウォレットシステム

ウォレット	用途	必須
支払い（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. 支払い用ウォレットの残高を最小限にします - USDC は $1～2 のみを保管します
3. 別々のウォレットを使用します - 支払い用（ホット）と受け取り用（コールド）
4. 定期的に鍵をローテーションします - 支払い用ウォレットが侵害された場合

関連スキル

• sdk-capabilities：サポートされている操作の全リスト
• sdk-job-management：非同期ジョブの処理とポーリング