@luxfi/dex 1.3.0 → 2.0.1

package/dist/hooks/use-lxvault.js

@@ -0,0 +1,227 @@
+/**
+ * LXVault Hooks (LP-9030)
+ * React hooks for custody, margin, and positions via LXVault precompile
+ */
+import { useCallback } from 'react';
+import { useReadContract, useWriteContract, useWaitForTransactionReceipt, useAccount } from 'wagmi';
+import { LX } from '../precompile/addresses';
+import { LX_VAULT_ABI } from '../precompile/abis';
+/**
+ * Build account tuple from address and subaccount
+ */
+function buildAccount(main, subaccountId = 0) {
+    return { main, subaccountId };
+}
+/**
+ * Hook to get token balance in vault
+ */
+export function useLXVaultBalance(token, subaccountId = 0) {
+    const { address } = useAccount();
+    const { data, isLoading, error, refetch } = useReadContract({
+        address: LX.LX_VAULT,
+        abi: LX_VAULT_ABI,
+        functionName: 'getBalance',
+        args: address ? [buildAccount(address, subaccountId), token] : undefined,
+        query: { enabled: !!address },
+    });
+    return {
+        balance: data,
+        isLoading,
+        error,
+        refetch,
+    };
+}
+/**
+ * Hook to get position for a market
+ */
+export function useLXVaultPosition(marketId, subaccountId = 0) {
+    const { address } = useAccount();
+    const { data, isLoading, error, refetch } = useReadContract({
+        address: LX.LX_VAULT,
+        abi: LX_VAULT_ABI,
+        functionName: 'getPosition',
+        args: address ? [buildAccount(address, subaccountId), marketId] : undefined,
+        query: { enabled: !!address },
+    });
+    return {
+        position: data,
+        isLoading,
+        error,
+        refetch,
+    };
+}
+/**
+ * Hook to get margin info (free margin, used margin, etc.)
+ */
+export function useLXVaultMargin(subaccountId = 0) {
+    const { address } = useAccount();
+    const { data, isLoading, error, refetch } = useReadContract({
+        address: LX.LX_VAULT,
+        abi: LX_VAULT_ABI,
+        functionName: 'getMargin',
+        args: address ? [buildAccount(address, subaccountId)] : undefined,
+        query: { enabled: !!address },
+    });
+    return {
+        margin: data,
+        isLoading,
+        error,
+        refetch,
+    };
+}
+/**
+ * Hook to check if account is liquidatable
+ */
+export function useLXVaultLiquidatable(account, subaccountId = 0) {
+    const { address: connectedAddress } = useAccount();
+    const targetAddress = account ?? connectedAddress;
+    const { data, isLoading, error, refetch } = useReadContract({
+        address: LX.LX_VAULT,
+        abi: LX_VAULT_ABI,
+        functionName: 'isLiquidatable',
+        args: targetAddress ? [buildAccount(targetAddress, subaccountId)] : undefined,
+        query: { enabled: !!targetAddress },
+    });
+    const result = data;
+    return {
+        liquidatable: result?.[0],
+        shortfall: result?.[1],
+        isLoading,
+        error,
+        refetch,
+    };
+}
+/**
+ * Hook to get funding rate for a market
+ */
+export function useLXVaultFundingRate(marketId) {
+    const { data, isLoading, error, refetch } = useReadContract({
+        address: LX.LX_VAULT,
+        abi: LX_VAULT_ABI,
+        functionName: 'getFundingRate',
+        args: [marketId],
+    });
+    const result = data;
+    return {
+        rateX18: result?.[0],
+        nextFundingTime: result?.[1],
+        isLoading,
+        error,
+        refetch,
+    };
+}
+/**
+ * Hook for depositing tokens into vault
+ */
+export function useLXVaultDeposit() {
+    const { writeContract, data: hash, isPending, error } = useWriteContract();
+    const { isLoading: isConfirming, isSuccess } = useWaitForTransactionReceipt({ hash });
+    const deposit = useCallback((token, amount, subaccountId = 0) => {
+        writeContract({
+            address: LX.LX_VAULT,
+            abi: LX_VAULT_ABI,
+            functionName: 'deposit',
+            args: [token, amount, subaccountId],
+        });
+    }, [writeContract]);
+    return {
+        deposit,
+        hash,
+        isPending,
+        isConfirming,
+        isSuccess,
+        error,
+    };
+}
+/**
+ * Hook for withdrawing tokens from vault
+ */
+export function useLXVaultWithdraw() {
+    const { writeContract, data: hash, isPending, error } = useWriteContract();
+    const { isLoading: isConfirming, isSuccess } = useWaitForTransactionReceipt({ hash });
+    const withdraw = useCallback((token, amount, subaccountId = 0) => {
+        writeContract({
+            address: LX.LX_VAULT,
+            abi: LX_VAULT_ABI,
+            functionName: 'withdraw',
+            args: [token, amount, subaccountId],
+        });
+    }, [writeContract]);
+    return {
+        withdraw,
+        hash,
+        isPending,
+        isConfirming,
+        isSuccess,
+        error,
+    };
+}
+/**
+ * Hook for transferring between subaccounts
+ */
+export function useLXVaultTransfer() {
+    const { writeContract, data: hash, isPending, error } = useWriteContract();
+    const { isLoading: isConfirming, isSuccess } = useWaitForTransactionReceipt({ hash });
+    const transfer = useCallback((token, amount, fromSubaccount, toSubaccount) => {
+        writeContract({
+            address: LX.LX_VAULT,
+            abi: LX_VAULT_ABI,
+            functionName: 'transfer',
+            args: [token, amount, fromSubaccount, toSubaccount],
+        });
+    }, [writeContract]);
+    return {
+        transfer,
+        hash,
+        isPending,
+        isConfirming,
+        isSuccess,
+        error,
+    };
+}
+/**
+ * Hook for liquidating underwater positions
+ */
+export function useLXVaultLiquidate() {
+    const { writeContract, data: hash, isPending, error } = useWriteContract();
+    const { isLoading: isConfirming, isSuccess } = useWaitForTransactionReceipt({ hash });
+    const liquidate = useCallback((targetAccount, targetSubaccount, marketId, sizeX18) => {
+        writeContract({
+            address: LX.LX_VAULT,
+            abi: LX_VAULT_ABI,
+            functionName: 'liquidate',
+            args: [buildAccount(targetAccount, targetSubaccount), marketId, sizeX18],
+        });
+    }, [writeContract]);
+    return {
+        liquidate,
+        hash,
+        isPending,
+        isConfirming,
+        isSuccess,
+        error,
+    };
+}
+/**
+ * Combined hook for common vault operations
+ */
+export function useLXVault(subaccountId = 0) {
+    const { address } = useAccount();
+    const margin = useLXVaultMargin(subaccountId);
+    const { deposit, isPending: isDepositing } = useLXVaultDeposit();
+    const { withdraw, isPending: isWithdrawing } = useLXVaultWithdraw();
+    const { transfer, isPending: isTransferring } = useLXVaultTransfer();
+    return {
+        address,
+        subaccountId,
+        margin: margin.margin,
+        isLoadingMargin: margin.isLoading,
+        deposit,
+        withdraw,
+        transfer,
+        isDepositing,
+        isWithdrawing,
+        isTransferring,
+        refetchMargin: margin.refetch,
+    };
+}

