@unlink-xyz/core 0.1.3-canary.fd5dddf → 0.1.4

package/dist/wallet/unlink-wallet.d.ts

@@ -0,0 +1,187 @@
+import type { AccountView } from "../account/account.js";
+import type { RelayStatusResponse } from "../clients/broadcaster.js";
+import type { HistoryEntry } from "../history/types.js";
+import type { NoteRecord } from "../state/store/records.js";
+import type { DepositRelayResult, DepositSyncResult, TransactRelayResult, TransactSyncResult } from "../transactions/types/index.js";
+import type { BurnerAccount, BurnerSendParams } from "./burner/types.js";
+import type { AdapterExecuteResult, SignerOverride, SimpleAdapterExecuteParams, SimpleBurnerFundParams, SimpleBurnerSweepToPoolParams, SimpleDepositParams, SimpleTransactParams, SimpleTransferParams, SimpleWithdrawParams, TransferPlanResult, TransferResult, UnlinkWalletConfig, WalletAccountAPI, WalletSDK, WalletSDKEvent, WithdrawPlanResult, WithdrawResult } from "./types.js";
+/**
+ * High-level wallet API that bakes `chainId` and `poolAddress` at construction time.
+ *
+ * Replaces `createWalletSDK` / `createBrowserWalletSDK` with a single entry point
+ * that absorbs initialization (storage, rng, core migration, environment resolution).
+ *
+ * @example
+ * ```ts
+ * // Browser (auto-detects IndexedDB + crypto.getRandomValues):
+ * const wallet = await UnlinkWallet.create({
+ *   chainId: 11155111,
+ *   environment: "testnet",
+ * });
+ *
+ * // Node (explicit storage):
+ * const wallet = await UnlinkWallet.create({
+ *   chainId: 1,
+ *   poolAddress: "0x...",
+ *   gatewayUrl: "https://...",
+ *   storage: createSqliteStorage({ path: "wallet.db" }),
+ * });
+ *
+ * // Operations — no chainId/poolAddress needed:
+ * await wallet.seed.create();
+ * await wallet.accounts.create();
+ * await wallet.deposit({ depositor: "0x...", deposits: [{ token, amount }] });
+ * await wallet.transfer({ transfers: [{ token, recipient, amount }] });
+ * await wallet.getBalances();
+ * await wallet.sync();
+ * ```
+ */
+export declare class UnlinkWallet {
+    /** @internal */
+    private readonly sdk;
+    /** Chain ID this wallet operates on. */
+    readonly chainId: number;
+    /** Pool contract address this wallet transacts with. */
+    readonly poolAddress: string;
+    private constructor();
+    /**
+     * Create a new UnlinkWallet instance.
+     *
+     * Handles all initialization internally:
+     * - Resolves environment config (if using `environment` instead of explicit URLs)
+     * - Auto-detects storage (IndexedDB in browser) and rng (crypto.getRandomValues)
+     * - Runs schema migration via `initCore()`
+     * - Creates the internal SDK
+     */
+    static create(config: UnlinkWalletConfig): Promise<UnlinkWallet>;
+    /** Seed management (create, import, export, delete mnemonic). */
+    get seed(): WalletSDK["seed"];
+    /** Account management (create, list, switch accounts). */
+    get accounts(): WalletAccountAPI;
+    /**
+     * Request a deposit (1 or more tokens).
+     * Returns calldata the depositor must submit on-chain via their EOA.
+     */
+    deposit(params: SimpleDepositParams): Promise<DepositRelayResult>;
+    /** Wait for a deposit to be confirmed on-chain. */
+    confirmDeposit(relayId: string): Promise<DepositSyncResult>;
+    /**
+     * Execute a private transfer (1 or more recipients).
+     * Handles note selection, circuit selection, and proof generation automatically.
+     */
+    transfer(params: SimpleTransferParams, overrides?: SignerOverride): Promise<TransferResult>;
+    /**
+     * Get a transfer plan without executing (for preview/confirmation UIs).
+     */
+    planTransfer(params: SimpleTransferParams, account?: AccountView): Promise<TransferPlanResult>;
+    /** Execute a pre-built transfer plan. */
+    executeTransfer(plans: TransferPlanResult, overrides?: SignerOverride): Promise<TransferResult>;
+    /**
+     * Execute a withdrawal (1 or more recipients).
+     * Handles note selection, circuit selection, and proof generation automatically.
+     */
+    withdraw(params: SimpleWithdrawParams, overrides?: SignerOverride): Promise<WithdrawResult>;
+    /**
+     * Get a withdrawal plan without executing (for preview/confirmation UIs).
+     */
+    planWithdraw(params: SimpleWithdrawParams, account?: AccountView): Promise<WithdrawPlanResult>;
+    /** Execute a pre-built withdrawal plan. */
+    executeWithdraw(plans: WithdrawPlanResult, overrides?: SignerOverride): Promise<WithdrawResult>;
+    /** Wait for a transfer or withdrawal to be confirmed on-chain. */
+    confirmTransaction(relayId: string): Promise<TransactSyncResult>;
+    /**
+     * Get balance for a specific token (defaults to all tokens if no token specified).
+     * @param token Token address. If omitted, returns balance for all tokens via getBalances().
+     */
+    getBalance(token: string, overrides?: {
+        account: AccountView;
+    }): Promise<bigint>;
+    /** Get balances for all tokens. */
+    getBalances(overrides?: {
+        account: AccountView;
+    }): Promise<Record<string, bigint>>;
+    /** Get transaction history. */
+    getHistory(options?: {
+        includeSelfSends?: boolean;
+    }, overrides?: {
+        account: AccountView;
+    }): Promise<HistoryEntry[]>;
+    /** Get UTXO notes for the active account (or override account). */
+    getNotes(overrides?: {
+        account: AccountView;
+    }): Promise<NoteRecord[]>;
+    /**
+     * Sync notes from the blockchain.
+     * Automatically resolves the active account (no need to pass it).
+     */
+    sync(options?: {
+        forceFullResync?: boolean;
+    }, overrides?: {
+        account: AccountView;
+    }): Promise<void>;
+    /** Start auto-sync at the given interval (default: 5000ms). */
+    startAutoSync(intervalMs?: number): void;
+    /** Stop auto-sync. */
+    stopAutoSync(): void;
+    /** Get the current status of a transaction. */
+    getTxStatus(txId: string): Promise<RelayStatusResponse>;
+    /** Start tracking a transaction for status-changed events. */
+    trackTx(txId: string): void;
+    /** Stop tracking a transaction. */
+    untrackTx(txId: string): void;
+    /**
+     * Subscribe to wallet events (notes-updated, sync-error, tx-status-changed, etc.).
+     * @returns Unsubscribe function.
+     */
+    on(listener: (event: WalletSDKEvent) => void): () => void;
+    /**
+     * Burner account operations (BIP-44 derived EOAs for DeFi interactions).
+     * chainId/poolAddress are injected automatically for fund/sweepToPool.
+     */
+    readonly burner: {
+        /** Derive burner address for a given index. */
+        addressOf: (index: number) => Promise<BurnerAccount>;
+        /** Send a transaction from burner at index. */
+        send: (index: number, tx: BurnerSendParams) => Promise<{
+            txHash: string;
+        }>;
+        /** Export the raw private key (0x-prefixed hex) for wallet import. */
+        exportKey: (index: number) => Promise<string>;
+        /** Withdraw from shielded pool to fund this burner. */
+        fund: (index: number, params: SimpleBurnerFundParams) => Promise<WithdrawResult>;
+        /** Approve + deposit tokens from burner back into shielded pool. */
+        sweepToPool: (index: number, params: SimpleBurnerSweepToPoolParams) => Promise<{
+            txHash: string;
+        }>;
+        /** Get ERC-20 token balance of any address. */
+        getTokenBalance: (address: string, token: string) => Promise<bigint>;
+        /** Get native ETH balance of any address. */
+        getBalance: (address: string) => Promise<bigint>;
+    };
+    /**
+     * Private DeFi adapter operations.
+     * chainId/poolAddress are injected automatically.
+     */
+    readonly adapter: {
+        /**
+         * Execute an atomic unshield -> call(s) -> reshield flow through an adapter.
+         */
+        execute: (params: SimpleAdapterExecuteParams, opts?: {
+            skipBroadcast?: boolean;
+        }, overrides?: SignerOverride) => Promise<AdapterExecuteResult>;
+    };
+    /**
+     * Advanced escape hatch for raw JoinSplit transaction building.
+     * Use this for custom transaction construction (e.g. swap adapters).
+     */
+    readonly advanced: {
+        /** Build and submit raw JoinSplit transactions. */
+        transact: (params: SimpleTransactParams, opts?: {
+            skipBroadcast?: boolean;
+        }) => Promise<TransactRelayResult>;
+        /** Wait for a raw transaction to be confirmed on-chain. */
+        reconcile: (relayId: string) => Promise<TransactSyncResult>;
+    };
+    private requireActiveAccount;
+}
+//# sourceMappingURL=unlink-wallet.d.ts.map

