Interagir avec N'importe Quel Contrat Intelligent

Les API principales de Blockradar couvrent les flux fintech les plus courants : dépôts de stablecoins, paiements, swaps et règlements. Mais que faire si vous devez aller au-delà de ce qui est pris en charge nativement ? Si vous devez interagir avec un protocole DeFi, avec votre propre contrat de token ou avec un service on-chain propre à votre activité ? C’est là qu’intervient l’API de Contrats Intelligents. Elle vous permet d’interagir avec n’importe quel contrat intelligent directement depuis votre portefeuille Blockradar, sans gérer d’endpoints RPC, de flux de signature ni d’infrastructure de nœuds. Elle vous permet de :

Vous connecter à des protocoles DeFi pour gérer le rendement ou la liquidité
Automatiser le prêt, le staking ou les opérations de trésorerie en stablecoins
Intégrer des actifs du monde réel tokenisés (RWA) dans les flux de votre produit
Alimenter des règlements, paiements ou contrôles de conformité programmables grâce à la logique on-chain
Étendre votre plateforme avec des tokens personnalisés, des systèmes de récompense ou des règles de frais

L’API de Contrats Intelligents offre trois possibilités : lire l’état d’un contrat, écrire dans un contrat et estimer le gas avant exécution.

Prérequis

Clé API

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

Portefeuille créé

Un walletId est nécessaire pour toutes les opérations sur les contrats intelligents.

ABI du contrat

Vous avez besoin de l’ABI (interface binaire d’application) de la fonction du contrat que vous souhaitez appeler. Elle est publique pour les contrats vérifiés sur les explorateurs de blocs comme Etherscan.

Adresse du contrat

L’adresse on-chain du contrat intelligent avec lequel vous voulez interagir.

Fonctionnement

Dans ce guide, nous suivrons un exemple concret : échanger un token non pris en charge contre de l’USDT via Uniswap V2. Le même schéma s’applique à toute interaction avec un contrat intelligent. Le déroulé :

Lire le solde du token depuis le contrat
Autoriser Uniswap à dépenser le token
Estimer les frais de réseau du swap
Exécuter le swap
Confirmer via le webhook

Étape 1 : Comprendre le contrat

Nous utiliserons la méthode swapExactTokensForTokens du routeur Uniswap V2. Signature de la méthode :

function swapExactTokensForTokens(
  uint amountIn,
  uint amountOutMin,
  address[] calldata path,
  address to,
  uint deadline
) external returns (uint[] memory amounts);

Paramètre	Description
`amountIn`	Quantité du token que vous souhaitez vendre
`amountOutMin`	Quantité minimale du token de sortie que vous acceptez (protection contre le slippage)
`path`	Adresses des tokens composant la route du swap
`to`	L’adresse de votre portefeuille Blockradar (reçoit le token de sortie)
`deadline`	Horodatage Unix au-delà duquel la transaction expire

Étape 2 : Lire le solde du token

Avant le swap, vérifiez la quantité de token détenue par votre portefeuille avec contracts/read.

const res = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/contracts/read',
  {
    method: 'POST',
    headers: {
      'x-api-key': '<api-key>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      abi: [{
        "constant": true,
        "inputs": [{ "name": "_owner", "type": "address" }],
        "name": "balanceOf",
        "outputs": [{ "name": "balance", "type": "uint256" }],
        "stateMutability": "view",
        "type": "function"
      }],
      address: "0xUnsupportedTokenAddress",
      method: "balanceOf",
      parameters: ["0xYourWalletAddress"]
    })
  }
).then(r => r.json());

// Response:
// { "data": "1000000000000000000", "message": "Contract read successfully" }

Paramètre	Description
`abi`	L’ABI de la fonction du contrat que vous appelez
`address`	L’adresse du contrat intelligent du token
`method`	Le nom de la fonction à appeler
`parameters`	Les arguments de la fonction

Utilisez le solde renvoyé ici comme valeur de amountIn pour votre appel de swap.

Étape 3 : Autoriser le contrat à dépenser votre token

Avant qu’Uniswap puisse déplacer votre token, vous devez lui en donner l’autorisation via la fonction approve du contrat du token.

await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/contracts/write',
  {
    method: 'POST',
    headers: {
      'x-api-key': '<api-key>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      abi: [{
        "inputs": [
          { "name": "_spender", "type": "address" },
          { "name": "_value", "type": "uint256" }
        ],
        "name": "approve",
        "outputs": [],
        "stateMutability": "nonpayable",
        "type": "function"
      }],
      address: "0xUnsupportedTokenAddress",
      method: "approve",
      parameters: ["0xUniswapRouterAddress", "1000000000000000000"]
    })
  }
);

Ne lancez pas le swap immédiatement après avoir soumis l’autorisation. Attendez le webhook custom-smart-contract.success confirmant que la transaction d’autorisation a été minée avant de passer à l’étape suivante.

Charge utile du webhook d’autorisation :

