@unlink-xyz/core 0.1.3 → 0.1.4

package/dist/keys/address.d.ts

@@ -0,0 +1,13 @@
+export type Chain = {
+    type: number;
+    id: number;
+};
+export type AddressData = {
+    masterPublicKey: bigint;
+    viewingPublicKey: Uint8Array;
+    chain?: Chain;
+    version?: number;
+};
+export declare function encodeAddress(data: AddressData): string;
+export declare function decodeAddress(address: string): AddressData;
+//# sourceMappingURL=address.d.ts.map

package/dist/keys/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../keys/address.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,WAAW,GAAG;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAgCF,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAUvD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAqB1D"}

package/dist/keys/derive.d.ts

@@ -0,0 +1,37 @@
+export type SpendingPublicKey = [bigint, bigint];
+export type SpendingKeyPair = {
+    privateKey: Uint8Array;
+    pubkey: SpendingPublicKey;
+};
+export type ViewingKeyPair = {
+    privateKey: Uint8Array;
+    pubkey: Uint8Array;
+};
+export type AccountKeys = {
+    spending: SpendingKeyPair;
+    viewing: ViewingKeyPair;
+    nullifyingKey: bigint;
+    masterPublicKey: bigint;
+};
+/**
+ * Derive spending key pair (BabyJubJub) for an account.
+ */
+export declare function deriveSpendingKeyPair(seed: Uint8Array, index: number): SpendingKeyPair;
+/**
+ * Derive viewing key pair (Ed25519) for an account.
+ */
+export declare function deriveViewingKeyPair(seed: Uint8Array, index: number): ViewingKeyPair;
+/**
+ * Compute nullifying key from viewing private key using Poseidon hash.
+ */
+export declare function computeNullifyingKey(viewingPrivateKey: Uint8Array): bigint;
+/**
+ * Compute master public key from spending public key and nullifying key.
+ * MPK = Poseidon(spendingPubkey[0], spendingPubkey[1], nullifyingKey)
+ */
+export declare function computeMasterPublicKey(spendingPubkey: SpendingPublicKey, nullifyingKey: bigint): bigint;
+/**
+ * Derive all account keys from a seed.
+ */
+export declare function deriveAccountKeys(seed: Uint8Array, index: number): AccountKeys;
+//# sourceMappingURL=derive.d.ts.map

package/dist/keys/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../keys/derive.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE5E,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAwDF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,eAAe,CAKjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,cAAc,CAKhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,iBAAiB,EAAE,UAAU,GAAG,MAAM,CAK1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,iBAAiB,EACjC,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,WAAW,CAUb"}

package/dist/keys/hex.d.ts

@@ -0,0 +1,14 @@
+export declare enum FieldSize {
+    SCALAR = 32
+}
+export type HexInput = string | number | bigint | Uint8Array | ArrayLike<number>;
+export declare class Hex {
+    static strip(value: string): string;
+    static encode(data: HexInput): string;
+    static fromBytes(bytes: Uint8Array): string;
+    static toBytes(hex: string): Uint8Array;
+    static toBigInt(hex: string): bigint;
+    static padToSize(data: HexInput, size: FieldSize): string;
+    static fromBigInt(value: bigint, size: FieldSize, prefix?: boolean): string;
+}
+//# sourceMappingURL=hex.d.ts.map

package/dist/keys/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../keys/hex.ts"],"names":[],"mappings":"AAEA,oBAAY,SAAS;IACnB,MAAM,KAAK;CACZ;AAED,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,MAAM,GACN,MAAM,GACN,UAAU,GACV,SAAS,CAAC,MAAM,CAAC,CAAC;AAItB,qBAAa,GAAG;IACd,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAInC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;IAYrC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAI3C,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAUvC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIpC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM;IAQzD,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAQ,GAAG,MAAM;CAI1E"}

package/dist/keys/index.d.ts

