@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/routing/ProviderRouter.cjs

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * ProviderRouter - Simple routing logic for multi-provider order routing
+ *
+ * Phase 1 implementation: Uses simple routing strategy where:
+ * - Explicit providerId always wins
+ * - Falls back to default provider otherwise
+ *
+ * Advanced routing strategies (best_price, user_preference per market, lowest_fee)
+ * are deferred to Phase 3.
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ProviderRouter_defaultProvider, _ProviderRouter_strategy, _ProviderRouter_providerMarkets;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRouter = void 0;
+/**
+ * ProviderRouter handles routing decisions for write operations
+ * in multi-provider scenarios.
+ *
+ * Phase 1 routing logic is simple:
+ * 1. If explicit providerId is passed, use it
+ * 2. Otherwise, use the default provider
+ *
+ * @example
+ * ```typescript
+ * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });
+ *
+ * // With explicit provider
+ * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'
+ *
+ * // Without explicit provider
+ * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)
+ * ```
+ */
+class ProviderRouter {
+    constructor(options) {
+        /** Default provider to use when no explicit providerId is specified */
+        _ProviderRouter_defaultProvider.set(this, void 0);
+        /** Current routing strategy (Phase 1: only 'default_provider' supported) */
+        _ProviderRouter_strategy.set(this, 'default_provider');
+        /** Map of provider ID to the markets it supports */
+        _ProviderRouter_providerMarkets.set(this, new Map());
+        __classPrivateFieldSet(this, _ProviderRouter_defaultProvider, options.defaultProvider, "f");
+        if (options.strategy) {
+            __classPrivateFieldSet(this, _ProviderRouter_strategy, options.strategy, "f");
+        }
+    }
+    /**
+     * Select the provider to use for an operation.
+     *
+     * Phase 1 logic:
+     * - Explicit providerId > defaultProvider
+     *
+     * @param params - Selection parameters
+     * @returns The provider ID to use
+     */
+    selectProvider(params) {
+        // Phase 1: explicit providerId always wins
+        if (params.providerId) {
+            return params.providerId;
+        }
+        // Fall back to default provider
+        return __classPrivateFieldGet(this, _ProviderRouter_defaultProvider, "f");
+    }
+    /**
+     * Get all providers that support a specific market.
+     *
+     * @param symbol - Market symbol (e.g., 'BTC', 'ETH')
+     * @returns Array of provider IDs that support this market
+     */
+    getProvidersForMarket(symbol) {
+        const providers = [];
+        __classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").forEach((markets, providerId) => {
+            if (markets.has(symbol)) {
+                providers.push(providerId);
+            }
+        });
+        return providers;
+    }
+    /**
+     * Update the markets supported by a provider.
+     * Called during provider initialization or market refresh.
+     *
+     * @param providerId - Provider to update
+     * @param markets - Array of market symbols the provider supports
+     */
+    updateProviderMarkets(providerId, markets) {
+        __classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").set(providerId, new Set(markets));
+    }
+    /**
+     * Clear markets for a provider (e.g., on disconnect).
+     *
+     * @param providerId - Provider to clear
+     */
+    clearProviderMarkets(providerId) {
+        __classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").delete(providerId);
+    }
+    /**
+     * Set the default provider for routing.
+     *
+     * @param providerId - New default provider
+     */
+    setDefaultProvider(providerId) {
+        __classPrivateFieldSet(this, _ProviderRouter_defaultProvider, providerId, "f");
+    }
+    /**
+     * Get the current default provider.
+     *
+     * @returns Current default provider ID
+     */
+    getDefaultProvider() {
+        return __classPrivateFieldGet(this, _ProviderRouter_defaultProvider, "f");
+    }
+    /**
+     * Get the current routing strategy.
+     *
+     * @returns Current routing strategy
+     */
+    getStrategy() {
+        return __classPrivateFieldGet(this, _ProviderRouter_strategy, "f");
+    }
+    /**
+     * Check if a provider supports a specific market.
+     *
+     * @param providerId - Provider to check
+     * @param symbol - Market symbol
+     * @returns true if provider supports the market
+     */
+    providerSupportsMarket(providerId, symbol) {
+        const markets = __classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").get(providerId);
+        return markets?.has(symbol) ?? false;
+    }
+    /**
+     * Get all registered provider IDs.
+     *
+     * @returns Array of all provider IDs with registered markets
+     */
+    getRegisteredProviders() {
+        return Array.from(__classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").keys());
+    }
+}
+exports.ProviderRouter = ProviderRouter;
+_ProviderRouter_defaultProvider = new WeakMap(), _ProviderRouter_strategy = new WeakMap(), _ProviderRouter_providerMarkets = new WeakMap();
+//# sourceMappingURL=ProviderRouter.cjs.map

