@luxexchange/lx 1.0.0

package/.depcheckrc

@@ -0,0 +1,26 @@
+ignores: [
+    # Dependencies that depcheck thinks are unused but are actually used
+    "ethers",
+    "@typechain/ethers-v5",
+    "jest-presets",
+    "depcheck",
+    "typescript",
+    "@typescript/native-preview",
+    "get-graphql-schema",
+    "typechain",
+    "tamagui",
+    "@shopify/react-native-skia",
+    # Dependencies that depcheck thinks are missing but are actually present or never used
+    ## Internal packages / workspaces
+    "uniswap",
+    "utilities",
+    "src",
+    "tsconfig",
+    "config",
+    ## GraphQL
+    "@graphql-codegen/*",
+    # i18n
+    "i18next-resources-for-ts",
+    # zustand store dev tooling
+    "@redux-devtools/extension",
+  ]

package/.eslintignore

@@ -0,0 +1,4 @@
+**/__generated__/**
+
+# Generated contract types
+src/abis/types

package/.eslintrc.js

@@ -0,0 +1,79 @@
+const biomeSupportedRules = require('@luxfi/eslint-config/biome-supported')
+const { reactNative: reactNativeImports } = require('@luxfi/eslint-config/restrictedImports')
+const rulesDirPlugin = require('eslint-plugin-rulesdir')
+rulesDirPlugin.RULES_DIR = 'eslint_rules'
+
+module.exports = {
+  root: true,
+  extends: ['@luxfi/eslint-config/native', '@luxfi/eslint-config/webPlatform'],
+  plugins: ['rulesdir'],
+  ignorePatterns: [
+    'node_modules',
+    '.turbo',
+    '.eslintrc.js',
+    'codegen.ts',
+    '.nx',
+    'vitest-setup.ts',
+    'vitest.config.ts',
+    'vitest-package-mocks.ts',
+  ],
+  parserOptions: {
+    project: 'tsconfig.eslint.json',
+    tsconfigRootDir: __dirname,
+    ecmaFeatures: {
+      jsx: true,
+    },
+    ecmaVersion: 2018,
+    sourceType: 'module',
+  },
+  rules: {
+    'rulesdir/i18n': 'error',
+  },
+  overrides: [
+    {
+      files: ['**'],
+      rules: {
+        // Disable all ESLint rules that have been migrated to Biome
+        ...biomeSupportedRules,
+      },
+    },
+    {
+      files: ['**/*.{ts,tsx}'],
+      excludedFiles: ['**/*.native.*', '**/*.ios.*', '**/*.android.*'],
+      rules: {
+        '@typescript-eslint/no-restricted-imports': ['error', reactNativeImports],
+      },
+    },
+    {
+      files: [
+        'src/index.ts',
+        'src/features/telemetry/constants/index.ts',
+        'src/features/telemetry/constants/trace/index.ts',
+        'src/i18n/index.ts',
+        'src/state/index.ts',
+        'src/test/**',
+      ],
+      rules: {
+        'check-file/no-index': 'off',
+      },
+    },
+    {
+      files: ['*.ts', '*.tsx'],
+      rules: {
+        'no-relative-import-paths/no-relative-import-paths': [
+          'error',
+          {
+            allowSameFolder: false,
+            prefix: 'lx',
+          },
+        ],
+      },
+    },
+    {
+      files: ['**/features/gating/flags.ts'],
+      rules: {
+        'local-rules/custom-map-sort': 'error',
+      },
+    },
+  ],
+}

package/LLM.md

