Repository files navigation

(formerly: Blockchain parser / Russian scalpel)

Author: Denis Leonov (ragestack)
Contact:466611@gmail.com

Blockchain Scalpel is a lightweight script for parsing rawblkXXXXX.datfiles of the Bitcoin blockchain database.

The tool provides direct access to blockchain data stored on disk and allowsexploring the main database as close as possible to its original binaryrepresentation.

The parser is also compatible with many altcoins with minimal adjustments.

Blockchain Scalpel is a low-level blockchain data parser designed for research,analysis, and infrastructure-level processing.

The project focuses on:

• transparent and deterministic parsing
• minimal dependencies
• direct work with raw blockchain data
• long-term maintainability

No third-party modules or libraries are required.
A standard Python installation is sufficient.

pip install blockchain-scalpel

This will install theblockchain-scalpel command-line tool.

python blockchain-parser.py<blocks_dir><result_dir>

After installation from PyPI:

blockchain-scalpel<blocks_dir><result_dir>

This is equivalent to:

python blockchain-parser.py<blocks_dir><result_dir>

Where:

• <blocks_dir> is the directory containing blkXXXXX.dat files

• <result_dir> is the directory for parsed output

• academic and scientific research
• grant-funded university projects
• blockchain data analysis and forensics
• internal analytics and data processing pipelines

The script converts the raw blockchain database stored inblkXXXXX.datfiles into a simple, human-readable format.

Make sure to configure the paths for:

• inputblkXXXXX.dat files
• output directory for parsing results

Repository:
https://github.com/ragestack/blockchain-parser

PyPI package:https://pypi.org/project/blockchain-scalpel/

• Versionsup to and includingv1.0.0-gpl are licensed underGPL-3.0
• Versionsstarting fromv2.0.0 are distributed under theBlockchain Scalpel License (source-available)

• Free fornon-commercial use with mandatory attribution
• Academic and grant-funded research is permitted
• Commercial use requires a paid license
• SaaS / cloud / hosted use is not permitted without a commercial license

See the full license text in theLICENSE file.

Commercial licenses, including licenses permitting use in commercialorganizations or SaaS / cloud / hosted environments, are available undernegotiated terms.

For commercial licensing inquiries, contact:

Denis Leonov
466611@gmail.com

A limited compatibility warranty is provided for changes introduced by theauthor related to new or updated blockchain block formats.

This warranty is limited in scope and does not constitute an SLA.

SeeWARRANTY.md for details.

If this project is useful for your research or work, attribution to the authoris required.

Questions and licensing inquiries are welcome via email.

© Denis Leonov. All rights reserved.