yield farm docs

docs/basics/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "📚 Basics",
+  "position": 1,
+  "link": {
+    "type": "generated-index",
+    "description": "Learn the fundamentals that power the Arc Ecosystem"
+  }
+}

docs/basics/defi/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "📈 Defi",
+  "position": 1,
+  "link": {
+    "type": "generated-index",
+    "description": "Learn The Defi fundamentals that powers the Arc Ecosystem"
+  }
+}

docs/basics/defi/automated-market-makers.mdx

@@ -0,0 +1,73 @@
+---
+title: Automated Market Makers (AMMs)
+description: A fun, friendly explainer of Automated Market Makers—what they are, how pricing & fees work.
+sidebar_position: 2
+---
+
+import { BOTEGA, PERMASWAP } from '@arcaogaming/project-links';
+
+# AMMs — The Swap Engine Behind the $GAME
+
+Ever wondered how tokens get swapped in DeFi without any human in the middle?  
+Meet the **AMM (Automated Market Maker)** — your always-on, math-powered trading buddy.
+
+> ⚡ **TL;DR:** You trade tokens *with a pool*, not a person. The smart contract sets the price and takes a small fee. That's it.
+
+---
+
+## 🚀 30-Second Tour: How It Actually Works
+
+1. **Pool Party:** Tokens (like `$GAME` & `$AO`) live in a shared pool.  
+2. **Math Boss:** A formula (yup, `x * y = k`) calculates prices on the fly.  
+3. **No Middlemen:** No need for buyers/sellers to match. The pool handles it.  
+4. **Tiny Tolls:** Every swap pays a small fee — powering the protocol.
+
+---
+
+## 📈 Why Prices Move (The Slippage Shuffle)
+
+- **Constant-Product AMMs** (think Uniswap-style) always keep `x * y = k`.  
+- Buy `$GAME` → the pool holds **less `$GAME`** and **more `$AO`** → **`$GAME` gets pricier**.  
+- This dynamic = **slippage** (prices shift mid-swap) and **arbitrage** (traders balance AMM prices with the broader market).
+
+> 🧠 Think of the AMM as a *rubber band* — pull hard on one side, the other side stretches.
+
+---
+
+## 💸 Fees: The Tiny Tolls That Keep Things Running
+
+Fee tiers you’ll often see:
+
+- **0.01%–0.05%** for ultra-liquid or stable swaps  
+- **0.30%** — the classic  
+- **1.00%+** for exotic or spicy tokens  
+
+These fees are taken **per swap** and routed to the protocol’s stakeholders, treasury, or incentives.  
+If you're building pools, fee tiers directly shape **trader costs** and **pool earnings**.
+
+---
+
+## 🛠 Why Builders & Traders Love AMMs
+
+- **24/7 Liquidity** — No human needed, just smart contracts.  
+- **Composable Magic** — Drop them into dApps, routers, and aggregators.  
+- **Open-Source Brilliance** — Math you can trust, code you can verify.  
+- **Cross-Chain Friendly** — AMMs are everywhere, especially on EVMs.
+
+---
+
+## 🌐 Try AMMs Yourself
+
+Want to see AMMs in action? Check out these live examples:
+
+- <a href={BOTEGA} target="_blank">Botega</a>  
+- <a href={PERMASWAP} target="_blank">Permaswap</a>  
+
+See how price moves as you swap — the pool math at work in real time.
+
+---
+
+## 👉 Next Up
+
+- **[Liquidity Providing](./liquidity-providing.mdx)**  
+- **[$GAME Catalyst](/docs/investors/farming/yield-farming-game.mdx)**

docs/basics/defi/liquidity-providing.mdx

