Recuperation d'Actifs

En bref
L’API de Recuperation d’Actifs Yiksi Pay vous permet de recuperer des actifs qui ont ete accidentellement envoyes a la bonne adresse sur la mauvaise blockchain. Elle prend en charge la monnaie native et les actifs personnalises (ERC-20 et standards compatibles) sur tous les reseaux supportes.

Qu’est-ce que la Recuperation d’Actifs?

La recuperation d’actifs vous permet de recuperer des fonds qui ont ete envoyes a la bonne adresse de portefeuille mais sur le mauvais reseau blockchain. Cela se produit couramment lorsque:

Les utilisateurs envoient des actifs sur Ethereum mais voulaient envoyer sur Polygon
Des actifs sont envoyes sur BNB Smart Chain au lieu d’Arbitrum
Toute confusion d’adresses entre chaines ou la meme adresse existe sur plusieurs reseaux compatibles EVM

Etant donne que les blockchains compatibles EVM partagent le meme format d’adresse, la meme adresse peut recevoir des actifs sur plusieurs reseaux. La recuperation d’actifs vous permet d’acceder a ces fonds de maniere programmatique.

Prerequis

Avant d’utiliser l’API de Recuperation d’Actifs, assurez-vous d’avoir:

Cle API

Obtenez votre cle API depuis le Tableau de Bord Yiksi Pay. Naviguez vers Parametres → Cles API pour en generer une.

Portefeuille Cree

Creez un portefeuille via l’API Creer Portefeuille ou le tableau de bord. Vous aurez besoin du walletId pour les operations de recuperation.

ID Blockchain

Obtenez le blockchainId pour le reseau ou les actifs sont bloques. Vous pouvez le trouver dans le tableau de bord ou via l’API Obtenir Blockchains.

Solde en Monnaie Native

Assurez-vous que l’adresse emettrice dispose de suffisamment de monnaie native (ETH, BNB, MATIC, etc.) sur la blockchain de recuperation pour couvrir les frais de gas.

Comment Ca Fonctionne

L’API de Recuperation d’Actifs transfere des actifs d’une adresse emettrice (ou les actifs sont bloques) vers une adresse destinataire sur la meme blockchain:

Recuperation de Monnaie Native

Recuperez de la monnaie native comme ETH, BNB, MATIC ou AVAX envoyee sur le mauvais reseau.

Recuperation d'Actifs Personnalises

Recuperez des actifs ERC-20 et compatibles en specifiant l’adresse du contrat.

Estimation des Frais

Calculez les frais de reseau avant l’execution pour assurer un solde suffisant.

Support RPC Personnalise

Recuperez des actifs sur des blockchains non supportees en fournissant votre propre endpoint RPC.

Blockchains Supportees

La recuperation d’actifs est disponible sur toutes les blockchains supportees par Yiksi Pay, y compris les reseaux compatibles EVM, Tron et Solana. Voir Integrations pour la liste complete des reseaux supportes et les liens vers les faucets.

Pour les reseaux EVM non directement supportes, vous pouvez fournir une URL RPC personnalisee et optionnellement activer le mode Layer 2 pour les reseaux bases sur des rollups.

Commencez avec les testnets pendant le developpement pour eviter de depenser des fonds reels.

Recuperer des Actifs

Initiez une operation de recuperation d’actifs pour transferer des actifs bloques vers une adresse destinataire.

Parametres de Requete

Parametre	Type	Requis	Description
`senderAddress`	string	Oui	L’adresse Yiksi Pay ou les actifs sont actuellement bloques.
`recipientAddress`	string	Oui	L’adresse de destination ou les actifs recuperes seront envoyes.
`amount`	string	Oui	Le montant a recuperer. Utilisez le montant complet ou une portion.
`blockchainId`	string (UUID)	Oui	L’UUID blockchain ou la recuperation aura lieu. Obtenez-le via l’API Obtenir Blockchains.
`tokenAddress`	string	Non	Adresse du contrat pour la recuperation d’actifs personnalises. Omettez pour la monnaie native.
`rpcUrl`	string	Non	Endpoint RPC personnalise pour les blockchains non supportees.
`isL2`	boolean	Non	Definissez sur `true` si l’URL RPC pointe vers un reseau Layer 2.

