Recuperation d'Actifs

En bref
L’API Asset Recovery de Blockradar vous permet de récupérer des actifs envoyés par erreur à la bonne adresse sur la mauvaise blockchain. Elle prend en charge la devise native et les actifs personnalisés (ERC-20 et standards compatibles) sur tous les réseaux pris en charge.

Qu’est-ce que la récupération d’actifs ?

La récupération d’actifs vous permet de récupérer des fonds envoyés à la bonne adresse de portefeuille, mais sur le mauvais réseau blockchain. Cela se produit fréquemment lorsque :

Des utilisateurs envoient des actifs sur Ethereum alors qu’ils voulaient les envoyer sur Polygon
Des actifs sont envoyés sur BNB Smart Chain au lieu d’Arbitrum
Toute confusion d’adresse entre chaînes, lorsque la même adresse existe sur plusieurs réseaux compatibles EVM

Comme les blockchains compatibles EVM partagent le même format d’adresse, une même adresse peut recevoir des actifs sur plusieurs réseaux. La récupération d’actifs vous permet d’accéder à ces fonds par programmation.

Pour un guide détaillé sur les concepts de récupération d’actifs et l’utilisation du tableau de bord, lisez notre article de blog : How to Recover Assets Sent to the Wrong Blockchain

Prérequis

Avant d’utiliser l’API Asset Recovery, assurez-vous de disposer des éléments suivants :

Clé API

Obtenez votre clé API depuis le tableau de bord Blockradar. Rendez-vous dans Developers pour en générer une.

Portefeuille créé

Créez un portefeuille dans le tableau de bord (voir Create a Master Wallet). Vous aurez besoin du walletId pour les opérations de récupération.

Identifiant de blockchain

Récupérez le blockchainId du réseau sur lequel les actifs sont bloqués. Vous le trouverez dans le tableau de bord ou via l’API Get Blockchains.

Solde en devise native

Assurez-vous que l’adresse source dispose de suffisamment de devise native (ETH, BNB, MATIC, etc.) sur la blockchain de récupération pour couvrir les frais de gas.

Comment ça fonctionne

L’API Asset Recovery transfère des actifs depuis une adresse source (où les actifs sont bloqués) vers une adresse de destination sur la même blockchain :

Récupération de devise native

Récupérez une devise native comme ETH, BNB, MATIC ou AVAX envoyée sur le mauvais réseau.

Récupération d'actifs personnalisés

Récupérez des actifs ERC-20 et compatibles en indiquant l’adresse du contrat.

Estimation des frais

Calculez les frais de réseau avant l’exécution pour vous assurer que le solde est suffisant.

Prise en charge des RPC personnalisés

Récupérez des actifs sur des blockchains non prises en charge en fournissant votre propre endpoint RPC.

Blockchains prises en charge

La récupération d’actifs est disponible sur toutes les blockchains prises en charge par Blockradar, y compris les réseaux compatibles EVM, Tron et Solana. Consultez Intégrations pour la liste complète des réseaux pris en charge et les liens vers les faucets.

Pour les réseaux EVM qui ne sont pas directement pris en charge, vous pouvez fournir une URL de RPC personnalisée et, si besoin, activer le mode couche 2 pour les réseaux de type rollup.

Commencez par les testnets pendant le développement pour éviter de dépenser des fonds réels.

Récupérer des actifs

Lancez une opération de récupération d’actifs pour transférer les actifs bloqués vers une adresse de destination.

Paramètres de la requête

Paramètre	Type	Requis	Description
`senderAddress`	string	Oui	L’adresse Blockradar sur laquelle les actifs sont actuellement bloqués.
`recipientAddress`	string	Oui	L’adresse de destination vers laquelle les actifs récupérés seront envoyés.
`amount`	string	Oui	Le montant à récupérer. Utilisez le montant total ou une partie de celui-ci.
`blockchainId`	string (UUID)	Oui	L’UUID de la blockchain sur laquelle la récupération aura lieu. Obtenez-le via l’API Get Blockchains.
`tokenAddress`	string	Non	Adresse du contrat pour la récupération d’un actif personnalisé. À omettre pour la devise native.
`crossNetwork`	boolean	Non	Définissez sur `true` pour récupérer des actifs envoyés dans le mauvais environnement réseau (par exemple, des actifs mainnet sur une adresse dérivée sur testnet). Valeur par défaut : `false`.
`rpcUrl`	string	Non	Endpoint RPC personnalisé pour les blockchains non prises en charge. Ne peut pas être utilisé avec `crossNetwork`.
`isL2`	boolean	Non	Définissez sur `true` si l’URL de RPC pointe vers un réseau de couche 2.

