@ agent- score/ pay (帮助)

AgentScore Pay;一个CLI用于整个生态系统的代理支付. 从一个单一的 shell 命令支付任何 x402/ MPP 商家, 本地横跨 x402 (韩语) (基准)和 组合 (Tempo,索拉纳),对铁路兼容客户有结构化提示,我们不直接资助(Stripe SPC通过 链接- cli,其他x402网络).

关闭要支付协议指定终点的 shell-tool LLM 代理的 UX 缺口( Claude Code, Cursor, ChatGPT with Bash) 。 每笔付款一个外壳命令:请求体通过402回行保存,代理商从未在电线上看到私钥. 由AgentScore建造并维护. 它与生态系统中的每402名商人合作,AgentScore配对与否. Pay不联系AgentScore API,除非商家402的挑战需要AgentScore身份.

安装

# Run directly (no global install required)
npx @agent-score/pay --help

# Or install globally
npm i -g @agent-score/pay
agentscore-pay --help

# Or via the install script (auto-detects npm vs native binary)
curl -fsSL https://raw.githubusercontent.com/agentscore/pay/main/install.sh | sh

# Or via Homebrew
brew install agentscore/tap/agentscore-pay

Npm 路径需要节点 22+. 原生的单文件二进制(不需要节点)被附着在每一个GitHub发行.

快开始

# 1. One-shot init, encrypted keystores on every chain, derived from a single BIP-39 mnemonic
agentscore-pay init

# 2. Fund one of them (prints receive QR + polls balance)
agentscore-pay fund --chain base --amount 10

# 3. Pay, rail auto-selected from the single funded wallet
agentscore-pay pay POST https://agents.example.com/purchase \
  -H 'Content-Type: application/json' \
  -d '{"product_id":"cabernet-sauvignon-2021","quantity":1,"email":"[email protected]","shipping":{...}}' \
  --max-spend 250

如果为多个钱包提供资金,请指定栏杆(或设置) preferred_chains 在配置中 :

agentscore-pay pay POST https://merchant.example/api --chain tempo -d '...' --max-spend 5

代理人(描述)

对于 LLM 工具启动代理, 运行 agentscore-pay agent-guide (编) --json 用于解析输出). 它印出结构化的路径:金色路径(init )-发现-平衡-检查-干-跑-薪),测试网路径,资金,辅助指令(init )limits, (中文(简体) ), whoami, (中文(简体) ), history),陷阱,和出站码分支. 同样的笔记也浮出水面 agentscore-pay <command> --help 页:1 check 财务报告和审定财务报表 pay。 。 。 .

输出格式

每个命令都发出结构化的数据. 选择格式 :

其他有用的全球旗帜 : --filter-output <keys> (发泄点-路径), --token-count 编号 : --token-limit n 编号 : --token-offset n (管理大产出), --full-output (全信封装有 meta.command 编号 : meta.duration) (中文(简体) ).

当stdout是一个TTY(人)时,输出会相当地被打印出. 管道/代理消耗时,自动得到结构化的信封.

错误和退出代码

