@l.x/config 1.0.3 → 1.0.4

package/.depcheckrc

@@ -0,0 +1,9 @@
+ignores: [
+    # Standard ignores
+    "typescript",
+    "@typescript/native-preview",
+    "depcheck",
+
+    # Internal packages / workspaces
+    "@universe/config",
+  ]

package/.eslintrc.js

@@ -0,0 +1,20 @@
+module.exports = {
+  extends: ['@luxamm/eslint-config/lib'],
+  parserOptions: {
+    tsconfigRootDir: __dirname,
+  },
+  overrides: [
+    {
+      files: ['*.ts', '*.tsx'],
+      rules: {
+        'no-relative-import-paths/no-relative-import-paths': [
+          'error',
+          {
+            allowSameFolder: false,
+            prefix: '@luxexchange/config',
+          },
+        ],
+      },
+    },
+  ],
+}

package/README.md

@@ -0,0 +1,31 @@
+# @universe/config
+
+Configuration management package for the Uniswap Universe monorepo.
+
+## Overview
+
+This package provides centralized configuration management for all Uniswap applications (web, mobile, and extension). It handles environment variables and provides a platform-specific implementation for accessing configuration values.
+
+## Usage
+
+```typescript
+import { getConfig } from '@universe/config'
+
+const config = getConfig()
+console.log(config.infuraKey)
+```
+
+## Platform Support
+
+- **Web/Extension**: Uses `process.env` directly
+- **Mobile**: Uses `react-native-dotenv` for environment variable management
+
+## Configuration Values
+
+See `src/config-types.ts` for the complete list of configuration options.
+
+## Environment Variable Naming
+
+- **Web**: Variables must be prefixed with `REACT_APP_`
+- **Extension**: Variables use standard naming without prefix
+- **Mobile**: Variables use standard naming without prefix, but also require `react-native-dotenv` setup

package/__tests__/brand-and-legal.test.ts

