Skip to main content

Blockchain Scalpel

(formerly: Blockchain parser / Russian scalpel)

Русский скальпель

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

Blockchain Scalpel is a lightweight script for parsing raw blkXXXXX.dat files of the Bitcoin blockchain database.

The tool provides direct access to blockchain data stored on disk and allows exploring the main database as close as possible to its original binary representation.

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


Overview

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.


Typical Usage

  • 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 in blkXXXXX.dat files into a simple, human-readable format.

Make sure to configure the paths for:

  • input blkXXXXX.dat files
  • output directory for parsing results

Source Code

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


License

Important: License by version

  • Versions up to and including v1.0.0-gpl are licensed under GPL-3.0
  • Versions starting from v2.0.0 are distributed under the Blockchain Scalpel License (source-available)

License summary (v2.0.0 and later)

  • Free for non-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 the LICENSE file.


Commercial Licensing

Commercial licenses, including licenses permitting use in commercial organizations or SaaS / cloud / hosted environments, are available under negotiated terms.

For commercial licensing inquiries, contact:

Denis Leonov
466611@gmail.com


Warranty

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

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

See WARRANTY.md for details.


Notes

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

Questions and licensing inquiries are welcome via email.


© Denis Leonov. All rights reserved.

Metadata

Release files for blockchain-scalpel 2.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for blockchain-scalpel 2.0.3
File Size Uploaded
blockchain_scalpel-2.0.3.tar.gz 9.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for blockchain-scalpel 2.0.3
File Interpreter ABI Platform
blockchain_scalpel-2.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 19.0 kB

Release files / blockchain_scalpel-2.0.3.tar.gz

Download URL blockchain_scalpel-2.0.3.tar.gz
Size 9.6 kB
Tags Source
SHA-256 checksum
How to use checksums
6b6dea9330d3c300731f326fc7ebe20d443b734f30930d52d6d95441e2a11397
BLAKE2b-256 checksum
How to use checksums
00296644ae1170a59112388b79997d7d92af6bdff75cfa8d1d8bda53c0ca684a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.1

Release files / blockchain_scalpel-2.0.3-py3-none-any.whl

Download URL blockchain_scalpel-2.0.3-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6e9b2afae00b067c7c372c0c89a8f5dc4fb63c5afc2d6abb55229ce5991ab9be
BLAKE2b-256 checksum
How to use checksums
c4a47e111b33157eaf40c03bff2fd6ebf1c996c224f40cbb5458aa3b19f4e3b1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.1

Release history Release notifications | RSS feed

This release

2.0.3 This release

2 release files

2.0.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page