@@ -0,0 +1,112 @@
+---
+title: Liquidity Providing (LP)
+description: What LPing is, how fees work, where profits come from, core risks (incl. impermanent loss), and a simple mental model.
+sidebar_position: 3
+---
+
+# Liquidity Providing — Make Swaps Your Side Hustle
+
+If you’ve read about **[AMMs (Super Simple)](./automated-market-makers.mdx)**, you already know how swaps happen.  
+Now let’s flip to the other side: **becoming the one who *enables* swaps** and earns fees for it.  
+
+That’s **Liquidity Providing (LP)**. You deposit two tokens (like `$GAME` + `$AO`) into an AMM pool, and in return, you get a cut of every trade.  
+
+It’s like running a tiny, always-on market-making booth… without quitting your day job.  
+
+> ⚡ *TL;DR:* Put tokens in → earn a cut of every trade → let the fees flow.
+
+---
+
+## 🚀 How LPing Works (At a Glance)
+
+1. **Pick a Pool:** e.g., `$GAME / $AO` with a fee tier (0.05%, 0.30%, 1%+).  
+2. **Deposit Equal Value:** Both tokens, 50/50 style.  
+3. **Get LP Receipts:** A token or NFT proving your share.  
+4. **Traders Swap:** Every trade = fees trickling in.  
+5. **Exit Anytime:** Burn your LP receipt to withdraw your share.
+
+---
+
+## 💸 Where Your Yield Comes From
+
+- **Swap Fees:** Tiny % of every trade. (0.01–0.05%, 0.30%, 1%+ depending on pool).  
+- **Incentives (Optional):** Bonus rewards if pools offer them.  
+- **Compounding:** Reinvest fees/rewards → snowball into higher APY.  
+
+> 🧠 **Mental Model:** LPing = **short volatility, long volume.**  
+> - More swaps = more fees.  
+> - Wild price swings = more risk exposure.
+
+---
+
+## 📊 Fees & Volume (The Fun Part)
+
+- **Fee tier** sets both trader cost *and* your income.  
+- **High volume** is king — it drives fee APR.  
+- Bigger pools = lower slippage = more trades… but also more LPs sharing fees.  
+
+**Rule of Thumb:** A healthy pool = strong daily volume relative to TVL.
+
+---
+
+## ⚠️ Impermanent Loss (IL) — The Core LP Risk
+
+When prices drift apart, the AMM rebalances your tokens.  
+Sometimes, you’d have been richer just holding. That’s IL.  
+
+- **Lower IL:** Stable/pegged pairs.  
+- **Higher IL:** Volatile, uncorrelated pairs.  
+
+> ✏️ **Quick intuition:** If one token 2×’s vs the other, a 50/50 LP under constant-product rules loses ~5–6% vs HODL (before fees). Strong fees may offset this… but not guaranteed.
+
+**Mitigations:**  
+- Start with correlated pairs.  
+- Match fee tier to volatility.  
+- Don’t chase unsustainable yields.  
+- Monitor pool health & divergence.
+
+---
+
+## 🔢 Simple Walkthrough (Numbers Time)
+
+You LP with **$1,000 `$GAME` + $1,000 `$AO`** in a **0.30% pool**.  
+- Pool processes **$500,000** in swaps in a week.  
+- Fees = **$1,500** total.  
+- Your 2% share = **$30 fees** for that week.  
+- Final PnL depends on `$GAME` vs `$AO` price movement (IL could subtract, fees could outpace it).
+
+---
+
+## 🎟 What You Actually Hold
+
+- **LP Tokens (v2-style):** Fungible ERC-20 share of the pool.  
+- **NFT LP Positions (v3-style):** Define your price range. In-range = higher fee yield; out-of-range = nada.  
+
+> 📌 Always check pool docs for fee claiming + incentive options.
+
+---
+
+## ✅ Best-Practice Checklist
+
+- Start **small** — learn UX & risks first.  
+- Prefer **high-volume, sensible-fee** pools.  
+- Track **volume, fees, price moves** regularly.  
+- Harvest/compound on a **gas-friendly cadence**.  
+- ⚠️ Avoid unaudited “degen” farms unless you’re comfortable with full risk.  
+- ⚠️ Don’t overexpose to one pool/protocol. Diversify.
+
+---
+
+## 📚 Quick Glossary
+
+- **AMM:** Automated Market Maker (swap engine).  
+- **LP:** Liquidity Provider (you) or the position itself.  
+- **Fee Tier:** Swap cost setting (0.05%, 0.30%, etc.).  
+- **IL:** Impermanent Loss = underperformance vs HODL.  
+- **TVL:** Total Value Locked in a pool/protocol.
+
+---
+
+## 👉 Next Up
+
+- **[$GAME Catalyst](/docs/investors/farming/yield-farming-game.mdx)**

docs/game-developers/arcao-sdk.mdx

@@ -1,12 +1,12 @@
 ---
-title: ArcAO SDK
+title: Arc SDK
 description: Integrative support for ArcAO games
 sidebar_position: 2
 ---
 import { RUNEREALM, ARCAO } from '@arcaogaming/project-links';
 
 # 🧰 ArcAO SDK  
-## *Plug Into the Power of ArcAO*
+## *Plug Into the Power of Arc*
 
 The **ArcAO SDK** delivers seamless integration and robust developer tools to support every game in the ArcAO ecosystem.  
 Whether you're building from scratch or enhancing an existing title, our SDK has you covered.

docs/intro.md → docs/intro.mdx

@@ -1,5 +1,5 @@
 ---
-title: Start Here
+title: 👉 Start Here
 description: The AAA Game Development DAO leading the GameFi Revolution.
 sidebar_position: 1
 slug: /

docs/investors/bridging/_category_.json

