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

package/dist/config.js

@@ -1,36 +0,0 @@
-/**
- * Environment types for SDK configuration.
- */
-import { InitializationError } from "./errors.js";
-const CONFIG_URL = "https://api.unlink.xyz/config/networks.json";
-/**
- * Fetch environment configuration from the hosted network config file.
- *
- * @param env - The environment to fetch config for
- * @returns Promise resolving to the environment configuration
- * @throws If fetch fails or environment is not found
- */
-export async function fetchEnvironmentConfig(env) {
-    const res = await fetch(CONFIG_URL);
-    if (!res.ok) {
-        throw new InitializationError(`Failed to fetch SDK config: ${res.status}`);
-    }
-    const config = (await res.json());
-    if (!config[env]) {
-        throw new InitializationError(`Unknown environment: ${env}`);
-    }
-    return config[env];
-}
-/**
- * Create service configuration from an RPC URL.
- *
- * @param rpcUrl - The base RPC URL
- * @returns Service configuration with broadcaster and indexer URLs
- */
-export function createServiceConfig(rpcUrl) {
-    const baseUrl = rpcUrl.replace(/\/+$/, "");
-    return {
-        broadcasterBaseUrl: baseUrl + "/broadcaster",
-        indexerBaseUrl: baseUrl + "/indexer",
-    };
-}

package/dist/constants.js

@@ -1,5 +0,0 @@
-/**
- * Sentinel address for native ETH, matching the Solidity Constants.ETH_TOKEN.
- * Used as the token address in notes to indicate a native ETH deposit/withdrawal.
- */
-export const ETH_TOKEN = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";

package/dist/core.js

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

package/dist/crypto-adapters/auto-init.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=auto-init.d.ts.map

package/dist/crypto-adapters/auto-init.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto-init.d.ts","sourceRoot":"","sources":["../../crypto-adapters/auto-init.ts"],"names":[],"mappings":""}

package/dist/crypto-adapters/auto-init.js

@@ -1,7 +0,0 @@
-/**
- * Auto-initialization module for tests.
- * Import this at the top of test files to automatically initialize crypto, not in production code.
- */
-import { initCrypto } from "./index.js";
-await initCrypto();
-console.log("[crypto] Auto-initialized for tests");

package/dist/crypto-adapters/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * Crypto adapters for browser-compatible cryptographic operations.
- *
- * Exports:
- * - poseidon: Poseidon hash from circomlibjs (iden3)
- * - deriveSpendingPublicKey, signMessage, verifySignature: EdDSA from @zk-kit/eddsa-poseidon
- * - initCrypto: Async function to initialize crypto primitives (must be called before using poseidon)
- */
-import "./polyfills.js";
-/**
- * Initialize the crypto primitives (Poseidon hash function).
- * This must be called before using the poseidon function.
- * Safe to call multiple times - subsequent calls return the same promise.
- */
-export declare function initCrypto(): Promise<void>;
-/**
- * Poseidon hash function compatible with circomlib circuits.
- * Wraps circomlibjs buildPoseidon to return bigint directly.
- */
-export declare const poseidon: (inputs: (bigint | number)[]) => bigint;
-export { derivePublicKey as deriveSpendingPublicKey, signMessage, verifySignature, } from "@zk-kit/eddsa-poseidon";
-//# sourceMappingURL=index.d.ts.map

package/dist/crypto-adapters/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../crypto-adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,gBAAgB,CAAC;AAWxB;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAehD;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAG,MAQtD,CAAC;AAEF,OAAO,EACL,eAAe,IAAI,uBAAuB,EAC1C,WAAW,EACX,eAAe,GAChB,MAAM,wBAAwB,CAAC"}

package/dist/crypto-adapters/index.js

@@ -1,47 +0,0 @@
-/**
- * Crypto adapters for browser-compatible cryptographic operations.
- *
- * Exports:
- * - poseidon: Poseidon hash from circomlibjs (iden3)
- * - deriveSpendingPublicKey, signMessage, verifySignature: EdDSA from @zk-kit/eddsa-poseidon
- * - initCrypto: Async function to initialize crypto primitives (must be called before using poseidon)
- */
-// Polyfill must be the first import
-import "./polyfills.js";
-import { InitializationError } from "../errors.js";
-let _poseidon = null;
-let _initPromise = null;
-/**
- * Initialize the crypto primitives (Poseidon hash function).
- * This must be called before using the poseidon function.
- * Safe to call multiple times - subsequent calls return the same promise.
- */
-export async function initCrypto() {
-    if (_poseidon)
-        return; // Already initialized
-    if (_initPromise)
-        return _initPromise; // Initialization in progress
-    _initPromise = (async () => {
-        try {
-            const { buildPoseidon } = await import("circomlibjs");
-            _poseidon = await buildPoseidon();
-        }
-        catch (error) {
-            _initPromise = null; // Reset to allow retry
-            throw error;
-        }
-    })();
-    return _initPromise;
-}
-/**
- * Poseidon hash function compatible with circomlib circuits.
- * Wraps circomlibjs buildPoseidon to return bigint directly.
- */
-export const poseidon = (inputs) => {
-    if (!_poseidon) {
-        throw new InitializationError("Crypto not initialized. Call initCrypto() before using poseidon().");
-    }
-    const hash = _poseidon(inputs);
-    return _poseidon.F.toObject(hash);
-};
-export { derivePublicKey as deriveSpendingPublicKey, signMessage, verifySignature, } from "@zk-kit/eddsa-poseidon";

package/dist/crypto-adapters/polyfills.d.ts

@@ -1,5 +0,0 @@
-/**
- * Browser polyfills for Node.js-specific APIs used by circomlibjs.
- */
-export {};
-//# sourceMappingURL=polyfills.d.ts.map

package/dist/crypto-adapters/polyfills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../../crypto-adapters/polyfills.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/crypto-adapters/polyfills.js

@@ -1,8 +0,0 @@
-/**
- * Browser polyfills for Node.js-specific APIs used by circomlibjs.
- */
-import { Buffer } from "buffer";
-// Make Buffer available globally for circomlibjs
-if (typeof globalThis.Buffer === "undefined") {
-    globalThis.Buffer = Buffer;
-}

package/dist/errors.js

@@ -1,36 +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";
-    }
-}
-export class ValidationError extends CoreError {
-    constructor(message) {
-        super(message);
-        this.name = "ValidationError";
-    }
-}
-export class ProofError extends CoreError {
-    constructor(message) {
-        super(message);
-        this.name = "ProofError";
-    }
-}
-export class InitializationError extends CoreError {
-    constructor(message) {
-        super(message);
-        this.name = "InitializationError";
-    }
-}

package/dist/history/index.js

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

package/dist/history/service.js

@@ -1,354 +0,0 @@
-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.js

@@ -1 +0,0 @@
-export {};

package/dist/keys/address.js

@@ -1,55 +0,0 @@
-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))),
-    };
-}