跳到正文

部署

为原生网关、Worker 网关和文档站准备生产环境。

网关和文档站是两个独立部署面。本站已配置为 Cloudflare edge SSR，目标域名为 x402.pwp.sh。

文档站

Shell
pnpm --filter @x402-paysdk/docs typecheckpnpm --filter @x402-paysdk/docs build:edgepnpm --filter @x402-paysdk/docs deploy

部署命令使用 docs/wrangler.jsonc 并指向 x402.pwp.sh 自定义域。部署前需要在本地完成 Wrangler 认证。仓库不会提交资源 ID 或密钥。

选择网关

需要完整自托管路由，或希望控制进程、数据库和网络时，选择 gateway-native。希望在边缘运行，且已经配好 D1/KV binding 与生产 gate 时，选择 gateway-worker。

上线检查

  1. 设置 canonical gateway origin 和 HTTPS 终止。
  2. 配置 facilitator 与有边界的 RPC endpoint。
  3. 准备签名密钥、secret pepper、商户密钥存储和 rate limit。
  4. 启用 Worker store 前应用 D1 migration。
  5. 验证协商、结算、receipt verification 和 recovery 全流程。
  6. 确认日志不包含凭据或可重放支付 payload。
  7. 开启不可逆履约前，使用链上历史完成对账。