blockset 0.2.4

Data Block Set
Documentation

Data Block Set

The blockset application is a command line program that can store and retrieve data blocks using a content-dependent tree (CDT) hash function as a universal address of the blocks.

Articles:

Install the latest stable version from crates.io:

cargo install blockset

Install the current version from the main branch:

cargo install --git https://github.com/datablockset/blockset

Uninstall the blockset:

cargo uninstall blockset

Commands

  • address validation: 
    blockset validate 3v1d4j94scaseqgcyzr0ha5dxa9rx6ppnfbndck971ack
  • calculate address: 
    blockset address ./README.md
  • add a data block to the local storage cdt0/: 
    blockset add ./LICENSE
  • get a file by address 
    blockset get ngd7zembwj6f2tsh4gyxrcyx26h221e3f2wdgfbtq87nd ./old.md

For Developers

Internal documentation: https://blockset.pages.dev/.

Best practices

  • Make it simple.
  • Avoid unsafe code. Currently, we don't have unsafe code.
  • No I/O is allowed in a library. We have 100% code coverage.
  • Make const functions if possible.
  • Avoid using macros. Allowed macros: derive, cfg, test, assert.., wasm_bindgen_test.
  • Avoid using third-party dependencies, especially if they use I/O directly.