Desenvolvedores · Base

Verifique a atribuição do Builder Code nos depósitos do USDCtoFiat.

O código emitido está integrado à calldata das transações do aplicativo de produção. Use este guia para entender qual fluxo controla o sufixo e o que deve ser verificado após uma transação.

Começar pelo template da BaseAbrir o fluxo de venda
01

Sequência de atribuição

  1. 01Implante a Base Mini App em uma origem HTTPS estável.
  2. 02Registre e verifique o app na Base.dev.
  3. 03Copie o Builder Code real nas configurações da Base.dev.
  4. 04Gere o dataSuffix ERC-8021 a partir desse código com ox/erc8021.
  5. 05Em um fluxo de transação direta que você controla, adicione um único dataSuffix normalizado depois de remover qualquer sufixo existente.
  6. 06Crie um pequeno depósito da USDCtoFiat e verifique a atribuição antes de lançar uma campanha.
02

Onde isso pertence

SuperfícieCaminho de atribuição
Base AppA documentação da Base diz que apps registrados podem receber atribuição automática por atividade dentro da Base App.
App webO adaptador web do USDCtoFiat substitui qualquer sufixo existente e adiciona os códigos de produção.
SDK da USDCtoFiatO SDK fornece seu próprio referenciador galleonlabs. Não adicione um segundo sufixo no cliente; a API atual do SDK não oferece suporte a códigos separados de integradores.
ContratosNenhuma alteração de contrato é necessária; os dados de sufixo ERC-8021 são anexados ao calldata e indexados offchain.
03

Notas de implementação

  • Use viem 2.45.0 ou mais novo para o caminho da documentação da Base; este app já usa uma versão mais nova do viem.
  • O adaptador de produção do USDCtoFiat está configurado com um Builder Code emitido. A atribuição correta ainda precisa ser verificada no nível da transação.
  • Para transações diretas com Viem ou Wagmi que você controla, gere um único dataSuffix com todos os códigos pretendidos.
  • Não concatene sufixos ERC-8021 independentes. Analise e substitua o sufixo ou combine os códigos em um único sufixo antes de assinar.
  • O SDK @usdctofiat/offramp já fornece a atribuição da Galleon Labs. Ele não oferece uma opção separada para combinar um Builder Code.
04

Verificação

VerificaçãoCondição de aprovação
Base.devAs contagens de transações onchain aumentam para o Builder Code do app.
Explorador de blocosA entrada da transação termina com o marcador de sufixo ERC-8021 e decodifica para o código esperado.
Resultado da USDCtoFiatO depósito criado retorna depositId e txHash, e depois aparece em deposits(address).
PeerlyticsO ciclo de vida do depósito e do intent pode ser inspecionado depois que a indexação alcançar.

Continue explorando

Offramp SDKPeerlytics APICentro do desenvolvedor

Perguntas comuns

A USDCtoFiat já usa um Builder Code emitido?

Sim. O adaptador de produção adiciona o Builder Code emitido à calldata onchain do depósito. Verifique a atribuição correta no Base.dev ou em um explorador de blocos após uma transação real.

@usdctofiat/offramp precisa de uma opção separada de Builder Code?

Não. O SDK já fornece um referenciador galleonlabs e atualmente não oferece um fluxo compatível para combinar um Builder Code separado. Não adicione um segundo sufixo no cliente.

ERC-8021 muda os contratos ZKP2P?

Não. A documentação da Base descreve Builder Codes como atribuição por sufixo de calldata. Os contratos executam normalmente; a atribuição é lida por indexadores offchain depois que a transação entra na chain.