★ FEATURED ARTICLE 【免费下载链接】ixrailChaos项目地址https://gitcode.com/gh_mirrors/by/ixrail点击查看免费下载ixrail AgentPay是一款 VS Code 扩展它为本地 AI Agent 提供钱包与预算管理通过 x402 支付协议与 USDC 稳定币结算让 AI Agent 在调用 API、获取数据或消耗算力时自主完成付款且每笔交易都有签名回执可审计。本文将从安装、零成本沙盒演示到支出策略配置带你一步步给 AI Agent 装上一副有预算约束的钱包。什么是 ixrail AgentPay一句话概括它是一个Agent 钱包 支出策略 认证本地经纪人 x402 支付流 签名回执账本的组合体全程不离开编辑器。能力说明 Agent 钱包通过 VS CodeSecretStorage创建并保管 EOA 钱包测试网 Base Sepolia / 主网 Base 支出策略单笔、每日、每月三级限额 人工审批阈值 商户允许/阻止名单 本地经纪人仅监听回环地址的认证 HTTP 端点让本地 Agent 以 Bearer Token 调用 AgentPay 工具 签名回执每笔已结算支付都产出一条防重放、可独立验证的签名回执 MCP 服务器无第三方依赖的 stdio MCP 服务器任何 MCP 兼容客户端都能直接调用同一组工具 沙盒演示内置模拟商户 模拟结算零资金跑通支付 → 回执完整闭环为什么 AI Agent 需要钱包与预算随着 Agent 框架和 MCP 服务器能力增强它们越来越多地为消耗的资源付费——API 调用、数据、算力——而每一笔交易都不现实地由人肉在场审批。但直接把钱交给 Agent 又让人不放心。ixrail AgentPay 的思路是给 Agent 钱包但把花钱的缰绳留在人手里每次结算前都先过策略校验超额或被阻止名单命中的请求直接拒绝金额达到审批阈值时必须在 VS Code 中显式确认才会继续结算已批准的支出会被预留10 分钟防止并发请求同时冲破限额发现 Agent 行为异常时一键Revoke access立即停止其所有付款并清空在途预留。快速安装VS Code 中一条命令搞定最快的开始方式是从 VS Code Marketplace 安装ixrail AgentPay扩展 ID 为ixrail.ixrailcode --install-extension ixrail.ixrail也可以按CtrlShiftXmacOS 为CmdShiftX打开扩展视图直接搜索ixrail AgentPay安装。环境要求详见 package.jsonVS Code ≥ 1.85Node.js ≥ 18仅本地开发或运行独立进程时需要如果你想从源码构建克隆仓库后依次执行npm install→npm run build再按F5打开扩展开发宿主即可调试四个入口的打包布局可查看 esbuild.js。三步沙盒演示不花一分钱体验完整支付流ixrail AgentPay 自带引导式沙盒演示自动创建名为sandbox-demo的 Base Sepolia 钱包、应用仅限 localhost 的策略、启动认证经纪人和内置模拟商户全程不需要真钱。Set Up Sandbox Demo一键创建钱包、应用策略、启动经纪人并复制经纪人 Bearer TokenPay endpoint选择sandbox-demo代理输入模拟商户地址http://127.0.0.1:4021/v1/weather——该商户固定收费 0.05 USDC并会拒绝任何回执证明的二次重放查看回执在 Agent 卡片中查看近期付款或打开All receipts查看签名回执账本还能对回执做签名验证。默认情况下ixrail.simulateSettlement为开启状态扩展会完整执行策略校验 → 付款签名 → 402 重试 → 签名回执流程但不会真正广播链上交易。想测试真实的 Base Sepolia USDC 转账时关闭该设置为钱包注入 Base Sepolia USDC 和少量 ETH 作 gas 后再次支付即可。设置支出策略给 AI Agent 的四层预算控制在侧边栏选中某个 Agent选择Set policy后所有 x402 结算尝试在签名前都会经过以下检查控制项作用单笔上限Per-transaction cap一次支付的最大金额每日上限Daily cap当前 UTC 日已记录支出 在途预留之和每月上限Monthly cap当前 UTC 月已记录支出 在途预留之和审批阈值Approval threshold达到或超过该金额需要人工在 VS Code 中显式确认允许 / 阻止名单商户域名或收款地址白名单允许名单为空表示放行所有未被阻止的对象阻止名单始终优先两个值得注意的细节预留机制已批准的支出会预留 10 分钟避免并发请求竞争冲破上限交易失败时预留自动释放吊销与恢复吊销会拒绝该 Agent 的全部支付并清空调预留重新创建或更新策略时会自动恢复此前被吊销的 Agent。x402 支付流程Agent 如何为 API 自动买单x402 是一种用 HTTP 402 状态码表达需要付款的支付协议。pay_x402_endpoint工具的工作方式如下Agent 先正常请求目标资源若响应不是 402直接返回结果不发生支付收到 402 后AgentPay 读取付款要求并逐项校验金额为正数、资产为USDC、收款地址是合法 EVM 地址、链为base-sepolia或base、钱包链一致再叠加校验调用方传入的最大金额与 Agent 策略通过后预留支出并签名付款结算完成后AgentPay 签署一份规范化回执携带X-Payment-Proof与X-Ixrail-Receipt请求头重试原始请求最后把支出记入日/月限额并释放预留。完整的组件地图与数据流可以参考 docs/ARCHITECTURE.md。MCP 服务器与本地 Broker让其他 Agent 也能调用除 VS Code 界面外同样的 6 个工具get_balance、request_payment、pay_x402_endpoint、create_spending_policy、get_receipt、revoke_agent_access可以通过两条通道对外暴露stdio MCP 服务器基于 stdio 的无依赖 JSON-RPC 运行时支持 initialize、工具发现、ping 与工具调用可直接接入任何 MCP 兼容客户端。在扩展中使用Copy MCP Configuration可自动生成客户端配置并通过IXRAIL_AGENTPAY_STORE指定独立存储文件HTTP 经纪人默认监听127.0.0.1:4022只接受回环地址绑定每个/tools/*请求都必须携带Authorization: Bearer token头采用时序安全的比较方式GET /health则保持开放以便探活。相关安全设计与细节见 SECURITY.md。真实 USDC 结算前必须知道的注意事项沙盒模式不移动任何代币。启用真实链上 USDC 结算前请先了解这些限制链上模式钱包需同时持有 USDC 与 ETH作 gas金额以数字表示并四舍五入到 6 位小数适合受控的开发工作流而非高金额资金操作get_balance目前报告的是原生 ETH 余额不是USDC 代币余额Base 主网转账默认禁用需显式设置IXRAIL_ALLOW_MAINNET_PAYMENTS1才能开启——转账不可逆连接陌生端点前请收紧允许名单并调低限额本版本提交交易后不会等待确认请在认定支付最终完成前独立核验该交易x402 服务端控制它返回的付款要求因此对不熟悉的端点务必配合严格允许名单和低限额使用。常见问题速查现象快速排查/tools/*返回 401 Unauthorized确认Authorization: Bearer token完全一致重启且未设置IXRAIL_HTTP_TOKEN会生成新 token经纪人拒绝启动只支持127.0.0.1、::1、localhost三种回环主机支付被策略拒绝依次检查是否被吊销、允许/阻止名单、单笔上限、UTC 日/月累计支出、在途预留、maxAmountUsd支付要求人工审批金额达到审批阈值独立 HTTP/stdio 进程没有审批 UI默认拒绝需审批的结算如需无人值守请刻意调整策略端口 4021 / 4022 被占用用IXRAIL_MOCK_MERCHANT_PORT改商户端口用IXRAIL_HTTP_PORT或ixrail.brokerPort改经纪人端口项目文件导航文件说明README.md完整文档安装、沙盒演示、策略、x402 行为与环境变量docs/ARCHITECTURE.md组件地图、数据流与信任边界package.json扩展清单、贡献的命令与设置项、构建脚本esbuild.js扩展、MCP 服务器、HTTP 桥、模拟商户四个入口的打包配置CHANGELOG.md版本历史当前版本 0.2.6SECURITY.md安全机制与漏洞报告渠道写在最后ixrail AgentPay 本质上是一个装在 VS Code 里的AI Agent 收银台Agent 拥有自己的钱包花钱受策略约束结算留签名回执人始终握有一票否决权。建议先跑一遍零成本的沙盒演示再逐步过渡到真实的 USDC 结算——先让 Agent 在预算之内学会花钱再去扩大它的钱包权限。赞分享【免费下载链接】ixrailChaos项目地址https://gitcode.com/gh_mirrors/by/ixrail点击查看免费下载相关推荐为什么AI Agent需要自己付钱读懂x402协议与ixrail AgentPay的关系为什么AI Agent需要自己付钱读懂x402协议与ixrail AgentPay的关系 ixrail AgentPay 是一个 VS Code 扩展它给本创建第一个AI Agent钱包ixrail AgentPay的base-sepolia与base网络选择完全解析创建第一个AI Agent钱包ixrail AgentPay的base sepolia与base网络选择完全解析 ixrail AgentPay 是一款 VSOpenClacky是什么最省Token的开源AI Agent完整入门指南OpenClacky是什么最省Token的开源AI Agent完整入门指南 OpenClacky 是一款 100% 开源MIT 协议的 AI Agent人工智能大模型AI Agent代码智能体工具调用AI 技能交互助手创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