package/dist/index.d.ts

@@ -1,33 +1,50 @@
 /**
  * @luxfi/dex
  *
- * DEX Integration Package
+ * LX Integration Package
  *
- * Provides routing between:
- * - CLOB (Central Limit Order Book) via ~/work/lux/dex
- * - AMM Precompiles (0x0400-0x0403) for native swaps
+ * Native precompile integration for Lux DEX stack:
+ * - LXPool (LP-9010): v4-style AMM PoolManager
+ * - LXOracle (LP-9011): Multi-source price aggregation
+ * - LXRouter (LP-9012): Optimized swap routing
+ * - LXHooks (LP-9013): Hook contract registry
+ * - LXFlash (LP-9014): Flash loan facility
+ * - LXBook (LP-9020): CLOB matching engine
+ * - LXVault (LP-9030): Custody and margin engine
+ * - LXFeed (LP-9040): Mark price and funding feeds
  *
  * Architecture:
  * ```
- * ┌────────────────────────────────────────┐
- * │           Omnichain Router             │
- * │  Best execution between CLOB & AMM     │
- * └─────────────────┬──────────────────────┘
- *                   │
- *     ┌─────────────┴─────────────┐
- *     │                           │
- *     ▼                           ▼
- * ┌─────────┐              ┌───────────────┐
- * │  CLOB   │              │ AMM Precompile│
- * │ Client  │              │   (0x0400)    │
- * │         │              │               │
- * │ • Limit │              │ • Swap        │
- * │ • HFT   │              │ • Liquidity   │
- * │ • Perps │              │ • Flash       │
- * └─────────┘              └───────────────┘
+ * ┌─────────────────────────────────────────────────────────────┐
+ * │                    Omnichain Router                         │
+ * │           Best execution between CLOB & AMM                 │
+ * └─────────────────────────┬───────────────────────────────────┘
+ *                           │
+ *       ┌───────────────────┼───────────────────┐
+ *       │                   │                   │
+ *       ▼                   ▼                   ▼
+ * ┌───────────┐      ┌───────────┐       ┌───────────┐
+ * │  LXBook   │      │  LXPool   │       │  LXVault  │
+ * │ (LP-9020) │      │ (LP-9010) │       │ (LP-9030) │
+ * │           │      │           │       │           │
+ * │ • Orders  │      │ • Swaps   │       │ • Custody │
+ * │ • CLOB    │      │ • AMM     │       │ • Margin  │
+ * │ • Perps   │      │ • Flash   │       │ • Liq.    │
+ * └───────────┘      └───────────┘       └───────────┘
+ *       │                   │                   │
+ *       └───────────────────┴───────────────────┘
+ *                           │
+ *                    ┌──────┴──────┐
+ *                    │   LXFeed    │
+ *                    │  (LP-9040)  │
+ *                    │             │
+ *                    │ • Mark Px   │
+ *                    │ • Index Px  │
+ *                    │ • Funding   │
+ *                    └─────────────┘
  * ```
  */
