Разработчики · Base

Создайте мини-приложение Base для вывода USDC.

Используйте это, когда вашему Base-приложению нужна сфокусированная поверхность вывода, а не полноценная панель кошелька. Шаблон намеренно мал: одна форма, один wallet client, один результат депозита.

01

Используйте starter

  1. 1Клонируйте ADWilkinson/usdctofiat-peerlytics-starters и откройте templates/base-mini-app.
  2. 2Укажите NEXT_PUBLIC_APP_URL как публичный HTTPS origin перед тестированием поверхностей discovery.
  3. 3Держите форму компактной: маршрут, сумма, платежный handle, подключение кошелька и результат.
  4. 4Вызывайте offramp(walletClient, params) с integratorId и referralId, чтобы депозиты можно было атрибутировать.
02

Требования Base

Next.js app

Соответствует официальному Base app quickstart и упрощает деплой.

Base Account

Дает пользователям Base-native путь подключения через @base-org/account.

Viem WalletClient

Off-ramp SDK подписывает через wallet client, который вы предоставляете.

Builder Code

Атрибутирует onchain-активность после регистрации приложения на Base.dev.

Тест реальной транзакции

Production build недостаточен; проверьте небольшой депозит на Base от начала до конца.

03

Не расширяйте поверхность

  • Не добавляйте маркетинговый hero перед формой вывода.
  • Не прячьте платежный маршрут, сумму или handle за onboarding-текстом.
  • Не обещайте гарантированную скорость fill; ликвидность по-прежнему зависит от спроса покупателей.
  • Не добавляйте Builder Code wiring, пока не существует реального кода.

Common questions

Что мини-приложение Base должно делать первым?

Оно должно создавать реальный seller deposit USDCtoFiat из подключенного кошелька Base Account. Начните с суммы, маршрута, платежного handle и результата депозита, прежде чем добавлять что-либо еще.

Нужен ли мини-приложению Base отдельный backend?

Не для базового cash-out flow. Кошелек подписывает на клиенте, а @usdctofiat/offramp создает депозит на Base. Добавляйте backend только если нужны account state, webhooks или собственная база ордеров.

Когда добавлять Builder Code?

После регистрации приложения на Base.dev и получения реального кода. До этого держите интеграцию готовой к атрибуции, но не выпускайте placeholder code так, будто он верифицирован.