JustHandled Agent Utility Gateway

JustHandled Agent 客户端

一个带防护机制的命令行工具、JavaScript 客户端和本地 MCP 服务，适用于 JustHandled Agent Utility Gateway。该软件包提供 32 项预检、维护数据查询和证据产品。22 项产品价格为 0.05 USDC；另外 10 项证据密集型或维护数据产品价格为 0.25 USDC，其中包括实时的 Chicago 合同变更数据包。每次付费调用都会返回一份带版本号的证据收据。

客户端会在签名前拒绝不符合条件的请求。它只接受固定的 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 文档和沙盒索引获取机器可读的产品信息、确切的支付条款和免费的确定性测试数据。

执行一项付费工具

请使用余额较低的专用 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 服务提供一个免费的目录工具，以及网关中每项工具对应的一个付费工具。缺少钱包配置时会报错，而不会尝试付款。

该软件包声明了官方 MCP Registry 身份 io.github.justhandledlabs/agent-gateway。Registry 身份仅用于发现：安装或列出该服务不会花费资金，执行付费操作仍需使用专用钱包，并通过客户端的确切条款检查。

安全模型

• 价格、链、资产、收款地址和网关来源均在代码中固定。
• 10 项价格为 0.25 USDC 的产品，其 250,000 个基础单位的价格单独固定，与 50,000 个基础单位的检查分开。
• 每次执行都会先进行未付款的 402 预览。
• 条款不匹配时，会在签名前中止。
• 软件包绝不会输出私钥。
• 网关不会持久化客户输入或完整的客户结果。维护数据产品可能会保留经过规范化的公开来源快照，并在收据中披露该状态。
• 所有加密货币转账都应视为不可逆，且仅向专用钱包充值。

开发

npm install
npm run check

此客户端仓库有意不包含网关实现。