@ocash/sdk 0.1.4-rc.0 → 0.1.4-rc.2

package/dist/{index-CI7UllxU.d.cts → index-Dvl0HZkw.d.cts}

@@ -203,6 +203,13 @@ interface OCashSdkConfig {
          * Merkle depth used by the on-chain tree (defaults to 32).
          */
         treeDepth?: number;
+        /**
+         * Optional callback to read `merkleRoots(rootIndex)` from the on-chain contract.
+         * When provided, each batch merge is verified against the contract root.
+         * Return null if the contract hasn't committed this index yet (treated as "skip").
+         * A zero root (0x000...0) is also treated as "not yet committed".
+         */
+        readContractRoot?: (chainId: number, rootIndex: number) => Promise<Hex | null>;
     };
     sync?: {
         pageSize?: number;
@@ -634,19 +641,26 @@ type ListUtxosResult = {
     total: number;
     rows: UtxoRecord[];
 };
-/** Persisted merkle tree state metadata. */
-type MerkleTreeState = {
-    /** Chain id (scoped). */
+/** ChairmanMerkle tree (persistent segment tree) node. */
+type ChairmanMerkleNodeRecord = {
     chainId: number;
-    /** Current tree root (for the merged/main tree). */
-    root: Hex;
-    /**
-     * Total elements that have been merged into the main tree.
-     * This matches `totalElementsInTree(contract.totalElements, tempArraySize)`.
-     */
-    totalElements: number;
-    /** Last updated timestamp (ms). */
-    lastUpdated: number;
+    /** Unique node ID. Main tree: `cm-{version}-{level}`, subtree internal: `st-{level}-{position}` */
+    id: string;
+    hash: Hex;
+    /** Left child node ID (null for leaf/subtree nodes). */
+    leftId: string | null;
+    /** Right child node ID (null for leaf/subtree nodes). */
+    rightId: string | null;
+};
+/** ChairmanMerkle tree version — maps a mergedElements count to a persistent root. */
+type ChairmanMerkleVersionRecord = {
+    chainId: number;
+    /** Version = mergedElements count (0, 32, 64, …). */
+    version: number;
+    /** Root node ID for this version. */
+    rootId: string;
+    /** Root hash (cached for quick lookup without traversal). */
+    rootHash: Hex;
 };
 /** Persisted merkle leaf record. */
 type MerkleLeafRecord = {
@@ -654,19 +668,6 @@ type MerkleLeafRecord = {
     cid: number;
     commitment: Hex;
 };
-/** Persisted merkle node record. */
-type MerkleNodeRecord = {
-    chainId: number;
-    /**
-     * Node id.
-     * - Normal node: `${level}-${position}`
-     * - Frontier node: `frontier-${level}`
-     */
-    id: string;
-    level: number;
-    position: number;
-    hash: Hex;
-};
 /** Storage adapter interface for persistence. */
 interface StorageAdapter {
     /**
@@ -739,11 +740,19 @@ interface StorageAdapter {
      */
     getMerkleLeaf?(chainId: number, cid: number): Promise<MerkleLeafRecord | undefined>;
     /**
-     * Optional Merkle DB: node lookup by id (fast path for proof generation and incremental updates).
+     * ChairmanMerkle tree (persistent segment tree) node storage.
+     * Used for both main-tree versioned nodes and subtree internal nodes.
      */
-    getMerkleNode?(chainId: number, id: string): Promise<MerkleNodeRecord | undefined>;
-    upsertMerkleNodes?(chainId: number, nodes: MerkleNodeRecord[]): Promise<void>;
-    clearMerkleNodes?(chainId: number): Promise<void>;
+    getChairmanMerkleNode?(chainId: number, id: string): Promise<ChairmanMerkleNodeRecord | undefined>;
+    putChairmanMerkleNodes?(chainId: number, nodes: ChairmanMerkleNodeRecord[]): Promise<void>;
+    /**
+     * ChairmanMerkle tree version storage.
+     * Each version maps a mergedElements count to a persistent root.
+     */
+    getChairmanMerkleVersion?(chainId: number, version: number): Promise<ChairmanMerkleVersionRecord | undefined>;
+    getLatestChairmanMerkleVersion?(chainId: number): Promise<ChairmanMerkleVersionRecord | undefined>;
+    putChairmanMerkleVersion?(chainId: number, record: ChairmanMerkleVersionRecord): Promise<void>;
+    clearChairmanMerkleTree?(chainId: number): Promise<void>;
     /**
      * Optional entry memo persistence (raw EntryService payloads).
      * Useful for debugging, rebuilds, and app-like local caches.
@@ -758,13 +767,6 @@ interface StorageAdapter {
     upsertEntryNullifiers?(nullifiers: EntryNullifierRecord[]): Promise<void> | void;
     listEntryNullifiers?(query: ListEntryNullifiersQuery): Promise<ListEntryNullifiersResult>;
     clearEntryNullifiers?(chainId: number): Promise<void> | void;
-    /**
-     * Optional merkle tree state persistence (merged/main-tree only).
-     * This mirrors the client/app `MerkleDexie.trees` metadata.
-     */
-    getMerkleTree?(chainId: number): Promise<MerkleTreeState | undefined>;
-    setMerkleTree?(chainId: number, tree: MerkleTreeState): Promise<void>;
-    clearMerkleTree?(chainId: number): Promise<void>;
 }
 /** WASM & circuit initialization. Call `ready()` before any proof operations. */
 /** Core API for WASM initialization and eventing. */
@@ -2796,8 +2798,8 @@ declare class MemoryStore implements StorageAdapter {
     private readonly utxos;
     private operations;
     private readonly merkleLeavesByChain;
-    private readonly merkleTreesByChain;
-    private readonly merkleNodesByChain;
+    private readonly chairmanMerkleVersionsByChain;
+    private readonly chairmanMerkleNodesByChain;
     private readonly entryMemosByChain;
     private readonly entryNullifiersByChain;
     private readonly maxOperations;
@@ -2870,29 +2872,29 @@ declare class MemoryStore implements StorageAdapter {
      */
     getMerkleLeaf(chainId: number, cid: number): Promise<MerkleLeafRecord | undefined>;
     /**
-     * Get a merkle node by id.
+     * Get a chairmanMerkle tree node by id.
      */
-    getMerkleNode(chainId: number, id: string): Promise<MerkleNodeRecord | undefined>;
+    getChairmanMerkleNode(chainId: number, id: string): Promise<ChairmanMerkleNodeRecord | undefined>;
     /**
-     * Upsert merkle nodes for a chain.
+     * Put chairmanMerkle tree nodes for a chain.
      */
-    upsertMerkleNodes(chainId: number, nodes: MerkleNodeRecord[]): Promise<void>;
+    putChairmanMerkleNodes(chainId: number, nodes: ChairmanMerkleNodeRecord[]): Promise<void>;
     /**
-     * Clear merkle nodes for a chain.
+     * Get a chairmanMerkle version record by chain and version number.
      */
-    clearMerkleNodes(chainId: number): Promise<void>;
+    getChairmanMerkleVersion(chainId: number, version: number): Promise<ChairmanMerkleVersionRecord | undefined>;
     /**
-     * Get persisted merkle tree state.
+     * Get the latest chairmanMerkle version record (highest version number) for a chain.
      */
-    getMerkleTree(chainId: number): Promise<MerkleTreeState | undefined>;
+    getLatestChairmanMerkleVersion(chainId: number): Promise<ChairmanMerkleVersionRecord | undefined>;
     /**
-     * Persist merkle tree state.
+     * Persist a chairmanMerkle version record.
      */
-    setMerkleTree(chainId: number, tree: MerkleTreeState): Promise<void>;
+    putChairmanMerkleVersion(chainId: number, record: ChairmanMerkleVersionRecord): Promise<void>;
     /**
-     * Clear merkle tree state.
+     * Clear all chairmanMerkle tree state (both nodes and versions) for a chain.
      */
-    clearMerkleTree(chainId: number): Promise<void>;
+    clearChairmanMerkleTree(chainId: number): Promise<void>;
     /**
      * Upsert entry memos (raw EntryService cache).
      */
@@ -3010,13 +3012,14 @@ declare class KeyValueStore implements StorageAdapter {
     private readonly utxoCache;
     private readonly operationCache;
     private merkleLeafCids;
-    private merkleTrees;
-    private merkleNodeIds;
+    private chairmanMerkleLatestVersions;
+    private chairmanMerkleNodeIds;
+    private chairmanMerkleVersionNums;
     private entryMemoCids;
     private entryNullifierNids;
     private readonly loadedMerkleLeaves;
-    private readonly loadedMerkleTrees;
-    private readonly loadedMerkleNodes;
+    private readonly loadedChairmanMerkleVersions;
+    private readonly loadedChairmanMerkleNodes;
     private readonly loadedEntryMemos;
     private readonly loadedEntryNullifiers;
     private saveChain;
@@ -3033,7 +3036,6 @@ declare class KeyValueStore implements StorageAdapter {
     private walletCursorKey;
     private walletUtxoKey;
     private walletOperationKey;
-    private sharedChainKey;
     private sharedChainMetaKey;
     private sharedRecordKey;
     private parseJson;
@@ -3052,16 +3054,16 @@ declare class KeyValueStore implements StorageAdapter {
     private readUtxo;
     private pruneOperationIds;
     private ensureMerkleLeavesLoaded;
-    private ensureMerkleTreeLoaded;
-    private ensureMerkleNodesLoaded;
+    private ensureChairmanMerkleVersionsLoaded;
+    private ensureChairmanMerkleNodesLoaded;
     private ensureEntryMemosLoaded;
     private ensureEntryNullifiersLoaded;
-    getMerkleNode(chainId: number, id: string): Promise<MerkleNodeRecord | undefined>;
-    upsertMerkleNodes(chainId: number, nodes: MerkleNodeRecord[]): Promise<void>;
-    clearMerkleNodes(chainId: number): Promise<void>;
-    getMerkleTree(chainId: number): Promise<MerkleTreeState | undefined>;
-    setMerkleTree(chainId: number, tree: MerkleTreeState): Promise<void>;
-    clearMerkleTree(chainId: number): Promise<void>;
+    getChairmanMerkleNode(chainId: number, id: string): Promise<ChairmanMerkleNodeRecord | undefined>;
+    putChairmanMerkleNodes(chainId: number, nodes: ChairmanMerkleNodeRecord[]): Promise<void>;
+    getChairmanMerkleVersion(chainId: number, version: number): Promise<ChairmanMerkleVersionRecord | undefined>;
+    getLatestChairmanMerkleVersion(chainId: number): Promise<ChairmanMerkleVersionRecord | undefined>;
+    putChairmanMerkleVersion(chainId: number, record: ChairmanMerkleVersionRecord): Promise<void>;
+    clearChairmanMerkleTree(chainId: number): Promise<void>;
     upsertEntryMemos(memos: EntryMemoRecord[]): Promise<void>;
     listEntryMemos(query: ListEntryMemosQuery): Promise<{
         total: number;
@@ -3166,4 +3168,4 @@ declare const OcashSdk: {
     readonly MemoryStore: typeof MemoryStore;
 };
 
-export { SEPOLIA_TESTNET as $, App_ABI as A, BABYJUBJUB_SCALAR_FIELD as B, type ChainConfigInput as C, type DepositOperation as D, type EntryMemoRecord as E, LedgerInfo as F, MemoKit as G, type Hex as H, MemoryStore as I, type MerkleLeafRecord as J, KeyManager as K, type ListEntryMemosQuery as L, type MerkleNodeRecord as M, type OCashSdk as N, type OperationType as O, type OCashSdkConfig as P, type OperationCreateInput as Q, type OpsApi as R, type StorageAdapter as S, type PlannerEstimateTransferResult as T, type UtxoRecord as U, type PlannerEstimateWithdrawResult as V, type ProofResult as W, RedisStore as X, type RedisStoreOptions as Y, type RelayerRequest as Z, SEPOLIA_DEV as _, type MerkleTreeState as a, type SdkEvent as a0, type SyncChainStatus as a1, type TokenMetadata as a2, type TransactionReceipt as a3, type TransferOperation as a4, type TransferOperationDetail as a5, type TransferWitnessInput as a6, Utils as a7, type WalletSessionInput as a8, type WithdrawOperation as a9, type WithdrawOperationDetail as aa, type WithdrawWitnessInput as ab, type WitnessBuildResult as ac, type WitnessContext as ad, assertChainConfigInput as ae, assertTokenList as af, assertTokenMetadata as ag, calcTransferProofBinding as ah, calcWithdrawProofBinding as ai, createSdk as aj, OcashSdk as ak, defaultAssetsOverrideMainnet as al, defaultAssetsOverrideTestnet as am, fetchPoolTokensFromContract as an, normalizeTokenMetadata as ao, type EntryNullifierRecord as b, type ListEntryNullifiersQuery as c, type SyncCursor as d, type ListUtxosQuery as e, type StoredOperation as f, type OperationDetailFor as g, type OperationStatus as h, type ListOperationsQuery as i, type AssetOverrideEntry as j, type AssetsOverride as k, BASE_DEV as l, BASE_MAINNET as m, BSC_DEV as n, BSC_MAINNET as o, BSC_TESTNET as p, BSC_TESTNET_DEV as q, type CommitmentData as r, CryptoToolkit as s, type DepositOperationDetail as t, DummyFactory as u, ETH_DEV as v, ETH_MAINNET as w, type KeyValueClient as x, KeyValueStore as y, type KeyValueStoreOptions as z };
+export { SEPOLIA_TESTNET as $, App_ABI as A, BABYJUBJUB_SCALAR_FIELD as B, type ChairmanMerkleNodeRecord as C, type DepositOperation as D, type EntryMemoRecord as E, type KeyValueStoreOptions as F, LedgerInfo as G, type Hex as H, MemoryStore as I, type MerkleLeafRecord as J, KeyManager as K, type ListEntryMemosQuery as L, MemoKit as M, type OCashSdk as N, type OperationType as O, type OCashSdkConfig as P, type OperationCreateInput as Q, type OpsApi as R, type StorageAdapter as S, type PlannerEstimateTransferResult as T, type UtxoRecord as U, type PlannerEstimateWithdrawResult as V, type ProofResult as W, RedisStore as X, type RedisStoreOptions as Y, type RelayerRequest as Z, SEPOLIA_DEV as _, type ChairmanMerkleVersionRecord as a, type SdkEvent as a0, type SyncChainStatus as a1, type TokenMetadata as a2, type TransactionReceipt as a3, type TransferOperation as a4, type TransferOperationDetail as a5, type TransferWitnessInput as a6, Utils as a7, type WalletSessionInput as a8, type WithdrawOperation as a9, type WithdrawOperationDetail as aa, type WithdrawWitnessInput as ab, type WitnessBuildResult as ac, type WitnessContext as ad, assertChainConfigInput as ae, assertTokenList as af, assertTokenMetadata as ag, calcTransferProofBinding as ah, calcWithdrawProofBinding as ai, createSdk as aj, OcashSdk as ak, defaultAssetsOverrideMainnet as al, defaultAssetsOverrideTestnet as am, fetchPoolTokensFromContract as an, normalizeTokenMetadata as ao, type EntryNullifierRecord as b, type ListEntryNullifiersQuery as c, type SyncCursor as d, type ListUtxosQuery as e, type StoredOperation as f, type OperationDetailFor as g, type OperationStatus as h, type ListOperationsQuery as i, type AssetOverrideEntry as j, type AssetsOverride as k, BASE_DEV as l, BASE_MAINNET as m, BSC_DEV as n, BSC_MAINNET as o, BSC_TESTNET as p, BSC_TESTNET_DEV as q, type ChainConfigInput as r, type CommitmentData as s, CryptoToolkit as t, type DepositOperationDetail as u, DummyFactory as v, ETH_DEV as w, ETH_MAINNET as x, type KeyValueClient as y, KeyValueStore as z };

package/dist/{index-CI7UllxU.d.ts → index-Dvl0HZkw.d.ts}

@@ -203,6 +203,13 @@ interface OCashSdkConfig {
          * Merkle depth used by the on-chain tree (defaults to 32).
          */
         treeDepth?: number;
+        /**
+         * Optional callback to read `merkleRoots(rootIndex)` from the on-chain contract.
+         * When provided, each batch merge is verified against the contract root.
+         * Return null if the contract hasn't committed this index yet (treated as "skip").
+         * A zero root (0x000...0) is also treated as "not yet committed".
+         */
+        readContractRoot?: (chainId: number, rootIndex: number) => Promise<Hex | null>;
     };
     sync?: {
         pageSize?: number;
@@ -634,19 +641,26 @@ type ListUtxosResult = {
     total: number;
     rows: UtxoRecord[];
 };
-/** Persisted merkle tree state metadata. */
-type MerkleTreeState = {
-    /** Chain id (scoped). */
+/** ChairmanMerkle tree (persistent segment tree) node. */
+type ChairmanMerkleNodeRecord = {
     chainId: number;
-    /** Current tree root (for the merged/main tree). */
-    root: Hex;
-    /**
-     * Total elements that have been merged into the main tree.
-     * This matches `totalElementsInTree(contract.totalElements, tempArraySize)`.
-     */
-    totalElements: number;
-    /** Last updated timestamp (ms). */
-    lastUpdated: number;
+    /** Unique node ID. Main tree: `cm-{version}-{level}`, subtree internal: `st-{level}-{position}` */
+    id: string;
+    hash: Hex;
+    /** Left child node ID (null for leaf/subtree nodes). */
+    leftId: string | null;
+    /** Right child node ID (null for leaf/subtree nodes). */
+    rightId: string | null;
+};
+/** ChairmanMerkle tree version — maps a mergedElements count to a persistent root. */
+type ChairmanMerkleVersionRecord = {
+    chainId: number;
+    /** Version = mergedElements count (0, 32, 64, …). */
+    version: number;
+    /** Root node ID for this version. */
+    rootId: string;
+    /** Root hash (cached for quick lookup without traversal). */
+    rootHash: Hex;
 };
 /** Persisted merkle leaf record. */
 type MerkleLeafRecord = {
@@ -654,19 +668,6 @@ type MerkleLeafRecord = {
     cid: number;
     commitment: Hex;
 };
-/** Persisted merkle node record. */
-type MerkleNodeRecord = {
-    chainId: number;
-    /**
-     * Node id.
-     * - Normal node: `${level}-${position}`
-     * - Frontier node: `frontier-${level}`
-     */
-    id: string;
-    level: number;
-    position: number;
-    hash: Hex;
-};
 /** Storage adapter interface for persistence. */
 interface StorageAdapter {
     /**
@@ -739,11 +740,19 @@ interface StorageAdapter {
      */
     getMerkleLeaf?(chainId: number, cid: number): Promise<MerkleLeafRecord | undefined>;
     /**
-     * Optional Merkle DB: node lookup by id (fast path for proof generation and incremental updates).
+     * ChairmanMerkle tree (persistent segment tree) node storage.
+     * Used for both main-tree versioned nodes and subtree internal nodes.
      */
-    getMerkleNode?(chainId: number, id: string): Promise<MerkleNodeRecord | undefined>;
-    upsertMerkleNodes?(chainId: number, nodes: MerkleNodeRecord[]): Promise<void>;
-    clearMerkleNodes?(chainId: number): Promise<void>;
+    getChairmanMerkleNode?(chainId: number, id: string): Promise<ChairmanMerkleNodeRecord | undefined>;
+    putChairmanMerkleNodes?(chainId: number, nodes: ChairmanMerkleNodeRecord[]): Promise<void>;
+    /**
+     * ChairmanMerkle tree version storage.
+     * Each version maps a mergedElements count to a persistent root.
+     */
+    getChairmanMerkleVersion?(chainId: number, version: number): Promise<ChairmanMerkleVersionRecord | undefined>;
+    getLatestChairmanMerkleVersion?(chainId: number): Promise<ChairmanMerkleVersionRecord | undefined>;
+    putChairmanMerkleVersion?(chainId: number, record: ChairmanMerkleVersionRecord): Promise<void>;
+    clearChairmanMerkleTree?(chainId: number): Promise<void>;
     /**
      * Optional entry memo persistence (raw EntryService payloads).
      * Useful for debugging, rebuilds, and app-like local caches.
@@ -758,13 +767,6 @@ interface StorageAdapter {
     upsertEntryNullifiers?(nullifiers: EntryNullifierRecord[]): Promise<void> | void;
     listEntryNullifiers?(query: ListEntryNullifiersQuery): Promise<ListEntryNullifiersResult>;
     clearEntryNullifiers?(chainId: number): Promise<void> | void;
-    /**
-     * Optional merkle tree state persistence (merged/main-tree only).
-     * This mirrors the client/app `MerkleDexie.trees` metadata.
-     */
-    getMerkleTree?(chainId: number): Promise<MerkleTreeState | undefined>;
-    setMerkleTree?(chainId: number, tree: MerkleTreeState): Promise<void>;
-    clearMerkleTree?(chainId: number): Promise<void>;
 }
 /** WASM & circuit initialization. Call `ready()` before any proof operations. */
 /** Core API for WASM initialization and eventing. */
@@ -2796,8 +2798,8 @@ declare class MemoryStore implements StorageAdapter {
     private readonly utxos;
     private operations;
     private readonly merkleLeavesByChain;
-    private readonly merkleTreesByChain;
-    private readonly merkleNodesByChain;
+    private readonly chairmanMerkleVersionsByChain;
+    private readonly chairmanMerkleNodesByChain;
     private readonly entryMemosByChain;
     private readonly entryNullifiersByChain;
     private readonly maxOperations;
@@ -2870,29 +2872,29 @@ declare class MemoryStore implements StorageAdapter {
      */
     getMerkleLeaf(chainId: number, cid: number): Promise<MerkleLeafRecord | undefined>;
     /**
-     * Get a merkle node by id.
+     * Get a chairmanMerkle tree node by id.
      */
-    getMerkleNode(chainId: number, id: string): Promise<MerkleNodeRecord | undefined>;
+    getChairmanMerkleNode(chainId: number, id: string): Promise<ChairmanMerkleNodeRecord | undefined>;
     /**
-     * Upsert merkle nodes for a chain.
+     * Put chairmanMerkle tree nodes for a chain.
      */
-    upsertMerkleNodes(chainId: number, nodes: MerkleNodeRecord[]): Promise<void>;
+    putChairmanMerkleNodes(chainId: number, nodes: ChairmanMerkleNodeRecord[]): Promise<void>;
     /**
-     * Clear merkle nodes for a chain.
+     * Get a chairmanMerkle version record by chain and version number.
      */
-    clearMerkleNodes(chainId: number): Promise<void>;
+    getChairmanMerkleVersion(chainId: number, version: number): Promise<ChairmanMerkleVersionRecord | undefined>;
     /**
-     * Get persisted merkle tree state.
+     * Get the latest chairmanMerkle version record (highest version number) for a chain.
      */
-    getMerkleTree(chainId: number): Promise<MerkleTreeState | undefined>;
+    getLatestChairmanMerkleVersion(chainId: number): Promise<ChairmanMerkleVersionRecord | undefined>;
     /**
-     * Persist merkle tree state.
+     * Persist a chairmanMerkle version record.
      */
-    setMerkleTree(chainId: number, tree: MerkleTreeState): Promise<void>;
+    putChairmanMerkleVersion(chainId: number, record: ChairmanMerkleVersionRecord): Promise<void>;
     /**
-     * Clear merkle tree state.
+     * Clear all chairmanMerkle tree state (both nodes and versions) for a chain.
      */
-    clearMerkleTree(chainId: number): Promise<void>;
+    clearChairmanMerkleTree(chainId: number): Promise<void>;
     /**
      * Upsert entry memos (raw EntryService cache).
      */
@@ -3010,13 +3012,14 @@ declare class KeyValueStore implements StorageAdapter {
     private readonly utxoCache;
     private readonly operationCache;
     private merkleLeafCids;
-    private merkleTrees;
-    private merkleNodeIds;
+    private chairmanMerkleLatestVersions;
+    private chairmanMerkleNodeIds;
+    private chairmanMerkleVersionNums;
     private entryMemoCids;
     private entryNullifierNids;
     private readonly loadedMerkleLeaves;
-    private readonly loadedMerkleTrees;
-    private readonly loadedMerkleNodes;
+    private readonly loadedChairmanMerkleVersions;
+    private readonly loadedChairmanMerkleNodes;
     private readonly loadedEntryMemos;
     private readonly loadedEntryNullifiers;
     private saveChain;
@@ -3033,7 +3036,6 @@ declare class KeyValueStore implements StorageAdapter {
     private walletCursorKey;
     private walletUtxoKey;
     private walletOperationKey;
-    private sharedChainKey;
     private sharedChainMetaKey;
     private sharedRecordKey;
     private parseJson;
@@ -3052,16 +3054,16 @@ declare class KeyValueStore implements StorageAdapter {
     private readUtxo;
     private pruneOperationIds;
     private ensureMerkleLeavesLoaded;
-    private ensureMerkleTreeLoaded;
-    private ensureMerkleNodesLoaded;
+    private ensureChairmanMerkleVersionsLoaded;
+    private ensureChairmanMerkleNodesLoaded;
     private ensureEntryMemosLoaded;
     private ensureEntryNullifiersLoaded;
-    getMerkleNode(chainId: number, id: string): Promise<MerkleNodeRecord | undefined>;
-    upsertMerkleNodes(chainId: number, nodes: MerkleNodeRecord[]): Promise<void>;
-    clearMerkleNodes(chainId: number): Promise<void>;
-    getMerkleTree(chainId: number): Promise<MerkleTreeState | undefined>;
-    setMerkleTree(chainId: number, tree: MerkleTreeState): Promise<void>;
-    clearMerkleTree(chainId: number): Promise<void>;
+    getChairmanMerkleNode(chainId: number, id: string): Promise<ChairmanMerkleNodeRecord | undefined>;
+    putChairmanMerkleNodes(chainId: number, nodes: ChairmanMerkleNodeRecord[]): Promise<void>;
+    getChairmanMerkleVersion(chainId: number, version: number): Promise<ChairmanMerkleVersionRecord | undefined>;
+    getLatestChairmanMerkleVersion(chainId: number): Promise<ChairmanMerkleVersionRecord | undefined>;
+    putChairmanMerkleVersion(chainId: number, record: ChairmanMerkleVersionRecord): Promise<void>;
+    clearChairmanMerkleTree(chainId: number): Promise<void>;
     upsertEntryMemos(memos: EntryMemoRecord[]): Promise<void>;
     listEntryMemos(query: ListEntryMemosQuery): Promise<{
         total: number;
@@ -3166,4 +3168,4 @@ declare const OcashSdk: {
     readonly MemoryStore: typeof MemoryStore;
 };
 
-export { SEPOLIA_TESTNET as $, App_ABI as A, BABYJUBJUB_SCALAR_FIELD as B, type ChainConfigInput as C, type DepositOperation as D, type EntryMemoRecord as E, LedgerInfo as F, MemoKit as G, type Hex as H, MemoryStore as I, type MerkleLeafRecord as J, KeyManager as K, type ListEntryMemosQuery as L, type MerkleNodeRecord as M, type OCashSdk as N, type OperationType as O, type OCashSdkConfig as P, type OperationCreateInput as Q, type OpsApi as R, type StorageAdapter as S, type PlannerEstimateTransferResult as T, type UtxoRecord as U, type PlannerEstimateWithdrawResult as V, type ProofResult as W, RedisStore as X, type RedisStoreOptions as Y, type RelayerRequest as Z, SEPOLIA_DEV as _, type MerkleTreeState as a, type SdkEvent as a0, type SyncChainStatus as a1, type TokenMetadata as a2, type TransactionReceipt as a3, type TransferOperation as a4, type TransferOperationDetail as a5, type TransferWitnessInput as a6, Utils as a7, type WalletSessionInput as a8, type WithdrawOperation as a9, type WithdrawOperationDetail as aa, type WithdrawWitnessInput as ab, type WitnessBuildResult as ac, type WitnessContext as ad, assertChainConfigInput as ae, assertTokenList as af, assertTokenMetadata as ag, calcTransferProofBinding as ah, calcWithdrawProofBinding as ai, createSdk as aj, OcashSdk as ak, defaultAssetsOverrideMainnet as al, defaultAssetsOverrideTestnet as am, fetchPoolTokensFromContract as an, normalizeTokenMetadata as ao, type EntryNullifierRecord as b, type ListEntryNullifiersQuery as c, type SyncCursor as d, type ListUtxosQuery as e, type StoredOperation as f, type OperationDetailFor as g, type OperationStatus as h, type ListOperationsQuery as i, type AssetOverrideEntry as j, type AssetsOverride as k, BASE_DEV as l, BASE_MAINNET as m, BSC_DEV as n, BSC_MAINNET as o, BSC_TESTNET as p, BSC_TESTNET_DEV as q, type CommitmentData as r, CryptoToolkit as s, type DepositOperationDetail as t, DummyFactory as u, ETH_DEV as v, ETH_MAINNET as w, type KeyValueClient as x, KeyValueStore as y, type KeyValueStoreOptions as z };
+export { SEPOLIA_TESTNET as $, App_ABI as A, BABYJUBJUB_SCALAR_FIELD as B, type ChairmanMerkleNodeRecord as C, type DepositOperation as D, type EntryMemoRecord as E, type KeyValueStoreOptions as F, LedgerInfo as G, type Hex as H, MemoryStore as I, type MerkleLeafRecord as J, KeyManager as K, type ListEntryMemosQuery as L, MemoKit as M, type OCashSdk as N, type OperationType as O, type OCashSdkConfig as P, type OperationCreateInput as Q, type OpsApi as R, type StorageAdapter as S, type PlannerEstimateTransferResult as T, type UtxoRecord as U, type PlannerEstimateWithdrawResult as V, type ProofResult as W, RedisStore as X, type RedisStoreOptions as Y, type RelayerRequest as Z, SEPOLIA_DEV as _, type ChairmanMerkleVersionRecord as a, type SdkEvent as a0, type SyncChainStatus as a1, type TokenMetadata as a2, type TransactionReceipt as a3, type TransferOperation as a4, type TransferOperationDetail as a5, type TransferWitnessInput as a6, Utils as a7, type WalletSessionInput as a8, type WithdrawOperation as a9, type WithdrawOperationDetail as aa, type WithdrawWitnessInput as ab, type WitnessBuildResult as ac, type WitnessContext as ad, assertChainConfigInput as ae, assertTokenList as af, assertTokenMetadata as ag, calcTransferProofBinding as ah, calcWithdrawProofBinding as ai, createSdk as aj, OcashSdk as ak, defaultAssetsOverrideMainnet as al, defaultAssetsOverrideTestnet as am, fetchPoolTokensFromContract as an, normalizeTokenMetadata as ao, type EntryNullifierRecord as b, type ListEntryNullifiersQuery as c, type SyncCursor as d, type ListUtxosQuery as e, type StoredOperation as f, type OperationDetailFor as g, type OperationStatus as h, type ListOperationsQuery as i, type AssetOverrideEntry as j, type AssetsOverride as k, BASE_DEV as l, BASE_MAINNET as m, BSC_DEV as n, BSC_MAINNET as o, BSC_TESTNET as p, BSC_TESTNET_DEV as q, type ChainConfigInput as r, type CommitmentData as s, CryptoToolkit as t, type DepositOperationDetail as u, DummyFactory as v, ETH_DEV as w, ETH_MAINNET as x, type KeyValueClient as y, KeyValueStore as z };