Tempo Wallet 是 tempoxyz/plugins 提供的一项技能,其安装页面位于 https://www.skills.sh/tempoxyz/plugins/wallet。根据资料,它的核心定位是:当用户希望调用 API、发起 HTTP 请求、发现可用服务或访问外部数据,并需要自动处理支付时,使用 tempo CLI 完成操作。资料强调“use tempo”时应使用 tempo 命令行,而不是替代为 MCP 工具或其他工具。Tempo 被描述为 curl 兼容的 CLI,用于服务发现和 HTTP 端点调用,并自动处理支付。
用途与定位:该工具面向“带支付的 HTTP 请求”流程。用户可以先查询钱包状态和可用服务,再按服务端点发起请求;当端点返回付费要求时,由钱包完成结算。资料给出的示例用途包括图像生成、网页搜索、网页抓取与数据提取,以及存储、语音、浏览器自动化等。它不是通用浏览器或通用支付 SDK,资料未提供其他平台的兼容说明。
网络:Tempo Mainnet(链 ID 4217)是默认网络。覆盖顺序为 --network 参数、TEMPO_WALLET_NETWORK 环境变量、已保存的网络设置、已登录钱包的网络。Tempo Testnet(Moderato,链 ID 42431,使用 --network testnet)仅在用户要求或开发流程需要时使用。资料提到 pathUSD 地址 0x20c0000000000000000000000000000000000000 在主网是真实 TIP-20 代币,在测试网是测试代币。
安装与登录:资料要求按顺序执行:先运行 curl -fsSL https://tempo.xyz/install | bash 安装;再运行 "$HOME/.tempo/bin/tempo" wallet login --format json。登录命令会返回 pending 状态、verification_url、user_code 和过期时间,并在主机上打开浏览器。用户需要确认验证码并批准,然后运行登录状态查询命令等待批准结果。若 CLI 运行在远程主机而用户在另一设备操作,可加 --no-browser,把验证链接和验证码交给用户。资料提醒不要循环发起登录;遇到 E_LOGIN_DENIED 或 E_LOGIN_EXPIRED 时,应先询问用户再重新登录。登录完成后运行 tempo wallet whoami 确认就绪状态。
钱包与服务使用:登录后可用 tempo wallet whoami 查看钱包、网络、余额及密钥字段;tempo wallet balance 列出可花费代币余额,--token 可指定单个代币;tempo wallet address 提供收款地址。ready: true 表示钱包可在该网络支付。资料说明 key.status 为 pending 表示密钥已签名但尚未上链,首次支付会发布它;余额和限额以十进制字符串返回,地址为小写。服务发现使用 tempo wallet services search <query>、tempo wallet services show <SERVICE_ID> 和 tempo wallet services list。请求 URL 应由服务元数据中的 SERVICE_URL 与端点 PATH 组合,不能猜测端点路径。
报价与支付:资料建议先用 --dry-run 报价,并向用户展示金额和会话押金,获得明确批准后再支付。正式请求可带 --max-spend、--network、--payment-intent、--payment-token 等参数,把请求固定到已批准的条件。若返回 recurring: true 表示订阅,报价不显示续订条款且 --max-spend 会拒绝,应告知用户并改用 charge 或 session 重新报价。若 dry-run 显示 payment_required: false,说明请求已发出,只有在重复请求安全时才可去掉 --dry-run 重跑。支付失败或限额问题应明确报告并停止,可用 tempo wallet doctor 检查钱包、密钥或 RPC 问题。
MACH 与旧版积分:资料介绍了 MACH 充值与支付流程。可用 tempo wallet whoami --mach 查看 MACH,用 tempo wallet fund --mach --amount <USD> 充值;托管结账接受 5 到 100 美元、最多两位小数。跨设备时可加 --no-browser --format json 把 URL 交给用户,用户完成充值后再检查余额。MACH 是链上六位小数代币,不是旧版信用余额。旧版 MPP Credits 可用 whoami --credits 查看、transfer --credits 花费,但会显示弃用警告,新购买已禁用,tempo request 不会自动使用旧积分。
限制与操作注意:资料明确要求支付前报价并取得批准;撤销访问密钥不可逆,需先用 keys revoke --dry-run 展示密钥、钱包、网络、限额和过期时间,批准后再执行带 --yes 的命令。关闭会话同样不可逆,关闭后不能再为该请求付款。登出默认覆盖所有网络,若仍有会话押金或使用 --revoke,代理运行会返回 E_USAGE 而不登出,需先向用户报告并建议关闭相关会话。资料还说明 fund status、fund --wait、fund --timeout 已移除;tempo wallet debug 是 doctor 的弃用别名。输出方面,管道输出默认是 TOON,--format json 输出 JSON;终端直出时可能显示人类可读视图,因此读取结果应使用管道或显式 JSON。资料未提供收费价格、独立安全审计结论、完整服务清单或离开 Tempo 网络的使用方式,这些均暂未提供。