P02-L07 · P02 · P02-M02
Distinguer l’état du nœud, la latence de l’indexeur et l’absence de preuves
Prérequis: P02-L06
Objectifs pédagogiques
- Distinguer l’état du nœud, la latence de l’indexeur et l’absence de preuves
- Distinguer null, une erreur de transport et un zéro mesuré.
- Expliquer les limites de couverture et de délai de l’indexeur.
- Formuler un contrôle ciblé des données manquantes.
Version source EN · P02-L07 · 30 minutes estimées · needs_review
Étude en lecture seule. Aucune connexion de portefeuille, aucun argent réel, aucune phrase de récupération, clé privée, signature ou transaction de marché en direct. La durée est une estimation éditoriale ; les éléments visuels sont des spécifications, pas des composants déployés.
Pourquoi ce sujet compte
Un écran vide ne prouve pas qu’il ne s’est rien passé. Le parcours d’observation peut échouer ou prendre du retard indépendamment de l’événement du registre étudié.
Explication
Retracer le parcours d’observation
Une API de nœud retourne des données selon les paramètres d’une méthode et l’état disponible du nœud. Un indexeur construit une autre vue pour la recherche ou l’agrégation. Une interface affiche cette vue. Un résultat manquant peut provenir de différents niveaux ; ne les confondez pas en une seule conclusion sur la chaîne.
Solana getTransaction peut retourner null lorsque la transaction n’est pas trouvée au niveau de confirmation demandé [SOLRPC]. Les méthodes de reçu Ethereum distinguent aussi les reçus disponibles des résultats manquants [RPC]. La méthode et le contexte exacts importent davantage que le mot générique « vide ».
Quatre résultats semblables en apparence
Zéro est une mesure retournée sous une requête définie. Null est un résultat indisponible ou non trouvé selon la sémantique de la méthode. Une liste vide ne contient aucune ligne retournée sous ses filtres et sa couverture. Une expiration est un résultat de communication. Aucun de ces éléments n’est interchangeable sans preuve supplémentaire.
Un indexeur peut n’avoir traité que les données jusqu’à un bloc indiqué. Une requête portant sur un événement ultérieur ne peut alors en établir l’absence. N’inventez pas la ligne manquante ; signalez le manque de couverture. Un contrôle ultérieur doit conserver la requête d’origine et comparer des paramètres équivalents.
Diagnostiquer avec l’enregistrement utile le plus ciblé
Consignez le réseau, l’identifiant, la méthode, les paramètres, le niveau de confirmation ou le bloc, la source et le repère de récupération. Demandez ensuite le niveau manquant : contexte actuel de fin d’indexation, statut du nœud, disponibilité des archives ou enregistrement exact de la transaction. Répéter indéfiniment une requête inchangée n’ajoute pas de preuve.
Préserver l’incertitude dans le rapport
Utilisez « non retourné par la source S sous la requête Q » plutôt que « n’existe pas ». Si un dossier de nœud fourni contient un enregistrement alors qu’un indexeur s’arrête plus tôt, le retard est une explication raisonnable dans cet exercice. Cela reste une inférence fondée sur une couverture indiquée, pas une preuve que toute interface vide est sans danger.
Ne classez pas un actif comme sûr ou une personne comme inactive à partir d’observations manquantes. L’exhaustivité est une propriété à étayer, pas à déduire d’une page vide.
Classification des états de preuve
OBSERVED dans l’exercice : l’enregistrement fourni du nœud, la couverture de l’indexeur, la réponse vide, l’expiration et le solde nul dans son périmètre. INFERRED : le manque de couverture rend I1 compatible avec N1 dans le contexte indiqué. UNKNOWN : les frais de N2 et les avoirs antérieurs. INSUFFICIENT EVIDENCE : une liste vide, une expiration ou un seul instantané à zéro prouve une absence historique complète.
Terminologie
- RPC (appel de procédure à distance) : requête fondée sur une méthode auprès d’un nœud ou d’un fournisseur.
- Niveau de confirmation : niveau demandé de confirmation du réseau pour une observation ; son sens est propre au réseau.
- Indexeur : service de données dérivées permettant la recherche.
- Couverture : éléments inclus par une source.
- Null : résultat manquant selon la sémantique propre à la méthode.
Exemple historique
ILLUSTRATIVE. N1 fournit SIM-TX-Z dans le bloc120, avec exécution réussie. I1 a indexedThrough=118 et retourne un résultat vide pour Z. N2 expire. B1 retourne un solde0 pour ACCOUNT-Q au bloc119. Tous concernent SIM-NET ; les repères sont fictifs.
Spécifications visuelles
Panneau de preuves avec N1 bloc120, I1 couverture118, N2 expiration, B1 zéro119. Texte alternatif : les données manquantes ou indexées et un zéro mesuré répondent à des questions différentes.
Ce que les preuves établissent
Les types de réponse distincts de l’exercice et l’explication délimitée par la couverture.
Ce que les preuves n’établissent pas
Une absence globale de transaction, un historique complet, l’authenticité des sources ou l’état réel actuel du service.
Erreurs fréquentes
- Null signifie zéro.
- Un indexeur vide signifie aucune transaction.
- Une expiration signifie aucun frais.
Exercice pratique
Classifiez chaque résultat et rédigez une note d’observation manquante. I1 contredit-il N1 ? N2 établit-il l’absence de frais ? B1 peut-il établir que Q n’a jamais détenu d’actifs ?
Présenter un court tableau des éléments de preuve et le raisonnement, uniquement à partir du matériel fourni. Répartition suggérée : étude 12 min, inspection/calcul 8 min, correction/quiz 10 min.
Afficher la correction détaillée
N1 est un enregistrement d’inclusion fourni. I1 manque de couverture pour120 ; sa réponse vide ne contredit donc pas N1 : le retard est INFERRED sous la couverture indiquée. N2 ne fournit aucune mesure d’exécution ou de frais. B1 est un zéro mesuré uniquement à119, pas un historique complet. Les frais à N2 et les avoirs antérieurs de Q restent UNKNOWN.
Barème de revue : 1 point pour chacun des critères suivants : périmètre exact, provenance des sources/données pédagogiques, raisonnement correct, limites explicites et manipulation sûre hors ligne (5 au total). Une observation inventée ou une attribution humaine non étayée exige une correction quel que soit le score. Il s’agit d’un retour formatif, pas d’une certification.
Liste de contrôle
- Méthode et paramètres.
- Type de résultat retourné.
- Fin d’indexation, bloc et niveau de confirmation.
- Manque de couverture.
- Prochaine requête ciblée.
Résumé
Un écran vide ne prouve pas qu’il ne s’est rien passé. Le parcours d’observation peut échouer ou prendre du retard indépendamment de l’événement du registre étudié. Le matériel fourni permet de distinguer les types de réponse de l’exercice et fournit une explication délimitée par la couverture. Il n’établit ni une absence globale de transaction, ni un historique complet, ni l’authenticité des sources, ni l’état réel actuel du service.
Résumé
- Distinguer null, une erreur de transport et un zéro mesuré.
- Expliquer les limites de couverture et de délai de l’indexeur.
- Formuler un contrôle ciblé des données manquantes.
Leçon suivante
P02-L08 après examen de cet exercice et de ses prérequis.
Outils
NONE. Le catalogue de référence n’exige aucun accès au produit pour cette leçon. Utiliser le matériel figé/hors ligne.
Sources et limites des affirmations
- [RPC] Ethereum JSON-RPC — Statut du reçu, contexte du bloc et résultats d’API dans le périmètre du réseau. Vérifié 2026-10-01.
- [SOLRPC] Solana getTransaction — Résultats délimités par le niveau de confirmation et null lorsque la transaction n’est pas trouvée ou confirmée. Vérifié 2026-10-01.
Les valeurs synthétiques sont des données d’entrée d’exercice créées par l’auteur. Les valeurs historiques éventuelles doivent utiliser le jeu de données lié et sa provenance plus restreinte. L’inspection des sources ne constitue pas une acceptation éditoriale indépendante.
Spécifications visuelles
P02-L07-V01
Distinguer l’état du nœud, la latence de l’indexeur et l’absence de preuves
Données pédagogiques illustratives ; pas un écran en direct
Panneau de preuves avec N1 bloc120, I1 couverture118, N2 expiration, B1 zéro119. Texte alternatif : les données manquantes ou indexées et un zéro mesuré répondent à des questions différentes.
les données manquantes ou indexées et un zéro mesuré répondent à des questions différentes.
390px : lignes empilées avec un équivalent textuel complet ; acceptation du rendu à 768px/sur ordinateur en attente
Prose RTL ; identifiants et unités numériques restent LTR ; préserver le sens factuel des flèches
FIX-P02-L07
Sources et limites des affirmations
RPC · PRIMARY_DOCUMENTATION
Ethereum JSON-RPC
- Affirmation étayée
- Statut du reçu, contexte du bloc et résultats d’API dans le périmètre du réseau.
- Limite de vérification
- Page de documentation primaire inspectée pour le mécanisme indiqué ou la publication attribuée ; elle n’authentifie pas les données illustratives.
- Date de vérification
- 2026-10-01
https://ethereum.org/en/developers/docs/apis/json-rpc/
SOLRPC · PRIMARY_DOCUMENTATION
Solana getTransaction
- Affirmation étayée
- Résultats délimités par le niveau de confirmation et null lorsque la transaction n’est pas trouvée ou confirmée.
- Limite de vérification
- Page de documentation primaire inspectée pour le mécanisme indiqué ou la publication attribuée ; elle n’authentifie pas les données illustratives.
- Date de vérification
- 2026-10-01
https://solana.com/docs/rpc/http/gettransaction
Provenance des données
id: FIX-P02-L07
dataStatus: ILLUSTRATIVE
source: Original teaching fixture embedded below; not externally observed
observedAt: null
timeBasis: SIM/T markers are fictional; no real timestamp or chain observation
scope: Invalid training labels; no usable wallet, key or signature