@luxfi/exchange 0.2.0 → 1.0.1

package/dist/hooks/use-pools.js

@@ -2,13 +2,15 @@
 import { useQuery } from '@tanstack/react-query';
 import { usePublicClient } from 'wagmi';
 import { getContracts } from '../contracts';
-import { UNISWAP_V3_FACTORY_ABI, UNISWAP_V3_POOL_ABI } from '../contracts/abis';
+import { LUX_V3_FACTORY_ABI, LUX_V3_POOL_ABI } from '../contracts/abis';
+import { LUX_MAINNET_CONTRACTS } from '../contracts/addresses';
 /**
  * Hook to get pool information
  */
 export function usePool(token0, token1, fee, chainId) {
     const publicClient = usePublicClient({ chainId });
     const contracts = getContracts(chainId);
+    const v3Factory = 'V3_FACTORY' in contracts ? contracts.V3_FACTORY : LUX_MAINNET_CONTRACTS.V3_FACTORY;
     return useQuery({
         queryKey: ['pool', token0, token1, fee, chainId],
         queryFn: async () => {
@@ -17,8 +19,8 @@ export function usePool(token0, token1, fee, chainId) {
             try {
                 // Get pool address from factory
                 const poolAddress = await publicClient.readContract({
-                    address: contracts.V3_FACTORY,
-                    abi: UNISWAP_V3_FACTORY_ABI,
+                    address: v3Factory,
+                    abi: LUX_V3_FACTORY_ABI,
                     functionName: 'getPool',
                     args: [token0, token1, fee],
                 });
@@ -29,17 +31,17 @@ export function usePool(token0, token1, fee, chainId) {
                 const [slot0, liquidity, tickSpacing] = await Promise.all([
                     publicClient.readContract({
                         address: poolAddress,
-                        abi: UNISWAP_V3_POOL_ABI,
+                        abi: LUX_V3_POOL_ABI,
                         functionName: 'slot0',
                     }),
                     publicClient.readContract({
                         address: poolAddress,
-                        abi: UNISWAP_V3_POOL_ABI,
+                        abi: LUX_V3_POOL_ABI,
                         functionName: 'liquidity',
                     }),
                     publicClient.readContract({
                         address: poolAddress,
-                        abi: UNISWAP_V3_POOL_ABI,
+                        abi: LUX_V3_POOL_ABI,
                         functionName: 'tickSpacing',
                     }),
                 ]);

package/dist/hooks/use-swap.js

@@ -15,7 +15,7 @@ export function useSwap() {
             const contracts = getContracts(params.chainId);
             const isNativeIn = isNativeToken(params.tokenIn);
             const txHash = await writeContractAsync({
-                address: contracts.V3_SWAP_ROUTER_02,
+                address: contracts.V3_SWAP_ROUTER_02 ?? contracts.V2_ROUTER,
                 abi: SWAP_ROUTER_ABI,
                 functionName: 'exactInputSingle',
                 args: [

package/dist/hooks/use-token-allowance.d.ts

@@ -18,7 +18,7 @@ export declare function useTokenAllowance(token: Token | null, owner: Address |
     isPending: boolean;
     isConfirming: boolean;
     isSuccess: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<bigint, import("viem").ReadContractErrorType>>;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<bigint, import("viem").ReadContractErrorType>>;
 };
 /**
  * Check if approval is needed for a specific amount

package/dist/tokens/index.d.ts

@@ -28,9 +28,25 @@ export declare const WLUX_DEV: Token;
 export declare const LUSD: Token;
 /**
  * Bridge tokens (L-prefix for assets bridged to Lux)
+ * These are the canonical mainnet addresses from @luxfi/config
  */
 export declare const LETH: Token;
 export declare const LBTC: Token;
+export declare const LSOL: Token;
+export declare const LTON: Token;
+export declare const LAVAX: Token;
+/**
+ * Testnet bridge tokens
+ */
+export declare const LETH_TESTNET: Token;
+export declare const LBTC_TESTNET: Token;
+export declare const LUSD_TESTNET: Token;
+/**
+ * Dev mode bridge tokens (deterministic CREATE addresses)
+ */
+export declare const LETH_DEV: Token;
+export declare const LBTC_DEV: Token;
+export declare const LUSD_DEV: Token;
 /**
  * Major tokens on Lux Mainnet
  */
@@ -43,9 +59,9 @@ export declare const DAI_LUX: Token;
  * Zoo chain tokens
  */
 export declare const WZOO: Token;
-export declare const USDC_ZOO: Token;
-export declare const USDT_ZOO: Token;
-export declare const WETH_ZOO: Token;
+export declare const LETH_ZOO: Token;
+export declare const LBTC_ZOO: Token;
+export declare const LUSD_ZOO: Token;
 /**
  * Default token list for Lux Mainnet
  */
@@ -54,6 +70,18 @@ export declare const LUX_MAINNET_TOKENS: Token[];
  * Default token list for Zoo Mainnet
  */
 export declare const ZOO_MAINNET_TOKENS: Token[];
+/**
+ * Default token list for Lux Testnet
+ */
+export declare const LUX_TESTNET_TOKENS: Token[];
+/**
+ * Default token list for Lux Dev
+ */
+export declare const LUX_DEV_TOKENS: Token[];
+/**
+ * Get tokens for a chain
+ */
+export declare function getTokensForChain(chainId: number): Token[];
 /**
  * Get wrapped native token for chain
  */

package/dist/tokens/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,KAOxB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAOxB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,KAMrB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,EAWrC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,EAMrC,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAWnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,KAOxB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAOxB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAOtB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAMnB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,KAMrB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,KAMlB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAMtB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,EASrC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,EAMrC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,EAKrC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,EAKjC,CAAA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAa1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAWnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEnD"}

package/dist/tokens/index.js

@@ -21,21 +21,22 @@ export const NATIVE_ZOO = {
  * Wrapped native tokens
  */
 export const WLUX_MAINNET = {
-    address: '0x55750d6CA62a041c06a8E28626b10Be6c688f471',
+    address: '0x4888e4a2ee0f03051c72d2bd3acf755ed3498b3e',
     chainId: 96369,
     decimals: 18,
     symbol: 'WLUX',
     name: 'Wrapped LUX',
 };
 export const WLUX_TESTNET = {
-    address: '0x732740c5c895C9FCF619930ed4293fc858eb44c7',
+    address: '0xDe5310d0Eccc04C8987cB66Ff6b89Ee793442C91',
     chainId: 96368,
     decimals: 18,
     symbol: 'WLUX',
     name: 'Wrapped LUX',
 };
 export const WLUX_DEV = {
-    address: '0x610178dA211FEF7D417bC0e6FeD39F05609AD788',
+    // Deterministic CREATE address from DeployFullStack.s.sol (nonce 0)
+    address: '0x5FbDB2315678afecb367f032d93F642f64180aa3',
     chainId: 1337,
     decimals: 18,
     symbol: 'WLUX',
@@ -45,29 +46,99 @@ export const WLUX_DEV = {
  * Stablecoins
  */
 export const LUSD = {
-    address: '0x0000000000000000000000000000000000000000', // TODO: Deploy
+    address: '0x848Cff46eb323f323b6Bbe1Df274E40793d7f2c2',
     chainId: 96369,
     decimals: 18,
     symbol: 'LUSD',
-    name: 'Lux Dollar',
+    name: 'Lux USD',
 };
 /**
  * Bridge tokens (L-prefix for assets bridged to Lux)
+ * These are the canonical mainnet addresses from @luxfi/config
  */
 export const LETH = {
-    address: '0xAA3AE951A7925F25aE8Ad65b052a76Bd8f052598',
+    address: '0x60E0a8167FC13dE89348978860466C9ceC24B9ba',
     chainId: 96369,
     decimals: 18,
     symbol: 'LETH',
     name: 'Lux ETH',
 };
 export const LBTC = {
-    address: '0x526903Ee6118de6737D11b37f82fC7f69B13685D',
+    address: '0x1E48D32a4F5e9f08DB9aE4959163300FaF8A6C8e',
+    chainId: 96369,
+    decimals: 8,
+    symbol: 'LBTC',
+    name: 'Lux BTC',
+};
+export const LSOL = {
+    address: '0x26B40f650156C7EbF9e087Dd0dca181Fe87625B7',
     chainId: 96369,
+    decimals: 18,
+    symbol: 'LSOL',
+    name: 'Lux SOL',
+};
+export const LTON = {
+    address: '0x3141b94b89691009b950c96e97Bff48e0C543E3C',
+    chainId: 96369,
+    decimals: 9,
+    symbol: 'LTON',
+    name: 'Lux TON',
+};
+export const LAVAX = {
+    address: '0x0e4bD0DD67c15dECfBBBdbbE07FC9d51D737693D',
+    chainId: 96369,
+    decimals: 18,
+    symbol: 'LAVAX',
+    name: 'Lux AVAX',
+};
+/**
+ * Testnet bridge tokens
+ */
+export const LETH_TESTNET = {
+    address: '0xA695a8A66fbe3E32d15a531db04185313595771A',
+    chainId: 96368,
+    decimals: 18,
+    symbol: 'LETH',
+    name: 'Lux ETH',
+};
+export const LBTC_TESTNET = {
+    address: '0x5a88986958ea76Dd043f834542724F081cA1443B',
+    chainId: 96368,
     decimals: 8,
     symbol: 'LBTC',
     name: 'Lux BTC',
 };
+export const LUSD_TESTNET = {
+    address: '0x8a3fad1c7FB94461621351aa6A983B6f814F039c',
+    chainId: 96368,
+    decimals: 6,
+    symbol: 'LUSDC',
+    name: 'Lux USDC',
+};
+/**
+ * Dev mode bridge tokens (deterministic CREATE addresses)
+ */
+export const LETH_DEV = {
+    address: '0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512',
+    chainId: 1337,
+    decimals: 18,
+    symbol: 'LETH',
+    name: 'Lux ETH',
+};
+export const LBTC_DEV = {
+    address: '0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0',
+    chainId: 1337,
+    decimals: 8,
+    symbol: 'LBTC',
+    name: 'Lux BTC',
+};
+export const LUSD_DEV = {
+    address: '0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9',
+    chainId: 1337,
+    decimals: 6,
+    symbol: 'LUSD',
+    name: 'Lux Dollar',
+};
 /**
  * Major tokens on Lux Mainnet
  */
@@ -100,7 +171,7 @@ export const WBTC_LUX = {
     name: 'Wrapped Bitcoin',
 };
 export const DAI_LUX = {
-    address: '0x6B175474E89094C44Da98b954EesdscdKD34eL55',
+    address: '0x6B175474E89094C44Da98b954EedeAC495271d0F',
     chainId: 96369,
     decimals: 18,
     symbol: 'DAI',
@@ -110,32 +181,32 @@ export const DAI_LUX = {
  * Zoo chain tokens
  */
 export const WZOO = {
-    address: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
+    address: '0x5491216406daB99b7032b83765F36790E27F8A61',
     chainId: 200200,
     decimals: 18,
     symbol: 'WZOO',
     name: 'Wrapped ZOO',
 };
-export const USDC_ZOO = {
-    address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+export const LETH_ZOO = {
+    address: '0x4870621EA8be7a383eFCfdA225249d35888bD9f2',
     chainId: 200200,
-    decimals: 6,
-    symbol: 'USDC',
-    name: 'USD Coin',
+    decimals: 18,
+    symbol: 'LETH',
+    name: 'Lux ETH',
 };
-export const USDT_ZOO = {
-    address: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
+export const LBTC_ZOO = {
+    address: '0x6fc44509a32E513bE1aa00d27bb298e63830C6A8',
     chainId: 200200,
-    decimals: 6,
-    symbol: 'USDT',
-    name: 'Tether USD',
+    decimals: 8,
+    symbol: 'LBTC',
+    name: 'Lux BTC',
 };
-export const WETH_ZOO = {
-    address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+export const LUSD_ZOO = {
+    address: '0xb2ee1CE7b84853b83AA08702aD0aD4D79711882D',
     chainId: 200200,
     decimals: 18,
-    symbol: 'WETH',
-    name: 'Wrapped Ether',
+    symbol: 'LUSD',
+    name: 'Lux USD',
 };
 /**
  * Default token list for Lux Mainnet
@@ -143,14 +214,12 @@ export const WETH_ZOO = {
 export const LUX_MAINNET_TOKENS = [
     NATIVE_LUX,
     WLUX_MAINNET,
-    USDC_LUX,
-    USDT_LUX,
-    WETH_LUX,
-    WBTC_LUX,
-    DAI_LUX,
+    LUSD,
     LETH,
     LBTC,
-    LUSD,
+    LSOL,
+    LTON,
+    LAVAX,
 ];
 /**
  * Default token list for Zoo Mainnet
@@ -158,10 +227,45 @@ export const LUX_MAINNET_TOKENS = [
 export const ZOO_MAINNET_TOKENS = [
     NATIVE_ZOO,
     WZOO,
-    USDC_ZOO,
-    USDT_ZOO,
-    WETH_ZOO,
+    LUSD_ZOO,
+    LETH_ZOO,
+    LBTC_ZOO,
+];
+/**
+ * Default token list for Lux Testnet
+ */
+export const LUX_TESTNET_TOKENS = [
+    WLUX_TESTNET,
+    LETH_TESTNET,
+    LBTC_TESTNET,
+    LUSD_TESTNET,
+];
+/**
+ * Default token list for Lux Dev
+ */
+export const LUX_DEV_TOKENS = [
+    WLUX_DEV,
+    LETH_DEV,
+    LBTC_DEV,
+    LUSD_DEV,
 ];
+/**
+ * Get tokens for a chain
+ */
+export function getTokensForChain(chainId) {
+    switch (chainId) {
+        case 96369:
+            return LUX_MAINNET_TOKENS;
+        case 96368:
+            return LUX_TESTNET_TOKENS;
+        case 1337:
+            return LUX_DEV_TOKENS;
+        case 200200:
+            return ZOO_MAINNET_TOKENS;
+        default:
+            return [];
+    }
+}
 /**
  * Get wrapped native token for chain
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luxfi/exchange",
-  "version": "0.2.0",
+  "version": "1.0.1",
   "description": "Lux Exchange SDK - React hooks and utilities for Lux DEX",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -68,7 +68,7 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/luxfi/exchange.git",
-    "directory": "packages/exchange"
+    "directory": "pkgs/exchange"
   },
   "keywords": [
     "lux",

package/src/contracts/abis/{uniswap-v2-factory.ts → amm-v2-factory.ts}

@@ -1,7 +1,8 @@
 /**
- * UniswapV2Factory ABI
+ * AMM V2 Factory ABI
+ * Compatible with Lux V2 Factory interface
  */
-export const UNISWAP_V2_FACTORY_ABI = [
+export const AMM_V2_FACTORY_ABI = [
   {
     type: 'function',
     name: 'getPair',
@@ -47,3 +48,6 @@ export const UNISWAP_V2_FACTORY_ABI = [
     ],
   },
 ] as const
+
+/** @deprecated Use AMM_V2_FACTORY_ABI instead */
+export const LUX_V2_FACTORY_ABI = AMM_V2_FACTORY_ABI

package/src/contracts/abis/{uniswap-v2-pair.ts → amm-v2-pair.ts}

@@ -1,7 +1,8 @@
 /**
- * UniswapV2Pair ABI
+ * AMM V2 Pair ABI
+ * Compatible with Lux V2 Pair interface
  */
-export const UNISWAP_V2_PAIR_ABI = [
+export const AMM_V2_PAIR_ABI = [
   {
     type: 'function',
     name: 'token0',
@@ -83,3 +84,6 @@ export const UNISWAP_V2_PAIR_ABI = [
     ],
   },
 ] as const
+
+/** @deprecated Use AMM_V2_PAIR_ABI instead */
+export const LUX_V2_PAIR_ABI = AMM_V2_PAIR_ABI

package/src/contracts/abis/{uniswap-v2-router.ts → amm-v2-router.ts}

@@ -1,7 +1,8 @@
 /**
- * UniswapV2Router02 ABI (used by Lux AMM V2)
+ * AMM V2 Router ABI
+ * Compatible with Lux V2 Router02 interface
  */
-export const UNISWAP_V2_ROUTER_ABI = [
+export const AMM_V2_ROUTER_ABI = [
   {
     type: 'function',
     name: 'factory',
@@ -144,3 +145,6 @@ export const UNISWAP_V2_ROUTER_ABI = [
     stateMutability: 'nonpayable',
   },
 ] as const
+
+/** @deprecated Use AMM_V2_ROUTER_ABI instead */
+export const LUX_V2_ROUTER_ABI = AMM_V2_ROUTER_ABI

package/src/contracts/abis/{uniswap-v3-factory.ts → amm-v3-factory.ts}

@@ -1,7 +1,8 @@
 /**
- * UniswapV3Factory ABI
+ * AMM V3 Factory ABI
+ * Compatible with Lux V3 Factory interface
  */
-export const UNISWAP_V3_FACTORY_ABI = [
+export const AMM_V3_FACTORY_ABI = [
   {
     type: 'function',
     name: 'getPool',
@@ -43,3 +44,6 @@ export const UNISWAP_V3_FACTORY_ABI = [
     ],
   },
 ] as const
+
+/** @deprecated Use AMM_V3_FACTORY_ABI instead */
+export const LUX_V3_FACTORY_ABI = AMM_V3_FACTORY_ABI

package/src/contracts/abis/{uniswap-v3-pool.ts → amm-v3-pool.ts}

@@ -1,7 +1,8 @@
 /**
- * UniswapV3Pool ABI (essential functions)
+ * AMM V3 Pool ABI
+ * Compatible with Lux V3 Pool interface
  */
-export const UNISWAP_V3_POOL_ABI = [
+export const AMM_V3_POOL_ABI = [
   {
     type: 'function',
     name: 'token0',
@@ -79,3 +80,6 @@ export const UNISWAP_V3_POOL_ABI = [
     ],
   },
 ] as const
+
+/** @deprecated Use AMM_V3_POOL_ABI instead */
+export const LUX_V3_POOL_ABI = AMM_V3_POOL_ABI

package/src/contracts/abis/index.ts

@@ -1,17 +1,27 @@
 /**
  * Contract ABIs for Lux Exchange
+ *
+ * AMM V2/V3 - Concentrated liquidity AMM (Lux V2/V3 compatible)
+ * DEX V4 - Hook-based DEX with singleton pool manager (Lux V4 compatible)
  */
 
-export { UNISWAP_V2_ROUTER_ABI } from './uniswap-v2-router'
-export { UNISWAP_V2_FACTORY_ABI } from './uniswap-v2-factory'
-export { UNISWAP_V2_PAIR_ABI } from './uniswap-v2-pair'
-export { UNISWAP_V3_FACTORY_ABI } from './uniswap-v3-factory'
-export { UNISWAP_V3_POOL_ABI } from './uniswap-v3-pool'
+// AMM V2 ABIs
+export { AMM_V2_ROUTER_ABI, LUX_V2_ROUTER_ABI } from './amm-v2-router'
+export { AMM_V2_FACTORY_ABI, LUX_V2_FACTORY_ABI } from './amm-v2-factory'
+export { AMM_V2_PAIR_ABI, LUX_V2_PAIR_ABI } from './amm-v2-pair'
+
+// AMM V3 ABIs
+export { AMM_V3_FACTORY_ABI, LUX_V3_FACTORY_ABI } from './amm-v3-factory'
+export { AMM_V3_POOL_ABI, LUX_V3_POOL_ABI } from './amm-v3-pool'
+
+// AMM V3 Periphery ABIs
 export { SWAP_ROUTER_ABI } from './swap-router'
 export { QUOTER_V2_ABI } from './quoter-v2'
 export { NFT_POSITION_MANAGER_ABI } from './nft-position-manager'
+
+// Common ABIs
 export { ERC20_ABI } from './erc20'
 
-// DEX Precompile ABIs
+// DEX V4 Precompile ABIs
 export { POOL_MANAGER_ABI } from './pool-manager'
 export { DEX_SWAP_ROUTER_ABI } from './dex-swap-router'

package/src/contracts/abis/pool-manager.ts

@@ -1,6 +1,6 @@
 /**
  * PoolManager Precompile ABI (0x0400)
- * Native Uniswap v4-style AMM implementation
+ * Native Lux v4-style AMM implementation
  */
 export const POOL_MANAGER_ABI = [
   // Pool initialization