出错 { code, message, retryable, extra?, next_steps? } 打开 静态 (频道与成功相同,代理分支在 code (原始内容存档于2017-03-25). exceptive.s. extra 带有特定错误的结构上下文(例如:. valid_keys, (中文(简体) ), chain, (中文(简体) ), held_chains, (中文(简体) ), balance_usdc, (中文(简体) ), verify_url编号 :session_id编号 :poll_secret (一) 身份流动; next_steps 携带一个 action 键 + 可选 suggestion 用于确定性恢复的字符串。 过 --full-output 给包裹的信封 { ok: false, error: {...}, meta: { command, duration } }。退出代码稳定 :

# Scripted, non-interactive
export AGENTSCORE_PAY_PASSPHRASE=<passphrase>

# Probe without paying
agentscore-pay check https://merchant.example/api --json

# Dry-run a payment (print the plan, don't sign)
agentscore-pay pay POST https://merchant.example/api \
  -d '{"x":1}' --max-spend 5 --dry-run --json

# Real pay
agentscore-pay pay POST https://merchant.example/api \
  -d '{"x":1}' --max-spend 5 --json

MCP 服务器( 一个二进制, 每个工具)

每个命令(钱包,支付,身份)作为MCP工具被曝光:

agentscore-pay --mcp                  # start as a stdio JSON-RPC MCP server
agentscore-pay mcp add                # register with Claude Code / Cursor / Amp
agentscore-pay --llms                 # markdown manifest of every command
agentscore-pay --llms --format json   # JSON Schema manifest
agentscore-pay <cmd> --schema         # JSON Schema for one command's args/options/output

agentscore-pay skills add 财务报告和审定财务报表 agentscore-pay completions 注册技能文件和 shell 补全.

关于重试的缺席

每个 agentscore-pay pay 引用生成一个稳定 X-Idempotency-Key sHA-256散列 (url + method + body + signer),所以在一次引用中重复重复重用相同的键。 如果一笔付款解决了 但网络反应在中途失效 尊重Frede-pattern dedup的商人不会加倍收费 自己传 -H 'X-Idempotency-Key: <value>' 以覆盖( 用于跨进程等强性: 同一逻辑购买跨多个) agentscore-pay pay (援引).

测试模式地址

7个EVM地址(0x0000…0001 结束 0x0000…0007作为确定性的测试固定装置(KYC经核实,制裁明确,年龄门经过), dev/test商家不会燃烧真正的KYC信用. agentscore-pay 自动识别它们。 要在您的 dev/测试固定装置中使用识别器,导入 isAgentScoreTestAddress(addr) 财务报告和审定财务报表 AGENTSCORE_TEST_ADDRESSES 从 @agent-score/sdk (峡谷之家; agentscore-pay 重新使用同样的列表).

十进制处理

符合光谱要求的402份答复 decimals 在铁路要求。 当商人省略时,报酬实行严格的政策来避免默不作声地乱收费:

• 资产为Canonic USDC (与薪酬中标注的每链圆形USDC登记册相匹配):默默使用6个小数.
• 资产是其他一切: 终止 merchant_spec_violation. 猜测小数点后,可能会以非-小数点精确度对代币计价错误,所以工资拒绝支付而不是继续部分信息.

从代理人处使用:完整的食谱

一个典型的自主剂流:探究端点,决定是否支付,支付,分出结构化的结果.

巴什( Claude Code / Cursor / sell-tool) : (简体中文)

#!/usr/bin/env bash
set -eu
URL="https://agents.example.com/purchase"
BODY='{"product_id":"cab-2021","quantity":1,"email":"[email protected]","shipping":{...}}'
MAX_SPEND=250

# 1. Probe, what does this endpoint cost and which rails does it accept?
PROBE=$(agentscore-pay check "$URL" -X POST -d "$BODY" --json)
PRICE=$(printf '%s' "$PROBE" | jq -r '.rails[0].price_usd // empty')
echo "Endpoint asks for \$${PRICE} USDC"

# 2. Pay, capture stdout (success body) and exit code separately.
RESPONSE=$(agentscore-pay pay POST "$URL" \
  -H 'Content-Type: application/json' \
  -d "$BODY" \
  --max-spend "$MAX_SPEND" \
  --timeout 120 \
  --retries 2 \
  --json) || EXIT=$?
EXIT=${EXIT:-0}

# 3. Branch on the standard exit codes.
case "$EXIT" in
  0) echo "Paid. tx=$(printf '%s' "$RESPONSE" | jq -r '.tx_hash // .body.tx_hash // "?"')" ;;
  2) echo "Network/RPC error, retry later." >&2; exit 2 ;;
  3) echo "Insufficient funds, top up:"; agentscore-pay fund-estimate "$URL" -X POST -d "$BODY"; exit 3 ;;
  4) echo "Rejected (price exceeded --max-spend or local limit)." >&2; exit 4 ;;
  5) echo "Multi-rail ambiguity, set --chain or config preferred_chains." >&2; exit 5 ;;
  *) echo "User error: $RESPONSE" >&2; exit 1 ;;
