@miradexio/client 0.1.0

package/dist/engine/flow-context.js

@@ -0,0 +1,147 @@
+/**
+ * Zod-enforced FlowContext schemas.
+ *
+ * Three strictness levels:
+ *   FlowContext          — base, nullable fields (early phases: keygen, creating-swap)
+ *   PopulatedFlowContext — snapshot-critical fields non-empty (awaiting-deposit, deposit-detected)
+ *   VerifiedFlowContext  — populated + verification non-null (signing, funding, confirming, swapping)
+ *
+ * Types are inferred from schemas — one source of truth, zero drift.
+ * Validation uses safeParse — never throws, returns structured errors.
+ */
+import { z } from 'zod';
+const VerificationCheckSchema = z.object({
+    name: z.string(),
+    passed: z.boolean(),
+    detail: z.string(),
+});
+const VerificationResultSchema = z.object({
+    verified: z.boolean(),
+    provider: z.string(),
+    checks: z.array(VerificationCheckSchema).readonly(),
+    timestamp: z.number(),
+});
+const EXTRA_TYPES = ['prompt', 'message', 'warning', 'error'];
+const FlowContextExtraSchema = z.object({
+    text: z.string().min(1, 'extra.text must not be empty'),
+    type: z.enum(EXTRA_TYPES),
+});
+// Used by early phases where data may not be available yet.
+// Every field is nullable — the engine builds it up progressively.
+const FlowContextBaseSchema = z.object({
+    // Addresses
+    depositAddr: z.string().nullable(),
+    destAddress: z.string().nullable(),
+    refundAddress: z.string().nullable(),
+    keystoreId: z.string().nullable(),
+    // Amounts
+    depositAmount: z.string().nullable(),
+    fromToken: z.string().nullable(),
+    toToken: z.string().nullable(),
+    expectedOut: z.string().nullable(),
+    amountInUsd: z.string().nullable(),
+    expectedOutUsd: z.string().nullable(),
+    // Display
+    qr: z.string().nullable(),
+    verification: VerificationResultSchema.nullable(),
+    verificationSourceUrl: z.string().nullable(),
+    expiresAt: z.string().nullable(),
+    depositMemo: z.string().nullable(),
+    // Identity
+    provider: z.string().nullable(),
+    swapId: z.string().nullable(),
+    swapNumber: z.string().nullable(),
+    // Contextual
+    extra: FlowContextExtraSchema.nullable(),
+});
+// Used by deposit-ready phases. Critical snapshot fields MUST be
+// non-empty strings — Zod rejects "" and null at runtime.
+const PopulatedFlowContextSchema = FlowContextBaseSchema.extend({
+    depositAddr: z.string().min(1, 'depositAddr is required for this phase'),
+    destAddress: z.string().min(1, 'destAddress is required for this phase'),
+    fromToken: z.string().min(1, 'fromToken is required for this phase'),
+    toToken: z.string().min(1, 'toToken is required for this phase'),
+    qr: z.string().min(1, 'qr is required for this phase'),
+    provider: z.string().min(1, 'provider is required for this phase'),
+    // `expectedOut` stays nullable here on purpose. It's display-only —
+    // populated from a /quotes round-trip that can legitimately fail
+    // (transient API hiccup, no maker available for the amount, atomicswap
+    // provider not in the quote set). The deposit, swap, and refund paths
+    // do not depend on knowing the exact expected output, so blocking
+    // `deposit-detected` on it would force the SDK to fail a swap that's
+    // otherwise progressing fine. UIs already handle null with a "—".
+    expectedOut: z.string().nullable(),
+});
+// Used by post-verification phases. Everything populated + verification
+// MUST be a valid VerificationResult (non-null).
+const VerifiedFlowContextSchema = PopulatedFlowContextSchema.extend({
+    verification: VerificationResultSchema,
+});
+// Re-export schemas for consumers that need them (tests, browser adapter)
+export { FlowContextBaseSchema, PopulatedFlowContextSchema, VerifiedFlowContextSchema, FlowContextExtraSchema, VerificationResultSchema, VerificationCheckSchema, };
+// Use safeParse — never throw. Return structured error listing every
+// missing/invalid field. The engine calls these before emitting phases.
+function buildValidationError(phase, zodError) {
+    const fields = zodError.issues.map((issue) => issue.path.join('.'));
+    const details = zodError.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+    return {
+        phase,
+        fields,
+        message: `FlowContext validation failed for phase '${phase}': ${details.join('; ')}`,
+    };
+}
+export function validateBase(ctx, phase) {
+    const result = FlowContextBaseSchema.safeParse(ctx);
+    if (result.success)
+        return { ok: true, data: result.data };
+    return { ok: false, error: buildValidationError(phase, result.error) };
+}
+export function validatePopulated(ctx, phase) {
+    const result = PopulatedFlowContextSchema.safeParse(ctx);
+    if (result.success)
+        return { ok: true, data: result.data };
+    return { ok: false, error: buildValidationError(phase, result.error) };
+}
+export function validateVerified(ctx, phase) {
+    const result = VerifiedFlowContextSchema.safeParse(ctx);
+    if (result.success)
+        return { ok: true, data: result.data };
+    return { ok: false, error: buildValidationError(phase, result.error) };
+}
+const EMPTY_FLOW_CONTEXT = {
+    depositAddr: null,
+    destAddress: null,
+    refundAddress: null,
+    keystoreId: null,
+    depositAmount: null,
+    fromToken: null,
+    toToken: null,
+    expectedOut: null,
+    amountInUsd: null,
+    expectedOutUsd: null,
+    qr: null,
+    verification: null,
+    verificationSourceUrl: null,
+    expiresAt: null,
+    depositMemo: null,
+    provider: null,
+    swapId: null,
+    swapNumber: null,
+    extra: null,
+};
+/**
+ * Create a new FlowContext with defaults, overriding with provided values.
+ * Null values in partial are applied (they mean "not yet known").
+ */
+export function createFlowContext(partial) {
+    return { ...EMPTY_FLOW_CONTEXT, ...partial };
+}
+/**
+ * Merge an update into an existing FlowContext.
+ * Only non-undefined keys in partial overwrite. Null IS a valid value
+ * (it means "reset to unknown").
+ */
+export function mergeFlowContext(current, partial) {
+    return { ...current, ...partial };
+}
+//# sourceMappingURL=flow-context.js.map

