@luxexchange/config 1.0.1 → 1.0.3

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/env.d.ts

@@ -48,8 +48,8 @@ declare global {
       STATSIG_PROXY_URL_OVERRIDE?: string
       TRADING_API_KEY?: string
       TRADING_API_URL_OVERRIDE?: string
-      LUX_API_KEY?: string
-      LUX_NOTIF_API_BASE_URL_OVERRIDE?: string
+      LX_API_KEY?: string
+      LX_NOTIF_API_BASE_URL_OVERRIDE?: string
       UNITAGS_API_URL_OVERRIDE?: string
       VERSION?: string
       VERCEL?: string

package/env.native.d.ts

@@ -22,7 +22,6 @@ declare module 'react-native-dotenv' {
   export const IS_E2E_TEST: string
   export const JUPITER_PROXY_URL: string
   export const LIQUIDITY_SERVICE_URL_OVERRIDE: string
-  export const LUX_GATEWAY_URL: string
   export const ONESIGNAL_APP_ID: string
   export const QUICKNODE_ENDPOINT_NAME: string
   export const QUICKNODE_ENDPOINT_TOKEN: string
@@ -31,8 +30,8 @@ declare module 'react-native-dotenv' {
   export const STATSIG_PROXY_URL_OVERRIDE: string
   export const TRADING_API_KEY: string
   export const TRADING_API_URL_OVERRIDE: string
-  export const LUX_API_KEY: string
-  export const LUX_NOTIF_API_BASE_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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luxexchange/config",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "dependencies": {
     "react-native-dotenv": "3.2.0",
     "@luxfi/utilities": "workspace:^"

package/project.json

@@ -1,7 +1,7 @@
 {
-  "name": "@luxfi/config",
+  "name": "@luxexchange/config",
   "$schema": "../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "packages/config/src",
+  "sourceRoot": "pkgs/config/src",
   "projectType": "library",
   "tags": ["scope:config", "type:lib"],
   "targets": {

package/src/brand.ts

@@ -0,0 +1,165 @@
+/**
+ * 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
+  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()
+export const brand: BrandConfig = {
+  name: 'Exchange',
+  title: 'Exchange | Trade',
+  description: 'Swap, earn, and build on the leading decentralized exchange',
+  appDomain: 'lux.exchange',
+  docsDomain: 'docs.lux.exchange',
+  infoDomain: 'info.lux.exchange',
+  gatewayDomain: 'gw.lux.exchange',
+  wsDomain: 'ws.lux.exchange',
+  helpUrl: 'https://docs.lux.exchange/help',
+  termsUrl: 'https://lux.exchange/terms',
+  privacyUrl: 'https://lux.exchange/privacy',
+  downloadUrl: 'https://lux.exchange/wallet',
+  complianceEmail: 'compliance@lux.exchange',
+  supportEmail: 'hi@lux.exchange',
+  twitter: 'https://x.com/luxfi',
+  github: 'https://github.com/luxfi',
+  discord: 'https://discord.gg/lux',
+  logoUrl: '',
+  faviconUrl: '/favicon.ico',
+  primaryColor: '#FC72FF',
+  defaultChainId: 96369,
+  supportedChainIds: [96369, 96368, 96367],
+  walletConnectProjectId: '',
+  insightsHost: 'https://insights.hanzo.ai',
+  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

@@ -21,7 +21,6 @@ export interface Config {
   isE2ETest: boolean
   forApiUrlOverride: string
   graphqlUrlOverride: string
-  gChainGraphqlUrl: string
   includePrototypeFeatures: string
   infuraKey: string
   isVercelEnvironment: boolean
@@ -36,11 +35,10 @@ export interface Config {
   tradingApiUrlOverride: string
   tradingApiWebTestEnv: string
   liquidityServiceUrlOverride: string
-  luxApiKey: string
+  lxApiKey: string
   unitagsApiUrlOverride: string
-  luxNotifApiBaseUrlOverride: string
+  lxNotifApiBaseUrlOverride: string
   entryGatewayApiUrlOverride: string
-  luxGatewayUrlOverride: string
   walletConnectProjectId: string
   walletConnectProjectIdBeta: string
   walletConnectProjectIdDev: string

package/src/getConfig.native.ts

@@ -1,4 +1,4 @@
-import type { Config } from '@luxfi/config/src/config-types'
+import type { Config } from '@luxexchange/config/src/config-types'
 import {
   ALCHEMY_API_KEY,
   AMPLITUDE_PROXY_URL_OVERRIDE,
@@ -13,7 +13,6 @@ import {
   ENABLE_SESSION_SERVICE,
   ENABLE_SESSION_UPGRADE_AUTO,
   ENTRY_GATEWAY_API_URL_OVERRIDE,
-  LUX_GATEWAY_URL,
   FOR_API_URL_OVERRIDE,
   GRAPHQL_URL_OVERRIDE,
   INCLUDE_PROTOTYPE_FEATURES,
@@ -29,8 +28,8 @@ import {
   STATSIG_PROXY_URL_OVERRIDE,
   TRADING_API_KEY,
   TRADING_API_URL_OVERRIDE,
-  LUX_API_KEY,
-  LUX_NOTIF_API_BASE_URL_OVERRIDE,
+  LX_API_KEY,
+  LX_NOTIF_API_BASE_URL_OVERRIDE,
   UNITAGS_API_URL_OVERRIDE,
   WALLETCONNECT_PROJECT_ID,
   WALLETCONNECT_PROJECT_ID_BETA,
@@ -77,10 +76,6 @@ export const getConfig = (): Config => {
     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,
-    // G-Chain GraphQL: testnet=9650, mainnet=9630
-    gChainGraphqlUrl:
-      process.env['GCHAIN_GRAPHQL_URL'] ||
-      (isNonTestDev ? 'http://localhost:9650/ext/bc/G/graphql' : 'http://localhost:9630/ext/bc/G/graphql'),
     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
@@ -105,12 +100,11 @@ export const getConfig = (): Config => {
       process.env.REACT_APP_LIQUIDITY_SERVICE_URL_OVERRIDE ||
       process.env.LIQUIDITY_SERVICE_URL_OVERRIDE ||
       LIQUIDITY_SERVICE_URL_OVERRIDE,
-    luxApiKey: process.env.LUX_API_KEY || LUX_API_KEY,
+    lxApiKey: process.env.LX_API_KEY || LX_API_KEY,
     unitagsApiUrlOverride: process.env.UNITAGS_API_URL_OVERRIDE || UNITAGS_API_URL_OVERRIDE,
-    luxNotifApiBaseUrlOverride:
-      process.env.LUX_NOTIF_API_BASE_URL_OVERRIDE || LUX_NOTIF_API_BASE_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,
-    luxGatewayUrlOverride: process.env['LUX_GATEWAY_URL'] || LUX_GATEWAY_URL || '',
     walletConnectProjectId:
       process.env.REACT_APP_WALLET_CONNECT_PROJECT_ID ||
       process.env.WALLETCONNECT_PROJECT_ID ||

package/src/getConfig.ts

@@ -1,4 +1,4 @@
-import { Config } from '@luxfi/config/src/config-types'
+import { Config } from '@luxexchange/config/src/config-types'
 import { PlatformSplitStubError } from 'utilities/src/errors'
 
 export function getConfig(): Config {

package/src/getConfig.web.ts

@@ -1,4 +1,4 @@
-import type { Config } from '@luxfi/config/src/config-types'
+import type { Config } from '@luxexchange/config/src/config-types'
 import { isNonTestDev } from 'utilities/src/environment/constants'
 
 // Module-level cache for config to avoid recomputing on every call
@@ -34,13 +34,6 @@ export const getConfig = (): Config => {
     isE2ETest: process.env.IS_E2E_TEST?.toLowerCase() === 'true',
     forApiUrlOverride: process.env.FOR_API_URL_OVERRIDE || '',
     graphqlUrlOverride: process.env.GRAPHQL_URL_OVERRIDE || '',
-    // G-Chain GraphQL: testnet=9650, mainnet=9630, devnet=9650
-    gChainGraphqlUrl:
-      process.env['REACT_APP_GCHAIN_GRAPHQL_URL'] ||
-      process.env['GCHAIN_GRAPHQL_URL'] ||
-      (process.env.NODE_ENV === 'production'
-        ? 'http://localhost:9630/ext/bc/G/graphql'
-        : 'http://localhost:9650/ext/bc/G/graphql'),
     infuraKey: process.env.REACT_APP_INFURA_KEY || '',
     includePrototypeFeatures: process.env.INCLUDE_PROTOTYPE_FEATURES || '',
     isVercelEnvironment: process.env.VERCEL === '1',
@@ -57,11 +50,10 @@ export const getConfig = (): Config => {
     tradingApiWebTestEnv: process.env.REACT_APP_TRADING_API_TEST_ENV || '',
     liquidityServiceUrlOverride:
       process.env.REACT_APP_LIQUIDITY_SERVICE_URL_OVERRIDE || process.env.LIQUIDITY_SERVICE_URL_OVERRIDE || '',
-    luxApiKey: process.env.LUX_API_KEY || '',
+    lxApiKey: process.env.LX_API_KEY || '',
     unitagsApiUrlOverride: process.env.UNITAGS_API_URL_OVERRIDE || '',
-    luxNotifApiBaseUrlOverride: process.env.LUX_NOTIF_API_BASE_URL_OVERRIDE || '',
+    lxNotifApiBaseUrlOverride: process.env.LX_NOTIF_API_BASE_URL_OVERRIDE || '',
     entryGatewayApiUrlOverride: process.env.ENTRY_GATEWAY_API_URL_OVERRIDE || '',
-    luxGatewayUrlOverride: process.env['REACT_APP_LUX_GATEWAY_URL'] || process.env['LUX_GATEWAY_URL'] || '',
     walletConnectProjectId:
       process.env.REACT_APP_WALLET_CONNECT_PROJECT_ID || process.env.WALLETCONNECT_PROJECT_ID || '',
     walletConnectProjectIdBeta: process.env.WALLETCONNECT_PROJECT_ID_BETA || '',

package/src/index.ts

@@ -1,37 +1,4 @@
 export type { Config } from './config-types'
 export { getConfig } from './getConfig'
-
-// Chain definitions
-export {
-  luxMainnet,
-  luxTestnet,
-  zooMainnet,
-  zooTestnet,
-  hanzoMainnet,
-  spcMainnet,
-  parsMainnet,
-  liquidEvm,
-  LUX_MAINNET_ID,
-  LUX_TESTNET_ID,
-  ZOO_MAINNET_ID,
-  ZOO_TESTNET_ID,
-  HANZO_MAINNET_ID,
-  SPC_MAINNET_ID,
-  PARS_MAINNET_ID,
-  LIQUID_EVM_ID,
-  supportedChains,
-  type SupportedChainId,
-} from './chains'
-
-// Contract addresses
-export {
-  LUX_MAINNET_CONTRACTS,
-  LUX_TESTNET_CONTRACTS,
-  ZOO_MAINNET_CONTRACTS,
-  HANZO_MAINNET_CONTRACTS,
-  SPC_MAINNET_CONTRACTS,
-  PARS_MAINNET_CONTRACTS,
-  DEX_PRECOMPILES,
-  getContracts,
-  type ContractAddresses,
-} from './contracts'
+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 */
+export const REGULATORY_NOTICE =
+  'LUX is classified as a digital commodity 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

@@ -1,18 +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"],
+  "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": {
-      "@universe/config/*": ["./src/*"]
+      "@luxexchange/config/*": ["./src/*"]
     }
   },
   "references": [
     {
       "path": "../utilities"
+    },
+    {
+      "path": "../eslint-config"
     }
   ]
 }