Metadata-Version: 2.4
Name: blockchain-scalpel
Version: 2.0.2
Summary: Blockchain parser (source-available). Free for non-commercial use with attribution. Commercial & SaaS licenses available.
Author: Denis Leonov
License-Expression: LicenseRef-Blockchain-Scalpel
Project-URL: Homepage, https://github.com/ragestack/blockchain-parser
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 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.
