Prerequisites

• Java 17 or > Runtime

How to install

Unzip the distribution, and add it's bin directory to your environment's PATH, and give the launch scripts permission to execute. On Unix:

$ chmod +x io.crums.ledgers-0.5.1/bin/* 

How to use

The tools have manuals that complement their -help option:

• sldg manual
• mrsl manual

Changes

• Report template edit tool. Development CLI called report-template
• sldg setup --new-seed. Generates new secure table salt.
• CLI tool for interpreting/converting base64 encodings of hashes in SQL schema.

Best,
Babak Farhang

Prerequisites

• Java 17 or > Runtime

How to install

Unzip the distribution, and add it's bin directory to your environment's PATH, and give the launch scripts permission to execute. On Unix:

$ chmod +x skipledger-0.5.0/bin/* 

How to use

The tools have manuals that complement their -help option:

• sldg manual
• mrsl manual

Changes

Version 0.5.0 is both a maintenance- and new-feature release.

Maintenance

• JPMS Modularization. Maven submodules were JPMS modularized (the Java Module System). So were
  its other io.crums dependencies. This allows bundling applications with a custom JRE that's smaller
  than a standard runtime.
• Maven Central Deployment. The modules defined in this project (and their dependencies on other
  io.crums projects) are now deployed to central.
• Morsel File Format. The file format now defines an assets section. Auxiliary and meta files related to the ledger
  are packaged and embedded in this section of the file. (Code is backward compatible).

New Features

• Better CLI. This release uses the picocli library for prettier, more intuitive / helpful
  command line interfaces.

• Report Templates. .mrsl files can now embed a customizable template for generating PDF reports
  from ledger data in a morsel. The idea is to allow the ledger owner create branded documents
  from their ledger entries for such things as bills, receipts, or any other documents they might invent.

Best,
Babak Farhang

Prerequisites

• Java 11 or > Runtime

How to install

Unzip the distribution, add it's bin directory to your environment's PATH, and give the launch scripts permission to execute. On Unix:

$ chmod +x skipledger-0.0.4/bin/*

How to use

The tools have manuals that complement their -help option:

• sldg manual
• mrsl manual

Changes

A number of usability improvements..

• JSON representation of morsel data. Exposes type information about column values, as well as providing programmatic access from other environments than Java.
• mrsl submerge: slices out of pieces of data from a morsel file into a new morsel file. (The owner of
  a morsel may wish to share only a subset of the data gathered in their morsel.)
• Support for customized meta-info for morsels. This info is not validated but helps with usability. For eg, column titles/headings.

I've set up a discussion for this release. Feel free to ask questions, troubleshoot, or drop suggestions

Best,
Babak Farhang

This release provides tools for maintaining tamper proof evolving historical private ledgers on relational databases and for disclosing any of their parts in an efficient, provable way.

Prerequisites

• Java 11 or > Runtime

How to install

Unzip the distribution, add it's bin directory to your environment's PATH, and give the launch scripts permission to execute. On unix:

$ chmod +x skipledger-0.0.3/bin/*

How to use

The tools have manuals that complement their -help option:

• sldg
• mrsl

Changes

Following feedback after the first release (thank you!), the project's focus turned to relational databases (where many ledgers already reside). Here's what changed under the hood since the last release:

• Hash ledger (the skip ledger data structure with annotated crumtrails) implemented on RDBMS.
• The special beacon rows of the previous version were dropped. (Users can still embed beacon values in their own business records
  in order to the establish maximum age of their rows.)
• Modeled the source ledger (the source of the ledger's data). This supports rows composed of columns in the usual way.
  • Simplified column types (strings, fixed / floating precision integral types, null, etc.)
  • Salted hashing in order to resist decoding values from their hashes via rainbow attacks or frequency analysis.
  • SQL column value type mappings to those modeled in the source ledger.
• The source ledger is now encoded in morsel files; source rows in these files are now automatically validated against their
  hashes (since we've now defined what the parsing rules for generating those hashes are).
• Support for individual column value (table cell) redactions in morsel files added.

Keep the feedback coming! And if you wanna contribute.. well, there are so many much I need help with ;)

Best,
Babak Farhang

~October 29, 2021

Introducing the skip ledger: a tamper proof, append-only ledger with history and provable tear-outs called morsels.

Prerequisites

• Java 11 or > Runtime

How to install

Unzip the distribution, add it's bin directory to your environment's PATH, and give the launch scripts permission to execute. On unix:

$ chmod +x skipledger-0.0.2/bin/*

How to use

Follow the README Tour to familiarize yourself with the tools and what they do. Each tool also has a -help option explaining its few commands.

~April 25 2021