@@ -0,0 +1,321 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { brand, loadBrandConfig } from '../src/brand'
+import type { BrandConfig } from '../src/brand'
+import {
+  LEGAL_UPDATED,
+  LEGAL_URLS,
+  FOOTER_DISCLAIMER,
+  REGULATORY_NOTICE,
+  COOKIE_NOTICE,
+  NON_CUSTODIAL_NOTICE,
+  getLegalUrls,
+} from '../src/legal'
+
+// ---------------------------------------------------------------------------
+// 1. BrandConfig interface completeness
+// ---------------------------------------------------------------------------
+describe('BrandConfig interface completeness', () => {
+  const requiredFields: (keyof BrandConfig)[] = [
+    'name',
+    'title',
+    'description',
+    'legalEntity',
+    'appDomain',
+    'docsDomain',
+    'infoDomain',
+    'gatewayDomain',
+    'wsDomain',
+    'helpUrl',
+    'termsUrl',
+    'privacyUrl',
+    'downloadUrl',
+    'complianceEmail',
+    'supportEmail',
+    'twitter',
+    'github',
+    'discord',
+    'logoUrl',
+    'faviconUrl',
+    'primaryColor',
+    'defaultChainId',
+    'supportedChainIds',
+    'walletConnectProjectId',
+    'insightsHost',
+    'insightsApiKey',
+  ]
+
+  it.each(requiredFields)('brand object has field "%s"', (field) => {
+    expect(brand).toHaveProperty(field)
+  })
+
+  it('has exactly the expected number of fields', () => {
+    expect(Object.keys(brand).length).toBe(requiredFields.length)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 2. Default brand values are defined (not undefined)
+// ---------------------------------------------------------------------------
+describe('default brand values are defined', () => {
+  it('faviconUrl defaults to /favicon.ico', () => {
+    expect(brand.faviconUrl).toBe('/favicon.ico')
+  })
+
+  it('primaryColor defaults to #FC72FF', () => {
+    expect(brand.primaryColor).toBe('#FC72FF')
+  })
+
+  it('defaultChainId defaults to 1', () => {
+    expect(brand.defaultChainId).toBe(1)
+  })
+
+  it('supportedChainIds is an array', () => {
+    expect(Array.isArray(brand.supportedChainIds)).toBe(true)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 3. legalEntity field exists
+// ---------------------------------------------------------------------------
+describe('legalEntity field', () => {
+  it('exists on the brand object', () => {
+    expect(brand).toHaveProperty('legalEntity')
+  })
+
+  it('is a string', () => {
+    expect(typeof brand.legalEntity).toBe('string')
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 4. LEGAL_UPDATED is valid ISO date (YYYY-MM-DD)
+// ---------------------------------------------------------------------------
+describe('LEGAL_UPDATED', () => {
+  it('matches YYYY-MM-DD format', () => {
+    expect(LEGAL_UPDATED).toMatch(/^\d{4}-\d{2}-\d{2}$/)
+  })
+
+  it('parses to a valid date', () => {
+    const date = new Date(LEGAL_UPDATED)
+    expect(date.toString()).not.toBe('Invalid Date')
+  })
+
+  it('is not in the future beyond a reasonable window', () => {
+    const date = new Date(LEGAL_UPDATED)
+    const oneYearFromNow = new Date()
+    oneYearFromNow.setFullYear(oneYearFromNow.getFullYear() + 1)
+    expect(date.getTime()).toBeLessThanOrEqual(oneYearFromNow.getTime())
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 5. LEGAL_URLS paths are relative or absolute
+// ---------------------------------------------------------------------------
+describe('LEGAL_URLS', () => {
+  it('terms path starts with /', () => {
+    expect(LEGAL_URLS.terms).toMatch(/^\//)
+  })
+
+  it('privacy path starts with /', () => {
+    expect(LEGAL_URLS.privacy).toMatch(/^\//)
+  })
+
+  it('regulatory is a full URL', () => {
+    expect(LEGAL_URLS.regulatory).toMatch(/^https?:\/\//)
+  })
+
+  it('email links use mailto:', () => {
+    expect(LEGAL_URLS.compliance).toMatch(/^mailto:/)
+    expect(LEGAL_URLS.legal).toMatch(/^mailto:/)
+    expect(LEGAL_URLS.privacyEmail).toMatch(/^mailto:/)
+    expect(LEGAL_URLS.security).toMatch(/^mailto:/)
+  })
+
+  it('LP document links are full URLs', () => {
+    expect(LEGAL_URLS.lp3103).toMatch(/^https?:\/\//)
+    expect(LEGAL_URLS.lp3104).toMatch(/^https?:\/\//)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 6. FOOTER_DISCLAIMER contains key phrases
+// ---------------------------------------------------------------------------
+describe('FOOTER_DISCLAIMER', () => {
+  it('mentions "experimental"', () => {
+    expect(FOOTER_DISCLAIMER.toLowerCase()).toContain('experimental')
+  })
+
+  it('mentions "not legal"', () => {
+    expect(FOOTER_DISCLAIMER.toLowerCase()).toContain('not legal')
+  })
+
+  it('mentions "non-custodial"', () => {
+    expect(FOOTER_DISCLAIMER.toLowerCase()).toContain('non-custodial')
+  })
+
+  it('mentions "at your own risk"', () => {
+    expect(FOOTER_DISCLAIMER.toLowerCase()).toContain('at your own risk')
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 7. NON_CUSTODIAL_NOTICE contains key phrases
+// ---------------------------------------------------------------------------
+describe('NON_CUSTODIAL_NOTICE', () => {
+  it('mentions "never have access"', () => {
+    expect(NON_CUSTODIAL_NOTICE.toLowerCase()).toContain('never have access')
+  })
+
+  it('mentions "private keys"', () => {
+    expect(NON_CUSTODIAL_NOTICE.toLowerCase()).toContain('private keys')
+  })
+
+  it('mentions "irreversible"', () => {
+    expect(NON_CUSTODIAL_NOTICE.toLowerCase()).toContain('irreversible')
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 8. REGULATORY_NOTICE does NOT contain hardcoded brand name "Lux"
+// ---------------------------------------------------------------------------
+describe('REGULATORY_NOTICE', () => {
+  it('does not contain the hardcoded brand name "Lux"', () => {
+    expect(REGULATORY_NOTICE).not.toMatch(/\bLux\b/)
+  })
+
+  it('is brand-agnostic (no proper brand nouns)', () => {
+    expect(REGULATORY_NOTICE).not.toMatch(/\bZoo\b/)
+    expect(REGULATORY_NOTICE).not.toMatch(/\bPars\b/)
+    expect(REGULATORY_NOTICE).not.toMatch(/\bHanzo\b/)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 9. COOKIE_NOTICE mentions no tracking
+// ---------------------------------------------------------------------------
+describe('COOKIE_NOTICE', () => {
+  it('mentions "no tracking cookies"', () => {
+    expect(COOKIE_NOTICE.toLowerCase()).toContain('no tracking cookies')
+  })
+
+  it('mentions "no behavioral profiling"', () => {
+    expect(COOKIE_NOTICE.toLowerCase()).toContain('no behavioral profiling')
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 10. getLegalUrls() generates correct URLs
+// ---------------------------------------------------------------------------
+describe('getLegalUrls()', () => {
+  it('returns terms URL with the given domain', () => {
+    const urls = getLegalUrls('lux.exchange')
+    expect(urls.terms).toBe('https://lux.exchange/terms')
+  })
+
+  it('returns privacy URL with the given domain', () => {
+    const urls = getLegalUrls('lux.exchange')
+    expect(urls.privacy).toBe('https://lux.exchange/privacy')
+  })
+
+  it('returns regulatory URL from LEGAL_URLS constant', () => {
+    const urls = getLegalUrls('lux.exchange')
+    expect(urls.regulatory).toBe(LEGAL_URLS.regulatory)
+  })
+
+  it('works with arbitrary domains', () => {
+    const urls = getLegalUrls('zoo.exchange')
+    expect(urls.terms).toBe('https://zoo.exchange/terms')
+    expect(urls.privacy).toBe('https://zoo.exchange/privacy')
+  })
+
+  it('handles subdomain domains', () => {
+    const urls = getLegalUrls('app.pars.market')
+    expect(urls.terms).toBe('https://app.pars.market/terms')
+    expect(urls.privacy).toBe('https://app.pars.market/privacy')
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 11. loadBrandConfig() handles missing config gracefully
+// ---------------------------------------------------------------------------
+describe('loadBrandConfig()', () => {
+  beforeEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  it('returns fallback config when fetch fails (network error)', async () => {
+    vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('Network error')))
+
+    const config = await loadBrandConfig()
+
+    expect(config).toBeDefined()
+    expect(config.brand).toEqual({})
+    expect(config.chains).toBeDefined()
+    expect(config.rpc).toEqual({})
+    expect(config.api).toBeDefined()
+    expect(config.walletConnect).toBeDefined()
+  })
+
+  it('returns fallback config when fetch returns non-ok status', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn().mockResolvedValue({
+        ok: false,
+        status: 404,
+      }),
+    )
+
+    const config = await loadBrandConfig()
+
+    expect(config).toBeDefined()
+    expect(config.brand).toEqual({})
+    expect(config.rpc).toEqual({})
+  })
+
+  it('applies brand overrides from config.json', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn().mockResolvedValue({
+        ok: true,
+        json: async () => ({
+          brand: { name: 'Zoo Exchange', legalEntity: 'Zoo Labs Foundation' },
+          chains: { defaultChainId: 200200, supported: [200200] },
+          rpc: { '200200': 'https://api.zoo.network/rpc' },
+          api: { graphql: '', gateway: '', insights: '' },
+          walletConnect: { projectId: 'test-id' },
+        }),
+      }),
+    )
+
+    const config = await loadBrandConfig()
+
+    expect(config.brand?.name).toBe('Zoo Exchange')
+    expect(config.brand?.legalEntity).toBe('Zoo Labs Foundation')
+    expect(brand.name).toBe('Zoo Exchange')
+    expect(brand.legalEntity).toBe('Zoo Labs Foundation')
+    expect(brand.defaultChainId).toBe(200200)
+    expect(brand.walletConnectProjectId).toBe('test-id')
+  })
+
+  it('preserves default values for fields not in config.json', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn().mockResolvedValue({
+        ok: true,
+        json: async () => ({
+          brand: { name: 'Partial Brand' },
+          chains: { defaultChainId: 1, supported: [] },
+          rpc: {},
+          api: { graphql: '', gateway: '', insights: '' },
+          walletConnect: { projectId: '' },
+        }),
+      }),
+    )
+
+    await loadBrandConfig()
+
+    expect(brand.name).toBe('Partial Brand')
+    expect(brand.faviconUrl).toBe('/favicon.ico')
+    expect(brand.primaryColor).toBe('#FC72FF')
+  })
+})

package/env.d.ts

@@ -0,0 +1,64 @@
+/** 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'
+      ALCHEMY_API_KEY?: string
+      AMPLITUDE_PROXY_URL_OVERRIDE?: string
+      API_BASE_URL_OVERRIDE?: string
+      API_BASE_URL_V2_OVERRIDE?: string
+      APPSFLYER_API_KEY?: string
+      APPSFLYER_APP_ID?: string
+      BLOCKAID_PROXY_URL?: string
+      CI?: string
+      DATADOG_CLIENT_TOKEN?: string
+      DATADOG_PROJECT_ID?: string
+      ENABLE_ENTRY_GATEWAY_PROXY?: string
+      ENABLE_SESSION_SERVICE?: string
+      ENABLE_SESSION_UPGRADE_AUTO?: string
+      ENTRY_GATEWAY_API_URL_OVERRIDE?: string
+      FOR_API_URL_OVERRIDE?: string
+      GRAPHQL_URL_OVERRIDE?: string
+      INCLUDE_PROTOTYPE_FEATURES?: string
+      IS_E2E_TEST?: string
+      JUPITER_PROXY_URL?: string
+      LIQUIDITY_SERVICE_URL_OVERRIDE?: string
+      ONESIGNAL_APP_ID?: string
+      QUICKNODE_ENDPOINT_NAME?: string
+      QUICKNODE_ENDPOINT_TOKEN?: string
+      REACT_APP_ALCHEMY_API_KEY?: string
+      REACT_APP_BLOCKAID_PROXY_URL?: string
+      REACT_APP_DATADOG_CLIENT_TOKEN?: string
+      REACT_APP_DATADOG_PROJECT_ID?: string
+      REACT_APP_ENABLE_SESSION_UPGRADE_AUTO?: string
+      REACT_APP_INFURA_KEY?: string
+      REACT_APP_JUPITER_PROXY_URL?: string
+      REACT_APP_LIQUIDITY_SERVICE_URL_OVERRIDE?: string
+      REACT_APP_QUICKNODE_ENDPOINT_NAME?: string
+      REACT_APP_QUICKNODE_ENDPOINT_TOKEN?: string
+      REACT_APP_STATSIG_API_KEY?: string
+      REACT_APP_TRADING_API_KEY?: string
+      REACT_APP_TRADING_API_TEST_ENV?: string
+      REACT_APP_TRADING_API_URL_OVERRIDE?: string
+      REACT_APP_WALLET_CONNECT_PROJECT_ID?: string
+      SCANTASTIC_API_URL_OVERRIDE?: string
+      STATSIG_API_KEY?: string
+      STATSIG_PROXY_URL_OVERRIDE?: string
+      TRADING_API_KEY?: string
+      TRADING_API_URL_OVERRIDE?: string
+      LX_API_KEY?: string
+      LX_NOTIF_API_BASE_URL_OVERRIDE?: string
+      UNITAGS_API_URL_OVERRIDE?: string
+      VERSION?: string
+      VERCEL?: string
+      VITE_ENABLE_ENTRY_GATEWAY_PROXY?: string
+      WALLETCONNECT_PROJECT_ID?: string
+      WALLETCONNECT_PROJECT_ID_BETA?: string
+      WALLETCONNECT_PROJECT_ID_DEV?: string
+    }
+  }
+}
+
+export {}

package/env.native.d.ts

@@ -0,0 +1,39 @@
+// Adds typing for react-native-dotenv
+// Must be kept separately from env.d.ts as due to issue with global
+// namespace vs module declarations
+declare module 'react-native-dotenv' {
+  export const ALCHEMY_API_KEY: string
+  export const AMPLITUDE_PROXY_URL_OVERRIDE: string
+  export const API_BASE_URL_OVERRIDE: string
+  export const API_BASE_URL_V2_OVERRIDE: string
+  export const APPSFLYER_API_KEY: string
+  export const APPSFLYER_APP_ID: string
+  export const BLOCKAID_PROXY_URL: string
+  export const DATADOG_CLIENT_TOKEN: string
+  export const DATADOG_PROJECT_ID: string
+  export const ENABLE_ENTRY_GATEWAY_PROXY: string
+  export const ENABLE_SESSION_SERVICE: string
+  export const ENABLE_SESSION_UPGRADE_AUTO: string
+  export const ENTRY_GATEWAY_API_URL_OVERRIDE: string
+  export const FOR_API_URL_OVERRIDE: string
+  export const GRAPHQL_URL_OVERRIDE: string
+  export const INCLUDE_PROTOTYPE_FEATURES: string
+  export const INFURA_KEY: string
+  export const IS_E2E_TEST: string
+  export const JUPITER_PROXY_URL: string
+  export const LIQUIDITY_SERVICE_URL_OVERRIDE: string
+  export const ONESIGNAL_APP_ID: string
+  export const QUICKNODE_ENDPOINT_NAME: string
+  export const QUICKNODE_ENDPOINT_TOKEN: string
+  export const SCANTASTIC_API_URL_OVERRIDE: string
+  export const STATSIG_API_KEY: string
+  export const STATSIG_PROXY_URL_OVERRIDE: string
+  export const TRADING_API_KEY: string
+  export const TRADING_API_URL_OVERRIDE: string
+  export const LX_API_KEY: string
+  export const LX_NOTIF_API_BASE_URL_OVERRIDE: string
+  export const UNITAGS_API_URL_OVERRIDE: string
+  export const WALLETCONNECT_PROJECT_ID: string
+  export const WALLETCONNECT_PROJECT_ID_BETA: string
+  export const WALLETCONNECT_PROJECT_ID_DEV: string
+}

package/package.json

@@ -1 +1,36 @@
-{"name":"@l.x/config","version":"1.0.3","description":"LX Exchange - config","main":"index.js","dependencies":{"@luxexchange/config":"1.0.3"}}
+{
+  "name": "@l.x/config",
+  "version": "1.0.4",
+  "dependencies": {
+    "react-native-dotenv": "3.2.0",
+    "@luxfi/utilities": "workspace:^"
+  },
+  "devDependencies": {
+    "@types/node": "22.13.1",
+    "@typescript/native-preview": "7.0.0-dev.20260311.1",
+    "@luxfi/eslint-config": "workspace:^",
+    "depcheck": "1.4.7",
+    "eslint": "8.57.1",
+    "jsdom": "^26.1.0",
+    "typescript": "5.8.3",
+    "vitest": "^4.0.16"
+  },
+  "scripts": {
+    "typecheck": "nx typecheck config",
+    "typecheck:tsgo": "nx typecheck:tsgo config",
+    "lint": "nx lint config",
+    "lint:fix": "nx lint:fix config",
+    "lint:biome": "nx lint:biome config",
+    "lint:biome:fix": "nx lint:biome:fix config",
+    "lint:eslint": "nx lint:eslint config",
+    "lint:eslint:fix": "nx lint:eslint:fix config",
+    "test": "vitest run",
+    "check:deps:usage": "nx check:deps:usage config"
+  },
+  "nx": {
+    "includedScripts": []
+  },
+  "main": "src/index.ts",
+  "private": false,
+  "sideEffects": false
+}

package/project.json

@@ -0,0 +1,18 @@
+{
+  "name": "@l.x/config",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "pkgs/config/src",
+  "projectType": "library",
+  "tags": ["scope:config", "type:lib"],
+  "targets": {
+    "typecheck": {},
+    "typecheck:tsgo": {},
+    "lint:biome": {},
+    "lint:biome:fix": {},
+    "lint:eslint": {},
+    "lint:eslint:fix": {},
+    "lint": {},
+    "lint:fix": {},
+    "check:deps:usage": {}
+  }
+}

package/src/brand.ts

@@ -0,0 +1,169 @@
+/**
+ * Runtime brand configuration for white-label exchange deployments.
+ * Zero baked-in brands — everything loaded from /config.json at runtime.
+ *
+ * How it works:
+ * 1. Default config.json ships in the Docker image (Lux defaults)
+ * 2. K8s mounts a ConfigMap over /config.json per deployment
+ * 3. SPA calls loadBrandConfig() before first render
+ * 4. All brand references use the `brand` export which updates in place
+ *
+ * For zoo.exchange: mount a ConfigMap with Zoo branding over /config.json
+ * For any L2: same image, different ConfigMap
+ */
+
+export interface BrandConfig {
+  name: string
+  title: string
+  description: string
+  /** Legal entity name for Terms/Privacy, e.g. "Lux Industries Inc." */
+  legalEntity: string
+  appDomain: string
+  docsDomain: string
+  infoDomain: string
+  gatewayDomain: string
+  wsDomain: string
+  helpUrl: string
+  termsUrl: string
+  privacyUrl: string
+  downloadUrl: string
+  complianceEmail: string
+  supportEmail: string
+  twitter: string
+  github: string
+  discord: string
+  logoUrl: string
+  faviconUrl: string
+  primaryColor: string
+  defaultChainId: number
+  supportedChainIds: number[]
+  walletConnectProjectId: string
+  insightsHost: string
+  insightsApiKey: string
+}
+
+export interface RuntimeConfig {
+  brand: Partial<BrandConfig>
+  chains: {
+    defaultChainId: number
+    supported: number[]
+  }
+  rpc: Record<string, string>
+  api: {
+    graphql: string
+    gateway: string
+    insights: string
+  }
+  walletConnect: {
+    projectId: string
+  }
+}
+
+// Mutable brand — updated by loadBrandConfig() from /config.json
+// Defaults are deliberately generic — override via config.json per deployment
+export const brand: BrandConfig = {
+  name: '',
+  title: '',
+  description: '',
+  legalEntity: '',
+  appDomain: '',
+  docsDomain: '',
+  infoDomain: '',
+  gatewayDomain: '',
+  wsDomain: '',
+  helpUrl: '',
+  termsUrl: '',
+  privacyUrl: '',
+  downloadUrl: '',
+  complianceEmail: '',
+  supportEmail: '',
+  twitter: '',
+  github: '',
+  discord: '',
+  logoUrl: '',
+  faviconUrl: '/favicon.ico',
+  primaryColor: '#FC72FF',
+  defaultChainId: 1,
+  supportedChainIds: [],
+  walletConnectProjectId: '',
+  insightsHost: '',
+  insightsApiKey: '',
+}
+
+// Full runtime config (includes RPC, API endpoints, etc.)
+export let runtimeConfig: RuntimeConfig | null = null
+
+/**
+ * Load brand config from /config.json. Call once before React renders.
+ * The config.json is either the default shipped in the image, or a
+ * ConfigMap mounted by K8s for white-label deployments.
+ */
+export async function loadBrandConfig(): Promise<RuntimeConfig> {
+  try {
+    const res = await fetch('/config.json')
+    if (!res.ok) throw new Error(`${res.status}`)
+    const config: RuntimeConfig = await res.json()
+
+    // Apply brand overrides
+    if (config.brand) {
+      Object.assign(brand, config.brand)
+    }
+
+    // Apply chain config
+    if (config.chains) {
+      brand.defaultChainId = config.chains.defaultChainId ?? brand.defaultChainId
+      brand.supportedChainIds = config.chains.supported ?? brand.supportedChainIds
+    }
+
+    // Apply walletconnect
+    if (config.walletConnect?.projectId) {
+      brand.walletConnectProjectId = config.walletConnect.projectId
+    }
+
+    // Apply analytics
+    if (config.api?.insights) {
+      brand.insightsHost = config.api.insights
+    }
+
+    // Update document title
+    if (typeof document !== 'undefined' && config.brand?.title) {
+      document.title = config.brand.title
+    }
+
+    runtimeConfig = config
+    return config
+  } catch {
+    // Config fetch failed — use defaults (works for local dev)
+    return {
+      brand: {},
+      chains: { defaultChainId: brand.defaultChainId, supported: brand.supportedChainIds },
+      rpc: {},
+      api: { graphql: '', gateway: '', insights: brand.insightsHost },
+      walletConnect: { projectId: '' },
+    }
+  }
+}
+
+export function getBrandUrl(path: string): string {
+  return `https://${brand.appDomain}${path}`
+}
+
+export function getDocsUrl(path: string): string {
+  return `https://${brand.docsDomain}${path}`
+}
+
+export function getGatewayUrl(path: string): string {
+  return `https://${brand.gatewayDomain}${path}`
+}
+
+export function getWsUrl(path: string): string {
+  return `wss://${brand.wsDomain}${path}`
+}
+
+export function getRpcUrl(chainId: number): string | undefined {
+  return runtimeConfig?.rpc?.[String(chainId)]
+}
+
+export function getApiUrl(key: keyof RuntimeConfig['api']): string {
+  return runtimeConfig?.api?.[key] ?? ''
+}

package/src/config-types.ts

@@ -0,0 +1,48 @@
+/**
+ * Naming requirements for different environments:
+ * - Web ENV vars: must have process.env.REACT_APP_<var_name>
+ * - Extension ENV vars: must have process.env.<var_name>
+ * - Mobile ENV vars: must have BOTH process.env.<var_name> and <var_name>
+ *
+ *  The CI requires web vars to have the required 'REACT_APP_' prefix. The react-dot-env library doesnt integrate with CI correctly,
+ *  so we pull from github secrets directly with process.env.<var_name> for both extension and mobile. <var_name> is used for local mobile builds.
+ */
+
+export interface Config {
+  alchemyApiKey: string
+  amplitudeProxyUrlOverride: string
+  apiBaseUrlOverride: string
+  apiBaseUrlV2Override: string
+  appsflyerApiKey: string
+  appsflyerAppId: string
+  blockaidProxyUrl: string
+  datadogClientToken: string
+  datadogProjectId: string
+  isE2ETest: boolean
+  forApiUrlOverride: string
+  graphqlUrlOverride: string
+  includePrototypeFeatures: string
+  infuraKey: string
+  isVercelEnvironment: boolean
+  jupiterProxyUrl: string
+  onesignalAppId: string
+  quicknodeEndpointName: string
+  quicknodeEndpointToken: string
+  scantasticApiUrlOverride: string
+  statsigProxyUrlOverride: string
+  statsigApiKey: string
+  tradingApiKey: string
+  tradingApiUrlOverride: string
+  tradingApiWebTestEnv: string
+  liquidityServiceUrlOverride: string
+  lxApiKey: string
+  unitagsApiUrlOverride: string
+  lxNotifApiBaseUrlOverride: string
+  entryGatewayApiUrlOverride: string
+  walletConnectProjectId: string
+  walletConnectProjectIdBeta: string
+  walletConnectProjectIdDev: string
+  enableSessionService: boolean
+  enableSessionUpgradeAuto: boolean
+  enableEntryGatewayProxy: boolean
+}

package/src/getConfig.native.ts

@@ -0,0 +1,124 @@
+import type { Config } from '@l.x/config/src/config-types'
+import {
+  ALCHEMY_API_KEY,
+  AMPLITUDE_PROXY_URL_OVERRIDE,
+  API_BASE_URL_OVERRIDE,
+  API_BASE_URL_V2_OVERRIDE,
+  APPSFLYER_API_KEY,
+  APPSFLYER_APP_ID,
+  BLOCKAID_PROXY_URL,
+  DATADOG_CLIENT_TOKEN,
+  DATADOG_PROJECT_ID,
+  ENABLE_ENTRY_GATEWAY_PROXY,
+  ENABLE_SESSION_SERVICE,
+  ENABLE_SESSION_UPGRADE_AUTO,
+  ENTRY_GATEWAY_API_URL_OVERRIDE,
+  FOR_API_URL_OVERRIDE,
+  GRAPHQL_URL_OVERRIDE,
+  INCLUDE_PROTOTYPE_FEATURES,
+  INFURA_KEY,
+  IS_E2E_TEST,
+  JUPITER_PROXY_URL,
+  LIQUIDITY_SERVICE_URL_OVERRIDE,
+  ONESIGNAL_APP_ID,
+  QUICKNODE_ENDPOINT_NAME,
+  QUICKNODE_ENDPOINT_TOKEN,
+  SCANTASTIC_API_URL_OVERRIDE,
+  STATSIG_API_KEY,
+  STATSIG_PROXY_URL_OVERRIDE,
+  TRADING_API_KEY,
+  TRADING_API_URL_OVERRIDE,
+  LX_API_KEY,
+  LX_NOTIF_API_BASE_URL_OVERRIDE,
+  UNITAGS_API_URL_OVERRIDE,
+  WALLETCONNECT_PROJECT_ID,
+  WALLETCONNECT_PROJECT_ID_BETA,
+  WALLETCONNECT_PROJECT_ID_DEV,
+} from 'react-native-dotenv'
+import { isNonTestDev } from 'utilities/src/environment/constants'
+
+// Module-level cache for config to avoid recomputing on every call
+let cachedConfig: Config | undefined
+
+// eslint-disable-next-line complexity
+export const getConfig = (): Config => {
+  // Return cached config if already computed
+  if (cachedConfig !== undefined) {
+    return cachedConfig
+  }
+
+  /**
+   * Naming requirements for different environments:
+   * - Web ENV vars: must have process.env.REACT_APP_<var_name>
+   * - Extension ENV vars: must have process.env.<var_name>
+   * - Mobile ENV vars: must have BOTH process.env.<var_name> and <var_name>
+   *
+   *  The CI requires web vars to have the required 'REACT_APP_' prefix. The react-dot-env library doesnt integrate with CI correctly,
+   *  so we pull from github secrets directly with process.env.<var_name> for both extension and mobile. <var_name> is used for local mobile builds.
+   */
+
+  const config: Config = {
+    alchemyApiKey: process.env.REACT_APP_ALCHEMY_API_KEY || process.env.ALCHEMY_API_KEY || ALCHEMY_API_KEY,
+    amplitudeProxyUrlOverride: process.env.AMPLITUDE_PROXY_URL_OVERRIDE || AMPLITUDE_PROXY_URL_OVERRIDE,
+    apiBaseUrlOverride: process.env.API_BASE_URL_OVERRIDE || API_BASE_URL_OVERRIDE,
+    apiBaseUrlV2Override: process.env.API_BASE_URL_V2_OVERRIDE || API_BASE_URL_V2_OVERRIDE,
+    appsflyerApiKey: process.env.APPSFLYER_API_KEY || APPSFLYER_API_KEY,
+    appsflyerAppId: process.env.APPSFLYER_APP_ID || APPSFLYER_APP_ID,
+    blockaidProxyUrl: process.env.BLOCKAID_PROXY_URL || BLOCKAID_PROXY_URL,
+    datadogClientToken:
+      process.env.REACT_APP_DATADOG_CLIENT_TOKEN || process.env.DATADOG_CLIENT_TOKEN || DATADOG_CLIENT_TOKEN,
+    datadogProjectId: process.env.REACT_APP_DATADOG_PROJECT_ID || process.env.DATADOG_PROJECT_ID || DATADOG_PROJECT_ID,
+    enableEntryGatewayProxy: process.env.ENABLE_ENTRY_GATEWAY_PROXY === 'true' || ENABLE_ENTRY_GATEWAY_PROXY === 'true',
+    enableSessionService: process.env.ENABLE_SESSION_SERVICE === 'true' || ENABLE_SESSION_SERVICE === 'true',
+    enableSessionUpgradeAuto:
+      process.env.ENABLE_SESSION_UPGRADE_AUTO === 'true' || ENABLE_SESSION_UPGRADE_AUTO === 'true',
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    isE2ETest: process.env.IS_E2E_TEST?.toLowerCase() === 'true' || IS_E2E_TEST?.toLowerCase() === 'true',
+    forApiUrlOverride: process.env.FOR_API_URL_OVERRIDE || FOR_API_URL_OVERRIDE,
+    graphqlUrlOverride: process.env.GRAPHQL_URL_OVERRIDE || GRAPHQL_URL_OVERRIDE,
+    infuraKey: process.env.REACT_APP_INFURA_KEY || INFURA_KEY,
+    includePrototypeFeatures: process.env.INCLUDE_PROTOTYPE_FEATURES || INCLUDE_PROTOTYPE_FEATURES,
+    isVercelEnvironment: false, // never set to true for native
+    jupiterProxyUrl: process.env.JUPITER_PROXY_URL || JUPITER_PROXY_URL,
+    onesignalAppId: process.env.ONESIGNAL_APP_ID || ONESIGNAL_APP_ID,
+    quicknodeEndpointName:
+      process.env.REACT_APP_QUICKNODE_ENDPOINT_NAME || process.env.QUICKNODE_ENDPOINT_NAME || QUICKNODE_ENDPOINT_NAME,
+    quicknodeEndpointToken:
+      process.env.REACT_APP_QUICKNODE_ENDPOINT_TOKEN ||
+      process.env.QUICKNODE_ENDPOINT_TOKEN ||
+      QUICKNODE_ENDPOINT_TOKEN,
+    scantasticApiUrlOverride: process.env.SCANTASTIC_API_URL_OVERRIDE || SCANTASTIC_API_URL_OVERRIDE,
+    statsigApiKey: process.env.REACT_APP_STATSIG_API_KEY || process.env.STATSIG_API_KEY || STATSIG_API_KEY,
+    statsigProxyUrlOverride: process.env.STATSIG_PROXY_URL_OVERRIDE || STATSIG_PROXY_URL_OVERRIDE,
+    tradingApiKey: process.env.REACT_APP_TRADING_API_KEY || process.env.TRADING_API_KEY || TRADING_API_KEY,
+    tradingApiUrlOverride:
+      process.env.REACT_APP_TRADING_API_URL_OVERRIDE ||
+      process.env.TRADING_API_URL_OVERRIDE ||
+      TRADING_API_URL_OVERRIDE,
+    tradingApiWebTestEnv: process.env.REACT_APP_TRADING_API_TEST_ENV || '',
+    liquidityServiceUrlOverride:
+      process.env.REACT_APP_LIQUIDITY_SERVICE_URL_OVERRIDE ||
+      process.env.LIQUIDITY_SERVICE_URL_OVERRIDE ||
+      LIQUIDITY_SERVICE_URL_OVERRIDE,
+    lxApiKey: process.env.LX_API_KEY || LX_API_KEY,
+    unitagsApiUrlOverride: process.env.UNITAGS_API_URL_OVERRIDE || UNITAGS_API_URL_OVERRIDE,
+    lxNotifApiBaseUrlOverride:
+      process.env.LX_NOTIF_API_BASE_URL_OVERRIDE || LX_NOTIF_API_BASE_URL_OVERRIDE,
+    entryGatewayApiUrlOverride: process.env.ENTRY_GATEWAY_API_URL_OVERRIDE || ENTRY_GATEWAY_API_URL_OVERRIDE,
+    walletConnectProjectId:
+      process.env.REACT_APP_WALLET_CONNECT_PROJECT_ID ||
+      process.env.WALLETCONNECT_PROJECT_ID ||
+      WALLETCONNECT_PROJECT_ID,
+    walletConnectProjectIdBeta: process.env.WALLETCONNECT_PROJECT_ID_BETA || WALLETCONNECT_PROJECT_ID_BETA,
+    walletConnectProjectIdDev: process.env.WALLETCONNECT_PROJECT_ID_DEV || WALLETCONNECT_PROJECT_ID_DEV,
+  }
+
+  if (isNonTestDev) {
+    // biome-ignore lint/suspicious/noConsole: Cannot use logger here, causes error from circular dep
+    console.debug('Using app config:', config)
+  }
+
+  // Cache and return frozen config
+  cachedConfig = Object.freeze(config)
+  return cachedConfig
+}

package/src/getConfig.ts

@@ -0,0 +1,6 @@
+import { Config } from '@l.x/config/src/config-types'
+import { PlatformSplitStubError } from 'utilities/src/errors'
+
+export function getConfig(): Config {
+  throw new PlatformSplitStubError('Use the correct getConfig for your platform')
+}

package/src/getConfig.web.ts

@@ -0,0 +1,69 @@
+import type { Config } from '@l.x/config/src/config-types'
+import { isNonTestDev } from 'utilities/src/environment/constants'
+
+// Module-level cache for config to avoid recomputing on every call
+let cachedConfig: Config | undefined
+
+// eslint-disable-next-line complexity
+export const getConfig = (): Config => {
+  // Return cached config if already computed
+  if (cachedConfig !== undefined) {
+    return cachedConfig
+  }
+
+  /**
+   * Web-specific config implementation that uses process.env directly
+   * instead of react-native-dotenv to avoid Node.js filesystem dependencies
+   * in browser extension builds.
+   */
+  const config: Config = {
+    alchemyApiKey: process.env.REACT_APP_ALCHEMY_API_KEY || process.env.ALCHEMY_API_KEY || '',
+    amplitudeProxyUrlOverride: process.env.AMPLITUDE_PROXY_URL_OVERRIDE || '',
+    apiBaseUrlOverride: process.env.API_BASE_URL_OVERRIDE || '',
+    apiBaseUrlV2Override: process.env.API_BASE_URL_V2_OVERRIDE || '',
+    appsflyerApiKey: process.env.APPSFLYER_API_KEY || '',
+    appsflyerAppId: process.env.APPSFLYER_APP_ID || '',
+    blockaidProxyUrl: process.env.REACT_APP_BLOCKAID_PROXY_URL || process.env.BLOCKAID_PROXY_URL || '',
+    datadogClientToken: process.env.REACT_APP_DATADOG_CLIENT_TOKEN || process.env.DATADOG_CLIENT_TOKEN || '',
+    datadogProjectId: process.env.REACT_APP_DATADOG_PROJECT_ID || process.env.DATADOG_PROJECT_ID || '',
+    enableEntryGatewayProxy: process.env.VITE_ENABLE_ENTRY_GATEWAY_PROXY === 'true',
+    enableSessionService: process.env.ENABLE_SESSION_SERVICE === 'true',
+    enableSessionUpgradeAuto:
+      process.env.REACT_APP_ENABLE_SESSION_UPGRADE_AUTO === 'true' ||
+      process.env.ENABLE_SESSION_UPGRADE_AUTO === 'true',
+    isE2ETest: process.env.IS_E2E_TEST?.toLowerCase() === 'true',
+    forApiUrlOverride: process.env.FOR_API_URL_OVERRIDE || '',
+    graphqlUrlOverride: process.env.GRAPHQL_URL_OVERRIDE || '',
+    infuraKey: process.env.REACT_APP_INFURA_KEY || '',
+    includePrototypeFeatures: process.env.INCLUDE_PROTOTYPE_FEATURES || '',
+    isVercelEnvironment: process.env.VERCEL === '1',
+    jupiterProxyUrl: process.env.REACT_APP_JUPITER_PROXY_URL || process.env.JUPITER_PROXY_URL || '',
+    onesignalAppId: process.env.ONESIGNAL_APP_ID || '',
+    quicknodeEndpointName: process.env.REACT_APP_QUICKNODE_ENDPOINT_NAME || process.env.QUICKNODE_ENDPOINT_NAME || '',
+    quicknodeEndpointToken:
+      process.env.REACT_APP_QUICKNODE_ENDPOINT_TOKEN || process.env.QUICKNODE_ENDPOINT_TOKEN || '',
+    scantasticApiUrlOverride: process.env.SCANTASTIC_API_URL_OVERRIDE || '',
+    statsigApiKey: process.env.REACT_APP_STATSIG_API_KEY || process.env.STATSIG_API_KEY || '',
+    statsigProxyUrlOverride: process.env.STATSIG_PROXY_URL_OVERRIDE || '',
+    tradingApiKey: process.env.REACT_APP_TRADING_API_KEY || process.env.TRADING_API_KEY || '',
+    tradingApiUrlOverride: process.env.REACT_APP_TRADING_API_URL_OVERRIDE || process.env.TRADING_API_URL_OVERRIDE || '',
+    tradingApiWebTestEnv: process.env.REACT_APP_TRADING_API_TEST_ENV || '',
+    liquidityServiceUrlOverride:
+      process.env.REACT_APP_LIQUIDITY_SERVICE_URL_OVERRIDE || process.env.LIQUIDITY_SERVICE_URL_OVERRIDE || '',
+    lxApiKey: process.env.LX_API_KEY || '',
+    unitagsApiUrlOverride: process.env.UNITAGS_API_URL_OVERRIDE || '',
+    lxNotifApiBaseUrlOverride: process.env.LX_NOTIF_API_BASE_URL_OVERRIDE || '',
+    entryGatewayApiUrlOverride: process.env.ENTRY_GATEWAY_API_URL_OVERRIDE || '',
+    walletConnectProjectId:
+      process.env.REACT_APP_WALLET_CONNECT_PROJECT_ID || process.env.WALLETCONNECT_PROJECT_ID || '',
+    walletConnectProjectIdBeta: process.env.WALLETCONNECT_PROJECT_ID_BETA || '',
+    walletConnectProjectIdDev: process.env.WALLETCONNECT_PROJECT_ID_DEV || '',
+  }
+  if (isNonTestDev) {
+    // biome-ignore lint/suspicious/noConsole: Cannot use logger here, causes error from circular dep
+    console.debug('Using app config:', config)
+  }
+  // Cache and return frozen config
+  cachedConfig = Object.freeze(config)
+  return cachedConfig
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export type { Config } from './config-types'
+export { getConfig } from './getConfig'
+export { brand, getBrandUrl, getDocsUrl, getGatewayUrl, getWsUrl } from './brand'
+export type { BrandConfig } from './brand'

package/src/legal.ts

@@ -0,0 +1,55 @@
+/**
+ * Shared legal content for all Lux ecosystem apps.
+ *
+ * Every app (lux.exchange, zoo.exchange, pars.market, bridge.lux.network,
+ * explore.lux.network, etc.) serves /terms and /privacy using this content.
+ *
+ * The brand name is injected from the runtime brand config.
+ * The content is the same across all white-label deployments.
+ */
+
+export const LEGAL_UPDATED = '2026-03-25'
+
+export const LEGAL_URLS = {
+  terms: '/terms',
+  privacy: '/privacy',
+  regulatory: 'https://lps.lux.network/legal/regulatory-status',
+  compliance: 'mailto:compliance@lux.exchange',
+  legal: 'mailto:legal@lux.network',
+  privacyEmail: 'mailto:privacy@lux.network',
+  security: 'mailto:security@lux.network',
+  lp3103: 'https://lps.lux.network/docs/lp-3103-us-regulatory-classification',
+  lp3104: 'https://lps.lux.network/docs/lp-3104-genius-act-stablecoin-compliance',
+}
+
+/** Short disclaimer text for footers */
+export const FOOTER_DISCLAIMER =
+  'Experimental research software. Not legal, tax, or financial advice. Non-custodial — we never have access to your keys or funds. Use at your own risk.'
+
+/** Regulatory notice for inline display (brand-agnostic) */
+export const REGULATORY_NOTICE =
+  'Native protocol tokens are classified as digital commodities under the SEC/CFTC joint interpretive release of March 17, 2026. ' +
+  'Protocol staking, liquidity provision, and no-consideration airdrops are administrative activities outside the Howey test. ' +
+  'This interface is experimental research software provided "as is" without warranty.'
+
+/** Cookie/analytics notice text */
+export const COOKIE_NOTICE =
+  'This interface uses minimal cookies for functionality (theme, preferences) and privacy-respecting analytics. ' +
+  'No tracking cookies. No behavioral profiling. No data sold to third parties.'
+
+/** Non-custodial notice text */
+export const NON_CUSTODIAL_NOTICE =
+  'This protocol is fully non-custodial. We never have access to, custody of, or control over your private keys, ' +
+  'seed phrases, passwords, or funds. All transactions are executed directly by you on the blockchain and are irreversible. ' +
+  'Your keys, your assets, your responsibility.'
+
+/**
+ * Generate brand-specific legal URLs
+ */
+export function getLegalUrls(appDomain: string) {
+  return {
+    terms: `https://${appDomain}/terms`,
+    privacy: `https://${appDomain}/privacy`,
+    regulatory: LEGAL_URLS.regulatory,
+  }
+}

package/tsconfig.json

@@ -0,0 +1,32 @@
+{
+  "extends": "../../config/tsconfig/app.json",
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "src/**/*.json",
+    "env.native.d.ts",
+    "env.d.ts"
+  ],
+  "exclude": [
+    "src/**/*.spec.ts",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.ts",
+    "src/**/*.test.tsx"
+  ],
+  "compilerOptions": {
+    "emitDeclarationOnly": true,
+    "noEmit": false,
+    "types": ["node"],
+    "paths": {
+      "@l.x/config/*": ["./src/*"]
+    }
+  },
+  "references": [
+    {
+      "path": "../utilities"
+    },
+    {
+      "path": "../eslint-config"
+    }
+  ]
+}

package/tsconfig.lint.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "preserveSymlinks": true
+  },
+  "include": ["**/*.ts", "**/*.tsx", "**/*.json"],
+  "exclude": ["node_modules"]
+}

package/vitest.config.ts

@@ -0,0 +1,26 @@
+import path from 'path'
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  define: {
+    __DEV__: true,
+  },
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    include: ['src/**/*.test.ts', 'src/**/*.test.tsx'],
+    exclude: ['node_modules', 'dist'],
+    testTimeout: 15000,
+    reporters: ['verbose'],
+    coverage: {
+      include: ['src/**/*.ts*'],
+      exclude: ['src/**/*.d.ts'],
+    },
+  },
+  resolve: {
+    extensions: ['.web.ts', '.web.tsx', '.ts', '.tsx', '.js', '.jsx', '.json'],
+    alias: {
+      'config/src': path.resolve(__dirname, './src'),
+    },
+  },
+})

package/index.d.ts

@@ -1 +0,0 @@
-export * from '@luxexchange/config';

package/index.js

@@ -1 +0,0 @@
-module.exports = require('@luxexchange/config');