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

package/dist/history/index.js

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./service.js";

package/dist/history/service.d.ts

@@ -0,0 +1,46 @@
+import type { JobKind, JobRecord, JobStatus } from "../state/index.js";
+import type { NoteRecord } from "../state/store/records.js";
+import type { HistoryEntry } from "./types.js";
+type HistoryStateStore = {
+    listNotes(options?: {
+        chainId?: number;
+        mpk?: string;
+        token?: string;
+        includeSpent?: boolean;
+    }): Promise<NoteRecord[]>;
+    listJobs(filter?: {
+        kind?: JobKind;
+        statuses?: JobStatus[];
+    }): Promise<JobRecord[]>;
+    putHistoryEntry(entry: HistoryEntry): Promise<void>;
+    commitHistorySnapshot(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<void>;
+    hasHistorySnapshot(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<boolean>;
+    listHistoryEntries(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<HistoryEntry[]>;
+    clearHistoryEntries(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<void>;
+};
+export declare function createHistoryService(stateStore: HistoryStateStore): {
+    rebuildHistory(params: {
+        chainId: number;
+        mpk: string;
+    }): Promise<void>;
+    getHistory(params: {
+        chainId: number;
+        mpk: string;
+        force?: boolean;
+        includeSelfSends?: boolean;
+    }): Promise<HistoryEntry[]>;
+};
+export {};
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../history/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,YAAY,CAAC;AAE3E,KAAK,iBAAiB,GAAG;IACvB,SAAS,CAAC,OAAO,CAAC,EAAE;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;KACxB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACzB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,qBAAqB,CAAC,OAAO,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,kBAAkB,CAAC,OAAO,EAAE;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,kBAAkB,CAAC,OAAO,EAAE;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC5B,mBAAmB,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E,CAAC;AA6OF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,iBAAiB;2BA8IjC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;uBAmBpC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B;EA2CJ"}

package/dist/history/service.js

@@ -0,0 +1,354 @@
+import { ensureChainId, ensureMpk } from "../utils/validators.js";
+function addByToken(totals, token, delta) {
+    totals.set(token, (totals.get(token) ?? 0n) + delta);
+}
+function maxTimestamp(notes, field) {
+    let max = 0;
+    for (const note of notes) {
+        const timestamp = note[field];
+        if (timestamp !== undefined)
+            max = Math.max(max, timestamp);
+    }
+    return max > 0 ? max : undefined;
+}
+const STATUS_PRIORITY = {
+    failed: 3,
+    pending: 2,
+    confirmed: 1,
+};
+function convertJobStatus(jobStatus) {
+    if (jobStatus === "failed" || jobStatus === "dead")
+        return "failed";
+    if (jobStatus === "pending" ||
+        jobStatus === "submitted" ||
+        jobStatus === "broadcasting")
+        return "pending";
+    return "confirmed";
+}
+function mergeStatus(prev, next) {
+    if (!prev)
+        return next;
+    return STATUS_PRIORITY[next] > STATUS_PRIORITY[prev] ? next : prev;
+}
+function computeEntryId(params) {
+    return `${params.chainId}:${params.mpk}:${params.txHash}:${params.kind}`;
+}
+function groupNotesByTransaction(notes) {
+    const byTx = new Map();
+    const ensureGroup = (txHash) => {
+        const existing = byTx.get(txHash);
+        if (existing)
+            return existing;
+        const next = {
+            created: [],
+            spent: [],
+            createdEventType: undefined,
+        };
+        byTx.set(txHash, next);
+        return next;
+    };
+    for (const note of notes) {
+        if (note.createdTxHash) {
+            const group = ensureGroup(note.createdTxHash);
+            group.created.push(note);
+            group.createdEventType ??= note.createdEventType;
+        }
+        if (note.spentTxHash) {
+            const group = ensureGroup(note.spentTxHash);
+            group.spent.push(note);
+        }
+    }
+    return byTx;
+}
+function resolveJobStatuses(jobs, chainId, mpk) {
+    const statusByTxHash = new Map();
+    for (const job of jobs) {
+        if (job.chainId !== chainId)
+            continue;
+        if (job.mpk && job.mpk !== mpk)
+            continue;
+        const txHash = job.txHash ?? undefined;
+        if (!txHash)
+            continue;
+        const status = convertJobStatus(job.status);
+        statusByTxHash.set(txHash, mergeStatus(statusByTxHash.get(txHash), status));
+    }
+    return statusByTxHash;
+}
+function aggregateAmounts(group) {
+    const createdTotals = new Map();
+    const spentTotals = new Map();
+    for (const note of group.created) {
+        addByToken(createdTotals, note.token, BigInt(note.value));
+    }
+    for (const note of group.spent) {
+        addByToken(spentTotals, note.token, BigInt(note.value));
+    }
+    const tokens = new Set([
+        ...createdTotals.keys(),
+        ...spentTotals.keys(),
+    ]);
+    const netByToken = new Map();
+    let hasNetChange = false;
+    for (const token of tokens) {
+        const created = createdTotals.get(token) ?? 0n;
+        const spent = spentTotals.get(token) ?? 0n;
+        const net = created - spent;
+        netByToken.set(token, net);
+        if (net !== 0n)
+            hasNetChange = true;
+    }
+    return { createdTotals, spentTotals, netByToken, hasNetChange };
+}
+function classifyTransaction(group, amounts) {
+    const isSelfSend = group.spent.length > 0 && !amounts.hasNetChange;
+    if (isSelfSend) {
+        return "SelfSend";
+    }
+    else if (group.spent.length > 0) {
+        return "Send";
+    }
+    else if (group.created.length > 0) {
+        return group.createdEventType === "deposit" ? "Deposit" : "Receive";
+    }
+    return null;
+}
+function computeFinalAmounts(kind, amounts) {
+    const finalTotals = new Map();
+    const tokens = new Set([
+        ...amounts.createdTotals.keys(),
+        ...amounts.spentTotals.keys(),
+    ]);
+    if (kind === "SelfSend") {
+        for (const token of tokens)
+            finalTotals.set(token, 0n);
+    }
+    else if (kind === "Send" || kind === "Withdraw") {
+        for (const [token, net] of amounts.netByToken.entries()) {
+            if (net < 0n)
+                finalTotals.set(token, net);
+        }
+    }
+    else {
+        for (const [token, net] of amounts.netByToken.entries()) {
+            if (net > 0n)
+                finalTotals.set(token, net);
+        }
+    }
+    return finalTotals;
+}
+function selectTimestamp(kind, group) {
+    if (kind === "Deposit" || kind === "Receive") {
+        return maxTimestamp(group.created, "createdAt");
+    }
+    else if (kind === "Send" || kind === "SelfSend" || kind === "Withdraw") {
+        return (maxTimestamp(group.spent, "spentAt") ??
+            maxTimestamp(group.created, "createdAt"));
+    }
+    return undefined;
+}
+function buildHistoryEntry(params) {
+    return {
+        id: computeEntryId({
+            chainId: params.chainId,
+            mpk: params.mpk,
+            txHash: params.txHash,
+            kind: params.kind,
+        }),
+        chainId: params.chainId,
+        mpk: params.mpk,
+        txHash: params.txHash,
+        kind: params.kind,
+        status: params.status,
+        timestamp: params.timestamp,
+        amounts: [...params.finalAmounts.entries()].map(([token, delta]) => ({
+            token,
+            delta: delta.toString(),
+        })),
+        details: {
+            createdNoteCount: params.group.created.length,
+            spentNoteCount: params.group.spent.length,
+            createdEventType: params.group.createdEventType ?? "unknown",
+        },
+    };
+}
+export function createHistoryService(stateStore) {
+    // Track pending rebuilds to prevent concurrent execution
+    const pendingRebuilds = new Map();
+    async function computeHistory(params) {
+        ensureChainId(params.chainId);
+        ensureMpk(params.mpk);
+        // Fetch data
+        const notes = await stateStore.listNotes({
+            chainId: params.chainId,
+            mpk: params.mpk,
+            includeSpent: true,
+        });
+        const jobs = await stateStore.listJobs({
+            statuses: [
+                "pending",
+                "submitted",
+                "broadcasting",
+                "failed",
+                "dead",
+                "succeeded",
+            ],
+        });
+        // Group notes by transaction hash
+        const byTx = groupNotesByTransaction(notes);
+        // Resolve job statuses for each transaction
+        const statusByTxHash = resolveJobStatuses(jobs, params.chainId, params.mpk);
+        const entries = [];
+        const confirmedTxHashes = new Set();
+        // Process each transaction group
+        for (const [txHash, group] of byTx.entries()) {
+            if (group.created.length === 0 && group.spent.length === 0)
+                continue;
+            // Aggregate amounts and compute net deltas
+            const amounts = aggregateAmounts(group);
+            // Classify transaction type
+            const kind = classifyTransaction(group, amounts);
+            if (!kind)
+                continue;
+            // Compute final amounts to display
+            const finalAmounts = computeFinalAmounts(kind, amounts);
+            if (finalAmounts.size === 0)
+                continue;
+            // Select appropriate timestamp
+            const timestamp = selectTimestamp(kind, group);
+            // Build history entry
+            const entry = buildHistoryEntry({
+                chainId: params.chainId,
+                mpk: params.mpk,
+                txHash,
+                kind,
+                status: statusByTxHash.get(txHash) ?? "confirmed",
+                timestamp,
+                finalAmounts,
+                group,
+            });
+            confirmedTxHashes.add(txHash);
+            entries.push(entry);
+        }
+        // Add pending job entries for transactions not yet indexed
+        for (const job of jobs) {
+            if (job.chainId !== params.chainId)
+                continue;
+            if (job.mpk && job.mpk !== params.mpk)
+                continue;
+            const txHash = job.txHash ?? undefined;
+            if (!txHash)
+                continue;
+            if (confirmedTxHashes.has(txHash))
+                continue;
+            if (!job.historyPreview)
+                continue;
+            if (job.status === "succeeded")
+                continue;
+            const status = job.status === "failed" || job.status === "dead" ? "failed" : "pending";
+            entries.push({
+                id: computeEntryId({
+                    chainId: params.chainId,
+                    mpk: params.mpk,
+                    txHash,
+                    kind: job.historyPreview.kind,
+                }),
+                chainId: params.chainId,
+                mpk: params.mpk,
+                txHash,
+                kind: job.historyPreview.kind,
+                status,
+                timestamp: job.createdAt,
+                amounts: job.historyPreview.amounts,
+                details: {
+                    source: "job",
+                    jobKind: job.kind,
+                },
+            });
+        }
+        // Sort by timestamp descending
+        entries.sort((a, b) => {
+            const at = a.timestamp ?? 0;
+            const bt = b.timestamp ?? 0;
+            if (at !== bt)
+                return bt - at;
+            return b.txHash.localeCompare(a.txHash);
+        });
+        // Filter self-sends if needed (unified filtering point)
+        return params.includeSelfSends
+            ? entries
+            : entries.filter((e) => e.kind !== "SelfSend");
+    }
+    async function computeAndPersist(params) {
+        // Always compute with self-sends included for complete storage
+        const allEntries = await computeHistory({
+            chainId: params.chainId,
+            mpk: params.mpk,
+            includeSelfSends: true,
+        });
+        await stateStore.clearHistoryEntries({
+            chainId: params.chainId,
+            mpk: params.mpk,
+        });
+        await Promise.all(allEntries.map((entry) => stateStore.putHistoryEntry(entry)));
+        await stateStore.commitHistorySnapshot({
+            chainId: params.chainId,
+            mpk: params.mpk,
+        });
+    }
+    return {
+        async rebuildHistory(params) {
+            const rebuildKey = `${params.chainId}:${params.mpk}`;
+            // If a rebuild is already in progress, wait for it instead of starting a new one
+            const existing = pendingRebuilds.get(rebuildKey);
+            if (existing) {
+                return existing;
+            }
+            // Start a new rebuild and track it
+            const rebuildPromise = computeAndPersist(params).finally(() => {
+                // Clean up when done
+                pendingRebuilds.delete(rebuildKey);
+            });
+            pendingRebuilds.set(rebuildKey, rebuildPromise);
+            return rebuildPromise;
+        },
+        async getHistory(params) {
+            ensureChainId(params.chainId);
+            ensureMpk(params.mpk);
+            // If rebuild in progress, wait for it
+            const rebuildKey = `${params.chainId}:${params.mpk}`;
+            const pendingRebuild = pendingRebuilds.get(rebuildKey);
+            if (pendingRebuild) {
+                await pendingRebuild;
+            }
+            if (params.force) {
+                await computeAndPersist({
+                    chainId: params.chainId,
+                    mpk: params.mpk,
+                });
+            }
+            else {
+                // Check if we have persisted history
+                const hasSnapshot = await stateStore.hasHistorySnapshot({
+                    chainId: params.chainId,
+                    mpk: params.mpk,
+                });
+                if (!hasSnapshot) {
+                    // First time - compute and persist
+                    await computeAndPersist({
+                        chainId: params.chainId,
+                        mpk: params.mpk,
+                    });
+                }
+            }
+            // Always read from storage
+            const stored = await stateStore.listHistoryEntries({
+                chainId: params.chainId,
+                mpk: params.mpk,
+            });
+            return params.includeSelfSends
+                ? stored
+                : stored.filter((e) => e.kind !== "SelfSend");
+        },
+    };
+}

package/dist/history/types.d.ts

@@ -0,0 +1,21 @@
+export type HistoryKind = "Deposit" | "Receive" | "Send" | "SelfSend" | "Withdraw";
+export type HistoryAmount = {
+    token: string;
+    /** Signed amount delta as a base-10 bigint string (positive receive, negative send). */
+    delta: string;
+};
+export type HistoryStatus = "confirmed" | "pending" | "failed";
+export type HistoryEntry = {
+    /** Stable-ish identifier for de-duplication within a single SDK session. */
+    id: string;
+    chainId: number;
+    mpk: string;
+    txHash: string;
+    kind: HistoryKind;
+    status: HistoryStatus;
+    /** Timestamp in ms when known. */
+    timestamp?: number;
+    amounts: HistoryAmount[];
+    details?: Record<string, unknown>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../history/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG;IACzB,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./constants.js";
 export * from "./types.js";
 export * from "./errors.js";
 export * from "./keys.js";
@@ -7,12 +8,18 @@ export * from "./core.js";
 export * from "./state/index.js";
 export * from "./utils/validators.js";
 export * from "./utils/bigint.js";
-export * from "./account/zkAccount.js";
-export * from "./key-derivation/index.js";
+export * from "./utils/secure-memory.js";
+export * from "./utils/amounts.js";
+export * from "./utils/notes.js";
+export * from "./utils/format.js";
+export * from "./account/account.js";
+export * from "./keys/index.js";
+export * from "./history/index.js";
 export * from "./transactions/index.js";
-export { createJobReconciler } from "./transactions/reconcile.js";
-export { serviceConfig } from "./config.js";
-export type { ServiceConfig } from "./config.js";
+export { createServiceConfig, fetchEnvironmentConfig } from "./config.js";
+export type { Environment, EnvironmentConfig, ServiceConfig, } from "./config.js";
 export * from "./clients/broadcaster.js";
 export * from "./clients/indexer.js";
+export { HttpError } from "./clients/http.js";
+export * from "./crypto-adapters/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export * from "./constants.js";
 export * from "./types.js";
 export * from "./errors.js";
 export * from "./keys.js";
@@ -7,10 +8,16 @@ export * from "./core.js";
 export * from "./state/index.js";
 export * from "./utils/validators.js";
 export * from "./utils/bigint.js";
-export * from "./account/zkAccount.js";
-export * from "./key-derivation/index.js";
+export * from "./utils/secure-memory.js";
+export * from "./utils/amounts.js";
+export * from "./utils/notes.js";
+export * from "./utils/format.js";
+export * from "./account/account.js";
+export * from "./keys/index.js";
+export * from "./history/index.js";
 export * from "./transactions/index.js";
-export { createJobReconciler } from "./transactions/reconcile.js";
-export { serviceConfig } from "./config.js";
+export { createServiceConfig, fetchEnvironmentConfig } from "./config.js";
 export * from "./clients/broadcaster.js";
 export * from "./clients/indexer.js";
+export { HttpError } from "./clients/http.js";
+export * from "./crypto-adapters/index.js";

package/dist/keys/address.d.ts

@@ -0,0 +1,13 @@
+export type Chain = {
+    type: number;
+    id: number;
+};
+export type AddressData = {
+    masterPublicKey: bigint;
+    viewingPublicKey: Uint8Array;
+    chain?: Chain;
+    version?: number;
+};
+export declare function encodeAddress(data: AddressData): string;
+export declare function decodeAddress(address: string): AddressData;
+//# sourceMappingURL=address.d.ts.map

package/dist/keys/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../keys/address.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,WAAW,GAAG;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAgCF,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAUvD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAqB1D"}

package/dist/keys/address.js

@@ -0,0 +1,55 @@
+import { bech32m } from "@scure/base";
+import { ValidationError } from "../errors.js";
+import { FieldSize, Hex } from "./hex.js";
+const VERSION = 1;
+const LIMIT = 127;
+const ALL_CHAINS = "ffffffffffffffff";
+const PREFIX = "0zk";
+const SALT = new TextEncoder().encode("unlink");
+function xorWithSalt(hex) {
+    const bytes = Hex.toBytes(hex);
+    const result = new Uint8Array(bytes.length);
+    for (let i = 0; i < bytes.length; i++)
+        result[i] = bytes[i] ^ SALT[i % SALT.length];
+    return Hex.fromBytes(result);
+}
+function chainToHex(chain) {
+    if (!chain)
+        return ALL_CHAINS;
+    return ((chain.type & 0xff).toString(16).padStart(2, "0") +
+        BigInt(chain.id).toString(16).padStart(14, "0"));
+}
+function hexToChain(hex) {
+    if (hex === ALL_CHAINS)
+        return undefined;
+    return {
+        type: parseInt(hex.slice(0, 2), 16),
+        id: parseInt(hex.slice(2), 16),
+    };
+}
+export function encodeAddress(data) {
+    const ver = (data.version ?? VERSION).toString(16).padStart(2, "0");
+    const mpk = Hex.fromBigInt(data.masterPublicKey, FieldSize.SCALAR);
+    const vpk = Hex.padToSize(data.viewingPublicKey, FieldSize.SCALAR);
+    const net = xorWithSalt(chainToHex(data.chain));
+    return bech32m.encode(PREFIX, bech32m.toWords(Hex.toBytes(`${ver}${mpk}${net}${vpk}`)), LIMIT);
+}
+export function decodeAddress(address) {
+    if (!address)
+        throw new ValidationError("No address to decode");
+    const decoded = bech32m.decode(address, LIMIT);
+    if (decoded.prefix !== PREFIX)
+        throw new ValidationError("Invalid address prefix");
+    const hex = Hex.encode(bech32m.fromWords(decoded.words));
+    if (hex.length !== 146)
+        throw new ValidationError("Incorrect address payload length");
+    const version = parseInt(hex.slice(0, 2), 16);
+    if (version !== VERSION)
+        throw new ValidationError("Incorrect address version");
+    return {
+        version,
+        masterPublicKey: Hex.toBigInt(hex.slice(2, 66)),
+        viewingPublicKey: Hex.toBytes(hex.slice(82, 146)),
+        chain: hexToChain(xorWithSalt(hex.slice(66, 82))),
+    };
+}

package/dist/keys/derive.d.ts

@@ -0,0 +1,37 @@
+export type SpendingPublicKey = [bigint, bigint];
+export type SpendingKeyPair = {
+    privateKey: Uint8Array;
+    pubkey: SpendingPublicKey;
+};
+export type ViewingKeyPair = {
+    privateKey: Uint8Array;
+    pubkey: Uint8Array;
+};
+export type AccountKeys = {
+    spending: SpendingKeyPair;
+    viewing: ViewingKeyPair;
+    nullifyingKey: bigint;
+    masterPublicKey: bigint;
+};
+/**
+ * Derive spending key pair (BabyJubJub) for an account.
+ */
+export declare function deriveSpendingKeyPair(seed: Uint8Array, index: number): SpendingKeyPair;
+/**
+ * Derive viewing key pair (Ed25519) for an account.
+ */
+export declare function deriveViewingKeyPair(seed: Uint8Array, index: number): Promise<ViewingKeyPair>;
+/**
+ * Compute nullifying key from viewing private key using Poseidon hash.
+ */
+export declare function computeNullifyingKey(viewingPrivateKey: Uint8Array): bigint;
+/**
+ * Compute master public key from spending public key and nullifying key.
+ * MPK = Poseidon(spendingPubkey[0], spendingPubkey[1], nullifyingKey)
+ */
+export declare function computeMasterPublicKey(spendingPubkey: SpendingPublicKey, nullifyingKey: bigint): bigint;
+/**
+ * Derive all account keys from a seed.
+ */
+export declare function deriveAccountKeys(seed: Uint8Array, index: number): Promise<AccountKeys>;
+//# sourceMappingURL=derive.d.ts.map

package/dist/keys/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../keys/derive.ts"],"names":[],"mappings":"AAgCA,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE5E,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAwDF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,eAAe,CAKjB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAKzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,iBAAiB,EAAE,UAAU,GAAG,MAAM,CAK1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,iBAAiB,EACjC,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAUtB"}