Comment trouver votre signature de transaction Solana et vérifier son statut

Trouver votre signature de transaction Solana

1. Après avoir soumis une transaction via Solana CLI, la sortie affichera une chaîne hexadécimale de 64 caractères intitulée Signature : . Il s'agit de votre signature de transaction unique.

2. Lorsque vous utilisez les extensions de portefeuille Phantom ou Backpack, le modal de confirmation de transaction affiche la signature immédiatement après la signature – elle apparaît sous la forme d'un long hachage sous l'étiquette « Confirmé ».

3. Dans les applications Solana JavaScript SDK, la méthode sendTransaction renvoie une chaîne contenant la signature avant confirmation ; les développeurs doivent capturer et stocker cette valeur explicitement.

4. Si vous interagissez avec une dApp qui ne fait pas apparaître la signature, inspectez la console de développement du navigateur sous l'onglet Réseau et filtrez les appels sendTransaction ou getTransaction RPC pour localiser la réponse brute contenant la signature.

5. Les sessions WalletConnect v2 émettent des événements de transaction contenant la signature dans le champ transactionId de la charge utile émise – accessible via les écouteurs d'événements enregistrés sur l'objet de session.

Vérification de l'état de la transaction via les points de terminaison RPC

1. Utilisez la méthode getTransaction RPC avec la signature et le niveau d'engagement (par exemple, confirmé ou finalisé ) pour récupérer tous les détails d'exécution, y compris les clés de compte, les instructions et l'état du retour.

2. Soumettez la même signature à getSignatureStatuses pour obtenir un résumé d'état léger — utile pour interroger sans récupérer l'historique complet, en particulier dans les interfaces frontales.

3. Lors d'une requête sur des points de terminaison RPC publics tels que https://api.mainnet-beta.solana.com , incluez un jsonrpc , une méthode , des params et un identifiant valides dans le corps du POST - un échec de formatage correct entraîne un HTTP 400 ou des réponses vides.

4. Un statut null de getTransaction indique que la transaction n'a pas encore été traitée ou a été abandonnée en raison d'un délai d'attente ou d'un épuisement des frais.

5. Le champ err à l'intérieur de l'objet de transaction renvoyé révèle les raisons d'échec en chaîne, telles que InstructionError , AccountInUse ou InvalidArgument , qui sont essentielles au débogage des interactions ayant échoué.

Utilisation des explorateurs de blocs pour un contexte lisible par l'homme

1. Collez la signature de 64 caractères directement dans la barre de recherche de Solana Explorer ( explorer.solana.com ) ou Solscan ( solscan.io ) pour charger une répartition visuelle des comptes impliqués, des étapes d'instructions et des transferts de jetons.

2. Chaque explorateur affiche des indicateurs d'état codés par couleur : vert pour Succès , rouge pour Échec et gris pour En attente , ce qui permet un tri rapide sans analyser le JSON brut.

3. L'onglet Comptes répertorie toutes les adresses référencées dans la transaction, avec des hyperliens vers leurs historiques de soldes respectifs et les informations sur la propriété du programme.

4. Pour les transactions versionnées, les explorateurs affichent séparément les références des tables de recherche d'adresses, indiquant quels indices correspondent à quelles clés publiques, facilitant ainsi l'analyse des charges utiles des transactions compressées.

5. Les horodatages des transactions affichés sur les explorateurs dérivent du numéro d'emplacement et de l'heure du bloc ; les écarts entre l'horloge locale et l'heure du cluster peuvent entraîner des retards dans les mises à jour d'état.

Interprétations erronées courantes des états de transaction

1. Traité n'équivaut pas à Confirmé : une transaction peut être traitée par un validateur mais rester non confirmée sur le réseau jusqu'à ce qu'elle atteigne le nombre requis de confirmations.

2. Le statut finalisé nécessite ≥ 31 emplacements de profondeur, ce qui signifie que la transaction réside dans un bloc dont il est très peu probable qu'il soit annulé ; cela diffère entièrement du modèle de finalité d’Ethereum.

3. Une transaction marquée BlockhashNotFound indique que le blockhash utilisé lors de la soumission a expiré. Les blockhash Solana ne sont valables que pendant environ 2 minutes, nécessitant une actualisation fréquente.

4. Les erreurs de nœud introuvable proviennent souvent d'interrogations de points de terminaison RPC obsolètes ou de couches proxy mal configurées : le passage à un autre fournisseur de points de terminaison résout instantanément la plupart de ces problèmes.

5. Les signatures en double n'impliquent pas une exécution en double : Solana applique l'idempotence grâce à une réutilisation récente du blockhash et à une logique de déduplication au niveau des instructions intégrée dans le runtime Sealevel.

Foire aux questions

Q : Pourquoi ma transaction affiche-t-elle « Introuvable » même si je la vois dans l'historique de mon portefeuille ? R : Les portefeuilles mettent parfois en cache localement les transactions en attente avant qu'elles ne se propagent à la couche RPC : attendez 15 à 30 secondes et réessayez la requête, ou passez à un autre point de terminaison RPC.

Q : Puis-je récupérer une signature de transaction après avoir fermé le navigateur ou redémarré le portefeuille ? R : Non – à moins que l'application ne la stocke explicitement hors chaîne ou ne la connecte à un service backend, la signature est perdue une fois le contexte client terminé.

Q : Que signifie « Transaction trop importante » lorsque vous essayez de récupérer des détails ? R : Cela se produit lorsque la transaction dépasse la limite sérialisée de 1 232 octets de Solana ; Les transactions versionnées utilisant des tables de recherche d'adresses évitent cela en compressant les adresses de compte.

Q : Existe-t-il un moyen de regrouper plusieurs signatures en un seul appel RPC ? R : Oui : utilisez getSignatureStatuses avec un tableau allant jusqu'à 1 000 signatures en une seule requête ; les réponses renvoient les objets d'état dans l'ordre correspondant.