Merge PR #1

Merged via gits script

docs/farming/advanced-nodes.md

@@ -0,0 +1,147 @@
+---
+sidebar_position: 3
+---
+
+# Advanced Node Options
+
+Beyond traditional farming nodes, ThreeFold offers specialized **Edge Compute** and **Edge AI** nodes designed for specific use cases and enhanced earning opportunities.
+
+## Edge Compute Node
+
+**Based on GMKtec NUCBox M6 Ultra (Ryzen 5 7640HS)**
+
+### Specifications
+
+| Component | Specification |
+|-----------|---------------|
+| **CPU** | AMD Ryzen 5 7640HS (6 cores / 12 threads, up to ~5.0 GHz) |
+| **RAM** | 32 GB |
+| **Storage** | 1 TB NVMe SSD |
+| **Power Usage** | ~30-40 W typical under load |
+| **Network** | 2.5GbE LAN |
+| **Form Factor** | Mini PC, silent/dedicated use ready |
+
+### Three Usage Options
+
+#### Option 1: Use It Yourself (Free Forever)
+
+When you dedicate the machine to your own AI, cloud or development workloads:
+
+- ✅ Full control of the hardware and software stack
+- ✅ Access to the Mycelium OS / stack, for experiments and private workloads
+- ✅ No hosting fees. Use it as your private edge compute device
+
+#### Option 2: Host for the Mycelium Network
+
+When you make part or all of it available to the network and earn SPORE tokens:
+
+- ✅ Divide the machine into "slices" (allocate CPU cores, RAM, storage)
+- ✅ Submit to the marketplace and match bids or customer demand
+- ✅ Guaranteed baseline income via bid tiers
+- ✅ Example: Standard compute tier = minimum price × 80% in SPORE
+
+#### Option 3: Hybrid Approach
+
+- ✅ Use 50% for yourself, rent out 50% to the network
+- ✅ Mycelium coop willing to rent 50% of your node
+- ✅ Best of both worlds: personal use + earning
+
+---
+
+## Edge AI Node
+
+**Based on Ryzen AI MAX+ 395 platform**
+
+### Specifications
+
+| Component | Specification |
+|-----------|---------------|
+| **CPU** | AMD Ryzen™ AI MAX+ 395 (8C/16T, up to 5.1 GHz) |
+| **AI Accelerator** | Integrated NPU (~50 TOPS) |
+| **RAM** | 128 GB DDR5 |
+| **Storage** | 2 TB NVMe SSD |
+| **Power Usage** | ~45–55 W typical load |
+| **Network** | Dual 2.5 G LAN |
+| **Form Factor** | Compact, silent, ready for 24/7 operation |
+
+### AI-Focused Features
+
+- ✅ **Built-in AI Acceleration** - 50 TOPS NPU for local AI workloads
+- ✅ **High Memory** - 128GB DDR5 for memory-intensive AI tasks
+- ✅ **AI Development Ready** - Perfect for running local AI models
+- ✅ **Edge AI Processing** - Handle AI workloads closer to data sources
+
+---
+
+## How It Works
+
+1. **Buy your node** - Choose Edge Compute or Edge AI based on your needs
+2. **Install Mycelium OS (ZOS)** - Quick setup with our step-by-step guide
+3. **Decide usage mode** - Private use, hosting, or hybrid approach
+4. **Earn SPORE automatically** - 80% of revenue goes to you, 10% burned, 10% to development
+
+### SPORE Earning Example
+
+```mermaid
+graph TD
+    A[Node Provides Capacity] --> B[User Rents Resources]
+    B --> C[80% to You<br/>SPORE Tokens]
+    B --> D[10% Burned<br/>Makes SPORE Scarcer]
+    B --> E[10% Mycelium<br/>Development]
+    
+    C --> F[You Choose:<br/>Hold • Convert • Use]
+    D --> G[SPORE Supply Decreases<br/>Your Holdings More Valuable]
+    E --> H[The ecosystem grows<br/>Everyone benefits]
+```
+
+---
+
+## Comparison: Edge vs Traditional Nodes
+
+| **Feature** | **Edge Compute** | **Edge AI** | **Traditional Mini 1** |
+|-------------|------------------|-------------|------------------------|
+| **CPU Performance** | High (6-core Zen 4) | Very High (8-core AI) | Moderate |
+| **RAM** | 32GB | 128GB DDR5 | 32GB |
+| **AI Capabilities** | Basic | Advanced NPU | None |
+| **Power Usage** | 30-40W | 45-55W | ~60W |
+| **Best For** | General compute | AI workloads | Traditional farming |
+
+---
+
+## Getting Started with Edge Nodes
+
+### Ready to Buy?
+
+1. **Research vendors** - Compare prices for GMKtec NUCBox M6 Ultra or Ryzen AI MAX+ 395
+2. **Choose your approach** - Private use, hosting, or hybrid
+3. **[Set up your node](/getstarted/farming/setup)** - Follow our setup guide
+4. **[Learn about SPORE](/getstarted/farming/economics)** - Understand the token system
+
+### Need Help Deciding?
+
+- **Edge Compute**: Choose if you want efficient general-purpose computing with earning potential
+- **Edge AI**: Choose if you're interested in AI development and want maximum earning potential
+- **Traditional**: Choose if you want to start with the most affordable farming option
+
+<div className="info-box">
+
+### 💡 Pro Tip
+
+Edge nodes offer higher earning potential than traditional nodes, but require a larger initial investment. Consider starting with a traditional Mini 1 node to learn the system, then upgrading to Edge nodes as you become more comfortable with farming.
+
+</div>
+
+---
+
+## Links
+
+- **[GMKtec NUCBox M6 Ultra](https://www.gmktec.com/products/amd-ryzen-5-7640hs-mini-pc-nucbox-m6-ultra)**
+- **[Ryzen AI MAX+ 395 EVO X2](https://www.gmktec.com/products/amd-ryzen%E2%84%A2-ai-max-395-evo-x2-ai-mini-pc)**
+- **[Learn SPORE Economics](/getstarted/farming/economics)** - Understand the token system
+- **[Community Discussion](https://t.me/threefoldfarmers)** - Get advice from experienced farmers
+
+---
+
+:::tip Next Step
+Ready to set up your node? Check out the **[Setup Guide](/getstarted/farming/setup)** to get started.
+:::

docs/farming/buy-node.md

@@ -57,6 +57,20 @@ When buying a pre-built node, consider:
 - 2TB+ SSD (multi-drive)
 - Maximum capacity (~150-200W)
 
+### Specialized Edge Computing Options
+
+Beyond traditional farming nodes, ThreeFold offers **specialized Edge Compute and Edge AI nodes** designed for enhanced earning potential and specific use cases:
+
+- **Edge Compute Node**: GMKtec NUCBox M6 Ultra (€400) - Ryzen 5 7640HS, 32GB RAM
+- **Edge AI Node**: Ryzen AI MAX+ 395 - Advanced AI capabilities, 128GB RAM
+
+**Why Consider Edge Nodes?**
+- Higher earning potential
+- AI-optimized hardware for future workloads
+- Hybrid use options (private + hosting)
+
+**[Learn about Advanced Node Options](/getstarted/farming/advanced-nodes)** - Detailed specifications and pricing
+
 ## Option 2: Build Your Own Node
 
 ### Why Build Your Own?

docs/farming/economics.md

@@ -0,0 +1,239 @@
+---
+sidebar_position: 5
+---
+
+# Farming Economics
+
+Understanding how ThreeFold farmers earn money and the role of SPORE tokens in the ecosystem.
+
+## What is SPORE?
+
+**SPORE** is the native token of the ThreeFold ecosystem. Think of it as your reward for providing compute, storage, and network resources to the decentralized grid.
+
+### Key Facts About SPORE
+
+| **Feature** | **Details** |
+|-------------|-------------|
+| **Current Price** | $0.01 USD per SPORE (fixed until June 30, 2026) |
+| **Price After June 2026** | Will float based on market demand |
+| **What You Earn** | SPORE tokens for providing capacity |
+| **Maximum Supply** | 10 billion SPORE (capped) |
+| **Utility** | Payment for farmers, ecosystem growth token |
+
+### Why SPORE Value Should Increase
+
+1. **Burning reduces supply** - 10% of all revenue burns SPORE, shrinking total supply
+2. **Demand increases** - As more users adopt ThreeFold, demand for SPORE grows
+3. **Fewer tokens + more demand = higher price**
+
+---
+
+## How Revenue Works
+
+When users rent your node's resources, payments are distributed automatically:
+
+```mermaid
+graph LR
+    A[User Pays for Resources] --> B[80% to Farmer<br/>SPORE Tokens]
+    A --> C[10% Burned<br/>Removed from circulation]
+    A --> D[10% ThreeFold<br/>Development]
+    
+    B --> E[Your SPORE Balance Increases]
+    C --> F[Total SPORE Supply Decreases<br/>Each token worth more]
+    D --> G[Funds development<br/>of the ecosystem]
+```
+
+### Revenue Split Example
+
+**User pays $10 for compute resources:**
+
+| **Recipient** | **Amount** | **What Happens** |
+|---------------|------------|------------------|
+| **You (Farmer)** | $8 (800 SPORE) | Added to your balance |
+| **Burned** | $1 (100 SPORE) | Permanently destroyed |
+| **ThreeFold** | $1 (100 SPORE) | Funds development |
+
+---
+
+## What Happens When SPORE is Burned?
+
+Burning is like **removing tokens from circulation permanently**. Here's why this is good for farmers:
+
+### The Simple Math
+
+**Price = Market Demand ÷ Available Supply**
+
+- **Without burning**: Supply stays constant, price rises slowly with demand
+- **With burning**: Supply shrinks, price rises much faster
+
+### Example Over Time
+
+| **Year** | **SPORE Burned** | **Remaining Supply** | **Effect on Price** |
+|----------|------------------|---------------------|-------------------|
+| Year 1 | 1 billion | 9 billion | ↑ 10% scarcity |
+| Year 2 | 2 billion | 8 billion | ↑ 20% scarcity |
+| Year 3 | 3 billion | 7 billion | ↑ 30% scarcity |
+| Year 4 | 4 billion | 6 billion | ↑ 40% scarcity |
+
+*Your SPORE holdings become more valuable as supply decreases*
+
+---
+
+## Managing Your SPORE Earnings
+
+You have three main options with your earned SPORE:
+
+### Option 1: Hold (Recommended)
+
+**Keep your SPORE to benefit from price appreciation**
+
+- ✅ **Price growth potential** - Burning reduces supply
+- ✅ **Long-term wealth building** - Early holders benefit most
+- ✅ **No action needed** - Just let it grow
+
+### Option 2: Convert to Stable Currency
+
+**Swap SPORE for Cloud Credits (CC) for stability**
+
+- ✅ **Stable value** - CC pegged to gold
+- ✅ **Predictable budgeting** - No price volatility
+- ✅ **Can convert back** - Future flexibility
+
+### Option 3: Sell for Real Money
+
+**Convert SPORE to USD, EUR, or other currencies**
+
+- ✅ **Immediate cash** - Use for other investments
+- ✅ **Liquidity** - Access to real-world money
+- ❌ **Miss appreciation** - Give up future growth
+
+---
+
+## Real Earning Scenarios
+
+### Scenario 1: Mini 1 Node at 50% Utilization
+
+| **Parameter** | **Calculation** | **Result** |
+|---------------|-----------------|------------|
+| Hardware Cost | $350 one-time | - |
+| Monthly Revenue | 7 slices × $6 | $42/month |
+| Your Share (80%) | $42 × 0.80 | $33.60/month |
+| In SPORE | $33.60 ÷ $0.01 | 3,360 SPORE/month |
+| Annual Earnings | 3,360 × 12 | 40,320 SPORE/year |
+| At Current Price | 40,320 × $0.01 | $403.20/year |
+
+### Scenario 2: Edge AI Node at Full Hosting
+
+| **Parameter** | **Value** |
+|---------------|-----------|
+| Purchase Price | ~$2,000 (varies) |
+| Monthly Earning | 6,667 SPORE (€66.67) |
+| Annual SPORE | 80,004 SPORE/year |
+| At Current Price | $800.04/year |
+| Break-even Time | ~2.5 years |
+
+### Scenario 3: Nvidia 6000 at High Utilization
+
+| **Parameter** | **Value** |
+|---------------|-----------|
+| Hardware Cost | $15,000 |
+| Monthly Earning | 225,000 SPORE ($2,250) |
+| Annual Earnings | $27,000/year |
+| ROI | 180% annually |
+
+*Results vary based on utilization, market demand, and network growth*
+
+---
+
+## SPORE vs Other Options
+
+| **Investment** | **SPORE Farming** | **Traditional Server** | **Cloud Hosting** |
+|----------------|-------------------|----------------------|-------------------|
+| **Initial Cost** | $350-$15,000 | $2,000-$50,000 | $0 upfront |
+| **Ongoing Revenue** | SPORE tokens | None | None |
+| **Ownership** | Full control | Full control | None |
+| **Market Risk** | Token volatility | Hardware depreciation | None |
+| **Earning Potential** | Growing + appreciation | None | None |
+
+---
+
+## Benefits for Early Farmers
+
+### Why Start Now?
+
+1. **Fixed SPORE price** - $0.01 until June 2026 (predictable earnings)
+2. **Network growth** - More users = more demand = higher prices
+3. **Burning benefits** - Your holdings become scarcer over time
+4. **First-mover advantage** - Lower competition for hosting demand
+
+### Risk Considerations
+
+- **Hardware investment** - Nodes require upfront cost
+- **Token volatility** - SPORE price may fluctuate after 2026
+- **Market demand** - Earnings depend on network adoption
+- **Competition** - More farmers = more supply to compete with
+
+---
+
+## Getting Started with SPORE
+
+### Step 1: Set Up Your Node
+
+[Follow our setup guide](/getstarted/farming/setup) to get your node online and earning SPORE automatically.
+
+### Step 2: Monitor Your Earnings
+
+- **Dashboard tracking** - View SPORE balance and earning history
+- **Monthly reports** - Track utilization and revenue trends
+- **Price monitoring** - Watch SPORE market developments
+
+### Step 3: Manage Your Portfolio
+
+- **Start holding** - Benefit from early price stability
+- **Consider hybrid approach** - Keep some SPORE, convert some to CC
+- **Stay informed** - Follow ThreeFold developments
+
+---
+
+## Common Questions
+
+<details>
+<summary><strong>When will I start earning SPORE?</strong></summary>
+
+As soon as your node is online and starts providing capacity. The first earnings typically appear within 24-48 hours of going live.
+
+</details>
+
+<details>
+<summary><strong>Can I lose money farming?</strong></summary>
+
+Your SPORE earnings depend on utilization. Even with minimal usage, bid tiers ensure some baseline revenue. Hardware costs are one-time, so long-term farming should be profitable.
+
+</details>
+
+<details>
+<summary><strong>What if SPORE price drops?</strong></summary>
+
+The burning mechanism (10% of revenue) creates upward pressure on price. SPORE price is fixed at $0.01 until June 2026, providing stability during the early period.
+
+</details>
+
+<details>
+<summary><strong>How often do I get paid?</strong></summary>
+
+SPORE accumulation is continuous and automatic. You can check your balance anytime in the dashboard.
+
+</details>
+
+---
+
+## Resources
+
+- **[Community Forum](https://forum.threefold.io)** - Discussions with experienced farmers
+- **[Farming Manual](https://manual.grid.tf/farmers/intro)** - Technical implementation details
+
+---
+
+:::tip Ready to Start Earning?
+Set up your first node and begin earning SPORE today: **[Setup Guide](/getstarted/farming/setup)**
+:::

docs/farming/overview.md

@@ -17,6 +17,8 @@ As a **ThreeFold Farmer**, you:
 
 ## Why Become a Farmer?
 
+Farmers earn **SPORE tokens** for providing compute, storage, and network resources to the ThreeFold Grid.
+
 ### 🌱 Simple & Autonomous
 
 - Deploy once and let it run
@@ -24,11 +26,16 @@ As a **ThreeFold Farmer**, you:
 - Self-healing Zero-OS handles operations
 - No complex system administration needed
 
-### 💰 Multiple Revenue Streams
+### How Revenue Works
 
-- **Capacity Rewards** - Earn for available resources
+When users rent your node's resources, the payment is split:
-- **Utilization Rewards** - Earn when your capacity is used
+
-- **Growing Demand** - More workloads = more income potential
+```mermaid
+graph LR
+    A[User Pays] --> B[80% to Farmer<br/>SPORE Tokens]
+    A --> C[10% Burned<br/>Increases SPORE Scarcity]
+    A --> D[10% Mycelium<br/>Development]
+```
 
 ### 🌍 Make an Impact
 
@@ -88,7 +95,7 @@ Every farmer plays a vital role in creating a truly decentralized internet.
 ## Resources
 
 - **Dashboard**: [dashboard.grid.tf](https://dashboard.grid.tf) - Manage your farm
-- **Manual**: [manual.grid.tf/farmers](https://manual.grid.tf/farmers) - Detailed technical docs
+- **Manual**: [manual.grid.tf/farmers](https://manual.grid.tf/farmers/intro) - Detailed technical docs
 - **Community**: [t.me/threefold](https://t.me/threefold/1) - Get help from the community
 - **Forum**: [forum.threefold.io](https://forum.threefold.io) - Discussions and updates
 

docs/farming/setup.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 # Set Up Your Node
@@ -77,6 +77,55 @@ After your node is powered on:
 4. Your node should appear with status **Online**
 5. Check that resources (CPU, RAM, Storage) are correctly detected
 
+### What Happens Next? Start Earning SPORE
+
+🎉 **Congratulations!** Your node is now connected to the ThreeFold Grid and ready to start earning SPORE!
+
+#### When Will You Start Earning?
+
+- **First earnings**: Within 24-48 hours of going online
+- **Automatic process**: No manual intervention needed
+- **Continuous earning**: SPORE accumulates as your capacity is used
+
+#### How to Monitor Your Earnings
+
+1. **Check your SPORE balance** in the ThreeFold Connect app
+2. **View earnings history** to track your progress
+3. **Monitor utilization** - see how much of your capacity is being used
+4. **Track performance** - CPU, RAM, and storage usage over time
+
+#### Understanding Your Earning Data
+
+| **Metric** | **What It Means** | **How to Improve** |
+|------------|------------------|-------------------|
+| **SPORE Balance** | Total tokens earned | More utilization = more SPORE |
+| **Utilization %** | How much capacity is used | Lower prices, better location |
+| **Active Slices** | Currently rented resources | More slices = higher earning potential |
+| **Monthly Revenue** | Recent earning trend | Optimized pricing and hardware |
+
+#### Basic SPORE Management
+
+**Option 1: Hold Your SPORE (Recommended)**
+- Let your SPORE accumulate
+- Benefit from price appreciation over time
+- Minimal management required
+
+**Option 2: Convert to Stable Currency**
+- Convert some SPORE to Cloud Credits (CC)
+- CC provides stable value for budgeting
+- Keep some SPORE for growth potential
+
+<div className="info-box">
+
+### 💡 First Month Tips
+
+- **Don't worry about low initial earnings** - It takes time for the market to discover your node
+- **Optimize your pricing** - Consider starting with competitive prices to build reputation
+- **Monitor but don't obsess** - SPORE earning is a marathon, not a sprint
+- **Join the community** - Get tips from experienced farmers
+
+</div>
+
 ## Troubleshooting
 
 **Node not appearing?**

sidebars.js

@@ -27,7 +27,9 @@ const sidebars = {
       items: [
         'farming/overview',
         'farming/buy-node',
+        'farming/advanced-nodes',
         'farming/setup',
+        'farming/economics',
       ],
     },
     {