开发者 · Base

构建一个用于提现 USDC 的 Base mini app。

当你的 Base 应用只需要一个聚焦的提现界面，而不是完整的钱包仪表盘时，使用这个方案。模板刻意保持很小：一个表单、一个钱包客户端、一个存款结果。

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

使用 starter

  1. 1克隆 ADWilkinson/usdctofiat-peerlytics-starters，并打开 templates/base-mini-app。
  2. 2在测试发现入口前，将 NEXT_PUBLIC_APP_URL 设置为公开 HTTPS 来源。
  3. 3保持表单紧凑：路线、金额、收款标识、钱包连接和结果。
  4. 4调用带有 integratorId 和 referralId 的 offramp(walletClient, params)，以便存款可以被归因。
02

Base 特定要求

Next.js app

符合官方 Base app quickstart，并保持部署简单。

Base Account

通过 @base-org/account 为用户提供 Base 原生连接路径。

Viem WalletClient

off-ramp SDK 使用你提供的 wallet client 签名。

Builder Code

应用在 Base.dev 注册后，将链上活动归因。

真实交易测试

生产构建还不够；需要端到端验证一笔小额 Base 存款。

03

不要扩展界面

  • 不要在提现表单前添加营销 hero。
  • 不要把支付路线、金额或标识藏在 onboarding 文案后面。
  • 不要宣称保证成交速度；流动性仍由买方需求决定。
  • 在真实代码存在前，不要添加 Builder Code 接线。

Keep exploring

Offramp SDKWebhooksDeveloper hub

Common questions

Base mini app 首先应该做什么？

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

Base mini app 需要单独的后端吗？

基本提现流程不需要。钱包在客户端签名，@usdctofiat/offramp 创建 Base 存款。只有在需要账户状态、webhooks 或自己的订单数据库时才添加后端。

我什么时候应该添加 Builder Code？

在 Base.dev 注册应用并收到真实代码之后。在此之前，让集成为归因做好准备，但不要把 placeholder code 当作已验证代码发布。