@123456btc/123456btc-cli 1.0.5 → 1.0.6

package/dist/exchange/v2/executor/risk.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Risk Guard — Pre-execution checks
+ * Validates every order against configurable risk limits before sending to exchange.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RiskGuard = void 0;
+class RiskGuard {
+    limits;
+    dailyLoss = 0;
+    openOrderCount = 0;
+    persistence;
+    constructor(limits, persistence) {
+        this.limits = limits;
+        this.persistence = persistence;
+        // Load persisted state asynchronously
+        if (persistence) {
+            Promise.resolve(persistence.load()).then((state) => {
+                this.dailyLoss = state.dailyLoss;
+                this.openOrderCount = state.openOrders;
+            }).catch((err) => {
+                console.error('[RiskGuard] failed to load persisted state:', err);
+            });
+        }
+    }
+    _save() {
+        if (this.persistence) {
+            Promise.resolve(this.persistence.save({ dailyLoss: this.dailyLoss, openOrders: this.openOrderCount }))
+                .catch((err) => console.error('[RiskGuard] failed to persist state:', err));
+        }
+    }
+    /** Update running daily loss tracker (call on each filled order PnL) */
+    recordPnl(pnl) {
+        if (pnl < 0)
+            this.dailyLoss += Math.abs(pnl);
+        this._save();
+    }
+    recordOrderOpened() { this.openOrderCount++; this._save(); }
+    recordOrderClosed() { this.openOrderCount = Math.max(0, this.openOrderCount - 1); this._save(); }
+    resetDailyStats() {
+        this.dailyLoss = 0;
+        this._save();
+    }
+    async check(order, ticker) {
+        const results = [];
+        let worstAction = 'allow';
+        let adjustedRequest;
+        // ── 1. Symbol Whitelist / Blacklist ──────────────────────────────────
+        if (this.limits.allowedSymbols && this.limits.allowedSymbols.length > 0) {
+            const allowed = this.limits.allowedSymbols.includes(order.symbol);
+            if (!allowed) {
+                results.push({ rule: 'symbol_whitelist', action: 'block', message: `Symbol ${order.symbol} not in whitelist` });
+                worstAction = 'block';
+            }
+        }
+        if (this.limits.blockedSymbols?.includes(order.symbol)) {
+            results.push({ rule: 'symbol_blacklist', action: 'block', message: `Symbol ${order.symbol} is blocked` });
+            worstAction = 'block';
+        }
+        // ── 2. Daily Loss Limit ───────────────────────────────────────────────
+        if (this.limits.maxDailyLoss !== undefined && this.dailyLoss >= this.limits.maxDailyLoss) {
+            results.push({
+                rule: 'daily_loss', action: 'block',
+                message: `Daily loss limit reached: $${this.dailyLoss.toFixed(2)} >= $${this.limits.maxDailyLoss}`,
+            });
+            worstAction = 'block';
+        }
+        // ── 3. Max Open Orders ────────────────────────────────────────────────
+        if (this.limits.maxOpenOrders !== undefined && this.openOrderCount >= this.limits.maxOpenOrders) {
+            results.push({
+                rule: 'max_open_orders', action: 'block',
+                message: `Open order limit reached: ${this.openOrderCount} >= ${this.limits.maxOpenOrders}`,
+            });
+            worstAction = 'block';
+        }
+        // ── 4. Order Size / Notional ──────────────────────────────────────────
+        if (ticker && this.limits.maxOrderSize !== undefined) {
+            const qty = getQuantity(order);
+            if (qty !== null) {
+                const price = getPrice(order) ?? ticker.last;
+                const notional = qty * price;
+                if (notional > this.limits.maxOrderSize) {
+                    const cappedQty = this.limits.maxOrderSize / price;
+                    results.push({
+                        rule: 'max_order_size', action: 'reduce',
+                        message: `Order notional $${notional.toFixed(2)} > limit $${this.limits.maxOrderSize}`,
+                        adjustedQuantity: cappedQty,
+                    });
+                    if (worstAction === 'allow')
+                        worstAction = 'reduce';
+                    // Build adjusted request
+                    adjustedRequest = adjustQty(order, cappedQty);
+                }
+            }
+        }
+        // ── 5. Max Leverage ───────────────────────────────────────────────────
+        if (this.limits.maxLeverage !== undefined && order.leverage !== undefined) {
+            if (order.leverage > this.limits.maxLeverage) {
+                results.push({
+                    rule: 'max_leverage', action: 'block',
+                    message: `Leverage ${order.leverage}x exceeds limit ${this.limits.maxLeverage}x`,
+                });
+                worstAction = 'block';
+            }
+        }
+        // ── 6. Slippage Guard (market orders) ─────────────────────────────────
+        if (this.limits.maxSlippage !== undefined && order.type === 'market' && ticker) {
+            const mid = (ticker.bid + ticker.ask) / 2;
+            const spread = Math.abs(ticker.ask - ticker.bid) / mid * 100;
+            if (spread > this.limits.maxSlippage) {
+                results.push({
+                    rule: 'slippage_guard', action: 'block',
+                    message: `Spread ${spread.toFixed(3)}% > slippage limit ${this.limits.maxSlippage}%`,
+                });
+                worstAction = 'block';
+            }
+        }
+        const passed = worstAction !== 'block';
+        return {
+            passed,
+            action: worstAction,
+            results,
+            adjustedRequest: adjustedRequest ?? (worstAction === 'reduce' ? undefined : undefined),
+        };
+    }
+}
+exports.RiskGuard = RiskGuard;
+// ─── Helpers ──────────────────────────────────────────────────────────────
+function getQuantity(order) {
+    if ('quantity' in order)
+        return order.quantity ?? null;
+    return null;
+}
+function getPrice(order) {
+    if ('price' in order)
+        return order.price ?? null;
+    if ('entryPrice' in order)
+        return order.entryPrice ?? null;
+    return null;
+}
+function adjustQty(order, newQty) {
+    return { ...order, quantity: newQty };
+}
+//# sourceMappingURL=risk.js.map

