Skip to main content
En résumé
L’API Smart Contracts de Blockradar vous permet d’interagir avec n’importe quel smart contract directement depuis votre portefeuille, sans avoir à gérer vous-même les endpoints RPC, les flux de signature ou le déploiement de contrats.
Smart Contracts

Prérequis

Avant d’utiliser l’API Smart Contracts, assurez-vous de disposer de :
1

Clé API

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

Portefeuille créé

Créez un portefeuille via l’API Create Wallet ou le dashboard. Vous aurez besoin du walletId pour toutes les opérations sur les smart contracts.
3

Solde en monnaie native

Approvisionnez votre portefeuille en monnaie native (ETH, BNB, MATIC, etc.) pour couvrir les frais de gas. Utilisez le endpoint Network Fee pour estimer les coûts avant d’exécuter.

Blockchains prises en charge

L’API Smart Contracts prend en charge toutes les blockchains compatibles EVM ainsi que Tron disponibles sur Blockradar. Consultez Integrations pour la liste complète des réseaux pris en charge et les liens vers les faucets.
Solana n’est pas pris en charge pour les interactions avec les smart contracts. L’API Smart Contracts fonctionne uniquement avec les chaînes compatibles EVM et Tron.
Commencez par utiliser des testnets pendant le développement afin d’éviter de dépenser des fonds réels.

Introduction

L’API Smart Contracts transforme Blockradar d’une infrastructure de portefeuilles en une couche d’exécution programmable. Vous pouvez lire l’état d’un contrat, exécuter des fonctions de contrats, estimer les frais de gas et signer des transactions, le tout via une surface API unifiée.

Opérations de lecture

Récupérez les données de n’importe quel smart contract sur les blockchains prises en charge.

Opérations d'écriture

Exécutez les fonctions de smart contracts avec une gestion complète des transactions.

Estimation des frais

Calculez les coûts de gas avant l’exécution pour vous assurer de disposer de fonds suffisants.

Opérations groupées

Exécutez plusieurs appels de contrat dans une seule requête API.

Cas d’usage

L’API Smart Contracts débloque des capacités puissantes pour les développeurs fintech :
  • Intégration DeFi : Connectez-vous à des protocoles tels qu’Uniswap, Aave ou Compound pour la gestion du rendement et de la liquidité
  • Opérations de trésorerie : Automatisez la gestion de trésorerie au sein de votre plateforme fintech
  • Actifs tokenisés : Intégrez des actifs du monde réel dans vos flux produit
  • Règlements programmables : Exécutez des contrôles de conformité et des règlements automatisés
  • Actifs personnalisés : Gérez des actifs personnalisés, des systèmes de récompense et des programmes de fidélité

Master Wallet vs Child Address

L’API Smart Contracts est disponible à deux niveaux :

Master Wallet

Exécutez les opérations de contrat directement depuis votre master wallet. Idéal pour les opérations de trésorerie et la gestion centralisée des fonds.

Child Address

Exécutez les opérations de contrat à partir de child addresses individuelles. Parfait pour les opérations spécifiques aux utilisateurs et la gestion séparée des fonds.

Endpoints Master Wallet

Endpoints Child Address

Structure de la requête

Toutes les requêtes de smart contracts nécessitent ces paramètres :
Les champs reference et metadata ne s’appliquent qu’aux opérations d’écriture. Les opérations de lecture ne prennent pas en charge ces champs.

Comprendre les ABIs

L’ABI (Application Binary Interface) définit la manière d’interagir avec un smart contract. Vous pouvez obtenir des ABIs depuis :
  • Block explorers : Etherscan, BscScan, PolygonScan (contrats vérifiés)
  • Documentation des protocoles : Documentation officielle des protocoles DeFi
  • Code source du contrat : Compilez à partir du code source Solidity

Lecture des données du contrat

Utilisez l’endpoint de lecture pour interroger l’état du contrat sans modifier la blockchain.

Exemple de lecture avec Master Wallet

Exemple de lecture avec Child Address

Réponse de lecture

Réponses d’erreur de lecture

Écriture sur les contrats

Exécutez des fonctions modifiant l’état des smart contracts.

Exemple d’écriture avec Master Wallet

Exemple d’écriture avec Child Address

Réponse d’écriture

Les opérations d’écriture sont asynchrones. La réponse initiale affiche le statut PENDING. Écoutez le webhook custom-smart-contract.success pour confirmer la finalisation de la transaction.

Réponses d’erreur d’écriture

Estimation des frais réseau

Estimez toujours les frais avant d’exécuter des opérations d’écriture afin de vous assurer que votre portefeuille dispose d’une quantité suffisante de monnaie native.

Estimation des frais avec Master Wallet

Estimation des frais avec Child Address

Réponse de frais


Exemple pratique : échange d’actifs sur Uniswap

Cette section présente deux approches pour exécuter un échange d’actifs : sans opérations groupées (appels séquentiels) et avec opérations groupées (appel API unique).

Exemple 1 : échange d’actifs SANS opérations groupées

Cette approche effectue des appels API individuels pour chaque étape. Utilisez-la lorsque vous avez besoin d’un contrôle précis sur chaque transaction ou lorsque les opérations dépendent des résultats d’appels précédents.

Étape 1 : vérifier le solde de l’actif

Étape 2 : approuver la dépense de l’actif

Attendez toujours le webhook custom-smart-contract.success confirmant que la transaction d’approbation a été minée avant d’exécuter le swap.

Étape 3 : estimer les frais du swap

Étape 4 : exécuter le swap


Exemple 2 : échange d’actifs AVEC opérations groupées

Cette approche combine approve + swap en un seul appel API en utilisant le tableau calls. Utilisez-la pour plus d’efficacité lorsque vous souhaitez mettre en file plusieurs opérations à la fois.
Les opérations groupées s’exécutent séquentiellement. Chaque opération est soumise comme une transaction distincte, mais vous n’avez besoin que d’un seul appel API.

Requête groupée : approve + swap en un seul appel

Réponse groupée

Gestion des échecs partiels dans un lot

Règles des opérations groupées

Quand utiliser chaque approche


Événements Webhook

Les opérations de smart contracts déclenchent des notifications webhook :

Payload du Webhook

Bonnes pratiques

Sécurité

  • Vérifiez les adresses des contrats : Vérifiez toujours deux fois les adresses des contrats avant d’interagir
  • Utilisez des ABIs de confiance : Obtenez les ABIs de sources vérifiées comme les block explorers
  • Définissez des limites raisonnables : Utilisez la protection contre le slippage et les plafonds de montant pour les opérations DeFi

Gestion du gas

  • Estimez avant d’exécuter : Appelez toujours d’abord l’endpoint network-fee
  • Surveillez le solde natif : Assurez-vous d’avoir suffisamment d’ETH/BNB/MATIC pour les frais de gas
  • Utilisez les opérations groupées : Réduisez le surcoût en groupant les opérations liées

Gestion des erreurs

  • Implémentez des écouteurs de webhook : Ne vous fiez pas uniquement aux réponses API
  • Gérez les échecs partiels : Vérifiez à la fois les tableaux success et errors dans les réponses groupées
  • Réessayez avec backoff : Implémentez un backoff exponentiel pour les échecs transitoires

Référence API

Endpoints Master Wallet

Endpoints Child Address

Support

L’API Smart Contracts vous permet de créer des intégrations blockchain sophistiquées sans gérer la complexité de l’infrastructure. Commencez par des opérations de lecture simples et intégrez progressivement des opérations d’écriture à mesure que vous vous familiarisez avec le système.