package/dist/wallet/unlink-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlink-wallet.d.ts","sourceRoot":"","sources":["../../wallet/unlink-wallet.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlink-xyz/core",
-  "version": "0.1.3-canary.fd5dddf",
+  "version": "0.1.4",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,6 +15,16 @@
         "types": "./dist/index.d.ts"
       }
     },
+    "./wallet": {
+      "browser": {
+        "import": "./dist/browser/wallet/index.js",
+        "types": "./dist/wallet/index.d.ts"
+      },
+      "default": {
+        "import": "./dist/wallet/index.js",
+        "types": "./dist/wallet/index.d.ts"
+      }
+    },
     "./utils/async.js": {
       "import": "./dist/utils/async.js",
       "types": "./dist/utils/async.d.ts"
@@ -24,21 +34,21 @@
     "dist"
   ],
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json && tsup --config tsup.browser.config.ts",
+    "build": "tsc -p tsconfig.json --emitDeclarationOnly && tsup && tsup --config tsup.browser.config.ts",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier . --write",
     "format:check": "prettier . --check",
-    "test": "tsc -p tsconfig.json && vitest run --test-timeout 0",
+    "test": "tsc --noEmit && vitest run --test-timeout 0",
     "setup:artifacts": "bash ./scripts/setup-artifacts.sh",
     "clean": "rm -rf dist *.tsbuildinfo",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@noble/ed25519": "3.0.0",
