@unlink-xyz/core 0.1.3 → 0.1.4

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

@@ -1,19 +0,0 @@
-export declare enum ByteLength {
-    UINT_256 = 32,
-    UINT_512 = 64
-}
-export type BytesData = string | number | bigint | Uint8Array | ArrayLike<number>;
-export declare class ByteUtils {
-    static prefix0x(value: string): string;
-    static strip0x(value: string): string;
-    static hexlify(data: BytesData): string;
-    static bytesToHex(bytes: Uint8Array): string;
-    static hexStringToBytes(hex: string): Uint8Array;
-    static arrayify(data: BytesData): Uint8Array;
-    static hexToBigInt(hex: string): bigint;
-    static padToLength(data: BytesData, length: number, side?: "left" | "right"): string;
-    static formatToByteLength(data: BytesData, length: ByteLength): string;
-    static nToHex(value: bigint, length: ByteLength, prefix?: boolean): string;
-}
-export declare function fromUTF8String(value: string): string;
-//# sourceMappingURL=bytes.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../key-derivation/bytes.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,QAAQ,KAAK;IACb,QAAQ,KAAK;CACd;AAED,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,MAAM,GACN,UAAU,GACV,SAAS,CAAC,MAAM,CAAC,CAAC;AAkBtB,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAItC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIrC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAavC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAQ5C,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAUhD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU;IAa5C,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIvC,MAAM,CAAC,WAAW,CAChB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,GAAG,OAAgB,GAC9B,MAAM;IAWT,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;IAQtE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAQ,GAAG,MAAM;CAIzE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/key-derivation/bytes.js

@@ -1,92 +0,0 @@
-export var ByteLength;
-(function (ByteLength) {
-    ByteLength[ByteLength["UINT_256"] = 32] = "UINT_256";
-    ByteLength[ByteLength["UINT_512"] = 64] = "UINT_512";
-})(ByteLength || (ByteLength = {}));
-const HEX_REGEX = /^[0-9a-f]*$/i;
-const isPrefixed = (value) => value.startsWith("0x");
-const assertEvenLength = (hex) => {
-    if (hex.length % 2 !== 0) {
-        throw new Error("Hex string must have an even length");
-    }
-};
-const assertHex = (hex) => {
-    if (!HEX_REGEX.test(hex)) {
-        throw new Error("Invalid hex string");
-    }
-};
-export class ByteUtils {
-    static prefix0x(value) {
-        return isPrefixed(value) ? value : `0x${value}`;
-    }
-    static strip0x(value) {
-        return isPrefixed(value) ? value.slice(2) : value;
-    }
-    static hexlify(data) {
-        if (typeof data === "string") {
-            return ByteUtils.strip0x(data).toLowerCase();
-        }
-        if (typeof data === "number" || typeof data === "bigint") {
-            if (data < 0)
-                throw new Error("Cannot hexlify negative values");
-            const hex = data.toString(16);
-            return hex.length % 2 === 0 ? hex : `0${hex}`;
-        }
-        const view = data instanceof Uint8Array ? data : Uint8Array.from(data);
-        return ByteUtils.bytesToHex(view);
-    }
-    static bytesToHex(bytes) {
-        let hex = "";
-        for (const byte of bytes) {
-            hex += byte.toString(16).padStart(2, "0");
-        }
-        return hex;
-    }
-    static hexStringToBytes(hex) {
-        const normalized = ByteUtils.strip0x(hex).toLowerCase();
-        assertEvenLength(normalized);
-        assertHex(normalized);
-        const byteLength = normalized.length / 2;
-        return Uint8Array.from({ length: byteLength }, (_, index) => parseInt(normalized.slice(index * 2, index * 2 + 2), 16));
-    }
-    static arrayify(data) {
-        if (data instanceof Uint8Array) {
-            return new Uint8Array(data);
-        }
-        if (typeof data === "string") {
-            return ByteUtils.hexStringToBytes(data);
-        }
-        if (typeof data === "number" || typeof data === "bigint") {
-            return ByteUtils.hexStringToBytes(ByteUtils.hexlify(data));
-        }
-        return Uint8Array.from(data);
-    }
-    static hexToBigInt(hex) {
-        return BigInt(`0x${ByteUtils.strip0x(hex)}`);
-    }
-    static padToLength(data, length, side = "left") {
-        const hex = ByteUtils.hexlify(data);
-        const targetLength = length * 2;
-        if (hex.length > targetLength) {
-            throw new Error("Cannot pad data that exceeds target length");
-        }
-        return side === "left"
-            ? hex.padStart(targetLength, "0")
-            : hex.padEnd(targetLength, "0");
-    }
-    static formatToByteLength(data, length) {
-        const hex = ByteUtils.hexlify(data);
-        if (hex.length > length * 2) {
-            return hex.slice(0, length * 2);
-        }
-        return hex.padStart(length * 2, "0");
-    }
-    static nToHex(value, length, prefix = false) {
-        const hex = value.toString(16).padStart(length * 2, "0");
-        return prefix ? `0x${hex}` : hex;
-    }
-}
-export function fromUTF8String(value) {
-    const encoder = new TextEncoder();
-    return ByteUtils.hexlify(encoder.encode(value));
-}

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

