开发者 · Base

验证 USDCtoFiat 存款的 Builder Code 归因。

已签发的代码已接入生产应用的交易 calldata。请通过本指南了解由哪条路径管理后缀，以及交易后需要验证哪些内容。

从 Base 模板开始打开出售流程
01

归因顺序

  1. 01将 Base Mini App 部署到稳定的 HTTPS 来源。
  2. 02在 Base.dev 注册并验证应用。
  3. 03从 Base.dev 设置复制真实的 Builder Code。
  4. 04使用 ox/erc8021 从该代码生成 ERC-8021 dataSuffix。
  5. 05对于由你管理的直接交易路径，请先移除现有后缀，再附加一个规范化的 dataSuffix。
  6. 06创建一笔小额 USDCtoFiat 存款，并在启动活动前验证归因。
02

应放在哪里

入口归因路径
Base AppBase 文档说明，已注册应用可接收 Base App 内活动的自动归因。
Web 应用USDCtoFiat Web 适配器会替换现有后缀，并附加生产代码。
USDCtoFiat SDKSDK 会提供自己的 galleonlabs 推荐标识。请勿叠加第二个客户端后缀；当前 SDK API 不支持单独的集成方代码。
合约无需更改合约；ERC-8021 suffix 数据会附加到 calldata，并由链下索引。
03

实现说明

  • 按照 Base 文档路径使用 viem 2.45.0 或更新版本；此应用已经运行更新的 viem 版本。
  • USDCtoFiat 的生产适配器已接入签发的 Builder Code。归因是否成功仍需在交易级别进行验证。
  • 对于由你管理的直接 Viem 或 Wagmi 交易，请使用所有预期代码生成一个 dataSuffix。
  • 请勿拼接多个独立的 ERC-8021 后缀。签名前应解析并替换后缀，或将代码合并为一个后缀。
  • @usdctofiat/offramp SDK 已提供 Galleon Labs 归因，且未提供单独的 Builder Code 合并选项。
04

验证

检查通过条件
Base.dev应用的 Builder Code 的链上交易计数增加。
区块浏览器交易输入以 ERC-8021 suffix 标记结尾，并解码为预期代码。
USDCtoFiat 结果创建的存款返回 depositId 和 txHash，然后出现在 deposits(address) 中。
Peerlytics索引跟上后，可以检查存款和 intent 生命周期。

继续探索

出口匝道 SDKPeerlytics API开发者中心

常见问题

USDCtoFiat 已经使用签发的 Builder Code 吗？

是。生产适配器会将已签发的 Builder Code 附加到 onchain 存款 calldata。完成真实交易后，请在 Base.dev 或区块浏览器中验证归因是否成功。

@usdctofiat/offramp 需要单独的 Builder Code 选项吗？

否。SDK 已提供 galleonlabs 推荐标识，当前也没有为单独 Builder Code 提供受支持的合并路径。请勿添加第二个客户端后缀。

ERC-8021 会改变 ZKP2P 合约吗？

不会。Base 文档将 Builder Codes 描述为 calldata suffix 归因。合约正常执行；归因在交易落地后由链下索引器读取。