@unlink-xyz/core 0.1.3 → 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,39 +1,62 @@
 {
   "name": "@unlink-xyz/core",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "browser": {
+        "import": "./dist/browser/index.js",
+        "types": "./dist/index.d.ts"
+      },
+      "default": {
+        "import": "./dist/index.js",
+        "types": "./dist/index.d.ts"
+      }
     },
-    "./circuits.json": {
-      "import": "./circuits.json",
-      "require": "./circuits.json"
+    "./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"
+  ],
   "publishConfig": {
     "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",
+    "poseidon-lite": "^0.3.0",
     "ethereum-cryptography": "3.2.0",
     "ethers": "6.15.0",
     "ky": "^1.14.0",
@@ -42,13 +65,13 @@
     "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",
     "prettier": "^3.5.3",
+    "tsup": "^8.3.5",
     "typescript": "^5.9.2",
     "vitest": "4.0.1"
   }

package/.eslintrc.json

@@ -1,4 +0,0 @@
-{
-  "root": true,
-  "extends": ["../../.eslintrc.base.json"]
-}

package/account/zkAccount.test.ts

@@ -1,316 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import { Mnemonic } from "../key-derivation/bip39.js";
-import { ByteUtils } from "../key-derivation/bytes.js";
-import {
-  deriveNodesFromSeed,
-  WalletNode,
-} from "../key-derivation/wallet-node.js";
-import { createMemoryStorage } from "../storage/memory.js";
-import {
-  deriveZkAccount,
-  deriveZkAccountFromMnemonic,
-  generateMasterSeed,
-  importMasterMnemonic,
-  loadMasterMnemonic,
-  loadMasterSeed,
-  MASTER_MNEMONIC_KEY,
-  MASTER_SEED_KEY,
-  MASTER_SEED_LENGTH,
-  storeMasterMnemonic,
-  type MasterSeedCrypto,
-} from "./zkAccount.js";
-
-describe("deriveZkAccount", () => {
-  const seed = Uint8Array.from(
-    { length: MASTER_SEED_LENGTH },
-    (_, i) => i & 0xff,
-  );
-
-  it("derives wallet key material", async () => {
-    const account = await deriveZkAccount(seed, 0);
-
-    expect(account.spendingKeyPair.privateKey).toHaveLength(32);
-    expect(typeof account.spendingKeyPair.pubkey[0]).toBe("bigint");
-    expect(typeof account.spendingKeyPair.pubkey[1]).toBe("bigint");
-
-    expect(account.viewingKeyPair.privateKey).toHaveLength(32);
-    expect(account.viewingKeyPair.pubkey).toHaveLength(32);
-
-    expect(account.nullifyingKey).toBeTypeOf("bigint");
-
-    const expectedNullifyingKey = await deriveNodesFromSeed(
-      seed,
-      0,
-    ).viewing.getNullifyingKey();
-    expect(account.nullifyingKey).toBe(expectedNullifyingKey);
-
-    const expectedMPK = WalletNode.getMasterPublicKey(
-      account.spendingKeyPair.pubkey,
-      account.nullifyingKey,
-    );
-    expect(account.masterPublicKey).toBe(expectedMPK);
-  });
-
-  it("derives distinct accounts per index", async () => {
-    const first = await deriveZkAccount(seed, 0);
-    const second = await deriveZkAccount(seed, 1);
-
-    expect(first.spendingKeyPair.privateKey).not.toEqual(
-      second.spendingKeyPair.privateKey,
-    );
-    expect(first.viewingKeyPair.privateKey).not.toEqual(
-      second.viewingKeyPair.privateKey,
-    );
-    expect(first.nullifyingKey).not.toEqual(second.nullifyingKey);
-    expect(first.masterPublicKey).not.toEqual(second.masterPublicKey);
-  });
-
-  it("rejects negative indices", async () => {
-    await expect(deriveZkAccount(seed, -1)).rejects.toThrow(
-      "accountIndex must be a non-negative integer",
-    );
-  });
-
-  it("rejects non-integer indices", async () => {
-    await expect(deriveZkAccount(seed, Number.NaN)).rejects.toThrow(
-      "accountIndex must be a non-negative integer",
-    );
-    await expect(deriveZkAccount(seed, 0.25)).rejects.toThrow(
-      "accountIndex must be a non-negative integer",
-    );
-  });
-
-  it("rejects seeds that are not 64 bytes", async () => {
-    const shortSeed = Uint8Array.from({ length: 32 }, () => 1);
-    await expect(deriveZkAccount(shortSeed, 0)).rejects.toThrow(
-      "master seed must be 64 bytes",
-    );
-  });
-
-  it("derives the same keys when using mnemonic helper", async () => {
-    const entropy = Uint8Array.from({ length: 32 }, (_, i) => (i * 19) & 0xff);
-    const mnemonic = Mnemonic.fromEntropy(ByteUtils.bytesToHex(entropy));
-    const seedFromMnemonic = ByteUtils.hexStringToBytes(
-      Mnemonic.toSeed(mnemonic),
-    );
-
-    const fromSeed = await deriveZkAccount(seedFromMnemonic, 2);
-    const fromMnemonic = await deriveZkAccountFromMnemonic(mnemonic, 2);
-
-    expect(fromMnemonic).toEqual(fromSeed);
-  });
-});
-
-describe("generateMasterSeed", () => {
-  const fixtureEntropy = Uint8Array.from(
-    { length: 32 },
-    (_, i) => (i * 13) & 0xff,
-  );
-  const fixtureMnemonic = Mnemonic.fromEntropy(
-    ByteUtils.bytesToHex(fixtureEntropy),
-  );
-  const fixtureSeed = ByteUtils.hexStringToBytes(
-    Mnemonic.toSeed(fixtureMnemonic),
-  );
-
-  function rngFixture(): (n: number) => Uint8Array {
-    return (n) => {
-      expect(n).toBe(32);
-      return new Uint8Array(fixtureEntropy);
-    };
-  }
-
-  it("creates and persists a new seed when none exists", async () => {
-    const storage = createMemoryStorage();
-
-    const seed = await generateMasterSeed({
-      storage,
-      rng: rngFixture(),
-      mnemonicPassphrase: "",
-    });
-
-    expect(seed).toEqual(fixtureSeed);
-    const stored = await storage.get(MASTER_SEED_KEY);
-    expect(stored).not.toBeNull();
-    expect(stored).toEqual(fixtureSeed);
-
-    const mnemonic = await loadMasterMnemonic(storage);
-    expect(mnemonic).toEqual(fixtureMnemonic);
-  });
-
-  it("returns existing seed without invoking rng", async () => {
-    const storage = createMemoryStorage();
-    await storage.put(MASTER_SEED_KEY, fixtureSeed);
-
-    const seed = await generateMasterSeed({
-      storage,
-      rng: () => {
-        throw new Error("rng should not be called when seed exists");
-      },
-    });
-
-    expect(seed).toEqual(fixtureSeed);
-  });
-
-  it("overwrites when requested", async () => {
-    const storage = createMemoryStorage();
-    const existing = Uint8Array.from(
-      { length: MASTER_SEED_LENGTH },
-      (_, i) => (i * 3) & 0xff,
-    );
-    await storage.put(MASTER_SEED_KEY, existing);
-    const replacementEntropy = Uint8Array.from(
-      { length: 32 },
-      (_, i) => (i * 7) & 0xff,
-    );
-    const replacementMnemonic = Mnemonic.fromEntropy(
-      ByteUtils.bytesToHex(replacementEntropy),
-    );
-    const replacementSeed = ByteUtils.hexStringToBytes(
-      Mnemonic.toSeed(replacementMnemonic),
-    );
-
-    const seed = await generateMasterSeed({
-      storage,
-      rng: (n) => {
-        expect(n).toBe(32);
-        return new Uint8Array(replacementEntropy);
-      },
-      overwrite: true,
-      mnemonicPassphrase: "",
-    });
-
-    expect(seed).toEqual(replacementSeed);
-    const stored = await storage.get(MASTER_SEED_KEY);
-    expect(stored).toEqual(replacementSeed);
-    const mnemonic = await loadMasterMnemonic(storage);
-    expect(mnemonic).toEqual(replacementMnemonic);
-  });
-
-  it("applies custom crypto hooks", async () => {
-    const storage = createMemoryStorage();
-
-    const crypto: MasterSeedCrypto = {
-      encrypt(seed) {
-        return seed.map((byte) => byte ^ 0xff);
-      },
-      decrypt(payload) {
-        return payload.map((byte) => byte ^ 0xff);
-      },
-    };
-
-    const seed = await generateMasterSeed({
-      storage,
-      rng: rngFixture(),
-      crypto,
-      mnemonicPassphrase: "",
-    });
-
-    expect(seed).toEqual(fixtureSeed);
-    const roundTrip = await loadMasterSeed(storage, crypto);
-    expect(roundTrip).toEqual(fixtureSeed);
-
-    const storedMnemonic = await storage.get(MASTER_MNEMONIC_KEY);
-    expect(storedMnemonic).toEqual(
-      textEncode(fixtureMnemonic).map((byte) => byte ^ 0xff),
-    );
-
-    const mnemonicRoundTrip = await loadMasterMnemonic(storage, crypto);
-    expect(mnemonicRoundTrip).toEqual(fixtureMnemonic);
-  });
-
-  it("returns null when no seed is stored", async () => {
-    const storage = createMemoryStorage();
-
-    const result = await loadMasterSeed(storage);
-
-    expect(result).toBeNull();
-  });
-
-  it("throws if rng returns incorrect length", async () => {
-    const storage = createMemoryStorage();
-
-    await expect(
-      generateMasterSeed({
-        storage,
-        rng: () => new Uint8Array(16),
-        mnemonicPassphrase: "",
-      }),
-    ).rejects.toThrow(/mnemonic entropy must be 32 bytes/);
-  });
-
-  it("reconstitutes seed from stored mnemonic when seed missing", async () => {
-    const storage = createMemoryStorage();
-    await storeMnemonicFixture(storage, fixtureMnemonic);
-
-    const seed = await generateMasterSeed({
-      storage,
-      rng: rngFixture(),
-      mnemonicPassphrase: "",
-    });
-
-    expect(seed).toEqual(fixtureSeed);
-    const stored = await storage.get(MASTER_SEED_KEY);
-    expect(stored).toEqual(fixtureSeed);
-  });
-});
-
-describe("importMasterMnemonic", () => {
-  const mnemonic =
-    "legal winner thank year wave sausage worth useful legal winner thank yellow";
-  const seed = ByteUtils.hexStringToBytes(Mnemonic.toSeed(mnemonic));
-
-  it("imports mnemonic and stores derived seed", async () => {
-    const storage = createMemoryStorage();
-
-    const derived = await importMasterMnemonic({ storage, mnemonic });
-
-    expect(derived).toEqual(seed);
-    const storedSeed = await loadMasterSeed(storage);
-    expect(storedSeed).toEqual(seed);
-    const storedMnemonic = await loadMasterMnemonic(storage);
-    expect(storedMnemonic).toEqual(mnemonic);
-  });
-
-  it("refuses to overwrite without flag", async () => {
-    const storage = createMemoryStorage();
-    await importMasterMnemonic({ storage, mnemonic });
-
-    await expect(importMasterMnemonic({ storage, mnemonic })).rejects.toThrow(
-      /already exists/,
-    );
-  });
-
-  it("overwrites when requested", async () => {
-    const storage = createMemoryStorage();
-    await importMasterMnemonic({ storage, mnemonic });
-
-    const alternate =
-      "letter advice cage absurd amount doctor acoustic avoid letter advice cage above";
-    const alternateSeed = ByteUtils.hexStringToBytes(
-      Mnemonic.toSeed(alternate),
-    );
-
-    const derived = await importMasterMnemonic({
-      storage,
-      mnemonic: alternate,
-      overwrite: true,
-    });
-
-    expect(derived).toEqual(alternateSeed);
-    const storedMnemonic = await loadMasterMnemonic(storage);
-    expect(storedMnemonic).toEqual(alternate);
-  });
-});
-
-function textEncode(value: string): Uint8Array {
-  return new TextEncoder().encode(value);
-}
-
-async function storeMnemonicFixture(
-  storage: ReturnType<typeof createMemoryStorage>,
-  mnemonic: string,
-) {
-  await storeMasterMnemonic(storage, mnemonic);
-}