@@ -1,3 +0,0 @@
-import { BytesData } from "./bytes.js";
-export declare function sha512HMAC(key: BytesData, data: BytesData): string;
-//# sourceMappingURL=hash.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../key-derivation/hash.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AAMlD,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAGlE"}

package/dist/key-derivation/hash.js

@@ -1,10 +0,0 @@
-import { hmac } from "@noble/hashes/hmac";
-import { sha512 } from "@noble/hashes/sha2";
-import { ByteUtils } from "./bytes.js";
-const toBytes = (data) => {
-    return ByteUtils.arrayify(data);
-};
-export function sha512HMAC(key, data) {
-    const mac = hmac(sha512, toBytes(key), toBytes(data));
-    return ByteUtils.bytesToHex(mac);
-}

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

@@ -1,8 +0,0 @@
-export * from "./babyjubjub.js";
-export * from "./bip32.js";
-export * from "./bip39.js";
-export * from "./bech32.js";
-export * from "./bytes.js";
-export * from "./hash.js";
-export * from "./wallet-node.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../key-derivation/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/key-derivation/index.js

@@ -1,7 +0,0 @@
-export * from "./babyjubjub.js";
-export * from "./bip32.js";
-export * from "./bip39.js";
-export * from "./bech32.js";
-export * from "./bytes.js";
-export * from "./hash.js";
-export * from "./wallet-node.js";

package/dist/key-derivation/wallet-node.d.ts

@@ -1,45 +0,0 @@
-import { KeyNode } from "./bip32.js";
-export type SpendingPublicKey = [bigint, bigint];
-export type SpendingKeyPair = {
-    privateKey: Uint8Array;
-    pubkey: SpendingPublicKey;
-};
-export type ViewingKeyPair = {
-    privateKey: Uint8Array;
-    pubkey: Uint8Array;
-};
-export type WalletNodes = {
-    spending: WalletNode;
-    viewing: WalletNode;
-};
-export declare const deriveNodes: (mnemonic: string, index?: number) => WalletNodes;
-export declare const deriveNodesFromSeed: (seed: Uint8Array, index?: number) => WalletNodes;
-export declare class WalletNode {
-    private readonly chainKey;
-    private readonly chainCode;
-    constructor(node: KeyNode);
-    static fromMnemonic(mnemonic: string): WalletNode;
-    /**
-     * Convenience constructor for callers that already hold a seed or mnemonic-derived hex.
-     */
-    static fromSeed(seed: Uint8Array | string): WalletNode;
-    /**
-     * Traverse a derivation path, returning the resulting hardened node.
-     */
-    derive(path: string): WalletNode;
-    /**
-     * Derive the BabyJubJub spending key pair (private scalar + affine point).
-     */
-    getSpendingKeyPair(): SpendingKeyPair;
-    static getMasterPublicKey(spendingPublicKey: SpendingPublicKey, nullifyingKey: bigint): bigint;
-    static getNullifyingKey(viewingPrivateKey: Uint8Array): bigint;
-    /**
-     * Derive the Ed25519 viewing key pair for encrypted note retrieval.
-     */
-    getViewingKeyPair(): Promise<ViewingKeyPair>;
-    /**
-     * Compute the Poseidon-based nullifying key used in note nullifier generation.
-     */
-    getNullifyingKey(): Promise<bigint>;
-}
-//# sourceMappingURL=wallet-node.d.ts.map