package/dist/exchange/v2/executor/risk.js.map

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

package/dist/exchange/v2/executor/state.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Order State Manager
+ * Tracks every order through its lifecycle with a complete transition log.
+ * In-memory by default; can be extended to persist to D1/KV.
+ */
+import type { OrderStatus, OrderEvent, TrackedOrder, OrderRequest, OrderResponse, ExchangeId } from '../types';
+export declare function applyTransition(current: OrderStatus, event: OrderEvent): OrderStatus | null;
+export declare class OrderStateManager {
+    private orders;
+    private clientIdMap;
+    register(clientOrderId: string, exchange: ExchangeId, request: OrderRequest): TrackedOrder;
+    bind(clientOrderId: string, orderId: string): TrackedOrder | null;
+    transition(id: string, event: OrderEvent, detail?: string): TrackedOrder | null;
+    applyResponse(id: string, response: OrderResponse): TrackedOrder | null;
+    markError(id: string, error: string): TrackedOrder | null;
+    incrementRetry(id: string): number;
+    bindParentChild(parentId: string, childIds: string[]): void;
+    get(id: string): TrackedOrder | undefined;
+    getByClientId(clientOrderId: string): TrackedOrder | undefined;
+    list(filter?: {
+        status?: OrderStatus;
+        exchange?: ExchangeId;
+    }): TrackedOrder[];
+    remove(id: string): void;
+    /** Purge terminal orders older than maxAgeMs */
+    purge(maxAgeMs?: number): number;
+    size(): number;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/exchange/v2/executor/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/exchange/v2/executor/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EAEV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,MAAM,UAAU,CAAC;AAgBlB,wBAAgB,eAAe,CAC9B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,UAAU,GACf,WAAW,GAAG,IAAI,CAEpB;AAID,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,WAAW,CAAkC;IAErD,QAAQ,CACP,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,YAAY,GACnB,YAAY;IAoBf,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAUjE,UAAU,CACT,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,UAAU,EACjB,MAAM,CAAC,EAAE,MAAM,GACb,YAAY,GAAG,IAAI;IAqBtB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI;IAqBvE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAQzD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAQlC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAe3D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAK9D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,YAAY,EAAE;IAU9E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMxB,gDAAgD;IAChD,KAAK,CAAC,QAAQ,GAAE,MAA4B,GAAG,MAAM;IAcrD,IAAI,IAAI,MAAM;CACd"}

package/dist/exchange/v2/executor/state.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * Order State Manager
+ * Tracks every order through its lifecycle with a complete transition log.
+ * In-memory by default; can be extended to persist to D1/KV.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderStateManager = void 0;
+exports.applyTransition = applyTransition;
+// ─── State Machine ────────────────────────────────────────────────────────
+/** Legal state transitions */
+const TRANSITIONS = {
+    pending: { submit: 'pending', ack: 'open', reject: 'rejected', error: 'failed' },
+    open: { partial_fill: 'partially_filled', fill: 'filled', cancel_request: 'open', cancelled: 'cancelled', reject: 'rejected', expire: 'expired', error: 'failed' },
+    partially_filled: { partial_fill: 'partially_filled', fill: 'filled', cancel_request: 'partially_filled', cancelled: 'cancelled', error: 'failed' },
+    filled: {},
+    cancelled: {},
+    rejected: {},
+    expired: {},
+    failed: { submit: 'pending' }, // allow retry
+};
+function applyTransition(current, event) {
+    return TRANSITIONS[current]?.[event] ?? null;
+}
+// ─── In-Memory Store ──────────────────────────────────────────────────────
+class OrderStateManager {
+    orders = new Map();
+    clientIdMap = new Map(); // clientOrderId → orderId
+    register(clientOrderId, exchange, request) {
+        const order = {
+            orderId: '',
+            clientOrderId,
+            runId: request.runId,
+            exchange,
+            request,
+            status: 'pending',
+            transitions: [],
+            retryCount: 0,
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            parentOrderId: undefined,
+            childOrderIds: undefined,
+        };
+        this.orders.set(clientOrderId, order);
+        this.clientIdMap.set(clientOrderId, clientOrderId);
+        return order;
+    }
+    bind(clientOrderId, orderId) {
+        const order = this.orders.get(clientOrderId);
+        if (!order)
+            return null;
+        order.orderId = orderId;
+        this.orders.delete(clientOrderId);
+        this.orders.set(orderId, order);
+        this.clientIdMap.set(clientOrderId, orderId);
+        return order;
+    }
+    transition(id, event, detail) {
+        const order = this.get(id);
+        if (!order)
+            return null;
+        const next = applyTransition(order.status, event);
+        if (!next) {
+            // Illegal transition — log and ignore
+            console.warn(`[OrderState] Illegal transition: ${order.status} + ${event} (order ${id})`);
+            return order;
+        }
+        const t = {
+            from: order.status, event, to: next,
+            timestamp: Date.now(), detail,
+        };
+        order.transitions.push(t);
+        order.status = next;
+        order.updatedAt = Date.now();
+        return order;
+    }
+    applyResponse(id, response) {
+        const order = this.get(id);
+        if (!order)
+            return null;
+        order.response = response;
+        order.updatedAt = Date.now();
+        // Map response status to event
+        const eventMap = {
+            open: 'ack', pending: 'submit',
+            partially_filled: 'partial_fill',
+            filled: 'fill',
+            cancelled: 'cancelled',
+            rejected: 'reject',
+            expired: 'expire',
+            failed: 'error',
+        };
+        const event = eventMap[response.status];
+        if (event)
+            this.transition(id, event);
+        return order;
+    }
+    markError(id, error) {
+        const order = this.get(id);
+        if (!order)
+            return null;
+        order.error = error;
+        this.transition(id, 'error', error);
+        return order;
+    }
+    incrementRetry(id) {
+        const order = this.get(id);
+        if (!order)
+            return 0;
+        order.retryCount++;
+        order.updatedAt = Date.now();
+        return order.retryCount;
+    }
+    bindParentChild(parentId, childIds) {
+        const parent = this.get(parentId);
+        if (parent) {
+            parent.childOrderIds = [...(parent.childOrderIds ?? []), ...childIds];
+            parent.updatedAt = Date.now();
+        }
+        for (const childId of childIds) {
+            const child = this.get(childId);
+            if (child) {
+                child.parentOrderId = parentId;
+                child.updatedAt = Date.now();
+            }
+        }
+    }
+    get(id) {
+        return this.orders.get(id) ?? this.orders.get(this.clientIdMap.get(id) ?? '');
+    }
+    getByClientId(clientOrderId) {
+        const realId = this.clientIdMap.get(clientOrderId);
+        return realId ? this.orders.get(realId) : undefined;
+    }
+    list(filter) {
+        const all = Array.from(this.orders.values());
+        if (!filter)
+            return all;
+        return all.filter(o => {
+            if (filter.status && o.status !== filter.status)
+                return false;
+            if (filter.exchange && o.exchange !== filter.exchange)
+                return false;
+            return true;
+        });
+    }
+    remove(id) {
+        const order = this.get(id);
+        if (order?.clientOrderId)
+            this.clientIdMap.delete(order.clientOrderId);
+        this.orders.delete(id);
+    }
+    /** Purge terminal orders older than maxAgeMs */
+    purge(maxAgeMs = 24 * 60 * 60 * 1000) {
+        const terminal = ['filled', 'cancelled', 'rejected', 'expired', 'failed'];
+        const cutoff = Date.now() - maxAgeMs;
+        let count = 0;
+        for (const [id, order] of this.orders) {
+            if (terminal.includes(order.status) && order.updatedAt < cutoff) {
+                if (order.clientOrderId)
+                    this.clientIdMap.delete(order.clientOrderId);
+                this.orders.delete(id);
+                count++;
+            }
+        }
+        return count;
+    }
+    size() { return this.orders.size; }
+}
+exports.OrderStateManager = OrderStateManager;
+//# sourceMappingURL=state.js.map

package/dist/exchange/v2/executor/state.js.map

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

package/dist/exchange/v2/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Institutional Order Execution Module — Public API Surface
+ * ============================================================
+ * Usage:
+ *
+ *   import { createEngine, ExchangeRegistry } from './exchange/v2';
+ *
+ *   // Single exchange
+ *   const engine = createEngine({
+ *     exchange: 'okx',
+ *     credentials: { apiKey: '...', apiSecret: '...', passphrase: '...' },
+ *   }, {
+ *     riskLimits: { maxOrderSize: 10_000, maxDailyLoss: 500 },
+ *     onOrderUpdate: (order) => console.log('Order update:', order.orderId, order.status),
+ *   });
+ *
+ *   // Place a limit order
+ *   const tracked = await engine.submitOrder({
+ *     symbol: 'BTC-USDT', side: 'buy', type: 'limit',
+ *     quantity: 0.01, price: 65000, timeInForce: 'GTC',
+ *   });
+ *
+ *   // Place TWAP
+ *   const result = await engine.executeTWAP({
+ *     symbol: 'ETH-USDT', side: 'buy',
+ *     totalQuantity: 1.0, durationMs: 60_000, intervals: 6,
+ *   });
+ *
+ *   // Multi-exchange arbitrage
+ *   const registry = new ExchangeRegistry();
+ *   registry.add('okx', { exchange: 'okx', credentials: okxCreds });
+ *   registry.add('binance', { exchange: 'binance', credentials: bnbCreds });
+ *   const { bestBid, bestAsk } = await registry.bestBidAsk('BTCUSDT');
+ */
+export type { ExchangeId, MarketType, OrderSide, PositionSide, OrderType, TimeInForce, OrderStatus, MarginMode, ExchangeCredentials, TickerInfo, SymbolInfo, OHLCVBar, OrderBook, FundingInfo, AssetBalance, AccountSnapshot, PositionInfo, BaseOrderRequest, MarketOrderRequest, LimitOrderRequest, StopOrderRequest, TrailingStopRequest, BracketOrderRequest, OCOOrderRequest, OrderRequest, OrderResponse, RawOrderParams, TwapParams, VwapParams, IcebergParams, AlgoSlice, AlgoOrderResult, RiskAction, RiskRuleResult, RiskCheckResult, RiskLimits, OrderEvent, OrderStateTransition, TrackedOrder, EngineConfig, RetryPolicy, } from './types';
+export type { IExchangeAdapter } from './adapters/base';
+export { BaseExchangeAdapter, ExchangeError, InsufficientFundsError, RateLimitError, InvalidSymbolError, OrderNotFoundError, hmacSha256Hex, hmacSha256Base64, buildQueryString, buildQueryStringOrdered, genClientOrderId, roundToStep, roundToTick, TIMEFRAME_MS, } from './adapters/base';
+export { OKXAdapter } from './adapters/okx';
+export { BinanceAdapter } from './adapters/binance';
+export { BitgetAdapter } from './adapters/bitget';
+export { HyperliquidAdapter } from './adapters/hyperliquid';
+export type { HyperliquidSignerFn } from './adapters/hyperliquid';
+export { TWAPExecutor, VWAPExecutor, IcebergExecutor, BracketOrchestrator, TrailingStopMonitor, } from './algorithms/index';
+export type { TrailingStopState, BracketResult } from './algorithms/index';
+export { OrderEngine } from './executor/core';
+export { RiskGuard } from './executor/risk';
+export { OrderStateManager, applyTransition } from './executor/state';
+export { createAdapter, createEngine, ExchangeRegistry, } from './registry';
+export type { AdapterOptions } from './registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/exchange/v2/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exchange/v2/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,YAAY,EAEX,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EACvE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAE5C,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAExD,YAAY,EAAE,eAAe,EAAE,YAAY,EAE3C,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EACzE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EACvE,aAAa,EAAE,cAAc,EAE7B,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAEjE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAEvD,UAAU,EAAE,oBAAoB,EAAE,YAAY,EAE9C,YAAY,EAAE,WAAW,GACzB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACN,mBAAmB,EACnB,aAAa,EAAE,sBAAsB,EAAE,cAAc,EACrD,kBAAkB,EAAE,kBAAkB,EACtC,aAAa,EAAE,gBAAgB,EAC/B,gBAAgB,EAAE,uBAAuB,EACzC,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,GACxD,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,OAAO,EACN,YAAY,EAAE,YAAY,EAAE,eAAe,EAC3C,mBAAmB,EAAE,mBAAmB,GACxC,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO,EACN,aAAa,EAAE,YAAY,EAC3B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/exchange/v2/index.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Institutional Order Execution Module — Public API Surface
+ * ============================================================
+ * Usage:
+ *
+ *   import { createEngine, ExchangeRegistry } from './exchange/v2';
+ *
+ *   // Single exchange
+ *   const engine = createEngine({
+ *     exchange: 'okx',
+ *     credentials: { apiKey: '...', apiSecret: '...', passphrase: '...' },
+ *   }, {
+ *     riskLimits: { maxOrderSize: 10_000, maxDailyLoss: 500 },
+ *     onOrderUpdate: (order) => console.log('Order update:', order.orderId, order.status),
+ *   });
+ *
+ *   // Place a limit order
+ *   const tracked = await engine.submitOrder({
+ *     symbol: 'BTC-USDT', side: 'buy', type: 'limit',
+ *     quantity: 0.01, price: 65000, timeInForce: 'GTC',
+ *   });
+ *
+ *   // Place TWAP
+ *   const result = await engine.executeTWAP({
+ *     symbol: 'ETH-USDT', side: 'buy',
+ *     totalQuantity: 1.0, durationMs: 60_000, intervals: 6,
+ *   });
+ *
+ *   // Multi-exchange arbitrage
+ *   const registry = new ExchangeRegistry();
+ *   registry.add('okx', { exchange: 'okx', credentials: okxCreds });
+ *   registry.add('binance', { exchange: 'binance', credentials: bnbCreds });
+ *   const { bestBid, bestAsk } = await registry.bestBidAsk('BTCUSDT');
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExchangeRegistry = exports.createEngine = exports.createAdapter = exports.applyTransition = exports.OrderStateManager = exports.RiskGuard = exports.OrderEngine = exports.TrailingStopMonitor = exports.BracketOrchestrator = exports.IcebergExecutor = exports.VWAPExecutor = exports.TWAPExecutor = exports.HyperliquidAdapter = exports.BitgetAdapter = exports.BinanceAdapter = exports.OKXAdapter = exports.TIMEFRAME_MS = exports.roundToTick = exports.roundToStep = exports.genClientOrderId = exports.buildQueryStringOrdered = exports.buildQueryString = exports.hmacSha256Base64 = exports.hmacSha256Hex = exports.OrderNotFoundError = exports.InvalidSymbolError = exports.RateLimitError = exports.InsufficientFundsError = exports.ExchangeError = exports.BaseExchangeAdapter = void 0;
+var base_1 = require("./adapters/base");
+Object.defineProperty(exports, "BaseExchangeAdapter", { enumerable: true, get: function () { return base_1.BaseExchangeAdapter; } });
+Object.defineProperty(exports, "ExchangeError", { enumerable: true, get: function () { return base_1.ExchangeError; } });
+Object.defineProperty(exports, "InsufficientFundsError", { enumerable: true, get: function () { return base_1.InsufficientFundsError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return base_1.RateLimitError; } });
+Object.defineProperty(exports, "InvalidSymbolError", { enumerable: true, get: function () { return base_1.InvalidSymbolError; } });
+Object.defineProperty(exports, "OrderNotFoundError", { enumerable: true, get: function () { return base_1.OrderNotFoundError; } });
+Object.defineProperty(exports, "hmacSha256Hex", { enumerable: true, get: function () { return base_1.hmacSha256Hex; } });
+Object.defineProperty(exports, "hmacSha256Base64", { enumerable: true, get: function () { return base_1.hmacSha256Base64; } });
+Object.defineProperty(exports, "buildQueryString", { enumerable: true, get: function () { return base_1.buildQueryString; } });
+Object.defineProperty(exports, "buildQueryStringOrdered", { enumerable: true, get: function () { return base_1.buildQueryStringOrdered; } });
+Object.defineProperty(exports, "genClientOrderId", { enumerable: true, get: function () { return base_1.genClientOrderId; } });
+Object.defineProperty(exports, "roundToStep", { enumerable: true, get: function () { return base_1.roundToStep; } });
+Object.defineProperty(exports, "roundToTick", { enumerable: true, get: function () { return base_1.roundToTick; } });
+Object.defineProperty(exports, "TIMEFRAME_MS", { enumerable: true, get: function () { return base_1.TIMEFRAME_MS; } });
+// ─── Adapters ─────────────────────────────────────────────────────────────
+var okx_1 = require("./adapters/okx");
+Object.defineProperty(exports, "OKXAdapter", { enumerable: true, get: function () { return okx_1.OKXAdapter; } });
+var binance_1 = require("./adapters/binance");
+Object.defineProperty(exports, "BinanceAdapter", { enumerable: true, get: function () { return binance_1.BinanceAdapter; } });
+var bitget_1 = require("./adapters/bitget");
+Object.defineProperty(exports, "BitgetAdapter", { enumerable: true, get: function () { return bitget_1.BitgetAdapter; } });
+var hyperliquid_1 = require("./adapters/hyperliquid");
+Object.defineProperty(exports, "HyperliquidAdapter", { enumerable: true, get: function () { return hyperliquid_1.HyperliquidAdapter; } });
+// ─── Algorithms ───────────────────────────────────────────────────────────
+var index_1 = require("./algorithms/index");
+Object.defineProperty(exports, "TWAPExecutor", { enumerable: true, get: function () { return index_1.TWAPExecutor; } });
+Object.defineProperty(exports, "VWAPExecutor", { enumerable: true, get: function () { return index_1.VWAPExecutor; } });
+Object.defineProperty(exports, "IcebergExecutor", { enumerable: true, get: function () { return index_1.IcebergExecutor; } });
+Object.defineProperty(exports, "BracketOrchestrator", { enumerable: true, get: function () { return index_1.BracketOrchestrator; } });
+Object.defineProperty(exports, "TrailingStopMonitor", { enumerable: true, get: function () { return index_1.TrailingStopMonitor; } });
+// ─── Executor ────────────────────────────────────────────────────────────
+var core_1 = require("./executor/core");
+Object.defineProperty(exports, "OrderEngine", { enumerable: true, get: function () { return core_1.OrderEngine; } });
+var risk_1 = require("./executor/risk");
+Object.defineProperty(exports, "RiskGuard", { enumerable: true, get: function () { return risk_1.RiskGuard; } });
+var state_1 = require("./executor/state");
+Object.defineProperty(exports, "OrderStateManager", { enumerable: true, get: function () { return state_1.OrderStateManager; } });
+Object.defineProperty(exports, "applyTransition", { enumerable: true, get: function () { return state_1.applyTransition; } });
+// ─── Registry / Factory ──────────────────────────────────────────────────
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return registry_1.createAdapter; } });
+Object.defineProperty(exports, "createEngine", { enumerable: true, get: function () { return registry_1.createEngine; } });
+Object.defineProperty(exports, "ExchangeRegistry", { enumerable: true, get: function () { return registry_1.ExchangeRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/exchange/v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/exchange/v2/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AA2BH,wCAOyB;AANxB,2GAAA,mBAAmB,OAAA;AACnB,qGAAA,aAAa,OAAA;AAAE,8GAAA,sBAAsB,OAAA;AAAE,sGAAA,cAAc,OAAA;AACrD,0GAAA,kBAAkB,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AACtC,qGAAA,aAAa,OAAA;AAAE,wGAAA,gBAAgB,OAAA;AAC/B,wGAAA,gBAAgB,OAAA;AAAE,+GAAA,uBAAuB,OAAA;AACzC,wGAAA,gBAAgB,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,oGAAA,YAAY,OAAA;AAGzD,6EAA6E;AAC7E,sCAA4C;AAAnC,iGAAA,UAAU,OAAA;AACnB,8CAAoD;AAA3C,yGAAA,cAAc,OAAA;AACvB,4CAAkD;AAAzC,uGAAA,aAAa,OAAA;AACtB,sDAA4D;AAAnD,iHAAA,kBAAkB,OAAA;AAG3B,6EAA6E;AAC7E,4CAG4B;AAF3B,qGAAA,YAAY,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,wGAAA,eAAe,OAAA;AAC3C,4GAAA,mBAAmB,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAIzC,4EAA4E;AAC5E,wCAA8C;AAArC,mGAAA,WAAW,OAAA;AACpB,wCAA4C;AAAnC,iGAAA,SAAS,OAAA;AAClB,0CAAsE;AAA7D,0GAAA,iBAAiB,OAAA;AAAE,wGAAA,eAAe,OAAA;AAE3C,4EAA4E;AAC5E,uCAGoB;AAFnB,yGAAA,aAAa,OAAA;AAAE,wGAAA,YAAY,OAAA;AAC3B,4GAAA,gBAAgB,OAAA"}

package/dist/exchange/v2/registry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Adapter Registry / Factory
+ * Creates exchange adapters and fully-configured OrderEngines.
+ */
+import { type HyperliquidSignerFn } from './adapters/hyperliquid';
+import { OrderEngine } from './executor/core';
+import type { IExchangeAdapter } from './adapters/base';
+import type { ExchangeId, ExchangeCredentials, EngineConfig } from './types';
+import type { Price } from '../../types/financial';
+export interface AdapterOptions {
+    exchange: ExchangeId;
+    credentials: ExchangeCredentials;
+    /** Required for Hyperliquid — inject your EIP-712 signer */
+    hyperliquidSignerFn?: HyperliquidSignerFn;
+}
+export declare function createAdapter(options: AdapterOptions): IExchangeAdapter;
+export declare function createEngine(adapterOptions: AdapterOptions, engineConfig?: Partial<Omit<EngineConfig, 'exchange' | 'credentials'>>): OrderEngine;
+/**
+ * Manages multiple exchange engines in one registry.
+ * Useful for cross-exchange strategies and arbitrage.
+ */
+export declare class ExchangeRegistry {
+    private engines;
+    /** Add or replace an engine by key (e.g. 'okx_main', 'binance_futures') */
+    add(key: string, options: AdapterOptions, engineConfig?: Partial<Omit<EngineConfig, 'exchange' | 'credentials'>>): OrderEngine;
+    get(key: string): OrderEngine;
+    has(key: string): boolean;
+    keys(): string[];
+    remove(key: string): void;
+    /**
+     * Fetch the same ticker from all registered engines in parallel.
+     * Useful for finding the best bid/ask across exchanges.
+     */
+    fetchTickers(symbol: string): Promise<Map<string, import('./types').TickerInfo>>;
+    /**
+     * Find the best bid (sell into) and ask (buy from) across all registered exchanges.
+     * Returns: { bestBid: { key, price }, bestAsk: { key, price } }
+     */
+    bestBidAsk(symbol: string): Promise<{
+        bestBid: {
+            key: string;
+            price: Price;
+        } | null;
+        bestAsk: {
+            key: string;
+            price: Price;
+        } | null;
+    }>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/exchange/v2/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/exchange/v2/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAInD,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,mBAAmB,CAAC;IACjC,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAcvE;AAID,wBAAgB,YAAY,CAC3B,cAAc,EAAE,cAAc,EAC9B,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,aAAa,CAAC,CAAC,GACpE,WAAW,CAQb;AAID;;;GAGG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,OAAO,CAAuC;IAEtD,2EAA2E;IAC3E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,aAAa,CAAC,CAAC,GAAG,WAAW;IAM9H,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAM7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,IAAI,IAAI,MAAM,EAAE;IAIhB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,UAAU,CAAC,CAAC;IAatF;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QACzC,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,KAAK,CAAA;SAAE,GAAG,IAAI,CAAC;QAC9C,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,KAAK,CAAA;SAAE,GAAG,IAAI,CAAC;KAC9C,CAAC;CAWF"}