Recuperation de Monnaie Native

Recuperez de la monnaie native (ETH, BNB, MATIC, etc.) du mauvais reseau:

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

const response = await fetch(
  'https://api.yiksipay.com/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'VOTRE_CLE_API'
    },
    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.yiksipay.com/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'VOTRE_CLE_API'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'polygon-mainnet'
    }
)

print(response.json())

Recuperation d’Actifs Personnalises

Recuperez des actifs ERC-20 ou compatibles en specifiant l’adresse du contrat:

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

const response = await fetch(
  'https://api.yiksipay.com/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'VOTRE_CLE_API'
    },
    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.yiksipay.com/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'VOTRE_CLE_API'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '100',
        'blockchainId': 'polygon-mainnet',
        'tokenAddress': '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
    }
)

print(response.json())

Recuperation avec RPC Personnalise

Recuperez des actifs sur des blockchains non supportees en fournissant votre propre endpoint RPC:

curl --request POST \
  --url https://api.yiksipay.com/v1/wallets/{walletId}/salvage \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: VOTRE_CLE_API' \
  --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.yiksipay.com/v1/wallets/{walletId}/salvage',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'VOTRE_CLE_API'
    },
    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.yiksipay.com/v1/wallets/{walletId}/salvage',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'VOTRE_CLE_API'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'custom',
        'rpcUrl': 'https://rpc.custom-network.io',
        'isL2': True
    }
)

print(response.json())

Reponse Reussie

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

Estimation des Frais de Reseau

Avant d’executer une recuperation, estimez les frais de reseau pour assurer un solde suffisant.

Requete d’Estimation des Frais

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

const response = await fetch(
  'https://api.yiksipay.com/v1/wallets/{walletId}/salvage/network-fee',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'VOTRE_CLE_API'
    },
    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.yiksipay.com/v1/wallets/{walletId}/salvage/network-fee',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'VOTRE_CLE_API'
    },
    json={
        'senderAddress': '0x1234567890abcdef1234567890abcdef12345678',
        'recipientAddress': '0xabcdef1234567890abcdef1234567890abcdef12',
        'amount': '0.5',
        'blockchainId': 'polygon-mainnet'
    }
)

print(response.json())

Parametres de Reponse des Frais

Parametre	Description
`networkFee`	Frais de gas estimes en unites de monnaie native
`networkFeeInUSD`	Frais de gas convertis en USD
`nativeBalance`	Solde actuel en monnaie native de l’emetteur
`nativeBalanceInUSD`	Solde natif converti en USD

Estimez toujours les frais avant d’executer des operations de recuperation. L’adresse emettrice doit avoir suffisamment de monnaie native pour couvrir les frais de gas sur la blockchain de recuperation.

Webhooks

Abonnez-vous aux evenements webhook pour recevoir des notifications en temps reel sur les operations de recuperation.

Evenements de Recuperation

Evenement	Description
`salvage.success`	Declenche lorsqu’une operation de recuperation se termine avec succes.
`salvage.failed`	Declenche lorsqu’une operation de recuperation echoue en raison de fonds insuffisants, de problemes de reseau ou d’autres erreurs.
`salvage.cancelled`	Declenche lorsqu’une operation de recuperation est annulee avant son achevement.

Payload 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 Yiksi Pay sous Developers → Webhooks. Consultez la documentation Webhooks pour les instructions de configuration.

Cas d’Utilisation Courants

Utilisateur a envoye USDC sur le mauvais reseau

Un utilisateur voulait envoyer des USDC sur Ethereum mais les a accidentellement envoyes sur Polygon. Comme l’adresse est la meme, les fonds sont arrives sur Polygon. Utilisez la recuperation d’actifs avec l’adresse du contrat USDC sur Polygon pour recuperer les fonds.

ETH envoye sur Arbitrum au lieu d'Ethereum

Un utilisateur a fait un bridge d’ETH vers Arbitrum mais l’a envoye a une adresse Yiksi Pay. La meme adresse existe sur Arbitrum grace a la compatibilite EVM. Recuperez l’ETH d’Arbitrum en utilisant la recuperation de monnaie native.

Actif personnalise sur Layer 2

