开发者 · Base
为 USDCtoFiat 存款准备 Builder Code 归因。
这是设置指南，并不是声称 USDCtoFiat 已经获得 Builder Code。当你的 Base 应用准备好归因由 @usdctofiat/offramp 创建的链上存款交易时使用它。
01
归因顺序
- 1将 Base Mini App 部署到稳定的 HTTPS 来源。
- 2在 Base.dev 注册并验证应用。
- 3从 Base.dev 设置复制真实的 Builder Code。
- 4使用 ox/erc8021 从该代码生成 ERC-8021 dataSuffix。
- 5把 dataSuffix 附加到发送存款交易的 Viem 或 Wagmi 客户端。
- 6创建一笔小额 USDCtoFiat 存款，并在启动活动前验证归因。
02
应放在哪里
| 入口 | 归因路径 |
|---|---|
| Base App | Base 文档说明，已注册应用可接收 Base App 内活动的自动归因。 |
| Web 应用 | 将 dataSuffix 添加到交易客户端，使 Base App 外的浏览器使用可被归因。 |
| USDCtoFiat SDK | SDK 使用你传入的钱包客户端签名，因此 suffix 应放在该 wallet-client 路径上。 |
| 合约 | 无需更改合约；ERC-8021 suffix 数据会附加到 calldata，并由链下索引。 |
03
实现说明
- 按照 Base 文档路径使用 viem 2.45.0 或更新版本；此应用已经运行更新的 viem 版本。
- 不要在生产中使用占位 Builder Codes。只有在 Base.dev 签发真实值后才接入。
- 对于 Viem，在创建钱包客户端时添加 dataSuffix。
- 对于 Wagmi，在客户端级别配置 dataSuffix，使发送和批量调用继承它。
- 对于 Privy 或智能钱包流程，使用实际提交 user operation 或交易的钱包/provider 路径。
04
验证
| 检查 | 通过条件 |
|---|---|
| Base.dev | 应用的 Builder Code 的链上交易计数增加。 |
| 区块浏览器 | 交易输入以 ERC-8021 suffix 标记结尾，并解码为预期代码。 |
| USDCtoFiat 结果 | 创建的存款返回 depositId 和 txHash，然后出现在 deposits(address) 中。 |
| Peerlytics | 索引跟上后，可以检查存款和 intent 生命周期。 |
Keep exploring
Common questions
现在可以添加占位 Builder Code 吗？
不可以。保持集成就绪，但不要发布占位归因。先在 Base.dev 注册，获取真实代码，然后将其添加到 wallet-client 路径。
@usdctofiat/offramp 需要单独的 Builder Code 选项吗？
普通应用路径不需要。SDK 使用你传入的 Viem WalletClient，因此归因应附加到该客户端或实际发送交易的钱包/provider 层。
ERC-8021 会改变 ZKP2P 合约吗？
不会。Base 文档将 Builder Codes 描述为 calldata suffix 归因。合约正常执行；归因在交易落地后由链下索引器读取。