@miradexio/client 0.1.0 → 0.1.2

package/dist/engine/miradex-engine.d.ts

@@ -14,35 +14,13 @@ export interface StartSwapParams {
     readonly destAddress: string;
     readonly refundAddress: string;
     readonly selectedQuote: SwapQuote;
-    /**
-     * Per-swap slippage tolerance in bps. Overrides EngineConfig.slippageBps for
-     * this swap only. Validated against the same network-dependent band as the
-     * engine constructor: [ENGINE_SLIPPAGE_MIN_BPS, ENGINE_SLIPPAGE_MAX_BPS] on
-     * mainnet/testnet, [ENGINE_SLIPPAGE_MIN_BPS, 10_000] on regtest. Out-of-range
-     * values throw `E_SLIPPAGE_OUT_OF_RANGE`.
-     */
     readonly slippageBps?: number;
 }
 export interface StartAtomicSwapParams {
     readonly amount: string;
     readonly destAddress: string;
     readonly refundAddress: string;
-    /**
-     * Pin a specific atomicswap maker by `variantId` (e.g. `maker-K4ZK7eSx`),
-     * as returned in the `/quotes` response. When omitted the server picks the
-     * highest-scored maker for the requested amount.
-     */
     readonly variantId?: string;
-    /**
-     * Reuse an existing keystore instead of generating a fresh one. Loads the
-     * keystore record via `platform.loadKeystore(existingKeystoreId)` and
-     * skips both keygen and `platform.saveKeystore`. The new swap binds to
-     * the existing BTC private key and funding address — typical use is
-     * "previous swap failed but funds are still at the funding address; let
-     * the user re-quote without depositing again". `params.destAddress` and
-     * `params.refundAddress` still drive the new swap's protocol values; the
-     * keystore's stored copies are historical and not consulted here.
-     */
     readonly existingKeystoreId?: string;
 }
 export interface EngineConfig {
@@ -64,15 +42,11 @@ export interface ResolvedEngineConfig {
     readonly slippageBps: number;
     readonly monerodNodes: readonly string[] | undefined;
 }
-/**
- * Built-in MiradexEngine defaults applied when the caller leaves a field
- * unset. Consumers can read these without constructing an engine.
- */
 export declare const DEFAULT_ENGINE_CONFIG: {
     readonly apiTimeout: 60000;
     readonly apiMaxRetries: 3;
     readonly network: "mainnet";
-    readonly slippageBps: 100;
+    readonly slippageBps: 300;
 };
 interface EngineEvents {
     state: (state: EngineState) => void;
@@ -101,51 +75,16 @@ export declare class MiradexEngine extends EventEmitter<EngineEvents> {
     setSwapState(swap: SwapFlowState): void;
     setAtomicState(atomic: AtomicFlowState): void;
     setActiveFlow(flow: ActiveFlow): void;
-    /**
-     * Destroy the engine. Cancel all active flows, remove listeners.
-     */
     destroy(): void;
-    /**
-     * Start a standard (non-atomic) swap.
-     */
     startSwap(params: StartSwapParams): Promise<void>;
-    /**
-     * Resume any swap by ID. The engine fetches the detail, determines the
-     * provider, finds the keystore if atomic, and routes to the right flow.
-     * The TUI never needs to know which path to take.
-     */
     resume(swapId: string, keystoreAddress?: string): Promise<void>;
     cancelSwap(): void;
-    /**
-     * Start a fresh BTC→XMR atomic swap.
-     */
     startAtomicSwap(params: StartAtomicSwapParams): Promise<void>;
-    /**
-     * Resume an atomic swap from a keystore.
-     * Called from both /resume and /keystores modes.
-     */
     resumeAtomicSwap(keystoreId: string, swapId?: string): Promise<void>;
     cancelAtomicSwap(): void;
-    /**
-     * User presses 'x' — broadcast TxCancel.
-     * Only valid when atomic.phase === 'awaiting-user-action'
-     * and requiredAction.type === 'cancel'.
-     */
     userCancel(): void;
-    /**
-     * User presses 'f' — verify TxCancel on-chain, then share s_b.
-     * Only valid when atomic.phase === 'awaiting-user-action'
-     * and requiredAction.type === 'refund'.
-     */
     userRefund(): void;
-    /**
-     * User presses 'w' — retry XMR sweep.
-     */
     userRetrySweep(): void;
-    /**
-     * Exit current flow and return to idle.
-     * Cancels any active operation.
-     */
     exitToIdle(): void;
 }
 export {};

package/dist/engine/miradex-engine.d.ts.map

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

package/dist/engine/miradex-engine.js

@@ -4,15 +4,13 @@ import { createInitialEngineState } from './engine-state.js';
 import { VerificationError } from '../types/index.js';
 import { validateAddress } from '../address/index.js';
 import { ENGINE_SLIPPAGE_MIN_BPS, ENGINE_SLIPPAGE_MAX_BPS, ENGINE_RETRY_MIN, ENGINE_RETRY_MAX, } from '../lib/default-config.js';
-/**
- * Built-in MiradexEngine defaults applied when the caller leaves a field
- * unset. Consumers can read these without constructing an engine.
- */
+// Defaults applied when a config field is unset. Exported so consumers can
+// inspect them without constructing an engine.
 export const DEFAULT_ENGINE_CONFIG = {
     apiTimeout: 60_000,
     apiMaxRetries: 3,
     network: 'mainnet',
-    slippageBps: 100,
+    slippageBps: 300,
 };
 export class MiradexEngine extends EventEmitter {
     api;
@@ -28,11 +26,9 @@ export class MiradexEngine extends EventEmitter {
     }
     constructor(config, platform) {
         super();
-        const slippageBps = config.slippageBps ?? 100;
-        // Production slippage band is intentionally narrow (UX guard against
-        // catastrophic trades). Regtest exercises the engine against shallow
-        // mocknet pools where swap simulation needs much wider tolerance, so
-        // the band is relaxed when `network: 'regtest'`.
+        const slippageBps = config.slippageBps ?? 300;
+        // Tight band on mainnet/testnet (UX guard against catastrophic trades);
+        // wide on regtest to accommodate shallow mocknet pools.
         const network = config.network ?? 'mainnet';
         const maxSlippage = network === 'regtest' ? 10_000 : ENGINE_SLIPPAGE_MAX_BPS;
         if (slippageBps < ENGINE_SLIPPAGE_MIN_BPS || slippageBps > maxSlippage) {
@@ -75,8 +71,8 @@ export class MiradexEngine extends EventEmitter {
     get platformAdapter() {
         return this.platform;
     }
-    // Each flow gets a scoped callback. When a new flow replaces the old one,
-    // the old callback becomes a no-op — its emissions are silently discarded.
+    // Each flow gets a scoped callback. When a new flow replaces the old one
+    // the old callback becomes a no-op; its emissions are silently discarded.
     createScopedSwapEmit() {
         this.swapFlow?.cancel();
         this.swapFlowGeneration++;
@@ -108,18 +104,13 @@ export class MiradexEngine extends EventEmitter {
     setActiveFlow(flow) {
         this.updateState({ activeFlow: flow });
     }
-    /**
-     * Destroy the engine. Cancel all active flows, remove listeners.
-     */
+    // Cancel all active flows, remove listeners.
     destroy() {
         this.logger.info({}, 'Engine destroyed');
         this.swapFlow?.cancel();
         this.atomicFlow?.cancel();
         this.removeAllListeners();
     }
-    /**
-     * Start a standard (non-atomic) swap.
-     */
     async startSwap(params) {
         if (params.slippageBps !== undefined) {
             const maxSlippage = this.resolvedConfig.network === 'regtest' ? 10_000 : ENGINE_SLIPPAGE_MAX_BPS;
@@ -138,16 +129,11 @@ export class MiradexEngine extends EventEmitter {
         this.setActiveFlow('swap');
         void this.swapFlow.start(params);
     }
-    /**
-     * Resume any swap by ID. The engine fetches the detail, determines the
-     * provider, finds the keystore if atomic, and routes to the right flow.
-     * The TUI never needs to know which path to take.
-     */
+    // Routes to the right flow based on provider; caller doesn't need to know.
     async resume(swapId, keystoreAddress) {
         this.logger.info({ swapId, keystoreAddress: keystoreAddress ?? null }, 'Resuming swap');
-        // Cancel both previous flows before routing; startSwap does the same.
-        // Prevents a ghost SwapFlow from emitting after resume picked AtomicFlow
-        // (and vice versa).
+        // Cancel both flows first so a ghost emitter doesn't fire after resume
+        // picks the other flow.
         this.swapFlow?.cancel();
         this.atomicFlow?.cancel();
         try {
@@ -203,9 +189,6 @@ export class MiradexEngine extends EventEmitter {
         this.swapFlow?.cancel();
         this.setSwapState({ phase: 'cancelled', snapshot: this._state.swap.snapshot });
     }
-    /**
-     * Start a fresh BTC→XMR atomic swap.
-     */
     async startAtomicSwap(params) {
         const destCheck = validateAddress(params.destAddress, 'XMR');
         if (!destCheck.valid) {
@@ -218,10 +201,7 @@ export class MiradexEngine extends EventEmitter {
         this.setActiveFlow('atomic');
         void this.atomicFlow.start(params);
     }
-    /**
-     * Resume an atomic swap from a keystore.
-     * Called from both /resume and /keystores modes.
-     */
+    // Called from both /resume and /keystores modes.
     async resumeAtomicSwap(keystoreId, swapId) {
         this.logger.info({ flow: 'atomic', keystoreId, swapId: swapId ?? null }, 'Resuming atomic swap');
         const emit = this.createScopedAtomicEmit();
@@ -234,36 +214,24 @@ export class MiradexEngine extends EventEmitter {
         this.atomicFlow?.cancel();
         this.setAtomicState({ phase: 'cancelled', snapshot: this._state.atomic.snapshot, swapId: null, txCancelTxid: null });
     }
-    /**
-     * User presses 'x' — broadcast TxCancel.
-     * Only valid when atomic.phase === 'awaiting-user-action'
-     * and requiredAction.type === 'cancel'.
-     */
+    // Broadcast TxCancel. Only valid in atomic.phase=awaiting-user-action with
+    // requiredAction.type=cancel.
     userCancel() {
         if (this._state.atomic.phase !== 'awaiting-user-action')
             return;
         void this.atomicFlow?.userCancel();
     }
-    /**
-     * User presses 'f' — verify TxCancel on-chain, then share s_b.
-     * Only valid when atomic.phase === 'awaiting-user-action'
-     * and requiredAction.type === 'refund'.
-     */
+    // Verify TxCancel on-chain then share s_b. Only valid in
+    // atomic.phase=awaiting-user-action with requiredAction.type=refund.
     userRefund() {
         if (this._state.atomic.phase !== 'awaiting-user-action')
             return;
         void this.atomicFlow?.userRefund();
     }
-    /**
-     * User presses 'w' — retry XMR sweep.
-     */
     userRetrySweep() {
         void this.atomicFlow?.userRetrySweep();
     }
-    /**
-     * Exit current flow and return to idle.
-     * Cancels any active operation.
-     */
+    // Cancels any active operation.
     exitToIdle() {
         this.logger.info({}, 'Exiting to idle');
         this.swapFlow?.cancel();

package/dist/engine/miradex-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"miradex-engine.js","sourceRoot":"","sources":["../../src/engine/miradex-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"miradex-engine.js","sourceRoot":"","sources":["../../src/engine/miradex-engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAI7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAsDlC,2EAA2E;AAC3E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU,EAAE,MAAM;IAClB,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,SAAkB;IAC3B,WAAW,EAAE,GAAG;CACR,CAAC;AAMX,MAAM,OAAO,aAAc,SAAQ,YAA0B;IAC1C,GAAG,CAAY;IACf,QAAQ,CAAkB;IAC1B,cAAc,CAAuB;IAE9C,QAAQ,GAAoB,IAAI,CAAC;IACjC,UAAU,GAAsB,IAAI,CAAC;IACrC,kBAAkB,GAAG,CAAC,CAAC;IACvB,oBAAoB,GAAG,CAAC,CAAC;IAEzB,MAAM,CAAc;IAE5B,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,YAAY,MAAoB,EAAE,QAAyB;QACzD,KAAK,EAAE,CAAC;QAER,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC;QAC9C,wEAAwE;QACxE,wDAAwD;QACxD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC;QAC5C,MAAM,WAAW,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC;QAC7E,IAAI,WAAW,GAAG,uBAAuB,IAAI,WAAW,GAAG,WAAW,EAAE,CAAC;YACvE,MAAM,IAAI,iBAAiB,CACzB,yBAAyB,EACzB,2BAA2B,MAAM,CAAC,uBAAuB,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,UAAU,MAAM,CAAC,WAAW,CAAC,EAAE,CAClH,CAAC;QACJ,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;QAChD,IAAI,aAAa,GAAG,gBAAgB,IAAI,aAAa,GAAG,gBAAgB,EAAE,CAAC;YACzE,MAAM,IAAI,iBAAiB,CACzB,wBAAwB,EACxB,6BAA6B,MAAM,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC,gBAAgB,CAAC,UAAU,MAAM,CAAC,aAAa,CAAC,EAAE,CACpH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,cAAc,GAAG;YACpB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,MAAM;YACvC,aAAa;YACb,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK;YAC3C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS;YACpC,WAAW;YACX,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC;QAEF,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC;YACvB,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM;YACnC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,UAAU;YACvC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,aAAa;YAC7C,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,sEAAsE;IACtE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,4CAA4C;IAC5C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,yCAAyC;IACzC,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAClE,oBAAoB;QAC1B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACpC,OAAO,CAAC,CAAgB,EAAQ,EAAE;YAChC,IAAI,GAAG,KAAK,IAAI,CAAC,kBAAkB;gBAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC;IAEO,sBAAsB;QAC5B,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACtC,OAAO,CAAC,CAAkB,EAAQ,EAAE;YAClC,IAAI,GAAG,KAAK,IAAI,CAAC,oBAAoB;gBAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,OAA6B;QAC/C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,IAAmB;QAC9B,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,cAAc,CAAC,MAAuB;QACpC,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,aAAa,CAAC,IAAgB;QAC5B,IAAI,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,6CAA6C;IAC7C,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAuB;QACrC,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,WAAW,GACf,IAAI,CAAC,cAAc,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC;YAC/E,IAAI,MAAM,CAAC,WAAW,GAAG,uBAAuB,IAAI,MAAM,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC;gBACrF,MAAM,IAAI,iBAAiB,CACzB,yBAAyB,EACzB,2BAA2B,MAAM,CAAC,uBAAuB,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CACzH,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACtE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,IAAI,iBAAiB,CACzB,wBAAwB,EACxB,8BAA8B,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,cAAc,SAAS,CAAC,MAAM,IAAI,gBAAgB,EAAE,CACpH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAC9M,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACzC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC3B,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,eAAwB;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,IAAI,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;QACxF,uEAAuE;QACvE,wBAAwB;QACxB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAEpD,MAAM,cAAc,GAAsB,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;YACnG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,iBAAiB,CACzB,oBAAoB,EACpB,qCAAqC,MAAM,CAAC,QAAQ,EAAE,CACvD,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBACrC,IAAI,UAAU,GAAkB,IAAI,CAAC;gBACrC,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;oBACtD,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,IAAI,eAAe,CAAC;oBACzD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAC1B,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,UAAU,KAAK,OAAO,CAAC,CACvE,CAAC;oBACF,UAAU,GAAG,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC,CAAC,sCAAsC,CAAC,CAAC;gBAElD,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;oBACjD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;oBAC9D,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAC9B,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CACzD,CAAC;oBACF,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;oBAC7B,KAAK,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBAC9D,CAAC;qBAAM,CAAC;oBACN,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;oBAC7C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;oBAC1D,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAC1B,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CACvD,CAAC;oBACF,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;oBAC3B,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC/F,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC7C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;gBAC1D,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAC1B,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CACvD,CAAC;gBACF,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBAC3B,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;YAC/D,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3B,IAAI,CAAC,YAAY,CAAC;gBAChB,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,kBAAkB,OAAO,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAA6B;QACjD,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,IAAI,iBAAiB,CACzB,wBAAwB,EACxB,2CAA2C,SAAS,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAClF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACrH,MAAM,IAAI,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC3C,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACrF,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC7B,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,MAAe;QACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACjG,MAAM,IAAI,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC3C,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACrF,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC7B,KAAK,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IACvH,CAAC;IAED,2EAA2E;IAC3E,8BAA8B;IAC9B,UAAU;QACR,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,sBAAsB;YAAE,OAAO;QAChE,KAAK,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,yDAAyD;IACzD,qEAAqE;IACrE,UAAU;QACR,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,sBAAsB;YAAE,OAAO;QAChE,KAAK,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,cAAc;QACZ,KAAK,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC;IACzC,CAAC;IAED,gCAAgC;IAChC,UAAU;QACR,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,CAAC;YACf,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;YACvC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/engine/pipeline.d.ts

@@ -11,17 +11,6 @@ export declare const PIPELINE_LABELS_REFUND: readonly PipelineLabel[];
 export declare const PIPELINE_LABELS_EXPIRED: readonly PipelineLabel[];
 export declare function swapPipelineStage(phase: SwapFlowState['phase']): PipelineStage | null;
 export declare function atomicPipelineStage(phase: AtomicFlowState['phase']): PipelineStage | null;
-/**
- * Compute which pipeline stages are "done" given the current phase.
- * Returns a Set of stage keys that should show as completed.
- *
- * Both 'cancelling' and 'complete' sit after the base 4 stages,
- * so all base stages are marked done when either is current.
- */
 export declare function computeDoneStages(currentStage: PipelineStage | null): ReadonlySet<PipelineStage>;
-/**
- * Map server status to pipeline stage. ONE map, used by all flows.
- * Returns null for unknown statuses — caller must skip.
- */
 export declare function mapServerStatus(status: string): PipelineStage | null;
 //# sourceMappingURL=pipeline.d.ts.map

package/dist/engine/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/engine/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAMnD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAM1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAM1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,SAAS,aAAa,EAM3D,CAAC;AASF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,IAAI,CAoCrF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,IAAI,CAoCzF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI,GAAG,WAAW,CAAC,aAAa,CAAC,CA0BhG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqBpE"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/engine/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAMnD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAM1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAM1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,SAAS,aAAa,EAM3D,CAAC;AASF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,IAAI,CAoCrF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,IAAI,CAmCzF;AAID,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI,GAAG,WAAW,CAAC,aAAa,CAAC,CAuBhG;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqBpE"}

package/dist/engine/pipeline.js

@@ -98,37 +98,28 @@ export function atomicPipelineStage(phase) {
             return 'complete';
         case 'refunded':
         case 'cancelled':
-            // Atomic-flow refund/cancel both end with BTC returned to the buyer;
-            // the pipeline should render the refund variant (final stage chip
-            // labelled "Refunded") rather than masquerading as a completed swap.
+            // Atomic refund/cancel both return BTC to the buyer; render the refund
+            // chip rather than pretending the swap completed.
             return 'refunded';
         case 'failed':
             return null;
     }
 }
-/**
- * Compute which pipeline stages are "done" given the current phase.
- * Returns a Set of stage keys that should show as completed.
- *
- * Both 'cancelling' and 'complete' sit after the base 4 stages,
- * so all base stages are marked done when either is current.
- */
+// 'cancelling' and 'complete' both sit past the base 4 stages, so the
+// base stages are all marked done when either is current.
 export function computeDoneStages(currentStage) {
     if (!currentStage)
         return new Set();
     if (currentStage === 'cancelling' || currentStage === 'complete') {
         return new Set(STAGE_ORDER);
     }
-    // For a refund, the swap reached `confirming` cleanly (BTC was observed by
-    // the chain) before THORChain rejected at the swap step. Treat pending/
-    // deposit/confirming as "done" so the renderer can color them green; the
-    // last two stages (exchanging + refunded) are then the warn region.
+    // Refund means BTC was on-chain (THORChain rejected at the swap step).
+    // Mark pending/deposit/confirming green; exchanging + refunded are warn.
     if (currentStage === 'refunded') {
         return new Set(['pending', 'deposit', 'confirming']);
     }
-    // For expiry, the swap was created but the deposit window closed before
-    // any funds arrived on-chain. Only `pending` (we created the swap on the
-    // server) is unambiguously done; `deposit` onward never actually happened.
+    // Expiry means swap created but deposit window closed before any funds
+    // arrived. Only 'pending' is unambiguously done.
     if (currentStage === 'expired') {
         return new Set(['pending']);
     }
@@ -137,10 +128,7 @@ export function computeDoneStages(currentStage) {
         return new Set();
     return new Set(STAGE_ORDER.slice(0, idx));
 }
-/**
- * Map server status to pipeline stage. ONE map, used by all flows.
- * Returns null for unknown statuses — caller must skip.
- */
+// One map shared by every flow. Returns null on unknown status; caller skips.
 export function mapServerStatus(status) {
     switch (status) {
         case 'initializing':

package/dist/engine/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/engine/pipeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/engine/pipeline.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC1C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC1C,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC9D,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC1C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC1C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC9D,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC1C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC1C,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACpC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC1C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC1C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;CACrC,CAAC;AAEF,MAAM,WAAW,GAA6B;IAC5C,SAAS;IACT,SAAS;IACT,YAAY;IACZ,YAAY;CACb,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW,CAAC;QACjB,KAAK,eAAe,CAAC;QACrB,KAAK,aAAa,CAAC;QACnB,KAAK,eAAe,CAAC;QACrB,KAAK,gBAAgB,CAAC;QACtB,KAAK,kBAAkB;YACrB,OAAO,IAAI,CAAC;QACd,KAAK,aAAa,CAAC;QACnB,KAAK,eAAe;YAClB,OAAO,SAAS,CAAC;QACnB,KAAK,kBAAkB,CAAC;QACxB,KAAK,qBAAqB;YACxB,OAAO,SAAS,CAAC;QACnB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC;QACtB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB,KAAK,WAAW;YACd,OAAO,UAAU,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW;YACd,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,gBAAgB;YACnB,OAAO,SAAS,CAAC;QACnB,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,eAAe,CAAC;QACrB,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC;QACtB,KAAK,kBAAkB,CAAC;QACxB,KAAK,YAAY,CAAC;QAClB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,sBAAsB;YACzB,OAAO,YAAY,CAAC;QACtB,KAAK,kBAAkB,CAAC;QACxB,KAAK,YAAY,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,YAAY,CAAC;QACtB,KAAK,WAAW;YACd,OAAO,UAAU,CAAC;QACpB,KAAK,UAAU,CAAC;QAChB,KAAK,WAAW;YACd,uEAAuE;YACvE,kDAAkD;YAClD,OAAO,UAAU,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,YAAkC;IAClE,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAEpC,IAAI,YAAY,KAAK,YAAY,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QACjE,OAAO,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IAED,uEAAuE;IACvE,yEAAyE;IACzE,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,uEAAuE;IACvE,iDAAiD;IACjD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAE9B,OAAO,IAAI,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,cAAc,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,kBAAkB;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,YAAY,CAAC;QACtB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC;QACtB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/engine/platform.d.ts

@@ -1,32 +1,14 @@
-/**
- * Platform adapter — injected into the engine at creation time.
- *
- * Implementations:
- *   - NodeAdapter (src/adapters/node-adapter.ts): Electrum, filesystem, qrcode-terminal
- *   - BrowserAdapter (web/adapters/browser-adapter.ts): mempool, localStorage, QR canvas
- */
 import type { SwapKeystore } from '../lib/keystore.js';
 import type { Logger } from '../interfaces/logger.js';
 import type { BlockchainQuerier } from './blockchain-querier.js';
 import type { BlockchainDataProvider } from '../interfaces/blockchain.js';
 import type { ProtocolParams } from '../types/index.js';
-/**
- * Individual UTXO used as a PSBT input.
- */
 export interface UtxoInput {
     readonly txid: string;
     readonly vout: number;
     readonly value: number;
     readonly height: number;
 }
-/**
- * Detected deposit on a BTC address.
- * Returned by watchDeposit() and loadDeposit().
- *
- * When multiple UTXOs exist on the address, `value` is the sum of all
- * UTXOs, `txid`/`vout` refer to the primary (first) UTXO, and the
- * individual UTXOs are available in the `utxos` array.
- */
 export interface DetectedDeposit {
     readonly txid: string;
     readonly vout: number;
@@ -35,23 +17,13 @@ export interface DetectedDeposit {
     readonly status: 'mempool' | 'confirmed';
     readonly utxos?: readonly UtxoInput[];
 }
-/**
- * Fee estimation result.
- */
 export interface FeeEstimate {
     readonly feeSats: number;
     readonly feeRate: number;
 }
-/**
- * Keystore persistence result.
- * TUI: filesystem path. Browser: localStorage key or "downloaded".
- */
 export interface KeystoreSaveResult {
     readonly id: string;
 }
-/**
- * Keystore metadata for listing (not the actual keys).
- */
 export interface KeystoreMetadata {
     readonly id: string;
     readonly btcAddress: string;
@@ -67,154 +39,22 @@ export interface KeystoreMetadata {
 }
 export type KeystoreStatus = 'created' | 'awaiting_deposit' | 'deposited' | 'swap_created' | 'completed' | 'swept' | 'cancelled';
 export interface PlatformAdapter {
-    /**
-     * Watch for a BTC deposit to the given address.
-     * Resolves when a deposit is detected (mempool or confirmed).
-     *
-     * TUI: Uses Electrum (primary) with mempool.space fallback.
-     * Browser: Uses mempool.space REST API polling.
-     */
     watchDeposit(address: string, network: 'mainnet' | 'testnet' | 'regtest', signal: AbortSignal, onStatus?: (msg: string) => void): Promise<DetectedDeposit>;
-    /**
-     * One-shot deposit check. Returns null if no deposit found.
-     */
     checkDeposit(address: string, network: 'mainnet' | 'testnet' | 'regtest'): Promise<DetectedDeposit | null>;
-    /**
-     * Fetch a specific UTXO for a known address.
-     * Used when resuming a swap where deposit is known but UTXO details are stale.
-     */
     fetchUtxo(address: string, network: 'mainnet' | 'testnet' | 'regtest'): Promise<DetectedDeposit | null>;
-    /**
-     * Estimate mining fee for the lock transaction.
-     *
-     * TUI: Tries Electrum blockchain.estimatefee, falls back to mempool.space.
-     * Browser: Uses mempool.space /v1/fees/recommended.
-     */
     estimateFee(network: 'mainnet' | 'testnet' | 'regtest'): Promise<FeeEstimate>;
-    /**
-     * Persist a keystore. The keystore contains private keys and must be
-     * stored securely.
-     *
-     * TUI: Writes to filesystem with 0o600 permissions.
-     * Browser: Saves to localStorage AND triggers download as backup.
-     *
-     * @returns Opaque identifier (filesystem path or localStorage key).
-     */
     saveKeystore(keystore: SwapKeystore, label: string): Promise<KeystoreSaveResult>;
-    /**
-     * Load a keystore by its identifier.
-     *
-     * TUI: Reads from filesystem path.
-     * Browser: Reads from localStorage by key.
-     */
     loadKeystore(id: string): Promise<SwapKeystore>;
-    /**
-     * List all stored keystores. Returns metadata, not the actual keys.
-     *
-     * TUI: Reads from SQLite keystores table.
-     * Browser: Reads from localStorage index.
-     */
     listKeystores(): Promise<readonly KeystoreMetadata[]>;
-    /**
-     * Delete a completed keystore.
-     *
-     * TUI: Deletes file + SQLite record.
-     * Browser: Removes from localStorage.
-     */
     deleteKeystore(id: string): Promise<void>;
-    /**
-     * Optional write-through cache of per-swap protocol parameters keyed by
-     * `swapId`. Server-returned `ProtocolParams` (pubkeys, fees, timelocks,
-     * refund encsigs) are written here on every successful `getSwapDetail`
-     * that surfaces them; client-side refund falls back to `loadSwapProtocol`
-     * when the server is briefly unreachable or has lost the record.
-     *
-     * Stored data is PUBLIC — encrypted signatures, addresses, and numeric
-     * params — so it does not require the keystore's secret-material
-     * protections. Unencrypted filesystem / localStorage is acceptable.
-     *
-     * Implement in pairs or not at all: the SDK only uses the cache when
-     * both callbacks are present. Adapters that cannot persist (e.g., stub
-     * platforms for unit tests) can omit both and the feature no-ops.
-     *
-     * Suggested backends:
-     *   - TUI: SQLite `swap_protocol` table, keyed by swap id.
-     *   - Browser: `localStorage` with key `miradex.protocol.${swapId}`.
-     *   - Desktop: same filesystem layout as keystores, different subdir.
-     */
     readonly saveSwapProtocol?: (swapId: string, params: ProtocolParams) => Promise<void>;
-    /**
-     * Optional counterpart to `saveSwapProtocol`. Returns `null` when no
-     * cached entry exists for this swap. Must not throw on cache miss —
-     * use `null` so the SDK can treat miss and error distinctly.
-     */
     readonly loadSwapProtocol?: (swapId: string) => Promise<ProtocolParams | null>;
-    /**
-     * Persist the one-shot recovery snapshot for a swap. The SDK writes it
-     * exactly once, between `/presigs` (encsig received) and `/fund`
-     * (broadcast) — so the snapshot is on disk before any on-chain commitment.
-     * Together with the keystore it lets a recovery binary (eigenwallet swap
-     * CLI) drive the swap to a terminal state.
-     *
-     * Snapshot data is PUBLIC (Alice's encsig, protocol params, maker info,
-     * unsigned PSBT) — no secret material — so unencrypted filesystem /
-     * localStorage is fine. Must fsync / chmod 0o600 on platforms that
-     * support it so the file survives crashes and doesn't leak to other users.
-     *
-     * Implement in pairs or not at all: when both are absent, the SDK emits
-     * a warning and proceeds without a snapshot (and cross-binary recovery
-     * for that swap is not available).
-     *
-     * Suggested backends:
-     *   - TUI: `~/.miradex-tui/protocol-snapshots/<swapId>.snapshot.json`.
-     *   - Desktop: `<userData>/protocol-snapshots/<swapId>.snapshot.json`.
-     *   - Browser: IndexedDB entry + triggered download.
-     */
     readonly saveProtocolSnapshot?: (swapId: string, snapshotJson: string) => Promise<void>;
-    /**
-     * Counterpart to `saveProtocolSnapshot`. Returns `null` on cache miss.
-     * Used by the SDK to skip re-writing a snapshot it already persisted.
-     */
     readonly loadProtocolSnapshot?: (swapId: string) => Promise<string | null>;
-    /**
-     * Generate a QR code representation for the given text.
-     *
-     * TUI: Uses qrcode-terminal to generate ASCII art.
-     * Browser: Uses qrcode library to generate data URL or SVG.
-     */
     generateQr(text: string): Promise<string>;
-    /**
-     * Broadcast a raw Bitcoin transaction.
-     *
-     * TUI: Tries Electrum, falls back to mempool.space POST /tx.
-     * Browser: Uses mempool.space POST /tx.
-     */
     broadcastTx(rawHex: string, network: 'mainnet' | 'testnet' | 'regtest'): Promise<string>;
-    /**
-     * Create a blockchain data querier for the given network.
-     *
-     * Node.js: Returns an Electrum-backed querier (TCP/TLS).
-     * Browser: Returns a mempool.space-backed querier (HTTP fetch).
-     *
-     * The core's discoverAndVerifyTxCancel() uses this querier to
-     * independently verify TxCancel on-chain without trusting the server.
-     */
     createBlockchainQuerier(network: 'mainnet' | 'testnet' | 'regtest'): BlockchainQuerier;
-    /**
-     * Create a BlockchainDataProvider for the given network.
-     * Used by core's existing discoverAndVerifyTxCancel() which uses
-     * Electrum-style scriptHash-based queries.
-     *
-     * Node.js: Returns ElectrumClient-backed provider.
-     * Browser: Returns mempool.space-backed provider.
-     */
     createBlockchainProvider(network: 'mainnet' | 'testnet' | 'regtest'): Promise<BlockchainDataProvider>;
-    /**
-     * Structured logger.
-     *
-     * TUI: Pino logger writing to ~/.config/miradex/logs/miradex.log.
-     * Browser: console.debug/info/warn/error.
-     */
     readonly logger: Logger;
 }
 //# sourceMappingURL=platform.d.ts.map