@@ -0,0 +1,5 @@
+export { Mnemonic } from "./mnemonic.js";
+export { deriveAccountKeys, deriveSpendingKeyPair, deriveViewingKeyPair, computeNullifyingKey, computeMasterPublicKey, type AccountKeys, type SpendingKeyPair, type ViewingKeyPair, type SpendingPublicKey, } from "./derive.js";
+export { encodeAddress, decodeAddress, type AddressData, type Chain, } from "./address.js";
+export { Hex, FieldSize, type HexInput } from "./hex.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/keys/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../keys/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,KAAK,GACX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/keys/mnemonic.d.ts

@@ -0,0 +1,6 @@
+export declare class Mnemonic {
+    static validate(mnemonic: string): boolean;
+    static toSeed(mnemonic: string, password?: string): string;
+    static fromEntropy(entropyHex: string): string;
+}
+//# sourceMappingURL=mnemonic.d.ts.map

package/dist/keys/mnemonic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mnemonic.d.ts","sourceRoot":"","sources":["../../keys/mnemonic.ts"],"names":[],"mappings":"AASA,qBAAa,QAAQ;IACnB,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM;IAK9D,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAI/C"}

package/dist/keys.d.ts

@@ -1,7 +1,10 @@
-export declare const RESERVED_PREFIXES: readonly ["meta:", "notes:", "leaves:", "roots:", "nullifiers:", "ciphertexts:", "jobs:", "proof_cache:", "cfg:", "idx:", "locks:"];
+export declare const RESERVED_PREFIXES: readonly ["meta:", "history:", "notes:", "leaves:", "roots:", "nullifiers:", "ciphertexts:", "jobs:", "proof_cache:", "cfg:", "idx:", "locks:"];
 /** Canonical builders for storage key namespaces used across core */
 export declare const keys: {
     note: (c: number, i: number) => string;
+    historyEntry: (id: string) => string;
+    historyPrefix: (chainId: number, mpk: string) => string;
+    historyMeta: (chainId: number, mpk: string) => string;
     leaf: (c: number, i: number) => string;
     ciphertext: (c: number, i: number) => string;
     /** Track note indices that remain unspent for a given master public key (mpk acts as the account identifier). */
@@ -16,6 +19,7 @@ export declare const keys: {
     cursor: (c: number) => string;
     aggregate: (c: number, a: string) => string;
     job: (relayId: string) => string;
+    rescanCursor: (c: number, mpk: string) => string;
 };
 export declare const MAX_KEY_LEN = 512;
 export declare function validateKey(key: string): void;

package/dist/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../keys.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,qIAYpB,CAAC;AAEX,qEAAqE;AACrE,eAAO,MAAM,IAAI;cACL,MAAM,KAAK,MAAM;cACjB,MAAM,KAAK,MAAM;oBACX,MAAM,KAAK,MAAM;IACjC,iHAAiH;iBACpG,MAAM,OAAO,MAAM,KAAK,MAAM;uBAExB,MAAM,OAAO,MAAM;sBACpB,MAAM,KAAK,MAAM;qBAClB,MAAM,KAAK,MAAM;mBACnB,MAAM,KAAK,MAAM;cACtB,MAAM,SAAS,MAAM;oBACf,MAAM;oBACN,MAAM;gBACV,MAAM;mBACH,MAAM,KAAK,MAAM;mBACjB,MAAM;CACtB,CAAC;AAEF,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,QAQtC"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../keys.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,iJAapB,CAAC;AAEX,qEAAqE;AACrE,eAAO,MAAM,IAAI;cACL,MAAM,KAAK,MAAM;uBACR,MAAM;6BACA,MAAM,OAAO,MAAM;2BACrB,MAAM,OAAO,MAAM;cAEhC,MAAM,KAAK,MAAM;oBACX,MAAM,KAAK,MAAM;IACjC,iHAAiH;iBACpG,MAAM,OAAO,MAAM,KAAK,MAAM;uBAExB,MAAM,OAAO,MAAM;sBACpB,MAAM,KAAK,MAAM;qBAClB,MAAM,KAAK,MAAM;mBACnB,MAAM,KAAK,MAAM;cACtB,MAAM,SAAS,MAAM;oBACf,MAAM;oBACN,MAAM;gBACV,MAAM;mBACH,MAAM,KAAK,MAAM;mBACjB,MAAM;sBACH,MAAM,OAAO,MAAM;CACtC,CAAC;AAEF,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,QAQtC"}

