Ir para o conteúdoBlockAssay

Recolha de dados e proveniência

P10-L02 · P10 · P10-M01

Registar identificadores, alturas de bloco, carimbos temporais e limitações do fornecedor

ILLUSTRATIVE · needs_review

Pré-requisitos: P10-L01

Objetivos de aprendizagem

  • Registar identificadores, alturas de bloco, carimbos temporais e limitações do fornecedor
  • Conservar o tempo do evento, o tempo de recolha e a cobertura do fornecedor em campos separados.

Por que importa

Uma captura pode parecer estável enquanto o fornecedor altera etiquetas ou confirmações. Um carimbo temporal sem base de tempo pode fazer um evento antigo parecer uma nova observação.

Explicação

Trate cada recolha como um pequeno pacote de evidências: método de pedido e URL exato, rede, identificador do registo, referência de bloco ou slot, estado da resposta, hora UTC real da recolha, bytes de resposta e soma de controlo criptográfica. Mantenha separado o campo de tempo do evento do fornecedor. Guarde primeiro os dados e derive depois uma tabela; caso contrário, leitores posteriores não distinguem conteúdo do fornecedor de alterações do analista. Nunca inclua credenciais nem material de sessões privadas num pacote público.

Uma soma de controlo de identificador reproduz bytes, não a verdade. Um ID de transação recalculado localmente prova que a serialização bruta fornecida corresponde ao identificador; não prova, por si só, inclusão canónica, finalidade nem identidade humana. A etiqueta de confirmação de um indexador tem o seu próprio limite de fonte. Registe páginas em falta, truncagem, política de reorganização da cadeia e tipos de evento não suportados em vez de os eliminar silenciosamente.

Para valores derivados, indique a unidade e a operação. Mantenha os inteiros brutos antes da apresentação decimal. Wallet Intelligence pode ajudar a examinar registos, mas esta lição não cria um relatório real nem infere a cobertura da ferramenta a partir da interface. A proveniência acompanha cada afirmação desde a resposta guardada até ao cálculo.

Terminologia

Tempo de recolha: quando uma resposta foi recolhida.

Tempo do evento: carimbo temporal declarado pelo registo de cadeia do evento.

Soma de controlo: impressão digital dos bytes guardados.

Cobertura: registos e tipos de evento incluídos pelo fornecedor.

Exemplo histórico

ILLUSTRATIVE: a resposta R indica o bloco 500 com hora de cabeçalho 12:00Z. É recolhida às 12:12Z e lista 2500000 unidades brutas com seis casas decimais. O fornecedor P indica a página 1 de 2; a página 2 está indisponível. A apresentação derivada é 2.5 unidades, não 2,500,000 tokens inteiros. O conjunto estipula estes valores; nenhum pedido foi feito.

Especificações visuais

Cronologia de transação com duas faixas: tempo declarado do evento às 12:00Z e recolha às 12:12Z. Inclua conversão de unidades brutas e uma lacuna evidente da página-2.

Legenda: A proveniência ilustrativa separa o tempo do evento do momento em que a resposta do fornecedor foi recolhida.

SPECIFICATION_ONLY — o visual renderizado não foi produzido nem revisto independentemente.

O que a evidência demonstra

O conjunto permite uma conversão de unidades reprodutível e uma observação da página-1 claramente delimitada. O tempo da recolha e o do evento têm significados registados diferentes.

O que a evidência não demonstra

Uma soma de controlo correspondente não certifica a correção do fornecedor. A página 2 em falta impede afirmar uma contagem completa de eventos; uma hora de cabeçalho não estabelece o instante exato de chegada no relógio.

Erros comuns

Calcular o hash de uma captura em vez de guardar a resposta; substituir o tempo do evento pelo da recolha; eliminar unidades brutas; comunicar uma contagem completa a partir de uma só página disponível.

Exercício prático

Escreva uma linha de proveniência para R, calcule o montante apresentado e reformule «todos os eventos ocorreram às 12:12Z». Inclua a página indisponível e uma etapa de verificação independente.

Mostrar correção detalhada

Use URL/registo fictício R, rede N, bloco 500, eventTime 12:00Z (declarado no cabeçalho), retrievedAt 12:12Z, fornecedor P, rawAmount 2500000, decimals 6, displayAmount 2.5, cobertura página 1/2 com página 2 indisponível. A afirmação correta é «R foi recolhido às 12:12Z; a hora declarada do seu bloco é 12:00Z». Preserve os bytes exatos e a soma de controlo; verifique independentemente a serialização bruta e a referência de bloco antes de ampliar afirmações de confirmação. A contagem completa de eventos continua sem evidência suficiente.

