Aller au contenuBlockAssay

Collecte des données et provenance

P10-L02 · P10 · P10-M01

Consigner les identifiants, hauteurs de blocs, horodatages et limites du fournisseur

ILLUSTRATIVE · needs_review

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

SPECIFICATION_ONLY · ILLUSTRATIVE

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
Ouvrir la source primaire
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
Ouvrir la source primaire
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.

Testez votre raisonnement

P10-L02-Q1 · R est collecté à 12:12Z avec l’heure d’en-tête 12:00Z. Quel horodatage décrit l’enregistrement de l’événement ?
P10-L02-Q2 · Comment s’affichent 2500000 unités brutes avec six décimales ?
P10-L02-Q3 · Que démontre un SHA-256 concordant des octets stockés ?
P10-L02-Q4 · Seule la page 1 sur 2 est disponible. Quel énoncé reste fondé ?
P10-L02-Q5 · L’ID de transaction brut correspond ; l’inclusion n’est qu’une étiquette d’indexeur. Que reste-t-il ?