package/dist/key-derivation/wallet-node.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wallet-node.d.ts","sourceRoot":"","sources":["../../key-derivation/wallet-node.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,OAAO,EACR,MAAM,YAAY,CAAC;AASpB,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;AAgB5E,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAExE,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,EAChB,QAAO,MAAU,KAChB,WAOF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,UAAU,EAChB,QAAO,MAAU,KAChB,WAOF,CAAC;AAEF,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,OAAO;IAKzB,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU;IAKjD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU;IAQtD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAUhC;;OAEG;IACH,kBAAkB,IAAI,eAAe;IASrC,MAAM,CAAC,kBAAkB,CACvB,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,MAAM,GACpB,MAAM;IAIT,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,UAAU,GAAG,MAAM;IAW9D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;IASlD;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAI1C"}

package/dist/key-derivation/wallet-node.js

@@ -1,109 +0,0 @@
-import { Buffer } from "buffer";
-import { getPublicKey, hashes } from "@noble/ed25519";
-import { sha512 } from "@noble/hashes/sha2";
-import { eddsa, poseidon } from "@railgun-community/circomlibjs";
-import { childKeyDerivationHardened, getMasterKeyFromSeed, getPathSegments, } from "./bip32.js";
-import { Mnemonic } from "./bip39.js";
-import { ByteUtils } from "./bytes.js";
-hashes.sha512 = sha512;
-hashes.sha512Async = async (message) => sha512(message);
-const HARDENED_OFFSET = 0x80000000;
-/**
- * Hardened base paths for spending/viewing keys. The final path becomes
- * m/.../{index}' for each account slot.
- */
-const DERIVATION_PATH_PREFIXES = {
-    SPENDING: "m/44'/1984'/0'/0'/",
-    VIEWING: "m/420'/1984'/0'/0'/",
-};
-const derivePathsForIndex = (index = 0) => ({
-    spending: `${DERIVATION_PATH_PREFIXES.SPENDING}${index}'`,
-    viewing: `${DERIVATION_PATH_PREFIXES.VIEWING}${index}'`,
-});
-export const deriveNodes = (mnemonic, index = 0) => {
-    const paths = derivePathsForIndex(index);
-    const root = WalletNode.fromMnemonic(mnemonic);
-    return {
-        spending: root.derive(paths.spending),
-        viewing: root.derive(paths.viewing),
-    };
-};
-export const deriveNodesFromSeed = (seed, index = 0) => {
-    const paths = derivePathsForIndex(index);
-    const root = WalletNode.fromSeed(seed);
-    return {
-        spending: root.derive(paths.spending),
-        viewing: root.derive(paths.viewing),
-    };
-};
-export class WalletNode {
-    chainKey;
-    chainCode;
-    constructor(node) {
-        this.chainKey = node.chainKey;
-        this.chainCode = node.chainCode;
-    }
-    static fromMnemonic(mnemonic) {
-        const seedHex = Mnemonic.toSeed(mnemonic);
-        return new WalletNode(getMasterKeyFromSeed(seedHex));
-    }
-    /**
-     * Convenience constructor for callers that already hold a seed or mnemonic-derived hex.
-     */
-    static fromSeed(seed) {
-        const seedHex = typeof seed === "string"
-            ? ByteUtils.hexlify(seed)
-            : ByteUtils.bytesToHex(seed);
-        return new WalletNode(getMasterKeyFromSeed(seedHex));
-    }
-    /**
-     * Traverse a derivation path, returning the resulting hardened node.
-     */
-    derive(path) {
-        const segments = getPathSegments(path);
-        const derived = segments.reduce((parent, segment) => childKeyDerivationHardened(parent, segment, HARDENED_OFFSET), { chainKey: this.chainKey, chainCode: this.chainCode });
-        return new WalletNode(derived);
-    }
-    /**
-     * Derive the BabyJubJub spending key pair (private scalar + affine point).
-     */
-    getSpendingKeyPair() {
-        const privateKey = ByteUtils.hexStringToBytes(this.chainKey);
-        if (privateKey.length !== 32) {
-            throw new Error("Spending private key must be 32 bytes");
-        }
-        const pubkey = eddsa.prv2pub(Buffer.from(privateKey));
-        return { privateKey, pubkey };
-    }
-    static getMasterPublicKey(spendingPublicKey, nullifyingKey) {
-        return poseidon([...spendingPublicKey, nullifyingKey]);
-    }
-    static getNullifyingKey(viewingPrivateKey) {
-        if (!(viewingPrivateKey instanceof Uint8Array)) {
-            throw new Error("Viewing private key must be a Uint8Array");
-        }
-        if (viewingPrivateKey.length !== 32) {
-            throw new Error("Viewing private key must be 32 bytes");
-        }
-        const privateKeyHex = ByteUtils.bytesToHex(viewingPrivateKey);
-        return poseidon([ByteUtils.hexToBigInt(privateKeyHex)]);
-    }
-    /**
-     * Derive the Ed25519 viewing key pair for encrypted note retrieval.
-     */
-    async getViewingKeyPair() {
-        const privateKey = ByteUtils.hexStringToBytes(this.chainKey);
-        if (privateKey.length !== 32) {
-            throw new Error("Viewing private key must be 32 bytes");
-        }
-        const pubkey = await getPublicKey(privateKey);
-        return { privateKey, pubkey };
-    }
-    /**
-     * Compute the Poseidon-based nullifying key used in note nullifier generation.
-     */
-    async getNullifyingKey() {
-        const { privateKey } = await this.getViewingKeyPair();
-        return WalletNode.getNullifyingKey(privateKey);
-    }
-}

