Bereite Builder-Code-Attribution für USDCtoFiat-Deposits vor.
Dies ist Einrichtungsanleitung, keine Behauptung, dass USDCtoFiat bereits einen ausgestellten Builder Code hat. Nutze sie, wenn deine Base-App bereit ist, die onchain Deposit-Transaktionen aus @usdctofiat/offramp zu attribuieren.
Attributionssequenz
- 1Deploye die Base Mini-App auf einen stabilen HTTPS-Ursprung.
- 2Registriere und verifiziere die App auf Base.dev.
- 3Kopiere den echten Builder Code aus den Base.dev-Einstellungen.
- 4Erzeuge den ERC-8021 dataSuffix aus diesem Code mit ox/erc8021.
- 5Hänge dataSuffix an den Viem- oder Wagmi-Client, der die Deposit-Transaktion sendet.
- 6Erstelle einen kleinen USDCtoFiat-Deposit und verifiziere die Attribution, bevor du eine Kampagne startest.
Wo es hingehört
| Oberfläche | Attributionspfad |
|---|---|
| Base App | Die Base-Dokumentation sagt, dass registrierte Apps automatische Attribution für Aktivität innerhalb der Base App erhalten können. |
| Web-App | Füge dataSuffix dem Transaktionsclient hinzu, damit Browser-Nutzung außerhalb der Base App attribuiert wird. |
| USDCtoFiat SDK | Das SDK signiert mit dem Wallet-Client, den du übergibst; der Suffix gehört also auf diesen Wallet-Client-Pfad. |
| Contracts | Keine Contract-Änderung ist nötig; ERC-8021-Suffixdaten werden an calldata angehängt und offchain indexiert. |
Implementierungshinweise
- Nutze viem 2.45.0 oder neuer für den Base-Doku-Pfad; diese App nutzt bereits eine neuere viem-Version.
- Halte Platzhalter-Builder-Codes aus Produktion heraus. Verdrahte den echten Wert erst, nachdem Base.dev ihn ausgestellt hat.
- Bei Viem füge dataSuffix hinzu, wenn der Wallet-Client erstellt wird.
- Bei Wagmi konfiguriere dataSuffix auf Client-Ebene, damit Sends und Batch Calls ihn erben.
- Für Privy- oder Smart-Wallet-Flows nutze den Wallet/Provider-Pfad, der tatsächlich die User Operation oder Transaktion sendet.
Verifikation
| Prüfung | Bestehensbedingung |
|---|---|
| Base.dev | Onchain-Transaktionszähler steigen für den Builder Code der App. |
| Block Explorer | Die Transaktionseingabe endet mit dem ERC-8021-Suffixmarker und dekodiert zum erwarteten Code. |
| USDCtoFiat-Ergebnis | Der erstellte Deposit liefert depositId und txHash zurück und erscheint danach in deposits(address). |
| Peerlytics | Der Deposit- und Intent-Lifecycle kann inspiziert werden, sobald die Indexierung aufgeholt hat. |
Keep exploring
Common questions
Kann ich jetzt einen Platzhalter-Builder-Code hinzufügen?
Nein. Halte die Integration bereit, aber liefere keine Platzhalter-Attribution aus. Registriere auf Base.dev, hole den echten Code und füge ihn dann in den Wallet-Client-Pfad ein.
Braucht @usdctofiat/offramp eine separate Builder-Code-Option?
Nicht für den normalen App-Pfad. Das SDK nutzt den Viem WalletClient, den du übergibst; Attribution sollte also an diesen Client oder die Wallet/Provider-Schicht gehängt werden, die die Transaktion sendet.
Ä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.