Développeurs · Base

Créez un parcours de retrait dans Base App avec des outils web standard.

La route et le répertoire de démarrage conservent le nom base-mini-app pour des raisons de compatibilité, mais la cible est une application web standard qui fonctionne dans le navigateur intégré de Base App et dans tout navigateur mobile moderne.

Cloner le modèle BaseOuvrir le flux de vente
01

Utiliser le projet de démarrage existant

  1. 01Clonez ADWilkinson/usdctofiat-peerlytics-starters et ouvrez templates/base-mini-app.
  2. 02Définissez NEXT_PUBLIC_APP_URL et déployez l’application sur une origine HTTPS publique et stable.
  3. 03Gardez le formulaire compact : route, montant, identifiant de paiement, connexion wallet et résultat.
  4. 04Enregistrez l’URL déployée et les métadonnées de l’application sur Base.dev ; n’ajoutez pas de manifeste Farcaster.
02

Exigences de Base App

App Next.js
Fonctionne comme une application web standard dans le navigateur intégré de Base App et dans les navigateurs mobiles classiques.
Base Account
Donne aux utilisateurs un chemin de connexion natif Base via @base-org/account.
Viem WalletClient
Le SDK d off-ramp signe avec le client wallet que vous fournissez.
Builder Code
L’enregistrement sur Base.dev gère les métadonnées, la visibilité de l’application et le code d’attribution émis.
Test de transaction réelle
Un build de production ne suffit pas ; vérifiez un petit dépôt Base de bout en bout.
03

Rester standard et ciblé

  • N ajoutez pas de hero marketing avant le formulaire d encaissement.
  • Ne cachez pas la route de paiement, le montant ou l identifiant derrière du texte d onboarding.
  • Ne promettez pas une vitesse de remplissage garantie ; la demande des acheteurs contrôle toujours la liquidité.
  • N’ajoutez ni manifeste Farcaster ni SDK de mini-application ; la visibilité dans Base App repose sur les métadonnées de Base.dev et les Builder Codes.

Poursuivre l’exploration

SDK d’off-rampAPI PeerlyticsEspace développeurs

Questions fréquentes

Que doit faire l’intégration Base App en premier ?

Elle doit créer un vrai dépôt vendeur USDCtoFiat depuis un wallet Base Account connecté. Commencez par le montant, la route, l identifiant de paiement et le résultat du dépôt avant d ajouter autre chose.

L’intégration Base App nécessite-t-elle un backend distinct ?

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.

Cette intégration nécessite-t-elle un manifeste Farcaster ?

Non. Base App utilise des applications web standard et les métadonnées de Base.dev. Enregistrez plutôt l’URL HTTPS déployée, les informations de l’application et le Builder Code sur Base.dev.