@luxfi/dex 1.2.1 → 2.0.0

package/dist/router/router.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Omnichain Router
+ * Routes orders between CLOB and AMM for best execution
+ */
+import type { PublicClient } from 'viem';
+import type { ICLOBClient } from '../client/types';
+import type { RouterConfig, QuoteRequest, Quote, SwapRequest, SwapResult } from './types';
+/**
+ * Omnichain Router
+ * Best execution routing between CLOB and AMM
+ */
+export declare class OmnichainRouter {
+    private config;
+    private publicClient;
+    private clobClient;
+    constructor(config?: Partial<RouterConfig>);
+    /**
+     * Set the public client for AMM interactions
+     */
+    setPublicClient(client: PublicClient): void;
+    /**
+     * Set the CLOB client
+     */
+    setCLOBClient(client: ICLOBClient): void;
+    /**
+     * Get a quote for a swap
+     */
+    getQuote(request: QuoteRequest): Promise<Quote>;
+    /**
+     * Get AMM quote using precompiles
+     */
+    private getAMMQuote;
+    /**
+     * Get CLOB quote
+     */
+    private getCLOBQuote;
+    /**
+     * Convert token addresses to trading symbol
+     */
+    private getSymbol;
+    /**
+     * Execute a swap
+     */
+    executeSwap(request: SwapRequest): Promise<SwapResult>;
+    /**
+     * Execute AMM swap via precompile
+     */
+    private executeAMMSwap;
+    /**
+     * Execute CLOB swap
+     */
+    private executeCLOBSwap;
+}
+/**
+ * Create an omnichain router instance
+ */
+export declare function createRouter(config?: Partial<RouterConfig>): OmnichainRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/router/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,MAAM,CAAA;AAIjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,KAAK,EAEL,WAAW,EACX,UAAU,EACX,MAAM,SAAS,CAAA;AAUhB;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,UAAU,CAA2B;gBAEjC,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAI9C;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,YAAY;IAIpC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW;IAIjC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;IAkDrD;;OAEG;YACW,WAAW;IAgEzB;;OAEG;YACW,YAAY;IAwE1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB5D;;OAEG;YACW,cAAc;IAU5B;;OAEG;YACW,eAAe;CAyB9B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,eAAe,CAE5E"}

package/dist/router/router.js

