@ocash/sdk 0.1.0 → 0.1.1

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

@@ -1,8 +1,17 @@
 import { Address, PublicClient } from 'viem';
 
+/**
+ * Lifecycle states for local operation records.
+ */
 type OperationStatus = 'created' | 'submitted' | 'confirmed' | 'failed';
+/**
+ * Built-in operation types with support for custom extensions.
+ */
 type OperationType = 'deposit' | 'transfer' | 'withdraw' | (string & {});
 type Hex$1 = `0x${string}`;
+/**
+ * Query/filter options for listing operations.
+ */
 type ListOperationsQuery = {
     limit?: number;
     offset?: number;
@@ -12,6 +21,9 @@ type ListOperationsQuery = {
     status?: OperationStatus | OperationStatus[];
     sort?: 'desc' | 'asc';
 };
+/**
+ * Detail payload for deposit operations.
+ */
 type DepositOperationDetail = {
     token: string;
     amount: string;
@@ -20,6 +32,9 @@ type DepositOperationDetail = {
     inputCommitments?: Hex$1[];
     outputCommitments?: Hex$1[];
 };
+/**
+ * Detail payload for transfer operations.
+ */
 type TransferOperationDetail = {
     token: string;
     amount: string;
@@ -32,6 +47,9 @@ type TransferOperationDetail = {
     inputCommitments?: Hex$1[];
     outputCommitments?: Hex$1[];
 };
+/**
+ * Detail payload for withdraw operations.
+ */
 type WithdrawOperationDetail = {
     token: string;
     amount: string;
@@ -46,12 +64,21 @@ type WithdrawOperationDetail = {
     inputCommitments?: Hex$1[];
     outputCommitments?: Hex$1[];
 };
+/**
+ * Mapping of builtin operation types to their detail payloads.
+ */
 type BuiltinOperationDetailByType = {
     deposit: DepositOperationDetail;
     transfer: TransferOperationDetail;
     withdraw: WithdrawOperationDetail;
 };
+/**
+ * Resolve detail shape for a given operation type.
+ */
 type OperationDetailFor<TType extends OperationType> = TType extends keyof BuiltinOperationDetailByType ? BuiltinOperationDetailByType[TType] : Record<string, unknown>;
+/**
+ * Stored operation record as persisted by StorageAdapter implementations.
+ */
 type StoredOperation<TDetail = Record<string, unknown>> = {
     id: string;
     type: OperationType;
@@ -65,6 +92,9 @@ type StoredOperation<TDetail = Record<string, unknown>> = {
     detail?: TDetail;
     error?: string;
 };
+/**
+ * Input shape for creating a new operation record.
+ */
 type OperationCreateInput<TType extends OperationType = OperationType> = Omit<StoredOperation<OperationDetailFor<TType>>, 'id' | 'createdAt' | 'status'> & Partial<Pick<StoredOperation<OperationDetailFor<TType>>, 'createdAt' | 'id' | 'status'>> & {
     type: TType;
 };
@@ -81,10 +111,15 @@ type WithdrawOperation = Omit<StoredOperation<WithdrawOperationDetail>, 'type'>
     detail?: WithdrawOperationDetail;
 };
 
+/** Hex-encoded bytes with 0x prefix. */
 type Hex = `0x${string}`;
+/** Decimal string representing a bigint value. */
 type BigintLikeString = string;
+/** viem transaction receipt type alias. */
 type TransactionReceipt = Awaited<ReturnType<PublicClient['waitForTransactionReceipt']>>;
+/** SDK error code namespaces. */
 type SdkErrorCode = 'CONFIG' | 'ASSETS' | 'STORAGE' | 'SYNC' | 'CRYPTO' | 'MERKLE' | 'WITNESS' | 'PROOF' | 'RELAYER';
+/** Token configuration for a shielded pool. */
 interface TokenMetadata {
     id: string;
     symbol: string;
@@ -97,6 +132,7 @@ interface TokenMetadata {
     transferMaxAmount?: bigint | string;
     withdrawMaxAmount?: bigint | string;
 }
+/** Chain configuration input for SDK initialization. */
 interface ChainConfigInput {
     chainId: number;
     rpcUrl?: string;
@@ -111,15 +147,18 @@ interface ChainConfigInput {
      */
     contract?: Address;
 }
+/** Relayer fee entry for a specific pool. */
 interface RelayerFeeEntry {
     token_address: Hex;
     fee: bigint;
 }
+/** Relayer fee tables for transfer/withdraw actions. */
 interface RelayerFeeConfigure {
     valid_time: number;
     transfer: Record<string, RelayerFeeEntry>;
     withdraw: Record<string, RelayerFeeEntry>;
 }
+/** Relayer configuration fetched from relayer service. */
 interface RelayerConfig {
     config: {
         contract_address: Address;
@@ -132,15 +171,20 @@ interface RelayerConfig {
     fee_configure: RelayerFeeConfigure;
     fetched_at?: number;
 }
+/** Worker configuration for memo decryption. */
 interface MemoWorkerConfig {
     workerUrl?: string;
     concurrency?: number;
     type?: 'classic' | 'module';
 }
+/** Asset override entry: URL/path or sharded list. */
 type AssetOverrideEntry = string | string[];
+/** Map of required runtime assets to URLs/paths. */
 interface AssetsOverride {
     [filename: string]: AssetOverrideEntry;
 }
+/** SDK configuration passed to {@link createSdk}. */
+/** SDK configuration passed to createSdk(). */
 interface OCashSdkConfig {
     chains: ChainConfigInput[];
     assetsOverride?: AssetsOverride;
@@ -176,12 +220,14 @@ interface OCashSdkConfig {
     };
     onEvent?: (event: SdkEvent) => void;
 }
+/** Serialized error payload used in events. */
 interface SdkErrorPayload {
     code: SdkErrorCode;
     message: string;
     detail?: unknown;
     cause?: unknown;
 }
+/** Union of all SDK event payloads. */
 type SdkEvent = {
     type: 'core:ready';
     payload: {
@@ -266,6 +312,7 @@ type SdkEvent = {
     type: 'error';
     payload: SdkErrorPayload;
 };
+/** Record opening used in commitments and memos. */
 interface CommitmentData {
     asset_id: bigint;
     asset_amount: bigint;
@@ -275,11 +322,13 @@ interface CommitmentData {
     blinding_factor: bigint;
     is_frozen: boolean;
 }
+/** Batch decrypt request entry. */
 interface MemoDecryptRequest {
     memo: Hex;
     secretKey: bigint;
     metadata?: Record<string, unknown>;
 }
+/** Batch decrypt response entry. */
 interface MemoDecryptResult {
     memo: Hex;
     record: CommitmentData | null;
@@ -288,6 +337,7 @@ interface MemoDecryptResult {
         message: string;
     };
 }
+/** Accumulator membership witness used by circuits. */
 interface AccMemberWitness {
     /**
      * Circuits witness format (matches `circuits/pkg/core/policies/witness_json.go`):
@@ -299,6 +349,7 @@ interface AccMemberWitness {
     path: Array<Hex | BigintLikeString>;
     index: number;
 }
+/** Input secret (keypair + record opening + merkle witness). */
 interface InputSecret {
     owner_keypair: {
         user_pk: {
@@ -317,18 +368,22 @@ interface InputSecret {
     ro: CommitmentData;
     acc_member_witness: AccMemberWitness;
 }
+/** Circuits JSON format for field points. */
 interface FrPointJson {
     X: bigint;
     Y: bigint;
 }
+/** Circuits JSON format for viewer public key. */
 interface ViewerPkJson {
     EncryptionKey: {
         Key: FrPointJson;
     };
 }
+/** Circuits JSON format for freezer public key. */
 interface FreezerPkJson {
     Point: FrPointJson;
 }
+/** Witness input for transfer circuit. */
 interface TransferWitnessInput {
     asset_id: string;
     asset_token_id: string;
@@ -344,6 +399,7 @@ interface TransferWitnessInput {
     viewing_memo_randomness?: Uint8Array | number[];
     proof_binding?: string;
 }
+/** Witness input for withdraw circuit. */
 interface WithdrawWitnessInput {
     asset_id: string;
     asset_token_id: string;
@@ -360,6 +416,7 @@ interface WithdrawWitnessInput {
     viewing_memo_randomness?: Uint8Array | number[];
     proof_binding?: string;
 }
+/** Witness build output with metadata from context. */
 interface WitnessBuildResult {
     witness: TransferWitnessInput | WithdrawWitnessInput | Record<string, any>;
     array_hash_index?: number;
@@ -372,6 +429,7 @@ interface WitnessBuildResult {
     witness_type?: 'transfer' | 'withdraw';
     warnings?: string[];
 }
+/** Context fields attached to witness/proof creation. */
 interface WitnessContext {
     array_hash_index?: number;
     merkle_root_index?: number;
@@ -383,6 +441,7 @@ interface WitnessContext {
     recipient?: Address;
     withdraw_amount?: bigint;
 }
+/** Proof result returned from the prover bridge. */
 interface ProofResult {
     proof: [string, string, string, string, string, string, string, string];
     flatten_input: string[];
@@ -404,9 +463,13 @@ interface ProofResult {
     } | null;
     warnings?: string[];
 }
+/** Extra data payload for transfer proofs (3 memos). */
 type TransferExtraData = readonly [Hex, Hex, Hex];
+/** Extra data payload for withdraw proofs (1 memo). */
 type WithdrawExtraData = Hex;
+/** Union of extra data payloads by action. */
 type WitnessExtraData = TransferExtraData | WithdrawExtraData;
+/** Low-level WASM proof bridge interface. */
 interface ProofBridge {
     init(): Promise<void>;
     initTransfer(): Promise<void>;
@@ -420,11 +483,13 @@ interface ProofBridge {
     createDummyRecordOpening(): Promise<CommitmentData>;
     createDummyInputSecret(): Promise<InputSecret>;
 }
+/** Commitment function overloads by return format. */
 interface CommitmentFn {
     (ro: CommitmentData, format: 'hex'): Hex;
     (ro: CommitmentData, format: 'bigint'): bigint;
     (ro: CommitmentData, format?: undefined): Hex;
 }
+/** Sync cursors for memo/nullifier/merkle resources. */
 interface SyncCursor {
     memo: number;
     nullifier: number;
@@ -434,6 +499,7 @@ interface SyncCursor {
      */
     merkle: number;
 }
+/** Per-chain sync status (memo/nullifier/merkle). */
 interface SyncChainStatus {
     memo: {
         status: 'idle' | 'syncing' | 'synced' | 'error';
@@ -453,6 +519,7 @@ interface SyncChainStatus {
         errorMessage?: string;
     };
 }
+/** UTXO list query options. */
 type ListUtxosQuery = {
     /** Filter by chain id. */
     chainId?: number;
@@ -475,6 +542,7 @@ type ListUtxosQuery = {
     /** Order direction (default: asc). */
     order?: 'asc' | 'desc';
 };
+/** Persisted entry memo record (raw EntryService memo). */
 type EntryMemoRecord = {
     /** Chain id (scoped). */
     chainId: number;
@@ -497,6 +565,7 @@ type EntryMemoRecord = {
     /** Optional created_at from EntryService. */
     createdAt?: number | null;
 };
+/** Persisted entry nullifier record (raw EntryService nullifier). */
 type EntryNullifierRecord = {
     /** Chain id (scoped). */
     chainId: number;
@@ -510,6 +579,7 @@ type EntryNullifierRecord = {
     /** Optional created_at from EntryService. */
     createdAt?: number | null;
 };
+/** Query options for entry memos. */
 type ListEntryMemosQuery = {
     chainId: number;
     /** Start cid (inclusive). Defaults to 0. */
@@ -529,6 +599,7 @@ type ListEntryMemosQuery = {
     /** Filter by createdAt range (inclusive, epoch). */
     createdAtTo?: number;
 };
+/** Query options for entry nullifiers. */
 type ListEntryNullifiersQuery = {
     chainId: number;
     /** nid offset (defaults to 0). */
@@ -548,18 +619,22 @@ type ListEntryNullifiersQuery = {
     /** Filter by createdAt range (inclusive, epoch). */
     createdAtTo?: number;
 };
+/** Paged result for entry memos. */
 type ListEntryMemosResult = {
     total: number;
     rows: EntryMemoRecord[];
 };
+/** Paged result for entry nullifiers. */
 type ListEntryNullifiersResult = {
     total: number;
     rows: EntryNullifierRecord[];
 };
+/** Paged result for UTXOs. */
 type ListUtxosResult = {
     total: number;
     rows: UtxoRecord[];
 };
+/** Persisted merkle tree state metadata. */
 type MerkleTreeState = {
     /** Chain id (scoped). */
     chainId: number;
@@ -573,11 +648,13 @@ type MerkleTreeState = {
     /** Last updated timestamp (ms). */
     lastUpdated: number;
 };
+/** Persisted merkle leaf record. */
 type MerkleLeafRecord = {
     chainId: number;
     cid: number;
     commitment: Hex;
 };
+/** Persisted merkle node record. */
 type MerkleNodeRecord = {
     chainId: number;
     /**
@@ -590,10 +667,11 @@ type MerkleNodeRecord = {
     position: number;
     hash: Hex;
 };
+/** Storage adapter interface for persistence. */
 interface StorageAdapter {
     /**
      * Initialize adapter state, optionally scoping storage by wallet id.
-     * Implementations should clear any cached state when `walletId` changes.
+     * Implementations should clear wallet-scoped state when `walletId` changes.
      */
     init?(options?: {
         walletId?: string;
@@ -670,14 +748,14 @@ interface StorageAdapter {
      * Optional entry memo persistence (raw EntryService payloads).
      * Useful for debugging, rebuilds, and app-like local caches.
      */
-    upsertEntryMemos?(memos: EntryMemoRecord[]): Promise<number> | number;
+    upsertEntryMemos?(memos: EntryMemoRecord[]): Promise<void> | void;
     listEntryMemos?(query: ListEntryMemosQuery): Promise<ListEntryMemosResult>;
     clearEntryMemos?(chainId: number): Promise<void> | void;
     /**
      * Optional entry nullifier persistence (raw EntryService payloads).
      * Useful for debugging and app-like local caches.
      */
-    upsertEntryNullifiers?(nullifiers: EntryNullifierRecord[]): Promise<number> | number;
+    upsertEntryNullifiers?(nullifiers: EntryNullifierRecord[]): Promise<void> | void;
     listEntryNullifiers?(query: ListEntryNullifiersQuery): Promise<ListEntryNullifiersResult>;
     clearEntryNullifiers?(chainId: number): Promise<void> | void;
     /**
@@ -688,15 +766,26 @@ interface StorageAdapter {
     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. */
 interface CoreApi {
+    /** Load Go WASM runtime, compile circuits, and initialize proof engine. */
     ready: (onProgress?: (value: number) => void) => Promise<void>;
+    /** Release WASM resources and reset internal state. */
     reset: () => void;
+    /** Subscribe to a specific SDK event type. */
     on: (type: SdkEvent['type'], handler: (event: SdkEvent) => void) => void;
+    /** Unsubscribe from a specific SDK event type. */
     off: (type: SdkEvent['type'], handler: (event: SdkEvent) => void) => void;
 }
+/** Cryptographic primitives: Poseidon2 commitments, nullifiers, memo encryption. */
+/** Crypto primitives exposed by the SDK. */
 interface CryptoApi {
+    /** Compute Poseidon2 commitment from record opening data. */
     commitment: CommitmentFn;
+    /** Derive nullifier = Poseidon2(commitment, secret_key, merkle_index). */
     nullifier: (secretKey: bigint, commitment: Hex, freezerPk?: [bigint, bigint]) => Hex;
+    /** Create a record opening with normalized BigInt fields and random blinding factor. */
     createRecordOpening: (input: {
         asset_id: bigint | number | string;
         asset_amount: bigint | number | string;
@@ -725,17 +814,26 @@ interface CryptoApi {
         serializeBigInt: <T>(value: T) => string;
     };
 }
+/** BabyJubjub key derivation and address conversion. Seed must be >= 16 characters. */
+/** Key derivation and address conversion API. */
 interface KeysApi {
+    /** Derive full key pair (secret + public) from seed via HKDF-SHA256. */
     deriveKeyPair: (seed: string, nonce?: string) => UserKeyPair;
+    /** Derive secret key only (includes public key). */
     getSecretKeyBySeed: (seed: string, nonce?: string) => UserSecretKey;
+    /** Derive public key only (no secret key exposure). */
     getPublicKeyBySeed: (seed: string, nonce?: string) => UserPublicKey;
+    /** Compress BabyJubjub public key to 32-byte viewing address (0x...). */
     userPkToAddress: (userPk: {
         user_address: [bigint | string, bigint | string];
     }) => Hex;
+    /** Decompress viewing address back to BabyJubjub public key point. */
     addressToUserPk: (address: Hex) => {
         user_address: [bigint, bigint];
     };
 }
+/** Chain, token, and relayer configuration queries. */
+/** Assets API for chain/token/relayer configuration. */
 interface AssetsApi {
     getChains: () => ChainConfigInput[];
     getChain: (chainId: number) => ChainConfigInput;
@@ -743,20 +841,28 @@ interface AssetsApi {
     getPoolInfo: (chainId: number, tokenId: string) => TokenMetadata | undefined;
     getAllowanceTarget: (chainId: number) => Address;
     appendTokens: (chainId: number, tokens: TokenMetadata[]) => void;
+    /** Load chain/token config from a remote JSON URL. */
     loadFromUrl: (url: string) => Promise<void>;
     getRelayerConfig: (chainId: number) => RelayerConfig | undefined;
+    /** Fetch latest relayer config (fees, limits) from the relayer service. */
     syncRelayerConfig: (chainId: number) => Promise<RelayerConfig>;
     syncAllRelayerConfigs: () => Promise<void>;
 }
+/** Storage API exposure for adapter access. */
 interface StorageApi {
     getAdapter: () => StorageAdapter;
 }
+/** Memo, nullifier, and Merkle tree synchronization from Entry service. */
+/** Sync API for EntryService resources. */
 interface SyncApi {
+    /** Start background polling. Syncs immediately then repeats at `pollMs` interval. */
     start(options?: {
         chainIds?: number[];
         pollMs?: number;
     }): Promise<void>;
+    /** Stop polling and abort any in-flight sync. */
     stop(): void;
+    /** Run a single sync pass. Resolves when all requested resources are synced. */
     syncOnce(options?: {
         chainIds?: number[];
         resources?: Array<'memo' | 'nullifier' | 'merkle'>;
@@ -767,6 +873,7 @@ interface SyncApi {
     }): Promise<void>;
     getStatus(): Record<number, SyncChainStatus>;
 }
+/** Merkle proof response shape from remote service. */
 interface RemoteMerkleProofResponse {
     proof: Array<{
         path: Array<Hex | BigintLikeString>;
@@ -775,6 +882,7 @@ interface RemoteMerkleProofResponse {
     merkle_root: Hex | BigintLikeString;
     latest_cid: number;
 }
+/** Merkle API for proof generation and witness building. */
 interface MerkleApi {
     currentMerkleRootIndex: (totalElements: number, tempArraySize?: number) => number;
     /**
@@ -831,10 +939,16 @@ interface MerkleApi {
         maxInputs?: number;
     }) => Promise<InputSecret[]>;
 }
+/** Wallet open session parameters. */
 interface WalletSessionInput {
+    /**
+     * Secret seed for key derivation (min 16 characters).
+     * Any passphrase, hex string, or raw bytes — internally run through HKDF-SHA256.
+     */
     seed: string | Uint8Array;
     accountNonce?: number;
 }
+/** UTXO record stored in local persistence. */
 interface UtxoRecord {
     chainId: number;
     assetId: string;
@@ -847,19 +961,27 @@ interface UtxoRecord {
     memo?: Hex;
     createdAt?: number;
 }
+/** Wallet session, UTXO queries, and balance. */
+/** Wallet API for UTXO queries and session lifecycle. */
 interface WalletApi {
+    /** Open wallet session: derive keys from seed, initialize storage. */
     open(session: WalletSessionInput): Promise<void>;
+    /** Close session: release keys, flush storage. */
     close(): Promise<void>;
+    /** Query unspent UTXOs with optional filters. */
     getUtxos(query?: ListUtxosQuery): Promise<ListUtxosResult>;
-    getBalance(query?: {
-        chainId?: number;
-        assetId?: string;
+    /** Get total balance (sum of unspent, unfrozen UTXO amounts). */
+    getBalance(query: {
+        chainId: number;
+        assetId: string;
     }): Promise<bigint>;
+    /** Mark UTXOs as spent by their nullifiers. */
     markSpent(input: {
         chainId: number;
         nullifiers: Hex[];
     }): Promise<void>;
 }
+/** Planner estimate result for transfer. */
 type PlannerEstimateTransferResult = {
     action: 'transfer';
     chainId: number;
@@ -877,6 +999,7 @@ type PlannerEstimateTransferResult = {
         maxInputs: number;
     };
 };
+/** Planner estimate result for withdraw. */
 type PlannerEstimateWithdrawResult = {
     action: 'withdraw';
     chainId: number;
@@ -894,7 +1017,9 @@ type PlannerEstimateWithdrawResult = {
         requiresSingleInput: true;
     };
 };
+/** Planner estimate union. */
 type PlannerEstimateResult = PlannerEstimateTransferResult | PlannerEstimateWithdrawResult;
+/** Summary of fees and inputs used by planner. */
 type PlannerFeeSummary = {
     mergeCount: number;
     feeCount: number;
@@ -905,6 +1030,7 @@ type PlannerFeeSummary = {
     cost: bigint;
     inputCount: number;
 };
+/** Planner max estimate result for transfer/withdraw. */
 type PlannerMaxEstimateResult = {
     action: 'transfer' | 'withdraw';
     chainId: number;
@@ -912,6 +1038,7 @@ type PlannerMaxEstimateResult = {
     ok: boolean;
     maxSummary: PlannerFeeSummary;
 };
+/** Transfer plan with inputs/outputs and proof binding. */
 type TransferPlan = {
     action: 'transfer';
     chainId: number;
@@ -933,6 +1060,7 @@ type TransferPlan = {
     extraData: readonly [Hex, Hex, Hex];
     proofBinding: string;
 };
+/** Transfer-merge plan including merge step. */
 type TransferMergePlan = {
     action: 'transfer-merge';
     chainId: number;
@@ -949,6 +1077,7 @@ type TransferMergePlan = {
     maxSummary: PlannerFeeSummary;
     mergePlan: TransferPlan;
 };
+/** Withdraw plan with input/output and proof binding. */
 type WithdrawPlan = {
     action: 'withdraw';
     chainId: number;
@@ -970,8 +1099,12 @@ type WithdrawPlan = {
     proofBinding: string;
     recipient: Hex;
 };
+/** Planner plan union. */
 type PlannerPlanResult = TransferPlan | TransferMergePlan | WithdrawPlan;
+/** Coin selection, fee estimation, and transaction planning. */
+/** Planner API for fee estimation and plan creation. */
 interface PlannerApi {
+    /** Estimate fees and check if balance is sufficient for an operation. */
     estimate(input: {
         chainId: number;
         assetId: string;
@@ -979,26 +1112,32 @@ interface PlannerApi {
         amount: bigint;
         payIncludesFee?: boolean;
     }): Promise<PlannerEstimateResult>;
+    /** Calculate the maximum transferable/withdrawable amount after fees. */
     estimateMax(input: {
         chainId: number;
         assetId: string;
         action: 'transfer' | 'withdraw';
         payIncludesFee?: boolean;
     }): Promise<PlannerMaxEstimateResult>;
+    /** Build a full transaction plan (coin selection, outputs, proof binding). */
     plan(input: Record<string, unknown>): Promise<PlannerPlanResult>;
 }
+/** zk-SNARK proof generation via Go WASM (Groth16). Requires `core.ready()`. */
+/** ZKP API for witness/proof generation. */
 interface ZkpApi {
     createWitnessTransfer: (input: TransferWitnessInput, context?: WitnessContext) => Promise<WitnessBuildResult>;
     createWitnessWithdraw: (input: WithdrawWitnessInput, context?: WitnessContext) => Promise<WitnessBuildResult>;
     proveTransfer: (witness: TransferWitnessInput | string, context?: WitnessContext) => Promise<ProofResult>;
     proveWithdraw: (witness: WithdrawWitnessInput | string, context?: WitnessContext) => Promise<ProofResult>;
 }
+/** Relayer request payload built from proofs. */
 interface RelayerRequest {
     kind: 'relayer';
     method: 'POST';
     path: string;
     body: Record<string, unknown>;
 }
+/** Tx builder API for relayer request construction. */
 interface TxBuilderApi {
     buildTransferCalldata: (input: {
         chainId: number;
@@ -1009,7 +1148,10 @@ interface TxBuilderApi {
         proof: ProofResult;
     }) => Promise<RelayerRequest>;
 }
+/** End-to-end operation orchestration: plan → Merkle proof → witness → zk-SNARK proof → relayer request. */
+/** Ops API for end-to-end operations (plan → proof → relayer). */
 interface OpsApi {
+    /** Prepare a private transfer (auto-merges UTXOs if needed when `autoMerge: true`). */
     prepareTransfer(input: {
         chainId: number;
         assetId: string;
@@ -1053,6 +1195,7 @@ interface OpsApi {
             autoMerge?: boolean;
         };
     }>;
+    /** Prepare a withdrawal to an EVM address. Optionally includes gas drop. */
     prepareWithdraw(input: {
         chainId: number;
         assetId: string;
@@ -1073,6 +1216,7 @@ interface OpsApi {
             relayer: Address;
         };
     }>;
+    /** Prepare a deposit: compute commitment, memo, and build contract call requests. */
     prepareDeposit(input: {
         chainId: number;
         assetId: string;
@@ -1108,6 +1252,7 @@ interface OpsApi {
             value: bigint;
         };
     }>;
+    /** Execute deposit on-chain: optionally auto-approve ERC-20 then call deposit(). */
     submitDeposit(input: {
         prepared: Awaited<ReturnType<OpsApi['prepareDeposit']>>;
         walletClient: {
@@ -1147,6 +1292,7 @@ interface OpsApi {
         confirmations?: number;
         operationId?: string;
     }): Promise<TransactionReceipt>;
+    /** Submit prepared transfer/withdraw to relayer and optionally wait for tx confirmation. */
     submitRelayerRequest<T = unknown>(input: {
         prepared: {
             plan: TransferPlan | WithdrawPlan;
@@ -1171,51 +1317,110 @@ interface OpsApi {
         transactionReceipt?: Promise<TransactionReceipt>;
     }>;
 }
+/**
+ * The SDK instance returned by `createSdk(config)`.
+ *
+ * Lifecycle: `core.ready()` → `wallet.open()` → `sync.syncOnce()` → operations → `wallet.close()`
+ */
+/** SDK instance returned by createSdk(config). */
 interface OCashSdk {
+    /** WASM & circuit initialization. */
     core: CoreApi;
+    /** Poseidon2 commitments, nullifiers, memo encryption. */
     crypto: CryptoApi;
+    /** BabyJubjub key derivation and address conversion. */
     keys: KeysApi;
+    /** Chain, token, and relayer configuration. */
     assets: AssetsApi;
+    /** Persistence adapter access. */
     storage: StorageApi;
+    /** Memo/nullifier/Merkle sync from Entry service. */
     sync: SyncApi;
+    /** Merkle proofs and membership witnesses. */
     merkle: MerkleApi;
+    /** Wallet session, UTXO queries, balance. */
     wallet: WalletApi;
+    /** Coin selection, fee estimation, transaction planning. */
     planner: PlannerApi;
+    /** zk-SNARK proof generation (Groth16 via Go WASM). */
     zkp: ZkpApi;
+    /** Relayer request payload builder. */
     tx: TxBuilderApi;
+    /** End-to-end operation orchestration. */
     ops: OpsApi;
 }
+/** User public key. */
 interface UserPublicKey {
     user_pk: {
         user_address: [bigint, bigint];
     };
 }
+/** User secret key (includes public key). */
 interface UserSecretKey extends UserPublicKey {
     user_sk: {
         address_sk: bigint;
     };
 }
+/** User key pair alias (secret + public). */
 interface UserKeyPair extends UserSecretKey {
 }
 
-declare const defaultAssetsOverride: AssetsOverride;
+/**
+ * Default asset overrides for testnet environments.
+ * Assets can be sharded across multiple URLs for large files.
+ */
+declare const defaultAssetsOverrideTestnet: AssetsOverride;
+/**
+ * Default asset overrides for mainnet environments.
+ * Assets can be sharded across multiple URLs for large files.
+ */
+declare const defaultAssetsOverrideMainnet: AssetsOverride;
 
+/**
+ * Memo helpers for encrypting/decrypting record openings.
+ */
 declare class MemoKit {
+    /**
+     * Encrypt a record opening into a memo payload.
+     * Payload = ephemeral PK (32 bytes) + NaCl secretbox ciphertext.
+     */
     static createMemo(ro: CommitmentData): `0x${string}`;
+    /**
+     * Decrypt a memo with the owner's secret key.
+     * Returns null if decryption fails or payload is invalid.
+     */
     static decryptMemo(secretKey: bigint, encoded: `0x${string}`): CommitmentData | null;
+    /**
+     * Decode memo for owner with transparent fallback.
+     * If isTransparent=true, treat memo as plaintext record opening.
+     */
     static decodeMemoForOwner(input: {
         secretKey: bigint;
         memo: Hex;
         expectedAddress?: Hex | null;
         isTransparent?: boolean;
     }): CommitmentData | null;
+    /**
+     * Expose memo nonce derivation for advanced usage/tests.
+     */
     static memoNonce(ephemeralPublicKey: [bigint, bigint], userPublicKey: [bigint, bigint]): Uint8Array;
 }
 
+/**
+ * Cryptographic helpers for commitments, nullifiers, and record openings.
+ */
 declare class CryptoToolkit {
     static commitment(record: CommitmentData, format: 'hex'): Hex;
     static commitment(record: CommitmentData, format: 'bigint'): bigint;
+    /**
+     * Compute nullifier for a commitment using secret key and optional freezer PK.
+     * If freezer PK is default (0,1), the secret key is used directly.
+     */
     static nullifier(secretKey: bigint, commitment: `0x${string}`, freezerPk?: [bigint, bigint]): `0x${string}`;
+    /**
+     * Create a record opening with normalized fields and a random blinding factor.
+     * Ensures non-zero commitment when auto-generating the blinding factor.
+     */
     static createRecordOpening(input: {
         asset_id: bigint | number | string;
         asset_amount: bigint | number | string;
@@ -1225,53 +1430,134 @@ declare class CryptoToolkit {
         blinding_factor?: bigint | number | string;
         is_frozen?: boolean;
     }): CommitmentData;
+    /**
+     * Generate randomness for memo encryption (BabyJubjub scalar).
+     */
     static viewingRandomness(): Uint8Array;
+    /**
+     * Compute pool id from token address and policy keys.
+     */
     static poolId(tokenAddress: Hex | bigint | number | string, viewerPk: [bigint, bigint], freezerPk: [bigint, bigint]): bigint;
 }
 
+/**
+ * Key derivation and address conversion utilities.
+ */
 declare class KeyManager {
+    /**
+     * Derive a full keypair from seed and optional nonce.
+     */
     static deriveKeyPair(seed: string, nonce?: string): UserKeyPair;
+    /**
+     * Derive public key only from seed (no secret exposure).
+     */
     static getPublicKeyBySeed(seed: string, nonce?: string): UserPublicKey;
+    /**
+     * Derive secret key object from seed (includes public key).
+     */
     static getSecretKeyBySeed(seed: string, nonce?: string): UserSecretKey;
+    /**
+     * Compress BabyJubjub public key into an OCash viewing address.
+     */
     static userPkToAddress(userPk: {
         user_address: [bigint | string, bigint | string];
     }): Hex;
+    /**
+     * Decompress an OCash viewing address back to BabyJubjub public key.
+     */
     static addressToUserPk(address: Hex): {
         user_address: [bigint, bigint];
     };
 }
 
+/**
+ * In-memory ledger registry for chain, token, and relayer configuration.
+ * Acts as the canonical config source for assets APIs.
+ */
 declare class LedgerInfo {
     private readonly chains;
     private readonly relayerManager;
+    /**
+     * Initialize with optional chain configs and prepare relayer manager.
+     */
     constructor(initialChains?: ChainConfigInput[]);
+    /**
+     * Validate and upsert a chain config. Tokens are cloned defensively.
+     */
     private upsertChain;
+    /**
+     * Return all registered chains (deep-cloned token arrays).
+     */
     getChains(): ChainConfigInput[];
+    /**
+     * Lookup a chain by id. Throws if not registered.
+     */
     getChain(chainId: number): ChainConfigInput;
+    /**
+     * Get token list for a chain (cloned).
+     */
     getTokens(chainId: number): TokenMetadata[];
+    /**
+     * Get token metadata for a specific pool id on a chain.
+     */
     getPoolInfo(chainId: number, tokenId: string): TokenMetadata | undefined;
+    /**
+     * Resolve the allowance target address for ERC20 approvals.
+     * Uses ocashContractAddress, falling back to legacy contract field.
+     */
     getAllowanceTarget(chainId: number): Address;
+    /**
+     * Append/merge tokens into an existing chain.
+     * Token ids are treated as unique keys and overwrite duplicates.
+     */
     appendTokens(chainId: number, tokens: TokenMetadata[]): void;
+    /**
+     * Load ledger config from a remote JSON file and refresh relayer configs.
+     */
     loadFromUrl(url: string): Promise<void>;
+    /**
+     * Return cached relayer config (if present and fresh).
+     */
     getRelayerConfig(chainId: number): RelayerConfig | undefined;
+    /**
+     * Fetch and cache relayer config for a single chain.
+     */
     syncRelayerConfig(chainId: number): Promise<RelayerConfig>;
+    /**
+     * Fetch and cache relayer configs for all chains.
+     */
     syncAllRelayerConfigs(): Promise<void>;
 }
 
+type TokenMetadataInput = Omit<TokenMetadata, 'viewerPk' | 'freezerPk' | 'depositFeeBps' | 'withdrawFeeBps'> & {
+    viewerPk: readonly [string, string] | readonly [bigint, bigint];
+    freezerPk: readonly [string, string] | readonly [bigint, bigint];
+    depositFeeBps?: number | bigint;
+    withdrawFeeBps?: number | bigint;
+};
 /**
- * Normalize token metadata from app-style or sdk-style shapes.
- *
- * Supported legacy fields (app):
- * - `wrapped_erc20` (instead of `wrappedErc20`)
- * - `viewerPK` / `freezerPK` (instead of `viewerPk` / `freezerPk`)
- * - `depositFeeBPS` / `withdrawFeeBPS` (instead of `depositFeeBps` / `withdrawFeeBps`)
+ * Normalize arbitrary token metadata inputs into strict TokenMetadata.
+ * Ensures valid addresses, PK shapes, and fee/limit fields.
  */
-declare const normalizeTokenMetadata: (input: unknown) => TokenMetadata;
+declare const normalizeTokenMetadata: (input: TokenMetadataInput) => TokenMetadata;
 
+/**
+ * Validate token metadata input at runtime. Throws SdkError on mismatch.
+ */
 declare function assertTokenMetadata(value: unknown, name?: string): asserts value is TokenMetadata;
+/**
+ * Validate a list of tokens.
+ */
 declare function assertTokenList(value: unknown, name?: string): asserts value is TokenMetadata[];
+/**
+ * Validate a chain config input at runtime. Throws SdkError on mismatch.
+ */
 declare function assertChainConfigInput(value: unknown, name?: string): asserts value is ChainConfigInput;
 
+/**
+ * Read pool metadata from the OCash contract and return normalized TokenMetadata[].
+ * Optionally includes ERC20 symbol/decimals via a second multicall.
+ */
 declare function fetchPoolTokensFromContract(input: {
     publicClient: PublicClient;
     chainId: number;
@@ -1280,13 +1566,25 @@ declare function fetchPoolTokensFromContract(input: {
     includeErc20Metadata?: boolean;
 }): Promise<TokenMetadata[]>;
 
+/**
+ * Wrapper around ProofBridge dummy helpers.
+ */
 declare class DummyFactory {
     private readonly bridge;
     constructor(bridge: ProofBridge);
+    /**
+     * Create a dummy record opening via the WASM bridge.
+     */
     createRecordOpening(): Promise<CommitmentData>;
+    /**
+     * Create a dummy input secret via the WASM bridge.
+     */
     createInputSecret(): Promise<InputSecret>;
 }
 
+/**
+ * Convenience namespace for commonly used utils.
+ */
 declare const Utils: {
     calcDepositFee: (amount: bigint, feeBps?: number) => bigint;
     randomBytes32: () => Uint8Array<ArrayBufferLike>;
@@ -1296,10 +1594,16 @@ declare const Utils: {
 
 declare const BABYJUBJUB_SCALAR_FIELD = 21888242871839275222246405745257275088548364400416034343698204186575808495617n;
 
+/**
+ * Compute the proof binding for transfer proofs (relayer + extra data).
+ */
 declare function calcTransferProofBinding(input: {
     relayer: string;
     extraData: TransferExtraData;
 }): bigint;
+/**
+ * Compute the proof binding for withdraw proofs (relayer + recipient + fees).
+ */
 declare function calcWithdrawProofBinding(input: {
     recipient: string;
     amount: bigint;
@@ -1309,22 +1613,32 @@ declare function calcWithdrawProofBinding(input: {
     extraData: Hex;
 }): bigint;
 
+/**
+ * OCash contract ABI (functions/events/errors) used by the SDK.
+ * This is a trimmed Foundry ABI without internalType/constructor/receive.
+ */
 declare const App_ABI: readonly [{
     readonly type: "function";
-    readonly name: "depositRelayerFee";
+    readonly name: "DomainArray";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "uint128";
+        readonly type: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "poolIds";
-    readonly inputs: readonly [{
+    readonly name: "DomainMerkle";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
         readonly name: "";
         readonly type: "uint256";
     }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "DomainNullifier";
+    readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "uint256";
@@ -1332,178 +1646,1150 @@ declare const App_ABI: readonly [{
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "getPoolInfo";
-    readonly inputs: readonly [{
-        readonly name: "poolId";
+    readonly name: "DomainPolicy";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
         readonly type: "uint256";
     }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "DomainRecord";
+    readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "tuple";
-        readonly components: readonly [{
-            readonly name: "token";
-            readonly type: "address";
-        }, {
-            readonly name: "depositFeeBPS";
-            readonly type: "uint16";
-        }, {
-            readonly name: "withdrawFeeBPS";
-            readonly type: "uint16";
-        }, {
-            readonly name: "accumulatedFee";
-            readonly type: "uint128";
-        }, {
-            readonly name: "viewerPK";
-            readonly type: "uint256[2]";
-        }, {
-            readonly name: "freezerPK";
-            readonly type: "uint256[2]";
-        }, {
-            readonly name: "transferMaxAmount";
-            readonly type: "uint128";
-        }, {
-            readonly name: "withdrawMaxAmount";
-            readonly type: "uint128";
-        }];
+        readonly type: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "deposit";
-    readonly inputs: readonly [{
-        readonly name: "poolId";
-        readonly type: "uint256";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint128";
-    }, {
-        readonly name: "userPK";
-        readonly type: "uint256[2]";
-    }, {
-        readonly name: "nonce";
-        readonly type: "uint256";
-    }, {
+    readonly name: "FREEZE_VERIFIER";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "bytes";
+        readonly type: "address";
     }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "payable";
+    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "getArray";
+    readonly name: "NATIVE_TOKEN_ADDRESS";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "uint256[]";
+        readonly type: "address";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "digest";
+    readonly name: "POSEIDON2";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
-        readonly name: "merkleTreeRoot";
-        readonly type: "uint256";
-    }, {
-        readonly name: "currentArrayHash";
-        readonly type: "uint256";
+        readonly name: "";
+        readonly type: "address";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "totalElements";
+    readonly name: "TRANSFER_VERIFIER";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "uint256";
+        readonly type: "address";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "merkleRoots";
+    readonly name: "WITHDRAW_VERIFIER";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "accumulatedRelayerFees";
     readonly inputs: readonly [{
         readonly name: "";
-        readonly type: "uint256";
+        readonly type: "address";
+    }, {
+        readonly name: "";
+        readonly type: "address";
     }];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "uint256";
+        readonly type: "uint128";
     }];
     readonly stateMutability: "view";
 }, {
-    readonly type: "event";
-    readonly name: "ArrayMergedToTree";
+    readonly type: "function";
+    readonly name: "array";
     readonly inputs: readonly [{
-        readonly name: "batchIndex";
-        readonly type: "uint256";
-        readonly indexed: true;
-    }, {
-        readonly name: "newRoot";
+        readonly name: "";
         readonly type: "uint256";
-        readonly indexed: true;
     }];
-    readonly anonymous: false;
-}];
-
-declare const ERC20_ABI: readonly [{
-    readonly type: "function";
-    readonly name: "name";
-    readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "string";
+        readonly type: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "symbol";
-    readonly inputs: readonly [];
+    readonly name: "arrayHashes";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "string";
+        readonly type: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "decimals";
+    readonly name: "arraySize";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
         readonly name: "";
-        readonly type: "uint8";
+        readonly type: "uint256";
     }];
     readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "allowance";
+    readonly name: "claimProtocolFees";
     readonly inputs: readonly [{
-        readonly name: "owner";
-        readonly type: "address";
-    }, {
-        readonly name: "spender";
-        readonly type: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
+        readonly name: "poolId";
         readonly type: "uint256";
     }];
-    readonly stateMutability: "view";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "approve";
+    readonly name: "claimRelayerFees";
     readonly inputs: readonly [{
-        readonly name: "spender";
+        readonly name: "token";
         readonly type: "address";
-    }, {
-        readonly name: "amount";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "commitments";
+    readonly inputs: readonly [{
+        readonly name: "";
         readonly type: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "";
         readonly type: "bool";
     }];
-    readonly stateMutability: "nonpayable";
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "deposit";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint128";
+    }, {
+        readonly name: "userPK";
+        readonly type: "uint256[2]";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "depositRelayerFee";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint128";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "digest";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "merkleTreeRoot";
+        readonly type: "uint256";
+    }, {
+        readonly name: "currentArrayHash";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "freeze";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "merkleRootIndex";
+        readonly type: "uint256";
+    }, {
+        readonly name: "arrayHashIndex";
+        readonly type: "uint256";
+    }, {
+        readonly name: "inputNullifiers";
+        readonly type: "uint256[3]";
+    }, {
+        readonly name: "outputs";
+        readonly type: "uint256[3]";
+    }, {
+        readonly name: "proof";
+        readonly type: "uint256[8]";
+    }, {
+        readonly name: "viewerData";
+        readonly type: "uint256[17]";
+    }, {
+        readonly name: "extraData";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "frontier";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getArray";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getLastArrayHash";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getLastRoot";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getPendingDepositsCount";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getPoolInfo";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+        }, {
+            readonly name: "depositFeeBPS";
+            readonly type: "uint16";
+        }, {
+            readonly name: "withdrawFeeBPS";
+            readonly type: "uint16";
+        }, {
+            readonly name: "accumulatedFee";
+            readonly type: "uint128";
+        }, {
+            readonly name: "viewerPK";
+            readonly type: "uint256[2]";
+        }, {
+            readonly name: "freezerPK";
+            readonly type: "uint256[2]";
+        }, {
+            readonly name: "transferMaxAmount";
+            readonly type: "uint128";
+        }, {
+            readonly name: "withdrawMaxAmount";
+            readonly type: "uint128";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "initialize";
+    readonly inputs: readonly [{
+        readonly name: "_depositRelayerFee";
+        readonly type: "uint128";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "merkleRoots";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "nullifiers";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pendingDepositsProcessed";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pendingDepositsQueue";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "leaf";
+        readonly type: "uint256";
+    }, {
+        readonly name: "relayerFee";
+        readonly type: "uint128";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "poolIds";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pools";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "depositFeeBPS";
+        readonly type: "uint16";
+    }, {
+        readonly name: "withdrawFeeBPS";
+        readonly type: "uint16";
+    }, {
+        readonly name: "accumulatedFee";
+        readonly type: "uint128";
+    }, {
+        readonly name: "transferMaxAmount";
+        readonly type: "uint128";
+    }, {
+        readonly name: "withdrawMaxAmount";
+        readonly type: "uint128";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "processPendingDeposits";
+    readonly inputs: readonly [{
+        readonly name: "maxBatchSize";
+        readonly type: "uint256";
+    }, {
+        readonly name: "relayer";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "registerPool";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "depositFeeBPS";
+        readonly type: "uint16";
+    }, {
+        readonly name: "withdrawFeeBPS";
+        readonly type: "uint16";
+    }, {
+        readonly name: "transferMaxAmount";
+        readonly type: "uint128";
+    }, {
+        readonly name: "withdrawMaxAmount";
+        readonly type: "uint128";
+    }, {
+        readonly name: "viewerPK";
+        readonly type: "uint256[2]";
+    }, {
+        readonly name: "freezerPK";
+        readonly type: "uint256[2]";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "registerUser";
+    readonly inputs: readonly [{
+        readonly name: "userKey";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setDepositRelayerFee";
+    readonly inputs: readonly [{
+        readonly name: "_depositRelayerFee";
+        readonly type: "uint128";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setPoolFees";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "depositFeeBPS";
+        readonly type: "uint16";
+    }, {
+        readonly name: "withdrawFeeBPS";
+        readonly type: "uint16";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setPoolLimits";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "transferMaxAmount";
+        readonly type: "uint128";
+    }, {
+        readonly name: "withdrawMaxAmount";
+        readonly type: "uint128";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "totalElements";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalElementsInTree";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalPools";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "merkleRootIndex";
+        readonly type: "uint256";
+    }, {
+        readonly name: "arrayHashIndex";
+        readonly type: "uint256";
+    }, {
+        readonly name: "inputNullifiers";
+        readonly type: "uint256[3]";
+    }, {
+        readonly name: "outputs";
+        readonly type: "uint256[3]";
+    }, {
+        readonly name: "proof";
+        readonly type: "uint256[8]";
+    }, {
+        readonly name: "viewerData";
+        readonly type: "uint256[17]";
+    }, {
+        readonly name: "extraData";
+        readonly type: "bytes";
+    }, {
+        readonly name: "relayer";
+        readonly type: "address";
+    }, {
+        readonly name: "relayerFee";
+        readonly type: "uint128";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferOwnership";
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "userKeys";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "withdraw";
+    readonly inputs: readonly [{
+        readonly name: "inp";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "poolId";
+            readonly type: "uint256";
+        }, {
+            readonly name: "merkleRootIndex";
+            readonly type: "uint256";
+        }, {
+            readonly name: "arrayHashIndex";
+            readonly type: "uint256";
+        }, {
+            readonly name: "inputNullifier";
+            readonly type: "uint256";
+        }, {
+            readonly name: "output";
+            readonly type: "uint256";
+        }, {
+            readonly name: "recipient";
+            readonly type: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint128";
+        }, {
+            readonly name: "proof";
+            readonly type: "uint256[8]";
+        }, {
+            readonly name: "viewerData";
+            readonly type: "uint256[7]";
+        }, {
+            readonly name: "extraData";
+            readonly type: "bytes";
+        }, {
+            readonly name: "relayer";
+            readonly type: "address";
+        }, {
+            readonly name: "relayerFee";
+            readonly type: "uint128";
+        }, {
+            readonly name: "gasDropValue";
+            readonly type: "uint128";
+        }];
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "event";
+    readonly name: "ArrayMergedToTree";
+    readonly inputs: readonly [{
+        readonly name: "batchIndex";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "newRoot";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Deposit";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }, {
+        readonly name: "fee";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }, {
+        readonly name: "userPK";
+        readonly type: "uint256[2]";
+        readonly indexed: false;
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "relayerFee";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "DepositQueued";
+    readonly inputs: readonly [{
+        readonly name: "queueIndex";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "leaf";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "relayerFee";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "DepositRelayerFeeUpdated";
+    readonly inputs: readonly [{
+        readonly name: "depositRelayerFee";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "DepositsProcessed";
+    readonly inputs: readonly [{
+        readonly name: "fromIndex";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "toIndex";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "ElementInserted";
+    readonly inputs: readonly [{
+        readonly name: "element";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "globalIndex";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Freeze";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "merkleRoot";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "arrayHash";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "inputs";
+        readonly type: "uint256[3]";
+        readonly indexed: false;
+    }, {
+        readonly name: "outputs";
+        readonly type: "uint256[3]";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Initialized";
+    readonly inputs: readonly [{
+        readonly name: "version";
+        readonly type: "uint64";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PoolFeesUpdated";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "depositFeeBPS";
+        readonly type: "uint16";
+        readonly indexed: false;
+    }, {
+        readonly name: "withdrawFeeBPS";
+        readonly type: "uint16";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PoolLimitsUpdated";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "transferMaxAmount";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }, {
+        readonly name: "withdrawMaxAmount";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PoolRegistered";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "viewerPK";
+        readonly type: "uint256[2]";
+        readonly indexed: false;
+    }, {
+        readonly name: "freezerPK";
+        readonly type: "uint256[2]";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "ProtocolFeesClaimed";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "recipient";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "RelayerFeesClaimed";
+    readonly inputs: readonly [{
+        readonly name: "relayer";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Transfer";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "merkleRoot";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "arrayHash";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "inputs";
+        readonly type: "uint256[3]";
+        readonly indexed: false;
+    }, {
+        readonly name: "outputs";
+        readonly type: "uint256[3]";
+        readonly indexed: false;
+    }, {
+        readonly name: "relayer";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "relayerFee";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "UserRegistered";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "userKey";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Withdraw";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "merkleRoot";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "arrayHash";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "input";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "output";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "recipient";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }, {
+        readonly name: "protocolFee";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }, {
+        readonly name: "relayer";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "relayerFee";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }, {
+        readonly name: "gasDropValue";
+        readonly type: "uint128";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "AddressIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "DataNotInField";
+    readonly inputs: readonly [{
+        readonly name: "data";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "DuplicateCommitment";
+    readonly inputs: readonly [{
+        readonly name: "commitment";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ExceedsWithdrawLimit";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint128";
+    }, {
+        readonly name: "maxAmount";
+        readonly type: "uint128";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "FailedCall";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "FeeBPSOutOfBounds";
+    readonly inputs: readonly [{
+        readonly name: "feeBPS";
+        readonly type: "uint16";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientBalance";
+    readonly inputs: readonly [{
+        readonly name: "balance";
+        readonly type: "uint256";
+    }, {
+        readonly name: "needed";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidArrayHashIndex";
+    readonly inputs: readonly [{
+        readonly name: "provided";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidBatchSize";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidETHAmount";
+    readonly inputs: readonly [{
+        readonly name: "expected";
+        readonly type: "uint128";
+    }, {
+        readonly name: "actual";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidGasDropValue";
+    readonly inputs: readonly [{
+        readonly name: "provided";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidInitialization";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidMerkleRootIndex";
+    readonly inputs: readonly [{
+        readonly name: "provided";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidPoolId";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidRelayerFee";
+    readonly inputs: readonly [{
+        readonly name: "provided";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "NoElementsInArray";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NoPendingDeposits";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotInitializing";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NullifierAlreadyPublished";
+    readonly inputs: readonly [{
+        readonly name: "nullifier";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "NullifierIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OutputIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OwnableInvalidOwner";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "OwnableUnauthorizedAccount";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "PoolAlreadyExists";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ReentrancyGuardReentrantCall";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "RelayerAddressIsZero";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SafeERC20FailedOperation";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "TreeIsFull";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "Unauthorized";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "caller";
+        readonly type: "address";
+    }];
 }];
 
+/**
+ * In-memory StorageAdapter implementation.
+ * Useful for ephemeral sessions or tests (non-persistent).
+ */
 declare class MemoryStore implements StorageAdapter {
     private walletId;
     private readonly cursors;
@@ -1515,106 +2801,274 @@ declare class MemoryStore implements StorageAdapter {
     private readonly entryMemosByChain;
     private readonly entryNullifiersByChain;
     private readonly maxOperations;
+    /**
+     * Create a MemoryStore with an optional maxOperations limit.
+     */
     constructor(options?: {
         maxOperations?: number;
     });
+    /**
+     * Initialize store; clears in-memory state when walletId changes.
+     */
     init(options?: {
         walletId?: string;
     }): void;
+    /**
+     * Close store (no-op for in-memory).
+     */
     close(): void;
+    /**
+     * Enforce maxOperations limit and return number removed.
+     */
     private enforceMaxOperations;
+    /**
+     * Get persisted sync cursor for a chain.
+     */
     getSyncCursor(chainId: number): Promise<SyncCursor | undefined>;
+    /**
+     * Set persisted sync cursor for a chain.
+     */
     setSyncCursor(chainId: number, cursor: SyncCursor): Promise<void>;
+    /**
+     * Upsert UTXOs; preserves spent flag on existing records.
+     */
     upsertUtxos(utxos: UtxoRecord[]): Promise<void>;
+    /**
+     * List UTXOs with query filtering and pagination.
+     */
     listUtxos(query?: ListUtxosQuery): Promise<{
         total: number;
         rows: UtxoRecord[];
     }>;
+    /**
+     * Mark matching UTXOs as spent by nullifier.
+     */
     markSpent(input: {
         chainId: number;
         nullifiers: Hex[];
     }): Promise<number>;
+    /**
+     * Get persisted merkle leaves for a chain.
+     */
     getMerkleLeaves(chainId: number): Promise<Array<{
         cid: number;
         commitment: Hex;
     }> | undefined>;
+    /**
+     * Append contiguous merkle leaves.
+     */
     appendMerkleLeaves(chainId: number, leaves: Array<{
         cid: number;
         commitment: Hex;
     }>): Promise<void>;
+    /**
+     * Clear merkle leaf cache for a chain.
+     */
     clearMerkleLeaves(chainId: number): Promise<void>;
+    /**
+     * Get a single merkle leaf by cid.
+     */
     getMerkleLeaf(chainId: number, cid: number): Promise<MerkleLeafRecord | undefined>;
+    /**
+     * Get a merkle node by id.
+     */
     getMerkleNode(chainId: number, id: string): Promise<MerkleNodeRecord | undefined>;
+    /**
+     * Upsert merkle nodes for a chain.
+     */
     upsertMerkleNodes(chainId: number, nodes: MerkleNodeRecord[]): Promise<void>;
+    /**
+     * Clear merkle nodes for a chain.
+     */
     clearMerkleNodes(chainId: number): Promise<void>;
+    /**
+     * Get persisted merkle tree state.
+     */
     getMerkleTree(chainId: number): Promise<MerkleTreeState | undefined>;
+    /**
+     * Persist merkle tree state.
+     */
     setMerkleTree(chainId: number, tree: MerkleTreeState): Promise<void>;
+    /**
+     * Clear merkle tree state.
+     */
     clearMerkleTree(chainId: number): Promise<void>;
-    upsertEntryMemos(memos: EntryMemoRecord[]): Promise<number>;
+    /**
+     * Upsert entry memos (raw EntryService cache).
+     */
+    upsertEntryMemos(memos: EntryMemoRecord[]): Promise<void>;
+    /**
+     * List entry memos with query filtering and pagination.
+     */
     listEntryMemos(query: ListEntryMemosQuery): Promise<{
         total: number;
         rows: EntryMemoRecord[];
     }>;
+    /**
+     * Clear entry memo cache for a chain.
+     */
     clearEntryMemos(chainId: number): Promise<void>;
-    upsertEntryNullifiers(nullifiers: EntryNullifierRecord[]): Promise<number>;
+    /**
+     * Upsert entry nullifiers (raw EntryService cache).
+     */
+    upsertEntryNullifiers(nullifiers: EntryNullifierRecord[]): Promise<void>;
+    /**
+     * List entry nullifiers with query filtering and pagination.
+     */
     listEntryNullifiers(query: ListEntryNullifiersQuery): Promise<{
         total: number;
         rows: EntryNullifierRecord[];
     }>;
+    /**
+     * Clear entry nullifier cache for a chain.
+     */
     clearEntryNullifiers(chainId: number): Promise<void>;
+    /**
+     * Create and persist an operation record.
+     */
     createOperation<TType extends OperationType>(input: Omit<StoredOperation<OperationDetailFor<TType>>, 'id' | 'createdAt' | 'status'> & Partial<Pick<StoredOperation<OperationDetailFor<TType>>, 'createdAt' | 'id' | 'status'>> & {
         type: TType;
     }): StoredOperation<OperationDetailFor<TType>> & {
         type: TType;
     };
+    /**
+     * Update an existing operation record.
+     */
     updateOperation(id: string, patch: Partial<StoredOperation>): void;
+    /**
+     * Delete an operation record by id.
+     */
     deleteOperation(id: string): boolean;
+    /**
+     * Clear all operation records.
+     */
     clearOperations(): void;
+    /**
+     * Prune operations to a maximum count (returns number removed).
+     */
     pruneOperations(options?: {
         max?: number;
     }): number;
+    /**
+     * List operations with filtering/pagination.
+     */
     listOperations(input?: number | ListOperationsQuery): StoredOperation[];
 }
 
+/**
+ * OCash mainnet deployment — ETH (Chain ID 1).
+ * Pools: ETH, USDT, USDC.
+ */
+declare const ETH_MAINNET: ChainConfigInput;
+/**
+ * OCash mainnet deployment — BSC (Chain ID 56).
+ * Pools: BNB, USDT (18 decimals), USDC (18 decimals).
+ */
+declare const BSC_MAINNET: ChainConfigInput;
+/**
+ * OCash mainnet deployment — Base (Chain ID 8453).
+ * Pools: ETH, USDC.
+ */
+declare const BASE_MAINNET: ChainConfigInput;
+/**
+ * OCash testnet deployment — Sepolia (Chain ID 11155111).
+ * Pools: SepoliaETH, tUSDT.
+ */
+declare const SEPOLIA_TESTNET: ChainConfigInput;
+/**
+ * OCash testnet deployment — BSC Testnet (Chain ID 97).
+ * Pools: tBNB, tUSDT.
+ */
+declare const BSC_TESTNET: ChainConfigInput;
+/** OCash dev deployment — ETH (Chain ID 1). Pools: ETH, USDT, USDC. */
+declare const ETH_DEV: ChainConfigInput;
+/** OCash dev deployment — BSC (Chain ID 56). Pools: BNB, USDT, USDC. */
+declare const BSC_DEV: ChainConfigInput;
+/** OCash dev deployment — Base (Chain ID 8453). Pools: ETH, USDC. */
+declare const BASE_DEV: ChainConfigInput;
+/** OCash dev deployment — Sepolia (Chain ID 11155111). Pools: ETH, tUSDT. */
+declare const SEPOLIA_DEV: ChainConfigInput;
+/** OCash dev deployment — BSC Testnet (Chain ID 97). Pools: BNB, tUSDT. */
+declare const BSC_TESTNET_DEV: ChainConfigInput;
+
 type KeyValueStoreOptions = {
     client: KeyValueClient;
     keyPrefix?: string;
     maxOperations?: number;
 };
+/**
+ * Generic key-value backed StorageAdapter for Redis/SQLite/etc.
+ */
 declare class KeyValueStore implements StorageAdapter {
     private readonly options;
     private walletId;
-    private readonly cursors;
-    private readonly utxos;
+    private cursorChains;
+    private utxoRefs;
+    private operationIds;
     private operations;
-    private merkleLeaves;
+    private readonly cursorCache;
+    private readonly utxoCache;
+    private readonly operationCache;
+    private merkleLeafCids;
     private merkleTrees;
-    private merkleNodes;
-    private entryMemos;
-    private entryNullifiers;
+    private merkleNodeIds;
+    private entryMemoCids;
+    private entryNullifierNids;
+    private readonly loadedMerkleLeaves;
+    private readonly loadedMerkleTrees;
+    private readonly loadedMerkleNodes;
+    private readonly loadedEntryMemos;
+    private readonly loadedEntryNullifiers;
     private saveChain;
     private readonly maxOperations;
+    private walletMetaLoaded;
     constructor(options: KeyValueStoreOptions);
     init(options?: {
         walletId?: string;
     }): Promise<void>;
     close(): Promise<void>;
-    private stateKey;
+    private keyPrefix;
+    private walletBaseKey;
+    private walletMetaKey;
+    private walletCursorKey;
+    private walletUtxoKey;
+    private walletOperationKey;
+    private sharedChainKey;
+    private sharedChainMetaKey;
+    private sharedRecordKey;
+    private parseJson;
+    private parseNumberIndex;
+    private parseStringIndex;
+    private toPersistedUtxo;
+    private fromPersistedUtxo;
+    private resetInMemory;
+    private enqueueWrite;
+    private writeJson;
+    private deleteOrReset;
     private load;
-    private save;
+    private ensureWalletMetaLoaded;
+    private normalizeCursor;
+    private readCursor;
+    private readUtxo;
+    private pruneOperationIds;
+    private ensureMerkleLeavesLoaded;
+    private ensureMerkleTreeLoaded;
+    private ensureMerkleNodesLoaded;
+    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>;
-    upsertEntryMemos(memos: EntryMemoRecord[]): Promise<number>;
+    upsertEntryMemos(memos: EntryMemoRecord[]): Promise<void>;
     listEntryMemos(query: ListEntryMemosQuery): Promise<{
         total: number;
         rows: EntryMemoRecord[];
     }>;
     clearEntryMemos(chainId: number): Promise<void>;
-    upsertEntryNullifiers(nullifiers: EntryNullifierRecord[]): Promise<number>;
+    upsertEntryNullifiers(nullifiers: EntryNullifierRecord[]): Promise<void>;
     listEntryNullifiers(query: ListEntryNullifiersQuery): Promise<{
         total: number;
         rows: EntryNullifierRecord[];
@@ -1647,8 +3101,18 @@ declare class KeyValueStore implements StorageAdapter {
     }): Promise<number>;
     createOperation<TType extends OperationType>(input: Omit<StoredOperation<OperationDetailFor<TType>>, 'id' | 'createdAt' | 'status'> & Partial<Pick<StoredOperation<OperationDetailFor<TType>>, 'createdAt' | 'id' | 'status'>> & {
         type: TType;
-    }): StoredOperation<OperationDetailFor<TType>> & {
-        type: TType;
+    }): {
+        id: string;
+        createdAt: number;
+        status: OperationStatus;
+        type: OperationType & TType;
+        chainId?: number | undefined;
+        tokenId?: string | undefined;
+        requestUrl?: string | undefined;
+        relayerTxHash?: `0x${string}` | undefined;
+        txHash?: `0x${string}` | undefined;
+        detail?: OperationDetailFor<TType> | undefined;
+        error?: string | undefined;
     };
     updateOperation(id: string, patch: Partial<StoredOperation>): void;
     deleteOperation(id: string): boolean;
@@ -1658,20 +3122,33 @@ declare class KeyValueStore implements StorageAdapter {
     }): number;
     listOperations(input?: number | ListOperationsQuery): StoredOperation[];
 }
-type RedisStoreOptions = KeyValueStoreOptions;
-declare class RedisStore extends KeyValueStore {
-    constructor(options: RedisStoreOptions);
-}
-type SqliteStoreOptions = KeyValueStoreOptions;
-declare class SqliteStore extends KeyValueStore {
-    constructor(options: SqliteStoreOptions);
-}
 interface KeyValueClient {
     get(key: string): Promise<string | null>;
     set(key: string, value: string): Promise<void>;
     del?(key: string): Promise<void>;
 }
 
+type RedisStoreOptions = KeyValueStoreOptions;
+/**
+ * Redis-backed store with a default key prefix.
+ */
+declare class RedisStore extends KeyValueStore {
+    constructor(options: RedisStoreOptions);
+}
+
+/**
+ * Create an SDK instance with the given configuration.
+ *
+ * @example
+ * ```ts
+ * const sdk = createSdk({ chains: [...], onEvent: (e) => console.log(e) });
+ * await sdk.core.ready();
+ * await sdk.wallet.open({ seed: 'my-secret-seed' });
+ * ```
+ */
+/**
+ * SDK factory. Wires together all modules and returns a stable API surface.
+ */
 declare const createSdk: (config: OCashSdkConfig) => OCashSdk;
 declare const OcashSdk: {
     readonly createSdk: (config: OCashSdkConfig) => OCashSdk;
@@ -1689,4 +3166,4 @@ declare const OcashSdk: {
     readonly MemoryStore: typeof MemoryStore;
 };
 
-export { type TransferWitnessInput as $, App_ABI as A, BABYJUBJUB_SCALAR_FIELD as B, type ChainConfigInput as C, type DepositOperation as D, type EntryMemoRecord as E, type OpsApi as F, type PlannerEstimateWithdrawResult as G, type Hex as H, type ProofResult as I, type RedisStoreOptions as J, KeyManager as K, type ListEntryMemosQuery as L, type MerkleNodeRecord as M, type RelayerRequest as N, type OperationType as O, type PlannerEstimateTransferResult as P, type SdkEvent as Q, RedisStore as R, type StorageAdapter as S, SqliteStore as T, type UtxoRecord as U, type SqliteStoreOptions as V, type SyncChainStatus as W, type TokenMetadata as X, type TransactionReceipt as Y, type TransferOperation as Z, type TransferOperationDetail as _, type MerkleTreeState as a, Utils as a0, type WalletSessionInput as a1, type WithdrawOperation as a2, type WithdrawOperationDetail as a3, type WithdrawWitnessInput as a4, type WitnessBuildResult as a5, type WitnessContext as a6, assertChainConfigInput as a7, assertTokenList as a8, assertTokenMetadata as a9, calcTransferProofBinding as aa, calcWithdrawProofBinding as ab, createSdk as ac, OcashSdk as ad, defaultAssetsOverride as ae, fetchPoolTokensFromContract as af, normalizeTokenMetadata as ag, 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 ListOperationsQuery as h, type AssetOverrideEntry as i, type AssetsOverride as j, type CommitmentData as k, CryptoToolkit as l, type DepositOperationDetail as m, DummyFactory as n, ERC20_ABI as o, type KeyValueClient as p, KeyValueStore as q, type KeyValueStoreOptions as r, LedgerInfo as s, MemoKit as t, MemoryStore as u, type MerkleLeafRecord as v, type OCashSdk as w, type OCashSdkConfig as x, type OperationCreateInput as y, type OperationStatus as z };
+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 };