@unlink-xyz/core 0.1.0 → 0.1.3-canary.01ac52d

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

@@ -0,0 +1,186 @@
+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, chain config resolution).
+ *
+ * @example
+ * ```ts
+ * // Chain mode (auto-resolves chainId, gateway, pool, artifacts):
+ * const wallet = await UnlinkWallet.create({
+ *   chain: "monad-testnet",
+ * });
+ *
+ * // Explicit mode (custom/local deployments):
+ * const wallet = await UnlinkWallet.create({
+ *   chainId: 10143,
+ *   poolAddress: "0x...",
+ *   gatewayUrl: "http://localhost:3000",
+ *   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 chain config (if using `chain` 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,36 +1,61 @@
 {
   "name": "@unlink-xyz/core",
-  "version": "0.1.0",
+  "version": "0.1.3-canary.01ac52d",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "browser": {
+        "import": "./dist/browser/index.js",
+        "types": "./dist/index.d.ts"
+      },
+      "default": {
+        "import": "./dist/index.js",
+        "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"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "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",
-    "setup:artifacts": "./setup-artifacts.sh"
+    "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",
-    "@railgun-community/circomlibjs": "0.0.8",
     "@scure/base": "2.0.0",
     "@scure/bip39": "2.0.1",
     "@types/snarkjs": "^0.7.9",
+    "@zk-kit/eddsa-poseidon": "^1.1.0",
     "@zk-kit/imt": "2.0.0-beta.8",
+    "buffer": "^6.0.3",
     "ethereum-cryptography": "3.2.0",
     "ethers": "6.15.0",
     "ky": "^1.14.0",
@@ -39,13 +64,14 @@
     "uuid": "^13.0.0"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3.1.0",
+    "@esbuild-plugins/node-globals-polyfill": "^0.2.3",
+    "@esbuild-plugins/node-modules-polyfill": "^0.2.2",
     "@types/node": "^22.0.0",
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
-    "eslint": "^8.57.1",
+    "eslint": "^9.19.0",
     "fake-indexeddb": "6.2.4",
+    "poseidon-lite": "^0.3.0",
     "prettier": "^3.5.3",
+    "tsup": "^8.3.5",
     "typescript": "^5.9.2",
     "vitest": "4.0.1"
   }

package/dist/account/zkAccount.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zkAccount.d.ts","sourceRoot":"","sources":["../../account/zkAccount.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;IAC5D,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;IAC/B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAC3D,eAAO,MAAM,mBAAmB,kCAAkC,CAAC;AAOnE,MAAM,MAAM,SAAS,GAAG;IACtB,eAAe,EAAE,eAAe,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,eAAe,CACnC,UAAU,EAAE,UAAU,EACtB,YAAY,GAAE,MAAU,GACvB,OAAO,CAAC,SAAS,CAAC,CAqBpB;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,MAAU,EACxB,QAAQ,GAAE,MAAW,GACpB,OAAO,CAAC,SAAS,CAAC,CAIpB;AAWD,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,EACP,GAAG,EACH,MAAiC,EACjC,SAAiB,EACjB,kBAAkB,GACnB,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0BjD;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,gBAA2C,GAClD,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAK5B;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,gBAA2C,GAClD,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,gBAA2C,GAClD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,OAAO,EACP,QAAQ,EACR,MAAiC,EACjC,SAAiB,EACjB,QAAa,GACd,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,CAAC,CAenD;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,gBAA2C,GAClD,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/account/zkAccount.js

@@ -1,128 +0,0 @@
-import { Mnemonic } from "../key-derivation/bip39.js";
-import { ByteUtils } from "../key-derivation/bytes.js";
-import { deriveNodesFromSeed, WalletNode, } from "../key-derivation/wallet-node.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 deriveZkAccount(masterSeed, accountIndex = 0) {
-    const seed = normalizeMasterSeed(masterSeed);
-    if (!Number.isInteger(accountIndex) || accountIndex < 0) {
-        throw new Error("accountIndex must be a non-negative integer");
-    }
-    const { spending, viewing } = deriveNodesFromSeed(seed, accountIndex);
-    const spendingKeyPair = spending.getSpendingKeyPair();
-    const viewingKeyPair = await viewing.getViewingKeyPair();
-    const nullifyingKey = WalletNode.getNullifyingKey(viewingKeyPair.privateKey);
-    const masterPublicKey = WalletNode.getMasterPublicKey(spendingKeyPair.pubkey, nullifyingKey);
-    return {
-        spendingKeyPair,
-        viewingKeyPair,
-        nullifyingKey,
-        masterPublicKey,
-    };
-}
-export async function deriveZkAccountFromMnemonic(mnemonic, accountIndex = 0, password = "") {
-    const normalized = normalizeMnemonic(mnemonic);
-    const seed = mnemonicToSeed(normalized, password);
-    return deriveZkAccount(seed, accountIndex);
-}
-const identityMasterSeedCrypto = {
-    encrypt(seed) {
-        return clone(seed);
-    },
-    decrypt(payload) {
-        return clone(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 Error(`mnemonic entropy must be ${MNEMONIC_ENTROPY_BYTES} bytes`);
-    }
-    const mnemonic = Mnemonic.fromEntropy(ByteUtils.bytesToHex(entropy));
-    await storeMasterMnemonic(storage, mnemonic, crypto);
-    const seed = mnemonicToSeed(mnemonic, mnemonicPassphrase);
-    await storeMasterSeed(storage, seed, crypto);
-    return seed;
-}
-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 Error("master seed encryptor must return Uint8Array");
-    }
-    await storage.put(MASTER_SEED_KEY, clone(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);
-    const mnemonic = textDecoder.decode(plaintext);
-    return normalizeMnemonic(mnemonic);
-}
-export async function importMasterMnemonic({ storage, mnemonic, crypto = identityMasterSeedCrypto, overwrite = false, password = "", }) {
-    if (!overwrite) {
-        const existing = await loadMasterMnemonic(storage, crypto);
-        if (existing) {
-            throw new Error("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 Error("master mnemonic encryptor must return Uint8Array");
-    }
-    await storage.put(MASTER_MNEMONIC_KEY, clone(encrypted));
-}
-function clone(bytes) {
-    return new Uint8Array(bytes);
-}
-function normalizeMasterSeed(seed) {
-    if (!(seed instanceof Uint8Array)) {
-        throw new Error("master seed must be a Uint8Array");
-    }
-    if (seed.length !== MASTER_SEED_LENGTH) {
-        throw new Error(`master seed must be ${MASTER_SEED_LENGTH} bytes`);
-    }
-    return clone(seed);
-}
-function normalizeMnemonic(mnemonic) {
-    const formatted = mnemonic.trim().replace(/\s+/g, " ");
-    if (!Mnemonic.validate(formatted)) {
-        throw new Error("invalid BIP-39 mnemonic phrase");
-    }
-    return formatted;
-}
-function mnemonicToSeed(mnemonic, password = "") {
-    const seedHex = Mnemonic.toSeed(mnemonic, password);
-    return ByteUtils.hexStringToBytes(seedHex);
-}

package/dist/clients/broadcaster.js

@@ -1,23 +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) {
-            return http.request({
-                method: "GET",
-                path: `/relays/${relayId}`,
-            });
-        },
-    };
-}

package/dist/clients/http.js

@@ -1,57 +0,0 @@
-import ky, { HTTPError, TimeoutError } from "ky";
-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 Error("baseUrl is required");
-    if (!deps?.fetch)
-        throw new Error("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,
-    });
-    return {
-        async request(opts) {
-            try {
-                const res = api(opts.path.replace(/^\//, ""), {
-                    method: opts.method,
-                    searchParams: opts.query,
-                    json: opts.json,
-                    body: opts.body,
-                    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);
-                }
-                if (err instanceof TimeoutError) {
-                    throw new HttpError("HTTP timeout", 408, null);
-                }
-                throw new HttpError(err instanceof Error ? err.message : "Network error", 0, null);
-            }
-        },
-    };
-}

package/dist/clients/indexer.js

@@ -1,67 +0,0 @@
-import { isNotFoundError } from "../utils/async.js";
-import { createJsonHttpClient } 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
-    // the rest of the SDK consumes.
-    const normalizeRecord = (record) => ({
-        index: record.leaf_index,
-        commitment: record.commitment,
-        ciphertext: [...record.ciphertext],
-        root: record.root,
-        txHash: record.tx_hash,
-        insertedAt: record.inserted_at,
-    });
-    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}`,
-            });
-            return normalizeRecord(raw);
-        },
-        async getNullifier(params) {
-            try {
-                const raw = await http.request({
-                    method: "GET",
-                    path: `/chains/${params.chainId}/nullifiers/${params.nullifier}`,
-                });
-                return normalizeNullifierRecord(raw);
-            }
-            catch (err) {
-                if (isNotFoundError(err)) {
-                    return null; // Nullifier not spent on-chain
-                }
-                throw err;
-            }
-        },
-        async getNullifierCount(chainId) {
-            const raw = await http.request({
-                method: "GET",
-                path: `/chains/${chainId}/nullifiers/count`,
-            });
-            return raw.count;
-        },
-    };
-}

