Desarrolladores · Base

Verifica la atribución de Builder Code para los depósitos de USDCtoFiat.

El código emitido está integrado en la calldata de las transacciones de la aplicación de producción. Usa esta guía para saber qué ruta controla el sufijo y qué debes verificar después de una transacción.

Empezar con la plantilla de BaseAbrir el flujo de venta
01

Secuencia de atribución

  1. 01Despliega la Base Mini App en un origen HTTPS estable.
  2. 02Registra y verifica la app en Base.dev.
  3. 03Copia el Builder Code real desde la configuración de Base.dev.
  4. 04Genera el dataSuffix ERC-8021 desde ese código con ox/erc8021.
  5. 05En una ruta de transacción directa que controles, añade un único dataSuffix normalizado después de eliminar cualquier sufijo existente.
  6. 06Crea un pequeño depósito de USDCtoFiat y verifica la atribución antes de lanzar una campaña.
02

Dónde pertenece

SuperficieRuta de atribución
Base AppLa documentación de Base dice que las apps registradas pueden recibir atribución automática por la actividad dentro de Base App.
App webEl adaptador web de USDCtoFiat reemplaza cualquier sufijo existente y añade los códigos de producción.
SDK de USDCtoFiatEl SDK proporciona su propio referente galleonlabs. No añadas un segundo sufijo en el cliente; la API actual del SDK no admite códigos separados para integradores.
ContratosNo hace falta cambiar contratos; los datos de sufijo ERC-8021 se añaden al calldata y se indexan offchain.
03

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.
  • El adaptador de producción de USDCtoFiat está configurado con un Builder Code emitido. Aun así, la atribución correcta debe verificarse en cada transacción.
  • Para las transacciones directas con Viem o Wagmi que controles, genera un único dataSuffix con todos los códigos previstos.
  • No concatenes sufijos ERC-8021 independientes. Analiza y reemplaza el sufijo, o combina los códigos en uno solo antes de firmar.
  • El SDK @usdctofiat/offramp ya proporciona la atribución de Galleon Labs. No ofrece una opción independiente para combinar un Builder Code.
04

Verificación

ComprobaciónCondición de éxito
Base.devLos conteos de transacciones onchain aumentan para el Builder Code de la app.
Explorador de bloquesLa entrada de la transacción termina con el marcador de sufijo ERC-8021 y se decodifica al código esperado.
Resultado de USDCtoFiatEl depósito creado devuelve depositId y txHash, y luego aparece en deposits(address).
PeerlyticsEl ciclo de vida del depósito y el intent puede inspeccionarse cuando la indexación se ponga al día.

Sigue explorando

SDK de offrampAPI de PeerlyticsCentro para desarrolladores

Preguntas frecuentes

¿USDCtoFiat ya usa un Builder Code emitido?

Sí. El adaptador de producción añade su Builder Code emitido a la calldata onchain del depósito. Verifica la atribución correcta en Base.dev o en un explorador de bloques después de una transacción real.

¿@usdctofiat/offramp necesita una opción separada de Builder Code?

No. El SDK ya proporciona un referente galleonlabs y actualmente no ofrece una ruta compatible para combinar un Builder Code independiente. No añadas un segundo sufijo en el cliente.

¿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.