Sviluppatori · Base

Crea una mini app Base per incassare USDC.

Usala quando la tua app Base ha bisogno di una superficie di cash-out mirata invece di una dashboard wallet completa. Il template è volutamente piccolo: un form, un wallet client, un risultato di deposito.

01

Usa lo starter

  1. 1Clona ADWilkinson/usdctofiat-peerlytics-starters e apri templates/base-mini-app.
  2. 2Imposta NEXT_PUBLIC_APP_URL sull origine HTTPS pubblica prima di testare le superfici di discovery.
  3. 3Mantieni il form compatto: route, importo, handle di pagamento, connessione wallet e risultato.
  4. 4Chiama offramp(walletClient, params) con integratorId e referralId per attribuire i depositi.
02

Requisiti specifici di Base

App Next.js

Segue il quickstart ufficiale delle app Base e mantiene semplice il deploy.

Base Account

Offre agli utenti un percorso di connessione nativo Base tramite @base-org/account.

Viem WalletClient

L SDK off-ramp firma con il wallet client che fornisci.

Builder Code

Attribuisce l attività onchain dopo la registrazione dell app su Base.dev.

Test con transazione reale

Un build di produzione non basta; verifica un piccolo deposito Base end to end.

03

Non espandere la superficie

  • Non aggiungere un hero marketing prima del form di cash-out.
  • Non nascondere route di pagamento, importo o handle dietro copy di onboarding.
  • Non promettere velocità di fill garantita; la domanda dei buyer controlla ancora la liquidità.
  • Non aggiungere cablaggio Builder Code finché non esiste il codice reale.

Common questions

Cosa deve fare prima la mini app Base?

Deve creare un vero deposito seller USDCtoFiat da un wallet Base Account connesso. Inizia con importo, route, handle di pagamento e risultato del deposito prima di aggiungere altro.

La mini app Base ha bisogno di un backend separato?

Non per il flusso base di cash-out. Il wallet firma dal client e @usdctofiat/offramp crea il deposito Base. Aggiungi un backend solo quando servono stato account, webhooks o il tuo database ordini.

Quando devo aggiungere un Builder Code?

Dopo aver registrato l app su Base.dev e ricevuto il codice reale. Fino ad allora, tieni pronta l integrazione per l attribuzione, ma non pubblicare codice placeholder come se fosse verificato.