@silentswap/sdk 0.0.76 → 0.0.77

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export * from './rpc.js';
 export * from './assets.js';
 export * from './encoding.js';
 export * from './refund.js';
+export { trackOrderViaWebSocket, getOrderTrackingWebSocketUrl, type TrackOrderOptions, type OrderStatusUpdate, } from './order-tracking.js';
 export type { NaiveBase58, NaiveBase93, NaiveHexLower, NaiveHexUpper } from './belt-utils.js';
 export { bytes_to_base58, base58_to_bytes, bytes_to_base93, base93_to_bytes, bytes_to_hex, hex_to_bytes } from './belt-utils.js';
 export * from './address.js';

package/dist/index.js

@@ -17,6 +17,7 @@ export * from './rpc.js';
 export * from './assets.js';
 export * from './encoding.js';
 export * from './refund.js';
+export { trackOrderViaWebSocket, getOrderTrackingWebSocketUrl, } from './order-tracking.js';
 export { bytes_to_base58, base58_to_bytes, bytes_to_base93, base93_to_bytes, bytes_to_hex, hex_to_bytes } from './belt-utils.js';
 export * from './address.js';
 // Export asset-utils functions (AssetInfo-based wrappers)

package/dist/order-tracking.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Order tracking via WebSocket
+ *
+ * Subscribe to order status updates from the SilentSwap API until the order
+ * is fully finalized or the connection times out.
+ */
+import type { OrderStatus, OutputStage } from './swap-executor.js';
+/**
+ * Incremental status update from the WebSocket stream
+ */
+export interface OrderStatusUpdate {
+    type: 'deposit' | 'stage' | 'transaction' | 'error';
+    data: {
+        stage?: OutputStage;
+        index?: number;
+        kind?: string;
+        chain?: string;
+        txId?: string;
+        message?: string;
+        amount?: string;
+        orderId?: string;
+    };
+}
+/**
+ * Options for trackOrderViaWebSocket
+ */
+export interface TrackOrderOptions {
+    /** WebSocket URL (default: derived from mainnet API) */
+    wsUrl?: string;
+    /** Timeout in milliseconds (default: 10 * 60 * 1000 = 10 minutes) */
+    timeoutMs?: number;
+    /** Callback for each status update */
+    onStatus?: (update: OrderStatusUpdate) => void;
+}
+/**
+ * Derive WebSocket URL from REST API base URL
+ * e.g. https://api.silentswap.com -> wss://api.silentswap.com/websocket
+ */
+export declare function getOrderTrackingWebSocketUrl(baseUrl: string): string;
+/**
+ * Track an order until all outputs are finalized via the SilentSwap WebSocket API.
+ * Uses the global WebSocket (available in Node 18+ and browsers).
+ *
+ * @param orderId - Base58 order ID returned when placing the order
+ * @param viewingAuth - Viewing authorization (Base58) from the facilitator group
+ * @param options - Optional wsUrl, timeoutMs, and onStatus callback
+ * @returns Final order status when all outputs are FINALIZED
+ * @throws Error on WebSocket error, invalid response, or timeout
+ */
+export declare function trackOrderViaWebSocket(orderId: string, viewingAuth: string, options?: TrackOrderOptions): Promise<OrderStatus>;

package/dist/order-tracking.js