+    "@noble/curves": "^2.0.1",
     "@noble/hashes": "2.0.0",
     "@scure/base": "2.0.0",
     "@scure/bip39": "2.0.1",
@@ -46,7 +56,7 @@
     "@zk-kit/eddsa-poseidon": "^1.1.0",
     "@zk-kit/imt": "2.0.0-beta.8",
     "buffer": "^6.0.3",
-    "circomlibjs": "^0.1.7",
+    "poseidon-lite": "^0.3.0",
     "ethereum-cryptography": "3.2.0",
     "ethers": "6.15.0",
     "ky": "^1.14.0",

package/dist/account/account.js

@@ -1,142 +0,0 @@
-import { ValidationError } from "../errors.js";
-import { encodeAddress } from "../keys/address.js";
-import { deriveAccountKeys, } from "../keys/derive.js";
-import { Hex } from "../keys/hex.js";
-import { Mnemonic } from "../keys/mnemonic.js";
-import { zeroize } from "../utils/secure-memory.js";
-export const MASTER_SEED_LENGTH = 64;
-export const MASTER_SEED_KEY = "cfg:wallet:master_seed/v1";
-export const MASTER_MNEMONIC_KEY = "cfg:wallet:master_mnemonic/v1";
-const MNEMONIC_ENTROPY_BYTES = 32;
-const textEncoder = new TextEncoder();
-const textDecoder = new TextDecoder();
-export async function deriveAccount(masterSeed, accountIndex = 0) {
-    const seed = normalizeMasterSeed(masterSeed);
-    if (!Number.isInteger(accountIndex) || accountIndex < 0) {
-        throw new ValidationError("accountIndex must be a non-negative integer");
-    }
-    const keys = await deriveAccountKeys(seed, accountIndex);
-    const address = encodeAddress({
-        masterPublicKey: keys.masterPublicKey,
-        viewingPublicKey: keys.viewing.pubkey,
-    });
-    return {
-        spendingKeyPair: keys.spending,
-        viewingKeyPair: keys.viewing,
-        nullifyingKey: keys.nullifyingKey,
-        masterPublicKey: keys.masterPublicKey,
-        address,
-    };
-}
-export async function deriveAccountFromMnemonic(mnemonic, accountIndex = 0, password = "") {
-    const normalized = normalizeMnemonic(mnemonic);
-    const seed = mnemonicToSeed(normalized, password);
-    try {
-        return await deriveAccount(seed, accountIndex);
-    }
-    finally {
-        zeroize(seed);
-    }
-}
-/** Passthrough crypto, storage handles buffer isolation */
-const identityMasterSeedCrypto = {
-    encrypt: (seed) => seed,
-    decrypt: (payload) => payload,
-};
-export async function generateMasterSeed({ storage, rng, crypto = identityMasterSeedCrypto, overwrite = false, mnemonicPassphrase, }) {
-    if (!overwrite) {
-        const existingSeed = await loadMasterSeed(storage, crypto);
-        if (existingSeed)
-            return existingSeed;
-        const existingMnemonic = await loadMasterMnemonic(storage, crypto);
-        if (existingMnemonic) {
-            const seedFromMnemonic = mnemonicToSeed(existingMnemonic, mnemonicPassphrase);
-            await storeMasterSeed(storage, seedFromMnemonic, crypto);
-            return seedFromMnemonic;
-        }
-    }
-    const entropy = rng(MNEMONIC_ENTROPY_BYTES);
-    if (entropy.length !== MNEMONIC_ENTROPY_BYTES) {
-        throw new ValidationError(`mnemonic entropy must be ${MNEMONIC_ENTROPY_BYTES} bytes`);
-    }
-    try {
-        const mnemonic = Mnemonic.fromEntropy(Hex.fromBytes(entropy));
-        await storeMasterMnemonic(storage, mnemonic, crypto);
-        const seed = mnemonicToSeed(mnemonic, mnemonicPassphrase);
-        await storeMasterSeed(storage, seed, crypto);
-        return seed;
-    }
-    finally {
-        zeroize(entropy);
-    }
-}
-export async function loadMasterSeed(storage, crypto = identityMasterSeedCrypto) {
-    const stored = await storage.get(MASTER_SEED_KEY);
-    if (!stored)
-        return null;
-    const plaintext = await crypto.decrypt(stored);
-    return normalizeMasterSeed(plaintext);
-}
-export async function storeMasterSeed(storage, seed, crypto = identityMasterSeedCrypto) {
-    const normalized = normalizeMasterSeed(seed);
-    const encrypted = await crypto.encrypt(normalized);
-    if (!(encrypted instanceof Uint8Array)) {
-        throw new ValidationError("master seed encryptor must return Uint8Array");
-    }
-    await storage.put(MASTER_SEED_KEY, encrypted);
-}
-export async function loadMasterMnemonic(storage, crypto = identityMasterSeedCrypto) {
-    const stored = await storage.get(MASTER_MNEMONIC_KEY);
-    if (!stored)
-        return null;
-    const plaintext = await crypto.decrypt(stored);
-    try {
-        const mnemonic = textDecoder.decode(plaintext);
-        return normalizeMnemonic(mnemonic);
-    }
-    finally {
-        zeroize(plaintext);
-    }
-}
-export async function importMasterMnemonic({ storage, mnemonic, crypto = identityMasterSeedCrypto, overwrite = false, password = "", }) {
-    if (!overwrite) {
-        const existing = await loadMasterMnemonic(storage, crypto);
-        if (existing) {
-            throw new ValidationError("master mnemonic already exists; set overwrite to true to replace it");
-        }
-    }
-    const normalized = normalizeMnemonic(mnemonic);
-    const seed = mnemonicToSeed(normalized, password);
-    await storeMasterMnemonic(storage, normalized, crypto);
-    await storeMasterSeed(storage, seed, crypto);
-    return seed;
-}
-export async function storeMasterMnemonic(storage, mnemonic, crypto = identityMasterSeedCrypto) {
-    const normalized = normalizeMnemonic(mnemonic);
-    const encrypted = await crypto.encrypt(textEncoder.encode(normalized));
-    if (!(encrypted instanceof Uint8Array)) {
-        throw new ValidationError("master mnemonic encryptor must return Uint8Array");
-    }
-    await storage.put(MASTER_MNEMONIC_KEY, encrypted);
-}
-/** Validates seed format. Storage handles buffer isolation on put/get. */
-function normalizeMasterSeed(seed) {
-    if (!(seed instanceof Uint8Array)) {
-        throw new ValidationError("master seed must be a Uint8Array");
-    }
-    if (seed.length !== MASTER_SEED_LENGTH) {
-        throw new ValidationError(`master seed must be ${MASTER_SEED_LENGTH} bytes`);
-    }
-    return seed;
-}
-function normalizeMnemonic(mnemonic) {
-    const formatted = mnemonic.trim().replace(/\s+/g, " ");
-    if (!Mnemonic.validate(formatted)) {
-        throw new ValidationError("invalid BIP-39 mnemonic phrase");
-    }
-    return formatted;
-}
-function mnemonicToSeed(mnemonic, password = "") {
-    const seedHex = Mnemonic.toSeed(mnemonic, password);
-    return Hex.toBytes(seedHex);
-}