Un utilisateur a envoye un actif ERC-20 personnalise sur un reseau L2 comme Optimism. Fournissez l’adresse du contrat de l’actif et utilisez l’API de recuperation pour le recuperer.

Actifs sur reseau non supporte

Des actifs sont bloques sur une blockchain non directement supportee par Yiksi Pay. Fournissez votre propre endpoint RPC et definissez isL2: true s’il s’agit d’un rollup pour recuperer les fonds.

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 emettrice avec suffisamment de monnaie native pour couvrir les frais de gas avant de reessayer.

Adresse Emettrice Invalide

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

Solution: Assurez-vous que l’adresse emettrice appartient a votre portefeuille Yiksi Pay et est une adresse enfant valide.

Actif Non Trouve

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

Solution: Verifiez l’adresse du contrat et la blockchain. Utilisez un explorateur de blocs pour confirmer que l’actif existe a l’adresse emettrice.

Connexion RPC Echouee

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

Solution: Verifiez que votre URL RPC est correcte et accessible. Assurez-vous qu’elle supporte les methodes JSON-RPC requises.

Bonnes Pratiques

Toujours Estimer les Frais d'Abord

Utilisez l’endpoint des frais de reseau avant la recuperation pour assurer un solde de gas suffisant et afficher des couts precis.

Verifiez les Adresses

Verifiez les adresses emettrice et destinataire en utilisant un explorateur de blocs avant d’initier la recuperation.

Utilisez les Webhooks

Configurez des webhooks pour recevoir des mises a jour de statut en temps reel au lieu d’interroger l’API.

Testez sur Testnet

Testez votre integration de recuperation sur testnet avant de l’utiliser en production.

Reference API

Endpoint	Description
Salvage	Initier une operation de recuperation d’actifs
Salvage Network Fee	Estimer les frais de reseau pour la recuperation

Bonne recuperation!

Démarrage

Essentiels

Recuperation d'Actifs

Qu’est-ce que la Recuperation d’Actifs?

Prerequis

Comment Ca Fonctionne

Recuperation de Monnaie Native

Recuperation d'Actifs Personnalises

Estimation des Frais

Support RPC Personnalise

Blockchains Supportees

Recuperer des Actifs

Parametres de Requete

Recuperation de Monnaie Native

Recuperation d’Actifs Personnalises

Recuperation avec RPC Personnalise

Reponse Reussie

Estimation des Frais de Reseau

Requete d’Estimation des Frais

Parametres de Reponse des Frais

Webhooks

Evenements de Recuperation

Payload Webhook

Cas d’Utilisation Courants

Gestion des Erreurs

Bonnes Pratiques

Toujours Estimer les Frais d'Abord

Verifiez les Adresses

Utilisez les Webhooks

Testez sur Testnet

Reference API

​Qu’est-ce que la Recuperation d’Actifs?

​Prerequis

​Comment Ca Fonctionne

Recuperation de Monnaie Native

Recuperation d'Actifs Personnalises

Estimation des Frais

Support RPC Personnalise

​Blockchains Supportees

​Recuperer des Actifs

​Parametres de Requete

​Recuperation de Monnaie Native

​Recuperation d’Actifs Personnalises

​Recuperation avec RPC Personnalise

​Reponse Reussie

​Estimation des Frais de Reseau

​Requete d’Estimation des Frais

​Parametres de Reponse des Frais

​Webhooks

​Evenements de Recuperation

​Payload Webhook

​Cas d’Utilisation Courants

​Gestion des Erreurs

​Bonnes Pratiques

Toujours Estimer les Frais d'Abord

Verifiez les Adresses

Utilisez les Webhooks

Testez sur Testnet

​Reference API

Qu’est-ce que la Recuperation d’Actifs?

Prerequis

Comment Ca Fonctionne

Blockchains Supportees

Recuperer des Actifs

Parametres de Requete

Recuperation de Monnaie Native

Recuperation d’Actifs Personnalises

Recuperation avec RPC Personnalise

Reponse Reussie

Estimation des Frais de Reseau

Requete d’Estimation des Frais

Parametres de Reponse des Frais

Webhooks

Evenements de Recuperation

Payload Webhook

Cas d’Utilisation Courants

Gestion des Erreurs

Bonnes Pratiques

Reference API