개발자 · Base

USDC 현금화를 위한 Base mini app을 만드세요.

Base 앱에 전체 지갑 대시보드가 아니라 집중된 현금화 화면이 필요할 때 사용하세요. 템플릿은 의도적으로 작습니다: 폼 하나, wallet client 하나, deposit 결과 하나.

Base 템플릿 클론하기판매 흐름 열기
01

스타터 사용

  1. 1ADWilkinson/usdctofiat-peerlytics-starters를 클론하고 templates/base-mini-app을 여세요.
  2. 2Discovery surfaces를 테스트하기 전에 NEXT_PUBLIC_APP_URL을 공개 HTTPS origin으로 설정하세요.
  3. 3폼은 경로, 금액, 지급 handle, 지갑 연결, 결과만 포함해 간결하게 유지하세요.
  4. 4deposit을 attribution할 수 있도록 integratorId와 referralId를 넣어 offramp(walletClient, params)를 호출하세요.
02

Base 전용 요구사항

Next.js app

공식 Base app quickstart와 맞고 배포를 단순하게 유지합니다.

Base Account

@base-org/account를 통해 사용자에게 Base-native 연결 경로를 제공합니다.

Viem WalletClient

off-ramp SDK는 제공한 wallet client로 서명합니다.

Builder Code

앱이 Base.dev에 등록된 후 onchain activity를 attribution합니다.

실제 트랜잭션 테스트

production build만으로는 부족합니다. 작은 Base deposit을 처음부터 끝까지 검증하세요.

03

화면을 확장하지 마세요

  • 현금화 폼 앞에 마케팅 hero를 추가하지 마세요.
  • 지급 경로, 금액, handle을 onboarding copy 뒤에 숨기지 마세요.
  • 보장된 fill speed를 주장하지 마세요. 유동성은 여전히 buyer demand가 결정합니다.
  • 실제 코드가 존재하기 전에는 Builder Code wiring을 추가하지 마세요.

Keep exploring

Offramp SDKWebhooksDeveloper hub

Common questions

Base mini app은 먼저 무엇을 해야 하나요?

연결된 Base Account wallet에서 실제 USDCtoFiat seller deposit을 만들어야 합니다. 다른 것을 추가하기 전에 금액, 경로, 지급 handle, deposit 결과부터 시작하세요.

Base mini app에 별도 backend가 필요한가요?

기본 현금화 흐름에는 필요하지 않습니다. wallet은 client에서 서명하고 @usdctofiat/offramp가 Base deposit을 만듭니다. account state, webhooks, 자체 order database가 필요할 때만 backend를 추가하세요.

Builder Code는 언제 추가해야 하나요?

Base.dev에 앱을 등록하고 실제 코드를 받은 뒤입니다. 그 전까지는 attribution 준비만 해두고, placeholder code를 검증된 것처럼 배포하지 마세요.