P10-L02 · P10 · P10-M01
Registar identificadores, alturas de bloco, carimbos temporais e limitações do fornecedor
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
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
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
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.