Recuperación de Activos

En resumen
La API de Recuperación de Activos de Blockradar le permite recuperar activos que fueron enviados accidentalmente a la dirección correcta en la blockchain incorrecta. Soporta moneda nativa y activos personalizados (ERC-20 y estándares compatibles) en todas las redes soportadas.

¿Qué es la Recuperación de Activos?

La recuperación de activos le permite recuperar fondos que fueron enviados a la dirección de billetera correcta pero en la red blockchain incorrecta. Esto comúnmente ocurre cuando:

Los usuarios envían activos en Ethereum pero querían enviar en Polygon
Los activos se envían en BNB Smart Chain en lugar de Arbitrum
Cualquier confusión de direcciones entre cadenas donde la misma dirección existe en múltiples redes compatibles con EVM

Dado que las blockchains compatibles con EVM comparten el mismo formato de dirección, la misma dirección puede recibir activos en múltiples redes. La recuperación de activos le permite acceder a estos fondos programáticamente.

Para una guía detallada sobre conceptos de recuperación de activos y uso del panel, lea nuestro artículo: Cómo Recuperar Activos Enviados a la Blockchain Incorrecta

Prerrequisitos

Antes de usar la API de Recuperación de Activos, asegúrese de tener:

Clave API

Obtenga su clave API desde el Panel de Blockradar. Navegue a Configuración → Claves API para generar una.

Billetera Creada

Cree una billetera a través de la API Crear Billetera o el panel. Necesitará el walletId para operaciones de recuperación.

ID de Blockchain

Obtenga el blockchainId para la red donde los activos están atrapados. Puede encontrarlo en el panel o a través de la API Obtener Blockchains.

Saldo de Moneda Nativa

Asegúrese de que la dirección emisora tenga suficiente moneda nativa (ETH, BNB, MATIC, etc.) en la blockchain de recuperación para cubrir las tarifas de gas.

Cómo Funciona

La API de Recuperación de Activos transfiere activos desde una dirección emisora (donde los activos están atrapados) a una dirección receptora en la misma blockchain:

Recuperación de Moneda Nativa

Recupere moneda nativa como ETH, BNB, MATIC o AVAX enviada a la red incorrecta.

Recuperación de Activos Personalizados

Recupere activos ERC-20 y compatibles especificando la dirección del contrato.

Estimación de Tarifas

Calcule las tarifas de red antes de la ejecución para asegurar saldo suficiente.

Soporte de RPC Personalizado

Recupere activos en blockchains no soportadas proporcionando su propio endpoint RPC.

Blockchains Soportadas

La recuperación de activos está disponible en todas las blockchains soportadas por Blockradar, incluyendo redes compatibles con EVM, Tron y Solana. Consulta Integraciones para la lista completa de redes soportadas y enlaces de faucets.

Para redes EVM no soportadas directamente, puede proporcionar una URL RPC personalizada y opcionalmente habilitar el modo Layer 2 para redes basadas en rollup.

Comience con testnets durante el desarrollo para evitar gastar fondos reales.

Recuperar Activos

Inicie una operación de recuperación de activos para transferir activos atrapados a una dirección receptora.

Parámetros de Solicitud

Parámetro	Tipo	Requerido	Descripción
`senderAddress`	string	Sí	La dirección de Blockradar donde los activos están actualmente atrapados.
`recipientAddress`	string	Sí	La dirección de destino donde se enviarán los activos recuperados.
`amount`	string	Sí	La cantidad a recuperar. Use la cantidad completa o una porción.
`blockchainId`	string (UUID)	Sí	El UUID de blockchain donde ocurrirá la recuperación. Obténgalo de la API Obtener Blockchains.
`tokenAddress`	string	No	Dirección del contrato para recuperación de activos personalizados. Omita para moneda nativa.
`rpcUrl`	string	No	Endpoint RPC personalizado para blockchains no soportadas.
`isL2`	boolean	No	Establezca en `true` si la URL RPC apunta a una red Layer 2.

Recuperación de Moneda Nativa

