Desenvolvedores · Base

Crie uma mini app Base para sacar USDC.

Use isto quando sua app Base precisar de uma superfície focada de saque em vez de um painel completo de carteira. O template é deliberadamente pequeno: um formulário, um cliente de carteira e um resultado de depósito.

01

Use o starter

  1. 1Clone ADWilkinson/usdctofiat-peerlytics-starters e abra templates/base-mini-app.
  2. 2Defina NEXT_PUBLIC_APP_URL para a origem HTTPS pública antes de testar superfícies de descoberta.
  3. 3Mantenha o formulário compacto: rota, valor, identificador de pagamento, conexão da carteira e resultado.
  4. 4Chame offramp(walletClient, params) com integratorId e referralId para que os depósitos possam ser atribuídos.
02

Requisitos específicos da Base

App Next.js

Segue o quickstart oficial de apps da Base e mantém o deploy simples.

Base Account

Dá aos usuários um caminho de conexão nativo da Base com @base-org/account.

Viem WalletClient

O SDK de off-ramp assina com o cliente de carteira que você fornece.

Builder Code

Atribui atividade onchain depois que a app é registrada na Base.dev.

Teste com transação real

Um build de produção não basta; verifique um pequeno depósito na Base de ponta a ponta.

03

Não expanda a superfície

  • Não adicione um hero de marketing antes do formulário de saque.
  • Não esconda a rota de pagamento, o valor ou o identificador atrás de texto de onboarding.
  • Não prometa velocidade de preenchimento garantida; a demanda dos compradores ainda controla a liquidez.
  • Não adicione integração de Builder Code até que o código real exista.

Common questions

O que a mini app Base deve fazer primeiro?

Ela deve criar um depósito real de vendedor do USDCtoFiat a partir de uma carteira Base Account conectada. Comece com valor, rota, identificador de pagamento e resultado do depósito antes de adicionar qualquer outra coisa.

A mini app Base precisa de um backend separado?

Não para o fluxo básico de saque. A carteira assina pelo cliente e @usdctofiat/offramp cria o depósito na Base. Adicione um backend apenas quando precisar de estado de conta, webhooks ou seu próprio banco de ordens.

Quando devo adicionar um Builder Code?

Depois de registrar a app na Base.dev e receber o código real. Até lá, deixe a integração pronta para atribuição, mas não publique código placeholder como se estivesse verificado.