JustHandled Agent Utility Gateway

JustHandled Agent Client

JustHandled Agent Utility Gateway 用の安全対策を備えた CLI、JavaScript クライアント、およびローカル MCP サーバーです。このパッケージは、32 種類の事前チェック、維持管理されたデータの検索、およびエビデンス製品を提供します。22 種類の製品は 0.05 USDC、ライブの Chicago Contract Change Packet を含む、エビデンスを多く含む、または維持管理されたデータを使用する 10 種類の製品は 0.25 USDC です。有料の呼び出しごとに、バージョン管理されたエビデンスレシートが返されます。

クライアントは署名を行う前に、条件を満たさない場合は処理を拒否します。固定された JustHandled ゲートウェイ、Base メインネット、正規の Base USDC、製品ごとの正確な価格、および公開済みの加盟店受取先のみを受け付けます。顧客の入力と完全な顧客の結果はゲートウェイに保存されません。維持管理された公開ソースのスナップショットはレシートに表示されます。

ウォレットなしで確認する

npx --package @justhandledlabs/agent-client justhandled-agent catalog
npx --package @justhandledlabs/agent-client justhandled-agent preview filename-portability-preflight --json '{"paths":["CON.txt"]}'
npx --package @justhandledlabs/agent-client justhandled-agent preview agent-run-evidence-pack --file agent-run-evidence-pack.sample.json
npx --package @justhandledlabs/agent-client justhandled-agent preview agent-distribution-readiness-pack --file agent-distribution-readiness-pack.sample.json
npx --package @justhandledlabs/agent-client justhandled-agent preview community-rule-credibility-preflight --file community-rule-credibility-preflight.sample.json
npx --package @justhandledlabs/agent-client justhandled-agent preview qualified-demand-ledger --file qualified-demand-ledger.sample.json
npx --package @justhandledlabs/agent-client justhandled-agent preview channel-fit-evidence-matrix --file channel-fit-evidence-matrix.sample.json
npx --package @justhandledlabs/agent-client justhandled-agent preview proof-to-channel-evidence-packet --file proof-to-channel-evidence-packet.sample.json
npx --package @justhandledlabs/agent-client justhandled-agent preview channel-experiment-postmortem --file channel-experiment-postmortem.sample.json
npx --package @justhandledlabs/agent-client justhandled-agent preview chicago-contract-change-packet --file chicago-contract-change-packet.sample.json

プレビューでは、無償リクエストを実行し、返された x402 の条件を検証します。署名や支払いは行いません。

カタログには、API レスポンスの契約変更、Webhook の契約とリプレイ、ポリシー変更のエビデンス製品が含まれます。パッケージに含まれる入力例は examples/ で利用できます。

機械可読な製品情報、正確な支払い条件、および無料の決定論的フィクスチャは、ゲートウェイの製品カタログ、OpenAPI ドキュメント、およびサンドボックスのインデックスから利用できます。

有料ユーティリティを 1 つ実行する

残高の少ない専用の Base ウォレットを使用してください。メインのウォレットキーは絶対に入力しないでください。

export JH_EVM_PRIVATE_KEY=0x...
npx --package @justhandledlabs/agent-client justhandled-agent call filename-portability-preflight --json '{"paths":["CON.txt"]}'

PowerShell：

$env:JH_EVM_PRIVATE_KEY = "0x..."
npx.cmd --package @justhandledlabs/agent-client justhandled-agent call filename-portability-preflight --json '{"paths":["CON.txt"]}'

MCP の設定

{
  "mcpServers": {
    "justhandled": {
      "command": "npx",
      "args": ["-y", "@justhandledlabs/agent-client"],
      "env": {
        "JH_EVM_PRIVATE_KEY": "0xDEDICATED_LOW_BALANCE_WALLET_KEY"
      }
    }
  }
}

MCP サーバーは、無料のカタログツールと、ゲートウェイのユーティリティごとに 1 つの有料ツールを公開します。ウォレット設定がない場合は、支払いを試みるのではなく、エラーを返します。

このパッケージは、公式 MCP Registry ID io.github.justhandledlabs/agent-gateway を宣言しています。Registry ID は検出用のメタデータにすぎません。サーバーをインストールしたり一覧表示したりしても資金は使われず、有料の実行には引き続き専用ウォレットと、クライアントによる正確な条件の確認が必要です。

セキュリティモデル

• 価格、チェーン、アセット、受取先、およびゲートウェイのオリジンはコード内で固定されています。
• 0.25 ドルの製品 10 種類の 250,000 基本単位の価格は、50,000 基本単位の確認とは別に固定されています。
• すべての実行は、無償の 402 プレビューから開始します。
• 条件が一致しない場合は、署名の前に処理を中止します。
• パッケージが秘密鍵を出力することはありません。
• ゲートウェイは顧客の入力や完全な顧客の結果を保存しません。維持管理されたデータを使用する製品では、正規化された公開ソースのスナップショットを保持し、その状態をレシートに開示する場合があります。
• すべての暗号資産の送金は取り消し不能として扱い、専用ウォレットにのみ資金を入れてください。

開発

npm install
npm run check

ゲートウェイの実装は、このクライアントのリポジトリには意図的に含めていません。