# 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:

1. CPU: 4+ cores recommended for development
2. RAM: 8GB+ for running multiple services
3. Storage: 50GB+ free space for dependencies
4. Network: Stable internet connection Development Tools:
   1. VS Code - Recommended IDE with extensions
   2. Postman - API testing and documentation
   3. SQLite Browser - Database management
   4. Chrome DevTools - Frontend debugging

### Installation Steps

1. Clone Repository:

git clone <https://github.com/your-org/idle-finance-v2.git> cd idle-finance-v2

1. Install Dependencies: # Frontend dependencies

cd frontend npm install

\# Backend dependencies cd ../backend

npm install

\# Automation dependencies cd ../automation/golem

pip install -r requirements.txt

1. 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

1. Database Setup: cd backend

npm run migration:run npm run seed

### Running Locally

1. Start Backend:

```
// cd backend
```

```
// npm run start:dev
```

\# API available at [http://localhost:3000](http://localhost:3000/)

\# Swagger docs at <http://localhost:3000/api/v1/docs>

1. Start Frontend:

```
cd frontend npm run dev
```

\# App available at [http://localhost:5173](http://localhost:5173/)

1. Start Automation (Optional): cd automation/golem

python -m uvicorn main:app --reload Automation API at [http://localhost:8000](http://localhost:8000/)

1. Build Desktop App: cd frontend

```
npm run build
```

```
npm run electron:dev
```

## How It Works

### The Curated Wallet System

The Idle Network Curated Wallet System allows users to:

1. Generate a secure wallet during signup
2. Encrypt and store keys locally
3. Automatically collect rewards
4. Track everything transparently
5. Keep you in full control
6. Security:
   1. Everything encrypted locally
   2. Device-specific access
   3. Non-transferable profiles
   4. Automatic backups

### Behind the Scenes

Your Desktop App:

1. Cross-platform (Windows, Mac, Linux)
2. Real-time monitoring
3. Local sensitive state management
4. Cloud non-sensitive state management
5. Automatic updates Our Backend:
   1. Manages your profile and wallet
   2. Orchestrates node deployment
   3. Tracks rewards and performance
   4. Handles all the complex Golem Integration:
      1. Automatically deploys provider nodes
      2. Monitors performance in real-time
      3. Optimizes resource usage
      4. Handles all the technical details Local Reward Tracking:
         1. Tracks GLM earnings locally
         2. Real-time performance monitoring
         3. Secure local storage
         4. Future: Will bridge to other networks

### Earning Process

How You Earn:

1. Node runs - Golem provider does compute tasks
2. Rewards earned - GLM tokens on Ethereum network
3. Automatic tracking - we monitor everything locally
4. Real-time updates - see earnings as they happen
5. Future features - bridging and vaults coming soon

## Using Idle Network

### Dashboard

Your main control center shows:

1. Connection status - animated rings show if you're connected
2. Earnings - live GLM token tracking
3. System health - CPU, memory, disk usage
4. Node controls - start/stop your node
5. Performance - uptime and efficiency stats

Everything updates in real-time. No manual refresh needed.

### Rewards

1. Live updates - see GLM tokens as they come in
2. History - earnings over time
3. Collection - rewards automatically tracked
4. Transparency - know exactly what you're earning

### Node Management

<figure><img src="/files/epMoBOZOGDdTxOW8NyOQ" alt=""><figcaption></figcaption></figure>

1. Start/Stop - one-click control
2. Status - see if it's running
3. Resources - CPU, memory, disk usage
4. Performance - uptime and efficiency
5. Settings - we optimize automatically

### Activity Log

See everything that happens:

1. Node events - starts, stops, status changes
2. Rewards - when you earn GLM tokens
3. System alerts - performance issues
4. Performance - uptime and resource usage

### Settings

Manage your account:

<figure><img src="/files/IBzVzrDgpTh1enVdfTMS" alt=""><figcaption></figcaption></figure>

1. Profile - name, email, device info
2. Wallet - view your curated wallet (show/hide address)
3. Preferences - notifications, optimizations

Security - two-factor auth, account protection

See everything that happens:

1. Node events - starts, stops, status changes
2. Rewards - when you earn GLM tokens
3. System alerts - performance issues
4. Performance - uptime and resource usage


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.idlenetwork.com/architectural-overview/user-requirements-and-journeys.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.