docs: add info on farmers, tokenomics, spore, and more

2025-10-29 20:39:20 -04:00
parent a2a70b8213
commit 3097814409
7 changed files with 19798 additions and 4 deletions
--- a/docs/farming/advanced-nodes.md
+++ b/docs/farming/advanced-nodes.md
@@ -0,0 +1,164 @@
+---
+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 |
+
+### Cost and Earning Potential
+
+| **Parameter** | **Value** |
+|---------------|-----------|
+| **Purchase Price** | €400 (~$435 USD) |
+| **Guaranteed Monthly Earning** | €20/month (≈ 2,000 SPORE/month) |
+| **Break-even Time** | ~20 months |
+
+### 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 |
+
+### Cost and Earning Potential
+
+| **Parameter** | **Value** |
+|---------------|-----------|
+| **Purchase Price** | Premium pricing (varies by vendor) |
+| **Guaranteed Monthly Earning** | €66.67/month (≈ 6,667 SPORE/month) |
+| **Break-even Time** | Variable based on purchase price |
+
+### 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]
+```
+
+---
+
+## 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 |
+| **Purchase Price** | €400 | Premium | $350 |
+| **Monthly Earning** | 2,000 SPORE | 6,667 SPORE | 1,000-12,000 SPORE |
+| **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.
+:::
--- a/docs/farming/buy-node.md
+++ b/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 (up to 6,667 SPORE/month)
+- AI-optimized hardware for future workloads
+- Hybrid use options (private + hosting)
+
+**[Learn about Advanced Node Options](/getstarted/farming/advanced-nodes)** - Detailed specifications, pricing, and earning analysis
+
 ## Option 2: Build Your Own Node

 ### Why Build Your Own?
--- a/docs/farming/economics.md
+++ b/docs/farming/economics.md
@@ -0,0 +1,241 @@
+---
+sidebar_position: 4
+---
+
+# Farming Economics & SPORE Token
+
+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 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 | ↑ 11% scarcity |
+| Year 2 | 2 billion | 7 billion | ↑ 30% scarcity |
+| Year 3 | 3 billion | 6 billion | ↑ 40% scarcity |
+| Year 4 | 4 billion | 6 billion | ↑ 67% 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
+
+- **[SPORE Token Details](/getstarted/farming/economics)** - Deeper dive into tokenomics
+- **[Community Forum](https://forum.threefold.io)** - Discussions with experienced farmers
+- **[Market Data](https://stats.grid.tf)** - Real-time SPORE and network statistics
+- **[Farming Manual](https://manual.grid.tf/farmers)** - Technical implementation details
+
+---
+
+:::tip Ready to Start Earning?
+Set up your first node and begin earning SPORE today: **[Setup Guide](/getstarted/farming/setup)**
+:::
--- a/docs/farming/overview.md
+++ b/docs/farming/overview.md
@@ -24,11 +24,30 @@ As a **ThreeFold Farmer**, you:
 - Self-healing Zero-OS handles operations
 - No complex system administration needed

-### 💰 Multiple Revenue Streams
+### 💰 Real Earning Potential

- **Capacity Rewards** - Earn for available resources
- **Utilization Rewards** - Earn when your capacity is used
- **Growing Demand** - More workloads = more income potential
+As a farmer, you earn **SPORE tokens** for providing compute, storage, and network resources to the ThreeFold Grid.
+
+**Earning Potential by Node Type:**
+
+| **Node Type** | **Hardware Cost** | **Monthly Earning Range** | **Annual Potential** |
+|---------------|-------------------|---------------------------|---------------------|
+| **Mini 1** | $350 | 1,000–12,000 SPORE ($10–$120) | $120–$1,440 |
+| **Mini AI 1** | $2,000 | 5,000–60,000 SPORE ($50–$600) | $600–$7,200 |
+| **Nvidia 6000** | $15,000 | 39,000–450,000 SPORE ($390–$4,500) | $4,680–$54,000 |
+
+*SPORE price fixed at $0.01 until June 30, 2026*
+
+### How Revenue Works
+
+When users rent your node's resources, the payment is split:
+
+```mermaid
+graph LR
+    A[User Pays] --> B[80% to Farmer<br/>SPORE Tokens]
+    A --> C[10% Burned<br/>Increases SPORE Value]
+    A --> D[10% Mycelium<br/>Development]
+```

 ### 🌍 Make an Impact

@@ -36,6 +55,7 @@ As a **ThreeFold Farmer**, you:
 - Provide alternatives to centralized cloud providers
 - Contribute to digital sovereignty and data privacy
 - Build the peer-to-peer internet of the future
+- **Benefit from network growth** as SPORE becomes more valuable

 ## What You Need

--- a/docs/farming/setup.md
+++ b/docs/farming/setup.md
@@ -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?**
--- a/package-lock.json
+++ b/package-lock.json
--- a/sidebars.js
+++ b/sidebars.js
@@ -27,6 +27,8 @@ const sidebars = {
      items: [
        'farming/overview',
        'farming/buy-node',
+        'farming/advanced-nodes',
+        'farming/economics',
        'farming/setup',
      ],
    },