P10-L02 · P10 · P10-M01
Consigner les identifiants, hauteurs de blocs, horodatages et limites du fournisseur
Prérequis: P10-L01
Objectifs pédagogiques
- Consigner les identifiants, hauteurs de blocs, horodatages et limites du fournisseur
- Conserver séparément l’heure de l’événement, l’heure de collecte et la couverture du fournisseur.
Pourquoi ce sujet compte
Une capture peut paraître stable alors que son fournisseur change les étiquettes ou confirmations. Un horodatage sans base temporelle peut faire passer un ancien événement pour une nouvelle observation.
Explication
Traitez chaque collecte comme un petit dossier de preuves : méthode de requête et URL exacte, réseau, identifiant d’enregistrement, référence de bloc ou slot, statut de réponse, heure réelle de collecte UTC, octets de réponse et somme de contrôle cryptographique. Gardez séparé le champ d’heure d’événement du fournisseur. Stockez d’abord les données, puis dérivez un tableau ; sinon les lecteurs ultérieurs ne peuvent distinguer le contenu du fournisseur des modifications de l’analyste. N’incluez jamais d’identifiants d’accès ni de données de session privée dans un dossier public.
Une somme de contrôle d’identifiant reproduit des octets, pas la vérité. Un ID de transaction recalculé localement prouve que la sérialisation brute fournie correspond à cet identifiant ; il ne prouve pas à lui seul l’inclusion canonique, la finalité ni l’identité humaine. L’étiquette « confirmé » d’un indexeur a sa propre limite de source. Consignez les pages manquantes, la troncature, la politique de réorganisation de chaîne et les types d’événement non pris en charge au lieu de les éliminer silencieusement.
Pour les valeurs dérivées, indiquez l’unité et l’opération. Gardez les entiers bruts avant l’affichage décimal. Wallet Intelligence peut aider à examiner les enregistrements, mais cette leçon ne crée aucun rapport réel et ne déduit pas la couverture de l’outil à partir de l’interface. La provenance accompagne chaque affirmation depuis la réponse stockée jusqu’au calcul.
Terminologie
Heure de collecte : moment où une réponse a été collectée.
Heure de l’événement : horodatage déclaré par l’enregistrement de chaîne de l’événement.
Somme de contrôle : empreinte des octets stockés.
Couverture : enregistrements et types d’événement inclus par un fournisseur.
Exemple historique
ILLUSTRATIVE : la réponse R indique le bloc 500 avec l’heure d’en-tête 12:00Z. Elle est collectée à 12:12Z et liste 2500000 unités brutes avec six décimales. Le fournisseur P indique la page 1 sur 2 ; la page 2 est indisponible. L’affichage dérivé est 2.5 unités, et non 2,500,000 tokens entiers. Ces valeurs sont stipulées par le jeu de données ; aucune requête n’a été faite.
Spécifications visuelles
Chronologie de transaction à deux pistes : heure d’événement déclarée à 12:00Z et collecte à 12:12Z. Ajoutez la conversion des unités brutes et une lacune visible pour la page-2.
Légende : La provenance illustrative sépare l’heure de l’événement de celle de collecte d’une réponse du fournisseur.
SPECIFICATION_ONLY — le visuel rendu n’a pas été produit ni examiné indépendamment.
Ce que les preuves établissent
Le jeu de données permet une conversion d’unités reproductible et une observation clairement bornée à la page-1. L’heure de collecte et celle de l’événement ont des significations enregistrées différentes.
Ce que les preuves n’établissent pas
Une somme de contrôle concordante ne certifie pas l’exactitude du fournisseur. L’absence de la page 2 empêche d’affirmer un décompte complet des événements ; une heure d’en-tête n’établit pas l’heure exacte d’arrivée sur l’horloge.
Erreurs fréquentes
Hacher une capture au lieu de conserver la réponse ; remplacer l’heure de l’événement par l’heure de collecte ; supprimer les unités brutes ; annoncer un décompte complet à partir d’une seule page disponible.
Exercice pratique
Rédigez une ligne de provenance pour R, calculez son montant affiché et reformulez « tous les événements ont eu lieu à 12:12Z ». Incluez la page indisponible et une étape de vérification indépendante.
Afficher la correction détaillée
Utilisez l’URL/enregistrement fictif R, réseau N, bloc 500, eventTime 12:00Z (déclaré dans l’en-tête), retrievedAt 12:12Z, fournisseur P, rawAmount 2500000, decimals 6, displayAmount 2.5, couverture page 1/2 avec page 2 indisponible. L’énoncé correct est « R a été collecté à 12:12Z ; son heure de bloc déclarée est 12:00Z ». Conservez les octets exacts de réponse et la somme de contrôle ; vérifiez indépendamment la sérialisation brute et la référence de bloc avant d’étendre les affirmations de confirmation. Le décompte complet des événements reste insuffisamment étayé.
Liste de contrôle
- Conservez les identifiants exacts et les unités brutes.
- Séparez les horodatages d’événement et de collecte.
- Sauvegardez les octets avant de dériver les résultats.
- Signalez la pagination incomplète et la finalité indexée.
Résumé
La provenance relie enregistrements, collectes et affirmations dérivées sans transformer une somme de contrôle en certificat de vérité.
Résumé
- Conservez les octets de réponse et le contexte de requête.
- La base temporelle et la base d’unité accompagnent chaque valeur.
- Une couverture partielle ne permet pas un décompte complet.
Leçon suivante
P10-L03
Outils
Utilisez l’outil BlockAssay nommé uniquement comme contexte de lecture des preuves. Cette leçon ne crée aucune sortie d’outil, session de compte ni droit d’accès. Exercice hors ligne ; ne signez, ne déployez, n’approuvez et ne financez rien.
Sources et limites des affirmations
- API: Spécification de l’API publique Esplora — Routes GET, satoshis entiers et champs indexés de confirmation et de dépense des sorties. Limite : Documentation du mécanisme uniquement ; les valeurs illustratives originales sont stipulées, pas observées. Les enregistrements historiques disposent d’une provenance figée séparément et de lacunes de collecte explicites.
- BTC: Guide développeur Bitcoin — transactions — Les références des entrées identifient les sorties de transactions antérieures ; les scripts n’identifient pas un humain. Limite : Documentation du mécanisme uniquement ; les valeurs illustratives originales sont stipulées, pas observées. Les enregistrements historiques disposent d’une provenance figée séparément et de lacunes de collecte explicites.
Classification des preuves
ILLUSTRATIVE — entrées hors ligne entièrement fictives ; aucune observation actuelle.
Date d’observation
null — aucune observation réelle
Version du contenu
1
Date de révision
null
Statut de révision
needs_review
Spécifications visuelles
P10-L02-V01
Consigner les identifiants, hauteurs de blocs, horodatages et limites du fournisseur
La provenance illustrative sépare l’heure de l’événement de celle de collecte d’une réponse du fournisseur.
Chronologie de transaction à deux pistes : heure d’événement déclarée à 12:00Z et collecte à 12:12Z. Ajoutez la conversion des unités brutes et une lacune visible pour la page-2.
Chronologie de transaction à deux pistes : heure d’événement déclarée à 12:00Z et collecte à 12:12Z. Ajoutez la conversion des unités brutes et une lacune visible pour la page-2.
À 390 px, empilez observations, hypothèses, lacunes et conclusion ; conservez les IDs complets et un équivalent textuel intégral. Tout tableau large défile localement.
La prose peut suivre RTL ; les IDs, quantités et axes temporels restent LTR. Préservez le sens des dépendances.
P10-L02-ILLUSTRATIVE-v1
Sources et limites des affirmations
API · PRIMARY_DOCUMENTATION
Spécification de l’API publique Esplora
- Affirmation étayée
- Routes GET, satoshis entiers et champs indexés de confirmation et de dépense des sorties.
- Limite de vérification
- Documentation du mécanisme uniquement ; les valeurs illustratives originales sont stipulées, pas observées. Les enregistrements historiques disposent d’une provenance figée séparément et de lacunes de collecte explicites.
- Date de vérification
- 2026-10-02
https://github.com/Blockstream/esplora/blob/master/API.md
BTC · PRIMARY_DOCUMENTATION
Guide développeur Bitcoin — transactions
- Affirmation étayée
- Les références des entrées identifient les sorties de transactions antérieures ; les scripts n’identifient pas un humain.
- Limite de vérification
- Documentation du mécanisme uniquement ; les valeurs illustratives originales sont stipulées, pas observées. Les enregistrements historiques disposent d’une provenance figée séparément et de lacunes de collecte explicites.
- Date de vérification
- 2026-10-02
https://developer.bitcoin.org/devguide/transactions.html
Provenance des données
id: P10-L02-ILLUSTRATIVE-v1
dataStatus: ILLUSTRATIVE
observedAt: null
source: Original offline scenario in realOrHistoricalExample
scope: Fictional stipulated labels and values. No wallet, deployment, transaction, token launch or production observation.