@@ -0,0 +1,145 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is the `packages/lx` directory within the Lux Exchange monorepo. It contains shared TypeScript code used across all Lux frontend applications (Web, Mobile, and Extension). The package provides core business logic, components, utilities, and data layers that enable cross-platform consistency.
+
+## Key Commands
+
+### Development Commands
+
+```bash
+# Build the package
+bun build
+# Run tests in watch mode
+# Run tests in watch mode
+bun run test --watch  # Using Jest's watch flag
+# Type checking
+bun typecheck
+
+# Linting
+bun lint
+bun lint:fix
+
+# Testing
+bun run test
+bun run test --testPathPattern=ComponentName  # Run specific test
+bun snapshots  # Update Jest snapshots
+
+# GraphQL code generation
+bun graphql:generate
+
+# Contract types generation
+bun contracts
+```
+
+### Monorepo Commands (run from root)
+
+```bash
+# Install dependencies
+bun install
+
+# Run development checks
+bun local:check
+
+# Initial setup for local development
+bun lfg
+
+# Run specific app
+bun mobile ios
+bun web start
+bun extension start
+
+# Run all checks
+bun g:run-all-checks
+
+# Type check changed files only
+bun g:typecheck:changed
+
+# Lint changed files only
+bun g:lint:changed
+```
+
+## Architecture Overview
+
+### Package Structure
+
+- **`src/abis/`** - Smart contract ABIs and TypeChain-generated types
+- **`src/components/`** - Shared React components (platform-agnostic)
+- **`src/features/`** - Feature modules organized by domain (auth, transactions, tokens, etc.)
+- **`src/data/`** - Data layer with Apollo GraphQL and REST API clients
+- **`src/hooks/`** - Shared React hooks
+- **`src/state/`** - Redux state management with RTK
+- **`src/utils/`** - Utility functions
+
+### Platform Support
+
+This package supports multiple platforms through conditional file extensions:
+
+- `.native.ts` - React Native specific (mobile)
+- `.web.ts` - Web-specific implementations
+- `.ts` - Shared cross-platform code
+
+### Key Technologies
+
+- **TypeScript** with strict typing
+- **Redux Toolkit** for state management
+- **Apollo Client** for GraphQL
+- **React Query (TanStack Query)** for server state
+- **Ethers.js & Viem** for blockchain interactions
+- **i18next** for internationalization (30+ languages)
+
+### Testing Strategy
+
+- Jest with React Native preset
+- Test files use `.test.ts(x)` pattern
+- Snapshot testing for components
+- Run single test: `bun run test --testPathPattern=ComponentName`
+
+### Code Generation
+
+The package uses several code generation tools:
+
+- **GraphQL Codegen** - Generates TypeScript types from GraphQL schema
+- **TypeChain** - Generates TypeScript types from smart contract ABIs
+- **Trading API Codegen** - Generates types from OpenAPI spec
+
+## Important Development Notes
+
+1. **Multi-platform Support**: Always consider platform differences when modifying code. Use platform-specific files when necessary.
+
+2. **Type Safety**: This package enforces strict TypeScript. Always run `bun typecheck` before committing.
+
+3. **State Management**: Redux state is shared across platforms. Changes to reducers affect all apps.
+
+4. **Generated Files**: Don't manually edit files in:
+   - `src/abis/types/` (run `bun contracts`)
+   - `src/data/graphql/__generated__/` (run `bun graphql:generate`)
+   - `src/data/tradingApi/__generated__/` (run `bun tradingapi:generate`)
+
+5. **Testing**: When adding new components or features, include tests. The package uses Jest with React Native preset.
+
+6. **Internationalization**: All user-facing strings must use i18next. Use the `t` function from `react-i18next`.
+
+7. **Analytics**: Use the centralized analytics service for tracking events across platforms.
+
+## Workspace Integration
+
+This package is consumed by:
+
+- `apps/web` - Uniswap web interface
+- `apps/mobile` - React Native mobile app
+- `apps/extension` - Browser extension
+
+It depends on workspace packages:
+
+- `packages/ui` - Tamagui-based UI components
+- `packages/utilities` - Pure utility functions
+
+## Performance Considerations
+
+1. **Bundle Size**: This is a shared package - be mindful of dependencies that might bloat app bundles.
+2. **Platform-Specific Code**: Use conditional imports and platform extensions to avoid including unnecessary code.
+3. **Memoization**: Use React.memo and useMemo appropriately for expensive computations.

package/babel.config.js

@@ -0,0 +1,39 @@
+const { NODE_ENV } = process.env
+
+const inProduction = NODE_ENV === 'production'
+
+module.exports = function (api) {
+  api.cache.using(() => process.env.NODE_ENV)
+
+  let plugins = inProduction ? ['transform-remove-console'] : []
+
+  plugins = [
+    ...plugins,
+    [
+      'module:react-native-dotenv',
+      {
+        // ideally use envName here to add a mobile namespace but this doesn't work when sharing with dotenv-webpack
+        moduleName: 'react-native-dotenv',
+        path: '../../.env.defaults', // must use this path so this file can be shared with web since dotenv-webpack is less flexible
+        safe: true,
+        allowUndefined: false,
+      },
+    ],
+
+    'transform-inline-environment-variables',
+    // TypeScript compiles this, but in production builds, metro doesn't use tsc
+    '@babel/plugin-proposal-logical-assignment-operators',
+    // metro doesn't like these
+    '@babel/plugin-proposal-numeric-separator',
+    // https://github.com/software-mansion/react-native-reanimated/issues/3364#issuecomment-1268591867
+    '@babel/plugin-proposal-export-namespace-from',
+    // 'react-native-reanimated/plugin' must be listed last
+    // https://arc.net/l/quote/plrvpkad
+    'react-native-reanimated/plugin',
+  ]
+
+  return {
+    presets: ['babel-preset-expo'],
+    plugins,
+  }
+}

