@l.x/config 1.0.3 → 1.0.5

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.5",
+  "dependencies": {
+    "react-native-dotenv": "3.2.0",
+    "@luxfi/utilities": "^1.0.6"
+  },
+  "devDependencies": {
+    "@types/node": "22.13.1",
+    "@typescript/native-preview": "7.0.0-dev.20260311.1",
+    "depcheck": "1.4.7",
+    "eslint": "8.57.1",
+    "jsdom": "^26.1.0",
+    "typescript": "5.8.3",
+    "vitest": "^4.0.16",
+    "@luxfi/eslint-config": "^1.0.6"
+  },
+  "nx": {
+    "includedScripts": []
+  },
+  "main": "src/index.ts",
+  "private": false,
+  "sideEffects": false,
+  "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"
+  }
+}

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,231 @@
+/**
+ * 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
+ *
+ * KMS integration: set KMS_BRAND_SECRET env var to load brand config from
+ * KMS (Infisical) instead of a ConfigMap. The secret should contain the
+ * full RuntimeConfig JSON. The /config.json endpoint in the serving layer
+ * should proxy to KMS when this env var is set.
+ */
+
+/** Theme color overrides applied on top of the default dark/light themes */
+export interface BrandTheme {
+  /** Primary accent color (buttons, links) */
+  accent1?: string
+  /** Background color */
+  surface1?: string
+  /** Secondary surface */
+  surface2?: string
+  /** Tertiary surface */
+  surface3?: string
+  /** Primary text color */
+  neutral1?: string
+  /** Secondary text color */
+  neutral2?: string
+  /** Success status color */
+  statusSuccess?: string
+  /** Critical/error status color */
+  statusCritical?: string
+}
+
+export interface BrandConfig {
+  name: string
+  title: string
+  description: string
+  /** Legal entity name for Terms/Privacy, e.g. "Lux Industries Inc." */
+  legalEntity: string
+  /** Wallet product name, e.g. "Zoo Wallet" or "Lux Wallet" */
+  walletName: string
+  /** Protocol product name, e.g. "Zoo Protocol" or "Lux Protocol" */
+  protocolName: string
+  /** Copyright holder name, e.g. "Zoo Labs Foundation" */
+  copyrightHolder: 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
+  /** Theme color overrides for dark and light modes */
+  theme?: {
+    light?: BrandTheme
+    dark?: BrandTheme
+  }
+}
+
+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: '',
+  walletName: '',
+  protocolName: '',
+  copyrightHolder: '',
+  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.
+ *
+ * KMS integration: when the serving layer sets KMS_BRAND_SECRET, it should
+ * proxy /config.json to fetch the secret value from KMS (Infisical). The
+ * SPA itself always fetches /config.json — KMS resolution is server-side.
+ */
+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)
+    }
+
+    // Derive convenience fields from name if not explicitly set
+    if (!brand.walletName && brand.name) {
+      brand.walletName = brand.name.replace(/\s*exchange\s*/i, '') + ' Wallet'
+    }
+    if (!brand.protocolName && brand.name) {
+      brand.protocolName = brand.name.replace(/\s*exchange\s*/i, '') + ' Protocol'
+    }
+    if (!brand.copyrightHolder) {
+      brand.copyrightHolder = brand.legalEntity
+    }
+
+    // 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 and favicon
+    if (typeof document !== 'undefined') {
+      if (config.brand?.title) {
+        document.title = config.brand.title
+      }
+      if (config.brand?.faviconUrl) {
+        const link = document.querySelector("link[rel*='icon']") as HTMLLinkElement | null
+        if (link) {
+          link.href = config.brand.faviconUrl
+        }
+      }
+    }
+
+    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, loadBrandConfig, getBrandUrl, getDocsUrl, getGatewayUrl, getWsUrl } from './brand'
+export type { BrandConfig, BrandTheme } 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');