@shyftnetwork/shyft_merkle-lib v1.0.1
Shyft Merkle Tree Library
Basic libary for Shyft-specific merkle tree operations.
Installing
npm install @shyftnetwork/shyft_merkle-libRe-generating Docs
npm install && npm run docsFunctions
hashAB(a, b) ⇒ string
Hashes two values together.
Kind: global function
| Param | Type | Description |
|---|---|---|
| a | string | a bytes32 appropriate value |
| b | string | a bytes32 appropriate value |
hashHeader() ⇒ string
Hashes a block header: {previousHeader, timestamp, blockNumber, transactionRoot}
Kind: global function
| Param | Type | Description |
|---|---|---|
| obj.previousHeader | string | previous block header |
| obj.timestamp | number | block timestamp |
| obj.blockNumber | number | current block number |
| obj.transactionsRoot | string | current transaction root |
| obj.receiptsRoot | string | current receipts root |
isPowerOfTwo(n) ⇒ boolean
Checks if a number is a power of two (ie. valid leaf array size)
Kind: global function
| Param | Type |
|---|---|
| n | number |
setupleafs(leafs) ⇒ Array.<Array.<string>>
Creates first two layers of a tree, ie. the leafs and their hashes
Kind: global function
| Param | Type |
|---|---|
| leafs | Array.<string> |
treePad(tree) ⇒ Array.<Array.<string>>
Pads the leaves of a tree with null to ensure its length is a power of two
Kind: global function
| Param | Type |
|---|---|
| tree | Array.<Array.<string>> |
buildTree(height) ⇒ Tree
Constructs a merkle tree recursively as a 2d array.
Kind: global function
| Param | Type | Description |
|---|---|---|
| Array.<string> | Array.<Array.<string>> | the current tree. Initially a single dimensional array of leaves | |
| height | current height of the tree (starts at 0) |
getProof(tree, leaf) ⇒ Array.<any>
Assembles a proof from a given tree for a given leaf. This produces a proof of the format boolean, leaf, boolean, leaf ...
Kind: global function
| Param | Type |
|---|---|
| tree | Array.<Array.<string>> |
| leaf | string |
verifyProof(proof, leaf, root) ⇒ boolean
Verifies that the leaf and the proof do in fact hash to the root
Kind: global function
| Param | Type |
|---|---|
| proof | Array.<any> |
| leaf | Object |
| root | string |
stringifyProof(proof) ⇒ string
Stringifies the proof by assmbling a bit array of the path indicators and appending it to the path segments.
Kind: global function
| Param | Type |
|---|---|
| proof | Array.<any> |
getRoot(tree) ⇒ string
Returns root element of tree.
Kind: global function
| Param |
|---|
| tree |
isValidLeaf(leaf, tree) ⇒ boolean
Checks if the leaf exists in the tree.
Kind: global function
| Param | Type | Description |
|---|---|---|
| leaf | Object | |
| leaf.previousHeader | string | previous block header |
| leaf.timestamp | number | block timestamp |
| leaf.blockNumber | number | current block number |
| leaf.transactionsRoot | string | current transaction root |
| leaf.receiptsRoot | string | current receipts root |
| tree | Valid merkle tree |