快速开始

通过 Agent 接入#

为你的 Agent 安装支付 Skill 后,它能识别 402 付费请求、签署交易并完成支付,无需人工介入。

配置#

将以下提示词发送给 AI,即可安装 Onchain OS Skills,为你的 Agent 配置 Agentic Wallet:

运行 npx skills add okx/onchainos-skills 安装 Onchain OS skills
注意:请安装到当前 Agent 对应的 skill 目录
同时,帮我根据这个文档安装最新版本的CLI https://github.com/okx/onchainos-skills

验证#

下文以 "查询天气" 为示例,请以实际需要请求的线上 x402 付费服务进行测试。

登录:

onchainos wallet login

请求卖家端的服务/资源:

//非线上服务,仅做案例参考
访问该服务 http://localhost:4021/weather

获取到支付信息,说明请求成功:

服务返回了一个 x402 支付要求 响应(HTTP 402)。内容如下:

  - x402 版本: 2
  - 资源: /weather — 获取任意地点的当前天气数据,返回 application/json
  - 支付方式 (两种 scheme):
    - exact — 单次支付
    - aggr_deferred — 事后支付
  - 网络: eip155:196 (OKX X Layer)
  - 代币: USD₮0 (0x779ded0c9e1022225f8e0630b35a9b54be713736)
  - 金额: 1000 (最小单位)
  - 收款地址: 0xb483abdb92f8061e9a3a082a4aaaa6b88c381308
  - 超时: 600,000 秒

  这是一个需要通过 x402 协议付费才能访问的端点。需要我帮你发起支付来获取天气数据吗?

确认支付,签名交易数据并重放请求到卖家端:

签名成功,正在重放请求:
Bash(PAYMENT_PAYLOAD=$(python3 -c "
      import json, base64
      payload = {
          'x402Version': 2,
          'resource': {'url': '/weather', 'description': 'Get current weather data for any location', 'mimeType':
      'application/json'},
          'accepted': {'scheme': 'exact', 'network': 'eip155:196', 'asset':
      '0x779ded0...4be713736', 'amount': '1000', 'payTo':
      '0xb483abd....aa6b88c381308', 'maxTimeoutSeconds': 600000, 'extra': {'name': 'USD₮0',
      'version': '1'}},
          'payload': {
              'signature': '0x3d1907a6ba9f592c...35868ea11b',
              'authorization': {'from': '0xbda9fde...99763', 'nonce':
              '0x20862cc...06e48', 'to':
              '0xb483abd...81308', 'validAfter': '0', 'validBefore': '1775837508', 'value': '1000'}
          }
      }
      print(base64.b64encode(json.dumps(payload, separators=(',', ':')).encode()).decode())
      ")
      curl -s -D - http://localhost:4021/weather -H "PAYMENT-SIGNATURE: $PAYMENT_PAYLOAD")
  ⎿  HTTP/1.1 200 OK

获取到卖家端返回的资源:

⏺ 支付成功!天气数据返回:

  {"report": {"temperature": 70, "weather": "sunny"}}

  - 温度: 70°F
  - 天气: 晴天 ☀️