SuperAPI AI 工具集

walletconnect-pay-headless

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:该技能帮助开发者用 WalletConnect Pay Headless SDK(@walletconnect/pay-* 包)在自有产品与域名中构建完全自定义品牌的稳定币收银台,把加密支付嵌入已有结账流程,而非跳转到 WalletConnect 托管页面;也用于为 Engine API 密钥搭建服务器代理,并按快照渲染支付生命周期。若只需创建支付请求或轮询状态、或为钱包应用添加 WC Pay,则不属于本集成范围。

主要能力:Headless 运行时与 UI 解耦,支付流程(加载支付、连接钱包、报价、签名、结算)全部在 SDK 内运行,界面由开发者自行渲染。运行时通过五个可替换接缝与外界交互:Transport、WalletProvider、Signer、Clock、Telemetry;实际通常只需接入前三个,browserClock 与 noopTelemetry 为默认。四个分层包:@walletconnect/pay-core(Engine API 客户端、浏览器 Transport 与仅服务端的 createEngineClient)、@walletconnect/pay-state(状态机、createPaymentController、PaymentSnapshot)、@walletconnect/pay-react(usePaymentSession 的 React 轻绑定)、@walletconnect/pay-appkit(Reown AppKit 适配,含 WalletProvider 接缝、零配置 Signer 与钱包选择器)。

使用方式:需 Node 18+、Reown Project ID(公开、启用 headless)与仅服务端的 WalletConnect Pay Gateway API 密钥。安装:npm install @walletconnect/pay-core @walletconnect/pay-state @walletconnect/pay-appkit @walletconnect/pay-react(非 React 项目可省略最后一个)。可选 React/Next.js、原生 JavaScript、自定义钱包三条路径,均需自建服务器代理。流程为:加载支付 → 连接钱包 → 获取选项 → 选择与构建 → 签名 → 确认与结算,SDK 自动推进,开发者读取 snapshot.state 并调用对应动作(如 connectWallet、selectOption、confirmSelection、submitInfoCapture、navigateBack 等)。

限制与注意:API 密钥必须只保留在服务端,绝不进入浏览器或 NEXT_PUBLIC_/VITE_ 变量;浏览器经代理访问 Engine。当前为 beta(v0.1.x),签名可能随小版本变化,版本敏感细节应以官方文档与参考示例为准。需处理全部 17 个状态,五个终止失败状态可用 isFailureState 归组。Reown 项目需启用 headless 特性;CSP 需允许 verify.walletconnect.com/.org 的 frame-src。资料未提供具体收费、价格与效果信息。