package/dist/circuits.json

@@ -1,74 +0,0 @@
-{
-    "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.js

@@ -1,30 +0,0 @@
-import { createJsonHttpClient } from "./http.js";
-export function createBroadcasterClient(baseUrl, deps) {
-    const http = createJsonHttpClient(baseUrl, deps);
-    return {
-        async submitRelay(params) {
-            return http.request({
-                method: "POST",
-                path: "/relays",
-                json: {
-                    client_tx_id: params.clientTxId,
-                    chain_id: params.chainId,
-                    ...params.payload,
-                },
-            });
-        },
-        async getRelayStatus(relayId) {
-            const raw = await http.request({
-                method: "GET",
-                path: `/relays/${relayId}`,
-            });
-            return {
-                id: raw.id,
-                state: raw.state,
-                txHash: raw.tx_hash,
-                receipt: raw.receipt,
-                error: raw.error,
-            };
-        },
-    };
-}

package/dist/clients/http.js

@@ -1,72 +0,0 @@
-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;
-    constructor(message, status, body) {
-        super(message);
-        this.status = status;
-        this.body = body;
-    }
-}
-async function readErrorBodySafe(res) {
-    try {
-        return await res.clone().json();
-    }
-    catch {
-        const text = await res.text();
-        return text || null;
-    }
-}
-export function createJsonHttpClient(baseUrl, deps) {
-    if (!baseUrl)
-        throw new InitializationError("baseUrl is required");
-    if (!deps?.fetch)
-        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 {
-                res = await api(opts.path.replace(/^\//, ""), {
-                    method: opts.method,
-                    searchParams: opts.query,
-                    json: opts.json,
-                    body: opts.body,
-                    headers: opts.headers,
-                    signal: opts.signal,
-                });
-            }
-            catch (err) {
-                // 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.js

@@ -1,94 +0,0 @@
-import { createJsonHttpClient, HttpError } from "./http.js";
-export function createIndexerClient(baseUrl, deps) {
-    const http = createJsonHttpClient(baseUrl, deps);
-    const normalizeRecord = (record) => ({
-        index: record.leaf_index,
-        commitment: record.commitment,
-        ciphertext: [...record.ciphertext],
-        root: record.root,
-        txHash: record.tx_hash,
-        insertedAt: record.inserted_at,
-        eventType: record.event_type ?? "unknown",
-    });
-    const normalizeNullifierRecord = (record) => ({
-        nullifier: record.nullifier,
-        txHash: record.tx_hash,
-        spentAt: record.spent_at,
-        chainId: record.chain_id,
-    });
-    return {
-        async fetchCommitmentBatch(params) {
-            const raw = await http.request({
-                method: "GET",
-                path: `/chains/${params.chainId}/commitments`,
-                query: {
-                    start: params.start,
-                    limit: params.limit,
-                },
-            });
-            return {
-                chainId: raw.chain_id,
-                commitments: raw.commitments.map(normalizeRecord),
-                latestRoot: raw.latest_root,
-            };
-        },
-        async getCommitment(params) {
-            const raw = await http.request({
-                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) {
-            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: "POST",
-                    path: `/chains/${params.chainId}/nullifiers/check`,
-                    json: { nullifiers: params.nullifiers },
-                });
-                return raw.found.map(normalizeNullifierRecord);
-            }
-            // 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({
-                method: "GET",
-                path: `/chains/${chainId}/nullifiers/count`,
-            });
-            return raw.count;
-        },
-    };
-}