User Requirements & Journeys
Set Up For Local Development
Prerequisites
System Requirements:
OS: Linux (Ubuntu 18.04+), macOS 10.15+, or Windows 10+ Node.js: Version 18+ with npm
Python: Version 3.8+ for automation scripts Git: Latest version for version control Hardware Requirements:
CPU: 4+ cores recommended for development
RAM: 8GB+ for running multiple services
Storage: 50GB+ free space for dependencies
Network: Stable internet connection Development Tools:
VS Code - Recommended IDE with extensions
Postman - API testing and documentation
SQLite Browser - Database management
Chrome DevTools - Frontend debugging
Installation Steps
Clone Repository:
git clone https://github.com/your-org/idle-finance-v2.git cd idle-finance-v2
Install Dependencies: # Frontend dependencies
cd frontend npm install
# Backend dependencies cd ../backend
npm install
# Automation dependencies cd ../automation/golem
pip install -r requirements.txt
Environment Setup:
# Backend environment cd backend
cp .env.example .env
# Edit .env with your configuration
# Frontend environment cd ../frontend
cp .env.example .env
# Edit .env with your configuration
Database Setup: cd backend
npm run migration:run npm run seed
Running Locally
Start Backend:
# API available at http://localhost:3000
# Swagger docs at http://localhost:3000/api/v1/docs
Start Frontend:
# App available at http://localhost:5173
Start Automation (Optional): cd automation/golem
python -m uvicorn main:app --reload Automation API at http://localhost:8000
Build Desktop App: cd frontend
How It Works
The Curated Wallet System
The Idle Network Curated Wallet System allows users to:
Generate a secure wallet during signup
Encrypt and store keys locally
Automatically collect rewards
Track everything transparently
Keep you in full control
Security:
Everything encrypted locally
Device-specific access
Non-transferable profiles
Automatic backups
Behind the Scenes
Your Desktop App:
Cross-platform (Windows, Mac, Linux)
Real-time monitoring
Local sensitive state management
Cloud non-sensitive state management
Automatic updates Our Backend:
Manages your profile and wallet
Orchestrates node deployment
Tracks rewards and performance
Handles all the complex Golem Integration:
Automatically deploys provider nodes
Monitors performance in real-time
Optimizes resource usage
Handles all the technical details Local Reward Tracking:
Tracks GLM earnings locally
Real-time performance monitoring
Secure local storage
Future: Will bridge to other networks
Earning Process
How You Earn:
Node runs - Golem provider does compute tasks
Rewards earned - GLM tokens on Ethereum network
Automatic tracking - we monitor everything locally
Real-time updates - see earnings as they happen
Future features - bridging and vaults coming soon
Using Idle Network
Dashboard
Your main control center shows:
Connection status - animated rings show if you're connected
Earnings - live GLM token tracking
System health - CPU, memory, disk usage
Node controls - start/stop your node
Performance - uptime and efficiency stats
Everything updates in real-time. No manual refresh needed.
Rewards
Live updates - see GLM tokens as they come in
History - earnings over time
Collection - rewards automatically tracked
Transparency - know exactly what you're earning
Node Management

Start/Stop - one-click control
Status - see if it's running
Resources - CPU, memory, disk usage
Performance - uptime and efficiency
Settings - we optimize automatically
Activity Log
See everything that happens:
Node events - starts, stops, status changes
Rewards - when you earn GLM tokens
System alerts - performance issues
Performance - uptime and resource usage
Settings
Manage your account:

Profile - name, email, device info
Wallet - view your curated wallet (show/hide address)
Preferences - notifications, optimizations
Security - two-factor auth, account protection
See everything that happens:
Node events - starts, stops, status changes
Rewards - when you earn GLM tokens
System alerts - performance issues
Performance - uptime and resource usage
Last updated

