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

package/dist/transactions/types/state-stores.d.ts

@@ -0,0 +1,151 @@
+/**
+ * State store interfaces for transaction operations.
+ */
+import type { JobKind, JobRecord, JobStatus, LeafRecord, NoteRecord, NullifierRecord, RootRecord } from "../../state/index.js";
+/**
+ * Base state store interface with common methods shared across services.
+ */
+export type BaseStateStore = {
+    putLeaf(record: LeafRecord): Promise<void>;
+    getLeaf(chainId: number, index: number): Promise<LeafRecord | null>;
+    listLeaves(chainId: number): Promise<LeafRecord[]>;
+    clearLeaves(chainId: number): Promise<void>;
+    putRoot(record: RootRecord): Promise<void>;
+    putJob(job: JobRecord): Promise<void>;
+    getJob(relayId: string): Promise<JobRecord | null>;
+    listJobs(filter?: {
+        kind?: JobKind;
+        statuses?: JobStatus[];
+    }): Promise<JobRecord[]>;
+    deleteJob(relayId: string): Promise<void>;
+};
+/**
+ * State store interface for transaction operations.
+ */
+export type TransactStateStore = BaseStateStore & {
+    getNote(chainId: number, index: number): Promise<NoteRecord | null>;
+    markNoteSpent(chainId: number, index: number, spentAt?: number, spentTxHash?: string): Promise<NoteRecord>;
+    putNullifier(record: NullifierRecord): Promise<void>;
+    listNotes(options?: {
+        chainId?: number;
+        mpk?: string;
+        token?: string;
+        includeSpent?: boolean;
+    }): Promise<NoteRecord[]>;
+};
+/**
+ * State store interface for note synchronization operations.
+ * Extends BaseStateStore with note-specific methods.
+ */
+export type NoteSyncStateStore = BaseStateStore & {
+    putNote(record: NoteRecord): Promise<void>;
+    getNote(chainId: number, index: number): Promise<NoteRecord | null>;
+    clearNotes(chainId: number): Promise<void>;
+    listNotes(options?: {
+        chainId?: number;
+        mpk?: string;
+        token?: string;
+        includeSpent?: boolean;
+    }): Promise<NoteRecord[]>;
+    markNoteSpent(chainId: number, index: number, spentAt?: number, spentTxHash?: string): Promise<NoteRecord>;
+    putCiphertext(chainId: number, index: number, payload: Uint8Array): Promise<void>;
+    getCiphertext(chainId: number, index: number): Promise<Uint8Array | null>;
+    listCiphertexts(chainId: number): Promise<{
+        index: number;
+        payload: Uint8Array;
+    }[]>;
+    clearCiphertexts(chainId: number): Promise<void>;
+    countNullifiers(chainId: number): Promise<number>;
+    clearNullifiers(chainId: number): Promise<void>;
+    clearNullifiersFromIndex(chainId: number, fromIndex: number): Promise<void>;
+    putNullifier(record: NullifierRecord): Promise<void>;
+    /**
+     * Atomically store a commitment's leaf, ciphertext, root, and optionally note.
+     * Uses storage.batch() for all-or-nothing semantics.
+     */
+    syncCommitment(params: {
+        leaf: {
+            chainId: number;
+            index: number;
+            commitment: string;
+            txHash?: string;
+            eventType?: string;
+            adapterNpk?: string;
+            adapterToken?: string;
+            adapterAmount?: string;
+            adapterRandom?: string;
+            insertedAt?: number;
+        };
+        ciphertext: {
+            chainId: number;
+            index: number;
+            payload: Uint8Array;
+        };
+        root: {
+            chainId: number;
+            root: string;
+        };
+        note?: {
+            chainId: number;
+            index: number;
+            token: string;
+            value: string;
+            commitment: string;
+            npk: string;
+            mpk: string;
+            random: string;
+            nullifier: string;
+            createdTxHash?: string;
+            createdEventType?: string;
+            createdAt?: number;
+            spentAt?: number;
+            spentTxHash?: string;
+        };
+    }): Promise<void>;
+    /** Atomically store multiple commitments in a single batch write. */
+    syncCommitmentBatch(items: Array<{
+        leaf: {
+            chainId: number;
+            index: number;
+            commitment: string;
+            txHash?: string;
+            eventType?: string;
+            adapterNpk?: string;
+            adapterToken?: string;
+            adapterAmount?: string;
+            adapterRandom?: string;
+            insertedAt?: number;
+        };
+        ciphertext: {
+            chainId: number;
+            index: number;
+            payload: Uint8Array;
+        };
+        root: {
+            chainId: number;
+            root: string;
+        };
+        note?: {
+            chainId: number;
+            index: number;
+            token: string;
+            value: string;
+            commitment: string;
+            npk: string;
+            mpk: string;
+            random: string;
+            nullifier: string;
+            createdTxHash?: string;
+            createdEventType?: string;
+            createdAt?: number;
+            spentAt?: number;
+            spentTxHash?: string;
+        };
+    }>): Promise<void>;
+    getRescanCursor(chainId: number, mpk: string): Promise<number | null>;
+    setRescanCursor(chainId: number, mpk: string, value: number): Promise<void>;
+    clearRescanCursors(chainId: number): Promise<void>;
+    /** Clear notes, leaves, ciphertexts, and unspent indices for indices >= fromIndex. */
+    clearChainDataFromIndex(chainId: number, fromIndex: number): Promise<void>;
+};
+//# sourceMappingURL=state-stores.d.ts.map

