開発者 · Base

USDCtoFiat のデポジットに対する Builder Code アトリビューションを検証します。

発行済みコードは、本番アプリのトランザクション calldata に組み込まれています。このガイドで、どの経路がサフィックスを管理し、トランザクション後に何を検証すべきか確認してください。

01

アトリビューション手順

  1. 01Base Mini App を安定した HTTPS オリジンにデプロイします。
  2. 02Base.dev でアプリを登録して検証します。
  3. 03Base.dev 設定から本物の Builder Code をコピーします。
  4. 04ox/erc8021 でそのコードから ERC-8021 dataSuffix を生成します。
  5. 05自身で管理する直接トランザクション経路では、既存のサフィックスを削除してから、正規化した dataSuffix を 1 つ追加します。
  6. 06小さな USDCtoFiat デポジットを作成し、キャンペーン前にアトリビューションを検証します。
02

追加する場所

サーフェスアトリビューション経路
Base AppBase ドキュメントでは、登録済みアプリは Base App 内の活動について自動アトリビューションを受けられるとされています。
Web アプリUSDCtoFiat のウェブアダプターは、既存のサフィックスを置き換えて本番用コードを追加します。
USDCtoFiat SDKSDK は独自の 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 のライフサイクルを確認できます。

よくある質問

USDCtoFiat はすでに発行済み Builder Code を使用していますか?

はい。本番アダプターは、発行済みの Builder Code を onchain デポジット calldata に追加します。実際のトランザクション後に、Base.dev またはブロックエクスプローラーでアトリビューションの成功を検証してください。

@usdctofiat/offramp に別の Builder Code オプションは必要ですか?

いいえ。SDK はすでに galleonlabs リファラーを付与しており、個別の Builder Code をマージするためのサポート済み経路は現在公開していません。クライアント側で 2 つ目のサフィックスを追加しないでください。

ERC-8021 は ZKP2P コントラクトを変更しますか?

いいえ。Base ドキュメントでは Builder Codes は calldata suffix attribution と説明されています。コントラクトは通常通り実行され、アトリビューションは取引後にオフチェーン indexers が読み取ります。