@miradexio/client 0.1.0

package/dist/lib/errors.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Unified error taxonomy for the miradex-client SDK.
+ *
+ * Every error thrown out of the SDK is either a {@link MiradexError} subclass
+ * (carrying a `category`) or a foreign error that {@link classifyError} can
+ * map to a category. The category drives retry policy via {@link withRetry}.
+ *
+ * Cross-platform: this module uses only platform-neutral primitives (`Error`,
+ * `TypeError`, `DOMException`). It never references Node-only APIs (`Buffer`,
+ * `process`, `fs`) and never assumes a particular fetch implementation. Both
+ * the browser and Node 20+ runtimes throw `TypeError("fetch failed")` /
+ * `DOMException("AbortError")` for the same underlying conditions, so a single
+ * classifier covers both.
+ *
+ * Category meaning:
+ *  - `network`        : transient — DNS, TLS, connection reset, fetch timeout. Retry indefinitely.
+ *  - `server`         : HTTP 5xx. Server fault, retry indefinitely.
+ *  - `rate-limit`     : HTTP 429. Server-controlled throttling. Bounded retry.
+ *  - `client-bounded` : HTTP 4xx that may resolve on retry (404 freshly-created, 408, 409, 422). Bounded retry.
+ *  - `client-fatal`   : HTTP 4xx that won't resolve (400, 401, 403, 405, 410, ...). Fail immediately.
+ *  - `protocol`       : Contract violation (schema mismatch, missing required field). Fail immediately.
+ *  - `verification`   : Independent crypto/security check failed. Fail immediately.
+ *  - `cancelled`      : User/engine cancellation. Propagate.
+ *  - `unknown`        : Unclassified. Bounded retry as a safety net.
+ */
+export type ErrorCategory = 'network' | 'server' | 'rate-limit' | 'client-bounded' | 'client-fatal' | 'protocol' | 'verification' | 'cancelled' | 'unknown';
+export interface MiradexErrorOptions {
+    readonly cause?: unknown;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Base for every error the SDK emits. Subclasses set `name` and `category`.
+ * `cause` and `details` are optional and travel with the error for diagnostics.
+ */
+export declare class MiradexError extends Error {
+    readonly name: string;
+    readonly category: ErrorCategory;
+    readonly details: Readonly<Record<string, unknown>> | undefined;
+    readonly cause: unknown;
+    constructor(message: string, category: ErrorCategory, options?: MiradexErrorOptions);
+}
+/**
+ * Determine the retry category for any value thrown from the SDK boundary.
+ *
+ * Already-classified {@link MiradexError}s short-circuit. Everything else is
+ * matched against the platform-neutral fingerprints of fetch / DNS / TLS
+ * failures.
+ */
+export declare function classifyError(err: unknown): ErrorCategory;
+/** Convenience: shorthand string from an unknown thrown value. */
+export declare function errorMessage(err: unknown): string;
+/**
+ * User / engine cancellation. Raised when an `AbortSignal` aborts an
+ * in-flight retry loop or a long-running drive call.
+ */
+export declare class SwapCancelledError extends MiradexError {
+    readonly name = "SwapCancelledError";
+    constructor(message?: string);
+}
+/**
+ * Transient network / fetch failure. The category is always `'network'`,
+ * which means {@link withRetry} retries indefinitely with capped backoff.
+ */
+export declare class NetworkError extends MiradexError {
+    readonly name = "NetworkError";
+    constructor(message: string, options?: MiradexErrorOptions);
+}
+/**
+ * HTTP-level error. The {@link MiradexError.category} is derived from the
+ * status code + server-emitted error code, so a single class covers the four
+ * HTTP categories (`client-bounded`, `client-fatal`, `rate-limit`, `server`)
+ * while keeping `instanceof ApiError` working for legacy callers.
+ *
+ * Special case: `code === 'SCHEMA_MISMATCH'` is `protocol` regardless of
+ * status, because a schema mismatch indicates a code-level contract violation
+ * — retrying will not fix it.
+ */
+export declare class ApiError extends MiradexError {
+    readonly name = "ApiError";
+    readonly statusCode: number;
+    readonly code: string;
+    constructor(message: string, statusCode: number, code: string, options?: MiradexErrorOptions);
+}
+/** Map an HTTP status + server code to a retry category. */
+export declare function deriveApiCategory(statusCode: number, code: string): ErrorCategory;
+/** Whether the SDK should retry this error at all. */
+export declare function isRetryable(err: unknown): boolean;
+/** Whether the SDK should retry this error indefinitely (capped backoff). */
+export declare function isUnboundedRetry(err: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,gBAAgB,GAChB,cAAc,GACd,UAAU,GACV,cAAc,GACd,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAkB,IAAI,EAAE,MAAM,CAAkB;IAChD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAChE,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAMpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CA+BzD;AASD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGjD;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,SAAkB,IAAI,wBAAwB;gBAClC,OAAO,SAA2B;CAG/C;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,SAAkB,IAAI,kBAAkB;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAG3D;AAED;;;;;;;;;GASG;AACH,qBAAa,QAAS,SAAQ,YAAY;IACxC,SAAkB,IAAI,cAAc;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB;CAMhC;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQjF;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGjD;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGtD"}

package/dist/lib/errors.js

@@ -0,0 +1,129 @@
+/**
+ * Base for every error the SDK emits. Subclasses set `name` and `category`.
+ * `cause` and `details` are optional and travel with the error for diagnostics.
+ */
+export class MiradexError extends Error {
+    name = 'MiradexError';
+    category;
+    details;
+    cause;
+    constructor(message, category, options) {
+        super(message);
+        this.category = category;
+        this.cause = options?.cause;
+        this.details = options?.details;
+    }
+}
+/**
+ * Determine the retry category for any value thrown from the SDK boundary.
+ *
+ * Already-classified {@link MiradexError}s short-circuit. Everything else is
+ * matched against the platform-neutral fingerprints of fetch / DNS / TLS
+ * failures.
+ */
+export function classifyError(err) {
+    if (err instanceof MiradexError)
+        return err.category;
+    // Native fetch failure (undici on Node, browser fetch).
+    // Node 20+: `TypeError: fetch failed` (with .cause carrying the underlying ECONN…).
+    // Browser: `TypeError: Failed to fetch` (no cause).
+    if (err instanceof TypeError) {
+        if (/^(?:fetch failed|failed to fetch|networkerror|load failed)/i.test(err.message)) {
+            return 'network';
+        }
+    }
+    // Per-request timeout: AbortController.abort() raises DOMException('AbortError').
+    if (typeof DOMException !== 'undefined' && err instanceof DOMException && err.name === 'AbortError') {
+        return 'network';
+    }
+    if (err instanceof Error) {
+        // Last-resort fingerprinting for environments that surface Node-style
+        // codes embedded in message / cause without extending TypeError.
+        const merged = `${err.message} ${cause(err)}`.toLowerCase();
+        if (/\b(?:econnrefused|econnreset|enotfound|eai_again|etimedout|epipe|ehostunreach|enetunreach|socket hang up|getaddrinfo|other side closed|terminated)\b/.test(merged)) {
+            return 'network';
+        }
+    }
+    return 'unknown';
+}
+function cause(err) {
+    const c = err.cause;
+    if (c === undefined || c === null)
+        return '';
+    if (c instanceof Error)
+        return c.message;
+    return String(c);
+}
+/** Convenience: shorthand string from an unknown thrown value. */
+export function errorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+/**
+ * User / engine cancellation. Raised when an `AbortSignal` aborts an
+ * in-flight retry loop or a long-running drive call.
+ */
+export class SwapCancelledError extends MiradexError {
+    name = 'SwapCancelledError';
+    constructor(message = 'Swap cancelled by user') {
+        super(message, 'cancelled');
+    }
+}
+/**
+ * Transient network / fetch failure. The category is always `'network'`,
+ * which means {@link withRetry} retries indefinitely with capped backoff.
+ */
+export class NetworkError extends MiradexError {
+    name = 'NetworkError';
+    constructor(message, options) {
+        super(message, 'network', options);
+    }
+}
+/**
+ * HTTP-level error. The {@link MiradexError.category} is derived from the
+ * status code + server-emitted error code, so a single class covers the four
+ * HTTP categories (`client-bounded`, `client-fatal`, `rate-limit`, `server`)
+ * while keeping `instanceof ApiError` working for legacy callers.
+ *
+ * Special case: `code === 'SCHEMA_MISMATCH'` is `protocol` regardless of
+ * status, because a schema mismatch indicates a code-level contract violation
+ * — retrying will not fix it.
+ */
+export class ApiError extends MiradexError {
+    name = 'ApiError';
+    statusCode;
+    code;
+    constructor(message, statusCode, code, options) {
+        super(message, deriveApiCategory(statusCode, code), options);
+        this.statusCode = statusCode;
+        this.code = code;
+    }
+}
+/** Map an HTTP status + server code to a retry category. */
+export function deriveApiCategory(statusCode, code) {
+    if (code === 'SCHEMA_MISMATCH')
+        return 'protocol';
+    if (statusCode >= 500)
+        return 'server';
+    if (statusCode === 429)
+        return 'rate-limit';
+    if (statusCode === 408 || statusCode === 409 || statusCode === 422)
+        return 'client-bounded';
+    if (statusCode === 404)
+        return 'client-bounded';
+    if (statusCode >= 400)
+        return 'client-fatal';
+    return 'unknown';
+}
+/** Whether the SDK should retry this error at all. */
+export function isRetryable(err) {
+    const c = classifyError(err);
+    return c !== 'protocol' && c !== 'verification' && c !== 'client-fatal' && c !== 'cancelled';
+}
+/** Whether the SDK should retry this error indefinitely (capped backoff). */
+export function isUnboundedRetry(err) {
+    const c = classifyError(err);
+    return c === 'network' || c === 'server';
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"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"}

package/dist/lib/format.d.ts

@@ -0,0 +1,7 @@
+export declare function formatAmount(value: string | number, maxDecimals?: number): string;
+export declare function formatDuration(seconds: number): string;
+export declare function formatEta(seconds: number): string;
+export declare function formatTimeAgo(iso: string): string;
+export declare function truncAddr(addr: string, start?: number, end?: number): string;
+export declare function bpsToPercent(bps: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,CAQ5E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,GAAG,SAAI,GAAG,MAAM,CAGlE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/lib/format.js

@@ -0,0 +1,43 @@
+export function formatAmount(value, maxDecimals = 8) {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num))
+        return '0';
+    const fixed = num.toFixed(maxDecimals).replace(/\.?0+$/, '') || '0';
+    const [int, dec] = fixed.split('.');
+    const withCommas = (int ?? '0').replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    return dec ? `${withCommas}.${dec}` : withCommas;
+}
+export function formatDuration(seconds) {
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (seconds < 3600) {
+        const m = Math.floor(seconds / 60);
+        const s = seconds % 60;
+        return s ? `${m}m ${s}s` : `${m}m`;
+    }
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    return m ? `${h}h ${m}m` : `${h}h`;
+}
+export function formatEta(seconds) {
+    return `~${formatDuration(seconds)}`;
+}
+export function formatTimeAgo(iso) {
+    const sec = Math.floor((Date.now() - new Date(iso).getTime()) / 1000);
+    if (sec < 60)
+        return `${sec}s ago`;
+    if (sec < 3600)
+        return `${Math.floor(sec / 60)}m ago`;
+    if (sec < 86400)
+        return `${Math.floor(sec / 3600)}h ago`;
+    return `${Math.floor(sec / 86400)}d ago`;
+}
+export function truncAddr(addr, start = 8, end = 6) {
+    if (addr.length <= start + end + 3)
+        return addr;
+    return `${addr.slice(0, start)}...${addr.slice(-end)}`;
+}
+export function bpsToPercent(bps) {
+    return `${(bps / 100).toFixed(2)}%`;
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"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"}

package/dist/lib/keystore.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Records how keys were derived so future code changes never break recovery.
+ */
+export interface KeystoreDerivation {
+    /** Scheme identifier (e.g. "miradex-v0") */
+    readonly scheme: string;
+    /** BIP32 derivation path used for the BTC key */
+    readonly btcPath: string;
+    /** HMAC domain string used to derive s_b from the BIP32 seed */
+    readonly scalarDomain: string;
+    /** HMAC domain string used to derive v_b from the BIP32 seed */
+    readonly viewKeyDomain: string;
+}
+/**
+ * Keystore file format v3.
+ *
+ * Adds eigenwallet_master_seed + libp2p_peer_id so a recovery binary
+ * (eigenwallet's swap CLI) can re-derive the same libp2p identity Bob used
+ * for the swap setup. Required for cross-binary recovery.
+ *
+ * Naming convention follows the atomic swap protocol:
+ *   lowercase s = private (secret scalar)
+ *   uppercase S = public (curve point)
+ */
+export interface SwapKeystore {
+    readonly version: 3;
+    readonly createdAt: string;
+    readonly warning: string;
+    /** BIP39 24-word mnemonic — THE master recovery key. Optional for pre-mnemonic keystores. */
+    readonly mnemonic?: string;
+    /** Derivation parameters used to produce all keys from the mnemonic. */
+    readonly derivation?: KeystoreDerivation;
+    readonly btc: {
+        readonly wif: string;
+        readonly address: string;
+        readonly network: 'mainnet' | 'testnet' | 'regtest';
+    };
+    readonly keys: {
+        readonly s_b: string;
+        readonly v_b: string;
+        readonly S_b_bitcoin: string;
+        readonly S_b_monero: string;
+        readonly dleq_proof: string;
+        readonly b: string;
+        readonly B: string;
+        /** 32-byte hex master seed — feeds the libp2p identity HMAC chain. */
+        readonly eigenwallet_master_seed: string;
+        /** base58btc PeerId derived from `eigenwallet_master_seed`. Cached for logs. */
+        readonly libp2p_peer_id: string;
+    };
+    readonly swap: {
+        readonly receiveAddress: string;
+        readonly refundAddress: string;
+    };
+}
+export declare function createKeystore(params: {
+    readonly wif: string;
+    readonly btcAddress: string;
+    readonly network: 'mainnet' | 'testnet' | 'regtest';
+    readonly s_b: string;
+    readonly v_b: string;
+    readonly S_b_bitcoin: string;
+    readonly S_b_monero: string;
+    readonly dleq_proof: string;
+    readonly b: string;
+    readonly B: string;
+    readonly eigenwallet_master_seed: string;
+    readonly libp2p_peer_id: string;
+    readonly receiveAddress: string;
+    readonly refundAddress: string;
+    readonly mnemonic?: string;
+    readonly derivation?: KeystoreDerivation;
+}): SwapKeystore;
+/**
+ * Parse a raw JSON string into a SwapKeystore.
+ * Handles v1, v2 (migrated), and v3 keystore formats.
+ *
+ * V2→V3 migration: existing V2 keystores have no `eigenwallet_master_seed`.
+ * The migrator stamps an empty string for both libp2p fields; recovery for
+ * those swaps is keystore-only (mnemonic still works), but the eigenwallet
+ * binary won't reproduce the original peer-id. Newly-created keystores at V3
+ * have the field populated.
+ */
+export declare function parseKeystore(rawJson: string): SwapKeystore;
+//# sourceMappingURL=keystore.d.ts.map

package/dist/lib/keystore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystore.d.ts","sourceRoot":"","sources":["../../src/lib/keystore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;KACrD,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,sEAAsE;QACtE,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;QACzC,gFAAgF;QAChF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C,GAAG,YAAY,CA+Bf;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAuB3D"}

package/dist/lib/keystore.js

@@ -0,0 +1,105 @@
+export function createKeystore(params) {
+    const hasMnemonic = params.mnemonic !== undefined && params.mnemonic.length > 0;
+    return {
+        version: 3,
+        createdAt: new Date().toISOString(),
+        warning: hasMnemonic
+            ? 'DO NOT SHARE. Contains private keys and recovery mnemonic for your atomic swap.'
+            : 'DO NOT SHARE. Contains private keys for your atomic swap.',
+        ...(params.mnemonic ? { mnemonic: params.mnemonic } : {}),
+        ...(params.derivation ? { derivation: params.derivation } : {}),
+        btc: {
+            wif: params.wif,
+            address: params.btcAddress,
+            network: params.network,
+        },
+        keys: {
+            s_b: params.s_b,
+            v_b: params.v_b,
+            S_b_bitcoin: params.S_b_bitcoin,
+            S_b_monero: params.S_b_monero,
+            dleq_proof: params.dleq_proof,
+            b: params.b,
+            B: params.B,
+            eigenwallet_master_seed: params.eigenwallet_master_seed,
+            libp2p_peer_id: params.libp2p_peer_id,
+        },
+        swap: {
+            receiveAddress: params.receiveAddress,
+            refundAddress: params.refundAddress,
+        },
+    };
+}
+/**
+ * Parse a raw JSON string into a SwapKeystore.
+ * Handles v1, v2 (migrated), and v3 keystore formats.
+ *
+ * V2→V3 migration: existing V2 keystores have no `eigenwallet_master_seed`.
+ * The migrator stamps an empty string for both libp2p fields; recovery for
+ * those swaps is keystore-only (mnemonic still works), but the eigenwallet
+ * binary won't reproduce the original peer-id. Newly-created keystores at V3
+ * have the field populated.
+ */
+export function parseKeystore(rawJson) {
+    const raw = JSON.parse(rawJson);
+    if (typeof raw !== 'object' || raw === null) {
+        throw new Error('Invalid keystore format');
+    }
+    const obj = raw;
+    const version = obj['version'];
+    if (version === 3) {
+        return raw;
+    }
+    if (version === 2) {
+        return migrateV2toV3(obj);
+    }
+    if (version === 1) {
+        return migrateV2toV3(migrateV1toV2(obj));
+    }
+    throw new Error(`Unsupported keystore version: ${String(version)}`);
+}
+function migrateV2toV3(raw) {
+    const v2 = raw;
+    return {
+        version: 3,
+        createdAt: v2.createdAt,
+        warning: v2.warning,
+        ...(v2.mnemonic ? { mnemonic: v2.mnemonic } : {}),
+        ...(v2.derivation ? { derivation: v2.derivation } : {}),
+        btc: v2.btc,
+        keys: {
+            ...v2.keys,
+            eigenwallet_master_seed: '',
+            libp2p_peer_id: '',
+        },
+        swap: v2.swap,
+    };
+}
+function migrateV1toV2(raw) {
+    const v1 = raw;
+    return {
+        version: 2,
+        createdAt: raw['createdAt'] ?? new Date().toISOString(),
+        warning: 'DO NOT SHARE. Contains private keys for your atomic swap.',
+        btc: {
+            wif: v1.btc.wif,
+            address: v1.btc.address,
+            network: (v1.btc.network || 'mainnet'),
+        },
+        keys: {
+            // s_b: v1 keystores may have dleq.sB (if created after partial fix) or nothing
+            s_b: v1.dleq?.sB ?? '',
+            v_b: v1.monero?.privateViewKey ?? '',
+            S_b_bitcoin: v1.dleq?.sBitcoin ?? '',
+            S_b_monero: v1.dleq?.sMonero ?? v1.monero?.publicSpendKey ?? '',
+            dleq_proof: v1.dleq?.proof ?? '',
+            b: '',
+            B: '',
+        },
+        swap: {
+            receiveAddress: v1.swap?.receiveAddress ?? '',
+            refundAddress: v1.swap?.refundAddress ?? '',
+        },
+    };
+}
+//# sourceMappingURL=keystore.js.map

package/dist/lib/keystore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystore.js","sourceRoot":"","sources":["../../src/lib/keystore.ts"],"names":[],"mappings":"AAyDA,MAAM,UAAU,cAAc,CAAC,MAiB9B;IACC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAChF,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,WAAW;YAClB,CAAC,CAAC,iFAAiF;YACnF,CAAC,CAAC,2DAA2D;QAC/D,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,EAAE;YACH,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,UAAU;YAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB;QACD,IAAI,EAAE;YACJ,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;YACvD,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC;QACD,IAAI,EAAE;YACJ,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAE/B,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,GAAmB,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC,aAAa,CAAC,GAAG,CAAuC,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC;AA4BD,SAAS,aAAa,CAAC,GAA4B;IACjD,MAAM,EAAE,GAAG,GAA4B,CAAC;IACxC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,IAAI,EAAE;YACJ,GAAG,EAAE,CAAC,IAAI;YACV,uBAAuB,EAAE,EAAE;YAC3B,cAAc,EAAE,EAAE;SACnB;QACD,IAAI,EAAE,EAAE,CAAC,IAAI;KACd,CAAC;AACJ,CAAC;AAwBD,SAAS,aAAa,CAAC,GAA4B;IACjD,MAAM,EAAE,GAAG,GAA4B,CAAC;IAExC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAG,GAAG,CAAC,WAAW,CAAY,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnE,OAAO,EAAE,2DAA2D;QACpE,GAAG,EAAE;YACH,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG;YACf,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO;YACvB,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAsC;SAC5E;QACD,IAAI,EAAE;YACJ,+EAA+E;YAC/E,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE;YACtB,GAAG,EAAE,EAAE,CAAC,MAAM,EAAE,cAAc,IAAI,EAAE;YACpC,WAAW,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE;YACpC,UAAU,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,MAAM,EAAE,cAAc,IAAI,EAAE;YAC/D,UAAU,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAChC,CAAC,EAAE,EAAE;YACL,CAAC,EAAE,EAAE;SACN;QACD,IAAI,EAAE;YACJ,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,IAAI,EAAE;YAC7C,aAAa,EAAE,EAAE,CAAC,IAAI,EAAE,aAAa,IAAI,EAAE;SAC5C;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/monero/output-scanner.d.ts

@@ -0,0 +1,53 @@
+import type { Logger } from '../../interfaces/logger.js';
+import type { MoneroTxJson } from './rpc.js';
+/** A scanned output with all fields needed for SweepConstructionData. */
+export interface ScannedOutput {
+    /** One-time public key P (32 bytes hex). */
+    readonly oneTimePublicKey: string;
+    /** Transaction public key R (32 bytes hex). */
+    readonly txPublicKey: string;
+    /** Index of this output within its transaction. */
+    readonly outputIndex: number;
+    /** Global output index on the blockchain. */
+    readonly globalOutputIndex: number;
+    /** Decrypted amount in piconeros. */
+    readonly amount: bigint;
+    /** RCT commitment blinding factor (32 bytes hex). Computed via WASM. */
+    readonly rctMask: string;
+}
+/**
+ * Scan a transaction's outputs to find ones belonging to the given keys.
+ *
+ * @param txJson - Parsed transaction JSON from monerod
+ * @param globalOutputIndices - Global indices for each output (from get_transactions response)
+ * @param viewKeyHex - Combined private view key (32 bytes hex)
+ * @param spendPubHex - Combined public spend key S_a + S_b (32 bytes hex)
+ * @param computeMask - Function to compute commitment mask (typically WASM compute_commitment_mask)
+ * @param decryptAmountFn - Function to decrypt RCT amount (typically WASM decrypt_amount). If not provided, uses TS fallback.
+ * @param logger - Optional structured logger
+ * @returns Array of matching outputs with all metadata
+ */
+export declare function scanTransactionOutputs(params: {
+    readonly txJson: MoneroTxJson;
+    readonly globalOutputIndices: readonly number[];
+    readonly viewKeyHex: string;
+    readonly spendPubHex: string;
+    readonly computeMask: (viewKeyHex: string, txPubKeyHex: string, outputIndex: number) => string;
+    readonly decryptAmountFn?: (viewKeyHex: string, txPubKeyHex: string, outputIndex: number, encryptedHex: string) => bigint;
+    readonly logger?: Logger;
+}): ScannedOutput[];
+/** Extract the tx public key R from the extra field. Tag 0x01 = 32-byte pubkey. */
+export declare function extractTxPubKey(extra: readonly number[]): Uint8Array | null;
+/** Decode a hex-encoded little-endian scalar reduced mod L. */
+export declare function hexToScalar(hex: string): bigint;
+/** Hs(D8 || varint(i)) mod L: keccak output interpreted as a little-endian scalar. */
+export declare function deriveScalar(d8Bytes: Uint8Array, outputIndex: number): bigint;
+/** Keccak256(D8 || varint(i)) as raw 32 bytes. */
+export declare function deriveScalarBytes(d8Bytes: Uint8Array, outputIndex: number): Uint8Array;
+/** Decrypt a Monero RingCT amount (Bulletproofs+ style, 8-byte XOR). */
+export declare function decryptAmount(d8Bytes: Uint8Array, outputIndex: number, ecdhInfo: {
+    readonly amount: string;
+} | undefined): bigint;
+/** Encode a number as a Monero varint (unsigned LEB128). */
+export declare function encodeVarint(value: number): Uint8Array;
+//# sourceMappingURL=output-scanner.d.ts.map

package/dist/lib/monero/output-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/monero/output-scanner.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAQzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/F,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1H,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,aAAa,EAAE,CAuGlB;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAO3E;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAI7E;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAMtF;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAChD,MAAM,CAiCR;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAUtD"}