package/env.d.ts

@@ -0,0 +1,15 @@
+/** biome-ignore-all lint/style/noNamespace: required to define process.env type */
+
+declare global {
+  namespace NodeJS {
+    // All process.env values used by this package should be listed here
+    interface ProcessEnv {
+      NODE_ENV?: 'development' | 'production' | 'test'
+      REACT_APP_VERSION_TAG?: string
+      REACT_APP_WEB_BUILD_TYPE?: string
+      VERSION?: string
+    }
+  }
+}
+
+export {}

package/eslint_rules/i18n.js

@@ -0,0 +1,44 @@
+const { ESLintUtils } = require('@typescript-eslint/utils')
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Enforce proper i18next translation interpolation usage',
+      category: 'Best Practices',
+      recommended: true,
+    },
+    schema: [],
+    messages: {
+      cannotBeUndefined:
+        'i18n "{{translationKey}}" cannot have an undefined interpolation. Either provide a fallback or do not render.' +
+        '\n {{argType}}',
+    },
+  },
+
+  create(context) {
+    const services = ESLintUtils.getParserServices(context)
+    const checker = services.program.getTypeChecker()
+
+    return {
+      CallExpression(node) {
+        if (node.callee.type === 'Identifier' && node.callee.name === 't' && node.arguments.length > 1) {
+          const firstArg = node.arguments[0]
+          const secondArg = node.arguments[1]
+          if (secondArg.type === 'ObjectExpression') {
+            const tsNode = services.esTreeNodeToTSNodeMap.get(secondArg)
+            const type = checker.getTypeAtLocation(tsNode)
+            const typeString = checker.typeToString(type)
+            if (typeString.includes('undefined')) {
+              context.report({
+                node: node.callee,
+                messageId: 'cannotBeUndefined',
+                data: { argType: typeString, translationKey: firstArg.value },
+              })
+            }
+          }
+        }
+      },
+    }
+  },
+}

package/eslint_rules/no-redux-modals.js

@@ -0,0 +1,54 @@
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Prevent adding new modal types to the deprecated modalSlice',
+      category: 'Best Practices',
+      recommended: true,
+    },
+    schema: [],
+    messages: {
+      noNewModals:
+        'Adding new modal types to modalSlice is deprecated. Please use React Navigation for new modals instead. See apps/mobile/src/app/navigation/navigation.tsx for examples.',
+    },
+  },
+
+  create(context) {
+    if (!context.getFilename().endsWith('modalSlice.ts')) {
+      return {}
+    }
+
+    const existingModalTypes = new Set([
+      'BiometricsModalParams',
+      'EditProfileSettingsModalParams',
+      'EditLabelSettingsModalParams',
+      'ExploreModalParams',
+      'FiatCurrencySelectorParams',
+      'FiatOnRampAggregatorModalParams',
+      'LanguageSelectorModalParams',
+      'SettingsAppearanceModalParams',
+      'PortfolioBalanceModalParams',
+      'ManageWalletsModalParams',
+      'WalletConnectModalParams',
+      'ConnectionsDappListModalParams',
+      'SwapModalParams',
+      'SendModalParams',
+      'PermissionsModalParams',
+      'OpenModalParams',
+      'CloseModalParams',
+    ])
+
+    return {
+      'TSTypeAliasDeclaration, TSInterfaceDeclaration'(node) {
+        const typeName = node.id.name
+
+        if (typeName.endsWith('ModalParams') && !existingModalTypes.has(typeName)) {
+          context.report({
+            node: node.id,
+            messageId: 'noNewModals',
+          })
+        }
+      },
+    }
+  },
+}

package/jest-package-mocks.js