@@ -1,6 +1,6 @@
 {
   "label": "🌉 Bridging",
-  "position": 1,
+  "position": 3,
   "link": {
     "type": "generated-index",
     "description": "How To Bridge Assets In And Out Of AO The Computer on Arweave"

docs/investors/buying/_category_.json

@@ -1,6 +1,6 @@
 {
   "label": "🤑 Buying",
-  "position": 1,
+  "position": 4,
   "link": {
     "type": "generated-index",
     "description": "How To BUY $GAME on AO The Computer on Arweave"

docs/investors/buying/buying.mdx → docs/investors/buying/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: Buying $GAME on AO The Computer
+title: Start Here
 description: <Insert description here>
 sidebar_position: 1
 ---

docs/investors/farming/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "🧺 Farming",
+  "position": 5,
+  "link": {
+    "type": "generated-index",
+    "description": "How To Farm $GAME on AO The Computer on Arweave"
+  }
+}

docs/investors/farming/overview.mdx

@@ -0,0 +1,22 @@
+---
+title: Start Here
+description: Your GameFi journey starts here — learn AMMs, Liquidity Providing, and then begin with the $GAME Catalyst.
+sidebar_position: 1
+---
+
+# Your GameFi Journey Starts Here 🎮
+
+Before unlocking the **[$GAME Catalyst](/docs/investors/farming/yield-farming-game.mdx)**, there are two core mechanics to understand:  
+
+- **[AMMs (Super Simple)](/docs/basics/defi/automated-market-makers.mdx)** — the swap engines of DeFi, where math + pools replace order books.  
+- **[Liquidity Providing (LP)](/docs/basics/defi/liquidity-providing.mdx)** — how you deposit tokens into AMMs to earn fees (and face risks like impermanent loss).  
+
+Master these basics, and you’ll be ready to take on the **[$GAME Catalyst](/docs/investors/farming/yield-farming-game.mdx)** — Arc’s farming engine that rewards liquidity providers and powers the $GAME ecosystem.  
+
+---
+
+## 👉 Next Steps
+
+- **[AMMs (Super Simple)](/docs/basics/defi/automated-market-makers.mdx)**  
+- **[Liquidity Providing (LP)](/docs/basics/defi/liquidity-providing.mdx)**  
+- **[$GAME Catalyst](/docs/investors/farming/yield-farming-game.mdx)**

docs/investors/farming/yield-farming-game.mdx

@@ -0,0 +1,59 @@
+---
+title: 💎 $GAME Catalyst
+description: How $GAME Catalyst works — LP-backed tokens that generate yield and fuel the $GAME ecosystem.
+sidebar_position: 2
+---
+
+import {  RUNEREALM, GAME } from '@arcaogaming/project-links';
+
+
+# 💎 $GAME Catalyst
+
+The **$GAME Catalyst** is your ticket into Arc’s liquidity engine.  
+It represents a share of liquidity in pools like **Permaswap** or **Botega**, which generate LP yield over time from trading volume.  
+
+> ⚡ Before diving in, make sure you understand the **[risks of Liquidity Providing](/docs/basics/defi/liquidity-providing.mdx)**.
+
+---
+
+## 🔑 How It Works
+
+1. **LP-Backed Tokens** — $GAME Catalyst tokens = your proportional share of an LP position.  
+2. **Yield Generation** — As swaps happen, fees accumulate, boosting the value of your Catalyst position.  
+3. **Automated Buybacks** — Revenue from Arc **$GAMES** (like <a href={RUNEREALM.website} target="_blank">RuneRealm Onchain</a>) — paid in `$AO`, `$AR`, or `$USDC` — is funneled back into $GAME via automated **½ buybacks + liquidity pairing**.  
+4. **Ecosystem Support** — This revenue is recycled into **$GAME Catalyst tokens**, which flow back to the community and projects.
+
+---
+
+## 🌍 Who Benefits from Catalyst?
+
+- **Ecosystem Projects** — Receive Catalyst tokens as liquidity support for growth.  
+- **Arc Ambassadors** — Funded through [the Ambassador Program](/docs/content-creators/ambassador-program.mdx), rewarding community members for contributions.  
+- **Players** — Can play Arc games like <a href={RUNEREALM.website} target="_blank">RuneRealm Onchain</a> to earn $GAME, which fuels more Catalyst liquidity.  
+
+---
+
+## ♻️ Shared Redemption Model
+
+Whether you’re a project, ambassador, or player, **Catalyst tokens are always hedged** (½ $GAME, ½ pair).  
+At any time, holders can **redeem Catalyst tokens** back into the underlying LP tokens.  
+
+This makes Catalyst positions more balanced, reducing one-sided risk while keeping liquidity strong.
+
+---
+
+## 🎮 Why It Matters
+
+- **Sustainable Liquidity** — Pools deepen as Catalyst revenue flows in.  
+- **Aligned Incentives** — Builders, ambassadors, and players all share the same liquidity engine.  
+- **Flexibility** — Catalyst tokens can always be unwrapped into the base LP tokens.  
+
+---
+
+<a href={GAME.yieldFarming} target="_blank">
+  <img
+    alt="$GAME Catalyst - Start Now"
+    src="https://img.shields.io/badge/$GAME%20Catalyst-%F0%9F%92%8E%20Start%20Now-4ade80?style=for-the-badge"
+  />
+</a>
+

docs/investors/minting/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "🪙 Minting",
+  "position": 2,
+  "link": {
+    "type": "generated-index",
+    "description": "Resources and documentation for investors in the ArcAO ecosystem."
+  }
+}

docs/investors/how-to-yield-game-token.mdx → docs/investors/minting/how-to-yield-game-token.mdx

@@ -1,7 +1,7 @@
 ---
 title: How to Yield Arc $GAME Token
 description: A Step-by-Step Guide to Yielding ArcAO's $GAME Token via ETH/DAI Delegation
-sidebar_position: 2
+sidebar_position: 3
 ---
 
 import { RUNEREALM, ARCAO, AO } from '@arcaogaming/project-links';