Files
smom-dbis-138/frontend-dapp/ENV_SETUP_COMPLETE.md
defiQUG 6dcadc86a2 chore(omnl): consolidate portal and domain routing updates
Capture non-secret OMNL portal, journal, chain, and nginx routing updates from the operator cleanup session while leaving generated auth includes unstaged.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 09:57:01 -07:00

3.8 KiB

Environment Variables Setup - Complete

Overview

All Reown credentials and environment variables have been successfully configured for the bridge dApp.

Environment Variables Configured

Created .env File

Location: smom-dbis-138/frontend-dapp/.env

Variables Added:

  1. Reown/WalletConnect Project ID

    VITE_WALLETCONNECT_PROJECT_ID=56972cec44a77f83975463494711e8fa
    
    • Used by wagmi for WalletConnect connector
    • Configured in src/config/wagmi.ts
    • Resolves "Project ID Not Configured" error
  2. Reown AppKit Auth API

    VITE_REOWN_APPKIT_AUTH_API=a8156a47-6c11-470f-bc0c-9633ef2fd905
    
    • Available for AppKit authentication if needed
    • Can be used for future AppKit integrations
  3. ThirdWeb Client ID

    VITE_THIRDWEB_CLIENT_ID=542981292d51ec610388ba8985f027d7
    
    • Used by ThirdWeb provider
    • Configured in src/App.tsx and src/pages/BridgePage.tsx
  4. Chain 138 RPC URL

    VITE_RPC_URL_138=http://192.168.11.250:8545
    
    • Used for connecting to Chain 138
    • Configured in src/config/wagmi.ts and src/config/bridge.ts

Security

.gitignore Created

  • .env file is now in .gitignore
  • Prevents accidental commit of sensitive credentials
  • Follows security best practices

Integration Points

1. Wagmi Configuration (src/config/wagmi.ts)

const projectId = import.meta.env.VITE_WALLETCONNECT_PROJECT_ID || ''
  • Uses Project ID for WalletConnect connector
  • Falls back to empty string if not set

2. ThirdWeb Configuration (src/App.tsx)

const THIRDWEB_CLIENT_ID = import.meta.env.VITE_THIRDWEB_CLIENT_ID || '542981292d51ec610388ba8985f027d7'
  • Uses ThirdWeb Client ID
  • Has fallback default value

3. Bridge Configuration (src/config/bridge.ts)

rpcUrl: import.meta.env.VITE_RPC_URL_138 || 'http://192.168.11.250:8545'
  • Uses Chain 138 RPC URL
  • Has fallback default value

Verification

Server Status

  • Dev server running on http://localhost:3002
  • Environment variables loaded
  • No configuration errors

Expected Behavior

  • WalletConnect should now work without "Project ID Not Configured" error
  • All wallet connectors (MetaMask, WalletConnect, Coinbase) functional
  • Chain 138 connection working
  • ThirdWeb integration functional

Next Steps (If Needed)

Using AppKit Auth API

If you need to use the AppKit Auth API in the future, you can access it via:

const appKitAuthApi = import.meta.env.VITE_REOWN_APPKIT_AUTH_API

Updating Credentials

To update any credentials:

  1. Edit .env file
  2. Restart dev server: npm run dev
  3. Changes take effect immediately

Production Deployment

For production:

  1. Set environment variables in your hosting platform
  2. Do NOT commit .env file (already in .gitignore)
  3. Use platform-specific environment variable configuration

Troubleshooting

If WalletConnect Still Shows Error

  1. Verify .env file exists and has correct Project ID
  2. Restart dev server completely
  3. Clear browser cache and reload
  4. Check browser console for any errors

If Environment Variables Not Loading

  1. Ensure variable names start with VITE_ (required by Vite)
  2. Restart dev server after changes
  3. Check for typos in variable names
  4. Verify .env file is in root of frontend-dapp directory

Files Modified/Created

  • Created: .env (environment variables)
  • Created: .gitignore (to protect .env)
  • Verified: src/config/wagmi.ts (uses Project ID)
  • Verified: src/App.tsx (uses ThirdWeb Client ID)
  • Verified: src/config/bridge.ts (uses RPC URL)

Status: COMPLETE

All environment variables have been configured and the dev server has been restarted. The application should now work without the "Project ID Not Configured" error.