Skip to main content

类型

字段要点

  • scheme:固定 "exact"
  • network:kebab-case 网络名(如 bsc, base-sepolia
  • maxAmountRequired:最大支付额(wei)
  • payTo:商家地址(EIP-7702)
  • asset:Token 合约地址
  • maxTimeoutSeconds:签名有效期(防重放)

示例

Zod Schema

支持的网络

验证规则要点

  • scheme 必须为 "exact"
  • network 必须与客户端/链配置一致
  • BigInt(payment.value) <= BigInt(maxAmountRequired)
  • resource 为有效 URL,且与受保护资源一致
  • payTo 与商家收款地址一致(建议 EIP-7702)
  • 超时:deadline/validBefore <= now + maxTimeoutSeconds
  • 若指定 paymentType,客户端必须使用该类型

常见场景

  • 固定价 API:启动时创建并缓存 requirements,复用以降低开销
  • 动态定价:按请求上下文计算 maxAmountRequired/description
  • 多 Token 选项:返回多个 accepts 供客户端选择(见 402)

结合 402 的用法