Saltar al contenido principal
En pocas palabras
Para aprovechar la infraestructura de billeteras de Blockradar y permitir depósitos y pagos sin problemas para tus clientes, necesitas crear al menos una billetera principal.
Wallets Home

​
Introducción

Las billeteras principales son la columna vertebral de la mayoría de las acciones que puedes realizar con la API de Blockradar. Estas billeteras te permiten gestionar depósitos de stablecoins en múltiples blockchains compatibles con Blockradar. Para ver la lista de blockchains y activos compatibles en Blockradar. Cuando creas una billetera principal para una blockchain específica, te permite gestionar todo lo relacionado con esa blockchain con la billetera principal:
  1. Generar direcciones dedicadas para que tus clientes las usen para depositar stablecoins en múltiples blockchains.
  2. Añadir a la lista blanca direcciones gestionadas externamente para el monitoreo de depósitos de stablecoins.
  3. Barrido automático: cada stablecoin depositada en cualquiera de las direcciones dedicadas se barre automáticamente a la billetera principal.
  4. Retiros: puedes iniciar fácilmente retiros de stablecoins desde la dirección de la billetera principal a una dirección externa.

​
Crear una Billetera

La creación de una billetera principal requiere cuatro pasos:
  1. Selecciona la blockchain para la que deseas crear la billetera.
  2. Agrega las stablecoins que necesitas que esta billetera principal admita.
  3. Configura la URL del webhook de tu billetera. Esto se utilizará para notificaciones y sincronización de datos cuando se depositen stablecoins en cualquiera de las direcciones dedicadas generadas a través de esta billetera.
  4. Financia la billetera principal. Para habilitar el barrido automático de stablecoins desde las direcciones dedicadas a la billetera principal y el retiro a direcciones externas, necesitas mantener un saldo del activo nativo en la blockchain en esta billetera principal.
Una dirección dedicada generada a través de cualquiera de estas billeteras principales puede usarse para recibir depósitos en todas las demás billeteras principales de blockchain, siempre que las blockchains tengan isEvmCompatible: true.Esto significa que puedes emitir a tus clientes una única dirección única que se puede usar para depositar stablecoins en múltiples blockchains, sin preocuparte de que envíen stablecoins a la blockchain incorrecta.

​
Crear una Billetera Principal

Para crear una billetera principal, ve al panel de control, navega a la sección de billeteras y crea una billetera para comenzar a construir una experiencia sin problemas para tus clientes. El panel de control de Blockradar proporciona una interfaz simple y fácil de usar para generar billeteras principales. Create Wallet
Esta captura de pantalla demuestra el proceso de generar una nueva billetera principal a través del panel de control de Blockradar. Este método es ideal para la creación manual de direcciones o para equipos que prefieren una interfaz gráfica.
Entorno
Las billeteras creadas en el entorno en vivo están aisladas a ese entorno. Lo mismo se aplica a las billeteras creadas en el entorno de prueba, incluidas las direcciones dedicadas creadas para tus clientes.

​
Configuraciones de Billetera

Las billeteras principales de Blockradar admiten dos opciones de configuración clave para ayudarte a gestionar fondos y la experiencia del usuario: Barrido Automático y Transacciones Sin Gas.

​
Barrido Automático

Habilitar Cuando está habilitado, los fondos depositados en direcciones bajo esta billetera se barrerán automáticamente (transferirán) a la billetera principal. Esto ayuda a consolidar saldos, mejora la seguridad y simplifica la gestión de fondos. Umbral Establece el saldo mínimo requerido para cada dirección secundaria para activar el barrido automático. Si se deja vacío, cualquier cantidad recibida activará un barrido automático. Esto te permite controlar con qué frecuencia ocurre el barrido y optimizar las tarifas de gas.
  • Configuración Predeterminada: Por defecto, el barrido automático está establecido en verdadero y el umbral es 0
  • Anulación de Dirección: Al generar o actualizar una dirección, puedes anular tanto la configuración de habilitar/deshabilitar el barrido automático como el umbral para esa dirección específica.
Las configuraciones de auto-sweeping y threshold a nivel de direcciones anularán la configuración de la billetera principal para esa dirección. Esto permite un control granular sobre el comportamiento del barrido automático por dirección.
Mejor Práctica: Habilita el barrido automático y establece un umbral apropiado para equilibrar entre la consolidación oportuna de fondos y la minimización de las tarifas de transacción. Auto Sweeping

​
Transacciones Sin Gas

