Update docs

This commit is contained in:
Miguel Mota 2022-11-10 05:33:32 -08:00
parent ab6543a74e
commit 142ac3d903
No known key found for this signature in database
GPG Key ID: 67EC1161588A00F9
3 changed files with 526 additions and 15 deletions

View File

@ -18,20 +18,24 @@
* [_isHexString](_src_base_.base.md#protected-_ishexstring) * [_isHexString](_src_base_.base.md#protected-_ishexstring)
* [_log2](_src_base_.base.md#protected-_log2) * [_log2](_src_base_.base.md#protected-_log2)
* [_zip](_src_base_.base.md#protected-_zip) * [_zip](_src_base_.base.md#protected-_zip)
* [binarySearch](_src_base_.base.md#binarysearch)
* [bufferToHex](_src_base_.base.md#buffertohex) * [bufferToHex](_src_base_.base.md#buffertohex)
* [bufferify](_src_base_.base.md#bufferify) * [bufferify](_src_base_.base.md#bufferify)
* [bufferifyFn](_src_base_.base.md#bufferifyfn) * [bufferifyFn](_src_base_.base.md#bufferifyfn)
* [linearSearch](_src_base_.base.md#linearsearch)
* [print](_src_base_.base.md#print) * [print](_src_base_.base.md#print)
* [binarySearch](_src_base_.base.md#static-binarysearch)
* [bufferToHex](_src_base_.base.md#static-buffertohex) * [bufferToHex](_src_base_.base.md#static-buffertohex)
* [bufferify](_src_base_.base.md#static-bufferify) * [bufferify](_src_base_.base.md#static-bufferify)
* [isHexString](_src_base_.base.md#static-ishexstring) * [isHexString](_src_base_.base.md#static-ishexstring)
* [linearSearch](_src_base_.base.md#static-linearsearch)
* [print](_src_base_.base.md#static-print) * [print](_src_base_.base.md#static-print)
## Methods ## Methods
### `Protected` _bufferIndexOf ### `Protected` _bufferIndexOf
**_bufferIndexOf**(`array`: Buffer[], `element`: Buffer): *number* **_bufferIndexOf**(`array`: Buffer[], `element`: Buffer, `isSorted`: boolean): *number*
bufferIndexOf bufferIndexOf
@ -44,10 +48,11 @@ const index = tree.bufferIndexOf(haystack, needle)
**Parameters:** **Parameters:**
Name | Type | Name | Type | Default |
------ | ------ | ------ | ------ | ------ |
`array` | Buffer[] | `array` | Buffer[] | - |
`element` | Buffer | `element` | Buffer | - |
`isSorted` | boolean | false |
**Returns:** *number* **Returns:** *number*
@ -121,6 +126,46 @@ Name | Type | Description |
___ ___
### binarySearch
**binarySearch**(`array`: Buffer[], `element`: Buffer, `compareFunction`: function): *number*
binarySearch
**`desc`** Returns the first index of which given item is found in array using binary search.
**`example`**
```js
const index = tree.binarySearch(array, element, Buffer.compare)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**compareFunction**: *function*
▸ (`a`: unknown, `b`: unknown): *number*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### bufferToHex ### bufferToHex
**bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string* **bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string*
@ -191,6 +236,46 @@ Name | Type |
___ ___
### linearSearch
**linearSearch**(`array`: Buffer[], `element`: Buffer, `eqChecker`: function): *number*
linearSearch
**`desc`** Returns the first index of which given item is found in array using linear search.
**`example`**
```js
const index = tree.linearSearch(array, element, (a, b) => a === b)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**eqChecker**: *function*
▸ (`a`: unknown, `b`: unknown): *boolean*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### print ### print
**print**(): *void* **print**(): *void*
@ -208,6 +293,46 @@ tree.print()
___ ___
### `Static` binarySearch
**binarySearch**(`array`: Buffer[], `element`: Buffer, `compareFunction`: function): *number*
binarySearch
**`desc`** Returns the first index of which given item is found in array using binary search.
**`example`**
```js
const index = MerkleTree.binarySearch(array, element, Buffer.compare)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**compareFunction**: *function*
▸ (`a`: unknown, `b`: unknown): *number*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### `Static` bufferToHex ### `Static` bufferToHex
**bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string* **bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string*
@ -278,6 +403,46 @@ Name | Type |
___ ___
### `Static` linearSearch
**linearSearch**(`array`: Buffer[], `element`: Buffer, `eqChecker`: function): *number*
linearSearch
**`desc`** Returns the first index of which given item is found in array using linear search.
**`example`**
```js
const index = MerkleTree.linearSearch(array, element, (a, b) => a === b)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**eqChecker**: *function*
▸ (`a`: unknown, `b`: unknown): *boolean*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### `Static` print ### `Static` print
**print**(`tree`: any): *void* **print**(`tree`: any): *void*

View File

@ -34,6 +34,7 @@
* [_log2](_src_merklemountainrange_.merklemountainrange.md#protected-_log2) * [_log2](_src_merklemountainrange_.merklemountainrange.md#protected-_log2)
* [_zip](_src_merklemountainrange_.merklemountainrange.md#protected-_zip) * [_zip](_src_merklemountainrange_.merklemountainrange.md#protected-_zip)
* [append](_src_merklemountainrange_.merklemountainrange.md#append) * [append](_src_merklemountainrange_.merklemountainrange.md#append)
* [binarySearch](_src_merklemountainrange_.merklemountainrange.md#binarysearch)
* [bufferToHex](_src_merklemountainrange_.merklemountainrange.md#buffertohex) * [bufferToHex](_src_merklemountainrange_.merklemountainrange.md#buffertohex)
* [bufferify](_src_merklemountainrange_.merklemountainrange.md#bufferify) * [bufferify](_src_merklemountainrange_.merklemountainrange.md#bufferify)
* [bufferifyFn](_src_merklemountainrange_.merklemountainrange.md#bufferifyfn) * [bufferifyFn](_src_merklemountainrange_.merklemountainrange.md#bufferifyfn)
@ -50,6 +51,7 @@
* [hashLeaf](_src_merklemountainrange_.merklemountainrange.md#hashleaf) * [hashLeaf](_src_merklemountainrange_.merklemountainrange.md#hashleaf)
* [heightAt](_src_merklemountainrange_.merklemountainrange.md#heightat) * [heightAt](_src_merklemountainrange_.merklemountainrange.md#heightat)
* [isLeaf](_src_merklemountainrange_.merklemountainrange.md#isleaf) * [isLeaf](_src_merklemountainrange_.merklemountainrange.md#isleaf)
* [linearSearch](_src_merklemountainrange_.merklemountainrange.md#linearsearch)
* [mountainHeight](_src_merklemountainrange_.merklemountainrange.md#mountainheight) * [mountainHeight](_src_merklemountainrange_.merklemountainrange.md#mountainheight)
* [numOfPeaks](_src_merklemountainrange_.merklemountainrange.md#numofpeaks) * [numOfPeaks](_src_merklemountainrange_.merklemountainrange.md#numofpeaks)
* [peakBagging](_src_merklemountainrange_.merklemountainrange.md#peakbagging) * [peakBagging](_src_merklemountainrange_.merklemountainrange.md#peakbagging)
@ -59,9 +61,11 @@
* [print](_src_merklemountainrange_.merklemountainrange.md#print) * [print](_src_merklemountainrange_.merklemountainrange.md#print)
* [rollUp](_src_merklemountainrange_.merklemountainrange.md#rollup) * [rollUp](_src_merklemountainrange_.merklemountainrange.md#rollup)
* [verify](_src_merklemountainrange_.merklemountainrange.md#verify) * [verify](_src_merklemountainrange_.merklemountainrange.md#verify)
* [binarySearch](_src_merklemountainrange_.merklemountainrange.md#static-binarysearch)
* [bufferToHex](_src_merklemountainrange_.merklemountainrange.md#static-buffertohex) * [bufferToHex](_src_merklemountainrange_.merklemountainrange.md#static-buffertohex)
* [bufferify](_src_merklemountainrange_.merklemountainrange.md#static-bufferify) * [bufferify](_src_merklemountainrange_.merklemountainrange.md#static-bufferify)
* [isHexString](_src_merklemountainrange_.merklemountainrange.md#static-ishexstring) * [isHexString](_src_merklemountainrange_.merklemountainrange.md#static-ishexstring)
* [linearSearch](_src_merklemountainrange_.merklemountainrange.md#static-linearsearch)
* [print](_src_merklemountainrange_.merklemountainrange.md#static-print) * [print](_src_merklemountainrange_.merklemountainrange.md#static-print)
## Constructors ## Constructors
@ -134,7 +138,7 @@ ___
### `Protected` _bufferIndexOf ### `Protected` _bufferIndexOf
**_bufferIndexOf**(`array`: Buffer[], `element`: Buffer): *number* **_bufferIndexOf**(`array`: Buffer[], `element`: Buffer, `isSorted`: boolean): *number*
*Inherited from [Base](_src_base_.base.md).[_bufferIndexOf](_src_base_.base.md#protected-_bufferindexof)* *Inherited from [Base](_src_base_.base.md).[_bufferIndexOf](_src_base_.base.md#protected-_bufferindexof)*
@ -149,10 +153,11 @@ const index = tree.bufferIndexOf(haystack, needle)
**Parameters:** **Parameters:**
Name | Type | Name | Type | Default |
------ | ------ | ------ | ------ | ------ |
`array` | Buffer[] | `array` | Buffer[] | - |
`element` | Buffer | `element` | Buffer | - |
`isSorted` | boolean | false |
**Returns:** *number* **Returns:** *number*
@ -249,6 +254,48 @@ Name | Type |
___ ___
### binarySearch
**binarySearch**(`array`: Buffer[], `element`: Buffer, `compareFunction`: function): *number*
*Inherited from [Base](_src_base_.base.md).[binarySearch](_src_base_.base.md#static-binarysearch)*
binarySearch
**`desc`** Returns the first index of which given item is found in array using binary search.
**`example`**
```js
const index = tree.binarySearch(array, element, Buffer.compare)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**compareFunction**: *function*
▸ (`a`: unknown, `b`: unknown): *number*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### bufferToHex ### bufferToHex
**bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string* **bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string*
@ -523,6 +570,48 @@ Name | Type |
___ ___
### linearSearch
**linearSearch**(`array`: Buffer[], `element`: Buffer, `eqChecker`: function): *number*
*Inherited from [Base](_src_base_.base.md).[linearSearch](_src_base_.base.md#static-linearsearch)*
linearSearch
**`desc`** Returns the first index of which given item is found in array using linear search.
**`example`**
```js
const index = tree.linearSearch(array, element, (a, b) => a === b)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**eqChecker**: *function*
▸ (`a`: unknown, `b`: unknown): *boolean*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### mountainHeight ### mountainHeight
**mountainHeight**(`size`: number): *number* **mountainHeight**(`size`: number): *number*
@ -671,6 +760,48 @@ Name | Type |
___ ___
### `Static` binarySearch
**binarySearch**(`array`: Buffer[], `element`: Buffer, `compareFunction`: function): *number*
*Inherited from [Base](_src_base_.base.md).[binarySearch](_src_base_.base.md#static-binarysearch)*
binarySearch
**`desc`** Returns the first index of which given item is found in array using binary search.
**`example`**
```js
const index = MerkleTree.binarySearch(array, element, Buffer.compare)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**compareFunction**: *function*
▸ (`a`: unknown, `b`: unknown): *number*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### `Static` bufferToHex ### `Static` bufferToHex
**bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string* **bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string*
@ -747,6 +878,48 @@ Name | Type |
___ ___
### `Static` linearSearch
**linearSearch**(`array`: Buffer[], `element`: Buffer, `eqChecker`: function): *number*
*Inherited from [Base](_src_base_.base.md).[linearSearch](_src_base_.base.md#static-linearsearch)*
linearSearch
**`desc`** Returns the first index of which given item is found in array using linear search.
**`example`**
```js
const index = MerkleTree.linearSearch(array, element, (a, b) => a === b)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**eqChecker**: *function*
▸ (`a`: unknown, `b`: unknown): *boolean*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### `Static` print ### `Static` print
**print**(`tree`: any): *void* **print**(`tree`: any): *void*

View File

@ -27,6 +27,7 @@ Class reprensenting a Merkle Tree
* [_zip](_src_merkletree_.merkletree.md#protected-_zip) * [_zip](_src_merkletree_.merkletree.md#protected-_zip)
* [addLeaf](_src_merkletree_.merkletree.md#addleaf) * [addLeaf](_src_merkletree_.merkletree.md#addleaf)
* [addLeaves](_src_merkletree_.merkletree.md#addleaves) * [addLeaves](_src_merkletree_.merkletree.md#addleaves)
* [binarySearch](_src_merkletree_.merkletree.md#binarysearch)
* [bufferToHex](_src_merkletree_.merkletree.md#buffertohex) * [bufferToHex](_src_merkletree_.merkletree.md#buffertohex)
* [bufferify](_src_merkletree_.merkletree.md#bufferify) * [bufferify](_src_merkletree_.merkletree.md#bufferify)
* [bufferifyFn](_src_merkletree_.merkletree.md#bufferifyfn) * [bufferifyFn](_src_merkletree_.merkletree.md#bufferifyfn)
@ -55,16 +56,19 @@ Class reprensenting a Merkle Tree
* [getProofsDFS](_src_merkletree_.merkletree.md#getproofsdfs) * [getProofsDFS](_src_merkletree_.merkletree.md#getproofsdfs)
* [getRoot](_src_merkletree_.merkletree.md#getroot) * [getRoot](_src_merkletree_.merkletree.md#getroot)
* [isUnevenTree](_src_merkletree_.merkletree.md#isuneventree) * [isUnevenTree](_src_merkletree_.merkletree.md#isuneventree)
* [linearSearch](_src_merkletree_.merkletree.md#linearsearch)
* [print](_src_merkletree_.merkletree.md#print) * [print](_src_merkletree_.merkletree.md#print)
* [resetTree](_src_merkletree_.merkletree.md#resettree) * [resetTree](_src_merkletree_.merkletree.md#resettree)
* [toString](_src_merkletree_.merkletree.md#tostring) * [toString](_src_merkletree_.merkletree.md#tostring)
* [verify](_src_merkletree_.merkletree.md#verify) * [verify](_src_merkletree_.merkletree.md#verify)
* [verifyMultiProof](_src_merkletree_.merkletree.md#verifymultiproof) * [verifyMultiProof](_src_merkletree_.merkletree.md#verifymultiproof)
* [verifyMultiProofWithFlags](_src_merkletree_.merkletree.md#verifymultiproofwithflags) * [verifyMultiProofWithFlags](_src_merkletree_.merkletree.md#verifymultiproofwithflags)
* [binarySearch](_src_merkletree_.merkletree.md#static-binarysearch)
* [bufferToHex](_src_merkletree_.merkletree.md#static-buffertohex) * [bufferToHex](_src_merkletree_.merkletree.md#static-buffertohex)
* [bufferify](_src_merkletree_.merkletree.md#static-bufferify) * [bufferify](_src_merkletree_.merkletree.md#static-bufferify)
* [getMultiProof](_src_merkletree_.merkletree.md#static-getmultiproof) * [getMultiProof](_src_merkletree_.merkletree.md#static-getmultiproof)
* [isHexString](_src_merkletree_.merkletree.md#static-ishexstring) * [isHexString](_src_merkletree_.merkletree.md#static-ishexstring)
* [linearSearch](_src_merkletree_.merkletree.md#static-linearsearch)
* [marshalLeaves](_src_merkletree_.merkletree.md#static-marshalleaves) * [marshalLeaves](_src_merkletree_.merkletree.md#static-marshalleaves)
* [marshalProof](_src_merkletree_.merkletree.md#static-marshalproof) * [marshalProof](_src_merkletree_.merkletree.md#static-marshalproof)
* [print](_src_merkletree_.merkletree.md#static-print) * [print](_src_merkletree_.merkletree.md#static-print)
@ -111,7 +115,7 @@ Name | Type | Default | Description |
### `Protected` _bufferIndexOf ### `Protected` _bufferIndexOf
**_bufferIndexOf**(`array`: Buffer[], `element`: Buffer): *number* **_bufferIndexOf**(`array`: Buffer[], `element`: Buffer, `isSorted`: boolean): *number*
*Inherited from [Base](_src_base_.base.md).[_bufferIndexOf](_src_base_.base.md#protected-_bufferindexof)* *Inherited from [Base](_src_base_.base.md).[_bufferIndexOf](_src_base_.base.md#protected-_bufferindexof)*
@ -126,10 +130,11 @@ const index = tree.bufferIndexOf(haystack, needle)
**Parameters:** **Parameters:**
Name | Type | Name | Type | Default |
------ | ------ | ------ | ------ | ------ |
`array` | Buffer[] | `array` | Buffer[] | - |
`element` | Buffer | `element` | Buffer | - |
`isSorted` | boolean | false |
**Returns:** *number* **Returns:** *number*
@ -274,6 +279,48 @@ Name | Type | Default |
___ ___
### binarySearch
**binarySearch**(`array`: Buffer[], `element`: Buffer, `compareFunction`: function): *number*
*Inherited from [Base](_src_base_.base.md).[binarySearch](_src_base_.base.md#static-binarysearch)*
binarySearch
**`desc`** Returns the first index of which given item is found in array using binary search.
**`example`**
```js
const index = tree.binarySearch(array, element, Buffer.compare)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**compareFunction**: *function*
▸ (`a`: unknown, `b`: unknown): *number*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### bufferToHex ### bufferToHex
**bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string* **bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string*
@ -893,6 +940,48 @@ Name | Type |
___ ___
### linearSearch
**linearSearch**(`array`: Buffer[], `element`: Buffer, `eqChecker`: function): *number*
*Inherited from [Base](_src_base_.base.md).[linearSearch](_src_base_.base.md#static-linearsearch)*
linearSearch
**`desc`** Returns the first index of which given item is found in array using linear search.
**`example`**
```js
const index = tree.linearSearch(array, element, (a, b) => a === b)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**eqChecker**: *function*
▸ (`a`: unknown, `b`: unknown): *boolean*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### print ### print
**print**(): *void* **print**(): *void*
@ -1025,6 +1114,48 @@ Name | Type |
___ ___
### `Static` binarySearch
**binarySearch**(`array`: Buffer[], `element`: Buffer, `compareFunction`: function): *number*
*Inherited from [Base](_src_base_.base.md).[binarySearch](_src_base_.base.md#static-binarysearch)*
binarySearch
**`desc`** Returns the first index of which given item is found in array using binary search.
**`example`**
```js
const index = MerkleTree.binarySearch(array, element, Buffer.compare)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**compareFunction**: *function*
▸ (`a`: unknown, `b`: unknown): *number*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### `Static` bufferToHex ### `Static` bufferToHex
**bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string* **bufferToHex**(`value`: Buffer, `withPrefix`: boolean): *string*
@ -1129,6 +1260,48 @@ Name | Type |
___ ___
### `Static` linearSearch
**linearSearch**(`array`: Buffer[], `element`: Buffer, `eqChecker`: function): *number*
*Inherited from [Base](_src_base_.base.md).[linearSearch](_src_base_.base.md#static-linearsearch)*
linearSearch
**`desc`** Returns the first index of which given item is found in array using linear search.
**`example`**
```js
const index = MerkleTree.linearSearch(array, element, (a, b) => a === b)
```
**Parameters:**
**array**: *Buffer[]*
Array of items.
**element**: *Buffer*
Item to find.
**eqChecker**: *function*
▸ (`a`: unknown, `b`: unknown): *boolean*
**Parameters:**
Name | Type |
------ | ------ |
`a` | unknown |
`b` | unknown |
**Returns:** *number*
- Index number
___
### `Static` marshalLeaves ### `Static` marshalLeaves
**marshalLeaves**(`leaves`: any[]): *string* **marshalLeaves**(`leaves`: any[]): *string*