logos-storage-spec/manifest.md
2024-10-03 15:23:34 -04:00

2.5 KiB

title name status category tags editor contributors
CODEX-MANIFEST Codes Manifest raw Standards Track codex

Abstract

This specification describes the parameters used in the manifest for a Codex client application.

Manifest

The manifest is used to encode datasets with the a Codex client node. The file contains key-value pairs.

Parameters


"manifest" : {
	"treeCid" : "string"
	"datasetSize" : ,
	"blockSize" : ,
	"codec" : ,
	"hcodec" : ,
	"version" : ,
	"protected" : "bool",
	"ecK" : "int",
	"ecM" : "int",
	"originalTreeCid" : ,
	"originalDatasetSize" :
	"protectedStrategy" :
	"verifiable" : "bool" ,
	"verifyRoot" : ,
	"slotRoots" : ,
	"cellSize" : ,
	"verifiableStrategy" : ,
	
}

The structured format used is JSON.

attribute type description
treeCid string A hash based on CIDv1. The root of the merkle tree
datasetSize bytes Total size of all blocks, after data is chunked.
blockSize bytes Size of each contained block.
codec MultiCodec A dataset codec.
hcodec MultiCodec A multihash codec.
version string The CID version
protected bool The protected datasets have erasure coded info, If true, ecK, ecM, originalTreeCid, originalDatasetSize, and protectedStrategy SHOULD be used.
ecK int The number of blocks to encode.
ecM int The number of resulting parity blocks.
originalTreeCid string The original root of the dataset being erasure coded.
originalDatasetSize bytes The size of the original dataset.
protectedStrategy enum An indexing strategy used to build the slot roots.
verifiable bool Verifiable datasets can be used to generate storage proofs. If true, verifyRoot, slotRoots, cellSize, and verifiableStrategy SHOULD be used.
verifyRoot string The root of the top level merkle tree built from slot roots.
slotRoots array[string] Individual slot root built from the original dataset blocks.
cellSize bytes The size of each slot cell.
verifiableStrategy enum Indexing strategy used to build the slot roots.

Copyright and related rights waived via CC0.

References