How zaidalhawamdeh/bitcoin-forensics works
This is a reproducible Bitcoin-mining forensics research repository, not a service: researchers inspect supplied chain and Stratum-share data, run focused analyses, and compare recomputed measurements with written findings. Its main domain stages are share calibration, block-version classification and skew analysis, and interpretation of saturated version masks; separate work examines a solo-mined block and hash-search hypotheses. The sampled scripts show direct data reads and one experiment-results write. Other documented investigations are represented without asserting unsampled implementation details.
Main entry points: verify_version_class.py Version-class analysis · verify_saturated.py Saturation analysis · verify_calibration.py Calibration verifier · verify_version_skew.py Version-skew analysis
Components 22
Share calibration
- Share submissions
calibration/calibration_submits.csv.gz - Calibration verifier
calibration/repro/verify_calibration.py - Calibration findings
calibration/CALIBRATION.md
Chain analyses
- Block headers
data/headers.json - Block fields
data/blocks.json - Class exploration set
data/version_class_A.jsonl - Class holdout set
data/version_class_B.jsonl - Pool attribution
data/version_class_B_pools.jsonl - Version-skew analysis
repro/verify_version_skew.py - Version-class analysis
repro/verify_version_class.py - Saturation analysis
repro/verify_saturated.py
Hash experiments
- Nonce-range experiment
merkle-templates/followup_ranges.py - Experiment results
merkle-templates/results_followup.json
Findings and methods
- Solo-mined block
findings/CASE_957382.md - Version-skew finding
findings/CASE_VERSION_SKEW.md - Version-class finding
findings/CASE_VERSION_CLASS.md - Saturated-pattern finding
findings/CASE_VERSION_CLASS.md - Prior-work limits
PRIOR_WORK.md - Hashpower prior work
HASHPOWER_PRIOR_WORK.md - Work-selection prior
WORK_SELECTION_PRIOR.md - Pre-registered test
method/PRECOMMIT.md
Other components
- Researcher
Connections 12
- Researcher → Calibration verifier: runs
- Calibration verifier → Share submissions: reads
- Researcher → Version-skew analysis: runs
- Version-skew analysis → Block headers: reads
- Researcher → Version-class analysis: runs
- Version-class analysis → Class exploration set: reads
- Version-class analysis → Class holdout set: reads
- Researcher → Saturation analysis: runs
- Saturation analysis → Class holdout set: reads
- Saturation analysis → Pool attribution: reads
- Researcher → Nonce-range experiment: runs
- Nonce-range experiment → Experiment results: writes