@@ -0,0 +1,272 @@
+import { DEX_PRECOMPILES } from '../precompile/addresses';
+import { POOL_MANAGER_ABI } from '../precompile/abis';
+import { createPoolKey } from '../precompile/types';
+const DEFAULT_CONFIG = {
+    clobEnabled: true,
+    ammEnabled: true,
+    maxHops: 3,
+    preferCLOB: false,
+    hybridEnabled: true,
+};
+/**
+ * Omnichain Router
+ * Best execution routing between CLOB and AMM
+ */
+export class OmnichainRouter {
+    config;
+    publicClient = null;
+    clobClient = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Set the public client for AMM interactions
+     */
+    setPublicClient(client) {
+        this.publicClient = client;
+    }
+    /**
+     * Set the CLOB client
+     */
+    setCLOBClient(client) {
+        this.clobClient = client;
+    }
+    /**
+     * Get a quote for a swap
+     */
+    async getQuote(request) {
+        const { tokenIn, tokenOut, amountIn, slippageTolerance = 50, // 0.5%
+        preferredSource, } = request;
+        const quotes = [];
+        // Get AMM quote if enabled
+        if (this.config.ammEnabled && (!preferredSource || preferredSource !== 'clob')) {
+            try {
+                const ammQuote = await this.getAMMQuote(tokenIn, tokenOut, amountIn);
+                if (ammQuote)
+                    quotes.push(ammQuote);
+            }
+            catch (error) {
+                console.warn('AMM quote failed:', error);
+            }
+        }
+        // Get CLOB quote if enabled
+        if (this.config.clobEnabled && this.clobClient && (!preferredSource || preferredSource !== 'amm')) {
+            try {
+                const clobQuote = await this.getCLOBQuote(tokenIn, tokenOut, amountIn);
+                if (clobQuote)
+                    quotes.push(clobQuote);
+            }
+            catch (error) {
+                console.warn('CLOB quote failed:', error);
+            }
+        }
+        if (quotes.length === 0) {
+            throw new Error('No quotes available');
+        }
+        // Select best quote (highest output)
+        const bestQuote = quotes.reduce((best, quote) => quote.amountOut > best.amountOut ? quote : best);
+        // Apply slippage tolerance
+        const minimumAmountOut = bestQuote.amountOut - (bestQuote.amountOut * BigInt(slippageTolerance)) / 10000n;
+        return {
+            ...bestQuote,
+            minimumAmountOut,
+            validUntil: Date.now() + 30000, // 30 seconds
+        };
+    }
+    /**
+     * Get AMM quote using precompiles
+     */
+    async getAMMQuote(tokenIn, tokenOut, amountIn) {
+        if (!this.publicClient)
+            return null;
+        try {
+            // Create pool key
+            const poolKey = createPoolKey(tokenIn, tokenOut);
+            const zeroForOne = tokenIn.toLowerCase() < tokenOut.toLowerCase();
+            // Get pool state
+            const slot0 = await this.publicClient.readContract({
+                address: DEX_PRECOMPILES.POOL_MANAGER,
+                abi: POOL_MANAGER_ABI,
+                functionName: 'getSlot0',
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                args: [poolKey],
+            });
+            if (slot0[0] === 0n) {
+                return null; // Pool doesn't exist
+            }
+            // Calculate expected output (simplified - real implementation would use tick math)
+            // For now, use a simple estimate based on sqrt price
+            const sqrtPriceX96 = slot0[0];
+            const price = (sqrtPriceX96 * sqrtPriceX96) / (2n ** 192n);
+            const amountOut = zeroForOne
+                ? (amountIn * price) / (10n ** 18n)
+                : (amountIn * (10n ** 18n)) / price;
+            // Estimate price impact (simplified)
+            const priceImpact = Number((amountIn * 10n) / (amountIn + amountOut));
+            const step = {
+                source: 'amm',
+                tokenIn,
+                tokenOut,
+                amountIn,
+                amountOut,
+                pool: DEX_PRECOMPILES.POOL_MANAGER,
+                fee: (amountIn * BigInt(poolKey.fee)) / 1000000n,
+                priceImpact,
+            };
+            return {
+                tokenIn,
+                tokenOut,
+                amountIn,
+                amountOut,
+                minimumAmountOut: amountOut,
+                route: [step],
+                priceImpact,
+                estimatedGas: 150000n,
+                validUntil: Date.now() + 30000,
+            };
+        }
+        catch (error) {
+            console.error('AMM quote error:', error);
+            return null;
+        }
+    }
+    /**
+     * Get CLOB quote
+     */
+    async getCLOBQuote(tokenIn, tokenOut, amountIn) {
+        if (!this.clobClient || !this.clobClient.isConnected())
+            return null;
+        try {
+            // Convert addresses to symbol (e.g., "LUX-USDT")
+            const symbol = this.getSymbol(tokenIn, tokenOut);
+            if (!symbol)
+                return null;
+            const orderBook = await this.clobClient.getOrderBook(symbol, 50);
+            // Calculate output by walking the order book
+            let remainingIn = amountIn;
+            let totalOut = 0n;
+            const side = tokenIn.toLowerCase() < tokenOut.toLowerCase() ? 'asks' : 'bids';
+            const levels = side === 'asks' ? orderBook.asks : orderBook.bids;
+            for (const level of levels) {
+                if (remainingIn <= 0n)
+                    break;
+                const levelSize = BigInt(Math.floor(level.size * 1e18));
+                const levelPrice = BigInt(Math.floor(level.price * 1e18));
+                const fillSize = remainingIn < levelSize ? remainingIn : levelSize;
+                const fillOut = side === 'asks'
+                    ? (fillSize * (10n ** 18n)) / levelPrice
+                    : (fillSize * levelPrice) / (10n ** 18n);
+                totalOut += fillOut;
+                remainingIn -= fillSize;
+            }
+            if (totalOut === 0n)
+                return null;
+            // Calculate price impact
+            const avgPrice = (amountIn * (10n ** 18n)) / totalOut;
+            const bestPrice = BigInt(Math.floor(levels[0]?.price * 1e18 || 0));
+            const priceImpact = bestPrice > 0n
+                ? Number(((avgPrice - bestPrice) * 10000n) / bestPrice)
+                : 0;
+            const step = {
+                source: 'clob',
+                tokenIn,
+                tokenOut,
+                amountIn,
+                amountOut: totalOut,
+                symbol,
+                fee: (amountIn * 30n) / 10000n, // 0.3% maker fee estimate
+                priceImpact,
+            };
+            return {
+                tokenIn,
+                tokenOut,
+                amountIn,
+                amountOut: totalOut,
+                minimumAmountOut: totalOut,
+                route: [step],
+                priceImpact,
+                estimatedGas: 50000n, // CLOB is off-chain
+                validUntil: Date.now() + 10000, // 10 seconds (faster expiry for CLOB)
+            };
+        }
+        catch (error) {
+            console.error('CLOB quote error:', error);
+            return null;
+        }
+    }
+    /**
+     * Convert token addresses to trading symbol
+     */
+    getSymbol(tokenIn, tokenOut) {
+        // TODO: Implement proper token-to-symbol mapping
+        // This should look up the token registry
+        const tokenMap = {
+            '0x0000000000000000000000000000000000000000': 'LUX',
+            // Add more tokens as needed
+        };
+        const symbolIn = tokenMap[tokenIn.toLowerCase()];
+        const symbolOut = tokenMap[tokenOut.toLowerCase()];
+        if (!symbolIn || !symbolOut)
+            return null;
+        return `${symbolIn}-${symbolOut}`;
+    }
+    /**
+     * Execute a swap
+     */
+    async executeSwap(request) {
+        const { quote, recipient, deadline = Math.floor(Date.now() / 1000) + 1200 } = request;
+        if (Date.now() > quote.validUntil) {
+            throw new Error('Quote expired');
+        }
+        // Determine execution path
+        const source = quote.route[0]?.source;
+        if (source === 'amm') {
+            return this.executeAMMSwap(quote, recipient, deadline);
+        }
+        else if (source === 'clob') {
+            return this.executeCLOBSwap(quote, recipient);
+        }
+        else {
+            throw new Error(`Unknown route source: ${source}`);
+        }
+    }
+    /**
+     * Execute AMM swap via precompile
+     */
+    async executeAMMSwap(quote, recipient, deadline) {
+        // This would be called by the wallet/wagmi on the frontend
+        // Just return the transaction parameters
+        throw new Error('AMM swap execution should be handled by wagmi writeContract');
+    }
+    /**
+     * Execute CLOB swap
+     */
+    async executeCLOBSwap(quote, recipient) {
+        if (!this.clobClient) {
+            throw new Error('CLOB client not configured');
+        }
+        const step = quote.route[0];
+        if (!step?.symbol) {
+            throw new Error('Invalid CLOB route');
+        }
+        // Place market order on CLOB
+        const order = await this.clobClient.placeOrder({
+            symbol: step.symbol,
+            side: step.tokenIn.toLowerCase() < step.tokenOut.toLowerCase() ? 'buy' : 'sell',
+            type: 'market',
+            size: Number(quote.amountIn) / 1e18,
+        });
+        return {
+            txHash: `0x${order.orderId}`,
+            amountIn: quote.amountIn,
+            amountOut: quote.amountOut,
+            route: quote.route,
+        };
+    }
+}
+/**
+ * Create an omnichain router instance
+ */
+export function createRouter(config) {
+    return new OmnichainRouter(config);
+}

