X402engine

⚡ 63个API按调用付费,微支付即用即走

通过x402微支付调用63个付费API的网关,每笔$0.001-$0.60,支持LLM、图像生成、加密行情、航班酒店等,需配置EVM私钥和本地策略引擎进行支出管控。

收藏
3.4k
安装
972
版本
1.2.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

x402engine是一个基于区块链微支付协议的API网关skill,允许用户通过USDC/USDm稳定币按调用付费访问63种第三方服务。用户需配置EVM_PRIVATE_KEY环境变量用于签名链上交易,系统通过本地策略引擎(policy engine)实施支出管控。

典型调用流程:
1. 从发现端点获取服务目录(默认https://x402engine.app/.well-known/x402.json)

2. 将用户查询与63个服务描述匹配打分

3. 策略预检:单笔上限、日限额、收款方白名单

4. 通过@x402/fetch自动处理402支付流程

5. 返回结构化数据并由Agent自然语言呈现(必须包含调用成本)

覆盖服务类型:

  • LLM对话(GPT、Claude等)
  • 图像/视频生成
  • 加密货币行情与链上数据
  • 航班酒店搜索
  • 网页抓取、IPFS、ENS解析等基础设施

显著优点

  • 细粒度付费:单次调用成本$0.001-$0.60,避免订阅浪费
  • 多链支持:Base、Solana、MegaETH网络
  • 本地策略管控:可配置单笔/日限额、资产白名单、收款方白名单,策略文件缺失或损坏时默认拒绝所有支付(fail-closed设计)
  • 透明计费:每次调用强制展示成本,支持实时预算查询
  • 模块化架构:支持自定义发现端点,可自建服务目录

潜在缺点与局限性

  • 私钥风险:EVM_PRIVATE_KEY直接用于签名交易,虽建议"专用小额钱包",但仍为热钥暴露
  • 资金门槛:需预存USDC/USDc,新用户 onboarding 摩擦
  • 网络依赖:链上确认可能引入延迟,Gas波动影响小额支付经济性
  • 服务集中:默认依赖x402engine.app的发现端点,存在单点信任假设
  • 策略配置复杂度:需手动维护X402_POLICY_PATH文件,误配可能导致服务中断或超额支出

适合人群

  • 需要高频调用多种付费API但不愿承担固定订阅的开发者/Agent构建者
  • 希望可审计、可编程的支出管控的团队场景
  • 已熟悉EVM钱包操作、能接受链上支付摩擦的加密原生用户

常规风险

| 风险类型 | 说明 |
|---------|------|
| **私钥泄露** | 环境变量中的`EVM_PRIVATE_KEY`被窃取导致资金损失 |
| **策略绕过** | 配置错误导致限额失效,或恶意服务目录篡改`payTo`地址 |
| **资金冻结** | Permit2合约风险或网络拥堵导致支付失败 |
| **服务中断** | 发现端点宕机或策略引擎故障导致全部API访问阻断 |
| **隐私暴露** | 链上支付留下可追踪的调用模式指纹 |

X402engine 内容

test文件夹
手动下载zip · 30.8 kB
client.test.jstext/javascript
请选择文件