Desenvolvedores · Base

Crie um fluxo de saque no Base App com ferramentas web padrão.

A rota e o diretório inicial mantêm o nome base-mini-app por compatibilidade, mas o objetivo é um aplicativo web padrão que funcione no navegador integrado do Base App e em qualquer navegador móvel moderno.

01

Use o projeto inicial existente

  1. 01Clone ADWilkinson/usdctofiat-peerlytics-starters e abra templates/base-mini-app.
  2. 02Defina NEXT_PUBLIC_APP_URL e implante o aplicativo em uma origem HTTPS pública e estável.
  3. 03Mantenha o formulário compacto: rota, valor, identificador de pagamento, conexão da carteira e resultado.
  4. 04Registre a URL implantada e os metadados do aplicativo no Base.dev; não adicione um manifesto Farcaster.
02

Requisitos do Base App

App Next.js
Funciona como um aplicativo web padrão no navegador integrado do Base App e em navegadores móveis comuns.
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
O registro no Base.dev gerencia os metadados, a descoberta do aplicativo e o código de atribuição emitido.
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

Mantenha o fluxo padrão e objetivo

  • 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 um manifesto Farcaster nem um SDK de miniaplicativo; Base App usa os metadados do Base.dev e os Builder Codes para descoberta.

Perguntas comuns

O que a integração com Base App 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 integração com Base App precisa de um backend separado?

Not for the basic cash-out flow. The wallet signs through the client and @usdctofiat/offramp creates the Base deposit. Add a backend only when you need account state or your own order database.

Esta integração precisa de um manifesto Farcaster?

Não. Base App usa aplicativos web padrão e os metadados do Base.dev. Registre no Base.dev a URL HTTPS implantada, os detalhes do aplicativo e o Builder Code.