Lista de verificação

  • Preserve identificadores exatos e unidades brutas.
  • Separe carimbos temporais de evento e recolha.
  • Guarde os bytes antes da derivação.
  • Revele paginação incompleta e finalidade indexada.

Resumo

A proveniência liga registos, recolhas e afirmações derivadas sem transformar uma soma de controlo num certificado de verdade.

Resumo

  • Preserve bytes de resposta e contexto do pedido.
  • A base temporal e a de unidades acompanha cada valor.
  • Cobertura parcial não sustenta uma contagem completa.

Próxima lição

P10-L03

Ferramentas

Utilize a ferramenta BlockAssay indicada apenas como contexto de leitura de evidências. Esta lição não cria resultados de ferramenta, sessões de conta nem direitos de acesso. Exercício offline; não assine, implemente, aprove nem financie nada.

Fontes e limites das afirmações

  • API: Especificação da API pública Esplora — Rotas GET, satoshis inteiros e campos indexados de confirmação e gasto das saídas. Limite: Apenas documentação do mecanismo; os valores ilustrativos originais são estipulados, não são observações. Os registos históricos têm proveniência congelada separadamente e lacunas de recolha explícitas.
  • BTC: Guia de desenvolvimento Bitcoin — transações — As referências das entradas identificam saídas de transações anteriores; os scripts não identificam uma pessoa. Limite: Apenas documentação do mecanismo; os valores ilustrativos originais são estipulados, não são observações. Os registos históricos têm proveniência congelada separadamente e lacunas de recolha explícitas.

Classificações de evidência

ILLUSTRATIVE — entradas offline inteiramente fictícias; nenhuma observação atual.

Data de observação

null — nenhuma observação real

Versão do conteúdo

1

Data de revisão

null

Estado de revisão

needs_review

Especificações visuais

P10-L02-V01

SPECIFICATION_ONLY · ILLUSTRATIVE

Registar identificadores, alturas de bloco, carimbos temporais e limitações do fornecedor

A proveniência ilustrativa separa o tempo do evento do momento em que a resposta do fornecedor foi recolhida.

Cronologia de transação com duas faixas: tempo declarado do evento às 12:00Z e recolha às 12:12Z. Inclua conversão de unidades brutas e uma lacuna evidente da página-2.

Cronologia de transação com duas faixas: tempo declarado do evento às 12:00Z e recolha às 12:12Z. Inclua conversão de unidades brutas e uma lacuna evidente da página-2.

A 390 px, empilhe observações, pressupostos, lacunas e conclusão; mantenha os IDs completos e um equivalente textual integral. As tabelas largas deslocam-se localmente.

A prosa pode seguir RTL; os IDs, quantidades e eixos temporais permanecem LTR. Preserve o sentido das dependências.

P10-L02-ILLUSTRATIVE-v1

Fontes e limites das afirmações

API · PRIMARY_DOCUMENTATION

Especificação da API pública Esplora

Afirmação sustentada
Rotas GET, satoshis inteiros e campos indexados de confirmação e gasto das saídas.
Limite de verificação
Apenas documentação do mecanismo; os valores ilustrativos originais são estipulados, não são observações. Os registos históricos têm proveniência congelada separadamente e lacunas de recolha explícitas.
Data de verificação
2026-10-02
Abrir fonte primária
https://github.com/Blockstream/esplora/blob/master/API.md

BTC · PRIMARY_DOCUMENTATION

Guia de desenvolvimento Bitcoin — transações

Afirmação sustentada
As referências das entradas identificam saídas de transações anteriores; os scripts não identificam uma pessoa.
Limite de verificação
Apenas documentação do mecanismo; os valores ilustrativos originais são estipulados, não são observações. Os registos históricos têm proveniência congelada separadamente e lacunas de recolha explícitas.
Data de verificação
2026-10-02
Abrir fonte primária
https://developer.bitcoin.org/devguide/transactions.html

Proveniência dos dados

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.

Teste seu raciocínio

P10-L02-Q1 · R é recolhido às 12:12Z com hora de cabeçalho 12:00Z. Qual carimbo descreve o registo do evento?
P10-L02-Q2 · Como se apresentam 2500000 unidades brutas com seis casas decimais?
P10-L02-Q3 · O que estabelece um SHA-256 correspondente dos bytes guardados?
P10-L02-Q4 · Só está disponível a página 1 de 2. Qual afirmação se mantém?
P10-L02-Q5 · O ID da transação bruta corresponde; a inclusão é apenas uma etiqueta do indexador. O que permanece?