JPYON Agent

⚡ 概要

JPYON Agent は、AIエージェントが JPYC（日本円ステーブルコイン） を使って API やサービスを自律的に購入できるインフラです。x402 プロトコルに対応し、エージェントはガスレスで決済できます。

🔍 サービスレジストリ（重要機能）

JPYON レジストリには企業が API を登録しています。エージェントは発見 → 比較 → 選択 → 決済を自律的に実行します。

サービス一覧・比較（CLI）

# 気象 API を検索
jpyon services list --capabilities weather

# 出力:
# 1. jpyon-weather-demo   0.1 JPYC/req  [weather, forecast]
# 2. weather-premium-api  0.5 JPYC/req  [weather, ai]
# 3. meteo-data-jp        1.0 JPYC/req  [weather, jp]

# 価格比較（安い順）
jpyon services compare weather

# 最安値を自動選択してフェッチ
jpyon fetch https://demo.jpyon.jp.ai/weather

SDK でのサービス利用

// 最安値の気象 API を自動選択して決済
const res = await agent.fetchCheapest(["weather", "forecast"]);

// または手動でレジストリを検索
const services = await agent.registry.compare({ capabilities: ["weather"] });
// → 価格の安い順に並んだサービス一覧

// 特定のサービスに直接フェッチ
const data = await agent.fetch("https://demo.jpyon.jp.ai/weather");

企業向け：API を登録する（CLI）

# 1. ウォレット初期化（初回のみ）
jpyon init

# 2. サービス登録 — 秘密鍵は ~/.jpyon/agent/ から自動読み込み
jpyon services register \
  --service-id my-api \
  --name "My Premium API" \
  --name-ja "プレミアム API" \
  --endpoint https://api.example.com/v1 \
  --capabilities data,analytics \
  --provider "My Company" \
  --amount 100000000000000000 \
  --display-amount "0.1 JPYC per request"

# 3. 更新・削除
jpyon services update my-api --name "Updated API Name"
jpyon services delete my-api

🔄 決済フロー

📦 インストール

npm install -g @jpyonchain/aiagent

jpyon init

jpyon fetch https://api.example.com/premium-data

⚙️ SDK（TypeScript / JavaScript）

npm install @jpyonchain/aiagent

基本的な使い方

import { createAgent } from "@jpyonchain/aiagent/agent";

// ワンライナーで初期化
const agent = await createAgent({
  relayUrl: "https://jpyon.jp.ai",
  policy: {
    maxPerRequestJpyc: "10",   // 1リクエスト最大 10 JPYC
    maxPerWindowJpyc: "100",   // 1時間最大 100 JPYC
  },
});

// x402 保護 API を自動決済でフェッチ
const res = await agent.fetch("https://api.example.com/premium-data");
const data = await res.json();

// 最安値のサービスを自動選択
const weather = await agent.fetchCheapest(["weather", "forecast"]);

// Plan・配分残高を確認
const plan = await agent.getMyPlan();
console.log(plan.gasless.remaining); // 残配分

// セッション終了
await agent.shutdown();

onBeforePayment フック（確認ダイアログ等）

const agent = await createAgent({
  relayUrl: "https://jpyon.jp.ai",
  onBeforePayment: async (ctx) => {
    console.log(`支払い: ${ctx.amount} JPYC → ${ctx.endpoint}`);
    return true; // false で支払いキャンセル
  },
  onPaymentSuccess: (entry) => {
    console.log(`決済成功: ${entry.txHash} (${entry.paymentMode})`);
  },
});

💻 CLI コマンド一覧

ウォレット管理

Plan 管理

決済

サービス発見

💳 Plan 制度

🔧 環境変数