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

package/dist/circuits.json

@@ -0,0 +1,74 @@
+{
+    "joinsplit_1x1_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [1, 1, 16]
+    },
+    "joinsplit_1x2_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [1, 2, 16]
+    },
+    "joinsplit_2x1_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [2, 1, 16]
+    },
+    "joinsplit_2x2_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [2, 2, 16]
+    },
+    "joinsplit_2x3_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [2, 3, 16]
+    },
+    "joinsplit_3x1_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [3, 1, 16]
+    },
+    "joinsplit_3x2_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [3, 2, 16]
+    },
+    "joinsplit_3x3_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [3, 3, 16]
+    },
+    "joinsplit_4x1_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [4, 1, 16]
+    },
+    "joinsplit_4x2_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [4, 2, 16]
+    },
+    "joinsplit_5x1_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [5, 1, 16]
+    },
+    "joinsplit_5x2_16": {
+        "file": "joinsplit",
+        "template": "JoinSplit",
+        "pubs": ["merkleRoot", "boundParamsHash", "nullifiers", "commitmentsOut"],
+        "params": [5, 2, 16]
+    }
+}

package/dist/clients/broadcaster.d.ts

@@ -14,12 +14,17 @@ export type SubmitRelayResponse = {
     accepted: boolean;
     message?: string | null;
 };
-export type RelayState = "pending" | "broadcasting" | "succeeded" | "failed" | "dead";
+export type RelayState = "pending" | "broadcasting" | "submitted" | "succeeded" | "reverted" | "failed" | "dead";
+export type TransactionReceipt = {
+    blockNumber?: number;
+    blockHash?: string;
+    transactionIndex?: number;
+};
 export type RelayStatusResponse = {
     id: string;
     state: RelayState;
     txHash?: string | null;
-    receipt?: unknown;
+    receipt?: TransactionReceipt | null;
     error?: string | null;
 };
 type BroadcasterClientDeps = {

package/dist/clients/broadcaster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broadcaster.d.ts","sourceRoot":"","sources":["../../clients/broadcaster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,cAAc,GACd,WAAW,GACX,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,qBAAqB;wBAKC,iBAAiB;4BAYb,MAAM;EAOvC"}
+{"version":3,"file":"broadcaster.d.ts","sourceRoot":"","sources":["../../clients/broadcaster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,cAAc,GACd,WAAW,GACX,WAAW,GACX,UAAU,GACV,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAWF,KAAK,qBAAqB,GAAG;IAC3B,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,qBAAqB;wBAKC,iBAAiB;4BAYb,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;EAetE"}

package/dist/clients/broadcaster.js

@@ -14,10 +14,18 @@ export function createBroadcasterClient(baseUrl, deps) {
             });
         },
         async getRelayStatus(relayId) {
-            return http.request({
+            const raw = await http.request({
                 method: "GET",
                 path: `/relays/${relayId}`,
             });
+            // Transform snake_case to camelCase for consistency
+            return {
+                id: raw.id,
+                state: raw.state,
+                txHash: raw.tx_hash,
+                receipt: raw.receipt,
+                error: raw.error,
+            };
         },
     };
 }

package/dist/clients/http.d.ts

@@ -1,4 +1,10 @@
 export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * Resolve fetch implementation from options or global.
+ * @param providedFetch - Optional fetch implementation
+ * @returns Fetch function or undefined if not available
+ */
+export declare function resolveFetch(providedFetch?: FetchLike): typeof fetch | undefined;
 export type JsonHttpDeps = {
     fetch: FetchLike;
 };

package/dist/clients/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../clients/http.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClD,CAAC;AAEF,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAK3D;AAWD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GACjB,cAAc,CA+ChB"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../clients/http.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,aAAa,CAAC,EAAE,SAAS,GACxB,OAAO,KAAK,GAAG,SAAS,CAE1B;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClD,CAAC;AAEF,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAK3D;AAWD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GACjB,cAAc,CAqDhB"}

