Skip to main content

Blockchain parser (source-available). Free for non-commercial use with attribution. Commercial & SaaS licenses available.

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

blockchain_scalpel-2.0.2.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

blockchain_scalpel-2.0.2-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

Details for the file blockchain_scalpel-2.0.2.tar.gz.

File metadata

  • Download URL: blockchain_scalpel-2.0.2.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for blockchain_scalpel-2.0.2.tar.gz
Algorithm Hash digest
SHA256 f0d36ee24cffa2a40653549c0526a01b1f9f4465cdb23189cfa7d2b2057596cc
MD5 10765fb1ff6453e095712c4ba4013a77
BLAKE2b-256 6531731200db4077a82b78c36a93510c72dc14bd1214d11a6dd4a04db8603641

See more details on using hashes here.

File details

Details for the file blockchain_scalpel-2.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for blockchain_scalpel-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b6dad830f78e528f81a27cc0c0334ac9373a1d5a8e880efad1096a98ca3e657a
MD5 397fc7e14efbeb925af999a01a4c19a5
BLAKE2b-256 cd8b783844767d001aac4a5e72a17dc34003b64149842933202977468afa4b3e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page