{
  "event": "custom-smart-contract.success",
  "data": {
    "status": "SUCCESS",
    "type": "CUSTOM_SMART_CONTRACT",
    "hash": "0xfedcba098765...",
    "tokenAddress": "0xUnsupportedTokenAddress"
  }
}

Étape 4 : Estimer les frais de réseau

Avant d’exécuter le swap, estimez le coût en gas afin de vous assurer que votre portefeuille dispose d’assez de token natif pour le couvrir.

const fee = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/contracts/network-fee',
  {
    method: 'POST',
    headers: {
      'x-api-key': '<api-key>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      abi: [ /* ABI of swapExactTokensForTokens */ ],
      address: "0xUniswapRouterAddress",
      method: "swapExactTokensForTokens",
      parameters: [
        "1000000000000000000",
        "990000",
        ["0xUnsupportedTokenAddress", "0xUSDTAddress"],
        "0xYourWalletAddress",
        Math.floor(Date.now() / 1000) + 60 * 20
      ]
    })
  }
).then(r => r.json());

// Response:
// { "data": { "balance": "1.0123", "fee": "0.00422" } }

Étape 5 : Exécuter le swap

Une fois l’autorisation confirmée et les frais vérifiés, exécutez le swap.

const swap = await fetch(
  'https://api.blockradar.co/v1/wallets/{walletId}/contracts/write',
  {
    method: 'POST',
    headers: {
      'x-api-key': '<api-key>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      abi: [ /* ABI of swapExactTokensForTokens */ ],
      address: "0xUniswapRouterAddress",
      method: "swapExactTokensForTokens",
      parameters: [
        "1000000000000000000",
        "990000",
        ["0xUnsupportedTokenAddress", "0xUSDTAddress"],
        "0xYourWalletAddress",
        Math.floor(Date.now() / 1000) + 60 * 20
      ]
    })
  }
).then(r => r.json());

// Response:
// { "message": "Contract write initiated successfully", "data": { "status": "PENDING" } }

Écoutez le webhook pour confirmer la finalisation :

{
  "event": "custom-smart-contract.success",
  "data": {
    "status": "SUCCESS",
    "type": "CUSTOM_SMART_CONTRACT",
    "hash": "0xfedcba098765...",
    "tokenAddress": "0xUniswapRouterAddress"
  }
}

Événements webhook

Événement	Description
`custom-smart-contract.success`	Écriture dans le contrat confirmée on-chain
`custom-smart-contract.failed`	Échec de l’écriture dans le contrat

Autres endpoints

Endpoint	Description
`POST /v1/wallets/{walletId}/contracts/read`	Lire l’état de n’importe quel contrat
`POST /v1/wallets/{walletId}/contracts/write`	Exécuter n’importe quelle fonction de contrat
`POST /v1/wallets/{walletId}/contracts/network-fee`	Estimer le gas avant exécution
`POST /v1/wallets/{walletId}/contracts/write/sign`	Signer une transaction sans la diffuser

Notes de sécurité

Toutes les transactions sont signées et diffusées via l’infrastructure Blockradar : aucune clé privée ni nœud RPC à gérer
Les contrôles natifs d’AML et de conformité s’appliquent lorsque c’est possible
Chaque interaction avec un contrat est une transaction on-chain réelle et nécessite du gas dans le token natif de la chaîne

Référence API

Endpoint	Description
Master Wallet Read	Lire l’état d’un contrat depuis le portefeuille principal
Master Wallet Write	Exécuter une fonction de contrat depuis le portefeuille principal
Master Wallet Network Fee	Estimer le gas depuis le portefeuille principal
Child Address Read	Lire l’état d’un contrat depuis une child address
Child Address Write	Exécuter une fonction de contrat depuis une child address
Child Address Network Fee	Estimer le gas depuis une child address

Démarrage

Portefeuilles

Encaissements

Paiements

Convertir et Gérer

Conformité et Outils

Interagir avec N'importe Quel Contrat Intelligent

Prérequis

Fonctionnement

Étape 1 : Comprendre le contrat

Étape 2 : Lire le solde du token

Étape 3 : Autoriser le contrat à dépenser votre token

Étape 4 : Estimer les frais de réseau

Étape 5 : Exécuter le swap

Événements webhook

Autres endpoints

Notes de sécurité

Référence API

​Prérequis

​Fonctionnement

​Étape 1 : Comprendre le contrat

​Étape 2 : Lire le solde du token

​Étape 3 : Autoriser le contrat à dépenser votre token

​Étape 4 : Estimer les frais de réseau

​Étape 5 : Exécuter le swap

​Événements webhook

​Autres endpoints

​Notes de sécurité

​Référence API

Prérequis

Fonctionnement

Étape 1 : Comprendre le contrat

Étape 2 : Lire le solde du token

Étape 3 : Autoriser le contrat à dépenser votre token

Étape 4 : Estimer les frais de réseau

Étape 5 : Exécuter le swap

Événements webhook

Autres endpoints

Notes de sécurité

Référence API