Préparez l attribution Builder Code pour les dépôts USDCtoFiat.
Ceci est un guide de configuration, pas une affirmation qu USDCtoFiat possède déjà un Builder Code émis. Utilisez-le quand votre app Base est prête à attribuer les transactions de dépôt onchain créées par @usdctofiat/offramp.
Séquence d attribution
- 1Déployez la Base Mini App sur une origine HTTPS stable.
- 2Enregistrez et vérifiez l app sur Base.dev.
- 3Copiez le vrai Builder Code depuis les paramètres Base.dev.
- 4Générez le dataSuffix ERC-8021 depuis ce code avec ox/erc8021.
- 5Attachez dataSuffix au client Viem ou Wagmi qui envoie la transaction de dépôt.
- 6Créez un petit dépôt USDCtoFiat et vérifiez l attribution avant de lancer une campagne.
Où cela appartient
| Surface | Chemin d attribution |
|---|---|
| Base App | La documentation Base indique que les apps enregistrées peuvent recevoir une attribution automatique pour l activité dans la Base App. |
| App web | Ajoutez dataSuffix au client de transaction afin que l usage navigateur hors Base App soit attribué. |
| SDK USDCtoFiat | Le SDK signe avec le client wallet que vous fournissez, donc le suffixe appartient à ce chemin wallet-client. |
| Contrats | Aucun changement de contrat n est nécessaire ; les données de suffixe ERC-8021 sont ajoutées au calldata et indexées offchain. |
Notes d implémentation
- Utilisez viem 2.45.0 ou plus récent pour le parcours documenté par Base ; cette app utilise déjà une version plus récente de viem.
- Gardez les Builder Codes placeholder hors production. Branchez la vraie valeur seulement après son émission par Base.dev.
- Pour Viem, ajoutez dataSuffix lors de la création du client wallet.
- Pour Wagmi, configurez dataSuffix au niveau du client afin que les envois et appels groupés en héritent.
- Pour Privy ou les flux smart-wallet, utilisez le chemin wallet/provider qui soumet réellement la user operation ou la transaction.
Vérification
| Contrôle | Condition de réussite |
|---|---|
| Base.dev | Les compteurs de transactions onchain augmentent pour le Builder Code de l app. |
| Explorateur de blocs | L input de transaction se termine par le marqueur de suffixe ERC-8021 et se décode vers le code attendu. |
| Résultat USDCtoFiat | Le dépôt créé renvoie depositId et txHash, puis apparaît dans deposits(address). |
| Peerlytics | Le cycle de vie du dépôt et de l intent peut être inspecté après rattrapage de l indexation. |
Keep exploring
Common questions
Puis-je ajouter un Builder Code placeholder maintenant ?
Non. Gardez l intégration prête, mais ne publiez pas d attribution placeholder. Enregistrez sur Base.dev, obtenez le vrai code, puis ajoutez-le au chemin du client wallet.
@usdctofiat/offramp a-t-il besoin d une option Builder Code séparée ?
Pas pour le parcours normal d app. Le SDK utilise le Viem WalletClient fourni ; l attribution doit donc être attachée à ce client ou à la couche wallet/provider qui envoie la transaction.
ERC-8021 change-t-il les contrats ZKP2P ?
Non. La documentation Base décrit les Builder Codes comme une attribution par suffixe calldata. Les contrats s exécutent normalement ; l attribution est lue par des indexeurs offchain après l arrivée de la transaction.