@@ -0,0 +1,131 @@
+/**
+ * Order tracking via WebSocket
+ *
+ * Subscribe to order status updates from the SilentSwap API until the order
+ * is fully finalized or the connection times out.
+ */
+/** Stage name used to detect completion */
+const STAGE_FINALIZED = 'FINALIZED';
+const DEFAULT_WS_URL = 'wss://api.silentswap.com/websocket';
+const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
+/**
+ * Derive WebSocket URL from REST API base URL
+ * e.g. https://api.silentswap.com -> wss://api.silentswap.com/websocket
+ */
+export function getOrderTrackingWebSocketUrl(baseUrl) {
+    const url = baseUrl.replace(/^http:\/\//i, 'ws://').replace(/^https:\/\//i, 'wss://');
+    const trimmed = url.replace(/\/+$/, '');
+    return `${trimmed}/websocket`;
+}
+/**
+ * Track an order until all outputs are finalized via the SilentSwap WebSocket API.
+ * Uses the global WebSocket (available in Node 18+ and browsers).
+ *
+ * @param orderId - Base58 order ID returned when placing the order
+ * @param viewingAuth - Viewing authorization (Base58) from the facilitator group
+ * @param options - Optional wsUrl, timeoutMs, and onStatus callback
+ * @returns Final order status when all outputs are FINALIZED
+ * @throws Error on WebSocket error, invalid response, or timeout
+ */
+export function trackOrderViaWebSocket(orderId, viewingAuth, options = {}) {
+    const wsUrl = options.wsUrl ?? DEFAULT_WS_URL;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const onStatus = options.onStatus;
+    return new Promise((resolve, reject) => {
+        if (typeof WebSocket === 'undefined') {
+            reject(new Error('WebSocket is not available. Use Node 18+ or a browser.'));
+            return;
+        }
+        const ws = new WebSocket(wsUrl);
+        let requestId = 0;
+        let finalStatus = null;
+        let heartbeatInterval;
+        const cleanup = () => {
+            if (heartbeatInterval) {
+                clearInterval(heartbeatInterval);
+                heartbeatInterval = undefined;
+            }
+            try {
+                if (ws.readyState === 1)
+                    ws.close();
+            }
+            catch {
+                // ignore
+            }
+        };
+        const tryResolve = () => {
+            if (finalStatus?.outputs?.every((o) => o.stage === STAGE_FINALIZED)) {
+                cleanup();
+                resolve(finalStatus);
+            }
+        };
+        ws.onopen = () => {
+            ws.send(JSON.stringify({
+                jsonrpc: '2.0',
+                id: requestId++,
+                method: 'connect',
+                params: { auth: { orderId, viewingAuth } },
+            }));
+            heartbeatInterval = setInterval(() => {
+                if (ws.readyState === 1) {
+                    const withPing = ws;
+                    try {
+                        withPing.ping?.();
+                    }
+                    catch {
+                        // ignore (browser WebSocket has no ping)
+                    }
+                }
+            }, 30000);
+        };
+        ws.onmessage = (event) => {
+            try {
+                const msg = JSON.parse(typeof event.data === 'string' ? event.data : String(event.data));
+                if (msg.error) {
+                    if (msg.error.code === -32000)
+                        return; // order not found yet
+                    cleanup();
+                    reject(new Error(msg.error.message ?? 'WebSocket error'));
+                    return;
+                }
+                if (msg.result) {
+                    if (msg.result.priority) {
+                        finalStatus = msg.result;
+                        onStatus?.({ type: 'deposit', data: { orderId: finalStatus.deposit?.orderId, amount: finalStatus.deposit?.amount } });
+                        tryResolve();
+                    }
+                    else if (msg.result.type) {
+                        const update = msg.result;
+                        onStatus?.(update);
+                        if (update.type === 'stage' && update.data.stage === STAGE_FINALIZED && finalStatus?.outputs?.[update.data.index ?? -1]) {
+                            finalStatus.outputs[update.data.index].stage = STAGE_FINALIZED;
+                            tryResolve();
+                        }
+                    }
+                }
+            }
+            catch {
+                // ignore parse errors
+            }
+        };
+        ws.onerror = (event) => {
+            cleanup();
+            reject(new Error('WebSocket error'));
+        };
+        ws.onclose = () => {
+            cleanup();
+            if (finalStatus)
+                resolve(finalStatus);
+        };
+        setTimeout(() => {
+            if (finalStatus) {
+                cleanup();
+                resolve(finalStatus);
+            }
+            else {
+                cleanup();
+                reject(new Error('Order tracking timeout'));
+            }
+        }, timeoutMs);
+    });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@silentswap/sdk",
   "type": "module",
-  "version": "0.0.76",
+  "version": "0.0.77",
   "license": "MIT",
   "main": "dist/index.js",
   "files": [