Desarrolladores · Apps
Crea un flujo de venta de USDC que los usuarios sí puedan terminar.
Una buena app de off-ramp es, sobre todo, una gestión de estado aburrida: recoge la ruta, deja que la wallet firme, recupera los métodos de pago con extensión, muestra un enlace al depósito y reconcilia los eventos del ciclo de vida después de que la pestaña se cierre.
01
Vía de frontend
- 1Recoge el importe, la plataforma de pago, la moneda fiat y el identificador de cobro.
- 2Pasa el WalletClient de viem conectado a useOfframp() o createOfframp({ walletClient }).
- 3Muestra los estados de progreso: aprobando, registrando, depositando, confirmando, delegando, restringiendo, reanudando, hecho.
- 4Captura EXTENSION_REGISTRATION_REQUIRED para PayPal y Wise, y luego dirige usePeerExtensionRegistration(platform).
- 5Llama a deposits(address) al cargar la página para que un refresco no deje varado a un vendedor con una operación en curso.
02
Estado que deberías guardar
| Campo | Motivo |
|---|---|
| depositId | Identificador principal para close(), enlaces OTC y soporte |
| txHash | Prueba de que el usuario firmó y transmitió la transacción del depósito |
| platform + currency | Visualización de la ruta, soporte y segmentación analítica |
| etiqueta del identificador | Referencia de cobro legible; no guardes secretos |
| integratorId | Atribución estable para la telemetría de producto y el soporte |
03
Restricciones de UX
- El SDK apunta a la mainnet de Base; no hay sandbox público. Prueba con el mínimo de 1 USDC.
- Cada depósito creado por el SDK delega la fijación de precios al vault de Delegate. No presentes controles manuales de tasa para esta vía.
- El fiat queda fuera del SDK. El comprador y el vendedor liquidan directamente dentro de la app de pago seleccionada.
- Trata los webhooks como pistas del ciclo de vida y luego reconcilia el estado acotado del titular con deposits(); usa la API de Peerlytics para datos de mercado y analíticas más amplios.
Keep exploring
Common questions
¿Una app de wallet debería usar la función independiente o el hook de React?
Usa el hook de React cuando quieras estado integrado de carga, progreso, error y resultado. Usa createOfframp({ walletClient }) cuando tu app tenga su propia máquina de estados.
¿Qué debería mostrar cuando PayPal o Wise fallan el registro?
Captura EXTENSION_REGISTRATION_REQUIRED, pide al usuario que instale o conecte la extensión Peer, completa la captura de credenciales de vendedor mediante usePeerExtensionRegistration() y luego reintenta el depósito original.