package/dist/engine/flow-context.js.map

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

package/dist/engine/flows/atomic-flow-state.d.ts

@@ -0,0 +1,124 @@
+import type { RequiredAction } from '../../types/index.js';
+import type { FlowContext, PopulatedFlowContext, VerifiedFlowContext } from '../flow-context.js';
+export interface AtomicIdlePhase {
+    readonly phase: 'idle';
+    readonly snapshot: null;
+}
+export interface AtomicKeygenPhase {
+    readonly phase: 'keygen';
+    readonly snapshot: FlowContext | null;
+    readonly message: string;
+}
+export interface AtomicKeystoreSavedPhase {
+    readonly phase: 'keystore-saved';
+    readonly snapshot: FlowContext;
+    readonly message: string;
+}
+export interface AtomicAwaitingDepositPhase {
+    readonly phase: 'awaiting-deposit';
+    readonly snapshot: PopulatedFlowContext;
+    readonly message: string;
+}
+export interface AtomicDepositDetectedPhase {
+    readonly phase: 'deposit-detected';
+    readonly snapshot: PopulatedFlowContext;
+    readonly deposit: {
+        readonly txid: string;
+        readonly vout: number;
+        readonly value: number;
+        readonly utxos?: readonly {
+            readonly txid: string;
+            readonly vout: number;
+            readonly value: number;
+        }[];
+    };
+    readonly message: string;
+}
+export interface AtomicCreatingSwapPhase {
+    readonly phase: 'creating-swap';
+    readonly snapshot: FlowContext;
+    readonly message: string;
+}
+export interface AtomicVerifyingPhase {
+    readonly phase: 'verifying';
+    readonly snapshot: FlowContext;
+    readonly message: string;
+}
+export interface AtomicSigningPhase {
+    readonly phase: 'signing';
+    readonly snapshot: VerifiedFlowContext;
+    readonly message: string;
+}
+export interface AtomicFundingPhase {
+    readonly phase: 'funding';
+    readonly snapshot: VerifiedFlowContext;
+    readonly message: string;
+}
+export interface AtomicComputingEncsigPhase {
+    readonly phase: 'computing-encsig';
+    readonly snapshot: VerifiedFlowContext;
+    readonly message: string;
+}
+export interface AtomicConfirmingPhase {
+    readonly phase: 'confirming';
+    readonly snapshot: VerifiedFlowContext;
+    readonly message: string;
+}
+export interface AtomicSwappingPhase {
+    readonly phase: 'swapping';
+    readonly snapshot: VerifiedFlowContext;
+    readonly message: string;
+}
+export interface AtomicSweepingPhase {
+    readonly phase: 'sweeping';
+    readonly snapshot: VerifiedFlowContext;
+    readonly message: string;
+    readonly sweepStep: 'get-outputs' | 'key-images' | 'submitting' | 'broadcasting';
+}
+export interface AtomicAwaitingUserActionPhase {
+    readonly phase: 'awaiting-user-action';
+    readonly snapshot: VerifiedFlowContext;
+    readonly requiredAction: RequiredAction;
+    readonly error: string | null;
+}
+export interface AtomicVerifyingCancelPhase {
+    readonly phase: 'verifying-cancel';
+    readonly snapshot: FlowContext;
+    readonly message: string;
+}
+export interface AtomicCancellingPhase {
+    readonly phase: 'cancelling';
+    readonly snapshot: FlowContext;
+    readonly message: string;
+}
+export interface AtomicRefundingPhase {
+    readonly phase: 'refunding';
+    readonly snapshot: FlowContext;
+    readonly message: string;
+}
+export interface AtomicCompletedPhase {
+    readonly phase: 'completed';
+    readonly snapshot: FlowContext;
+    readonly outputTxHash: string | null;
+    readonly actualOut: string;
+    readonly durationSec: number | null;
+}
+export interface AtomicRefundedPhase {
+    readonly phase: 'refunded';
+    readonly snapshot: FlowContext | null;
+    readonly swapId: string;
+    readonly refundTxid: string | null;
+}
+export interface AtomicCancelledPhase {
+    readonly phase: 'cancelled';
+    readonly snapshot: FlowContext | null;
+    readonly swapId: string | null;
+    readonly txCancelTxid: string | null;
+}
+export interface AtomicFailedPhase {
+    readonly phase: 'failed';
+    readonly snapshot: FlowContext | null;
+    readonly error: string;
+}
+export type AtomicFlowState = AtomicIdlePhase | AtomicKeygenPhase | AtomicKeystoreSavedPhase | AtomicAwaitingDepositPhase | AtomicDepositDetectedPhase | AtomicCreatingSwapPhase | AtomicVerifyingPhase | AtomicSigningPhase | AtomicFundingPhase | AtomicComputingEncsigPhase | AtomicConfirmingPhase | AtomicSwappingPhase | AtomicSweepingPhase | AtomicAwaitingUserActionPhase | AtomicVerifyingCancelPhase | AtomicCancellingPhase | AtomicRefundingPhase | AtomicCompletedPhase | AtomicRefundedPhase | AtomicCancelledPhase | AtomicFailedPhase;
+//# sourceMappingURL=atomic-flow-state.d.ts.map