package/dist/clients/http.js

@@ -1,4 +1,13 @@
-import ky, { HTTPError, TimeoutError } from "ky";
+import ky, { TimeoutError } from "ky";
+import { InitializationError } from "../errors.js";
+/**
+ * Resolve fetch implementation from options or global.
+ * @param providedFetch - Optional fetch implementation
+ * @returns Fetch function or undefined if not available
+ */
+export function resolveFetch(providedFetch) {
+    return providedFetch ?? (typeof fetch === "function" ? fetch : undefined);
+}
 export class HttpError extends Error {
     status;
     body;
@@ -19,20 +28,24 @@ async function readErrorBodySafe(res) {
 }
 export function createJsonHttpClient(baseUrl, deps) {
     if (!baseUrl)
-        throw new Error("baseUrl is required");
+        throw new InitializationError("baseUrl is required");
     if (!deps?.fetch)
-        throw new Error("deps.fetch is required");
+        throw new InitializationError("deps.fetch is required");
     // Ensure `fetch` is invoked with a global `this` to avoid "Illegal invocation"
     // errors in some browser environments when the function is extracted. // TODO: can we fix this in another way?
     const fetchImpl = (...args) => deps.fetch.apply(globalThis, args);
     const api = ky.create({
         prefixUrl: baseUrl.replace(/\/+$/, ""),
         fetch: fetchImpl,
+        // Disable ky's automatic error throwing to prevent browser DevTools
+        // from logging expected 404s as network errors
+        throwHttpErrors: false,
     });
     return {
         async request(opts) {
+            let res;
             try {
-                const res = api(opts.path.replace(/^\//, ""), {
+                res = await api(opts.path.replace(/^\//, ""), {
                     method: opts.method,
                     searchParams: opts.query,
                     json: opts.json,
@@ -40,18 +53,20 @@ export function createJsonHttpClient(baseUrl, deps) {
                     headers: opts.headers,
                     signal: opts.signal,
                 });
-                return await res.json();
             }
             catch (err) {
-                if (err instanceof HTTPError) {
-                    const body = await readErrorBodySafe(err.response);
-                    throw new HttpError(`HTTP ${err.response.status} ${err.response.statusText}`.trim(), err.response.status, body);
-                }
+                // Only network-level errors reach here (timeout, connection refused, etc.)
                 if (err instanceof TimeoutError) {
                     throw new HttpError("HTTP timeout", 408, null);
                 }
                 throw new HttpError(err instanceof Error ? err.message : "Network error", 0, null);
             }
+            // HTTP status errors handled outside try-catch - no redundant catch/rethrow
+            if (!res.ok) {
+                const body = await readErrorBodySafe(res);
+                throw new HttpError(`HTTP ${res.status} ${res.statusText}`.trim(), res.status, body);
+            }
+            return (await res.json());
         },
     };
 }

package/dist/clients/indexer.d.ts

@@ -6,6 +6,7 @@ export type CommitmentRecord = {
     root: string;
     txHash: string;
     insertedAt: number;
+    eventType: string;
 };
 export type IndexerNullifierRecord = {
     nullifier: string;
@@ -31,13 +32,23 @@ export type GetNullifierParams = {
     chainId: number;
     nullifier: string;
 };
+export type CheckNullifiersParams = {
+    chainId: number;
+    nullifiers: string[];
+};
 type IndexerClientDeps = {
     fetch: FetchLike;
 };
 export declare function createIndexerClient(baseUrl: string, deps: IndexerClientDeps): {
     fetchCommitmentBatch(params: FetchCommitmentsParams): Promise<CommitmentBatchResponse>;
     getCommitment(params: GetCommitmentParams): Promise<CommitmentRecord>;
+    /**
+     * Like getCommitment but returns null when the commitment doesn't exist.
+     * Used for polling pending deposits without generating console errors.
+     */
+    tryGetCommitment(params: GetCommitmentParams): Promise<CommitmentRecord | null>;
     getNullifier(params: GetNullifierParams): Promise<IndexerNullifierRecord | null>;
+    checkNullifiers(params: CheckNullifiersParams): Promise<IndexerNullifierRecord[]>;
     getNullifierCount(chainId: number): Promise<number>;
 };
 export {};

package/dist/clients/indexer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../clients/indexer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAe3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AASF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAQF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAOF,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB;iCAyB9D,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;0BAgBzB,mBAAmB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;yBAQlB,kBAAkB,GACzB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;+BAcR,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;EAQ5D"}
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../clients/indexer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAe3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AASF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAQF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAWF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB;iCA0B9D,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;0BAgBzB,mBAAmB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IAU5B;;;OAGG;6BAEO,mBAAmB,GAC1B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;yBAQzB,kBAAkB,GACzB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;4BAQ/B,qBAAqB,GAC5B,OAAO,CAAC,sBAAsB,EAAE,CAAC;+BAwBH,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;EAQ5D"}

package/dist/clients/indexer.js

@@ -1,5 +1,4 @@
-import { createJsonHttpClient } from "./http.js";
-import { isNotFoundError } from "../utils/async.js";
+import { createJsonHttpClient, HttpError } from "./http.js";
 export function createIndexerClient(baseUrl, deps) {
     const http = createJsonHttpClient(baseUrl, deps);
     // Converts the snake_case record from the REST API into the camelCase shape
@@ -11,6 +10,7 @@ export function createIndexerClient(baseUrl, deps) {
         root: record.root,
         txHash: record.tx_hash,
         insertedAt: record.inserted_at,
+        eventType: record.event_type ?? "unknown",
     });
     const normalizeNullifierRecord = (record) => ({
         nullifier: record.nullifier,
@@ -39,22 +39,51 @@ export function createIndexerClient(baseUrl, deps) {
                 method: "GET",
                 path: `/chains/${params.chainId}/commitments/${params.commitment}`,
             });
+            if (!raw) {
+                throw new HttpError("commitment not found", 404, null);
+            }
             return normalizeRecord(raw);
         },
+        /**
+         * Like getCommitment but returns null when the commitment doesn't exist.
+         * Used for polling pending deposits without generating console errors.
+         */
+        async tryGetCommitment(params) {
+            const raw = await http.request({
+                method: "GET",
+                path: `/chains/${params.chainId}/commitments/${params.commitment}`,
+            });
+            return raw ? normalizeRecord(raw) : null;
+        },
         async getNullifier(params) {
-            try {
+            const raw = await http.request({
+                method: "GET",
+                path: `/chains/${params.chainId}/nullifiers/${params.nullifier}`,
+            });
+            return raw ? normalizeNullifierRecord(raw) : null;
+        },
+        async checkNullifiers(params) {
+            const CHUNK_SIZE = 1000;
+            if (params.nullifiers.length <= CHUNK_SIZE) {
                 const raw = await http.request({
-                    method: "GET",
-                    path: `/chains/${params.chainId}/nullifiers/${params.nullifier}`,
+                    method: "POST",
+                    path: `/chains/${params.chainId}/nullifiers/check`,
+                    json: { nullifiers: params.nullifiers },
                 });
-                return normalizeNullifierRecord(raw);
+                return raw.found.map(normalizeNullifierRecord);
             }
-            catch (err) {
-                if (isNotFoundError(err)) {
-                    return null; // Nullifier not spent on-chain
-                }
-                throw err;
+            // Chunk into batches of 1000, run sequentially to avoid overwhelming server
+            const results = [];
+            for (let i = 0; i < params.nullifiers.length; i += CHUNK_SIZE) {
+                const chunk = params.nullifiers.slice(i, i + CHUNK_SIZE);
+                const raw = await http.request({
+                    method: "POST",
+                    path: `/chains/${params.chainId}/nullifiers/check`,
+                    json: { nullifiers: chunk },
+                });
+                results.push(...raw.found.map(normalizeNullifierRecord));
             }
+            return results;
         },
         async getNullifierCount(chainId) {
             const raw = await http.request({

package/dist/config.d.ts

@@ -1,12 +1,31 @@
-export declare const serviceConfig: {
-    /**
-     * Base URL for the Broadcaster HTTP API (default: http://localhost:8081).
-     */
+export type Environment = "mainnet" | "testnet" | "local";
+/**
+ * Configuration for a specific environment.
+ */
+export interface EnvironmentConfig {
+    rpcUrl: string;
+    poolAddress: string;
+}
+/**
+ * Service configuration with broadcaster and indexer URLs.
+ */
+export interface ServiceConfig {
     broadcasterBaseUrl: string;
-    /**
-     * Base URL for the Indexer HTTP API (default: http://localhost:8082).
-     */
     indexerBaseUrl: string;
-};
-export type ServiceConfig = typeof serviceConfig;
+}
+/**
+ * Fetch environment configuration from the hosted config file.
+ *
+ * @param env - The environment to fetch config for
+ * @returns Promise resolving to the environment configuration
+ * @throws If fetch fails or environment is not found
+ */
+export declare function fetchEnvironmentConfig(env: Environment): Promise<EnvironmentConfig>;
+/**
+ * Create service configuration from an RPC URL.
+ *
+ * @param rpcUrl - The base RPC URL
+ * @returns Service configuration with broadcaster and indexer URLs
+ */
+export declare function createServiceConfig(rpcUrl: string): ServiceConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../config.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,aAAa;IACxB;;OAEG;;IAGH;;OAEG;;CAGJ,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAKD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAMjE"}

package/dist/config.js

@@ -1,29 +1,36 @@
-const DEFAULT_RPC_URL = "http://localhost:3000";
-function readEnv(key) {
-    if (typeof process !== "undefined" && process?.env) {
-        return process.env[key];
+/**
+ * Environment types for SDK configuration.
+ */
+import { InitializationError } from "./errors.js";
+const CONFIG_URL = "https://raw.githubusercontent.com/unlink-xyz/config/main/environments.json";
+/**
+ * Fetch environment configuration from the hosted config file.
+ *
+ * @param env - The environment to fetch config for
+ * @returns Promise resolving to the environment configuration
+ * @throws If fetch fails or environment is not found
+ */
+export async function fetchEnvironmentConfig(env) {
+    const res = await fetch(CONFIG_URL);
+    if (!res.ok) {
+        throw new InitializationError(`Failed to fetch SDK config: ${res.status}`);
     }
-    // Support environments where process isn't defined but a shim sets globalThis.process
-    const globalProcess = globalThis.process;
-    return globalProcess?.env?.[key];
-}
-function readServiceUrl(envKey, fallback) {
-    const raw = readEnv(envKey);
-    if (!raw)
-        return fallback;
-    const trimmed = raw.trim();
-    if (!trimmed) {
-        throw new Error(`${envKey} must not be empty when set`);
+    const config = (await res.json());
+    if (!config[env]) {
+        throw new InitializationError(`Unknown environment: ${env}`);
     }
-    return trimmed.replace(/\/+$/, "");
+    return config[env];
+}
+/**
+ * Create service configuration from an RPC URL.
+ *
+ * @param rpcUrl - The base RPC URL
+ * @returns Service configuration with broadcaster and indexer URLs
+ */
+export function createServiceConfig(rpcUrl) {
+    const baseUrl = rpcUrl.replace(/\/+$/, "");
+    return {
+        broadcasterBaseUrl: baseUrl + "/broadcaster",
+        indexerBaseUrl: baseUrl + "/indexer",
+    };
 }
-export const serviceConfig = {
-    /**
-     * Base URL for the Broadcaster HTTP API (default: http://localhost:8081).
-     */
-    broadcasterBaseUrl: readServiceUrl("UNLINK_RPC_URL", DEFAULT_RPC_URL) + "/broadcaster",
-    /**
-     * Base URL for the Indexer HTTP API (default: http://localhost:8082).
-     */
-    indexerBaseUrl: readServiceUrl("UNLINK_RPC_URL", DEFAULT_RPC_URL) + "/indexer",
-};

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Sentinel address for native ETH, matching the Solidity Constants.ETH_TOKEN.
+ * Used as the token address in notes to indicate a native ETH deposit/withdrawal.
+ */
+export declare const ETH_TOKEN = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,SAAS,+CAA+C,CAAC"}

package/dist/constants.js

@@ -0,0 +1,5 @@
+/**
+ * Sentinel address for native ETH, matching the Solidity Constants.ETH_TOKEN.
+ * Used as the token address in notes to indicate a native ETH deposit/withdrawal.
+ */
+export const ETH_TOKEN = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;CAChC,CAAC;AAEF,wBAAsB,QAAQ,CAAC,IAAI,EAAE,QAAQ;;aAHlC,MAAM,KAAK,UAAU;GAW/B"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;CAChC,CAAC;AAEF,wBAAsB,QAAQ,CAAC,IAAI,EAAE,QAAQ;;aAHlC,MAAM,KAAK,UAAU;GAa/B"}

package/dist/core.js

@@ -1,9 +1,12 @@
+import { initCrypto } from "./crypto-adapters/index.js";
+import { InitializationError } from "./errors.js";
 import { migrate } from "./schema.js";
 export async function initCore(deps) {
     if (!deps?.storage)
-        throw new Error("storage dep required");
+        throw new InitializationError("storage dep required");
     if (!deps?.rng)
-        throw new Error("rng dep required");
+        throw new InitializationError("rng dep required");
+    await initCrypto();
     await migrate(deps.storage);
     return {
         storage: deps.storage,

package/dist/crypto-adapters/auto-init.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auto-init.d.ts.map

package/dist/crypto-adapters/auto-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-init.d.ts","sourceRoot":"","sources":["../../crypto-adapters/auto-init.ts"],"names":[],"mappings":""}

package/dist/crypto-adapters/auto-init.js

@@ -0,0 +1,7 @@
+/**
+ * Auto-initialization module for tests.
+ * Import this at the top of test files to automatically initialize crypto, not in production code.
+ */
+import { initCrypto } from "./index.js";
+await initCrypto();
+console.log("[crypto] Auto-initialized for tests");

package/dist/crypto-adapters/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Crypto adapters for browser-compatible cryptographic operations.
+ *
+ * Exports:
+ * - poseidon: Poseidon hash from circomlibjs (iden3)
+ * - deriveSpendingPublicKey, signMessage, verifySignature: EdDSA from @zk-kit/eddsa-poseidon
+ * - initCrypto: Async function to initialize crypto primitives (must be called before using poseidon)
+ */
+import "./polyfills.js";
+/**
+ * Initialize the crypto primitives (Poseidon hash function).
+ * This must be called before using the poseidon function.
+ * Safe to call multiple times - subsequent calls return the same promise.
+ */
+export declare function initCrypto(): Promise<void>;
+/**
+ * Poseidon hash function compatible with circomlib circuits.
+ * Wraps circomlibjs buildPoseidon to return bigint directly.
+ */
+export declare const poseidon: (inputs: (bigint | number)[]) => bigint;
+export { derivePublicKey as deriveSpendingPublicKey, signMessage, verifySignature, } from "@zk-kit/eddsa-poseidon";
+//# sourceMappingURL=index.d.ts.map

package/dist/crypto-adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../crypto-adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,gBAAgB,CAAC;AAWxB;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAehD;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAG,MAQtD,CAAC;AAEF,OAAO,EACL,eAAe,IAAI,uBAAuB,EAC1C,WAAW,EACX,eAAe,GAChB,MAAM,wBAAwB,CAAC"}

package/dist/crypto-adapters/index.js

@@ -0,0 +1,47 @@
+/**
+ * Crypto adapters for browser-compatible cryptographic operations.
+ *
+ * Exports:
+ * - poseidon: Poseidon hash from circomlibjs (iden3)
+ * - deriveSpendingPublicKey, signMessage, verifySignature: EdDSA from @zk-kit/eddsa-poseidon
+ * - initCrypto: Async function to initialize crypto primitives (must be called before using poseidon)
+ */
+// Polyfill must be the first import
+import "./polyfills.js";
+import { InitializationError } from "../errors.js";
+let _poseidon = null;
+let _initPromise = null;
+/**
+ * Initialize the crypto primitives (Poseidon hash function).
+ * This must be called before using the poseidon function.
+ * Safe to call multiple times - subsequent calls return the same promise.
+ */
+export async function initCrypto() {
+    if (_poseidon)
+        return; // Already initialized
+    if (_initPromise)
+        return _initPromise; // Initialization in progress
+    _initPromise = (async () => {
+        try {
+            const { buildPoseidon } = await import("circomlibjs");
+            _poseidon = await buildPoseidon();
+        }
+        catch (error) {
+            _initPromise = null; // Reset to allow retry
+            throw error;
+        }
+    })();
+    return _initPromise;
+}
+/**
+ * Poseidon hash function compatible with circomlib circuits.
+ * Wraps circomlibjs buildPoseidon to return bigint directly.
+ */
+export const poseidon = (inputs) => {
+    if (!_poseidon) {
+        throw new InitializationError("Crypto not initialized. Call initCrypto() before using poseidon().");
+    }
+    const hash = _poseidon(inputs);
+    return _poseidon.F.toObject(hash);
+};
+export { derivePublicKey as deriveSpendingPublicKey, signMessage, verifySignature, } from "@zk-kit/eddsa-poseidon";

package/dist/crypto-adapters/polyfills.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Browser polyfills for Node.js-specific APIs used by circomlibjs.
+ */
+export {};
+//# sourceMappingURL=polyfills.d.ts.map

package/dist/crypto-adapters/polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../../crypto-adapters/polyfills.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/crypto-adapters/polyfills.js

@@ -0,0 +1,8 @@
+/**
+ * Browser polyfills for Node.js-specific APIs used by circomlibjs.
+ */
+import { Buffer } from "buffer";
+// Make Buffer available globally for circomlibjs
+if (typeof globalThis.Buffer === "undefined") {
+    globalThis.Buffer = Buffer;
+}

package/dist/errors.d.ts

@@ -7,4 +7,13 @@ export declare class KeyValidationError extends CoreError {
 export declare class SchemaMismatchError extends CoreError {
     constructor(current: number, expected: number);
 }
+export declare class ValidationError extends CoreError {
+    constructor(message: string);
+}
+export declare class ProofError extends CoreError {
+    constructor(message: string);
+}
+export declare class InitializationError extends CoreError {
+    constructor(message: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAI9C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAI9C;AAED,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAW,SAAQ,SAAS;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -16,3 +16,21 @@ export class SchemaMismatchError extends CoreError {
         this.name = "SchemaMismatchError";
     }
 }
+export class ValidationError extends CoreError {
+    constructor(message) {
+        super(message);
+        this.name = "ValidationError";
+    }
+}
+export class ProofError extends CoreError {
+    constructor(message) {
+        super(message);
+        this.name = "ProofError";
+    }
+}
+export class InitializationError extends CoreError {
+    constructor(message) {
+        super(message);
+        this.name = "InitializationError";
+    }
+}

package/dist/history/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./service.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../history/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}