Prepara l attribuzione Builder Code per i depositi USDCtoFiat.
Questa è una guida di configurazione, non una dichiarazione che USDCtoFiat abbia già un Builder Code emesso. Usala quando la tua app Base è pronta ad attribuire le transazioni onchain di deposito create tramite @usdctofiat/offramp.
Sequenza di attribuzione
- 1Distribuisci la Base Mini App su un origine HTTPS stabile.
- 2Registra e verifica l app su Base.dev.
- 3Copia il vero Builder Code dalle impostazioni Base.dev.
- 4Genera il dataSuffix ERC-8021 da quel codice con ox/erc8021.
- 5Collega dataSuffix al client Viem o Wagmi che invia la transazione di deposito.
- 6Crea un piccolo deposito USDCtoFiat e verifica l attribuzione prima di lanciare una campagna.
Dove appartiene
| Superficie | Percorso di attribuzione |
|---|---|
| Base App | La documentazione Base dice che le app registrate possono ricevere attribuzione automatica per l attività dentro la Base App. |
| App web | Aggiungi dataSuffix al client di transazione così l uso browser fuori dalla Base App viene attribuito. |
| SDK USDCtoFiat | Il SDK firma con il wallet client che fornisci, quindi il suffix appartiene a quel percorso wallet-client. |
| Contratti | Non serve modificare i contratti; i dati suffix ERC-8021 vengono aggiunti al calldata e indicizzati offchain. |
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.
- Tieni i Builder Codes placeholder fuori dalla produzione. Collega il valore reale solo dopo che Base.dev lo ha emesso.
- Per Viem, aggiungi dataSuffix quando viene creato il wallet client.
- Per Wagmi, configura dataSuffix a livello client così send e batch calls lo ereditano.
- Per Privy o smart-wallet flows, usa il percorso wallet/provider che invia davvero la user operation o la transazione.
Verifica
| Controllo | Condizione di successo |
|---|---|
| Base.dev | I conteggi delle transazioni onchain aumentano per il Builder Code dell app. |
| Block explorer | L input della transazione termina con il marker suffix ERC-8021 e decodifica al codice atteso. |
| Risultato USDCtoFiat | Il deposito creato restituisce depositId e txHash, poi appare in deposits(address). |
| Peerlytics | Il lifecycle di deposito e intent può essere ispezionato quando l indicizzazione raggiunge. |
Keep exploring
Common questions
Posso aggiungere ora un Builder Code placeholder?
No. Tieni pronta l integrazione, ma non pubblicare attribuzione placeholder. Registrati su Base.dev, ottieni il codice reale, poi aggiungilo al percorso wallet-client.
@usdctofiat/offramp ha bisogno di un opzione Builder Code separata?
Non per il normale percorso app. Il SDK usa il Viem WalletClient che passi, quindi l attribuzione va attaccata a quel client o al layer wallet/provider che invia la transazione.
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.