Prepara la atribución con Builder Code para depósitos de USDCtoFiat.
Esta es una guía de configuración, no una afirmación de que USDCtoFiat ya tenga un Builder Code emitido. Úsala cuando tu app de Base esté lista para atribuir las transacciones onchain de depósito creadas con @usdctofiat/offramp.
Secuencia de atribución
- 1Despliega la Base Mini App en un origen HTTPS estable.
- 2Registra y verifica la app en Base.dev.
- 3Copia el Builder Code real desde la configuración de Base.dev.
- 4Genera el dataSuffix ERC-8021 desde ese código con ox/erc8021.
- 5Adjunta dataSuffix al cliente Viem o Wagmi que envía la transacción de depósito.
- 6Crea un pequeño depósito de USDCtoFiat y verifica la atribución antes de lanzar una campaña.
Dónde pertenece
| Superficie | Ruta de atribución |
|---|---|
| Base App | La documentación de Base dice que las apps registradas pueden recibir atribución automática por la actividad dentro de Base App. |
| App web | Añade dataSuffix al cliente de transacciones para atribuir el uso del navegador fuera de Base App. |
| SDK de USDCtoFiat | El SDK firma con el cliente de wallet que proporcionas, así que el sufijo pertenece a esa ruta de wallet-client. |
| Contratos | No hace falta cambiar contratos; los datos de sufijo ERC-8021 se añaden al calldata y se indexan offchain. |
Notas de implementación
- Usa viem 2.45.0 o posterior para la ruta de la documentación de Base; esta app ya usa una versión más nueva de viem.
- Mantén los Builder Codes placeholder fuera de producción. Conecta el valor real solo después de que Base.dev lo emita.
- Para Viem, añade dataSuffix al crear el cliente de wallet.
- Para Wagmi, configura dataSuffix a nivel de cliente para que envíos y llamadas agrupadas lo hereden.
- Para Privy o flujos de smart wallet, usa la ruta de wallet/proveedor que realmente envía la user operation o transacción.
Verificación
| Comprobación | Condición de éxito |
|---|---|
| Base.dev | Los conteos de transacciones onchain aumentan para el Builder Code de la app. |
| Explorador de bloques | La entrada de la transacción termina con el marcador de sufijo ERC-8021 y se decodifica al código esperado. |
| Resultado de USDCtoFiat | El depósito creado devuelve depositId y txHash, y luego aparece en deposits(address). |
| Peerlytics | El ciclo de vida del depósito y el intent puede inspeccionarse cuando la indexación se ponga al día. |
Keep exploring
Common questions
¿Puedo añadir ahora un Builder Code placeholder?
No. Mantén lista la integración, pero no publiques atribución placeholder. Registra en Base.dev, obtén el código real y luego añádelo a la ruta del cliente de wallet.
¿@usdctofiat/offramp necesita una opción separada de Builder Code?
No para la ruta normal de app. El SDK usa el Viem WalletClient que proporcionas, así que la atribución debe adjuntarse a ese cliente o a la capa de wallet/proveedor que envía la transacción.
¿ERC-8021 cambia los contratos de ZKP2P?
No. La documentación de Base describe Builder Codes como atribución mediante sufijo de calldata. Los contratos se ejecutan normalmente; la atribución la leen indexadores offchain después de que la transacción se confirme.