Files
docs_tfgrid_economics/docs/roadmap/liquidity-pools-overview.md
despiegk e01a48e251
Some checks failed
Deploy to GitHub Pages / Deploy to GitHub Pages (push) Has been cancelled
...
2025-10-11 08:14:32 +04:00

9.1 KiB

sidebar_position
sidebar_position
1

Liquidity Pools: Simplified Overview

Our ecosystem uses interconnected liquidity pools to manage the flow of value between tokens and external markets. This page provides a high-level understanding before diving into the detailed mechanics.

:::tip Start Here If you're new to the system, read this overview first. Then explore the detailed documentation on Position-Based Pools and Dutch Auction Exits. :::


The Big Picture: Three Pools

graph TB
    subgraph External["External World"]
        FIAT[💵 Fiat/USDC]
        TFT_MARKET[🌐 TFT Market]
    end
    
    subgraph Internal["ThreeFold Ecosystem"]
        TFT_LOCKED[🔒 Locked TFT]
        CC[💎 Cloud Credits CC]
        TFTF[📊 TFT Future TFTF]
        
        POOL1["Pool 1: TFT → CC<br/>(One-Way Entry)"]
        POOL2["Pool 2: CC ↔ TFTF<br/>(Internal Trading)"]
        POOL3["Pool 3: TFTF ↔ USDC<br/>(Controlled Exit)"]
    end
    
    TFT_MARKET -->|Buy TFT| POOL1
    POOL1 -->|Lock TFT<br/>Mint CC| CC
    
    CC <-->|Convert| POOL2
    POOL2 <-->|Based on TFT price| TFTF
    
    TFTF <-->|Dutch Auction<br/>5% cap, 20% discount| POOL3
    POOL3 <-->|Controlled bridge| FIAT
    
    style POOL1 fill:#e1f5ff
    style POOL2 fill:#fff4e1
    style POOL3 fill:#ffe1e1

Your Journey Through the System

1. Entry (Pool 1: TFT → CC)

What it does: Converts your TFT into stable Cloud Credits

How it works:

  • You bring TFT (purchased from market or earned from farming)
  • TFT gets locked (not sold, not converted - just held)
  • CC is minted at a fixed rate (currently 1 CC for 2 TFT)
  • You receive CC to spend on cloud services

Key point: This is a one-way swap. You can't directly convert CC back to TFT through this pool.

Example:

You have: 1,000 TFT
You deposit → 1,000 TFT gets locked
You receive → 500 CC (at 2:1 rate)
Your CC is pegged to gold (~$0.128 per CC as of Oct 2024)

2. Internal Movement (Pool 2: CC ↔ TFTF)

What it does: Lets you maintain TFT exposure while holding stable CC

How it works:

  • You earn CC from farming or have CC from services
  • You can convert CC to TFTF (TFT Future) based on current TFT market price
  • TFTF represents a claim on TFT value without holding actual TFT
  • You can convert back to CC when needed

Key point: This allows you to participate in TFT upside without immediately exiting to fiat.

Example:

You earned: 500 CC from farming
TFT market price: $0.10
You convert → 500 CC becomes 5,000 TFTF
If TFT rises to $0.15, your TFTF value increases
You can convert back to CC at any time

3. Exit to Fiat (Pool 3: TFTF ↔ USDC)

What it does: Provides a controlled bridge to cash out to fiat currency

How it works:

  • You submit a bid in the Dutch auction: amount + minimum acceptable price
  • Bids are sorted from lowest price to highest (most discount to least)
  • System fills bids until reaching the monthly cap (e.g., 5% of total liquidity)
  • Successful bidders receive USDC at the clearing price

Key point: This is controlled liquidity - not instant withdrawals. It protects the pool from being drained.

Example:

You want to exit: 10,000 TFTF (worth ~$1,000)
You're willing to accept: 20% discount minimum
Others bid: 15%, 18%, 22%, 25%, 30%
Clearing price: 22% (your bid gets filled)
You receive: $780 USDC (after 22% discount)
Margin benefit: Goes to remaining pool members

Traditional DeFi vs. Our Approach

Feature Traditional Liquidity Pools ThreeFold Position-Based Pools
LP Tokens Floating value tokens issued No tokens - fixed positions tracked
Your Share Changes with market volatility Fixed based on contribution + time
Exit Instant (swap LP tokens) Controlled (Dutch auction)
Impermanent Loss Yes - you lose value in volatile markets No - your position doesn't change
Gaming Risk Front-running, sandwich attacks Protected by time-weighting
Best For Active traders Long-term supporters

Why Three Pools?

Each pool serves a distinct purpose:

graph LR
    A[User Needs] --> B{What do you need?}
    
    B -->|Stable pricing for services| P1[Pool 1: TFT→CC<br/>Get stable credits]
    B -->|Keep TFT upside exposure| P2[Pool 2: CC↔TFTF<br/>Maintain position]
    B -->|Cash out for operations| P3[Pool 3: TFTF→USDC<br/>Controlled exit]
    
    style P1 fill:#e1f5ff
    style P2 fill:#fff4e1
    style P3 fill:#ffe1e1

Pool 1: Stability

Gives you predictable pricing for cloud services without exposure to TFT volatility.

Pool 2: Flexibility

Allows you to move between stable CC and TFT-linked TFTF based on your market outlook.

Pool 3: Liquidity

Provides real fiat exit when needed, with controls that protect all participants.


Visual Flow: Complete User Journey

graph TD
    START([👤 New User]) --> BUY[Buy TFT on Market]
    BUY --> ENTER[Enter Pool 1]
    ENTER --> LOCKED[TFT Locked + CC Minted]
    
    LOCKED --> USE{How to use CC?}
    
    USE -->|Spend on services| SERVICES[☁️ Use ThreeFold Cloud]
    USE -->|Hold as stable value| HOLD[💎 Keep CC]
    USE -->|Want TFT exposure| CONVERT[Convert to TFTF in Pool 2]
    
    SERVICES --> BURN[CC Burned by Network]
    HOLD --> WAIT[Wait for opportunities]
    CONVERT --> TFTF_HOLD[Hold TFTF Position]
    
    TFTF_HOLD --> TFTF_USE{What next?}
    TFTF_USE -->|Need stability again| BACK[Back to CC in Pool 2]
    TFTF_USE -->|Need fiat| EXIT[Enter Pool 3 Dutch Auction]
    
    EXIT --> BID[Submit bid with discount]
    BID --> AUCTION{Bid filled?}
    AUCTION -->|Yes| RECEIVE[Receive USDC]
    AUCTION -->|No| RETRY[Try next auction round]
    
    BACK --> LOCKED
    WAIT --> USE
    
    style START fill:#90EE90
    style RECEIVE fill:#90EE90
    style BURN fill:#FFB6C1

Key Protections Built In

1. No Unlimited Dumping

  • Exits are capped per period (e.g., max 5% of total liquidity)
  • Dutch auction requires accepting a discount
  • Protects all participants from sudden value crashes

2. Fair Distribution

  • Position-based tracking means early supporters aren't diluted
  • Time-weighting rewards long-term commitment
  • No front-running or gaming the system

3. Sustainable Liquidity

  • Only 50% of total contributed liquidity can ever exit via Dutch auctions
  • Margin from discounts gets redistributed to remaining participants
  • System strengthens with each exit, rather than weakening

4. Transparency

  • All positions are clearly tracked and visible
  • Rules are consistent and applied equally
  • No hidden fees or complex formulas

Common Questions

Can I get my TFT back immediately?

Not instantly. You need to:

  1. Convert CC to TFTF (Pool 2)
  2. Exit TFTF via Dutch auction (Pool 3) to USDC
  3. Buy TFT on the market with USDC if you want TFT again

The original TFT you deposited is locked to back the CC that was minted.

What if I just want stable income from farming?

Perfect! Just keep your earnings in CC. You get:

  • Stable value (pegged to gold)
  • No exposure to TFT market swings
  • Ability to convert to TFTF later if you want upside
How do I benefit from TFT price increases?

Convert your CC to TFTF in Pool 2. TFTF value tracks TFT market price, so if TFT goes up, your TFTF position becomes more valuable in CC or USDC terms.

What happens to the margin from Dutch auctions?

When someone exits at, say, a 25% discount, that 25% margin is collected and redistributed to all remaining liquidity providers proportionally. The longer you hold, the more you benefit from others exiting.

Is this like Uniswap or Curve?

Fundamentally different. Traditional AMMs use value-weighted pools with instant liquidity and impermanent loss. We use time-weighted, position-based pools with controlled exits and no impermanent loss. Trade-off: less instant liquidity, more fairness and protection.


Next Steps

Now that you understand the overall flow, dive deeper:

  1. Token System - Understand TFT, CC, and TFTF roles
  2. Position-Based Liquidity Pools - Learn why this approach is fair
  3. Dutch Auction Exit - See exactly how exits work with examples
  4. Yin-Yang Currency - The philosophy behind dual tokens

:::tip Simplified Summary

  • Pool 1: Get in (TFT → CC)
  • Pool 2: Move around (CC ↔ TFTF)
  • Pool 3: Get out (TFTF → USDC)

All three work together to give you stability, flexibility, and controlled liquidity. :::