Récupération de devise native

Récupérez une devise native (ETH, BNB, MATIC, etc.) depuis le mauvais réseau :

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

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '0.5',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa'
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'polygon-mainnet'
    }
)

print(response.json())

Récupération d’actifs personnalisés

Récupérez des actifs ERC-20 ou compatibles en indiquant l’adresse du contrat :

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

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '100',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa',
      tokenAddress: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '100',
        'blockchainId': 'polygon-mainnet',
        'tokenAddress': '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
    }
)

print(response.json())

Récupération via un RPC personnalisé

Récupérez des actifs sur des blockchains non prises en charge en fournissant votre propre endpoint RPC :

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

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '0.5',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa',
      rpcUrl: 'https://rpc.custom-network.io',
      isL2: true
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'custom',
        'rpcUrl': 'https://rpc.custom-network.io',
        'isL2': True
    }
)

print(response.json())

Récupération inter-réseaux

Récupérez des actifs envoyés par erreur sur mainnet à une adresse dérivée sur testnet, ou inversement. Cela fonctionne parce que les adresses EVM, Tron et Solana sont dérivées des mêmes clés, quel que soit l’environnement réseau.

La récupération inter-réseaux nécessite blockchainId et ne peut pas être utilisée avec rpcUrl. La blockchain doit correspondre à celle du portefeuille : vous ne pouvez pas changer à la fois de chaîne et d’environnement réseau.

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

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '100',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa',
      tokenAddress: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
      crossNetwork: true
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '100',
        'blockchainId': 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa',
        'tokenAddress': '0xdAC17F958D2ee523a2206206994597C13D831ec7',
        'crossNetwork': True
    }
)

print(response.json())

Lorsque crossNetwork est activé, les métadonnées de la transaction incluent les champs crossNetwork: true et keyDerivationNetwork à des fins d’audit.

Réponse en cas de succès

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

Estimation des frais de réseau

Avant d’exécuter une récupération, estimez les frais de réseau pour vous assurer que le solde est suffisant.

Requête d’estimation des frais

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

const response = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/salvage/network-fee',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      senderAddress: '0x1234567890abcdef1234567890abcdef12345678',
      recipientAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
      amount: '0.5',
      blockchainId: 'b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa'
    })
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.blockradar.co/v1/wallets/{walletId}/salvage/network-fee',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'polygon-mainnet'
    }
)

print(response.json())

Paramètres de la réponse des frais

Paramètre	Description
`networkFee`	Frais de gas estimés, en unités de devise native
`networkFeeInUSD`	Frais de gas convertis en USD
`nativeBalance`	Solde actuel de l’adresse source en devise native
`nativeBalanceInUSD`	Solde natif converti en USD

Estimez toujours les frais avant d’exécuter une opération de récupération. L’adresse source doit disposer de suffisamment de devise native pour couvrir les frais de gas sur la blockchain de récupération.

Webhooks

Abonnez-vous aux événements webhook pour recevoir des notifications en temps réel sur les opérations de récupération.

Événements de récupération

Événement	Description
`salvage.success`	Déclenché lorsqu’une opération de récupération se termine avec succès.
`salvage.failed`	Déclenché lorsqu’une opération de récupération échoue en raison de fonds insuffisants, de problèmes réseau ou d’autres erreurs.
`salvage.cancelled`	Déclenché lorsqu’une opération de récupération est annulée avant d’être terminée.

Payload du 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"
  }
}

Configurez les webhooks dans le tableau de bord Blockradar sous Settings → Webhooks. Consultez la documentation sur les webhooks pour les instructions de configuration.

Cas d’usage courants

Un utilisateur a envoyé de l'USDC sur le mauvais réseau

Un utilisateur voulait envoyer de l’USDC sur Ethereum, mais l’a envoyé par erreur sur Polygon. Comme l’adresse est la même, les fonds sont arrivés sur Polygon. Utilisez la récupération d’actifs avec l’adresse du contrat USDC sur Polygon pour récupérer les fonds.

ETH envoyé sur Arbitrum au lieu d'Ethereum

Un utilisateur a transféré de l’ETH vers Arbitrum via un bridge, mais l’a envoyé à une adresse Blockradar. La même adresse existe sur Arbitrum grâce à la compatibilité EVM. Récupérez l’ETH depuis Arbitrum avec la récupération de devise native.

Actif personnalisé sur une couche 2

Un utilisateur a envoyé un actif ERC-20 personnalisé sur un réseau L2 comme Optimism. Indiquez l’adresse du contrat de l’actif et utilisez l’API de récupération pour le récupérer.

