Comment obtenir l'ABI d'un contrat déployé?

Comprendre ce qu'est un ABI

Dans le monde d'Ethereum et des contrats intelligents, ABI signifie Interface binaire d'application . Il sert d'interface entre le contrat et les entités externes telles que les portefeuilles, les applications décentralisées (DAPP) ou d'autres contrats intelligents. L' ABI définit comment les données sont codées et décodées lors de l'interaction avec les fonctions et les événements du contrat. Sans l'ABI, il est presque impossible d'appeler des fonctions ou d'interpréter les données renvoyées par un contrat intelligent.

Lorsqu'un contrat est déployé sur la blockchain Ethereum, l' ABI n'est pas stockée à la chaîne . Au lieu de cela, il doit être obtenu séparément. Les développeurs le fournissent généralement lors du déploiement du contrat ou de le rendre disponible sur des plateformes comme Etherscan . L'ABI est crucial pour les outils externes pour comprendre la structure du contrat et interagir correctement avec lui.

Utiliser Etherscan pour récupérer ABI d'un contrat

L'une des façons les plus courantes d'obtenir l'ABI d'un contrat déployé est par Etherscan , l'Ethereum Blockchain Explorer le plus utilisé. Voici comment vous pouvez récupérer l'ABI en utilisant cette méthode:

• Accédez à https://etherscan.io
• Collez l'adresse du contrat dans la barre de recherche et appuyez sur Entrée
• Une fois sur la page du contrat, localisez l'onglet «contrat» et cliquez dessus
• Faites défiler vers le bas jusqu'à ce que vous voyiez la section «Contrat Abi»
• Cliquez sur le bouton «Copier» pour copier l'ABI ou «Télécharger» pour l'enregistrer en tant que fichier JSON

Cette méthode fonctionne pour des contrats vérifiés. Si le contrat n'est pas vérifié, l'ABI ne sera pas disponible sur Etherscan. Dans de tels cas, des approches alternatives sont nécessaires.

Vérification de la transaction de déploiement sur un explorateur blockchain

Si l'ABI n'est pas directement disponible sur Etherscan, vous pouvez parfois l'extraire de la transaction de création de contrat . Cette méthode est plus technique et nécessite d'inspecter les données de transaction:

• Trouvez l'adresse du contrat sur un explorateur de blockchain comme Etherscan
• Cliquez sur l'onglet «Transactions» et recherchez la transaction étiquetée comme «création de contrat»
• Cliquez sur ce hachage de transaction pour ouvrir les détails de la transaction
• Dans la section «Données d'entrée», vous pouvez trouver le contrat bytecode et éventuellement l'ABI intégrée
• Si l'ABI est présent, vous pouvez l'extraire et la formater dans un fichier JSON à utiliser

Cette approche n'est pas garantie, car les développeurs peuvent choisir de ne pas inclure l'ABI dans la transaction de déploiement. Cependant, il peut être utile dans certains cas où l'ABI n'est pas publié séparément.

Utilisation de la truffe ou du hardhat pour extraire ABI

Si vous avez accès au code source de Solidity d'origine et aux scripts de déploiement, vous pouvez utiliser des cadres de développement comme la truffe ou le hardhat pour compiler le contrat et générer automatiquement l'ABI. Voici comment le faire avec les deux outils:

• Pour la truffe , exécutez la truffle compile de commande dans votre répertoire de projet. L'ABI sera enregistré dans le dossier build/contracts en tant que fichier JSON
• Pour Hardhat , exécutez npx hardhat compile . L'ABI sera situé dans le répertoire artifacts sous le nom du contrat
• Ouvrez le fichier JSON et localisez le tableau «ABI». C'est l'ABI dont vous avez besoin pour interagir avec le contrat

Cette méthode est idéale pour les développeurs qui ont accès au code source du contrat et travaillent dans un environnement de développement local. Il garantit que l'ABI est exact et correspond au contrat déployé si le code source est correct.

Interagir avec les nœuds via JSON-RPC pour récupérer les données du contrat

Pour les utilisateurs ou développeurs avancés, interagir avec un nœud Ethereum via l' API JSON-RPC est une autre façon de récupérer les informations du contrat. Bien que cette méthode ne renvoie pas directement l'ABI, elle vous permet d'inspecter le bytecode du contrat et potentiellement extraire l'ABI des métadonnées:

• Configurez une connexion à un nœud Ethereum à l'aide de services comme Infura, Alchemy ou un nœud local
• Utilisez la méthode eth_getCode JSON-RPC en envoyant une demande de poste avec l'adresse du contrat et le paramètre de bloc (par exemple, «dernier»)
• Analysez le bytecode retourné. Si le contrat comprend des métadonnées, le hachage IPFS du code source et ABI peut être intégré dans le bytecode
• Utilisez des outils comme SOLC ou Dissemblers en ligne pour décoder le bytecode et extraire les métadonnées

Cette méthode nécessite une bonne compréhension du protocole Ethereum et de la structure des contrats intelligents. Il n'est pas recommandé pour les débutants mais est un outil puissant pour l'analyse médico-légale ou l'ingénierie inverse.

Questions fréquemment posées

Puis-je interagir avec un contrat sans son ABI?

Oui, mais seulement de manière limitée. Vous pouvez envoyer Ether au contrat ou des fonctions d'appel sans connaître leurs noms en utilisant le hachage de la signature de la fonction. Cependant, l'interprétation des données de retour ou des journaux d'événements devient extrêmement difficile sans l'ABI.

L'ABI est-il le même que le bytecode du contrat?

Non, l' ABI est un format JSON lisible par l'homme et structuré qui décrit les fonctions et les événements d'un contrat. ByteCode, en revanche, est le code de niveau de la machine compilé qui s'exécute sur la machine virtuelle Ethereum (EVM).

Pourquoi l'ABI est-il important pour le développement du DAPP?

L' ABI est essentiel pour permettre la communication entre A DAPP et un contrat intelligent . Il permet aux développeurs d'encoder correctement les appels de fonction et de décoder correctement, garantissant que le DAPP peut interagir avec le contrat de manière significative.

Où puis-je trouver Abis en plus d'étherscan?

Vous pouvez trouver Abis sur d'autres explorateurs de blockchain comme le blockchair , le blockscout ou le BSCSCAN (pour la chaîne intelligente Binance). De plus, certains projets publient leur ABI sur les référentiels GitHub ou les pages de documentation officielles.