En résumé
L’API Contrats Intelligents de Blockradar vous permet d’interagir avec n’importe quel contrat intelligent directement depuis votre portefeuille sans avoir à gérer les endpoints RPC, les flux de signature ou les déploiements de contrats vous-même.
L’API Contrats Intelligents de Blockradar vous permet d’interagir avec n’importe quel contrat intelligent directement depuis votre portefeuille sans avoir à gérer les endpoints RPC, les flux de signature ou les déploiements de contrats vous-même.

Prérequis
Avant d’utiliser l’API Contrats Intelligents, assurez-vous d’avoir :1
Clé API
Obtenez votre clé API depuis le Tableau de bord Blockradar. Naviguez vers Paramètres → Clés API pour en générer une.
2
Portefeuille Créé
Créez un portefeuille via l’API Créer Portefeuille ou le tableau de bord. Vous aurez besoin du
walletId pour toutes les opérations de contrat intelligent.3
Solde en Monnaie Native
Alimentez votre portefeuille avec de la monnaie native (ETH, BNB, MATIC, etc.) pour couvrir les frais de gas. Utilisez l’endpoint Frais Réseau pour estimer les coûts avant l’exécution.
Blockchains Supportées
L’API Contrats Intelligents supporte toutes les blockchains compatibles EVM et Tron disponibles sur Blockradar. Voir Intégrations pour la liste complète des réseaux supportés et les liens vers les faucets.Introduction
L’API Contrats Intelligents transforme Blockradar d’une infrastructure de portefeuille en une couche d’exécution programmable. Vous pouvez lire l’état des contrats, exécuter des fonctions de contrat, estimer les frais de gas et signer des transactions—le tout via une surface API unifiée.Opérations de Lecture
Récupérez des données de n’importe quel contrat intelligent sur les blockchains supportées.
Opérations d'Écriture
Exécutez des fonctions de contrat intelligent avec une gestion complète des transactions.
Estimation des Frais
Calculez les coûts de gas avant l’exécution pour garantir des fonds suffisants.
Opérations par Lot
Exécutez plusieurs appels de contrat en une seule requête API.
Cas d’Utilisation
L’API Contrats Intelligents débloque des capacités puissantes pour les développeurs fintech :- Intégration DeFi : Connectez-vous à des protocoles comme Uniswap, Aave ou Compound pour la gestion de rendement et de 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 de produits
- Règlements Programmables : Exécutez des vérifications de conformité et des règlements automatisés
- Actifs Personnalisés : Gérez des actifs personnalisés, des systèmes de récompenses et des programmes de fidélité
Portefeuille Principal vs Adresse Enfant
L’API Contrats Intelligents est disponible à deux niveaux :Portefeuille Principal
Exécutez des opérations de contrat directement depuis votre portefeuille principal. Idéal pour les opérations de trésorerie et la gestion centralisée des fonds.
Adresse Enfant
Exécutez des opérations de contrat depuis des adresses enfants individuelles. Parfait pour les opérations spécifiques aux utilisateurs et la gestion séparée des fonds.
Endpoints du Portefeuille Principal
| Opération | Endpoint | Description |
|---|---|---|
| Lecture | POST /v1/wallets/{walletId}/contracts/read | Récupérer des données des contrats intelligents |
| Écriture | POST /v1/wallets/{walletId}/contracts/write | Exécuter des fonctions de contrat intelligent |
| Frais Réseau | POST /v1/wallets/{walletId}/contracts/network-fee | Estimer les coûts de gas |
| Signature Seule | POST /v1/wallets/{walletId}/contracts/write/sign | Signer sans diffuser |
Endpoints de l’Adresse Enfant
| Opération | Endpoint | Description |
|---|---|---|
| Lecture | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/read | Récupérer des données des contrats intelligents |
| Écriture | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write | Exécuter des fonctions de contrat intelligent |
| Frais Réseau | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/network-fee | Estimer les coûts de gas |
| Signature Seule | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write/sign | Signer sans diffuser |
Structure des Requêtes
Toutes les requêtes de contrat intelligent nécessitent ces paramètres :| Paramètre | Type | Requis | Description |
|---|---|---|---|
address | string | Oui | L’adresse blockchain du contrat intelligent |
method | string | Oui | Le nom de la fonction à appeler |
parameters | array | Oui | Arguments correspondant à l’ordre de l’ABI de la fonction |
abi | array | Oui | L’Interface Binaire d’Application du contrat |
reference | string | Non | Votre ID de suivi interne pour la transaction |
metadata | object | Non | Paires clé-valeur personnalisées pour des détails de transaction supplémentaires |
Les champs
reference et metadata ne sont applicables que pour les 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 comment interagir avec un contrat intelligent. Vous pouvez obtenir des ABIs depuis :- Explorateurs de blocs : Etherscan, BscScan, PolygonScan (contrats vérifiés)
- Documentation des protocoles : Docs officiels des protocoles DeFi
- Code source du contrat : Compiler depuis le code source Solidity
Lecture des Données de Contrat
Utilisez l’endpoint de lecture pour interroger l’état du contrat sans modifier la blockchain.Exemple de Lecture depuis le Portefeuille Principal
Exemple de Lecture depuis une Adresse Enfant
Réponse de Lecture
Réponses d’Erreur de Lecture
Adresse de Contrat Invalide
Adresse de Contrat Invalide
Méthode Non Trouvée
Méthode Non Trouvée
Exécution du Contrat Annulée
Exécution du Contrat Annulée
Paramètres Invalides
Paramètres Invalides
Écriture sur les Contrats
Exécutez des fonctions qui modifient l’état sur les contrats intelligents.Exemple d’Écriture depuis le Portefeuille Principal
Exemple d’Écriture depuis une Adresse Enfant
Réponse d’Écriture
Réponses d’Erreur d’Écriture
Gas Insuffisant
Gas Insuffisant
Solde Insuffisant
Solde Insuffisant
Transaction Annulée
Transaction Annulée
ABI Invalide
ABI Invalide
Portefeuille Non Trouvé
Portefeuille Non Trouvé
Estimation des Frais Réseau
Estimez toujours les frais avant d’exécuter des opérations d’écriture pour vous assurer que votre portefeuille dispose de suffisamment de monnaie native.Estimation des Frais du Portefeuille Principal
Estimation des Frais de l’Adresse Enfant
Réponse des Frais
Exemple Pratique : Échange d’Actifs sur Uniswap
Cette section démontre deux approches pour exécuter un échange d’actifs : sans opérations par lot (appels séquentiels) et avec opérations par lot (appel API unique).Exemple 1 : Échange d’Actifs SANS Opérations par Lot
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 des appels précédents.Étape 1 : Vérifier le Solde d’Actifs
Étape 2 : Approuver la Dépense d’Actifs
Étape 3 : Estimer les Frais d’Échange
Étape 4 : Exécuter l’Échange
Exemple 2 : Échange d’Actifs AVEC Opérations par Lot
Cette approche combine approbation + échange en un seul appel API utilisant le tableaucalls. Utilisez ceci pour l’efficacité lorsque vous voulez mettre en file d’attente plusieurs opérations ensemble.
Les opérations par lot s’exécutent séquentiellement. Chaque opération est soumise comme une transaction séparée, mais vous n’avez besoin que d’un seul appel API.
Requête par Lot : Approbation + Échange en Un Appel
Réponse par Lot
Gestion des Échecs Partiels dans les Lots
Règles des Opérations par Lot
| Règle | Valeur |
|---|---|
| Taille maximale du lot | 20 opérations |
| Ordre d’exécution | Séquentiel |
| Gestion des erreurs | Succès partiel (les échecs n’arrêtent pas les opérations suivantes) |
Quand Utiliser Chaque Approche
| Scénario | Approche Recommandée |
|---|---|
| Besoin de vérifier les résultats entre les étapes | Sans Lot |
| Paramètres dynamiques basés sur les résultats précédents | Sans Lot |
| Modèles simples d’approbation + action | Avec Lot |
| Plusieurs opérations indépendantes | Avec Lot |
| Minimiser les appels API | Avec Lot |
Événements Webhook
Les opérations de contrat intelligent déclenchent des notifications webhook :| Événement | Description |
|---|---|
custom-smart-contract.success | Opération de contrat terminée avec succès |
custom-smart-contract.failed | Opération de contrat échouée |
Payload du Webhook
Meilleures Pratiques
Sécurité
- Vérifiez les adresses de contrat : Vérifiez toujours les adresses de contrat avant d’interagir
- Utilisez des ABIs fiables : Obtenez les ABIs de sources vérifiées comme les explorateurs de blocs
- Définissez des limites raisonnables : Utilisez la protection contre le slippage et les plafonds de montants pour les opérations DeFi
Gestion du Gas
- Estimez avant d’exécuter : Appelez toujours l’endpoint network-fee en premier
- Surveillez le solde natif : Assurez-vous d’avoir suffisamment d’ETH/BNB/MATIC pour les frais de gas
- Utilisez les opérations par lot : Réduisez les frais généraux en regroupant les opérations liées
Gestion des Erreurs
- Implémentez des écouteurs webhook : Ne vous fiez pas uniquement aux réponses API
- Gérez les échecs partiels : Vérifiez les tableaux
successeterrorsdans les réponses par lot - Réessayez avec backoff : Implémentez un backoff exponentiel pour les échecs transitoires
Référence API
Endpoints du Portefeuille Principal
| Endpoint | Description |
|---|---|
| Lire Contrat | Lire l’état du contrat |
| Écrire Contrat | Exécuter des fonctions de contrat |
| Frais Réseau | Estimer les coûts de gas |
| Signature Seule | Signer sans diffuser |
Endpoints de l’Adresse Enfant
| Endpoint | Description |
|---|---|
| Lire Contrat | Lire l’état du contrat |
| Écrire Contrat | Exécuter des fonctions de contrat |
| Frais Réseau | Estimer les coûts de gas |
| Signature Seule | Signer sans diffuser |
Support
- Email : [email protected]
- Documentation : Référence API
- Blog : Comment Interagir avec N’importe Quel Contrat Intelligent
L’API Contrats Intelligents 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 incorporez progressivement des opérations d’écriture à mesure que vous vous familiarisez avec le système.

