solace-bg-dubai/ENV_FILES_GUIDE.md

Environment Files Guide

This project uses environment files for configuration. Each workspace has its own .env files.

File Structure

Frontend (frontend/)

• .env.local.example - Template for local development
• .env.production.example - Template for production deployment
• .env.local - Local development (gitignored)
• .env.production - Production deployment (gitignored)

Backend (backend/)

• .env.example - Template for backend API
• .env.indexer.example - Template for event indexer
• .env - Backend API configuration (gitignored)
• .env.indexer - Indexer configuration (gitignored)

Contracts (contracts/)

• .env.example - Template for contract deployment
• .env - Contract deployment configuration (gitignored)

Setup Instructions

1. Frontend Setup

For local development:

cd frontend
cp .env.local.example .env.local
# Edit .env.local with your values

For production:

cd frontend
cp .env.production.example .env.production
# Edit .env.production with your values

2. Backend Setup

Backend API:

cd backend
cp .env.example .env
# Edit .env with your database password and contract addresses

Event Indexer:

cd backend
cp .env.indexer.example .env.indexer
# Edit .env.indexer with your database password and contract address

3. Contracts Setup

cd contracts
cp .env.example .env
# Edit .env with your private key and RPC URLs

Required Values

Frontend

• NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID - Get from https://cloud.walletconnect.com
• NEXT_PUBLIC_TREASURY_WALLET_ADDRESS - After contract deployment
• NEXT_PUBLIC_SUB_ACCOUNT_FACTORY_ADDRESS - After contract deployment

Backend

• DATABASE_URL - PostgreSQL connection string
• CONTRACT_ADDRESS - Treasury wallet address (after deployment)
• RPC_URL - Chain 138 RPC endpoint

Contracts

• PRIVATE_KEY - Deployer account private key (with ETH balance on Chain 138)
• CHAIN138_RPC_URL - Chain 138 RPC endpoint

Security Notes

⚠️ NEVER commit .env files to version control!

• All .env files are gitignored
• Only .env.example files should be committed
• Use strong passwords and secure private keys
• Rotate credentials regularly

Chain 138 Configuration

All environment files are pre-configured for Chain 138:

• RPC URL: http://192.168.11.250:8545
• WebSocket: ws://192.168.11.250:8546
• Chain ID: 138

Update these if your Chain 138 RPC endpoints are different.