esac

Python : (中文(简体) )

import json, subprocess, sys

def pay(url: str, body: dict, max_spend_usd: float) -> dict:
    proc = subprocess.run(
        ["agentscore-pay", "pay", "POST", url,
         "-H", "Content-Type: application/json",
         "-d", json.dumps(body),
         "--max-spend", str(max_spend_usd),
         "--timeout", "120", "--retries", "2", "--json"],
        capture_output=True, text=True,
    )
    if proc.returncode == 0:
        return json.loads(proc.stdout)
    err = json.loads(proc.stdout)
    raise RuntimeError(f"pay failed (exit {proc.returncode}): {err['code']}, {err['message']}")

result = pay("https://agents.example.com/purchase",
             {"product_id": "cab-2021", "quantity": 1, "email": "[email protected]", "shipping": {}}, 250)
print(result["tx_hash"], result["body"])

类型脚本/ 节点 :

import { execFile } from 'node:child_process';
import { promisify } from 'node:util';
const exec = promisify(execFile);

async function pay(url: string, body: unknown, maxSpendUsd: number) {
  try {
    const { stdout } = await exec('agentscore-pay', [
      'pay', 'POST', url,
      '-H', 'Content-Type: application/json',
      '-d', JSON.stringify(body),
      '--max-spend', String(maxSpendUsd),
      '--timeout', '120', '--retries', '2', '--json',
    ]);
    return JSON.parse(stdout);
  } catch (err: any) {
    // execFile rejects on non-zero exit; the error envelope JSON is in err.stdout.
    const envelope = err.stdout ? JSON.parse(err.stdout) : { code: 'unknown', message: err.message };
    throw new Error(`agentscore-pay exit ${err.code}: ${envelope.code}, ${envelope.message}`);
  }
}