package/dist/engine/flows/atomic-flow-state.d.ts.map

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

package/dist/engine/flows/atomic-flow-state.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atomic-flow-state.js.map

package/dist/engine/flows/atomic-flow-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-flow-state.js","sourceRoot":"","sources":["../../../src/engine/flows/atomic-flow-state.ts"],"names":[],"mappings":""}

package/dist/engine/flows/atomic-flow.d.ts

@@ -0,0 +1,88 @@
+import type { ApiClient } from '../../api/index.js';
+import type { PlatformAdapter } from '../platform.js';
+import type { ResolvedEngineConfig } from '../miradex-engine.js';
+import type { AtomicFlowState } from './atomic-flow-state.js';
+export interface AtomicFlowOptions {
+    readonly pollMs?: number;
+}
+export declare class AtomicFlow {
+    private readonly api;
+    private readonly platform;
+    private readonly config;
+    private readonly emitFn;
+    private abortController;
+    private userActionResolver;
+    private keystore;
+    private deposit;
+    private keystoreId;
+    private lastEmittedState;
+    private flowCtx;
+    private lastProgressKey;
+    private readonly pollMs;
+    /**
+     * True once the driver has emitted a terminal phase (`completed`,
+     * `failed`, `refunded`, etc.). Used to suppress the post-driver
+     * `requiredAction` re-check that would otherwise trigger a phantom
+     * second sweep — the server has no scanner for the on-chain XMR sweep,
+     * so a fresh `getSwapDetail` right after the driver completes still
+     * reports `requiredAction.type === 'sweep'`.
+     */
+    private hasReachedTerminal;
+    /**
+     * Optional maker pin forwarded to `coreResumeAtomicSwap` via
+     * `params.variantId`. Set by `start()` from `StartAtomicSwapParams`;
+     * unused (and irrelevant) on the resume path because the maker is
+     * already chosen at that point.
+     */
+    private variantId;
+    constructor(api: ApiClient, platform: PlatformAdapter, config: ResolvedEngineConfig, emitFn: (state: AtomicFlowState) => void, options?: AtomicFlowOptions);
+    private get signal();
+    private get logger();
+    private setFlowContext;
+    /**
+     * Validate FlowContext as PopulatedFlowContext.
+     * On failure, emits a 'failed' phase with structured error and returns null.
+     */
+    private requirePopulated;
+    /**
+     * Validate FlowContext as VerifiedFlowContext.
+     * On failure, emits a 'failed' phase with structured error and returns null.
+     */
+    private requireVerified;
+    private emitError;
+    private transition;
+    cancel(): void;
+    start(params: {
+        readonly amount: string;
+        readonly destAddress: string;
+        readonly refundAddress: string;
+        readonly variantId?: string;
+        readonly existingKeystoreId?: string;
+    }): Promise<void>;
+    resumeFromKeystore(keystoreId: string, existingSwapId?: string): Promise<void>;
+    private fetchDetailWithRetry;
+    private driveSwapToCompletion;
+    private mapCoreProgress;
+    userCancel(): Promise<void>;
+    userRefund(): Promise<void>;
+    userRetrySweep(): Promise<void>;
+    private executeSweep;
+    private executeRefund;
+    private resolveLockAddress;
+    /**
+     * Read protocol params from the server response; fall back to the platform
+     * adapter's optional write-through cache when the server didn't return the
+     * refund encsig. On success from the server, populate the cache so later
+     * refunds survive a briefly-unreachable backend.
+     */
+    private resolveProtocolParams;
+    private cacheProtocolParams;
+    private emitRefundAborted;
+    private pollUntilTerminal;
+    private emitTerminal;
+    private resumeActionLoop;
+    private checkAborted;
+    private handleError;
+    private getCurrentAwaitingActionState;
+}
+//# sourceMappingURL=atomic-flow.d.ts.map

package/dist/engine/flows/atomic-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-flow.d.ts","sourceRoot":"","sources":["../../../src/engine/flows/atomic-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,wBAAwB,CAAC;AA2EnF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,UAAU;IA6BnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IA/BzB,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAAqB;gBAGnB,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,EACzD,OAAO,CAAC,EAAE,iBAAiB;IAK7B,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,CAAC,cAAc;IAMtB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,UAAU;IAWlB,MAAM,IAAI,IAAI;IAMR,KAAK,CAAC,MAAM,EAAE;QAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACtC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgLX,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YA6NtE,oBAAoB;YAyBpB,qBAAqB;IA2EnC,OAAO,CAAC,eAAe;IAiLjB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;YAOvB,YAAY;YA6EZ,aAAa;IA8M3B,OAAO,CAAC,kBAAkB;IAU1B;;;;;OAKG;YACW,qBAAqB;YAiCrB,mBAAmB;IAiBjC,OAAO,CAAC,iBAAiB;YAUX,iBAAiB;IA0C/B,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,6BAA6B;CAItC"}