Recupere moneda nativa (ETH, BNB, MATIC, etc.) de la red incorrecta:

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: TU_CLAVE_API' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "0.5",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa"
  }'

Recuperación de Activos Personalizados

Recupere activos ERC-20 o compatibles especificando la dirección del contrato:

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: TU_CLAVE_API' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "100",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
    "tokenAddress": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"
  }'

Recuperación con RPC Personalizado

Recupere activos en blockchains no soportadas proporcionando su propio endpoint RPC:

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: TU_CLAVE_API' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "0.5",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
    "rpcUrl": "https://rpc.custom-network.io",
    "isL2": true
  }'

Respuesta Exitosa

{
  "message": "Salvage asset initiated successfully",
  "statusCode": 200
}

Estimación de Tarifas de Red

Antes de ejecutar una recuperación, estime las tarifas de red para asegurar saldo suficiente.

Solicitud de Estimación de Tarifas

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/salvage/network-fee \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: TU_CLAVE_API' \
  --data '{
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "amount": "0.5",
    "blockchainId": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa"
  }'

Parámetros de Respuesta de Tarifas

Parámetro	Descripción
`networkFee`	Tarifa de gas estimada en unidades de moneda nativa
`networkFeeInUSD`	Tarifa de gas convertida a USD
`nativeBalance`	Saldo actual de moneda nativa del emisor
`nativeBalanceInUSD`	Saldo nativo convertido a USD

Siempre estime las tarifas antes de ejecutar operaciones de recuperación. La dirección emisora debe tener suficiente moneda nativa para cubrir las tarifas de gas en la blockchain de recuperación.

Webhooks

Suscríbase a eventos de webhook para recibir notificaciones en tiempo real sobre operaciones de recuperación.

Eventos de Recuperación

Evento	Descripción
`salvage.success`	Se activa cuando una operación de recuperación se completa exitosamente.
`salvage.failed`	Se activa cuando una operación de recuperación falla debido a fondos insuficientes, problemas de red u otros errores.
`salvage.cancelled`	Se activa cuando una operación de recuperación es cancelada antes de completarse.

Payload del Webhook

{
  "event": "salvage.success",
  "data": {
    "id": "txn_abc123",
    "type": "SALVAGE",
    "status": "SUCCESS",
    "amount": "0.5",
    "senderAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "recipientAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
    "blockchain": "polygon-mainnet",
    "txHash": "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba",
    "networkFee": "0.001",
    "createdAt": "2025-01-12T10:30:00Z"
  }
}

Configure webhooks en el Panel de Blockradar bajo Configuración → Webhooks. Vea la documentación de Webhooks para instrucciones de configuración.

Casos de Uso Comunes

Usuario envió USDC en red incorrecta

Un usuario quería enviar USDC en Ethereum pero accidentalmente lo envió en Polygon. Como la dirección es la misma, los fondos llegaron a Polygon. Use la recuperación de activos con la dirección del contrato USDC en Polygon para recuperar los fondos.

ETH enviado a Arbitrum en lugar de Ethereum

Un usuario hizo bridge de ETH a Arbitrum pero lo envió a una dirección de Blockradar. La misma dirección existe en Arbitrum debido a la compatibilidad EVM. Recupere el ETH de Arbitrum usando la recuperación de moneda nativa.

Activo personalizado en Layer 2

Un usuario envió un activo ERC-20 personalizado en una red L2 como Optimism. Proporcione la dirección del contrato del activo y use la API de recuperación para recuperarlo.

Activos en red no soportada

Los activos están atrapados en una blockchain no soportada directamente por Blockradar. Proporcione su propio endpoint RPC y establezca isL2: true si es un rollup para recuperar los fondos.

Manejo de Errores

Saldo Nativo Insuficiente

{
  "error": "Insufficient native balance for gas",
  "code": "INSUFFICIENT_GAS",
  "details": {
    "required": "0.01",
    "available": "0.001",
    "currency": "MATIC"
  }
}

Solución: Financie la dirección emisora con suficiente moneda nativa para cubrir las tarifas de gas antes de reintentar.