package/dist/keys.js

@@ -1,41 +0,0 @@
-import { KeyValidationError } from "./errors.js";
-export const RESERVED_PREFIXES = [
-    "meta:",
-    "notes:",
-    "leaves:",
-    "roots:",
-    "nullifiers:",
-    "ciphertexts:",
-    "jobs:",
-    "proof_cache:",
-    "cfg:",
-    "idx:",
-    "locks:",
-];
-/** Canonical builders for storage key namespaces used across core */
-export const keys = {
-    note: (c, i) => `notes:${c}:${i}`,
-    leaf: (c, i) => `leaves:${c}:${i}`,
-    ciphertext: (c, i) => `ciphertexts:${c}:${i}`,
-    /** Track note indices that remain unspent for a given master public key (mpk acts as the account identifier). */
-    unspent: (c, mpk, i) => `idx:notes:unspent:${c}:${mpk}:${i}`,
-    unspentPrefix: (c, mpk) => `idx:notes:unspent:${c}:${mpk}:`,
-    nullifierObs: (c, n) => `nullifiers:${c}:${n}`,
-    nullToIndex: (c, n) => `idx:nullifier:${c}:${n}`,
-    nullifier: (c, n) => `nullifiers:${c}:${n}`,
-    root: (c, value) => `roots:${c}:${value}`,
-    latestRoot: (c) => `roots:latest:${c}`,
-    rootCursor: (c) => `meta:roots:cursor:${c}`,
-    cursor: (c) => `meta:sync:cursors:${c}`,
-    aggregate: (c, a) => `idx:notes:agg:${c}:${a}`,
-    job: (relayId) => `jobs:${relayId}`,
-};
-export const MAX_KEY_LEN = 512;
-export function validateKey(key) {
-    if (!key)
-        throw new KeyValidationError("key must not be empty");
-    if (key.length > MAX_KEY_LEN)
-        throw new KeyValidationError(`key exceeds ${MAX_KEY_LEN}`);
-    if (!RESERVED_PREFIXES.some((p) => key.startsWith(p)))
-        throw new KeyValidationError("key must start with a reserved namespace prefix");
-}

