Comment lire un contrat intelligent sur Etherscan ? (Un guide pratique)

Comprendre l'interface Etherscan

1. Accédez à la page d'accueil d'Etherscan et localisez la barre de recherche en haut au centre de la page.

2. Saisissez une adresse de contrat ou un hachage de transaction valide dans le champ de recherche et appuyez sur Entrée.

3. Si l'entrée correspond à un contrat intelligent vérifié, Etherscan affiche une page de contrat dédiée avec des onglets tels que « Contrat », « Lire le contrat », « Écrire un contrat » et « Événements ».

4. Les contrats non vérifiés affichent uniquement les informations de bytecode et ABI, sans fonctions ni variables lisibles par l'homme.

5. Les contrats vérifiés affichent le code source complet sous l'onglet « Contrat », ainsi que la version du compilateur, les paramètres d'optimisation et le type de licence.

Vérifier l'authenticité du contrat

1. Recherchez l'étiquette verte « Vérifié » à côté du nom du contrat dans le coin supérieur gauche de la page du contrat.

2. Cliquez sur l'onglet « Contrat » et faites défiler vers le bas pour afficher la section « Code source du contrat » – cela confirme que le bytecode déployé correspond à la source soumise.

3. Comparez la « version du compilateur » affichée sur Etherscan avec la version spécifiée dans la directive pragma du fichier Solidity d'origine.

4. Examinez l'état « Optimisation activée » : des paramètres d'optimisation incompatibles peuvent indiquer des écarts de falsification ou de recompilation.

5. Vérifiez le champ « Type de licence » ; l'absence ou l'utilisation de licences non standard peuvent signaler des pratiques de déploiement incomplètes ou obscurcies.

Interagir avec les fonctions en lecture seule

1. Passez à l'onglet « Lire le contrat » après avoir confirmé la vérification du contrat.

2. Chaque fonction publique ou externe apparaît sous la forme d'une ligne extensible contenant des champs de saisie et un bouton « Requête ».

3. Saisissez les paramètres requis en utilisant les types de données corrects : par exemple, les adresses doivent commencer par « 0x », les nombres doivent être décimaux ou hexadécimaux sans préfixes, sauf indication contraire.

4. Cliquez sur « Requête » pour exécuter l'appel sur le backend du nœud Ethereum ; les résultats apparaissent instantanément sous le bouton sans consommer de gaz.

5. Observez attentivement les valeurs de retour : certaines fonctions renvoient des tableaux, des structures ou des objets imbriqués qu'Etherscan restitue dans un format pliable de type JSON.

Analyse des événements et des journaux de contrat

1. Accédez à l'onglet « Événements » pour afficher les journaux émis associés à l'adresse du contrat.

2. Filtrez les événements par hachage de sujet, plage de blocs ou valeurs de paramètres indexés à l'aide des filtres intégrés.

3. Chaque entrée d'événement affiche le numéro de bloc, le hachage de transaction, l'horodatage et les paramètres décodés si la signature de l'événement est connue et publiée sur Etherscan.

4. Cliquez sur n'importe quel hachage de transaction pour ouvrir sa page de détails et inspecter les entrées de journal brutes ainsi que les opérations internes.

5. Croisez les données d'événement avec les appels de fonction dans l'onglet « Transactions » pour tracer les changements d'état déclenchés par des actions spécifiques de l'utilisateur.

Foire aux questions

Q : Pourquoi Etherscan affiche-t-il « Impossible de récupérer les données » lors de l'interrogation d'une fonction ? Ce message apparaît lorsque la fonction est annulée en raison d'entrées manquantes, de types incorrects ou de conditions qui échouent lors de l'exécution. Même les appels en lecture seule peuvent être annulés s'ils contiennent des instructions require().

Q : Puis-je faire confiance à l'ABI affiché sur Etherscan pour l'intégration hors chaîne ? Oui, à condition que le contrat soit vérifié — Etherscan génère automatiquement l'ABI à partir de la source soumise et le valide par rapport au bytecode en chaîne.

Q : Que signifie « Code de création de contrat » sous l'onglet « Contrat » ? Il s'agit du code d'initialisation utilisé lors du déploiement : il inclut les arguments du constructeur et le bytecode d'exécution intégré dans le champ de saisie de la transaction de création.

Q : Comment puis-je savoir si un contrat utilise des modèles de proxy tels que Transparent Proxy ou UUPS ? Vérifiez l'adresse « Implémentation » dans l'onglet « Contrat » — si elle est présente et différente de l'adresse principale, le contrat délègue la logique à un autre contrat déployé.