package/dist/prover/config.d.ts

@@ -1,37 +1,68 @@
 /**
- * Configuration for the prover system
- * Handles artifact loading from local files or remote artifact server
+ * Configuration for the prover system.
+ * Handles artifact loading from Cloudflare R2 or local files
+ * in Node.js development/test environments.
  */
+export declare const DEFAULT_ARTIFACT_BASE_URL = "https://artifacts.unlink.xyz";
 /**
- * Environment-based configuration for artifact loading
+ * Artifact file types.
  */
-export interface ProverConfig {
-    /** Base URL for the artifact server (browser mode) */
-    rpcUrl: string;
-    /** Whether to enable artifact caching */
-    enableCache: boolean;
+export declare enum ArtifactType {
+    WASM = "joinsplit.wasm",
+    ZKEY = "joinsplit.zkey",
+    VKEY = "joinsplit.vkey.json"
 }
 /**
- * Default configuration
- * Can be overridden via environment variables
+ * Artifact source configuration.
  */
-export declare const DEFAULT_CONFIG: ProverConfig;
+export interface ArtifactSourceConfig {
+    /**
+     * Base URL for artifact hosting.
+     * Defaults to Cloudflare R2 CDN domain.
+     */
+    readonly baseUrl?: string;
+    /**
+     * Artifact version path segment.
+     * Must be a pinned immutable version like `vabc12345` for remote mode.
+     * Optional only when using local-only mode (`preferLocalFiles: true`).
+     */
+    readonly version?: string;
+    /**
+     * Node.js-only override to load local artifacts first.
+     */
+    readonly preferLocalFiles?: boolean;
+}
 /**
- * Artifact file types
+ * Fully-resolved artifact source configuration.
  */
-export declare enum ArtifactType {
-    WASM = "joinsplit.wasm",
-    ZKEY = "joinsplit.zkey",
-    VKEY = "joinsplit.vkey.json"
+export interface ResolvedArtifactSourceConfig {
+    readonly baseUrl: string;
+    readonly version?: string;
+    readonly preferLocalFiles: boolean;
 }
+export interface RemoteArtifactSourceConfig {
+    readonly baseUrl: string;
+    readonly version: string;
+}
+export declare function assertValidArtifactVersion(version: string, label?: string): void;
 /**
- * Build artifact URL for a given circuit and artifact type
- * @param circuitName Full circuit name (e.g., "joinsplit_2x3_16")
- * @param artifactType Type of artifact to fetch
- * @param baseUrl Base URL of the artifact server
- * @returns Full URL to the artifact
+ * Resolve artifact source configuration with defaults.
+ */
+export declare function resolveArtifactSourceConfig(config?: ArtifactSourceConfig): ResolvedArtifactSourceConfig;
+/**
+ * Require a remote-capable source (baseUrl + immutable version).
+ */
+export declare function requireRemoteArtifactSource(source: ResolvedArtifactSourceConfig): RemoteArtifactSourceConfig;
+/**
+ * Build R2 artifact URL for a given circuit and artifact type.
+ * Format: `https://artifacts.unlink.xyz/<version>/<circuit>/<file>`.
+ */
+export declare function buildR2ArtifactUrl(circuitName: string, artifactType: ArtifactType, source: RemoteArtifactSourceConfig): string;
+/**
+ * Build R2 checksums manifest URL for a given circuit.
+ * Format: `https://artifacts.unlink.xyz/<version>/<circuit>/checksums.json`.
  */
-export declare function buildArtifactUrl(circuitName: string, artifactType: ArtifactType, baseUrl?: string): string;
+export declare function buildR2ChecksumsUrl(circuitName: string, source: RemoteArtifactSourceConfig): string;
 /**
  * Get relative path for local artifact loading
  * Used in Node.js environment when artifacts are bundled

package/dist/prover/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../prover/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAM5B,CAAC;AAEF;;GAEG;AACH,oBAAY,YAAY;IACtB,IAAI,mBAAmB;IACvB,IAAI,mBAAmB;IACvB,IAAI,wBAAwB;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,MAA8B,GACtC,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GACzB,MAAM,EAAE,CAQV;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB;;OAEG;iBACU,OAAO;IAIpB;;OAEG;cACO,OAAO;IAQjB;;OAEG;sBACe,MAAM;CAKzB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../prover/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,yBAAyB,iCAAiC,CAAC;AAExE;;GAEG;AACH,oBAAY,YAAY;IACtB,IAAI,mBAAmB;IACvB,IAAI,mBAAmB;IACvB,IAAI,wBAAwB;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,SAA2B,GAC/B,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,oBAAoB,GAC5B,4BAA4B,CA6B9B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,4BAA4B,GACnC,0BAA0B,CAU5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,0BAA0B,GACjC,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,0BAA0B,GACjC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GACzB,MAAM,EAAE,CAQV;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB;;OAEG;iBACU,OAAO;IAIpB;;OAEG;cACO,OAAO;IAQjB;;OAEG;sBACe,MAAM;CAKzB,CAAC"}

package/dist/prover/integrity.d.ts

@@ -0,0 +1,20 @@
+import { ProofError } from "../errors.js";
+import { ArtifactType } from "./config.js";
+export declare class ArtifactIntegrityError extends ProofError {
+    constructor(message: string);
+}
+export declare function isArtifactIntegrityError(error: unknown): error is ArtifactIntegrityError;
+interface ChecksumEntry {
+    readonly sha256: string;
+    readonly size: number;
+}
+export interface ChecksumsManifest {
+    readonly version: string;
+    readonly circuit: string;
+    readonly generated: string;
+    readonly files: Record<string, ChecksumEntry>;
+}
+export declare function parseChecksumsManifest(rawManifest: unknown, expectedCircuitName: string, expectedVersion: string): ChecksumsManifest;
+export declare function verifyArtifactIntegrity(manifest: ChecksumsManifest, circuitName: string, artifactType: ArtifactType, content: Uint8Array): Promise<void>;
+export {};
+//# sourceMappingURL=integrity.d.ts.map

package/dist/prover/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../prover/integrity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,sBAAsB,CAEjC;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC/C;AAiCD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,OAAO,EACpB,mBAAmB,EAAE,MAAM,EAC3B,eAAe,EAAE,MAAM,GACtB,iBAAiB,CAiDnB;AAoBD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/prover/prover.d.ts

@@ -1,4 +1,11 @@
 import { Groth16Proof, PublicSignals } from "snarkjs";
+import { type ArtifactSourceConfig } from "./config.js";
+export interface ProverOptions {
+    /**
+     * Artifact source selection for R2 pathing and local-first mode.
+     */
+    readonly artifactSource?: ArtifactSourceConfig;
+}
 export interface JoinsplitProof {
     readonly proof: Groth16Proof;
     readonly publicSignals: PublicSignals;
@@ -30,30 +37,19 @@ export interface JoinsplitProofInput {
     readonly npkOut: bigint[];
     readonly valueOut: bigint[];
 }
-export declare function proveTransaction(input: JoinsplitProofInput): Promise<JoinsplitProof>;
+export declare function proveTransaction(input: JoinsplitProofInput, options?: ProverOptions): Promise<JoinsplitProof>;
 /**
- * Get verification key for a specific circuit configuration
- * @param inputs Number of inputs (nullifiers)
- * @param outputs Number of outputs (commitments)
- * @returns Verification key for the circuit
+ * Get verification key for a specific circuit configuration.
  */
-export declare function getVerificationKey(inputs: number, outputs: number): Promise<VerificationKey>;
+export declare function getVerificationKey(inputs: number, outputs: number, options?: ProverOptions): Promise<VerificationKey>;
 /**
- * Verify a proof with public signals
- * Auto-detects the circuit from the public signals structure
- * @param proof Groth16 proof
- * @param publicSignals Public signals array
- * @returns True if proof is valid
+ * Verify a proof with public signals.
+ * Auto-detects the circuit from the public signals structure.
  */
-export declare function verifyProof(proof: Groth16Proof, publicSignals: PublicSignals): Promise<boolean>;
+export declare function verifyProof(proof: Groth16Proof, publicSignals: PublicSignals, options?: ProverOptions): Promise<boolean>;
 /**
- * Verify a proof with explicit circuit specification
- * Preferred method when you know the circuit dimensions
- * @param proof Groth16 proof
- * @param publicSignals Public signals array
- * @param inputs Number of inputs (nullifiers)
- * @param outputs Number of outputs (commitments)
- * @returns True if proof is valid
+ * Verify a proof with explicit circuit specification.
+ * Preferred method when you know the circuit dimensions.
  */
-export declare function verifyProofWithCircuit(proof: Groth16Proof, publicSignals: PublicSignals, inputs: number, outputs: number): Promise<boolean>;
+export declare function verifyProofWithCircuit(proof: Groth16Proof, publicSignals: PublicSignals, inputs: number, outputs: number, options?: ProverOptions): Promise<boolean>;
 //# sourceMappingURL=prover.d.ts.map

package/dist/prover/prover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prover.d.ts","sourceRoot":"","sources":["../../prover/prover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA4BtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAiND,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,cAAc,CAAC,CAmCzB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAUlB"}
+{"version":3,"file":"prover.d.ts","sourceRoot":"","sources":["../../prover/prover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAItD,OAAO,EASL,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;AAuBrB,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;CAChD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAgbD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,cAAc,CAAC,CAqCzB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/prover/registry.d.ts

@@ -1,39 +1,12 @@
-/**
- * Circuit registry for automatic prover selection
- * Maps circuit dimensions (inputs x outputs) to circuit configurations
- */
 export interface CircuitConfig {
-    /** Full circuit name (e.g., "joinsplit_2x3_16") */
     readonly name: string;
-    /** Number of inputs (nullifiers) */
     readonly inputs: number;
-    /** Number of outputs (commitments) */
     readonly outputs: number;
-    /** Merkle tree depth */
     readonly depth: number;
 }
-export type CircuitKey = "3x3" | "2x3" | "1x2" | "1x1";
-/**
- * Registry of available circuits
- * Auto-generated from circuits/circuits.json
- */
-export declare const CIRCUIT_REGISTRY: Record<CircuitKey, CircuitConfig>;
-/**
- * Get list of all supported circuit keys
- */
-export declare const SUPPORTED_CIRCUITS: CircuitKey[];
-/**
- * Get circuit configuration by dimensions
- * @param inputs Number of inputs (nullifiers)
- * @param outputs Number of outputs (commitments)
- * @returns Circuit configuration or undefined if not supported
- */
+export declare const CIRCUIT_REGISTRY: Record<string, CircuitConfig>;
+export type CircuitKey = keyof typeof CIRCUIT_REGISTRY & string;
+export declare const SUPPORTED_CIRCUITS: string[];
 export declare function getCircuitConfig(inputs: number, outputs: number): CircuitConfig | undefined;
-/**
- * Check if a circuit configuration is supported
- * @param inputs Number of inputs (nullifiers)
- * @param outputs Number of outputs (commitments)
- * @returns True if supported
- */
 export declare function isCircuitSupported(inputs: number, outputs: number): boolean;
 //# sourceMappingURL=registry.d.ts.map

package/dist/prover/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../prover/registry.ts"],"names":[],"mappings":"AAKA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,aAAa,CAyBrD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAoC,UAAU,EAAE,CAAC;AAEhF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,aAAa,GAAG,SAAS,CAG3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3E"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../prover/registry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAYD,eAAO,MAAM,gBAAgB,EAAe,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE1E,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,gBAAgB,GAAG,MAAM,CAAC;AAEhE,eAAO,MAAM,kBAAkB,UAAgC,CAAC;AAEhE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,aAAa,GAAG,SAAS,CAE3B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3E"}

package/dist/state/merkle/hydrator.d.ts

@@ -1,27 +1,29 @@
-export type LeafLoader = (chainId: number, index: number) => Promise<{
+export type BatchLeafLoader = (chainId: number) => Promise<{
     commitment: string;
-} | null>;
-export declare function rebuildTreeFromStore({ chainId, trees, loadLeaf, }: {
-    chainId: number;
-    trees: {
-        reset(chainId: number): void;
-        addLeaf(chainId: number, value: bigint): {
-            index: number;
-        };
-        getLeafCount?(chainId: number): number;
+    index: number;
+}[]>;
+type TreesInterface = {
+    reset(chainId: number): void;
+    addLeaf(chainId: number, value: bigint): {
+        index: number;
     };
-    loadLeaf: LeafLoader;
+    getLeafCount?(chainId: number): number;
+};
+export declare function rebuildTreeFromStore({ chainId, trees, loadLeaves, }: {
+    chainId: number;
+    trees: TreesInterface;
+    loadLeaves: BatchLeafLoader;
 }): Promise<number>;
 export type HydrateChainParams = {
     chainId: number;
-    trees: {
-        reset(chainId: number): void;
-        addLeaf(chainId: number, value: bigint): {
-            index: number;
-        };
-    };
-    loadLeaf: LeafLoader;
+    trees: TreesInterface;
+    loadLeaves: BatchLeafLoader;
     hydrated: Set<number>;
 };
-export declare function hydrateChain({ chainId, trees, loadLeaf, hydrated, }: HydrateChainParams): Promise<void>;
+/**
+ * Hydrate the in-memory merkle tree for a chain, skipping if already done.
+ * Call `hydrated.delete(chainId)` to invalidate and force a rebuild.
+ */
+export declare function hydrateChain({ chainId, trees, loadLeaves, hydrated, }: HydrateChainParams): Promise<number>;
+export {};
 //# sourceMappingURL=hydrator.d.ts.map

package/dist/state/merkle/hydrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydrator.d.ts","sourceRoot":"","sources":["../../../state/merkle/hydrator.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,KACV,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAE5C,wBAAsB,oBAAoB,CAAC,EACzC,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3D,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;KACxC,CAAC;IACF,QAAQ,EAAE,UAAU,CAAC;CACtB,mBAeA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5D,CAAC;IACF,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAKF,wBAAsB,YAAY,CAAC,EACjC,OAAO,EACP,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,EAAE,kBAAkB,iBAcpB"}
+{"version":3,"file":"hydrator.d.ts","sourceRoot":"","sources":["../../../state/merkle/hydrator.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAAC;AAEtD,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACxC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,OAAO,EACP,KAAK,EACL,UAAU,GACX,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,eAAe,CAAC;CAC7B,mBAaA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,YAAY,CAAC,EACjC,OAAO,EACP,KAAK,EACL,UAAU,EACV,QAAQ,GACT,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAWtC"}

package/dist/state/merkle/index.d.ts

@@ -1,3 +1,3 @@
-export { createLocalMerkleTree, createMerkleTrees, type LocalMerkleTree, type LocalMerkleTrees, type MerkleProof, } from "./merkle-tree.js";
-export { hydrateChain, rebuildTreeFromStore, type HydrateChainParams, } from "./hydrator.js";
+export { createLocalMerkleTree, createMerkleTrees, resolveMerkleTrees, type LocalMerkleTree, type LocalMerkleTrees, type MerkleProof, } from "./merkle-tree.js";
+export { hydrateChain, rebuildTreeFromStore, type BatchLeafLoader, type HydrateChainParams, } from "./hydrator.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/state/merkle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../state/merkle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../state/merkle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}

package/dist/state/merkle/merkle-tree.d.ts

@@ -31,4 +31,12 @@ export type LocalMerkleTrees = {
     reset(chainId: number): void;
 };
 export declare function createMerkleTrees(): LocalMerkleTrees;
+/**
+ * Resolve merkle trees from options or create new instance.
+ * @param opts - Options object that may contain merkle trees
+ * @returns Merkle trees instance
+ */
+export declare function resolveMerkleTrees(opts?: {
+    merkleTrees?: LocalMerkleTrees;
+}): LocalMerkleTrees;
 //# sourceMappingURL=merkle-tree.d.ts.map

package/dist/state/merkle/merkle-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merkle-tree.d.ts","sourceRoot":"","sources":["../../../state/merkle/merkle-tree.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,cAAc,EAGf,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAaF,wBAAgB,qBAAqB;qBAUX,MAAM,KAAG,aAAa;;;qBAsBtB,MAAM;+BAQI,MAAM,KAAG,cAAc;mBAUxC,MAAM;;;EAiBxB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAClD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAC;IAC9C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IACvD,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IAClE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iBAAiB,IAAI,gBAAgB,CAwCpD"}
+{"version":3,"file":"merkle-tree.d.ts","sourceRoot":"","sources":["../../../state/merkle/merkle-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAGf,MAAM,aAAa,CAAC;AAarB,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAaF,wBAAgB,qBAAqB;qBAUX,MAAM,KAAG,aAAa;;;qBAsBtB,MAAM;+BAQI,MAAM,KAAG,cAAc;mBAUxC,MAAM;;;EAiBxB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAClD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAC;IAC9C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IACvD,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IAClE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,iBAAiB,IAAI,gBAAgB,CAwCpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE;IACxC,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,GAAG,gBAAgB,CAEnB"}

package/dist/state/store/ciphertext-store.d.ts

@@ -8,5 +8,16 @@ export declare function createCiphertextStore(storage: Storage): {
      * Retrieve encrypted note payloads; returns null when the ciphertext is missing.
      */
     getCiphertext(chainId: number, index: number): Promise<Uint8Array<ArrayBuffer> | null>;
+    /**
+     * Load all cached ciphertexts for a chain in index order.
+     */
+    listCiphertexts(chainId: number): Promise<{
+        index: number;
+        payload: Uint8Array;
+    }[]>;
+    /**
+     * Remove all cached ciphertexts for a chain.
+     */
+    clearCiphertexts(chainId: number): Promise<void>;
 };
 //# sourceMappingURL=ciphertext-store.d.ts.map

package/dist/state/store/ciphertext-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ciphertext-store.d.ts","sourceRoot":"","sources":["../../../state/store/ciphertext-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO;IAElD;;OAEG;2BAC0B,MAAM,SAAS,MAAM,WAAW,UAAU;IAQvE;;OAEG;2BAC0B,MAAM,SAAS,MAAM;EAOrD"}
+{"version":3,"file":"ciphertext-store.d.ts","sourceRoot":"","sources":["../../../state/store/ciphertext-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO;IAElD;;OAEG;2BAC0B,MAAM,SAAS,MAAM,WAAW,UAAU;IAQvE;;OAEG;2BAC0B,MAAM,SAAS,MAAM;IAOlD;;OAEG;6BAEQ,MAAM,GACd,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAYpD;;OAEG;8BAC6B,MAAM;EASzC"}

package/dist/state/store/history-store.d.ts

@@ -0,0 +1,24 @@
+import type { HistoryEntry } from "../../history/types.js";
+import type { Storage } from "../../types.js";
+type HistoryEntryRecord = HistoryEntry;
+export declare function createHistoryStore(storage: Storage): {
+    putHistoryEntry(entry: HistoryEntryRecord): Promise<void>;
+    hasHistorySnapshot(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<boolean>;
+    listHistoryEntries(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<HistoryEntry[]>;
+    clearHistoryEntries(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<void>;
+    commitHistorySnapshot(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<void>;
+};
+export {};
+//# sourceMappingURL=history-store.d.ts.map

package/dist/state/store/history-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-store.d.ts","sourceRoot":"","sources":["../../../state/store/history-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAQ9C,KAAK,kBAAkB,GAAG,YAAY,CAAC;AAGvC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO;2BASlB,kBAAkB;gCAOb;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;gCAShC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;iCAiB/B;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;mCAS9B;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;EAMxE"}

package/dist/state/store/index.d.ts

@@ -1,10 +1,11 @@
-export { createStateStore } from "./store.js";
+export { createStateStore, type StateStore } from "./store.js";
 export { createLeafStore } from "./leaf-store.js";
 export { createNoteStore } from "./note-store.js";
 export { createNullifierStore } from "./nullifier-store.js";
 export { createRootStore } from "./root-store.js";
 export { createCiphertextStore } from "./ciphertext-store.js";
+export { createHistoryStore } from "./history-store.js";
 export { createJobStore } from "./job-store.js";
-export { DEFAULT_JOB_TIMEOUT_MS, type JobStatus, type PendingJobKind, type PendingJobRecord, type PendingDepositJob, type PendingTransactJob, type PendingTransactContext, type PendingTransactOutput, } from "./jobs.js";
+export { DEFAULT_JOB_TIMEOUT_MS, type JobStatus, type JobKind, type JobRecord, type AdapterRecord, type DepositRecord, type TransferRecord, type WithdrawRecord, type PoolTransactionRecord, type TransactContext, type TransactOutput, } from "./jobs.js";
 export type { LeafRecord, NoteInsert, NoteRecord, NullifierRecord, RootRecord, } from "./records.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/state/store/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../state/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../state/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC"}

package/dist/state/store/job-store.d.ts

@@ -1,12 +1,12 @@
 import type { Storage } from "../../types.js";
-import type { JobStatus, PendingJobKind, PendingJobRecord } from "../store/jobs.js";
+import type { JobKind, JobRecord, JobStatus } from "../store/jobs.js";
 export declare function createJobStore(storage: Storage): {
-    putPendingJob(job: PendingJobRecord): Promise<void>;
-    getPendingJob(relayId: string): Promise<PendingJobRecord | null>;
-    listPendingJobs(filter?: {
-        kind?: PendingJobKind;
+    putJob(job: JobRecord): Promise<void>;
+    getJob(relayId: string): Promise<JobRecord | null>;
+    listJobs(filter?: {
+        kind?: JobKind;
         statuses?: JobStatus[];
-    }): Promise<PendingJobRecord[]>;
-    deletePendingJob(relayId: string): Promise<void>;
+    }): Promise<JobRecord[]>;
+    deleteJob(relayId: string): Promise<void>;
 };
 //# sourceMappingURL=job-store.d.ts.map

package/dist/state/store/job-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-store.d.ts","sourceRoot":"","sources":["../../../state/store/job-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAO9C,OAAO,KAAK,EACV,SAAS,EAET,cAAc,EACd,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AA4G1B,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO;uBAElB,gBAAgB;2BASZ,MAAM;6BAKzB;QACN,IAAI,CAAC,EAAE,cAAc,CAAC;QACtB,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;KACxB;8BAe6B,MAAM;EAIzC"}
+{"version":3,"file":"job-store.d.ts","sourceRoot":"","sources":["../../../state/store/job-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAQ9C,OAAO,KAAK,EAGV,OAAO,EACP,SAAS,EACT,SAAS,EAEV,MAAM,kBAAkB,CAAC;AAuJ1B,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO;gBAEzB,SAAS;oBASL,MAAM;sBAKlB;QACN,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;KACxB;uBAesB,MAAM;EAIlC"}