Créez une mini app Base pour encaisser des USDC.
Utilisez cela lorsque votre app Base a besoin d une surface d encaissement ciblée plutôt que d un tableau de bord wallet complet. Le modèle est volontairement petit : un formulaire, un client wallet et un résultat de dépôt.
Utiliser le starter
- 1Clonez ADWilkinson/usdctofiat-peerlytics-starters et ouvrez templates/base-mini-app.
- 2Définissez NEXT_PUBLIC_APP_URL sur l origine HTTPS publique avant de tester les surfaces de découverte.
- 3Gardez le formulaire compact : route, montant, identifiant de paiement, connexion wallet et résultat.
- 4Appelez offramp(walletClient, params) avec integratorId et referralId pour que les dépôts puissent être attribués.
Exigences propres à Base
App Next.js
Correspond au quickstart officiel des apps Base et garde le déploiement simple.
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
Attribue l activité onchain après l enregistrement de l app sur Base.dev.
Test de transaction réelle
Un build de production ne suffit pas ; vérifiez un petit dépôt Base de bout en bout.
Ne pas élargir la surface
- 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 pas le câblage Builder Code tant que le vrai code n existe pas.
Keep exploring
Common questions
Que doit faire la mini app Base 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.
La mini app Base a-t-elle besoin d un backend séparé ?
Pas pour le flux d encaissement de base. Le wallet signe côté client et @usdctofiat/offramp crée le dépôt Base. Ajoutez un backend seulement si vous avez besoin d état de compte, de webhooks ou de votre propre base d ordres.
Quand dois-je ajouter un Builder Code ?
Après avoir enregistré l app sur Base.dev et reçu le vrai code. Jusque-là, gardez l intégration prête pour l attribution, mais ne publiez pas de code placeholder comme s il était vérifié.