CLI从不为人类的发热发作 --json 被通过: Stdout 上的每个字节都是可解析的 JSON,成功和出错都一样. 施特勒只用于人类的铬(banner, 腐烂警告, -v 铁路选取日志,软过期警告.

铁路

索拉纳支付途径 solana/charge (索拉纳基金会) @solana/mpp 而不是x402软件包。 Tempo总是通过 MPP mppx/client. Base是唯一的x402铁路直接支付基金.

铁路选择

CLI号舰只 没有默认铁路优惠。算法:

1. --chain X ——使用X(如不在场或不足则有误).
2. 磁盘上有一个钱包是给目标资助的 – 使用它.
3. 多个供资钱包 – 检查 ~/.agentscore/config.json preferred_chains 做为破领带.
4. 仍为多 + 错误 code: "multi_rail_candidates" 并列出选项.
5. 无候选人 —— 错误 code: "no_funded_rail" 并指向 fund。 。 。 .

配置示例( E)~/.agentscore/config.json:

{
  "preferred_chains": ["tempo", "base"]
}

或者通过CLI:

agentscore-pay config set preferred_chains tempo,base
agentscore-pay config get
agentscore-pay config unset preferred_chains

Verbose 模式 (-v记录铁路选择+余额为stderr.

图标

下面的每一行都有一个子命令: agentscore-pay,引用为 agentscore-pay <command> (例如:. agentscore-pay init, (中文(简体) ), agentscore-pay pay POST <url>) (中文(简体) ).

身份命令

passport login编号 :status编号 :logout 使用 AgentScore 的购买方身份流并需要 无 API 密钥。下面的其他身份命令(assess, (中文(简体) ), sessions, (中文(简体) ), credentials, (中文(简体) ), associate-wallet包装代理Score SDK,设定 AGENTSCORE_API_KEY。 。 。 .

AgentScore Passports是免费的买家,永远。 Agent Score Monetys 卖家/商家,买家和代理-买家从不支付我们.

身份错误代码

assess, (中文(简体) ), sessions, (中文(简体) ), credentials,以及 associate-wallet 以结构化 CliErrors 格式显示 SDK 的打出错误。 JSON的信封里的东西 code 区分恢复路径 :

这个 pay <url> 命令在代理时额外扔出两个非 TTY 代码(--json / MCP / 脚本) 点击了 Passport 需要的状态, 而不是在内线浏览器- 直接流上屏蔽一个小时, 支付一个结构化的信封, 这样代理可以向 passport login数字 :

两种代码只向非TTY跑道开火. 在人类终端薪酬中,继续驱动内线浏览器-定向流量本身.

配额的可观察性

assess (以及当账户有每期配额时,其他身份命令) 发布响应 X-Quota-Limit 编号 : X-Quota-Used 编号 : X-Quota-Reset 作为标题 quota: { limit, used, reset } 屏蔽成功信封。 监控人员对接方式应警告80%,警戒95%.

agentscore-pay assess --address 0xabc... --json | jq '.quota'
# → { "limit": 1000, "used": 780, "reset": "2026-06-01" }

quota 账户中不存在没有定期配额的情况.

基于磁体的钱包

# Generate a BIP-39 seed and derive all three chains at once
agentscore-pay wallet create --mnemonic

# Later, on another machine: import the phrase
agentscore-pay wallet import --mnemonic "legal winner thank year wave sausage worth useful legal winner thank yellow"

# Retrieve the stored phrase (prompted for passphrase + type-to-confirm)
agentscore-pay wallet show-mnemonic --danger

衍生路径: EVM 用途 m/44'/60'/0'/0/0 (标准),索拉纳使用 m/44'/501'/0'/0' (SLIP-10 Ed25519) (中文(简体) ). 同一短语在每台机器上重生出相同的密钥.

为什么有两个衍生算法?

EVM和索拉纳的使用 不同的曲线: EVM使用secp256k1(BIP-32硬化+非硬化路径),索拉纳使用Ed25519(只支持硬化衍生). 这些标准也相应不同:

• EVM (BIP-44, secp256k1) (中文(简体) ), (中文(简体) ), m/44'/60'/0'/0/0。跟踪 /0/0 没有硬化。 MetaMask, Rabby, 和 Coinbase 钱包 都使用此路径; 在其中任意一个词组中导入一个词组产生您在其中看到的相同的地址 wallet address --chain base。 。 。 .
• 索拉纳(SLIP-10, Ed25519), (中文(简体) ), m/44'/501'/0'/0'。所有四个级别都加硬度(注意后缀) '). Phantom和Solflare使用此路径进行“ 账号 0 ” ; 导入相同的短语会生成您看到的地址 wallet address --chain solana。 。 。 .

如果您将短语导入到 Phantom 并看到不同的地址, 请检查 Phantom 是否设定为“ 标准导出路径 ” (而不是遗留地址) m/44'/501'/0') (中文(简体) ).

多个钱包配置

双层多钱包支持:

每条链命名的钱包( 在位)

每个链可以持有多个键盘. 默认名称是 default; 通过 --name <name> 对其他人:

agentscore-pay wallet create --chain base --name trading
agentscore-pay wallet list                          # enumerate per chain
agentscore-pay balance --chain base --name trading
agentscore-pay pay POST <url> --chain base --name trading -d '...' --max-spend 5

名称仅限于 [a-z0-9-] (最大32个字符). 货币衍生钱包总是存放在 default,对于额外的命名钱包,使用随机键(wallet create)或导入(wallet import) (中文(简体) ).

端到端: 单独的交易 + 默认钱包

# Default wallet for general spending
agentscore-pay init                                 # creates base/solana/tempo "default"
agentscore-pay fund --chain base --amount 10        # tops up default

# Separate "trading" wallet for a high-budget bot
agentscore-pay wallet create --chain base --name trading
agentscore-pay wallet address --chain base --name trading
# → 0xTRADINGADDRESS, fund this address externally (CEX withdrawal, transfer, etc.)
agentscore-pay balance --chain base --name trading

# Inspect everything
agentscore-pay wallet list
# base     default
# base     trading

# Pay from each
agentscore-pay pay POST https://merchant.example/api -d '{}' --chain base                    # uses default
agentscore-pay pay POST https://merchant.example/api -d '{}' --chain base --name trading   # uses trading

# Remove a wallet (irrecoverable, back up the mnemonic or export the key first)
agentscore-pay wallet export --chain base --name trading --danger --skip-confirm > trading.key
agentscore-pay wallet remove --chain base --name trading --danger --skip-confirm

人马座限制今天不支持(限制是全球性的). 单独使用 AGENTSCORE_PAY_HOME 如果您需要每页的每日封顶, 则需要配置 .

单独状态目录

设定 AGENTSCORE_PAY_HOME 要完全隔离( 不同) history.jsonl, (中文(简体) ), limits.json, (中文(简体) ), config.json:

# One profile for production merchants
AGENTSCORE_PAY_HOME=~/.agentscore-prod agentscore-pay wallet create

# Another profile for testnet development
AGENTSCORE_PAY_HOME=~/.agentscore-test agentscore-pay wallet create
AGENTSCORE_PAY_HOME=~/.agentscore-test agentscore-pay pay --network testnet ...

解锁密钥

满足密码句的两种方式,按顺序排列:

Env var 获胜 设定时:它不产生上盘文物,并且是每个代理上下文(CI秘密,容器内涵,K8s秘密,Lambda config,MCP主机 config)的正确原始. 磁盘上没有密码句缓存 : 它会在解锁的键盘旁以清晰的文字保存密码句 .

对于代理作者(原始内容存档于2017-09-21). : preference env var. 在代理启动时从你的秘密商店读取;不要把它烤入代理的即时或记忆. 报酬 agent-guide 命令 (agentscore-pay agent-guide)解释其自身结构化产出中的优先.

供资

钱包只持有USDC,不需要ETH或SOL. x402 (EIP-3009) 和 MPP Tempo对签名者来说都是无气的;主持人付费.

主要网

• 所有链条, (中文(简体) ), agentscore-pay fund --chain <chain> --amount 10 打印一个 ASCII QR 和您的钱包地址,然后进行民调平衡直到存款地。 从任何来源发送USDC:另一个钱包(MetaMask, Rabby, Coinbase Wallet, Phantom),一个CEX退出,或者任何支持目的地链的第三方fiat onramp(Coinbase Pay, MoonPay, Transak, Onramper, Frede Crypto Onramp等). 默认金额是 $10 (~50-200个典型代理呼叫).
• 时间细节,大多数fiat-onranp的合作伙伴还没有覆盖Tempo(链4217). 通过从另一个Tempo钱包转出USDCe或从基地转出桥梁(LayerZero / Squid / Relay)供资.
• 没收到, (中文(简体) ), agentscore-pay wallet address --chain base 仅打印地址,如果您已经知道您的资金来源.

测试网

使用 fund --chain tempo --network testnet 在CI/代理设置脚本中,它是唯一一个没有人类交互作用的操作. Base Sepolia和Solana Devnet 仍然需要把你的地址贴入Circle的网络表格.

脚本/部署的特工

• 预付你笔记本电脑上的钱包 wallet export --chain base --danger --skip-confirm 拿到钥匙.
• 在服务器上, AGENTSCORE_PAY_PASSPHRASE=<pass> agentscore-pay wallet import --chain base 0x<hex> 或发送加密 ~/.agentscore/wallets/base.json 直接说.
• AGENTSCORE_PAY_HOME=/opt/agentscore 在服务器内将状态与机器上的任何其他用户隔离.
• agentscore-pay limits set --daily 50 --per-call 1 限制自主代理的支出.

为特定商人编制预算

# Before making a purchase, check what you can afford
agentscore-pay fund-estimate https://agents.example.com/purchase \
  -X POST -d '{"product_id":"cab-2021","quantity":1,...}'
# → shows price, your balance, calls affordable, and suggested top-up

警卫

• Keystore是AES-256-GCM加密的,带有一个由srypt衍生的密钥,每个链条一个文件.
• 所写文件 0600 属性, 父目录 0700。 。 。 .
• 每个签名操作都提示密码句; 覆盖到 AGENTSCORE_PAY_PASSPHRASE env var 用于非互动剂.
• wallet export 被守护着 --danger +"类型 EXPORT" 提示.
• 当地支出限额limits set --daily N --per-call N --per-merchant N在签署时通过x402和MPP钩执行.
• ~/.agentscore/history.jsonl 记录成功的支付(url、主机、链条、协议、状态、时间戳)。 没有秘密记录.
• 没有遥测。 没有自动更新。 磁盘上没有纯文本密钥 .

密码句强度

对于 交互式人类:任何8+Char的密码句你都会记得是好的,scrypt-256-GCM组合在典型的人类-口语 en平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平.

对于 自动代理: 密码句通常生活在 AGENTSCORE_PAY_PASSPHRASE (env var),它是任何拥有 shell 访问权限的用户都可以读取的,所以密码句其实不是一个单独的信任边界,它主要是保护键盘不受 仅盗取上盘文件。一个长而随机的密码句使文件在被过滤后无用:

# generate a 32-byte (256-bit) random passphrase
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
# 4d2a...

# stash it where your agent can read it (env / secret manager / .env / etc.)
export AGENTSCORE_PAY_PASSPHRASE=4d2a...

如果钱包键盘 财务报告和审定财务报表 密码句商店都失密了 钱包失密了 没有额外的保护 保护目录.

正在验证发行二进制( sigstore / 联合签名)

每一个附件的原生二进制 GitHub 发布 与 斯格斯托尔/签名 无密钥 OIDC. 要验证一个已下载的二进制( 需要共同签名 v2.4+ 或共同签名 v3) :

cosign verify-blob \
  --bundle agentscore-pay-darwin-arm64.bundle \
  --certificate-identity-regexp 'https://github.com/agentscore/.+' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  agentscore-pay-darwin-arm64

成功的核查Verified OK)确认二进制是按下列工作流程构建的: agentscore GitHub org 对已公布来源, 不篡改后构建 。 这个 .bundle 文件被上传到发布中每个二进制的旁边.

Npm 软件包本身以 npm 来源 (还有斜坡背后), npm install @agent-score/pay 自动继承同一信任链.

环境

与其他代理计分包的关系

@agent-score/pay 是通用代理支付CLI;它与任何x402/MPP商家合作,无论他们是否使用AgentScore作为身份. 以下包是 AgentScore 的可选身份 + 集成层,供选择使用:

• @agent-score/sdk, AgentScore API 的脚本客户端
• @agent-score/commerce,商边 SDK: 建立信任的中间软件(/identity/{hono,express,fastify,nextjs,web}+ 402 / 支付/ 发现/ 条纹- 多链帮助器
• @agent-score/pay (本套件),代理-侧 CLI:钱包+跨越x402/MPP铁道的支付+身份命令(资产,会话,证书,协理-wallet). 作为 MCP 服务器的双倍 --mcp。 。 。 .

当商人使用 @agent-score/commerce,钱包对操作器连接时,商家会通过 captureWallet,工资不重复 POST /v1/credentials/wallets 电话 对于非AgentScore商家来说,这是不开放的;除非商家的402个挑战需要AgentScore身份,否则工资不会与AgentScore API联系.

许可证

麻省理工学院