EPIC: Essential Block Storage and Retrieval Support

[jsync-swirlds]

Epic Goal

Design/implementation for essential block storage and retrieval support to enable the Phase 2 block node features (pre-release).

In this first iteration of the persistence layer, it is important to lay the ground work, to streamline the process and to see it work. Once everything is wired up and running, we will be able to iterate over this base in later iterations to introduce improvements to the persistence layer and clear out any uncertainties.

See #125 where we have defined the design of the functionality that now we need to implement

Tasks (in recommended order of implementation)

Preview Give feedback

1. feat: new BlockWriter implementation for block-as-file #281
   Block Node Improvement P0 +3
   
2. refactor: BlockAsDirReader and BlockAsDirWriter review and overhaul #319
   Block Node Improvement P1 +3
   
3. chore: replace large catch block with a method call repairPermissionsForRetry #348
   Block Node Improvement P2 +3
   
4. feat: new BlockReader implementation for block-as-file #349
   Block Node Improvement P1 +3
   
5. feat: add compression mode for BlockAsFileWriter #282
   Block Node Improvement P1 +3
   
6. feat: add compression mode support for BlockAsFileReader #350
   Block Node Improvement P1 +3
   
7. feat: add block archiving support #339
   Block Node New Feature P1 +3
   
8. feat: add block archive reading support #351
   Block Node Improvement P1 +3
   
9. docs: add design docs for the block-as-file persistence #370
   Block Node Documentation P2 +3
   
10. chore: change the liveRootPath and archiveRootPath to absolute paths as default #371
    Block Node Improvement P2 +3
    
11. chore: change the default persistence type to block-as-file #372
    Block Node Improvement P2 +3
    
12. chore: migrate preconditions to use non-null error messages #381
    Block Node Improvement P2 +3