通过 X Layer 上的 Builder Codes，将链上活动归因到你的应用或钱包。

什么是 Builder Codes#

X Layer Builder Codes 是一个 ERC-721 NFT 集合，其中唯一的 16 字符编码（例如 8k3m1v0q7z2c9a5x）用于在链上标识构建者。每个编码的元数据中有一个"收款地址（payout address）"——潜在奖励将发送到该地址。

Builder Codes 为你提供：

• 奖励（Rewards）： 将交易归因到你的应用，并随着计划扩展解锁潜在奖励。
• 数据分析（Analytics）： 在 OKX 开发者门户中追踪链上使用量、用户获取和转化指标。
• 曝光（Visibility）： 拥有 Builder Code 的应用可出现在应用排行榜（App Leaderboards）和生态系统精选等发现入口。

获取你的 Builder Code： 前往 OKX 开发者门户，验证你的地址，然后在 Builder Code 页面创建你的 Builder Code。

工作原理#

当发送一笔交易时，会在 calldata 末尾附加一个 ERC-8021 归因后缀（attribution suffix）。该后缀包含你的 Builder Code，由链下索引器提取——它不影响合约执行，无需对智能合约做任何修改。

该后缀消耗的 gas 可忽略不计：每个非零字节 16 gas。

应用通常通过在发送交易的客户端上配置 dataSuffix，或在每笔交易中单独传入来添加该后缀。钱包也可以在签名前附加该后缀，前提是钱包直接支持 Builder Code 归因。支持 EOA 和 ERC-7702 智能钱包，暂不支持 ERC-4337 用户操作（user operations）。

注意： OKX Wallet 目前尚不支持自动注入 Builder Code，因此应用应按集成指南中的说明配置 dataSuffix。

快速开始#

应用开发者

1. 前往 OKX 开发者门户，验证你的地址，然后在 Builder Code 页面创建你的 Builder Code。
2. 参照集成指南为你的应用添加归因。

钱包提供商

请参阅钱包提供商指南。

验证归因#

方式一 —— OKLink 浏览器

1. 在 OKLink 上查找你的交易。
2. 归因的 Builder Code 显示在 Txn hash 字段旁边。

方式二 —— 开源工具

1. 打开 Builder Code Validation 工具。
2. 复制并粘贴交易输入数据。
3. 点击 Check Attribution。

Builder Code 合约#

• 主网（Mainnet）： 0xd6c426f9c077358735622ae5a83468dc0510823b
• 测试网（Testnet）： 0x33907e98d7392d95212b05ab03f091e02d7815bf