开发者 · Base

使用标准 Web 工具构建 Base App 兑出流程。

为保持兼容性，路由和起始目录仍使用 base-mini-app 名称，但目标是构建一个可在 Base App 内置浏览器和任何现代移动浏览器中运行的标准 Web 应用。

克隆 Base 模板打开卖出流程
01

使用现有起始模板

  1. 01克隆 ADWilkinson/usdctofiat-peerlytics-starters，并打开 templates/base-mini-app。
  2. 02设置 NEXT_PUBLIC_APP_URL，并将应用部署到稳定的公共 HTTPS 源。
  3. 03保持表单紧凑：路线、金额、收款标识、钱包连接和结果。
  4. 04在 Base.dev 注册已部署的 URL 和应用元数据；不要添加 Farcaster 清单。
02

Base App 要求

Next.js app
作为标准 Web 应用在 Base App 内置浏览器和普通移动浏览器中运行。
Base Account
通过 @base-org/account 为用户提供 Base 原生连接路径。
Viem WalletClient
off-ramp SDK 使用你提供的 wallet client 签名。
Builder Code
Base.dev 注册负责管理应用元数据、发现能力和已签发的归因代码。
真实交易测试
生产构建还不够；需要端到端验证一笔小额 Base 存款。
03

保持标准且专注

  • 不要在提现表单前添加营销 hero。
  • 不要把支付路线、金额或标识藏在 onboarding 文案后面。
  • 不要宣称保证成交速度；流动性仍由买方需求决定。
  • 不要添加 Farcaster 清单或小程序 SDK；Base App 发现机制使用 Base.dev 元数据和 Builder Codes。

继续探索

出口匝道 SDKPeerlytics API开发者中心

常见问题

Base App 集成首先应实现什么？

它应该从已连接的 Base Account 钱包创建一笔真实的 USDCtoFiat 卖方存款。在添加任何其他东西前，先处理金额、路线、收款标识和存款结果。

Base App 集成是否需要单独的后端？

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.

此集成是否需要 Farcaster 清单？

不需要。Base App 使用标准 Web 应用和 Base.dev 元数据。请改为在 Base.dev 注册已部署的 HTTPS URL、应用详情和 Builder Code。