개발자 · 앱
사용자가 실제로 완료할 수 있는 USDC 판매 흐름을 구축하세요.
좋은 출금 앱은 대부분 지루한 상태 관리입니다. 경로를 수집하고, 지갑이 서명하도록 하고, 익스텐션이 차단된 결제 수단을 복구하고, 예치금 링크를 표시하고, 탭이 닫힌 후 수명 주기 이벤트를 조정합니다.
01
프론트엔드 경로
- 1금액, 결제 플랫폼, 법정화폐, 지급 식별자를 수집합니다.
- 2연결된 viem WalletClient를 useOfframp() 또는 createOfframp({ walletClient })에 전달합니다.
- 3진행 상태를 표시합니다: 승인 중, 등록 중, 입금 중, 확인 중, 위임 중, 제한 중, 재개 중, 완료.
- 4PayPal 및 Wise에 대한 EXTENSION_REGISTRATION_REQUIRED를 포착하고, usePeerExtensionRegistration(platform)을 통해 진행합니다.
- 5페이지 로드 시 deposits(address)를 호출하여 새로고침으로 진행 중인 판매자가 고립되지 않도록 합니다.
02
저장해야 할 상태
| 항목 | 이유 |
|---|---|
| depositId | close(), OTC 링크 및 지원을 위한 기본 핸들 |
| txHash | 사용자가 예치금 트랜잭션을 서명하고 브로드캐스트했다는 증명 |
| platform + currency | 경로 표시, 지원, 분석 세분화 |
| identifier label | 사람이 읽을 수 있는 지급 참조; 비밀 정보는 저장하지 마세요 |
| integratorId | 제품 텔레메트리 및 지원을 위한 안정적인 귀속 |
03
UX 제약사항
- SDK는 Base 메인넷을 대상으로 합니다. 공개 샌드박스가 없습니다. 1 USDC 최솟값으로 테스트하세요.
- SDK가 생성하는 모든 예치금은 Delegate 볼트에 가격 책정을 위임합니다. 이 경로에 대한 수동 환율 제어를 표시하지 마세요.
- 법정화폐는 SDK 밖에 있습니다. 구매자와 판매자는 선택한 결제 앱 내에서 직접 결제합니다.
- 웹훅을 수명 주기 힌트로 처리한 다음 좁은 소유자 상태를 deposits()로 조정합니다. 더 광범위한 시장 데이터 및 분석에는 Peerlytics API를 사용하세요.
Keep exploring
Common questions
지갑 앱은 독립 함수와 React 훅 중 어느 것을 사용해야 하나요?
내장된 로딩, 진행 상황, 오류 및 결과 상태가 필요할 때 React 훅을 사용하세요. 앱에 자체 상태 머신이 있을 때 createOfframp({ walletClient })를 사용하세요.
PayPal 또는 Wise 등록에 실패하면 무엇을 표시해야 하나요?
EXTENSION_REGISTRATION_REQUIRED를 포착하고, 사용자에게 Peer 익스텐션을 설치 또는 연결하도록 안내하고, usePeerExtensionRegistration()을 통해 판매자 자격 증명 캡처를 완료한 다음 원래 예치금을 재시도하세요.