package/dist/routing/ProviderRouter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouter.cjs","sourceRoot":"","sources":["../../src/routing/ProviderRouter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;AAcH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,cAAc;IAUzB,YAAY,OAKX;QAdD,uEAAuE;QACvE,kDAAoC;QAEpC,4EAA4E;QACnE,mCAA6B,kBAAkB,EAAC;QAEzD,oDAAoD;QAC3C,0CAAwD,IAAI,GAAG,EAAE,EAAC;QAQzE,uBAAA,IAAI,mCAAoB,OAAO,CAAC,eAAe,MAAA,CAAC;QAChD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,uBAAA,IAAI,4BAAa,OAAO,CAAC,QAAQ,MAAA,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,MAA0B;QACvC,2CAA2C;QAC3C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC;QAED,gCAAgC;QAChC,OAAO,uBAAA,IAAI,uCAAiB,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,MAAc;QAClC,MAAM,SAAS,GAAwB,EAAE,CAAC;QAC1C,uBAAA,IAAI,uCAAiB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE;YACpD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB,CACnB,UAA6B,EAC7B,OAAiB;QAEjB,uBAAA,IAAI,uCAAiB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,UAA6B;QAChD,uBAAA,IAAI,uCAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,UAA6B;QAC9C,uBAAA,IAAI,mCAAoB,UAAU,MAAA,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO,uBAAA,IAAI,uCAAiB,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,uBAAA,IAAI,gCAAU,CAAC;IACxB,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CACpB,UAA6B,EAC7B,MAAc;QAEd,MAAM,OAAO,GAAG,uBAAA,IAAI,uCAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtD,OAAO,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,uCAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AAlID,wCAkIC","sourcesContent":["/**\n * ProviderRouter - Simple routing logic for multi-provider order routing\n *\n * Phase 1 implementation: Uses simple routing strategy where:\n * - Explicit providerId always wins\n * - Falls back to default provider otherwise\n *\n * Advanced routing strategies (best_price, user_preference per market, lowest_fee)\n * are deferred to Phase 3.\n */\n\nimport type { PerpsProviderType, RoutingStrategy } from '../types';\n\n/**\n * Parameters for selecting a provider for an operation\n */\nexport type RouterSelectParams = {\n  /** Asset identifier (e.g., 'BTC', 'ETH', 'xyz:TSLA') */\n  symbol?: string;\n  /** Explicit provider override - if provided, always used */\n  providerId?: PerpsProviderType;\n};\n\n/**\n * ProviderRouter handles routing decisions for write operations\n * in multi-provider scenarios.\n *\n * Phase 1 routing logic is simple:\n * 1. If explicit providerId is passed, use it\n * 2. Otherwise, use the default provider\n *\n * @example\n * ```typescript\n * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });\n *\n * // With explicit provider\n * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'\n *\n * // Without explicit provider\n * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)\n * ```\n */\nexport class ProviderRouter {\n  /** Default provider to use when no explicit providerId is specified */\n  #defaultProvider: PerpsProviderType;\n\n  /** Current routing strategy (Phase 1: only 'default_provider' supported) */\n  readonly #strategy: RoutingStrategy = 'default_provider';\n\n  /** Map of provider ID to the markets it supports */\n  readonly #providerMarkets: Map<PerpsProviderType, Set<string>> = new Map();\n\n  constructor(options: {\n    /** Default provider for operations without explicit providerId */\n    defaultProvider: PerpsProviderType;\n    /** Routing strategy (Phase 1: only 'default_provider' supported) */\n    strategy?: RoutingStrategy;\n  }) {\n    this.#defaultProvider = options.defaultProvider;\n    if (options.strategy) {\n      this.#strategy = options.strategy;\n    }\n  }\n\n  /**\n   * Select the provider to use for an operation.\n   *\n   * Phase 1 logic:\n   * - Explicit providerId > defaultProvider\n   *\n   * @param params - Selection parameters\n   * @returns The provider ID to use\n   */\n  selectProvider(params: RouterSelectParams): PerpsProviderType {\n    // Phase 1: explicit providerId always wins\n    if (params.providerId) {\n      return params.providerId;\n    }\n\n    // Fall back to default provider\n    return this.#defaultProvider;\n  }\n\n  /**\n   * Get all providers that support a specific market.\n   *\n   * @param symbol - Market symbol (e.g., 'BTC', 'ETH')\n   * @returns Array of provider IDs that support this market\n   */\n  getProvidersForMarket(symbol: string): PerpsProviderType[] {\n    const providers: PerpsProviderType[] = [];\n    this.#providerMarkets.forEach((markets, providerId) => {\n      if (markets.has(symbol)) {\n        providers.push(providerId);\n      }\n    });\n    return providers;\n  }\n\n  /**\n   * Update the markets supported by a provider.\n   * Called during provider initialization or market refresh.\n   *\n   * @param providerId - Provider to update\n   * @param markets - Array of market symbols the provider supports\n   */\n  updateProviderMarkets(\n    providerId: PerpsProviderType,\n    markets: string[],\n  ): void {\n    this.#providerMarkets.set(providerId, new Set(markets));\n  }\n\n  /**\n   * Clear markets for a provider (e.g., on disconnect).\n   *\n   * @param providerId - Provider to clear\n   */\n  clearProviderMarkets(providerId: PerpsProviderType): void {\n    this.#providerMarkets.delete(providerId);\n  }\n\n  /**\n   * Set the default provider for routing.\n   *\n   * @param providerId - New default provider\n   */\n  setDefaultProvider(providerId: PerpsProviderType): void {\n    this.#defaultProvider = providerId;\n  }\n\n  /**\n   * Get the current default provider.\n   *\n   * @returns Current default provider ID\n   */\n  getDefaultProvider(): PerpsProviderType {\n    return this.#defaultProvider;\n  }\n\n  /**\n   * Get the current routing strategy.\n   *\n   * @returns Current routing strategy\n   */\n  getStrategy(): RoutingStrategy {\n    return this.#strategy;\n  }\n\n  /**\n   * Check if a provider supports a specific market.\n   *\n   * @param providerId - Provider to check\n   * @param symbol - Market symbol\n   * @returns true if provider supports the market\n   */\n  providerSupportsMarket(\n    providerId: PerpsProviderType,\n    symbol: string,\n  ): boolean {\n    const markets = this.#providerMarkets.get(providerId);\n    return markets?.has(symbol) ?? false;\n  }\n\n  /**\n   * Get all registered provider IDs.\n   *\n   * @returns Array of all provider IDs with registered markets\n   */\n  getRegisteredProviders(): PerpsProviderType[] {\n    return Array.from(this.#providerMarkets.keys());\n  }\n}\n"]}

package/dist/routing/ProviderRouter.d.cts

@@ -0,0 +1,112 @@
+/**
+ * ProviderRouter - Simple routing logic for multi-provider order routing
+ *
+ * Phase 1 implementation: Uses simple routing strategy where:
+ * - Explicit providerId always wins
+ * - Falls back to default provider otherwise
+ *
+ * Advanced routing strategies (best_price, user_preference per market, lowest_fee)
+ * are deferred to Phase 3.
+ */
+import type { PerpsProviderType, RoutingStrategy } from "../types/index.cjs";
+/**
+ * Parameters for selecting a provider for an operation
+ */
+export type RouterSelectParams = {
+    /** Asset identifier (e.g., 'BTC', 'ETH', 'xyz:TSLA') */
+    symbol?: string;
+    /** Explicit provider override - if provided, always used */
+    providerId?: PerpsProviderType;
+};
+/**
+ * ProviderRouter handles routing decisions for write operations
+ * in multi-provider scenarios.
+ *
+ * Phase 1 routing logic is simple:
+ * 1. If explicit providerId is passed, use it
+ * 2. Otherwise, use the default provider
+ *
+ * @example
+ * ```typescript
+ * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });
+ *
+ * // With explicit provider
+ * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'
+ *
+ * // Without explicit provider
+ * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)
+ * ```
+ */
+export declare class ProviderRouter {
+    #private;
+    constructor(options: {
+        /** Default provider for operations without explicit providerId */
+        defaultProvider: PerpsProviderType;
+        /** Routing strategy (Phase 1: only 'default_provider' supported) */
+        strategy?: RoutingStrategy;
+    });
+    /**
+     * Select the provider to use for an operation.
+     *
+     * Phase 1 logic:
+     * - Explicit providerId > defaultProvider
+     *
+     * @param params - Selection parameters
+     * @returns The provider ID to use
+     */
+    selectProvider(params: RouterSelectParams): PerpsProviderType;
+    /**
+     * Get all providers that support a specific market.
+     *
+     * @param symbol - Market symbol (e.g., 'BTC', 'ETH')
+     * @returns Array of provider IDs that support this market
+     */
+    getProvidersForMarket(symbol: string): PerpsProviderType[];
+    /**
+     * Update the markets supported by a provider.
+     * Called during provider initialization or market refresh.
+     *
+     * @param providerId - Provider to update
+     * @param markets - Array of market symbols the provider supports
+     */
+    updateProviderMarkets(providerId: PerpsProviderType, markets: string[]): void;
+    /**
+     * Clear markets for a provider (e.g., on disconnect).
+     *
+     * @param providerId - Provider to clear
+     */
+    clearProviderMarkets(providerId: PerpsProviderType): void;
+    /**
+     * Set the default provider for routing.
+     *
+     * @param providerId - New default provider
+     */
+    setDefaultProvider(providerId: PerpsProviderType): void;
+    /**
+     * Get the current default provider.
+     *
+     * @returns Current default provider ID
+     */
+    getDefaultProvider(): PerpsProviderType;
+    /**
+     * Get the current routing strategy.
+     *
+     * @returns Current routing strategy
+     */
+    getStrategy(): RoutingStrategy;
+    /**
+     * Check if a provider supports a specific market.
+     *
+     * @param providerId - Provider to check
+     * @param symbol - Market symbol
+     * @returns true if provider supports the market
+     */
+    providerSupportsMarket(providerId: PerpsProviderType, symbol: string): boolean;
+    /**
+     * Get all registered provider IDs.
+     *
+     * @returns Array of all provider IDs with registered markets
+     */
+    getRegisteredProviders(): PerpsProviderType[];
+}
+//# sourceMappingURL=ProviderRouter.d.cts.map

package/dist/routing/ProviderRouter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouter.d.cts","sourceRoot":"","sources":["../../src/routing/ProviderRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,2BAAiB;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc;;gBAUb,OAAO,EAAE;QACnB,kEAAkE;QAClE,eAAe,EAAE,iBAAiB,CAAC;QACnC,oEAAoE;QACpE,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B;IAOD;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB;IAU7D;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAU1D;;;;;;OAMG;IACH,qBAAqB,CACnB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI;IAIP;;;;OAIG;IACH,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIzD;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIvD;;;;OAIG;IACH,kBAAkB,IAAI,iBAAiB;IAIvC;;;;OAIG;IACH,WAAW,IAAI,eAAe;IAI9B;;;;;;OAMG;IACH,sBAAsB,CACpB,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO;IAKV;;;;OAIG;IACH,sBAAsB,IAAI,iBAAiB,EAAE;CAG9C"}

package/dist/routing/ProviderRouter.d.mts

@@ -0,0 +1,112 @@
+/**
+ * ProviderRouter - Simple routing logic for multi-provider order routing
+ *
+ * Phase 1 implementation: Uses simple routing strategy where:
+ * - Explicit providerId always wins
+ * - Falls back to default provider otherwise
+ *
+ * Advanced routing strategies (best_price, user_preference per market, lowest_fee)
+ * are deferred to Phase 3.
+ */
+import type { PerpsProviderType, RoutingStrategy } from "../types/index.mjs";
+/**
+ * Parameters for selecting a provider for an operation
+ */
+export type RouterSelectParams = {
+    /** Asset identifier (e.g., 'BTC', 'ETH', 'xyz:TSLA') */
+    symbol?: string;
+    /** Explicit provider override - if provided, always used */
+    providerId?: PerpsProviderType;
+};
+/**
+ * ProviderRouter handles routing decisions for write operations
+ * in multi-provider scenarios.
+ *
+ * Phase 1 routing logic is simple:
+ * 1. If explicit providerId is passed, use it
+ * 2. Otherwise, use the default provider
+ *
+ * @example
+ * ```typescript
+ * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });
+ *
+ * // With explicit provider
+ * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'
+ *
+ * // Without explicit provider
+ * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)
+ * ```
+ */
+export declare class ProviderRouter {
+    #private;
+    constructor(options: {
+        /** Default provider for operations without explicit providerId */
+        defaultProvider: PerpsProviderType;
+        /** Routing strategy (Phase 1: only 'default_provider' supported) */
+        strategy?: RoutingStrategy;
+    });
+    /**
+     * Select the provider to use for an operation.
+     *
+     * Phase 1 logic:
+     * - Explicit providerId > defaultProvider
+     *
+     * @param params - Selection parameters
+     * @returns The provider ID to use
+     */
+    selectProvider(params: RouterSelectParams): PerpsProviderType;
+    /**
+     * Get all providers that support a specific market.
+     *
+     * @param symbol - Market symbol (e.g., 'BTC', 'ETH')
+     * @returns Array of provider IDs that support this market
+     */
+    getProvidersForMarket(symbol: string): PerpsProviderType[];
+    /**
+     * Update the markets supported by a provider.
+     * Called during provider initialization or market refresh.
+     *
+     * @param providerId - Provider to update
+     * @param markets - Array of market symbols the provider supports
+     */
+    updateProviderMarkets(providerId: PerpsProviderType, markets: string[]): void;
+    /**
+     * Clear markets for a provider (e.g., on disconnect).
+     *
+     * @param providerId - Provider to clear
+     */
+    clearProviderMarkets(providerId: PerpsProviderType): void;
+    /**
+     * Set the default provider for routing.
+     *
+     * @param providerId - New default provider
+     */
+    setDefaultProvider(providerId: PerpsProviderType): void;
+    /**
+     * Get the current default provider.
+     *
+     * @returns Current default provider ID
+     */
+    getDefaultProvider(): PerpsProviderType;
+    /**
+     * Get the current routing strategy.
+     *
+     * @returns Current routing strategy
+     */
+    getStrategy(): RoutingStrategy;
+    /**
+     * Check if a provider supports a specific market.
+     *
+     * @param providerId - Provider to check
+     * @param symbol - Market symbol
+     * @returns true if provider supports the market
+     */
+    providerSupportsMarket(providerId: PerpsProviderType, symbol: string): boolean;
+    /**
+     * Get all registered provider IDs.
+     *
+     * @returns Array of all provider IDs with registered markets
+     */
+    getRegisteredProviders(): PerpsProviderType[];
+}
+//# sourceMappingURL=ProviderRouter.d.mts.map

package/dist/routing/ProviderRouter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouter.d.mts","sourceRoot":"","sources":["../../src/routing/ProviderRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,2BAAiB;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc;;gBAUb,OAAO,EAAE;QACnB,kEAAkE;QAClE,eAAe,EAAE,iBAAiB,CAAC;QACnC,oEAAoE;QACpE,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B;IAOD;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB;IAU7D;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAU1D;;;;;;OAMG;IACH,qBAAqB,CACnB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI;IAIP;;;;OAIG;IACH,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIzD;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIvD;;;;OAIG;IACH,kBAAkB,IAAI,iBAAiB;IAIvC;;;;OAIG;IACH,WAAW,IAAI,eAAe;IAI9B;;;;;;OAMG;IACH,sBAAsB,CACpB,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO;IAKV;;;;OAIG;IACH,sBAAsB,IAAI,iBAAiB,EAAE;CAG9C"}

package/dist/routing/ProviderRouter.mjs

@@ -0,0 +1,150 @@
+/**
+ * ProviderRouter - Simple routing logic for multi-provider order routing
+ *
+ * Phase 1 implementation: Uses simple routing strategy where:
+ * - Explicit providerId always wins
+ * - Falls back to default provider otherwise
+ *
+ * Advanced routing strategies (best_price, user_preference per market, lowest_fee)
+ * are deferred to Phase 3.
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ProviderRouter_defaultProvider, _ProviderRouter_strategy, _ProviderRouter_providerMarkets;
+/**
+ * ProviderRouter handles routing decisions for write operations
+ * in multi-provider scenarios.
+ *
+ * Phase 1 routing logic is simple:
+ * 1. If explicit providerId is passed, use it
+ * 2. Otherwise, use the default provider
+ *
+ * @example
+ * ```typescript
+ * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });
+ *
+ * // With explicit provider
+ * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'
+ *
+ * // Without explicit provider
+ * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)
+ * ```
+ */
+export class ProviderRouter {
+    constructor(options) {
+        /** Default provider to use when no explicit providerId is specified */
+        _ProviderRouter_defaultProvider.set(this, void 0);
+        /** Current routing strategy (Phase 1: only 'default_provider' supported) */
+        _ProviderRouter_strategy.set(this, 'default_provider');
+        /** Map of provider ID to the markets it supports */
+        _ProviderRouter_providerMarkets.set(this, new Map());
+        __classPrivateFieldSet(this, _ProviderRouter_defaultProvider, options.defaultProvider, "f");
+        if (options.strategy) {
+            __classPrivateFieldSet(this, _ProviderRouter_strategy, options.strategy, "f");
+        }
+    }
+    /**
+     * Select the provider to use for an operation.
+     *
+     * Phase 1 logic:
+     * - Explicit providerId > defaultProvider
+     *
+     * @param params - Selection parameters
+     * @returns The provider ID to use
+     */
+    selectProvider(params) {
+        // Phase 1: explicit providerId always wins
+        if (params.providerId) {
+            return params.providerId;
+        }
+        // Fall back to default provider
+        return __classPrivateFieldGet(this, _ProviderRouter_defaultProvider, "f");
+    }
+    /**
+     * Get all providers that support a specific market.
+     *
+     * @param symbol - Market symbol (e.g., 'BTC', 'ETH')
+     * @returns Array of provider IDs that support this market
+     */
+    getProvidersForMarket(symbol) {
+        const providers = [];
+        __classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").forEach((markets, providerId) => {
+            if (markets.has(symbol)) {
+                providers.push(providerId);
+            }
+        });
+        return providers;
+    }
+    /**
+     * Update the markets supported by a provider.
+     * Called during provider initialization or market refresh.
+     *
+     * @param providerId - Provider to update
+     * @param markets - Array of market symbols the provider supports
+     */
+    updateProviderMarkets(providerId, markets) {
+        __classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").set(providerId, new Set(markets));
+    }
+    /**
+     * Clear markets for a provider (e.g., on disconnect).
+     *
+     * @param providerId - Provider to clear
+     */
+    clearProviderMarkets(providerId) {
+        __classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").delete(providerId);
+    }
+    /**
+     * Set the default provider for routing.
+     *
+     * @param providerId - New default provider
+     */
+    setDefaultProvider(providerId) {
+        __classPrivateFieldSet(this, _ProviderRouter_defaultProvider, providerId, "f");
+    }
+    /**
+     * Get the current default provider.
+     *
+     * @returns Current default provider ID
+     */
+    getDefaultProvider() {
+        return __classPrivateFieldGet(this, _ProviderRouter_defaultProvider, "f");
+    }
+    /**
+     * Get the current routing strategy.
+     *
+     * @returns Current routing strategy
+     */
+    getStrategy() {
+        return __classPrivateFieldGet(this, _ProviderRouter_strategy, "f");
+    }
+    /**
+     * Check if a provider supports a specific market.
+     *
+     * @param providerId - Provider to check
+     * @param symbol - Market symbol
+     * @returns true if provider supports the market
+     */
+    providerSupportsMarket(providerId, symbol) {
+        const markets = __classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").get(providerId);
+        return markets?.has(symbol) ?? false;
+    }
+    /**
+     * Get all registered provider IDs.
+     *
+     * @returns Array of all provider IDs with registered markets
+     */
+    getRegisteredProviders() {
+        return Array.from(__classPrivateFieldGet(this, _ProviderRouter_providerMarkets, "f").keys());
+    }
+}
+_ProviderRouter_defaultProvider = new WeakMap(), _ProviderRouter_strategy = new WeakMap(), _ProviderRouter_providerMarkets = new WeakMap();
+//# sourceMappingURL=ProviderRouter.mjs.map