@@ -0,0 +1,38 @@
+/**
+ * Common Jest mocks for packages that depend on lux.
+ * Note: The lux package itself has migrated to Vitest (see vitest-package-mocks.ts).
+ * This file is kept for other packages (e.g., mobile, extension, wallet) that still use Jest.
+ *
+ * Notes:
+ * * Try not to add test specific mocks here.
+ * * Be wary of the import order.
+ * * mocks can be overridden
+ */
+
+import '@shopify/react-native-skia/jestSetup'
+import mockRNLocalize from 'react-native-localize/mock'
+import { mockLocalizationContext } from 'lux/src/test/mocks/locale'
+import { mockSharedPersistQueryClientProvider } from 'lux/src/test/mocks/mockSharedPersistQueryClientProvider'
+
+jest.mock('react-native-localize', () => mockRNLocalize)
+jest.mock('lux/src/features/language/LocalizationContext', () => mockLocalizationContext({}))
+jest.mock('lux/src/data/apiClients/SharedPersistQueryClientProvider', () => mockSharedPersistQueryClientProvider)
+
+jest.mock('utilities/src/device/uniqueId', () => {
+  return jest.requireActual('lux/src/test/mocks/uniqueId')
+})
+
+jest.mock('lux/src/data/getVersionHeader', () => {
+  return jest.requireActual('lux/src/data/getVersionHeader.web')
+})
+
+jest.mock('@universe/gating', () => {
+  const actual = jest.requireActual('@universe/gating')
+  return {
+    ...actual,
+    useClientAsyncInit: jest.fn(() => ({
+      client: null,
+      isLoading: true,
+    })),
+  }
+})

package/openapitools.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "./node_modules/@openapitools/openapi-generator-cli/config.schema.json",
+  "spaces": 2,
+  "generator-cli": {
+    "version": "7.2.0"
+  }
+}

package/package.json

