@miradexio/client 0.1.0 → 0.1.2

package/dist/lib/default-config.js

@@ -1,10 +1,5 @@
-/**
- * Centralized default configuration values.
- *
- * Every hardcoded default used across the codebase lives here.
- * Individual modules import what they need — no magic strings scattered
- * across files. When adding new infrastructure defaults, put them here.
- */
+// Single home for hardcoded defaults so individual modules don't carry
+// magic strings. Add new infrastructure defaults here.
 export const API_URL = 'http://127.0.0.1:7001/';
 export const API_TOR_URL = 'http://miradextor.onion:7001';
 export const API_TIMEOUT_MS = 30_000;
@@ -20,12 +15,10 @@ export const TOR_MODE = 'bundled';
 export const ELECTRUM_PRIMARY_URL = 'ssl://electrum.blockstream.info:50002';
 /** Testnet Electrum server URL. */
 export const ELECTRUM_TESTNET_URL = 'ssl://electrum.blockstream.info:60002';
-/** Resolve the correct Electrum server URL for a given network. */
 export function electrumUrlForNetwork(configuredUrl, network) {
-    // If user explicitly configured a server, respect it regardless of network
+    // Respect a user-configured server regardless of network.
     if (configuredUrl !== ELECTRUM_PRIMARY_URL)
         return configuredUrl;
-    // Default server: swap to testnet variant
     return network === 'testnet' ? ELECTRUM_TESTNET_URL : configuredUrl;
 }
 /** Ordered list of Electrum servers. First entry is the primary. */
@@ -45,20 +38,10 @@ export const ELECTRUM_SERVERS = [
 ];
 export const ELECTRUM_CONNECT_TIMEOUT_MS = 8_000;
 export const ELECTRUM_REQUEST_TIMEOUT_MS = 10_000;
