01
アトリビューション手順
- 01Base Mini App を安定した HTTPS オリジンにデプロイします。
- 02Base.dev でアプリを登録して検証します。
- 03Base.dev 設定から本物の Builder Code をコピーします。
- 04ox/erc8021 でそのコードから ERC-8021 dataSuffix を生成します。
- 05自身で管理する直接トランザクション経路では、既存のサフィックスを削除してから、正規化した dataSuffix を 1 つ追加します。
- 06小さな USDCtoFiat デポジットを作成し、キャンペーン前にアトリビューションを検証します。
02
追加する場所
| サーフェス | アトリビューション経路 |
|---|---|
| Base App | Base ドキュメントでは、登録済みアプリは Base App 内の活動について自動アトリビューションを受けられるとされています。 |
| Web アプリ | USDCtoFiat のウェブアダプターは、既存のサフィックスを置き換えて本番用コードを追加します。 |
| USDCtoFiat SDK | SDK は独自の galleonlabs リファラーを付与します。クライアント側で 2 つ目のサフィックスを重ねないでください。現在の SDK API は、インテグレーターごとの個別コードをサポートしていません。 |
| コントラクト | コントラクト変更は不要です。ERC-8021 suffix データは calldata に追加され、オフチェーンでインデックスされます。 |
03
実装メモ
- Base ドキュメントの経路では viem 2.45.0 以降を使います。このアプリはすでにより新しい viem を使っています。
- USDCtoFiat の本番アダプターには、発行済みの Builder Code が組み込まれています。アトリビューションの成功は、引き続きトランザクション単位で検証する必要があります。
- 自身で管理する Viem または Wagmi の直接トランザクションでは、使用するすべてのコードから 1 つの dataSuffix を生成します。
- 個別の ERC-8021 サフィックスを連結しないでください。署名前にコードを解析して置き換えるか、1 つのサフィックスへマージしてください。
- @usdctofiat/offramp SDK は、すでに Galleon Labs アトリビューションを付与します。個別の Builder Code をマージするオプションは公開していません。
04
検証
| チェック | 合格条件 |
|---|---|
| Base.dev | アプリの Builder Code のオンチェーン取引数が増えます。 |
| ブロックエクスプローラー | 取引 input が ERC-8021 suffix マーカーで終わり、期待するコードにデコードされます。 |
| USDCtoFiat 結果 | 作成されたデポジットは depositId と txHash を返し、その後 deposits(address) に表示されます。 |
| Peerlytics | インデックスが追いついた後、デポジットと intent のライフサイクルを確認できます。 |