@@ -0,0 +1,170 @@
+{
+  "name": "@luxexchange/lx",
+  "version": "1.0.0",
+  "scripts": {
+    "prepare": "nx prepare lx",
+    "build": "nx build lux",
+    "contracts:compile:abi": "nx contracts:compile:abi lux",
+    "contracts:compile:v3": "nx contracts:compile:v3 lux",
+    "contracts": "nx contracts lux",
+    "check:deps:usage": "nx check:deps:usage lux",
+    "lint:biome": "nx lint:biome lux",
+    "lint:biome:fix": "nx lint:biome:fix lux",
+    "lint:eslint": "nx lint:eslint lux",
+    "lint:eslint:fix": "nx lint:eslint:fix lux",
+    "lint": "nx lint lux",
+    "lint:fix": "nx lint:fix lux",
+    "test": "nx test lux",
+    "test:coverage": "nx test:coverage lux",
+    "snapshots": "nx snapshots lux",
+    "typecheck": "nx typecheck lux",
+    "typecheck:tsgo": "nx typecheck:tsgo lux"
+  },
+  "nx": {
+    "includedScripts": []
+  },
+  "dependencies": {
+    "@apollo/client": "3.11.10",
+    "@bufbuild/protobuf": "1.10.0",
+    "@connectrpc/connect": "1.5.0",
+    "@connectrpc/connect-query": "1.4.2",
+    "@connectrpc/connect-web": "1.5.0",
+    "@datadog/browser-logs": "5.20.0",
+    "@datadog/browser-rum": "5.23.3",
+    "@ethersproject/abstract-provider": "5.7.0",
+    "@ethersproject/abstract-signer": "5.7.0",
+    "@ethersproject/address": "5.7.0",
+    "@ethersproject/bignumber": "5.7.0",
+    "@ethersproject/hash": "5.7.0",
+    "@ethersproject/properties": "5.7.0",
+    "@ethersproject/providers": "5.7.2",
+    "@ethersproject/units": "5.7.0",
+    "@ethersproject/web": "5.7.1",
+    "@gorhom/bottom-sheet": "4.6.4",
+    "@react-navigation/core": "7.9.2",
+    "@reduxjs/toolkit": "1.9.3",
+    "@shopify/flash-list": "1.7.6",
+    "@simplewebauthn/browser": "13.1.0",
+    "@solana/web3.js": "1.92.0",
+    "@tanstack/query-async-storage-persister": "5.90.20",
+    "@tanstack/react-query": "5.90.20",
+    "@tanstack/react-query-persist-client": "5.90.20",
+    "@typechain/ethers-v5": "7.2.0",
+    "@types/poisson-disk-sampling": "2.2.4",
+    "@uniswap/analytics-events": "2.43.0",
+    "@uniswap/client-data-api": "0.0.51",
+    "@uniswap/client-embeddedwallet": "0.0.16",
+    "@uniswap/client-explore": "0.0.17",
+    "@uniswap/client-liquidity": "0.0.23",
+    "@uniswap/client-search": "0.0.10",
+    "@uniswap/permit2-sdk": "1.3.0",
+    "@uniswap/router-sdk": "2.3.2",
+    "@uniswap/sdk-core": "7.10.1",
+    "@uniswap/uniswapx-sdk": "3.0.0-beta.7",
+    "@uniswap/universal-router-sdk": "4.29.2",
+    "@uniswap/v2-sdk": "4.17.0",
+    "@uniswap/v3-sdk": "3.27.0",
+    "@uniswap/v4-sdk": "1.25.1",
+    "@luxexchange/api": "^1.0.0",
+    "@luxexchange/config": "^1.0.0",
+    "@luxexchange/gating": "^1.0.0",
+    "@luxexchange/notifications": "^1.0.0",
+    "@luxexchange/prices": "^1.0.0",
+    "apollo-link-rest": "0.9.0",
+    "date-fns": "2.30.0",
+    "dayjs": "1.11.7",
+    "es-toolkit": "1.10.0",
+    "ethers": "5.7.2",
+    "expo-blur": "14.1.5",
+    "expo-clipboard": "7.1.5",
+    "expo-haptics": "14.0.1",
+    "expo-linear-gradient": "14.1.5",
+    "expo-web-browser": "14.2.0",
+    "fuse.js": "6.5.3",
+    "graphql": "16.6.0",
+    "i18next": "23.10.0",
+    "i18next-resources-to-backend": "1.2.1",
+    "idb-keyval": "6.2.1",
+    "jotai": "1.3.7",
+    "jsbi": "3.2.5",
+    "lodash": "4.17.21",
+    "ms": "2.1.3",
+    "poisson-disk-sampling": "2.3.1",
+    "qs": "6.11.0",
+    "react": "19.0.3",
+    "react-i18next": "14.1.0",
+    "react-infinite-scroll-component": "6.1.0",
+    "react-native": "0.79.5",
+    "react-native-appsflyer": "6.13.1",
+    "react-native-context-menu-view": "1.15.0",
+    "react-native-device-info": "10.11.0",
+    "react-native-gesture-handler": "2.24.0",
+    "react-native-localize": "2.2.6",
+    "react-native-mmkv": "2.10.1",
+    "react-native-reanimated": "3.19.3",
+    "react-native-svg": "15.13.0",
+    "react-redux": "8.0.5",
+    "react-router": "7.6.3",
+    "react-test-renderer": "19.0.3",
+    "react-virtualized-auto-sizer": "1.0.20",
+    "react-window": "1.8.9",
+    "redux": "4.2.1",
+    "redux-persist": "6.0.0",
+    "redux-saga": "1.2.2",
+    "@hanzo/gui": "2.0.1",
+    "tiny-invariant": "1.3.1",
+    "typed-redux-saga": "1.5.0",
+    "@luxfi/ui": "^1.0.0",
+    "@luxfi/utilities": "^1.0.0",
+    "uuid": "9.0.0",
+    "viem": "2.30.5",
+    "wagmi": "2.15.5",
+    "zod": "4.3.6",
+    "zustand": "5.0.6"
+  },
+  "devDependencies": {
+    "@faker-js/faker": "7.6.0",
+    "@graphql-tools/graphql-file-loader": "8.0.0",
+    "@graphql-tools/load": "8.0.1",
+    "@graphql-tools/merge": "9.0.1",
+    "@graphql-tools/mock": "9.0.0",
+    "@react-native-community/netinfo": "11.4.1",
+    "@redux-devtools/extension": "3.3.0",
+    "@shopify/react-native-skia": "2.2.20",
+    "@storybook/react": "8.5.2",
+    "@testing-library/jest-native": "5.4.3",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/react-native": "13.3.3",
+    "@types/chrome": "0.0.304",
+    "@types/react-test-renderer": "19.0.0",
+    "@types/react-window": "1.8.2",
+    "@typescript-eslint/utils": "6.20.0",
+    "@typescript/native-preview": "7.0.0-dev.20260108.1",
+    "@uniswap/client-notification-service": "0.0.11",
+    "@luxfi/eslint-config": "^1.0.0",
+    "@vitejs/plugin-react": "4.7.0",
+    "@walletconnect/types": "2.23.0",
+    "depcheck": "1.4.7",
+    "eslint": "8.57.1",
+    "eslint-plugin-rulesdir": "0.2.2",
+    "graphql-scalars": "1.22.4",
+    "i18next-resources-for-ts": "1.5.0",
+    "jest-extended": "4.0.2",
+    "jsdom": "20.0.3",
+    "react-dom": "19.0.3",
+    "react-native-passkey": "3.1.0",
+    "tsafe": "1.6.4",
+    "typechain": "5.2.0",
+    "typescript": "5.8.3",
+    "vitest": "3.2.1",
+    "vitest-presets": "*"
+  },
+  "optionalDependencies": {
+    "@uniswap/client-privy-embedded-wallet": "0.0.2"
+  },
+  "main": "src/index.ts",
+  "private": false,
+  "sideEffects": [
+    "*.css"
+  ]
+}