-export { type Currency, type PoolKey, type BalanceDelta, type SwapParams, type ModifyLiquidityParams, type PoolState, type Position as AMMPosition, NATIVE_LUX, sortCurrencies, createPoolKey, POOL_MANAGER_ABI, SWAP_ROUTER_ABI, HOOKS_REGISTRY_ABI, FLASH_LOAN_ABI, DEX_PRECOMPILES, type DexPrecompile, } from './precompile';
+export { type Currency, type PoolKey, type BalanceDelta, type SwapParams, type ModifyLiquidityParams, type PoolState, type Position as AMMPosition, NATIVE_LUX, sortCurrencies, createPoolKey, TIF, OrderKind, GroupType, ActionType, type LXOrder, type LXAction, type LXPlaceResult, type LXL1, MarginMode, PositionSide, type LXAccount, type LXPosition, type LXMarginInfo, type LXSettlement, type LXLiquidationResult, type LXMarkPrice, type LXFundingRate, POOL_MANAGER_ABI, SWAP_ROUTER_ABI, HOOKS_REGISTRY_ABI, FLASH_LOAN_ABI, LX_BOOK_ABI, LX_VAULT_ABI, LX_FEED_ABI, LX_ORACLE_ABI, LX, DEX_PRECOMPILES, type LxdexPrecompile, type DexPrecompile, fromLP, toLP, isDEXPrecompile, isBridgePrecompile, } from './precompile';
 export { type OrderSide, type OrderType, type OrderStatus, type TimeInForce, type OrderRequest, type Order, type OrderBookEntry, type OrderBook, type Trade, type Position as CLOBPosition, type Balance, type ICLOBClient, CLOBClient, createCLOBClient, } from './client';
 export * from './router';
 export * from './hooks';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,QAAQ,IAAI,WAAW,EAC5B,UAAU,EACV,cAAc,EACd,aAAa,EAEb,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,cAAc,EAEd,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,QAAQ,IAAI,YAAY,EAC7B,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,UAAU,EACV,gBAAgB,GACjB,MAAM,UAAU,CAAA;AAGjB,cAAc,UAAU,CAAA;AAGxB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAMH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,QAAQ,IAAI,WAAW,EAC5B,UAAU,EACV,cAAc,EACd,aAAa,EAGb,GAAG,EACH,SAAS,EACT,SAAS,EACT,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,IAAI,EAGT,UAAU,EACV,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAGxB,KAAK,WAAW,EAChB,KAAK,aAAa,EAGlB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,cAAc,EAGd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EAGb,EAAE,EACF,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,MAAM,EACN,IAAI,EACJ,eAAe,EACf,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAMrB,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,QAAQ,IAAI,YAAY,EAC7B,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,UAAU,EACV,gBAAgB,GACjB,MAAM,UAAU,CAAA;AAMjB,cAAc,UAAU,CAAA;AAMxB,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -1,41 +1,72 @@
 /**
  * @luxfi/dex
  *
- * DEX Integration Package
+ * LX Integration Package
  *
- * Provides routing between:
- * - CLOB (Central Limit Order Book) via ~/work/lux/dex
- * - AMM Precompiles (0x0400-0x0403) for native swaps
+ * Native precompile integration for Lux DEX stack:
+ * - LXPool (LP-9010): v4-style AMM PoolManager
+ * - LXOracle (LP-9011): Multi-source price aggregation
+ * - LXRouter (LP-9012): Optimized swap routing
+ * - LXHooks (LP-9013): Hook contract registry
+ * - LXFlash (LP-9014): Flash loan facility
+ * - LXBook (LP-9020): CLOB matching engine
+ * - LXVault (LP-9030): Custody and margin engine
+ * - LXFeed (LP-9040): Mark price and funding feeds
  *
  * Architecture:
  * ```
- * ┌────────────────────────────────────────┐
- * │           Omnichain Router             │
- * │  Best execution between CLOB & AMM     │
- * └─────────────────┬──────────────────────┘
- *                   │
- *     ┌─────────────┴─────────────┐
- *     │                           │
- *     ▼                           ▼
- * ┌─────────┐              ┌───────────────┐
- * │  CLOB   │              │ AMM Precompile│
- * │ Client  │              │   (0x0400)    │
- * │         │              │               │
- * │ • Limit │              │ • Swap        │
- * │ • HFT   │              │ • Liquidity   │
- * │ • Perps │              │ • Flash       │
- * └─────────┘              └───────────────┘
+ * ┌─────────────────────────────────────────────────────────────┐
+ * │                    Omnichain Router                         │
+ * │           Best execution between CLOB & AMM                 │
+ * └─────────────────────────┬───────────────────────────────────┘
+ *                           │
+ *       ┌───────────────────┼───────────────────┐
+ *       │                   │                   │
+ *       ▼                   ▼                   ▼
+ * ┌───────────┐      ┌───────────┐       ┌───────────┐
+ * │  LXBook   │      │  LXPool   │       │  LXVault  │
+ * │ (LP-9020) │      │ (LP-9010) │       │ (LP-9030) │
+ * │           │      │           │       │           │
+ * │ • Orders  │      │ • Swaps   │       │ • Custody │
+ * │ • CLOB    │      │ • AMM     │       │ • Margin  │
+ * │ • Perps   │      │ • Flash   │       │ • Liq.    │
+ * └───────────┘      └───────────┘       └───────────┘
+ *       │                   │                   │
+ *       └───────────────────┴───────────────────┘
+ *                           │
+ *                    ┌──────┴──────┐
+ *                    │   LXFeed    │
+ *                    │  (LP-9040)  │
+ *                    │             │
+ *                    │ • Mark Px   │
+ *                    │ • Index Px  │
+ *                    │ • Funding   │
+ *                    └─────────────┘
  * ```
  */