Configura cuándo la billetera principal debe cubrir las tarifas de gas para retiros desde direcciones secundarias. Habilitar Retiros Sin Gas Cuando está habilitado, las tarifas de gas para retiros calificados serán pagadas por la billetera principal, proporcionando una experiencia sin problemas para tus usuarios. Configuraciones de Umbral Establece el umbral de cantidad para retiros sin gas. Solo las transacciones que cumplan con este umbral tendrán sus tarifas de gas cubiertas por la billetera principal. Puedes especificar la lógica de umbral usando operadores aritméticos:
OperadorDescripciónEjemplo (Umbral = 100)
gtMayor queSolo retiros > 100
gteMayor o igual queSolo retiros ≥ 100
ltMenor queSolo retiros < 100
lteMenor o igual queSolo retiros ≤ 100
eqIgual aSolo retiros = 100
  • Configuración Predeterminada: La transacción sin gas está establecida en false por defecto y las configuraciones de umbral están establecidas en 0.
  • Anulación de Dirección: Al generar o actualizar una dirección, puedes anular tanto la configuración de habilitar/deshabilitar como las configuraciones de umbral para transacciones sin gas para esa dirección específica.
La configuración de habilitar gasless transaction y threshold a nivel de direcciones anulará la configuración de la billetera principal para esa dirección. Esto permite un control granular sobre el comportamiento de retiro sin gas por dirección.
Mejor Práctica: Habilita los retiros sin gas y establece una lógica de umbral apropiada para equilibrar la experiencia del usuario y los costos operativos.
  • Establece configuraciones a nivel de billetera según tus necesidades comerciales y requisitos de seguridad.
  • Usa anulaciones a nivel de dirección solo cuando necesites un comportamiento diferente para direcciones específicas.
Gasless Transaction

​
Financiamiento

Financiar una billetera principal es esencial para pagar las tarifas de gas en la blockchain cuando se realiza el barrido automático de stablecoins desde las direcciones dedicadas a la billetera principal y para retiros a billeteras externas.

​
Entorno de Prueba

  • Ethereum: Obtén ETH de prueba aquí: Alchemy o Infura
  • Binance Smart Chain: Obtén BNB de prueba aquí: Faucet
  • Polygon: Obtén MATIC de prueba aquí: Polygon PoS (Amoy)
  • Base: Obtén ETH de prueba aquí: Alchemy
  • Optimism: Obtén ETH de prueba aquí: Alchemy
  • Arbitrum: Obtén ETH de prueba aquí: Alchemy
  • Tron: Obtén TRX de prueba aquí: Faucet
  • Solana: Obtén SOL de prueba aquí: Faucet
  • Celo: Obtén CELO de prueba aquí: Faucet

​
Entorno en Vivo

Para el entorno en vivo, puedes enviar activos desde cualquier billetera o exchange que admita los activos nativos en cada una de las blockchains.
Barrido
Siempre asegúrate de tener suficiente saldo en tu billetera principal para evitar retrasos en el barrido automático o retiros. Te notificaremos cuando el saldo de tu billetera principal sea bajo.

​
Tarifas de Gas: Entorno de Prueba vs. Entorno en Vivo

Comprender las diferencias en las tarifas de gas entre entornos de prueba y en vivo es crucial para el desarrollo y despliegue eficiente.

​
Tarifas de Gas de Prueba

En el entorno de prueba, las tarifas de gas son mínimas. Las redes de prueba están diseñadas para simular el entorno de la red principal sin los costos asociados del mundo real. Como resultado, pequeñas cantidades de tokens de gas en una red de prueba se pueden usar durante un período prolongado. Esto permite a los desarrolladores probar e iterar su integración sin incurrir en gastos significativos.

​
Tarifas de Gas en Vivo

En un entorno de prueba, las tarifas de gas representan gastos del mundo real. Estos costos pueden variar significativamente según la blockchain y la congestión de la red. Estimar y gestionar adecuadamente las tarifas de gas es esencial para garantizar el funcionamiento fluido de tus aplicaciones y evitar costos excesivos. Al aprovechar las redes de prueba para desarrollo y pruebas, puedes minimizar los gastos y asegurarte de que tus soluciones sean robustas antes de implementarlas en la red principal.

​
Buscador de Depósitos

En casos raros, es posible que no recibas un webhook de nuestro sistema después de que un cliente envíe stablecoins a cualquiera de las direcciones emitidas para ellos. Tenemos un mecanismo de buscador de depósitos incorporado internamente, pero también tienes la capacidad de activar un reescaneo de la blockchain para una transacción faltante usando la API de Buscador de Depósitos proporcionando el transactionHash 
curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{id}/rescan/blocks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "transactionHash": "string<TRANSACTION_HASH_OPTIONAL>"
}'
Parámetros del cuerpo
El parámetro requerido es transactionHash, que se puede obtener del registro de transacción original o buscando la transacción en el explorador de blockchain.


¡Feliz programación! ❤️