Documentation Index
Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
Use this file to discover all available pages before exploring further.
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.
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.

Prérequis
Avant d’utiliser l’API Smart Contracts, assurez-vous de disposer de :Clé API
Obtenez votre clé API depuis le Dashboard Blockradar. Rendez-vous dans Developers pour en générer une.
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.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.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
| Opération | Endpoint | Description |
|---|---|---|
| Lecture | POST /v1/wallets/{walletId}/contracts/read | Récupère les données des smart contracts |
| Écriture | POST /v1/wallets/{walletId}/contracts/write | Exécute les fonctions des smart contracts |
| Network Fee | POST /v1/wallets/{walletId}/contracts/network-fee | Estime les coûts de gas |
| Sign Only | POST /v1/wallets/{walletId}/contracts/write/sign | Signe sans diffuser |
Endpoints Child Address
| Opération | Endpoint | Description |
|---|---|---|
| Lecture | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/read | Récupère les données des smart contracts |
| Écriture | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write | Exécute les fonctions des smart contracts |
| Network Fee | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/network-fee | Estime les coûts de gas |
| Sign Only | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write/sign | Signe sans diffuser |
Structure de la requête
Toutes les requêtes de smart contracts nécessitent ces paramètres :| Paramètre | Type | Requis | Description |
|---|---|---|---|
address | string | Oui | L’adresse du smart contract sur la blockchain |
method | string | Oui | Le nom de la fonction à appeler |
parameters | array | Oui | Arguments dans l’ordre défini par l’ABI de la fonction |
abi | array | Oui | L’Application Binary Interface du contrat |
reference | string | Non | Votre identifiant interne de suivi de la transaction |
metadata | object | Non | Paires clé-valeur personnalisées pour des détails supplémentaires de transaction |
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
Adresse de contrat invalide
Adresse de contrat invalide
Méthode introuvable
Méthode introuvable
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 modifiant l’état des smart contracts.Exemple d’écriture avec Master Wallet
Exemple d’écriture avec Child Address
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 introuvable
Portefeuille introuvable
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
É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 tableaucalls. 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
| 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 |
|---|---|
| Vérifier les résultats entre les étapes | Sans lot |
| Paramètres dynamiques basés sur des résultats précédents | Sans lot |
| Schémas simples approve + action | Avec lot |
| Plusieurs opérations indépendantes | Avec lot |
| Minimiser les appels API | Avec lot |
Événements Webhook
Les opérations de smart contracts 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
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
successeterrorsdans 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
| Endpoint | Description |
|---|---|
| Read Contract | Lit l’état du contrat |
| Write Contract | Exécute les fonctions du contrat |
| Network Fee | Estime les coûts de gas |
| Sign Only | Signe sans diffuser |
Endpoints Child Address
| Endpoint | Description |
|---|---|
| Read Contract | Lit l’état du contrat |
| Write Contract | Exécute les fonctions du contrat |
| Network Fee | Estime les coûts de gas |
| Sign Only | Signe sans diffuser |
Support
- E-mail : [email protected]
- Documentation : API Reference
- Blog : How to Interact with Any Smart Contract
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.

