@unlink-xyz/core 0.1.2 → 0.1.3-canary.0877bfe

package/dist/prover/prover.js

@@ -1,6 +1,6 @@
 import * as snarkjs from "snarkjs";
-import { CoreError } from "../errors.js";
-import { ArtifactType, buildArtifactUrl, DEFAULT_CONFIG, getLocalArtifactPath, Runtime, } from "./config.js";
+import { ProofError } from "../errors.js";
+import { ArtifactType, buildArtifactUrl, getLocalArtifactPath, Runtime, } from "./config.js";
 import { getCircuitConfig, SUPPORTED_CIRCUITS, } from "./registry.js";
 // Cache for loaded artifacts to avoid reloading 18MB of files on every call
 // Now keyed by circuit name to support multiple circuits
@@ -10,116 +10,130 @@ const artifactCache = {};
  * @param inputs Number of inputs (nullifiers)
  * @param outputs Number of outputs (commitments)
  * @returns Circuit configuration
- * @throws CoreError if no matching circuit is found
+ * @throws ProofError if no matching circuit is found
  */
 function selectCircuit(inputs, outputs) {
     const config = getCircuitConfig(inputs, outputs);
     if (!config) {
-        throw new CoreError(`No circuit available for ${inputs} inputs and ${outputs} outputs. ` +
+        throw new ProofError(`No circuit available for ${inputs} inputs and ${outputs} outputs. ` +
             `Supported circuits: ${SUPPORTED_CIRCUITS.join(", ")}`);
     }
     return config;
 }
 /**
- * Fetch circuit artifacts for a specific circuit
- * Supports both browser (remote) and Node.js (local) environments
+ * Fetch circuit artifacts from server or local files (for tests)
  * @param circuitName Full circuit name (e.g., "joinsplit_2x3_16")
+ * @param rpcUrl Base URL for fetching artifacts
  * @returns Artifacts object with wasm, zkey, and vkey
  */
-async function fetchCircuitArtifacts(circuitName) {
+async function fetchCircuitArtifacts(circuitName, rpcUrl) {
     // Check cache first
     if (artifactCache[circuitName]) {
         return artifactCache[circuitName];
     }
-    let wasm;
-    let zkey;
-    let vkey;
-    // Browser environment: fetch from artifact server
+    // Browser: always requires rpcUrl and fetches from server
     if (Runtime.isBrowser()) {
+        if (!rpcUrl) {
+            throw new ProofError("rpcUrl is required. Please configure it via UnlinkProvider or pass it to the SDK.");
+        }
+        return fetchFromServer(circuitName, rpcUrl);
+    }
+    // Node.js: try server first if rpcUrl provided, fall back to local files
+    if (rpcUrl) {
         try {
-            const baseUrl = DEFAULT_CONFIG.rpcUrl;
-            const wasmUrl = buildArtifactUrl(circuitName, ArtifactType.WASM, baseUrl);
-            const zkeyUrl = buildArtifactUrl(circuitName, ArtifactType.ZKEY, baseUrl);
-            const vkeyUrl = buildArtifactUrl(circuitName, ArtifactType.VKEY, baseUrl);
-            const [wasmRes, zkeyRes, vkeyRes] = await Promise.all([
-                fetch(wasmUrl),
-                fetch(zkeyUrl),
-                fetch(vkeyUrl),
-            ]);
-            if (!wasmRes.ok || !zkeyRes.ok || !vkeyRes.ok) {
-                throw new CoreError(`Failed to fetch artifacts for ${circuitName} from ${baseUrl}. ` +
-                    `Status: wasm=${wasmRes.status}, zkey=${zkeyRes.status}, vkey=${vkeyRes.status}`);
-            }
-            wasm = new Uint8Array(await wasmRes.arrayBuffer());
-            zkey = new Uint8Array(await zkeyRes.arrayBuffer());
-            vkey = await vkeyRes.json();
+            return await fetchFromServer(circuitName, rpcUrl);
         }
-        catch (error) {
-            throw new CoreError(`Failed to fetch artifacts from server for ${circuitName}: ${error.message}`);
+        catch {
+            // Server not available, fall back to local files (useful for tests)
         }
     }
-    // Node.js environment: try local file paths
-    else {
-        const wasmCandidates = getLocalArtifactPath(circuitName, ArtifactType.WASM);
-        const zkeyCandidates = getLocalArtifactPath(circuitName, ArtifactType.ZKEY);
-        const vkeyCandidates = getLocalArtifactPath(circuitName, ArtifactType.VKEY);
-        let wasmLoaded = false;
-        for (const candidate of wasmCandidates) {
-            try {
-                wasm = await readBinaryResource(candidate);
-                wasmLoaded = true;
-                break;
-            }
-            catch {
-                // Try next candidate
-            }
+    // Node.js: try local files (for tests and development)
+    try {
+        return await fetchFromLocalFiles(circuitName);
+    }
+    catch {
+        throw new ProofError("rpcUrl is required. Local artifacts not found. " +
+            "If running tests, ensure artifacts are built with 'pnpm run zk:build'.");
+    }
+}
+async function fetchFromServer(circuitName, rpcUrl) {
+    const wasmUrl = buildArtifactUrl(circuitName, ArtifactType.WASM, rpcUrl);
+    const zkeyUrl = buildArtifactUrl(circuitName, ArtifactType.ZKEY, rpcUrl);
+    const vkeyUrl = buildArtifactUrl(circuitName, ArtifactType.VKEY, rpcUrl);
+    const [wasmRes, zkeyRes, vkeyRes] = await Promise.all([
+        fetch(wasmUrl),
+        fetch(zkeyUrl),
+        fetch(vkeyUrl),
+    ]);
+    if (!wasmRes.ok || !zkeyRes.ok || !vkeyRes.ok) {
+        throw new ProofError(`Failed to fetch artifacts for ${circuitName} from ${rpcUrl}. ` +
+            `Status: wasm=${wasmRes.status}, zkey=${zkeyRes.status}, vkey=${vkeyRes.status}`);
+    }
+    const wasm = new Uint8Array(await wasmRes.arrayBuffer());
+    const zkey = new Uint8Array(await zkeyRes.arrayBuffer());
+    const vkey = (await vkeyRes.json());
+    const artifacts = { wasm, zkey, vkey };
+    artifactCache[circuitName] = artifacts;
+    return artifacts;
+}
+async function fetchFromLocalFiles(circuitName) {
+    const wasmCandidates = getLocalArtifactPath(circuitName, ArtifactType.WASM);
+    const zkeyCandidates = getLocalArtifactPath(circuitName, ArtifactType.ZKEY);
+    const vkeyCandidates = getLocalArtifactPath(circuitName, ArtifactType.VKEY);
+    let wasm;
+    let zkey;
+    let vkey;
+    let wasmLoaded = false;
+    for (const candidate of wasmCandidates) {
+        try {
+            wasm = await readBinaryResource(candidate);
+            wasmLoaded = true;
+            break;
         }
-        if (!wasmLoaded) {
-            throw new CoreError(`Could not find WASM artifact for ${circuitName}. ` +
-                `Please run 'pnpm run build:all' in the circuits package.`);
+        catch {
+            // Try next candidate
         }
-        // Load zkey
-        let zkeyLoaded = false;
-        for (const candidate of zkeyCandidates) {
-            try {
-                zkey = await readBinaryResource(candidate);
-                zkeyLoaded = true;
-                break;
-            }
-            catch {
-                // Try next candidate
-            }
+    }
+    if (!wasmLoaded) {
+        throw new ProofError(`Could not find WASM artifact for ${circuitName}. ` +
+            `Please run 'pnpm run build:all' in the circuits package.`);
+    }
+    // Load zkey
+    let zkeyLoaded = false;
+    for (const candidate of zkeyCandidates) {
+        try {
+            zkey = await readBinaryResource(candidate);
+            zkeyLoaded = true;
+            break;
         }
-        if (!zkeyLoaded) {
-            throw new CoreError(`Could not find zkey artifact for ${circuitName}. ` +
-                `Please run 'pnpm run build:all' in the circuits package.`);
+        catch {
+            // Try next candidate
         }
-        // Load vkey
-        let vkeyLoaded = false;
-        for (const candidate of vkeyCandidates) {
-            try {
-                const vkeyText = await readTextResource(candidate);
-                vkey = JSON.parse(vkeyText);
-                vkeyLoaded = true;
-                break;
-            }
-            catch {
-                // Try next candidate
-            }
+    }
+    if (!zkeyLoaded) {
+        throw new ProofError(`Could not find zkey artifact for ${circuitName}. ` +
+            `Please run 'pnpm run build:all' in the circuits package.`);
+    }
+    // Load vkey
+    let vkeyLoaded = false;
+    for (const candidate of vkeyCandidates) {
+        try {
+            const vkeyText = await readTextResource(candidate);
+            vkey = JSON.parse(vkeyText);
+            vkeyLoaded = true;
+            break;
         }
-        if (!vkeyLoaded) {
-            throw new CoreError(`Could not find verification key for ${circuitName}. ` +
-                `Please run 'pnpm run build:all' in the circuits package.`);
+        catch {
+            // Try next candidate
         }
     }
-    // Verify all artifacts were loaded
-    if (!wasm || !zkey || !vkey) {
-        throw new CoreError(`Failed to load all artifacts for ${circuitName}. ` +
-            `Missing: ${!wasm ? "wasm " : ""}${!zkey ? "zkey " : ""}${!vkey ? "vkey" : ""}`);
+    if (!vkeyLoaded) {
+        throw new ProofError(`Could not find verification key for ${circuitName}. ` +
+            `Please run 'pnpm run build:all' in the circuits package.`);
     }
     // Cache the artifacts for future calls
     // TypeScript now knows these are defined after the check above
-    const artifacts = { wasm, zkey, vkey };
+    const artifacts = { wasm: wasm, zkey: zkey, vkey: vkey };
     artifactCache[circuitName] = artifacts;
     return artifacts;
 }
@@ -143,12 +157,12 @@ async function readBinaryResource(relativePath) {
         }
         const response = await fetch(url);
         if (!response.ok) {
-            throw new CoreError(`failed to fetch ${relativePath}: ${response.statusText}`);
+            throw new ProofError(`failed to fetch ${relativePath}: ${response.statusText}`);
         }
         return new Uint8Array(await response.arrayBuffer());
     }
     catch (error) {
-        throw new CoreError(`failed to read binary resource ${relativePath}: ${error.message}`);
+        throw new ProofError(`failed to read binary resource ${relativePath}: ${error.message}`);
     }
 }
 async function readTextResource(relativePath) {
@@ -170,24 +184,24 @@ async function readTextResource(relativePath) {
     }
     const response = await fetch(url);
     if (!response.ok) {
-        throw new CoreError(`failed to fetch ${relativePath}: ${response.statusText}`);
+        throw new ProofError(`failed to fetch ${relativePath}: ${response.statusText}`);
     }
     return response.text();
 }
-export async function proveTransaction(input) {
+export async function proveTransaction(input, options) {
     try {
         // Auto-detect circuit based on input dimensions
         const nInputs = input.nullifiers.length;
         const nOutputs = input.commitmentsOut.length;
         const circuit = selectCircuit(nInputs, nOutputs);
         // Fetch circuit artifacts (wasm and zkey)
-        const { wasm, vkey, zkey } = await fetchCircuitArtifacts(circuit.name);
+        const { wasm, vkey, zkey } = await fetchCircuitArtifacts(circuit.name, options?.rpcUrl);
         const inputSignals = input;
         const { proof, publicSignals } = await snarkjs.groth16.fullProve(inputSignals, wasm, zkey);
         // Additional verification step (optional)
         const isValid = await snarkjs.groth16.verify(vkey, publicSignals, proof);
         if (!isValid) {
-            throw new CoreError("generated proof is invalid");
+            throw new ProofError("generated proof is invalid");
         }
         return {
             proof,
@@ -195,23 +209,24 @@ export async function proveTransaction(input) {
         };
     }
     catch (error) {
-        throw new CoreError("proof generation failed: " + error.message);
+        throw new ProofError("proof generation failed: " + error.message);
     }
 }
 /**
  * Get verification key for a specific circuit configuration
  * @param inputs Number of inputs (nullifiers)
  * @param outputs Number of outputs (commitments)
+ * @param options Configuration including rpcUrl
  * @returns Verification key for the circuit
  */
-export async function getVerificationKey(inputs, outputs) {
+export async function getVerificationKey(inputs, outputs, options) {
     try {
         const circuit = selectCircuit(inputs, outputs);
-        const { vkey } = await fetchCircuitArtifacts(circuit.name);
+        const { vkey } = await fetchCircuitArtifacts(circuit.name, options?.rpcUrl);
         return vkey;
     }
     catch (error) {
-        throw new CoreError("failed to load verification key: " + error.message);
+        throw new ProofError("failed to load verification key: " + error.message);
     }
 }
 /**
@@ -219,9 +234,10 @@ export async function getVerificationKey(inputs, outputs) {
  * Auto-detects the circuit from the public signals structure
  * @param proof Groth16 proof
  * @param publicSignals Public signals array
+ * @param options Optional configuration including rpcUrl
  * @returns True if proof is valid
  */
-export async function verifyProof(proof, publicSignals) {
+export async function verifyProof(proof, publicSignals, options) {
     try {
         // Public signals structure: [merkleRoot, boundParamsHash, ...nullifiers, ...commitments]
         // We need to determine the circuit from the length
@@ -239,18 +255,18 @@ export async function verifyProof(proof, publicSignals) {
             const parts = circuitKey.split("x");
             const config = getCircuitConfig(parseInt(parts[0]), parseInt(parts[1]));
             if (config && config.inputs + config.outputs === variableCount) {
-                const artifacts = await fetchCircuitArtifacts(config.name);
+                const artifacts = await fetchCircuitArtifacts(config.name, options?.rpcUrl);
                 vkey = artifacts.vkey;
                 break;
             }
         }
         if (!vkey) {
-            throw new CoreError(`Could not determine circuit from ${totalLength} public signals`);
+            throw new ProofError(`Could not determine circuit from ${totalLength} public signals`);
         }
         return await snarkjs.groth16.verify(vkey, publicSignals, proof);
     }
     catch (error) {
-        throw new CoreError("proof verification failed: " + error.message);
+        throw new ProofError("proof verification failed: " + error.message);
     }
 }
 /**
@@ -260,15 +276,16 @@ export async function verifyProof(proof, publicSignals) {
  * @param publicSignals Public signals array
  * @param inputs Number of inputs (nullifiers)
  * @param outputs Number of outputs (commitments)
+ * @param options Optional configuration including rpcUrl
  * @returns True if proof is valid
  */
-export async function verifyProofWithCircuit(proof, publicSignals, inputs, outputs) {
+export async function verifyProofWithCircuit(proof, publicSignals, inputs, outputs, options) {
     try {
         const circuit = selectCircuit(inputs, outputs);
-        const { vkey } = await fetchCircuitArtifacts(circuit.name);
+        const { vkey } = await fetchCircuitArtifacts(circuit.name, options?.rpcUrl);
         return await snarkjs.groth16.verify(vkey, publicSignals, proof);
     }
     catch (error) {
-        throw new CoreError("proof verification failed: " + error.message);
+        throw new ProofError("proof verification failed: " + error.message);
     }
 }

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/prover/registry.js

@@ -1,57 +1,18 @@
-// AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
-// Generated by scripts/generate-registry.ts
-// Source: circuits/circuits.json
-// Generated at: 2025-11-25T13:26:58.576Z
-/**
- * Registry of available circuits
- * Auto-generated from circuits/circuits.json
- */
-export const CIRCUIT_REGISTRY = {
-    "3x3": {
-        name: "joinsplit_3x3_16",
-        inputs: 3,
-        outputs: 3,
-        depth: 16,
-    },
-    "2x3": {
-        name: "joinsplit_2x3_16",
-        inputs: 2,
-        outputs: 3,
-        depth: 16,
-    },
-    "1x2": {
-        name: "joinsplit_1x2_16",
-        inputs: 1,
-        outputs: 2,
-        depth: 16,
-    },
-    "1x1": {
-        name: "joinsplit_1x1_16",
-        inputs: 1,
-        outputs: 1,
-        depth: 16,
-    },
-};
-/**
- * Get list of all supported circuit keys
- */
+import circuitsJson from "../circuits.json" with { type: "json" };
+// Build registry from circuits.json — keyed by "NxM" (inputs x outputs)
+const registry = {};
+for (const [name, def] of Object.entries(circuitsJson)) {
+    const params = def.params;
+    const inputs = params[0];
+    const outputs = params[1];
+    const depth = params[2];
+    registry[`${inputs}x${outputs}`] = { name, inputs, outputs, depth };
+}
+export const CIRCUIT_REGISTRY = registry;
 export const SUPPORTED_CIRCUITS = Object.keys(CIRCUIT_REGISTRY);
-/**
- * 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 function getCircuitConfig(inputs, outputs) {
-    const key = `${inputs}x${outputs}`;
-    return CIRCUIT_REGISTRY[key];
+    return CIRCUIT_REGISTRY[`${inputs}x${outputs}`];
 }
-/**
- * Check if a circuit configuration is supported
- * @param inputs Number of inputs (nullifiers)
- * @param outputs Number of outputs (commitments)
- * @returns True if supported
- */
 export function isCircuitSupported(inputs, outputs) {
     return getCircuitConfig(inputs, outputs) !== undefined;
 }

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,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"}

package/dist/state/merkle/hydrator.js

@@ -1,3 +1,4 @@
+import { CoreError } from "../../errors.js";
 import { parseHexToBigInt } from "../../utils/bigint.js";
 export async function rebuildTreeFromStore({ chainId, trees, loadLeaf, }) {
     trees.reset(chainId);
@@ -8,7 +9,7 @@ export async function rebuildTreeFromStore({ chainId, trees, loadLeaf, }) {
             break;
         const { index } = trees.addLeaf(chainId, parseHexToBigInt(leaf.commitment));
         if (index !== idx) {
-            throw new Error(`stored leaves are inconsistent with local tree, expected ${idx}, got ${index}`);
+            throw new CoreError(`stored leaves are inconsistent with local tree, expected ${idx}, got ${index}`);
         }
         idx += 1;
     }
@@ -28,7 +29,7 @@ export async function hydrateChain({ chainId, trees, loadLeaf, hydrated, }) {
             break;
         const { index } = trees.addLeaf(chainId, parseHexToBigInt(leaf.commitment));
         if (index !== idx) {
-            throw new Error("stored leaves are inconsistent with local tree");
+            throw new CoreError("stored leaves are inconsistent with local tree");
         }
         idx += 1;
     }

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 { createLocalMerkleTree, createMerkleTrees, resolveMerkleTrees, type LocalMerkleTree, type LocalMerkleTrees, type MerkleProof, } from "./merkle-tree.js";
 export { hydrateChain, rebuildTreeFromStore, 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,kBAAkB,GACxB,MAAM,eAAe,CAAC"}

package/dist/state/merkle/index.js

@@ -1,2 +1,2 @@
-export { createLocalMerkleTree, createMerkleTrees, } from "./merkle-tree.js";
+export { createLocalMerkleTree, createMerkleTrees, resolveMerkleTrees, } from "./merkle-tree.js";
 export { hydrateChain, rebuildTreeFromStore, } from "./hydrator.js";

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/merkle/merkle-tree.js

@@ -1,20 +1,21 @@
-import { poseidon } from "@railgun-community/circomlibjs";
 import { IMT, } from "@zk-kit/imt";
-import { ByteLength, ByteUtils } from "../../key-derivation/bytes.js";
+import { poseidon } from "../../crypto-adapters/index.js";
+import { CoreError } from "../../errors.js";
+import { FieldSize, Hex } from "../../keys/hex.js";
 import { ensureChainId } from "../../utils/validators.js";
 const DEFAULT_DEPTH = 16;
 const DEFAULT_ARITY = 2;
-const ZERO_BYTE_LENGTH = ByteLength.UINT_256;
+const ZERO_BYTE_LENGTH = FieldSize.SCALAR;
 // Simple adapter: IMTNode[] -> poseidon(bigint[])
 const hash = (values) => poseidon(values.map((v) => BigInt(v)));
-const formatNode = (value) => ByteUtils.nToHex(value, ZERO_BYTE_LENGTH, true);
+const formatNode = (value) => Hex.fromBigInt(value, ZERO_BYTE_LENGTH, true);
 export function createLocalMerkleTree() {
     const zeroLeaf = 0n;
     const capacity = 2 ** DEFAULT_DEPTH;
     const tree = new IMT(hash, DEFAULT_DEPTH, zeroLeaf, DEFAULT_ARITY);
     function addLeaf(value) {
         if (tree.leaves.length >= capacity) {
-            throw new Error("merkle tree is full");
+            throw new CoreError("merkle tree is full");
         }
         const insertedIndex = tree.leaves.length;
         tree.insert(value);
@@ -32,7 +33,7 @@ export function createLocalMerkleTree() {
     function getLeaf(index) {
         const leaf = tree.leaves[index];
         if (leaf === undefined) {
-            throw new Error("leaf does not exist in this tree");
+            throw new CoreError("leaf does not exist in this tree");
         }
         return formatNode(BigInt(leaf));
     }
@@ -51,7 +52,7 @@ export function createLocalMerkleTree() {
             }
             const zero = tree.zeroes[level];
             if (zero === undefined) {
-                throw new Error("invalid level");
+                throw new CoreError("invalid level");
             }
             return formatNode(zero);
         },
@@ -102,3 +103,11 @@ export function createMerkleTrees() {
         },
     };
 }
+/**
+ * Resolve merkle trees from options or create new instance.
+ * @param opts - Options object that may contain merkle trees
+ * @returns Merkle trees instance
+ */
+export function resolveMerkleTrees(opts) {
+    return opts?.merkleTrees ?? createMerkleTrees();
+}

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

@@ -8,5 +8,9 @@ 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>;
+    /**
+     * 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;8BAC6B,MAAM;EASzC"}

package/dist/state/store/ciphertext-store.js

@@ -21,5 +21,17 @@ export function createCiphertextStore(storage) {
             const data = await storage.get(keys.ciphertext(chainId, index));
             return data ? new Uint8Array(data) : null;
         },
+        /**
+         * Remove all cached ciphertexts for a chain.
+         */
+        async clearCiphertexts(chainId) {
+            ensureChainId(chainId);
+            const prefix = `ciphertexts:${chainId}:`;
+            const entries = await storage.iter({ prefix });
+            if (entries.length === 0)
+                return;
+            const deletions = entries.map(({ key }) => ({ del: key }));
+            await storage.batch(deletions);
+        },
     };
 }