kx402

kx402 — Kaspa x402 エージェントの支払い機能

Kaspa L1 上で決済される x402 サービス向けの、エージェント中心の支払い機能です。1つのパッケージで、実績ある同一の支払いコアを使う3つのインターフェースを提供します。

• SDK — import { openWallet, payExact } from "kx402" を使い、独自のコードから x402 のオファーに支払えます。
• CLI — 人間やスクリプト向けの kx402 offer|pay|balance|addr。
• MCP サーバー — kx402-mcp をエージェント（Claude など）に追加すると、ツールとして Kaspa x402 サービスに支払えるようになります。

@kaspa-x402 バインディングを使い、x402 v2 exact / standard-native フローを実行します。標準のワイヤーフォーマットに準拠しており、拡張はしていません。Kaspa·402 マーケットプレイスの需要側です。

⚠️ アルファ版であり、pay は実際の資金を使用します。まず testnet-10 をお使いください。資金調達用の鍵は 0600 のファイルに保管し、git には絶対に含めないでください。

解決する課題

インターネットの決済インフラは、購入者が 人間 であることを前提としています。アカウントを作成し、API キーを取得し、カードを登録して、「承認」をクリックします。AI エージェントにはこうした操作ができませんし、クレジットカードを渡したいとも思わないでしょう。そのため、エージェントは推論して行動できても、タスクで有料ツール（データ、コンピューティング、モデル、API）が必要になると、まず人間が課金設定をしなければなりません。

kx402 はこのギャップを埋めます。エージェントが実際に操作できるウォレットを提供し、エージェント自身が利用ごとに支払えるようにします。

• アカウントも API キーも登録も不要です。 エージェントは呼び出しごとの正確な金額をその場で支払います。サービスとの事前の関係は必要ありません。
• カードでは実現できないマイクロペイメントに対応します。 クレジットカードには約30セントの最低額があります。Kaspa 上で KAS を使って決済することで、呼び出しごとの1セント未満の支払いを実用的に行えます。
• 人間の操作ではなくソフトウェア向けに設計されたウォレットです。 人間が介入せずに、プログラムから約1秒で支払いを作成、署名、送信し、支払いを証明します。
• 暴走を防ぐガードレールを備えています。 支払いは常にオファーの価格以下で、そのサービスにのみ支払われ、設定した上限も守られます。使いすぎや誤った相手への支払いのリスクを抑えながら、自律性を実現します。

厳格なルールが組み込まれたプリペイドカードのようなものだと考えてください。エージェントは必要なものを、必要なときに少額ずつ購入できますが、上限を超えて使ったり、見知らぬ相手に支払ったりすることはできません。

インストール

npm install -g kx402      # or: npm install kx402  (for SDK use)
npm run fetch-sdk         # downloads the rusty-kaspa v2.0.0 WASM SDK into ./vendor

Kaspa で署名するには、公式 rusty-kaspa v2.0.0 nodejs WASM SDK が必要です。npm の kaspa-wasm は別の古い ABI を使っており、"memory access out of bounds" エラーが発生します。npm run fetch-sdk で適切な SDK を取得し、表示された kaspa.js のパスを KASPA_X402_KASPA_WASM_MODULE に指定してください。

設定

.env.example を .env にコピーして値を設定します（または、これらの値をフラグ／環境変数として渡します）。

変数	説明
KASPA_X402_KASPA_WASM_MODULE	v2.0.0 nodejs WASM SDK の kaspa.js へのパス
KASPA_X402_FUNDING_WALLET	wallet-key:/path/to/wallet.key または64桁の16進数の生鍵
KASPA_X402_NETWORK	kaspa:mainnet または kaspa:testnet-10（デフォルト）
KASPA_X402_RPC_URL	任意。未設定の場合、パブリック PNN ノードが自動的に解決されます

CLI

kx402 addr    --config-file .env                 # show the wallet address (fund it first)
kx402 balance --config-file .env                 # spendable KAS
kx402 offer  https://host/exact --config-file .env   # inspect a 402 offer (no payment)
kx402 pay    https://host/exact --prompt "hi" --config-file .env   # pay and print the result

入力は exact GET のクエリで渡します。リソースの要件に応じて --text／--prompt／--model／--input を使用してください。安全性フラグ：--max <sompi> は支出額の上限を設定し、--dry はブロードキャストせずに署名済み tx を作成します。

SDK

import { openWallet, payExact, resolveWalletConfig } from "kx402";

const wallet = await openWallet(resolveWalletConfig());   // reads env / .env
const r = await payExact(wallet, "https://host/exact?prompt=hello");
console.log(r.status, r.body, r.settlement);
await wallet.close();

すべての支払いは、オファー自体から導出される fundingPolicy によって制限されます。オファーの payTo に対して、その profile で、指定した上限までしか支払いません。

MCP サーバー

kx402 mcp（または kx402-mcp バイナリ）を実行すると、kaspa_x402_address、kaspa_x402_balance、kaspa_x402_offer、kaspa_x402_pay を公開する stdio サーバーが起動します。kaspa_x402_pay は実際の資金を使用しますが、max_sompi によって上限が設定されます。クライアント設定の例：

{
  "mcpServers": {
    "kx402": {
      "command": "npx",
      "args": ["-y", "kx402", "mcp"],
      "env": {
        "KASPA_X402_KASPA_WASM_MODULE": "/abs/path/vendor/kaspa-wasm32-sdk/nodejs/kaspa/kaspa.js",
        "KASPA_X402_FUNDING_WALLET": "wallet-key:/abs/path/wallet.key",
        "KASPA_X402_NETWORK": "kaspa:testnet-10"
      }
    }
  }
}

決済の仕組み

メインネットでは、kx402 は非ホステッド決済を使用します。署名済み tx を自らブロードキャストし、ゲートウェイが検証に使うのと同じ REST インデクサーで承認されるのを待ってから、PAYMENT-SIGNATURE を提示します。これにより、ゲートウェイは承認済み tx を確認することで決済し、自らブロードキャストする必要がありません。すべて標準的な x402 v2 のライフサイクル内で行われます。

関連項目

• @kaspa-x402 — このプロジェクトの基盤となる Kaspa x402 バインディングです。
• kaspa-402.org — Kaspa 上の x402 対応サービスのマーケットプレイスです。

ライセンス

MIT