개발자 · Base

표준 웹 도구로 Base App 현금화 흐름을 구축하세요.

호환성을 위해 경로와 스타터 디렉터리는 base-mini-app 이름을 유지하지만, 대상은 Base App의 인앱 브라우저와 모든 최신 모바일 브라우저에서 작동하는 표준 웹 앱입니다.

01

기존 스타터 사용

  1. 01ADWilkinson/usdctofiat-peerlytics-starters를 클론하고 templates/base-mini-app을 여세요.
  2. 02NEXT_PUBLIC_APP_URL을 설정하고 안정적인 공개 HTTPS 오리진에 앱을 배포하세요.
  3. 03폼은 경로, 금액, 지급 handle, 지갑 연결, 결과만 포함해 간결하게 유지하세요.
  4. 04배포된 URL과 앱 메타데이터를 Base.dev에 등록하고 Farcaster 매니페스트는 추가하지 마세요.
02

Base App 요구 사항

Next.js app
Base App의 인앱 브라우저와 일반 모바일 브라우저에서 표준 웹 앱으로 실행됩니다.
Base Account
@base-org/account를 통해 사용자에게 Base-native 연결 경로를 제공합니다.
Viem WalletClient
off-ramp SDK는 제공한 wallet client로 서명합니다.
Builder Code
Base.dev 등록에서 앱 메타데이터, 검색 노출, 발급된 어트리뷰션 코드를 관리합니다.
실제 트랜잭션 테스트
production build만으로는 부족합니다. 작은 Base deposit을 처음부터 끝까지 검증하세요.
03

표준에 맞게 핵심에 집중

  • 현금화 폼 앞에 마케팅 hero를 추가하지 마세요.
  • 지급 경로, 금액, handle을 onboarding copy 뒤에 숨기지 마세요.
  • 보장된 fill speed를 주장하지 마세요. 유동성은 여전히 buyer demand가 결정합니다.
  • Farcaster 매니페스트나 미니 앱 SDK를 추가하지 마세요. Base App 검색 노출에는 Base.dev 메타데이터와 Builder Codes가 사용됩니다.

자주 묻는 질문

Base App 통합에서 가장 먼저 해야 할 일은 무엇인가요?

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

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은 표준 웹 앱과 Base.dev 메타데이터를 사용합니다. 대신 배포된 HTTPS URL, 앱 세부 정보, Builder Code를 Base.dev에 등록하세요.