Sviluppatori · Base

Verifica l’attribuzione del Builder Code per i depositi USDCtoFiat.

Il codice assegnato è integrato nella calldata delle transazioni dell’app di produzione. Usa questa guida per capire quale percorso gestisce il suffisso e cosa deve essere verificato dopo una transazione.

Parti dal template BaseApri il flusso di vendita
01

Sequenza di attribuzione

  1. 01Distribuisci la Base Mini App su un origine HTTPS stabile.
  2. 02Registra e verifica l app su Base.dev.
  3. 03Copia il vero Builder Code dalle impostazioni Base.dev.
  4. 04Genera il dataSuffix ERC-8021 da quel codice con ox/erc8021.
  5. 05Per un percorso di transazione diretta che gestisci, aggiungi un solo dataSuffix normalizzato dopo aver rimosso qualsiasi suffisso esistente.
  6. 06Crea un piccolo deposito USDCtoFiat e verifica l attribuzione prima di lanciare una campagna.
02

Dove appartiene

SuperficiePercorso di attribuzione
Base AppLa documentazione Base dice che le app registrate possono ricevere attribuzione automatica per l attività dentro la Base App.
App webL’adattatore web di USDCtoFiat sostituisce qualsiasi suffisso esistente e aggiunge i codici di produzione.
SDK USDCtoFiatL’SDK fornisce un proprio referrer galleonlabs. Non aggiungere un secondo suffisso lato client; l’API attuale dell’SDK non supporta codici separati per gli integratori.
ContrattiNon serve modificare i contratti; i dati suffix ERC-8021 vengono aggiunti al calldata e indicizzati offchain.
03

Note di implementazione

  • Usa viem 2.45.0 o più recente per il percorso della documentazione Base; questa app usa già una versione più nuova di viem.
  • L’adattatore di produzione di USDCtoFiat è configurato con un Builder Code assegnato. L’attribuzione corretta deve comunque essere verificata a livello di transazione.
  • Per le transazioni dirette con Viem o Wagmi che gestisci, genera un unico dataSuffix con tutti i codici previsti.
  • Non concatenare suffissi ERC-8021 indipendenti. Analizza e sostituisci il suffisso, oppure unisci i codici in un solo suffisso prima della firma.
  • L’SDK @usdctofiat/offramp fornisce già l’attribuzione Galleon Labs. Non offre un’opzione separata per unire un Builder Code.
04

Verifica

ControlloCondizione di successo
Base.devI conteggi delle transazioni onchain aumentano per il Builder Code dell app.
Block explorerL input della transazione termina con il marker suffix ERC-8021 e decodifica al codice atteso.
Risultato USDCtoFiatIl deposito creato restituisce depositId e txHash, poi appare in deposits(address).
PeerlyticsIl lifecycle di deposito e intent può essere ispezionato quando l indicizzazione raggiunge.

Continua a esplorare

SDK di offrampAPI di PeerlyticsHub per sviluppatori

Domande frequenti

USDCtoFiat usa già un Builder Code emesso?

Sì. L’adattatore di produzione aggiunge il Builder Code assegnato alla calldata onchain del deposito. Verifica l’attribuzione corretta in Base.dev o in un block explorer dopo una transazione reale.

@usdctofiat/offramp ha bisogno di un opzione Builder Code separata?

No. L’SDK fornisce già un referrer galleonlabs e attualmente non offre un percorso supportato per unire un Builder Code separato. Non aggiungere un secondo suffisso lato client.

ERC-8021 cambia i contratti ZKP2P?

No. La documentazione Base descrive i Builder Codes come attribuzione tramite calldata suffix. I contratti eseguono normalmente; l attribuzione viene letta da indexer offchain dopo la transazione.