package/dist/transactions/types/state-stores.d.ts.map

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

package/dist/transactions/types/transact.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Types for transaction operations.
+ */
+import type { IMTMerkleProof } from "@zk-kit/imt";
+import type { AccountView, Signer } from "../../account/account.js";
+import type { CommitmentRecord } from "../../clients/indexer.js";
+import type { NoteInput, Proof, SpendNoteReference, WithdrawalNoteInput } from "./domain.js";
+/**
+ * A single transaction item (used in the transactions array).
+ */
+export type TransactItem = {
+    /** Token address */
+    token: string;
+    /** Input notes to spend */
+    inputs: SpendNoteReference[];
+    /** Output notes to create */
+    outputs: NoteInput[];
+    /** Optional withdrawal output */
+    withdrawal?: WithdrawalNoteInput;
+    /**
+     * Optional adapter execution binding hash.
+     * When set, it is included in proof-bound context parameters.
+     */
+    adapterDataHash?: bigint;
+};
+/**
+ * Parameters required to execute private transaction(s).
+ * Always accepts an array of transactions - single tx just passes [item].
+ */
+export type TransactParams = {
+    /** Account identity (viewing key, nullifying key, address) */
+    account: AccountView;
+    /** Signing capability (public key + sign function) */
+    signer: Signer;
+    /** Chain ID for the target blockchain */
+    chainId: number;
+    /** Pool contract address */
+    poolAddress: string;
+    /** Transactions to execute (proofs generated in parallel, bundled into one call) */
+    transactions: TransactItem[];
+};
+/**
+ * Result of a single transaction within the batch.
+ */
+export type TransactItemResult = {
+    /** Generated proof */
+    proof: Proof;
+    /** Merkle witnesses for inputs */
+    witnesses: IMTMerkleProof[];
+    /** Nullifiers of spent notes */
+    nullifiers: string[];
+    /** Predicted commitment hex strings */
+    predictedCommitments: string[];
+};
+/**
+ * Result of the transact flow, including calldata and state deltas.
+ */
+export type TransactRelayResult = {
+    /** Relay ID for tracking */
+    relayId: string;
+    /** Calldata to submit on-chain */
+    calldata: string;
+    /** Individual transaction results */
+    transactions: TransactItemResult[];
+};
+/**
+ * Result of syncing a pending transaction.
+ */
+export type TransactSyncResult = {
+    /** Chain ID */
+    chainId: number;
+    /** Merkle root after transaction */
+    root: string;
+    /** Nullifiers of spent notes (all transactions combined) */
+    nullifiers: string[];
+    /** New commitment hex strings (all transactions combined) */
+    newCommitments: string[];
+    /** Transaction hash (if available) */
+    txHash?: string;
+    /** Indexed commitments */
+    indexedCommitments?: CommitmentRecord[];
+};
+//# sourceMappingURL=transact.d.ts.map