-/**
- * Curated Monero mainnet RPC endpoints. Browser-hit directly (no proxy)
- * by design — for real-money swaps the client must not trust a single
- * server-side proxy. Every entry below was probed (2026-05) and confirmed
- * to:
- *   - return `Access-Control-Allow-Origin: *` (browser-fetchable),
- *   - serve `nettype=mainnet`,
- *   - present a valid TLS chain.
- *
- * Mainnet stays out of the crypto-server proxy on purpose — see
- * `apps/crypto-server/src/swap/routes/monero-proxy.routes.ts`. Only
- * stagenet/testnet runs through the proxy because there's no real-money
- * trust to preserve in test flows.
- */
+// Browser-hit directly: real-money swaps must not trust a single server-side
+// proxy. Every entry probed 2026-05 to confirm CORS *, mainnet nettype, valid
+// TLS. Stagenet/testnet runs through the crypto-server proxy
+// (apps/crypto-server/src/swap/routes/monero-proxy.routes.ts); mainnet does not.
 export const MONERO_MAINNET_NODES = [
     'https://node.sethforprivacy.com',
     'https://node.sethforprivacy.com:443',
@@ -98,21 +81,14 @@ export const MONERO_MAINNET_NODES = [
     'https://monero.openinternet.io',
     'https://xmr.support:18089',
 ];
-/**
- * Curated Monero stagenet RPC endpoints. Stagenet is Monero's public test
- * network (the Monero analogue of Bitcoin testnet).
- */
+// Monero's public testnet equivalent.
 export const MONERO_STAGENET_NODES = [
     'https://node.sethforprivacy.com:38089',
     'https://testnet.miradex.io/api/v1/swap/proxy/monero/stagenet',
     'https://testnet.miradex.io/api/v1/swap/proxy/monero/stagenet'
 ];
-/**
- * Default node URLs per network per chain. URLs use the `scheme://host:port`
- * form that Electrum / monerod clients accept directly. For Monero, the
- * `testnet` key holds stagenet endpoints (Monero has no parallel-to-Bitcoin
- * 'testnet' notion — the closest public net is stagenet).
- */
+// scheme://host:port form, accepted directly by Electrum / monerod clients.
+// Monero `testnet` key holds stagenet endpoints (Monero has no Bitcoin-style testnet).
 export const DEFAULT_NODES = {
     testnet: {
         bitcoin: [
@@ -152,37 +128,22 @@ export const DEFAULT_NODES = {
 };
 export const MEMPOOL_API = 'https://mempool.space/api';
 export const MEMPOOL_TESTNET_API = 'https://mempool.space/testnet/api';
-/** Estimated vbytes for a 1-input P2WPKH → 1-output P2WSH transaction.
- * Header(10.5) + P2WPKH input(68) + P2WSH output(43) ≈ 122 vbytes.
- * Rounded up to 130 for safety margin (signature size variance). */
+// 1-in P2WPKH -> 1-out P2WSH. Header(10.5) + input(68) + output(43) ~= 122 vb;
+// rounded up to 130 for signature-size variance.
 export const LOCK_TX_VBYTES = 130;
 /** Fallback feerate when all fee sources are unreachable (sat/vbyte). */
 export const FALLBACK_FEE_RATE = 10;
-/**
- * Minimum feerate for the funding tx (sat/vbyte). Bitcoin Core's default
- * `minrelaytxfee` is 1.0, but many public and testnet nodes raise this to
- * 1.5–3.0 sat/vB. Setting this floor below 3 produces sporadic
- * "min relay fee not met" rejections that force a re-sign. 3 sat/vB covers
- * every sane operator policy we've observed with negligible extra cost.
- */
+// Bitcoin Core defaults minrelaytxfee to 1.0, but many public/testnet nodes
+// raise it to 1.5-3.0. Below 3 produces sporadic "min relay fee not met"
+// rejections that force a re-sign; 3 sat/vB covers every sane policy.
 export const MIN_FEE_RATE = 3;
-/**
- * Safety margin applied to the estimated feerate. Covers the race between
- * estimate-at-deposit-time and broadcast-at-fund-time when mempool pressure
- * changes. 1.25 = +25% headroom on top of the estimate.
- */
+// +25% headroom on the estimate, to cover mempool changes between estimate
+// at deposit-time and broadcast at fund-time.
 export const FEE_MARGIN_MULTIPLIER = 1.25;
-/**
- * Sanity ceilings on the broadcast feerate (sat/vbyte). Without this cap,
- * a misbehaving fee oracle can drive the lock-tx fee above the deposit
- * value itself. Testnet is especially prone: its mempool has no real
- * fee market, electrum servers and mempool.space/testnet routinely
- * return absurd `halfHourFee` values (we've seen >250 sat/vB on a chain
- * where 1 sat/vB confirms in one block).
- *
- * Mainnet ceiling is set conservatively above historical peak conditions
- * — it catches oracle bugs without gating real high-fee periods.
- */
+// Sanity ceiling. Testnet halfHourFee oracles routinely return absurd
+// values (>250 sat/vB on a chain where 1 sat/vB confirms in a block); without
+// a cap a misbehaving oracle can drive the lock-tx fee above the deposit.
+// Mainnet ceiling sits above historical peaks so it only catches oracle bugs.
 export const MAX_FEE_RATE_MAINNET = 100;
 export const MAX_FEE_RATE_TESTNET = 10;
 export const DEPOSIT_POLL_MS = 5_000;
@@ -193,7 +154,7 @@ export const SWEEP_POLL_MS = 30_000;
 export const SWEEP_TIMEOUT_MS = 3_600_000;
 export const POW_MAX_RETRIES = 3;
 export const POW_BACKOFF_MS = 2_000;
-export const DEFAULT_SLIPPAGE_BPS = 100;
+export const DEFAULT_SLIPPAGE_BPS = 300;
 export const DEFAULT_MAX_DEVIATION_BPS = 300;
 export const DEFAULT_FROM_TOKEN = 'BTC';
 export const DEFAULT_TO_TOKEN = 'XMR';

package/dist/lib/default-config.js.map

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

package/dist/lib/errors.d.ts

@@ -1,37 +1,8 @@
-/**
- * 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;
@@ -39,42 +10,17 @@ export declare class MiradexError extends Error {
     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;

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

@@ -1 +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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAcA,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;AAGD,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;AAID,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CA8BzD;AASD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGjD;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,SAAkB,IAAI,wBAAwB;gBAClC,OAAO,SAA2B;CAG/C;AAGD,qBAAa,YAAa,SAAQ,YAAY;IAC5C,SAAkB,IAAI,kBAAkB;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;CAG3D;AAKD,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

@@ -1,7 +1,4 @@
-/**
- * Base for every error the SDK emits. Subclasses set `name` and `category`.
- * `cause` and `details` are optional and travel with the error for diagnostics.
- */
+// Subclasses set name and category. cause + details travel along.
 export class MiradexError extends Error {
     name = 'MiradexError';
     category;
@@ -14,31 +11,25 @@ export class MiradexError extends Error {
         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.
- */
+// MiradexError short-circuits; everything else is fingerprinted against
+// platform-neutral 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).
+    // Native fetch: Node 20+ throws TypeError("fetch failed") with .cause
+    // carrying ECONN...; browsers throw TypeError("Failed to fetch") sans 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').
+    // Per-request timeout via AbortController.abort().
     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.
+        // Last-resort fingerprint for environments that bury Node codes 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';
@@ -60,36 +51,22 @@ export function errorMessage(err) {
         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.
- */
+// Always category 'network' so withRetry retries forever (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.
- */
+// One class for all four HTTP categories (server / rate-limit / client-bounded
+// / client-fatal); category derived from statusCode + code. SCHEMA_MISMATCH is
+// always 'protocol' regardless of status — retrying won't fix it.
 export class ApiError extends MiradexError {
     name = 'ApiError';
     statusCode;

package/dist/lib/errors.js.map

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

package/dist/lib/keystore.d.ts

@@ -1,6 +1,3 @@
-/**
- * Records how keys were derived so future code changes never break recovery.
- */
 export interface KeystoreDerivation {
     /** Scheme identifier (e.g. "miradex-v0") */
     readonly scheme: string;
@@ -11,17 +8,6 @@ export interface KeystoreDerivation {
     /** 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;
@@ -71,15 +57,5 @@ export declare function createKeystore(params: {
     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

@@ -1 +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"}
+{"version":3,"file":"keystore.d.ts","sourceRoot":"","sources":["../../src/lib/keystore.ts"],"names":[],"mappings":"AACA,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;AAKD,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;AAKD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAuB3D"}

package/dist/lib/keystore.js

@@ -30,16 +30,9 @@ export function createKeystore(params) {
         },
     };
 }
-/**
- * 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.
- */
+// Handles v1, v2 (migrated), v3. V2->V3: empty libp2p fields, so recovery
+// is keystore-only (mnemonic works) but eigenwallet can't reproduce the
+// original peer-id. Fresh V3 keystores have the field populated.
 export function parseKeystore(rawJson) {
     const raw = JSON.parse(rawJson);
     if (typeof raw !== 'object' || raw === null) {

package/dist/lib/keystore.js.map

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

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

@@ -15,18 +15,6 @@ export interface ScannedOutput {
     /** 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[];
@@ -36,18 +24,12 @@ export declare function scanTransactionOutputs(params: {
     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

@@ -1 +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"}
+{"version":3,"file":"output-scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/monero/output-scanner.ts"],"names":[],"mappings":"AAOA,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;AAID,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;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAO3E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAGD,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAI7E;AAGD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAMtF;AASD,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,CAuBR;AAGD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAUtD"}

package/dist/lib/monero/output-scanner.js

@@ -1,31 +1,13 @@
-/**
- * Monero output scanning — detect owned outputs in a transaction.
- *
- * Given a transaction JSON (from monerod /get_transactions), the shared view key,
- * and the combined spend public key, this module scans each output to determine
- * if it belongs to the lock address. For matching outputs, it decrypts the amount
- * and computes the RCT commitment mask.
- *
- * Reusable by both verify-xmr-lock.ts (lock verification) and monero-sweep.ts
- * (sweep construction).
- */
+// Detect owned outputs in a Monero tx given the shared view key and the
+// combined spend pubkey. For matches, decrypt the amount and compute the
+// RCT commitment mask. Used by verify-xmr-lock.ts and monero-sweep.ts.
 import { Point } from '@noble/ed25519';
 import { keccak_256 } from '@noble/hashes/sha3.js';
 import { bytesToHex, hexToBytes } from '@noble/hashes/utils.js';
 import { noopLogger } from '../../interfaces/logger.js';
 import { ED25519_GROUP_ORDER, bytesToBigIntLE, hexToScalarLE, bigIntToBytes, } from '../crypto/scalars.js';
-/**
- * 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
- */
+// computeMask / decryptAmountFn typically wrap the WASM equivalents;
+// decryptAmountFn falls back to the local TS impl when omitted.
 export function scanTransactionOutputs(params) {
     const { txJson, globalOutputIndices, viewKeyHex, spendPubHex, computeMask, decryptAmountFn, logger: log = noopLogger } = params;
     const txPubKeyR = extractTxPubKey(txJson.extra);
@@ -69,7 +51,7 @@ export function scanTransactionOutputs(params) {
         const expectedKeyHex = bytesToHex(expectedKey.toBytes());
         const isMatch = expectedKeyHex === outputKeyHex;
         if (isMatch) {
-            // Decrypt amount — prefer WASM (uses same key derivation as mask/key images)
+            // Prefer the WASM decrypt — same key derivation as mask / key images.
             const ecdhInfo = txJson.rct_signatures.ecdhInfo[i];
             let amount;
             if (decryptAmountFn && ecdhInfo) {
@@ -105,7 +87,7 @@ export function scanTransactionOutputs(params) {
     log.info({ scannedOutputs: txJson.vout.length, matches: results.length }, 'Output scanning complete');
     return results;
 }
-/** Extract the tx public key R from the extra field. Tag 0x01 = 32-byte pubkey. */
+// Tag 0x01 = 32B pubkey.
 export function extractTxPubKey(extra) {
     for (let i = 0; i < extra.length; i++) {
         if (extra[i] === 0x01 && i + 32 < extra.length) {
@@ -114,17 +96,16 @@ export function extractTxPubKey(extra) {
     }
     return null;
 }
-/** Decode a hex-encoded little-endian scalar reduced mod L. */
 export function hexToScalar(hex) {
     return hexToScalarLE(hex);
 }
-/** Hs(D8 || varint(i)) mod L: keccak output interpreted as a little-endian scalar. */
+// Hs(D8 || varint(i)) mod L; keccak output as little-endian scalar.
 export function deriveScalar(d8Bytes, outputIndex) {
     const hash = deriveScalarBytes(d8Bytes, outputIndex);
     const raw = bytesToBigIntLE(hash);
     return ((raw % ED25519_GROUP_ORDER) + ED25519_GROUP_ORDER) % ED25519_GROUP_ORDER;
 }
-/** Keccak256(D8 || varint(i)) as raw 32 bytes. */
+// Raw 32B keccak256(D8 || varint(i)).
 export function deriveScalarBytes(d8Bytes, outputIndex) {
     const varintBuf = encodeVarint(outputIndex);
     const preimage = new Uint8Array(d8Bytes.length + varintBuf.length);
@@ -132,18 +113,16 @@ export function deriveScalarBytes(d8Bytes, outputIndex) {
     preimage.set(varintBuf, d8Bytes.length);
     return keccak_256(preimage);
 }
-/** Decrypt a Monero RingCT amount (Bulletproofs+ style, 8-byte XOR). */
+// RingCT amount decryption (Bulletproofs+ style 8-byte XOR).
+// Matches wallet2 / Rust WASM decrypt_amount_inner:
+//   derivation_scalar = sc_reduce32(keccak256(D8 || varint(i)))
+//   amount_key        = keccak256("amount" || derivation_scalar.as_bytes())
+// The reduced scalar is serialised canonically as 32 LE bytes before the
+// second hash. Skipping mod-L reduction silently produces garbage XOR
+// plaintexts whenever the hash exceeds the group order.
 export function decryptAmount(d8Bytes, outputIndex, ecdhInfo) {
     if (!ecdhInfo)
         return 0n;
-    // Match wallet2 / Rust WASM `decrypt_amount_inner`:
-    //   derivation_scalar = sc_reduce32(keccak256(D8 || varint(i)))
-    //   amount_key        = keccak256("amount" || derivation_scalar.as_bytes())
-    // The reduced scalar is serialised canonically as 32 LE bytes before the
-    // second hash. Feeding the raw keccak256 output (without mod-L reduction)
-    // is wrong whenever the hash exceeds the group order, which silently
-    // produces garbage XOR plaintexts that can pass a one-sided
-    // `< expectedAmount` check downstream.
     const rawDerivationHash = deriveScalarBytes(d8Bytes, outputIndex);
     const derivationScalarBytes = bigIntToBytes(bytesToBigIntLE(rawDerivationHash));
     const amountPrefix = new TextEncoder().encode('amount');
@@ -151,20 +130,18 @@ export function decryptAmount(d8Bytes, outputIndex, ecdhInfo) {
     amountPreimage.set(amountPrefix);
     amountPreimage.set(derivationScalarBytes, amountPrefix.length);
     const amountKey = keccak_256(amountPreimage);
-    // XOR first 8 bytes
     const encryptedAmount = hexToBytes(ecdhInfo.amount);
     const decrypted = new Uint8Array(8);
     for (let i = 0; i < 8; i++) {
         decrypted[i] = (encryptedAmount[i] ?? 0) ^ (amountKey[i] ?? 0);
     }
-    // Read as little-endian u64
     let amount = 0n;
     for (let i = 7; i >= 0; i--) {
         amount = (amount << 8n) | BigInt(decrypted[i] ?? 0);
     }
     return amount;
 }
-/** Encode a number as a Monero varint (unsigned LEB128). */
+// Monero varint = unsigned LEB128.
 export function encodeVarint(value) {
     const bytes = [];
     let v = value;