Actifs sur un réseau non pris en charge

Des actifs sont bloqués sur une blockchain qui n’est pas directement prise en charge par Blockradar. Fournissez votre propre endpoint RPC et définissez isL2: true s’il s’agit d’un rollup pour récupérer les fonds.

Actifs mainnet envoyés à une adresse dérivée sur testnet

Un utilisateur a envoyé de l’USDT mainnet à une adresse créée sur testnet. Comme la même clé privée dérive la même adresse sur les deux réseaux, utilisez la récupération inter-réseaux avec crossNetwork: true pour récupérer les fonds mainnet à l’aide des clés du portefeuille testnet.

Gestion des erreurs

Solde natif insuffisant

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

Solution : approvisionnez l’adresse source avec suffisamment de devise native pour couvrir les frais de gas avant de réessayer.

Adresse source invalide

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

Solution : assurez-vous que l’adresse source appartient à votre portefeuille Blockradar et qu’il s’agit d’une child address valide.

Actif introuvable

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

Solution : vérifiez l’adresse du contrat et la blockchain. Utilisez un explorateur de blocs pour confirmer que l’actif se trouve bien à l’adresse source.

Échec de connexion au RPC

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

Solution : vérifiez que votre URL de RPC est correcte et accessible. Assurez-vous qu’elle prend en charge les méthodes JSON-RPC requises.

Bonnes pratiques

Estimez toujours les frais d'abord

Utilisez l’endpoint des frais de réseau avant la récupération pour vous assurer que le solde en gas est suffisant et afficher des coûts précis.

Vérifiez les adresses

Vérifiez soigneusement les adresses source et de destination à l’aide d’un explorateur de blocs avant de lancer la récupération.

Utilisez les webhooks

Configurez des webhooks pour recevoir des mises à jour de statut en temps réel au lieu d’interroger l’API.

Testez sur testnet

Testez votre intégration de récupération sur testnet avant de l’utiliser en production.

Référence API

Endpoint	Description
Salvage	Lancer une opération de récupération d’actifs
Salvage Network Fee	Estimer les frais de réseau de la récupération

Bonne récupération !

Démarrage

Portefeuilles

Encaissements

Paiements

Convertir et Gérer

Conformité et Outils

Recuperation d'Actifs

Qu’est-ce que la récupération d’actifs ?

Prérequis

Comment ça fonctionne

Récupération de devise native

Récupération d'actifs personnalisés

Estimation des frais

Prise en charge des RPC personnalisés

Blockchains prises en charge

Récupérer des actifs

Paramètres de la requête

Récupération de devise native

Récupération d’actifs personnalisés

Récupération via un RPC personnalisé

Récupération inter-réseaux

Réponse en cas de succès

Estimation des frais de réseau

Requête d’estimation des frais

Paramètres de la réponse des frais

Webhooks

Événements de récupération

Payload du webhook

Cas d’usage courants

Gestion des erreurs

Bonnes pratiques

Estimez toujours les frais d'abord

Vérifiez les adresses

Utilisez les webhooks

Testez sur testnet

Référence API

​Qu’est-ce que la récupération d’actifs ?

​Prérequis

​Comment ça fonctionne

Récupération de devise native

Récupération d'actifs personnalisés

Estimation des frais

Prise en charge des RPC personnalisés

​Blockchains prises en charge

​Récupérer des actifs

​Paramètres de la requête

​Récupération de devise native

​Récupération d’actifs personnalisés

​Récupération via un RPC personnalisé

​Récupération inter-réseaux

​Réponse en cas de succès

​Estimation des frais de réseau

​Requête d’estimation des frais

​Paramètres de la réponse des frais

​Webhooks

​Événements de récupération

​Payload du webhook

​Cas d’usage courants

​Gestion des erreurs

​Bonnes pratiques

Estimez toujours les frais d'abord

Vérifiez les adresses

Utilisez les webhooks

Testez sur testnet

​Référence API

Qu’est-ce que la récupération d’actifs ?

Prérequis

Comment ça fonctionne

Blockchains prises en charge

Récupérer des actifs

Paramètres de la requête

Récupération de devise native

Récupération d’actifs personnalisés

Récupération via un RPC personnalisé

Récupération inter-réseaux

Réponse en cas de succès

Estimation des frais de réseau

Requête d’estimation des frais

Paramètres de la réponse des frais

Webhooks

Événements de récupération

Payload du webhook

Cas d’usage courants

Gestion des erreurs

Bonnes pratiques

Référence API