package/dist/transactions/types/transact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transact.d.ts","sourceRoot":"","sources":["../../../transactions/types/transact.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,iCAAiC;IACjC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,8DAA8D;IAC9D,OAAO,EAAE,WAAW,CAAC;IACrB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sBAAsB;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,kCAAkC;IAClC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,gCAAgC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uCAAuC;IACvC,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACzC,CAAC"}

package/dist/transactions/withdrawal-planner.d.ts

@@ -0,0 +1,58 @@
+import { type CircuitConfig } from "../prover/registry.js";
+import type { NoteInput, SelectableNote, WithdrawalNoteInput } from "./types/index.js";
+/**
+ * Result of planning a withdrawal transaction.
+ */
+export type WithdrawalPlan<T> = {
+    /** Selected input notes to spend */
+    inputs: SelectableNote<T>[];
+    /** Output notes (change only, if any) */
+    outputNotes: NoteInput[];
+    /** Withdrawal specification */
+    withdrawal: WithdrawalNoteInput;
+    /** Selected circuit configuration */
+    circuit: CircuitConfig;
+    /** Total input amount from selected notes */
+    totalInput: bigint;
+    /** Amount being withdrawn */
+    withdrawAmount: bigint;
+    /** Change amount returned to sender */
+    change: bigint;
+    /** Token address */
+    token: string;
+};
+/**
+ * Input for a single withdrawal in a batch.
+ */
+export type WithdrawalInput = {
+    token: string;
+    amount: bigint;
+    recipient: string;
+};
+/**
+ * Plan withdrawal transaction(s).
+ * Accepts 1 or more withdrawals. When multiple withdrawals use the same token,
+ * notes are tracked across withdrawals to avoid double-spending.
+ *
+ * @param notes - Available unspent notes (all tokens)
+ * @param withdrawals - Withdrawals to plan (each with token, amount, recipient)
+ * @param senderMpk - Sender's master public key (for change outputs)
+ * @returns Array of withdrawal plans, one per withdrawal input
+ *
+ * @example
+ * ```typescript
+ * // Single withdrawal
+ * const [plan] = planWithdrawals(notes, [{ token, amount: 100n, recipient: "0x..." }], mpk);
+ *
+ * // Multiple withdrawals (possibly same token)
+ * const plans = planWithdrawals(notes, [
+ *   { token: ETH, amount: 100n, recipient: "0x..." },
+ *   { token: USDC, amount: 50n, recipient: "0x..." },
+ * ], mpk);
+ * ```
+ */
+export declare function planWithdrawals<T extends {
+    index: number;
+    value: bigint | string;
+}>(notes: SelectableNote<T>[], withdrawals: WithdrawalInput[], senderMpk: bigint, senderViewingPubKey: Uint8Array): WithdrawalPlan<T>[];
+//# sourceMappingURL=withdrawal-planner.d.ts.map

package/dist/transactions/withdrawal-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawal-planner.d.ts","sourceRoot":"","sources":["../../transactions/withdrawal-planner.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG7E,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,oCAAoC;IACpC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,yCAAyC;IACzC,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,+BAA+B;IAC/B,UAAU,EAAE,mBAAmB,CAAC;IAChC,qCAAqC;IACrC,OAAO,EAAE,aAAa,CAAC;IACvB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAqFF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAEnD,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EAC1B,WAAW,EAAE,eAAe,EAAE,EAC9B,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,UAAU,GAC9B,cAAc,CAAC,CAAC,CAAC,EAAE,CA2ErB"}