Dirección Emisora Inválida

{
  "error": "Sender address not found in wallet",
  "code": "INVALID_SENDER"
}

Solución: Asegúrese de que la dirección emisora pertenezca a su billetera Blockradar y sea una dirección hija válida.

Activo No Encontrado

{
  "error": "No balance found for specified asset",
  "code": "ASSET_NOT_FOUND",
  "details": {
    "tokenAddress": "0x...",
    "blockchain": "polygon-mainnet"
  }
}

Solución: Verifique la dirección del contrato y la blockchain. Use un explorador de bloques para confirmar que el activo existe en la dirección emisora.

Conexión RPC Fallida

{
  "error": "Failed to connect to custom RPC",
  "code": "RPC_ERROR"
}

Solución: Verifique que su URL RPC sea correcta y accesible. Asegúrese de que soporte los métodos JSON-RPC requeridos.

Mejores Prácticas

Siempre Estime Tarifas Primero

Use el endpoint de tarifas de red antes de la recuperación para asegurar saldo de gas suficiente y mostrar costos precisos.

Verifique Direcciones

Verifique las direcciones emisora y receptora usando un explorador de bloques antes de iniciar la recuperación.

Use Webhooks

Configure webhooks para recibir actualizaciones de estado en tiempo real en lugar de consultar la API.

Pruebe en Testnet

Pruebe su integración de recuperación en testnet antes de usarla en producción.

Referencia API

Endpoint	Descripción
Salvage	Iniciar operación de recuperación de activos
Salvage Network Fee	Estimar tarifas de red para recuperación

¡Feliz recuperación!

Comenzar

Esenciales

Recuperación de Activos

¿Qué es la Recuperación de Activos?

Prerrequisitos

Cómo Funciona

Recuperación de Moneda Nativa

Recuperación de Activos Personalizados

Estimación de Tarifas

Soporte de RPC Personalizado

Blockchains Soportadas

Recuperar Activos

Parámetros de Solicitud

Recuperación de Moneda Nativa

Recuperación de Activos Personalizados

Recuperación con RPC Personalizado

Respuesta Exitosa

Estimación de Tarifas de Red

Solicitud de Estimación de Tarifas

Parámetros de Respuesta de Tarifas

Webhooks

Eventos de Recuperación

Payload del Webhook

Casos de Uso Comunes

Manejo de Errores

Mejores Prácticas

Siempre Estime Tarifas Primero

Verifique Direcciones

Use Webhooks

Pruebe en Testnet

Referencia API

Comenzar

Esenciales

​¿Qué es la Recuperación de Activos?

​Prerrequisitos

​Cómo Funciona

Recuperación de Moneda Nativa

Recuperación de Activos Personalizados

Estimación de Tarifas

Soporte de RPC Personalizado

​Blockchains Soportadas

​Recuperar Activos

​Parámetros de Solicitud

​Recuperación de Moneda Nativa

​Recuperación de Activos Personalizados

​Recuperación con RPC Personalizado

​Respuesta Exitosa

​Estimación de Tarifas de Red

​Solicitud de Estimación de Tarifas

​Parámetros de Respuesta de Tarifas

​Webhooks

​Eventos de Recuperación

​Payload del Webhook

​Casos de Uso Comunes

​Manejo de Errores

​Mejores Prácticas

Siempre Estime Tarifas Primero

Verifique Direcciones

Use Webhooks

Pruebe en Testnet

​Referencia API

¿Qué es la Recuperación de Activos?

Prerrequisitos

Cómo Funciona

Blockchains Soportadas

Recuperar Activos

Parámetros de Solicitud

Recuperación de Moneda Nativa

Recuperación de Activos Personalizados

Recuperación con RPC Personalizado

Respuesta Exitosa

Estimación de Tarifas de Red

Solicitud de Estimación de Tarifas

Parámetros de Respuesta de Tarifas

Webhooks

Eventos de Recuperación

Payload del Webhook

Casos de Uso Comunes

Manejo de Errores

Mejores Prácticas

Referencia API