import { Field, Provable } from 'o1js'; import { Hasher } from '../model.js'; import { Store } from '../store/store.js'; import { SparseCompactMerkleProof, SparseMerkleProof } from './proofs.js'; export { SparseMerkleTree }; /** * Sparse Merkle Tree * * @class SparseMerkleTree * @template K * @template V */ declare class SparseMerkleTree { /** * Initial empty tree root based on poseidon hash algorithm * * @static * @memberof SparseMerkleTree */ static initialPoseidonHashRoot: import("o1js/dist/node/lib/provable/field.js").Field; protected root: Field; protected store: Store; protected hasher: Hasher; protected config: { hashKey: boolean; hashValue: boolean; }; protected keyType: Provable; protected valueType: Provable; /** * Build a new sparse merkle tree * * @static * @template K * @template V * @param {Store} store * @param {Provable} KeyType * @param {Provable} ValueType * @param {{ hasher?: Hasher; hashKey?: boolean; hashValue?: boolean }} [options={ * hasher: PoseidonHasherFunc, * hashKey: true, * hashValue: true, * }] hasher: The hash function to use, defaults to PoseidonHasherFunc; hashKey: * whether to hash the key, the default is true; hashValue: whether to hash the value, * the default is true. * @return {*} {Promise>} * @memberof SparseMerkleTree */ static build(store: Store, KeyType: Provable, ValueType: Provable, options?: { hasher?: Hasher; hashKey?: boolean; hashValue?: boolean; }): Promise>; /** * Import a sparse merkle tree via existing store * * @static * @template K * @template V * @param {Store} store * @param {Provable} keyType * @param {Provable} valueType * @param {{ hasher?: Hasher; hashKey?: boolean; hashValue?: boolean }} [options={ * hasher: PoseidonHasherFunc, * hashKey: true, * hashValue: true, * }] hasher: The hash function to use, defaults to PoseidonHasherFunc; hashKey: * whether to hash the key, the default is true; hashValue: whether to hash the value, * the default is true. * @return {*} {Promise>} * @memberof SparseMerkleTree */ static import(store: Store, keyType: Provable, valueType: Provable, options?: { hasher?: Hasher; hashKey?: boolean; hashValue?: boolean; }): Promise>; private constructor(); private getKeyField; /** * Get the root of the tree. * * @return {*} {Field} * @memberof SparseMerkleTree */ getRoot(): Field; /** * Check if the tree is empty. * * @return {*} {boolean} * @memberof SparseMerkleTree */ isEmpty(): boolean; /** * Get the depth of the tree. * * @return {*} {number} * @memberof SparseMerkleTree */ depth(): number; /** * Set the root of the tree. * * @param {Field} root * @memberof SparseMerkleTree */ setRoot(root: Field): Promise; /** * Get the data store of the tree. * * @return {*} {Store} * @memberof SparseMerkleTree */ getStore(): Store; /** * Get the hasher function used by the tree. * * @return {*} {Hasher} * @memberof SparseMerkleTree */ getHasher(): Hasher; /** * Get the value for a key from the tree. * * @param {K} key * @return {*} {(Promise)} * @memberof SparseMerkleTree */ get(key: K): Promise; /** * Check if the key exists in the tree. * * @param {K} key * @return {*} {Promise} * @memberof SparseMerkleTree */ has(key: K): Promise; /** * Clear the tree. * * @return {*} {Promise} * @memberof SparseMerkleTree */ clear(): Promise; /** * Delete a value from tree and return the new root of the tree. * * @param {K} key * @return {*} {Promise} * @memberof SparseMerkleTree */ delete(key: K): Promise; /** * Update a new value for a key in the tree and return the new root of the tree. * * @param {K} key * @param {V} [value] * @return {*} {Promise} * @memberof SparseMerkleTree */ update(key: K, value?: V): Promise; /** * Update multiple leaves and return the new root of the tree. * * @param {{ key: K; value?: V }[]} kvs * @return {*} {Promise} * @memberof SparseMerkleTree */ updateAll(kvs: { key: K; value?: V; }[]): Promise; /** * Create a merkle proof for a key against the current root. * * @param {K} key * @return {*} {Promise} * @memberof SparseMerkleTree */ prove(key: K): Promise; /** * Create a compacted merkle proof for a key against the current root. * * @param {K} key * @return {*} {Promise} * @memberof SparseMerkleTree */ proveCompact(key: K): Promise; protected digest(data: Field[]): Field; protected updateForRoot(root: Field, key: K, value?: V): Promise; protected updateWithSideNodes(sideNodes: Field[], pathNodes: Field[], oldLeafData: Field, path: Field, value?: V): Field; protected sideNodesForRoot(root: Field, path: Field): Promise<{ sideNodes: Field[]; pathNodes: Field[]; leafData: Field; }>; protected proveForRoot(root: Field, key: K): Promise; }