package/dist/prover/config.js

@@ -1,80 +0,0 @@
-/**
- * Configuration for the prover system
- * Handles artifact loading from local files or remote artifact server
- */
-/**
- * Default configuration
- * Can be overridden via environment variables
- */
-export const DEFAULT_CONFIG = {
-    rpcUrl: typeof process !== "undefined" && process.env?.UNLINK_RPC_URL
-        ? process.env.UNLINK_RPC_URL
-        : "http://localhost:3000",
-    enableCache: true,
-};
-/**
- * Artifact file types
- */
-export var ArtifactType;
-(function (ArtifactType) {
-    ArtifactType["WASM"] = "joinsplit.wasm";
-    ArtifactType["ZKEY"] = "joinsplit.zkey";
-    ArtifactType["VKEY"] = "joinsplit.vkey.json";
-})(ArtifactType || (ArtifactType = {}));
-/**
- * Build artifact URL for a given circuit and artifact type
- * @param circuitName Full circuit name (e.g., "joinsplit_2x3_16")
- * @param artifactType Type of artifact to fetch
- * @param baseUrl Base URL of the artifact server
- * @returns Full URL to the artifact
- */
-export function buildArtifactUrl(circuitName, artifactType, baseUrl = DEFAULT_CONFIG.rpcUrl) {
-    // Remove trailing slash from baseUrl
-    const cleanBaseUrl = baseUrl.replace(/\/$/, "");
-    return `${cleanBaseUrl}/artifacts/${circuitName}/${artifactType}`;
-}
-/**
- * Get relative path for local artifact loading
- * Used in Node.js environment when artifacts are bundled
- * @param circuitName Full circuit name (e.g., "joinsplit_2x3_16")
- * @param artifactType Type of artifact
- * @returns Relative path to artifact
- */
-export function getLocalArtifactPath(circuitName, artifactType) {
-    // Return multiple candidate paths for different build scenarios
-    return [
-        // When compiled: dist/prover/ -> ../../artifacts/circuits/{circuit}/
-        `../../artifacts/circuits/${circuitName}/${artifactType}`,
-        // When in source: prover/ -> ../artifacts/circuits/{circuit}/
-        `../artifacts/circuits/${circuitName}/${artifactType}`,
-    ];
-}
-/**
- * Runtime detection utilities
- */
-export const Runtime = {
-    /**
-     * Check if running in browser environment
-     */
-    isBrowser() {
-        return typeof window !== "undefined" && typeof document !== "undefined";
-    },
-    /**
-     * Check if running in Node.js environment
-     */
-    isNode() {
-        return (typeof process !== "undefined" &&
-            process.versions != null &&
-            process.versions.node != null);
-    },
-    /**
-     * Get environment description for debugging
-     */
-    getEnvironment() {
-        if (this.isBrowser())
-            return "browser";
-        if (this.isNode())
-            return "node";
-        return "unknown";
-    },
-};

package/dist/prover/index.js

@@ -1 +0,0 @@
-export * from "./prover.js";