package/dist/routing/ProviderRouter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouter.mjs","sourceRoot":"","sources":["../../src/routing/ProviderRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;;;;;;;;;;;;AAcH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,cAAc;IAUzB,YAAY,OAKX;QAdD,uEAAuE;QACvE,kDAAoC;QAEpC,4EAA4E;QACnE,mCAA6B,kBAAkB,EAAC;QAEzD,oDAAoD;QAC3C,0CAAwD,IAAI,GAAG,EAAE,EAAC;QAQzE,uBAAA,IAAI,mCAAoB,OAAO,CAAC,eAAe,MAAA,CAAC;QAChD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,uBAAA,IAAI,4BAAa,OAAO,CAAC,QAAQ,MAAA,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,MAA0B;QACvC,2CAA2C;QAC3C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC;QAED,gCAAgC;QAChC,OAAO,uBAAA,IAAI,uCAAiB,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,MAAc;QAClC,MAAM,SAAS,GAAwB,EAAE,CAAC;QAC1C,uBAAA,IAAI,uCAAiB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE;YACpD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB,CACnB,UAA6B,EAC7B,OAAiB;QAEjB,uBAAA,IAAI,uCAAiB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,UAA6B;QAChD,uBAAA,IAAI,uCAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,UAA6B;QAC9C,uBAAA,IAAI,mCAAoB,UAAU,MAAA,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO,uBAAA,IAAI,uCAAiB,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,uBAAA,IAAI,gCAAU,CAAC;IACxB,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CACpB,UAA6B,EAC7B,MAAc;QAEd,MAAM,OAAO,GAAG,uBAAA,IAAI,uCAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtD,OAAO,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,uCAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;CACF","sourcesContent":["/**\n * ProviderRouter - Simple routing logic for multi-provider order routing\n *\n * Phase 1 implementation: Uses simple routing strategy where:\n * - Explicit providerId always wins\n * - Falls back to default provider otherwise\n *\n * Advanced routing strategies (best_price, user_preference per market, lowest_fee)\n * are deferred to Phase 3.\n */\n\nimport type { PerpsProviderType, RoutingStrategy } from '../types';\n\n/**\n * Parameters for selecting a provider for an operation\n */\nexport type RouterSelectParams = {\n  /** Asset identifier (e.g., 'BTC', 'ETH', 'xyz:TSLA') */\n  symbol?: string;\n  /** Explicit provider override - if provided, always used */\n  providerId?: PerpsProviderType;\n};\n\n/**\n * ProviderRouter handles routing decisions for write operations\n * in multi-provider scenarios.\n *\n * Phase 1 routing logic is simple:\n * 1. If explicit providerId is passed, use it\n * 2. Otherwise, use the default provider\n *\n * @example\n * ```typescript\n * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });\n *\n * // With explicit provider\n * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'\n *\n * // Without explicit provider\n * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)\n * ```\n */\nexport class ProviderRouter {\n  /** Default provider to use when no explicit providerId is specified */\n  #defaultProvider: PerpsProviderType;\n\n  /** Current routing strategy (Phase 1: only 'default_provider' supported) */\n  readonly #strategy: RoutingStrategy = 'default_provider';\n\n  /** Map of provider ID to the markets it supports */\n  readonly #providerMarkets: Map<PerpsProviderType, Set<string>> = new Map();\n\n  constructor(options: {\n    /** Default provider for operations without explicit providerId */\n    defaultProvider: PerpsProviderType;\n    /** Routing strategy (Phase 1: only 'default_provider' supported) */\n    strategy?: RoutingStrategy;\n  }) {\n    this.#defaultProvider = options.defaultProvider;\n    if (options.strategy) {\n      this.#strategy = options.strategy;\n    }\n  }\n\n  /**\n   * Select the provider to use for an operation.\n   *\n   * Phase 1 logic:\n   * - Explicit providerId > defaultProvider\n   *\n   * @param params - Selection parameters\n   * @returns The provider ID to use\n   */\n  selectProvider(params: RouterSelectParams): PerpsProviderType {\n    // Phase 1: explicit providerId always wins\n    if (params.providerId) {\n      return params.providerId;\n    }\n\n    // Fall back to default provider\n    return this.#defaultProvider;\n  }\n\n  /**\n   * Get all providers that support a specific market.\n   *\n   * @param symbol - Market symbol (e.g., 'BTC', 'ETH')\n   * @returns Array of provider IDs that support this market\n   */\n  getProvidersForMarket(symbol: string): PerpsProviderType[] {\n    const providers: PerpsProviderType[] = [];\n    this.#providerMarkets.forEach((markets, providerId) => {\n      if (markets.has(symbol)) {\n        providers.push(providerId);\n      }\n    });\n    return providers;\n  }\n\n  /**\n   * Update the markets supported by a provider.\n   * Called during provider initialization or market refresh.\n   *\n   * @param providerId - Provider to update\n   * @param markets - Array of market symbols the provider supports\n   */\n  updateProviderMarkets(\n    providerId: PerpsProviderType,\n    markets: string[],\n  ): void {\n    this.#providerMarkets.set(providerId, new Set(markets));\n  }\n\n  /**\n   * Clear markets for a provider (e.g., on disconnect).\n   *\n   * @param providerId - Provider to clear\n   */\n  clearProviderMarkets(providerId: PerpsProviderType): void {\n    this.#providerMarkets.delete(providerId);\n  }\n\n  /**\n   * Set the default provider for routing.\n   *\n   * @param providerId - New default provider\n   */\n  setDefaultProvider(providerId: PerpsProviderType): void {\n    this.#defaultProvider = providerId;\n  }\n\n  /**\n   * Get the current default provider.\n   *\n   * @returns Current default provider ID\n   */\n  getDefaultProvider(): PerpsProviderType {\n    return this.#defaultProvider;\n  }\n\n  /**\n   * Get the current routing strategy.\n   *\n   * @returns Current routing strategy\n   */\n  getStrategy(): RoutingStrategy {\n    return this.#strategy;\n  }\n\n  /**\n   * Check if a provider supports a specific market.\n   *\n   * @param providerId - Provider to check\n   * @param symbol - Market symbol\n   * @returns true if provider supports the market\n   */\n  providerSupportsMarket(\n    providerId: PerpsProviderType,\n    symbol: string,\n  ): boolean {\n    const markets = this.#providerMarkets.get(providerId);\n    return markets?.has(symbol) ?? false;\n  }\n\n  /**\n   * Get all registered provider IDs.\n   *\n   * @returns Array of all provider IDs with registered markets\n   */\n  getRegisteredProviders(): PerpsProviderType[] {\n    return Array.from(this.#providerMarkets.keys());\n  }\n}\n"]}

package/dist/routing/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRouter = void 0;
+/**
+ * Provider routing module exports
+ */
+var ProviderRouter_1 = require("./ProviderRouter.cjs");
+Object.defineProperty(exports, "ProviderRouter", { enumerable: true, get: function () { return ProviderRouter_1.ProviderRouter; } });
+//# sourceMappingURL=index.cjs.map

package/dist/routing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,uDAAkD;AAAzC,gHAAA,cAAc,OAAA","sourcesContent":["/**\n * Provider routing module exports\n */\nexport { ProviderRouter } from './ProviderRouter';\nexport type { RouterSelectParams } from './ProviderRouter';\n"]}

package/dist/routing/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Provider routing module exports
+ */
+export { ProviderRouter } from "./ProviderRouter.cjs";
+export type { RouterSelectParams } from "./ProviderRouter.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/routing/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EAAE,kBAAkB,EAAE,6BAAyB"}

package/dist/routing/index.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Provider routing module exports
+ */
+export { ProviderRouter } from "./ProviderRouter.mjs";
+export type { RouterSelectParams } from "./ProviderRouter.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/routing/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EAAE,kBAAkB,EAAE,6BAAyB"}

package/dist/routing/index.mjs

@@ -0,0 +1,5 @@
+/**
+ * Provider routing module exports
+ */
+export { ProviderRouter } from "./ProviderRouter.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/routing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,6BAAyB","sourcesContent":["/**\n * Provider routing module exports\n */\nexport { ProviderRouter } from './ProviderRouter';\nexport type { RouterSelectParams } from './ProviderRouter';\n"]}