package/dist/config.js

@@ -1,29 +0,0 @@
-const DEFAULT_RPC_URL = "http://localhost:3000";
-function readEnv(key) {
-    if (typeof process !== "undefined" && process?.env) {
-        return process.env[key];
-    }
-    // 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`);
-    }
-    return trimmed.replace(/\/+$/, "");
-}
-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/core.js

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

package/dist/errors.js

@@ -1,18 +0,0 @@
-export class CoreError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "CoreError";
-    }
-}
-export class KeyValidationError extends CoreError {
-    constructor(message) {
-        super(message);
-        this.name = "KeyValidationError";
-    }
-}
-export class SchemaMismatchError extends CoreError {
-    constructor(current, expected) {
-        super(`schema mismatch (current ${current}, expected ${expected})`);
-        this.name = "SchemaMismatchError";
-    }
-}

package/dist/key-derivation/babyjubjub.d.ts

@@ -1,9 +0,0 @@
-/**
- * Lightweight wrapper exposing the BabyJubJub point packing helpers we rely on for
- * derivation and address encoding. Re-exported for consumers that need raw curve ops.
- */
-export declare class Babyjubjub {
-    static packPoint: (point: [bigint, bigint]) => Uint8Array;
-    static unpackPoint: (bytes: Uint8Array) => [bigint, bigint];
-}
-//# sourceMappingURL=babyjubjub.d.ts.map

package/dist/key-derivation/babyjubjub.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"babyjubjub.d.ts","sourceRoot":"","sources":["../../key-derivation/babyjubjub.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,UAAU;IACrB,MAAM,CAAC,SAAS,0CAAqB;IAErC,MAAM,CAAC,WAAW,0CAAuB;CAC1C"}

package/dist/key-derivation/babyjubjub.js

@@ -1,9 +0,0 @@
-import { babyjub } from "@railgun-community/circomlibjs";
-/**
- * Lightweight wrapper exposing the BabyJubJub point packing helpers we rely on for
- * derivation and address encoding. Re-exported for consumers that need raw curve ops.
- */
-export class Babyjubjub {
-    static packPoint = babyjub.packPoint;
-    static unpackPoint = babyjub.unpackPoint;
-}