Prepare a atribuição com Builder Code para depósitos da USDCtoFiat.
Isto é orientação de configuração, não uma afirmação de que a USDCtoFiat já tem um Builder Code emitido. Use quando seu app na Base estiver pronto para atribuir as transações onchain de depósito criadas por @usdctofiat/offramp.
Sequência de atribuição
- 1Implante a Base Mini App em uma origem HTTPS estável.
- 2Registre e verifique o app na Base.dev.
- 3Copie o Builder Code real nas configurações da Base.dev.
- 4Gere o dataSuffix ERC-8021 a partir desse código com ox/erc8021.
- 5Anexe dataSuffix ao cliente Viem ou Wagmi que envia a transação de depósito.
- 6Crie um pequeno depósito da USDCtoFiat e verifique a atribuição antes de lançar uma campanha.
Onde isso pertence
| Superfície | Caminho de atribuição |
|---|---|
| Base App | A documentação da Base diz que apps registrados podem receber atribuição automática por atividade dentro da Base App. |
| App web | Adicione dataSuffix ao cliente de transações para atribuir o uso no navegador fora da Base App. |
| SDK da USDCtoFiat | O SDK assina com o cliente de wallet que você passa, então o sufixo pertence a esse caminho de wallet-client. |
| Contratos | Nenhuma alteração de contrato é necessária; os dados de sufixo ERC-8021 são anexados ao calldata e indexados offchain. |
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.
- Mantenha Builder Codes placeholder fora da produção. Conecte o valor real somente depois que a Base.dev o emitir.
- Para Viem, adicione dataSuffix quando o cliente de wallet for criado.
- Para Wagmi, configure dataSuffix no nível do cliente para que envios e chamadas em lote o herdem.
- Para Privy ou fluxos de smart wallet, use o caminho de wallet/provedor que realmente envia a user operation ou transação.
Verificação
| Verificação | Condição de aprovação |
|---|---|
| Base.dev | As contagens de transações onchain aumentam para o Builder Code do app. |
| Explorador de blocos | A entrada da transação termina com o marcador de sufixo ERC-8021 e decodifica para o código esperado. |
| Resultado da USDCtoFiat | O depósito criado retorna depositId e txHash, e depois aparece em deposits(address). |
| Peerlytics | O ciclo de vida do depósito e do intent pode ser inspecionado depois que a indexação alcançar. |
Keep exploring
Common questions
Posso adicionar agora um Builder Code placeholder?
Não. Mantenha a integração pronta, mas não publique atribuição placeholder. Registre na Base.dev, obtenha o código real e então adicione-o ao caminho do cliente de wallet.
@usdctofiat/offramp precisa de uma opção separada de Builder Code?
Não para o caminho normal de app. O SDK usa o Viem WalletClient que você passa, então a atribuição deve ser anexada a esse cliente ou à camada de wallet/provedor que envia a transação.
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.