package/dist/router/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Router Types
+ * Types for hybrid CLOB + AMM routing
+ */
+import type { Address } from 'viem';
+/**
+ * Route source - where liquidity comes from
+ */
+export type RouteSource = 'clob' | 'amm' | 'hybrid';
+/**
+ * Quote request
+ */
+export interface QuoteRequest {
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    slippageTolerance?: number;
+    preferredSource?: RouteSource;
+}
+/**
+ * Route step
+ */
+export interface RouteStep {
+    source: RouteSource;
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    amountOut: bigint;
+    pool?: Address;
+    symbol?: string;
+    fee: bigint;
+    priceImpact: number;
+}
+/**
+ * Quote response
+ */
+export interface Quote {
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    amountOut: bigint;
+    minimumAmountOut: bigint;
+    route: RouteStep[];
+    priceImpact: number;
+    estimatedGas: bigint;
+    validUntil: number;
+}
+/**
+ * Swap request
+ */
+export interface SwapRequest {
+    quote: Quote;
+    recipient: Address;
+    deadline?: number;
+}
+/**
+ * Swap result
+ */
+export interface SwapResult {
+    txHash: `0x${string}`;
+    amountIn: bigint;
+    amountOut: bigint;
+    route: RouteStep[];
+}
+/**
+ * Router configuration
+ */
+export interface RouterConfig {
+    clobUrl?: string;
+    clobEnabled?: boolean;
+    ammEnabled?: boolean;
+    maxHops?: number;
+    preferCLOB?: boolean;
+    hybridEnabled?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/router/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,eAAe,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,SAAS,EAAE,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAE3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IAGrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB"}

package/dist/router/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,41 +1,67 @@
 {
   "name": "@luxfi/dex",
-  "version": "1.2.1",
-  "description": "TypeScript SDK for LX",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "2.0.0",
+  "description": "Lux DEX SDK - CLOB client, AMM precompiles, and omnichain routing",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.ts",
+      "import": "./dist/router/index.js"
+    },
+    "./precompile": {
+      "types": "./dist/precompile/index.d.ts",
+      "import": "./dist/precompile/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "scripts": {
+    "typecheck": "tsc --noEmit",
     "build": "tsc",
-    "test": "jest",
-    "lint": "eslint src/**/*.ts",
-    "prepublish": "npm run build"
+    "prepublishOnly": "bun run build"
   },
-  "keywords": [
-    "luxfi",
-    "dex",
-    "trading",
-    "blockchain",
-    "sdk"
-  ],
-  "author": "Lux Network",
-  "license": "MIT",
   "dependencies": {
-    "axios": "^1.6.0",
-    "ws": "^8.14.0"
+    "viem": "^2.30.6",
+    "wagmi": "^3.1.3",
+    "zustand": "^5.0.5"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.0",
-    "@types/node": "^20.0.0",
-    "@types/ws": "^8.5.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "eslint": "^8.0.0",
-    "jest": "^29.5.0",
-    "ts-jest": "^29.1.0",
-    "typescript": "^5.0.0"
+    "@types/node": "^25.0.3",
+    "@types/react": "^19.2.3",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/luxfi/dex.git"
-  }
+    "url": "https://github.com/luxfi/exchange.git",
+    "directory": "pkgs/dex"
+  },
+  "keywords": [
+    "lux",
+    "dex",
+    "defi",
+    "clob",
+    "amm",
+    "swap",
+    "precompile"
+  ]
 }