Merge pull request #29 from ragestack/release/v2

Release v2.0.0: new license, docs, and parser updates

Author: ragestack

CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+## 2.0.0
+
+### Licensing
+- License changed to a source-available model.
+- Free for non-commercial use with attribution.
+- Commercial use and any SaaS / cloud / hosted use require a paid license.
+- Added a limited compatibility warranty related to block-format updates.
+
+### Technical changes
+- Added support for XOR-key handling when parsing `blocksdir` `*.dat` files.
+  - The parser now detects whether an XOR key applies to the block files.
+  - If no XOR key is present, or if the key is effectively zero, block files
+    are parsed directly without decryption.
+  - Compatible with existing `blocksdir` layouts and newly initialized ones
+    using `blocksxor` (default: enabled).
+
+- Improved incremental parsing behavior.
+  - The parser now detects already processed block files in the `./result/`
+    directory and processes only new block files.
+  - If an incomplete or partially written `.dat` file is detected (typically
+    the last file in the blocks directory), the parser reports an error and
+    terminates execution without processing that file to avoid corrupted output.

COMMERCIAL.md

@@ -0,0 +1,27 @@
+# Commercial licensing
+
+This project is **source-available**.
+
+Free for **non-commercial** use with attribution.
+
+## Commercial use
+Commercial use requires a paid license from the author.
+
+Commercial use includes (but is not limited to):
+- use in a for-profit company (internal or external)
+- use in paid products or services
+- monetized analytics or consulting deliverables built on the Software
+
+## SaaS / cloud / hosted use
+SaaS / cloud / hosted / API use is not permitted without a paid license,
+even if the service is offered free of charge.
+
+## Contact
+
+To obtain a commercial license or clarify licensing terms, please contact:
+
+**Denis Leonov**  
+Email: **[email protected]**  
+
+Additional contact information:  
+https://aaris.ru/DL

LICENSE

@@ -1,26 +1,111 @@
-# Blockchain parser
+# Blockchain Scalpel
+(formerly: Blockchain parser / Russian scalpel)
 
-## Russian scalpel
 ## Русский скальпель
 
-**Author:** Denis Leonov <[email protected]>
+**Author:** Denis Leonov (ragestack)  
+**Contact:** [email protected]
 
-Simple script for parsing **blkXXXXX.dat** files of Bitcoin blockchain database.
+Blockchain Scalpel is a lightweight script for parsing raw **blkXXXXX.dat**
+files of the Bitcoin blockchain database.
 
-This script also compatible with most of altcoins, after making some tiny tricks.
+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 one realisation of blockchain parser that allows you to explore the main database as close as possible.**
+The parser is also compatible with many altcoins with minimal adjustments.
 
-![blockchain parser](https://hsto.org/getpro/habr/post_images/dad/899/889/dad89988966ca08db3223bbc9b2afc90.jpg)
+---
 
-Don't worry to email me your questions or suggestions about this parser.
+## Overview
 
-No dependencies, no third-parties modules or libs needed. Just install Python standart release and run.
+Blockchain Scalpel is a low-level blockchain data parser designed for research,
+analysis, and infrastructure-level processing.
 
-Make sure you change the paths for **blkXXXXX.dat** files and for the parsing results to yours.
+The project focuses on:
+- transparent and deterministic parsing
+- minimal dependencies
+- direct work with raw blockchain data
+- long-term maintainability
 
-This script convert the full blockchain raw database that is stored in **blkXXXXX.dat** files to the simple **txt** view.
+No third-party modules or libraries are required.  
+A standard Python installation is sufficient.
 
-**If this was helpfull for you, don't hesistate to make a donations!!!**
+---
 
-Bitcoin (BTC): 1FvssyzXNnmgHbJg2DYwb7rkzTrtT8adcL
+## 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**  
+[email protected]
+
+---
+
+## 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.

README.md

@@ -0,0 +1,11 @@
+# Limited compatibility warranty (block format changes)
+
+The author provides a limited warranty related to changes introduced
+by the author for new/updated block formats.
+
+If a released version contains a material parsing error for a supported
+block format due to such changes, the author will make reasonable efforts
+to provide a fix in a subsequent release.
+
+This is not an SLA and does not cover forks, undocumented protocol changes,
+external data corruption, or third-party modifications.