Entwickler · Base

Builder Code-Attribution für USDCtoFiat-Einzahlungen überprüfen.

Der ausgegebene Code ist in die calldata der Transaktion der Produktions-App eingebunden. In diesem Leitfaden erfährst du, welcher Pfad den Suffix verwaltet und was nach einer Transaktion überprüft werden muss.

Mit dem Base-Template startenSell-Flow öffnen
01

Attributionssequenz

  1. 01Deploye die Base Mini-App auf einen stabilen HTTPS-Ursprung.
  2. 02Registriere und verifiziere die App auf Base.dev.
  3. 03Kopiere den echten Builder Code aus den Base.dev-Einstellungen.
  4. 04Erzeuge den ERC-8021 dataSuffix aus diesem Code mit ox/erc8021.
  5. 05Hänge bei einem direkten Transaktionspfad, den du verwaltest, nach dem Entfernen eines vorhandenen Suffixes genau einen normalisierten dataSuffix an.
  6. 06Erstelle einen kleinen USDCtoFiat-Deposit und verifiziere die Attribution, bevor du eine Kampagne startest.
02

Wo es hingehört

OberflächeAttributionspfad
Base AppDie Base-Dokumentation sagt, dass registrierte Apps automatische Attribution für Aktivität innerhalb der Base App erhalten können.
Web-AppDer USDCtoFiat-Webadapter ersetzt einen vorhandenen Suffix und hängt die Produktionscodes an.
USDCtoFiat SDKDas SDK stellt einen eigenen galleonlabs-Referrer bereit. Füge keinen zweiten clientseitigen Suffix hinzu; separate Integratorcodes werden von der aktuellen SDK-API nicht unterstützt.
ContractsKeine Contract-Änderung ist nötig; ERC-8021-Suffixdaten werden an calldata angehängt und offchain indexiert.
03

Implementierungshinweise

  • Nutze viem 2.45.0 oder neuer für den Base-Doku-Pfad; diese App nutzt bereits eine neuere viem-Version.
  • Der Produktionsadapter von USDCtoFiat ist mit einem ausgegebenen Builder Code eingebunden. Die erfolgreiche Attribution muss dennoch auf Transaktionsebene überprüft werden.
  • Erzeuge für direkte Viem- oder Wagmi-Transaktionen, die du verwaltest, einen einzigen dataSuffix aus allen vorgesehenen Codes.
  • Verknüpfe keine unabhängigen ERC-8021-Suffixe. Parse und ersetze den Suffix oder führe die Codes vor dem Signieren zu einem einzigen Suffix zusammen.
  • Das @usdctofiat/offramp SDK liefert bereits die Attribution für Galleon Labs. Es bietet keine separate Option zum Zusammenführen eines Builder Code.
04

Verifikation

PrüfungBestehensbedingung
Base.devOnchain-Transaktionszähler steigen für den Builder Code der App.
Block ExplorerDie Transaktionseingabe endet mit dem ERC-8021-Suffixmarker und dekodiert zum erwarteten Code.
USDCtoFiat-ErgebnisDer erstellte Deposit liefert depositId und txHash zurück und erscheint danach in deposits(address).
PeerlyticsDer Deposit- und Intent-Lifecycle kann inspiziert werden, sobald die Indexierung aufgeholt hat.

Weiter entdecken

Offramp SDKPeerlytics APIEntwickler-Hub

Häufige Fragen

Verwendet USDCtoFiat bereits einen ausgestellten Builder Code?

Ja. Der Produktionsadapter hängt seinen ausgegebenen Builder Code an die onchain calldata der Einzahlung an. Überprüfe die erfolgreiche Attribution nach einer echten Transaktion in Base.dev oder einem Block-Explorer.

Braucht @usdctofiat/offramp eine separate Builder-Code-Option?

Nein. Das SDK stellt bereits einen galleonlabs-Referrer bereit und bietet derzeit keinen unterstützten Pfad, um einen separaten Builder Code zusammenzuführen. Füge keinen zweiten clientseitigen Suffix hinzu.

Ändert ERC-8021 die ZKP2P-Contracts?

Nein. Die Base-Dokumentation beschreibt Builder Codes als Calldata-Suffix-Attribution. Die Contracts führen normal aus; Attribution wird nach der Transaktion von Offchain-Indexern gelesen.