-// Precompile types and ABIs (AMM)
+// =============================================================================
+// Precompile Types, ABIs, and Addresses
+// =============================================================================
 export { NATIVE_LUX, sortCurrencies, createPoolKey, 
-// ABIs
+// LXBook Types (LP-9020)
+TIF, OrderKind, GroupType, ActionType, 
+// LXVault Types (LP-9030)
+MarginMode, PositionSide, 
+// AMM ABIs
 POOL_MANAGER_ABI, SWAP_ROUTER_ABI, HOOKS_REGISTRY_ABI, FLASH_LOAN_ABI, 
+// LX* ABIs
+LX_BOOK_ABI, LX_VAULT_ABI, LX_FEED_ABI, LX_ORACLE_ABI, 
 // Addresses
-DEX_PRECOMPILES, } from './precompile';
-// CLOB client (exports Position as CLOBPosition to avoid conflict)
+LX, DEX_PRECOMPILES, fromLP, toLP, isDEXPrecompile, isBridgePrecompile, } from './precompile';
+// =============================================================================
+// CLOB Client (External ~/work/lux/dex integration)
+// =============================================================================
 export { CLOBClient, createCLOBClient, } from './client';
-// Omnichain router
+// =============================================================================
+// Omnichain Router
+// =============================================================================
 export * from './router';
-// React hooks
+// =============================================================================
+// React Hooks
+// =============================================================================
 export * from './hooks';