diff --git a/docs/core-concepts/_category_.json b/docs/core-concepts/_category_.json index 6f8b8ab..dc9cf16 100644 --- a/docs/core-concepts/_category_.json +++ b/docs/core-concepts/_category_.json @@ -3,6 +3,6 @@ "position": 2, "link": { "type": "generated-index", - "description": "Fundamental mechanisms of the TFT minting transition plan." + "description": "Fundamental mechanisms for TFGrid 4.0." } -} +} \ No newline at end of file diff --git a/docs/core-concepts/liquidity-pool.md b/docs/core-concepts/liquidity-pool.md index d4f115e..4be15b6 100644 --- a/docs/core-concepts/liquidity-pool.md +++ b/docs/core-concepts/liquidity-pool.md @@ -13,18 +13,18 @@ We want to launch the liquidity pools 1-1-2026 ### CC-TFT - **Function**: Enables conversion between TFT and CC, its a position based liquidity pool. -- **Source of Funds**: Only CC generated from revenue can be converted into TFTF -- **Purpose**: Facilitates internal settlements and allows revenue to be converted into an asset (TFTF) that reflects the market value of TFT +- **Source of Funds**: Only CC generated from revenue can be converted into TFP +- **Purpose**: Facilitates internal settlements and allows revenue to be converted into an asset (TFP) that reflects the market value of TFT - **Flexibility**: Allows users to maintain TFT exposure while holding stable CC ### CC-USDC Pool -- **Function**: Provides a controlled bridge between the internal ecosystem (TFTF) and an external stablecoin (USDC) +- **Function**: Provides a controlled bridge between the internal ecosystem (TFP) and an external stablecoin (USDC) - **Purpose**: Enables fiat exit for operational needs while protecting against system drainage **Rules:** -- **Dutch Auction Principles**: The pool operates based on [Dutch auction mechanics](./dutch-auction-exit.md) +- **Dutch Auction Principles**: The pool operates based on [Dutch auction mechanics](/roadmap/dutch-auction-exit) - **Liquidity Cap**: No more than 5% of the USDC liquidity in the pool can be used in a single transaction or period to prevent dramatic price shifts - **Minimum Margin**: A minimum discount of 20% is maintained, ensuring a margin for the pool -- **Position-Based Pool**: The pool's mechanics are based on its current position and liquidity. More info at [Position Based LP](./position-based-lp.md) +- **Position-Based Pool**: The pool's mechanics are based on its current position and liquidity. More info at [Position Based LP](/roadmap/position-based-lp) diff --git a/docs/core-concepts/token-system.md b/docs/core-concepts/token-system.md index f0b3691..455d197 100644 --- a/docs/core-concepts/token-system.md +++ b/docs/core-concepts/token-system.md @@ -8,10 +8,12 @@ Our ecosystem uses a multi-currency system to ensure both stability for utility ## Token Types -## TFP (ThreeFold Point) = is same as TFT but only exists in the marketplace +### TFP (ThreeFold Point) -- **Definition**: TFP is a converted TFT and only exists within the marketplace ecosystem for internal accounting and settlements. -- 1 TFP = 1 TFT (at time of conversion) +> is same as TFT but only exists in the marketplace + +- **Definition**: TFP is a TFT which only exists within the marketplace ecosystem for internal accounting and settlements. +- 1 TFP = 1 TFT - TFP cannot be converted back to TFT until the market price of TFT exceeds the fixed conversion rate of CC to TFP (see below in swap section). - in other words if on public markets the TFT is prices higher than 1 CC in USD value then you can convert back. - Once the market price surpasses the fixed rate, users can return TFP to unlock their original TFT. @@ -56,7 +58,7 @@ Our ecosystem uses a multi-currency system to ensure both stability for utility ## Link to Revenue -- Farmers (farmers) are paid in TFP, which they can convert to TFT or hold for potential appreciation (80% of revenue) +- 80% of revenue goes to Farmers (as TFP) - 10% of revenue is burned to reduce supply and maintain peg stability, burned TFT. - 10% of revenue goes to ThreeFold Foundation for ecosystem development and maintenance diff --git a/docs/faq.md b/docs/faq.md new file mode 100644 index 0000000..6835330 --- /dev/null +++ b/docs/faq.md @@ -0,0 +1,277 @@ +--- +sidebar_position: 1 +slug: /faq +--- + +# Frequently Asked Questions + +## Token System + +
+What are the different types of tokens in the ThreeFold ecosystem? + +The ThreeFold ecosystem uses a multi-currency system with three distinct token types: + +1. **TFP (ThreeFold Point)** + - Exists only within the marketplace for internal accounting and settlements + - 1 TFP = 1 TFT + - Cannot be converted back to TFT until the market price of TFT exceeds the fixed conversion rate of CC to TFP + - When users convert to TFP, their TFT is locked until they return TFP to unlock their TFT + +2. **TFT (ThreeFold Token)** + - Tradable reserve asset traded on public blockchains + - Price can be volatile + - Scarce, capped at 1 billion maximum + - Not directly usable inside the marketplace, must be converted to TFP first + +3. **CC (Cloud Credit)** + - Stable utility token pegged to 1/1000 of a gram of gold (0.001g) + - Only circulates within the digital marketplace (non-tradable) + - Primary medium of exchange for services within the ecosystem + - Generated when users enter with TFT or credit card, burned when exiting +
+ +
+How do the token swaps work? + +There are several types of swaps in the ThreeFold ecosystem: + +1. **TFP to CC Swap (both directions)** + - Allows users to swap TFP for CC at a fixed rate + - Users can acquire CC at a fixed rate of 1 CC for 2 TFP until the market price of TFP surpasses this rate + - Open question: maybe it should be 1 CC = 1 TFP + +2. **USD to CC Swap (one way)** + - Allows users to purchase CC directly with USD via credit card + - Fixed rate of 1 CC = $0.128 (as of Oct 8, 2025, changes as the price of gold changes) + - USD collected is held in a treasury to back the CC in circulation +
+ +
+How is revenue distributed in the ThreeFold ecosystem? + +Revenue distribution in the ThreeFold ecosystem follows this model: +- 80% of revenue goes to Farmers (as TFP) +- 10% of revenue is burned to reduce supply and maintain peg stability +- 10% of revenue goes to ThreeFold Foundation for ecosystem development and maintenance +
+ +
+Why does ThreeFold use a multi-token system? + +The multi-token architecture solves several critical problems: +- **Price Stability**: CC provides predictable pricing for services (pegged to gold) +- **Market Opportunity**: TFT remains tradable with upside potential +- **Controlled Liquidity**: Prevents sudden token dumps while maintaining fairness +- **Sustainable Growth**: Minting/burning mechanisms ensure backing and prevent inflation +- **Operational Viability**: Farmers receive stable CC for planning while retaining TFT exposure options +
+ +## Burning Mechanism + +
+What is token burning and how does it work? + +Token burning permanently removes tokens from circulation. When a percentage of real revenue is used to buy and burn tokens, it directly reduces the total supply, creating scarcity. If demand stays constant or increases, the token price naturally rises. + +In the ThreeFold ecosystem: +- 10% of all generated revenue is used to purchase tokens on the open market and destroy them +- This converts real economic activity into direct buying pressure +- As supply decreases, each remaining token represents a larger claim on the network's total value +
+ +
+What are the base assumptions for the burning mechanism? + +The base assumptions for the burning mechanism are: +- TFT Price (initial): $0.10 +- Market Cap (Fully Diluted): $100,000,000 +- Burn on Revenue: 10% +- Revenue over 4 years: $1,000,000,000 +- Tokens Burned: $100,000,000 worth of tokens +- Market Size Reference: Cloud & AI markets worth several trillion USD + +The conclusion is that there can never be 0 tokens in a functioning economy, so the price will keep rising as supply decreases. +
+ +## Node Economics + +
+What is a ThreeFold farmer? + +A farmer is an individual or entity that operates one or more "nodes" on the ThreeFold Grid. A node is essentially a physical or certified compute machine that provides resources like CPU, memory, and storage to the network. By making these resources available, farmers become integral to the decentralized cloud, enabling users worldwide to deploy applications, store data, and run various workloads without relying on centralized providers. +
+ +
+How do farmers make money? + +Farmers earn income by renting out "slices" of their nodes: +1. Farmers invest in hardware to set up their nodes and connect them to the ThreeFold Grid +2. They can divide their nodes into multiple slices with allocated resources +3. Farmers can set their own pricing within a defined minimum and maximum range +4. When a user reserves a slice, the farmer earns income with an 80/10/10 split: + - 80% goes directly to the farmer + - 10% is burned to reduce token supply + - 10% goes to ThreeFold for protocol development and maintenance +
+ +
+ +How does the decentralized marketplace work? + +The ThreeFold Grid operates as a decentralized marketplace where farmers and users interact directly: +1. Farmers offer resources by listing their available node slices with specifications and pricing +2. Users browse available resources and reserve slices for specific durations +3. The marketplace supports dynamic pricing where prices adjust based on reservation length +4. ThreeFold sets "Bid Tiers" for various slice types to ensure baseline demand +5. Smart contracts on the ThreeFold blockchain handle reservations and payments +
+ +## Liquidity Pools + +
+Can I get my TFT back immediately after converting to CC? + +Not instantly. The process requires: +1. Convert CC to TFP (TFP) in Pool 2 +2. Exit TFP via Dutch auction in Pool 3 to receive USDC +3. Buy TFT on the open 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? + +You can keep your earnings in CC for: +- Stable value (pegged to gold) +- No exposure to TFT market swings +- Ability to convert to TFP later if you want upside potential +
+ +
+How do I benefit from TFT price increases? + +Convert your CC to TFP. TFP value tracks TFT market price, so if TFT goes up, your TFP position becomes more valuable in CC or USDC terms. + +
+ +## Yin-Yang Currency Philosophy + +
+
+How is the liquidity pool different from traditional DeFi pools? + +The ThreeFold position-based liquidity pools are fundamentally different from traditional DeFi pools: + +| 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 | + +The ThreeFold approach prioritizes fairness and long-term contribution over market speculation. +
+ +
+How does the Dutch auction exit mechanism work? + +The Dutch auction exit mechanism works as follows: + +1. **Bids Are Submitted**: LPs submit requests with amount and minimum acceptable price +2. **Bids Are Sorted**: Ranked from lowest price to highest (those willing to accept biggest discount first) +3. **Clearing Price Is Found**: System fills bids from bottom up until reaching allowed maximum +4. **Settlement**: Successful LPs receive their share of the paired token at the clearing price + +Key principles: +- No timing advantage - when you bid doesn't matter, only the price you're willing to accept +- Price determines priority - bigger discounts get filled first +- Capped exit volume - only up to 50% of total liquidity can leave through Dutch auctions +
+ +
+What is position-based liquidity pooling? + +Position-based liquidity pooling tracks contributions differently than traditional pools: + +- Every liquidity contribution is recorded as a fixed position with: + - Token type (e.g., USDC, TFT) + - Contribution amount + - Timestamp + +- No floating LP tokens are issued +- Share is determined by how much you contributed and how early you contributed +- Positions don't change with price fluctuations +- No impermanent loss like in traditional DeFi pools +
+ +
+How does margin redistribution work in the liquidity pools? + +When liquidity providers exit through the Dutch auction: +- The margin between what a bidder was willing to accept and the final clearing price is collected by the pool +- This margin is aggregated across all filled bids and shared among remaining liquidity providers +- Distribution is proportional to each LP's share of the total liquidity +- The longer you hold, the more you benefit when others leave +
+ + +What is the philosophical foundation behind the dual token system? + +The ThreeFold token system is philosophically rooted in economist Bernard Lietaer's concept of complementary currencies: + +**Yang Currencies**: +- Conventional, national currencies (e.g., dollar, euro, yen) +- Promote competition, scarcity, hierarchy, and analytical thinking +- Efficient for global trade and industrial economic activities + +**Yin Currencies**: +- Complementary or community currencies +- Foster cooperation, egalitarian relationships, quality of life, sustainability, and social trust +- Thrive within bounded communities where circulation reinforces social cohesion + +In the ThreeFold system: +- TFT serves as the Yang currency (tradable, scarce, market-driven) +- CC serves as the Yin currency (stable, community-focused, cooperative) +
+ +
+Why are both Yin and Yang currencies important? + +Lietaer presents Yin and Yang currencies as complementary tools rather than antagonistic systems: + +- Societies that incorporate both systems are typically more resilient and socially robust +- The dual structure aims to: + - Preserve market efficiency and investment potential (Yang) + - Enable stable, community-oriented value exchange (Yin) + - Create resilience through complementarity + - Balance speculation with sustainability + +Real-world examples like Bali's dual system and Japan's care economy demonstrate how both currency types can solve multiple community needs. +
+ +## Implementation and Roadmap + +
+When will the liquidity pools be launched? + +The liquidity pools are planned to launch on January 1, 2026. +
+ +
+What protections are built into the liquidity system? + +Several key protections ensure sustainability: + +1. **No Unlimited Dumping**: Exits are capped per period (e.g., max 5% of total liquidity) and require accepting a discount +2. **Fair Distribution**: Position-based tracking means early supporters aren't diluted, with time-weighting rewarding long-term commitment +3. **Sustainable Liquidity**: Only 50% of total contributed liquidity can ever exit via Dutch auctions, with margin benefits redistributed to remaining participants +4. **Transparency**: All positions are clearly tracked and visible with consistent rules applied equally +
+ +--- + +*This FAQ is regularly updated to reflect the latest information about ThreeFold's token economics. For the most current details, always refer to the official documentation.* diff --git a/docs/implementation-roadmap.md b/docs/implementation-roadmap.md index c20529d..1672e83 100644 --- a/docs/implementation-roadmap.md +++ b/docs/implementation-roadmap.md @@ -1,34 +1,31 @@ --- -sidebar_position: 2 +sidebar_position: 3 --- # Implementation & Roadmap :::info Community Update -This page shares what we know **right now** about the implementation status and roadmap. We're committed to transparency with the community, even when some details are still being finalized. More information will be shared as it becomes available. +This page shares what we know **right now** about the implementation status and roadmap. **Join the discussion**: Share your feedback in the [forum thread](https://forum.threefold.io/t/tft-minting-transition-plan-community-e-book/4647). ::: -## Current Status Overview - -We're making significant progress on multiple fronts to deliver a sustainable, farmer-friendly ecosystem. Here's where we stand on the key components mentioned in our recent community discussions. - ---- ## Token Economics: Proposed Solution -We've designed a comprehensive solution to the token economics challenge. The mechanisms are described in this e-book: +We've designed a comprehensive solution to the token economics. - **Dual Token System**: TFT (tradable) and Cloud Credits (stable utility) - [Learn more](/core-concepts/token-system) -- **Controlled Liquidity**: Dutch auction mechanism prevents dumping - [Details](/core-concepts/dutch-auction-exit) -- **Fair Distribution**: Position-based pools reward long-term commitment - [Read more](/core-concepts/position-based-lp) -The system is designed and ready for implementation with the marketplace features below. +### Phase 2 : Q1 2026 + +- **Controlled Liquidity**: Dutch auction mechanism prevents dumping - [Details](/roadmap/dutch-auction-exit) +- **Fair Distribution**: Position-based pools reward long-term commitment - [Read more](/roadmap/position-based-lp) + --- -## Marketplace Implementation 🚧 +## Marketplace Implementation ### Stable Cloud Credit Currency @@ -47,11 +44,6 @@ Cloud Credits (CC) provide the stable utility currency needed for day-to-day ope farmers will be able to set their own pricing for capacity: -- **Flexible Pricing**: Set competitive rates for your node's resources -- **Market-Driven**: Respond to demand and differentiate your offerings -- **Integration**: Works alongside ThreeFold's standard bid packages -- **Transparency**: Clear pricing visible to potential customers - :::note This feature is being designed to balance farmer autonomy with marketplace consistency. ::: @@ -79,7 +71,7 @@ The slices system provides better node partitioning: - **Clear Pricing**: Each slice has defined resources and pricing - **Flexible Scaling**: Users can consume exactly what they need -This is part of the TFGrid v4 rollout. See the [Node Economics section](/node-economics/slices-overview) for detailed specifications and pricing. +This is part of the TFGrid v4 rollout. --- @@ -102,41 +94,42 @@ A marketplace where users can bid on capacity and farmers can accept offers: We're providing clear visibility into farmer economics: -- **Pricing Calculators**: Estimate income based on node specs - See [pricing models](/node-economics/pricing-model) +- **Pricing Calculators**: Estimate income based on node specs - **Revenue Projections**: Min/max income scenarios documented - **Cost Transparency**: Hardware costs amortized over 5-year lifespan - **ROI Models**: Clear break-even and profit projections -The [Node Specifications](/node-economics/node-specifications) page provides detailed income projections for various node configurations. - --- -## Dutch Auction Liquidity Pool - -**Status**: Design Complete | Smart Contract Development in Progress - -The controlled liquidity mechanism that protects the ecosystem: - -- **Exit Controls**: Maximum 50% of contributed liquidity can exit via auctions -- **Fair Pricing**: Market-driven clearing price ensures fairness -- **Pool Protection**: Minimum discounts maintain pool sustainability -- **Margin Redistribution**: Remaining LPs benefit when others exit - -Read the full [Dutch Auction Exit Mechanism](/core-concepts/dutch-auction-exit) for details. - ---- ## Infrastructure Development -### Kubernetes Cloud +### Mycelium Cloud **Status**: Complete ✅ -The Kubernetes cloud is operational and uses TFT underneath: +The Mycelium cloud is operational and uses TFT underneath: - **Production Ready**: Deployed and available for workloads -- **TFT-Powered**: Runs on the token economics described in this plan -- **Waiting On**: Marketplace features above before major marketing push + +> https://myceliumcloud.tf + +### Whats next for Mycelium Cloud + +- **More Nodes**: Expand the network with additional nodes +- Attach CC and minimal marketplace to it. + +## Mycelium Network + +**Status**: Complete ✅ + +The global Mycelium network is live and functional + +### Whats next for Mycelium Network + +- Need to add more nodes +- Invite more people to join +- Need to attach CC to it (basically the bandwidth should not be free but paid in CC, TFP underneath). ### TFGrid v4 & ZOS v4 @@ -162,13 +155,13 @@ We're expanding the network with quality infrastructure: - **Goal**: More high-quality, high-performance nodes - **Priority**: Significantly more GPU capacity for AI workloads - **Partnerships**: Working with hardware providers and farmers -- **See**: [Certified nodes coming Q4 2025](/node-economics/node-specifications#certified-nodes-q4-2025) including dedicated AI configurations +- **See**: Certified nodes coming Q4 2025 including dedicated AI configurations --- ## End-User Applications -**Status**: Teams Working On It 🚀 +**Status**: Teams Working On It Applications being built on top of TFGrid: @@ -187,31 +180,25 @@ Specific applications and partners will be announced as they reach appropriate m ### Who Are the Offtakers? -We're in discussions with several potential high-volume customers, but cannot share specific names at this stage due to: +We're in discussions with several potential high-volume customers, but cannot share specific names at this stage. -- **Confidentiality agreements** during negotiation phases -- **Competitive sensitivity** in the cloud services market -- **Deal contingencies** that haven't been finalized +- ICA is one of them, see http://ica.coop +- ThreeFold itself, we will be a significant user of capacity for its own operations and services as well as for its partners where we have direct relationships with. -### Why Can't We Share Details Yet? - -Standard business practice in enterprise sales: - -- Partners often require NDAs until public announcements -- Premature disclosure can jeopardize negotiations -- We want to announce confirmed commitments, not speculative discussions +ThreeFold will start to order capacity whenever minimal marketplace features are live. ### How Much Capacity Will They Take? -This depends on: +- orders of magnitude more than what's available today. + +Requirements before we can get started: - **Marketplace readiness**: Features listed above need to be live - **Network capacity**: Sufficient GPU and high-performance nodes - **Application maturity**: End-user apps that drive demand -- **Pricing competitiveness**: Market rates for comparable services :::note Transparency Commitment -We will share offtaker information and capacity commitments **as soon as commercially appropriate**. This community's trust matters to us, and we're balancing transparency with business realities. +We will share offtaker information and capacity commitments **as soon as commercially appropriate**. ::: --- @@ -249,12 +236,12 @@ We will share offtaker information and capacity commitments **as soon as commerc | Token Economics Design | ✅ Designed | Awaiting implementation | | Slices System | 🚧 Designed | Part of TFGrid v4 | | Kubernetes Cloud | ✅ Running | Now | -| Dutch Auction Mechanism | 🚧 In Development | Q4 2024 | -| Marketplace Features | 🚧 In Development | Q4 2024 - Q1 2025 | -| TFGrid v4 / ZOS v4 | 🚧 In Development | 2-3 months | | GPU Node Expansion | 🔨 Active Effort | Ongoing | | End-User Applications | 🔨 Active Development | Q1-Q2 2025 | | Offtaker Announcements | 🔒 Under NDA | When commercially ready | +| Dutch Auction Mechanism | 🚧 In Development | Q4 2024 | +| Marketplace Features | 🚧 In Development | Q4 2024 - Q1 2025 | +| TFGrid v4 / ZOS v4 | 🚧 In Development | 2-3 months | :::tip Stay Updated Join the discussion and get the latest updates as implementation progresses: diff --git a/docs/intro.md b/docs/intro.md index 0b0d23c..f56f3f7 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -3,9 +3,11 @@ sidebar_position: 1 slug: / --- -# TFT Minting Transition Plan +# TFGrid 4 Economics -Welcome to the **TFT Minting Transition Plan** community e-book. This document outlines the proposed changes to the ThreeFold Token (TFT) minting system and introduces a new liquidity framework designed to create sustainable value for all participants. +Welcome to the **TFGrid 4 Economics** community e-book. + +This document outlines the proposed changes to the ThreeFold Grid and the utilization of its Token (TFT) and introduces a new liquidity framework designed to create sustainable value for all participants. ## Purpose @@ -22,10 +24,8 @@ The transition plan introduces several interconnected concepts: - **Implementation Status & Roadmap**: Current progress on marketplace features, infrastructure, and timeline - **Dual Token System**: TFT as a tradable asset and Cloud Credits (CC) as a stable utility token -- **Position-Based Liquidity Pools**: A fair, time-weighted approach to rewarding contributors -- **Dutch Auction Exit Mechanism**: Controlled, sustainable liquidity with built-in protections -- **Yin-Yang Currency Philosophy**: Balancing market efficiency with community cooperation - **Node Economics & Pricing**: Detailed specifications, income projections, and ThreeFold's capacity commitments +- **Marketplace Mechanics**: How users interact with the system, including swaps and liquidity pools: TODO :::info Work in Progress This plan represents our current thinking but is **not finalized**. We are actively seeking community input to refine and improve these mechanisms. @@ -39,7 +39,7 @@ We acknowledge there are still important decisions to be made and gaps to fill. ### Key Areas We're Seeking Feedback On: -- **Entry Price**: Should the fixed TFT to CC conversion rate be **$0.05** or **$0.01** per TFT? +- **Entry Price**: Should the fixed TFT to CC conversion rate be 1 or 2 TFT per CC? - **Peg Currency**: Should Cloud Credits be pegged to **gold** (1/1000 gram) or **USD**? - **Liquidity Pool Parameters**: - What should the maximum exit percentage per period be? @@ -77,15 +77,7 @@ Your experience and perspective are valuable to making this plan work for everyo 2. **Refinement**: Based on input, we'll update and clarify the plan 3. **Community Call**: Interactive session to discuss and answer questions 4. **Finalization**: Incorporate feedback and prepare for implementation -5. **Migration**: Clear timeline and process for moving from v3 to v4 -## How to Read This Documentation - -- **Implementation & Roadmap**: See what's happening now and what's coming soon -- **Core Concepts**: Understand the fundamental token and liquidity mechanisms -- **Node Economics**: Explore farmer income models, pricing, and capacity commitments -- **Appendix**: Meeting notes and detailed technical discussions for transparency -- **Operations**: Technical documentation for deployment and maintenance :::tip Get Started Ready to dive in? Start with the [Token System](/core-concepts/token-system) to understand the foundational architecture. diff --git a/docs/node-economics/bids.md b/docs/node-economics/bids.md index 20c21df..163e4de 100644 --- a/docs/node-economics/bids.md +++ b/docs/node-economics/bids.md @@ -2,7 +2,9 @@ sidebar_position: 3 --- -# Bidding on ThreeFold Grid Capacity: Ensuring Farmer Revenue +# Bidding + +> Ensuring Farmer Revenue The ThreeFold Grid's decentralized marketplace introduces a robust bidding system that allows not only ThreeFold itself but also other entities to bid on available compute, storage, and network capacity. This mechanism is crucial for farmers, as it provides a proactive way to secure revenue and optimize node utilization without solely relying on direct customer reservations. @@ -12,7 +14,7 @@ The bidding system enables various parties to express their demand for specific 1. **ThreeFold's Role as a Bidder:** * ThreeFold, as the protocol developer and ecosystem facilitator, often places bids on capacity to ensure the grid has sufficient resources for its own operations, strategic partnerships, or to bootstrap demand for new node types. - * These bids are typically structured as "Bid Tiers," as seen in the `overview.md` document. These tiers specify a certain number of nodes or slices with defined minimum performance, memory, and GPU requirements, along with a set price per month. This provides a stable revenue stream for farmers whose nodes meet these specifications. + * These bids are typically structured as "Bid Tiers". These tiers specify a certain number of nodes or slices with defined minimum performance, memory, and GPU requirements, along with a set price per month. This provides a stable revenue stream for farmers whose nodes meet these specifications. 2. **Other Entities as Bidders:** * Beyond ThreeFold, other large-scale users, enterprises, or even decentralized applications (dApps) can place bids for significant amounts of capacity. This could be for long-term infrastructure needs, burst capacity for specific events, or to secure resources for their own user base. diff --git a/docs/node-economics/explanation.md b/docs/node-economics/explanation.md index ca6cba4..0c029d6 100644 --- a/docs/node-economics/explanation.md +++ b/docs/node-economics/explanation.md @@ -2,7 +2,9 @@ sidebar_position: 2 --- -# Node Economics Explained: How Farmers Earn and the Decentralized Marketplace +# Node Economics Explained + +> How Farmers Earn and the Decentralized Marketplace The ThreeFold Grid offers a unique opportunity for individuals, known as "farmers," to monetize their hardware by contributing to a global, decentralized cloud infrastructure. This document explains the core economic principles, how farmers generate income, and the role of the decentralized marketplace. diff --git a/docs/node-economics/overview.md b/docs/node-economics/overview.md index c5dafd0..06f0569 100644 --- a/docs/node-economics/overview.md +++ b/docs/node-economics/overview.md @@ -2,7 +2,9 @@ sidebar_position: 1 --- -# Example Node Configurations (Q4 2025) +# Example Node Configurations + +> Q4 2025 ![alt text](img/node_overview.png) diff --git a/docs/roadmap/dutch-auction-exit.md b/docs/roadmap/dutch-auction-exit.md index 0743fee..4f29243 100644 --- a/docs/roadmap/dutch-auction-exit.md +++ b/docs/roadmap/dutch-auction-exit.md @@ -2,7 +2,9 @@ sidebar_position: 4 --- -# Dutch Auction Exit: Fair and Controlled Liquidity Release +# Dutch Auction Exit + +> Fair and Controlled Liquidity Release To keep our liquidity pool strong and sustainable, we use a Dutch auction system for exits. This creates a market-driven, disciplined, and fair process that protects long-term participants and discourages opportunistic withdrawals. @@ -62,16 +64,16 @@ Let's say: - There can be other rules too (e.g., minimum price thresholds) - LPs submit the following bids: -| LP | Amount | Minimum Price | -|----|--------|----------------| -| A | €500k | €0.088 | -| B | €600k | €0.090 | -| C | €400k | €0.092 | -| D | €700k | €0.095 | -| E | €300k | €0.098 | -| F | €200k | €0.100 | -| G | €500k | €0.105 | -| H | €400k | €0.110 | +| LP | Amount | Minimum Price | +| --- | ------ | ------------- | +| A | €500k | €0.088 | +| B | €600k | €0.090 | +| C | €400k | €0.092 | +| D | €700k | €0.095 | +| E | €300k | €0.098 | +| F | €200k | €0.100 | +| G | €500k | €0.105 | +| H | €400k | €0.110 | After sorting from lowest price to highest, we fill bids starting from the bottom. The system stops when total accepted bids reach €3 million. @@ -98,12 +100,12 @@ The margin between what a bidder was willing to accept and the final clearing pr ## Why This Works -| Benefit | Description | -|---------|-------------| -| **Fair** | All successful bidders receive the same clearing price | -| **Protective** | Exits only happen with a discount, preventing abuse | -| **Incentivizing** | Remaining LPs gain rewards when others exit | -| **Sustainable** | Controls liquidity outflow with capped exit volume and loss-based exit mechanics | +| Benefit | Description | +| ----------------- | -------------------------------------------------------------------------------- | +| **Fair** | All successful bidders receive the same clearing price | +| **Protective** | Exits only happen with a discount, preventing abuse | +| **Incentivizing** | Remaining LPs gain rewards when others exit | +| **Sustainable** | Controls liquidity outflow with capped exit volume and loss-based exit mechanics | --- diff --git a/docs/roadmap/liquidity-pools-overview.md b/docs/roadmap/liquidity-pools-overview.md index a5e5a8e..2f88d19 100644 --- a/docs/roadmap/liquidity-pools-overview.md +++ b/docs/roadmap/liquidity-pools-overview.md @@ -24,20 +24,20 @@ graph TB subgraph Internal["ThreeFold Ecosystem"] TFT_LOCKED[🔒 Locked TFT] CC[💎 Cloud Credits CC] - TFTF[📊 TFT Future TFTF] + TFP[📊 TFP TFP] POOL1["Pool 1: TFT → CC
(One-Way Entry)"] - POOL2["Pool 2: CC ↔ TFTF
(Internal Trading)"] - POOL3["Pool 3: TFTF ↔ USDC
(Controlled Exit)"] + POOL2["Pool 2: CC ↔ TFP
(Internal Trading)"] + POOL3["Pool 3: TFP ↔ USDC
(Controlled Exit)"] end TFT_MARKET -->|Buy TFT| POOL1 POOL1 -->|Lock TFT
Mint CC| CC CC <-->|Convert| POOL2 - POOL2 <-->|Based on TFT price| TFTF + POOL2 <-->|Based on TFT price| TFP - TFTF <-->|Dutch Auction
5% cap, 20% discount| POOL3 + TFP <-->|Dutch Auction
5% cap, 20% discount| POOL3 POOL3 <-->|Controlled bridge| FIAT style POOL1 fill:#e1f5ff @@ -71,14 +71,14 @@ Your CC is pegged to gold (~$0.128 per CC as of Oct 2024) --- -### 2. Internal Movement (Pool 2: CC ↔ TFTF) +### 2. Internal Movement (Pool 2: CC ↔ TFP) **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 CC to TFP based on current TFT market price +- TFP 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. @@ -87,14 +87,14 @@ Your CC is pegged to gold (~$0.128 per CC as of Oct 2024) ``` 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 convert → 500 CC becomes 5,000 TFP +If TFT rises to $0.15, your TFP value increases You can convert back to CC at any time ``` --- -### 3. Exit to Fiat (Pool 3: TFTF ↔ USDC) +### 3. Exit to Fiat (Pool 3: TFP ↔ USDC) **What it does**: Provides a controlled bridge to cash out to fiat currency @@ -108,7 +108,7 @@ You can convert back to CC at any time **Example**: ``` -You want to exit: 10,000 TFTF (worth ~$1,000) +You want to exit: 10,000 TFP (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) @@ -140,8 +140,8 @@ graph LR A[User Needs] --> B{What do you need?} B -->|Stable pricing for services| P1[Pool 1: TFT→CC
Get stable credits] - B -->|Keep TFT upside exposure| P2[Pool 2: CC↔TFTF
Maintain position] - B -->|Cash out for operations| P3[Pool 3: TFTF→USDC
Controlled exit] + B -->|Keep TFT upside exposure| P2[Pool 2: CC↔TFP
Maintain position] + B -->|Cash out for operations| P3[Pool 3: TFP→USDC
Controlled exit] style P1 fill:#e1f5ff style P2 fill:#fff4e1 @@ -152,7 +152,7 @@ graph LR 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. +Allows you to move between stable CC and TFT-linked TFP based on your market outlook. ### Pool 3: Liquidity Provides real fiat exit when needed, with controls that protect all participants. @@ -171,15 +171,15 @@ graph TD 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] + USE -->|Want TFT exposure| CONVERT[Convert to TFP in Pool 2] SERVICES --> BURN[CC Burned by Network] HOLD --> WAIT[Wait for opportunities] - CONVERT --> TFTF_HOLD[Hold TFTF Position] + CONVERT --> TFP_HOLD[Hold TFP 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] + TFP_HOLD --> TFP_USE{What next?} + TFP_USE -->|Need stability again| BACK[Back to CC in Pool 2] + TFP_USE -->|Need fiat| EXIT[Enter Pool 3 Dutch Auction] EXIT --> BID[Submit bid with discount] BID --> AUCTION{Bid filled?} @@ -226,8 +226,8 @@ graph TD 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 +1. Convert CC to TFP (Pool 2) +2. Exit TFP 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. @@ -239,13 +239,13 @@ The original TFT you deposited is locked to back the CC that was minted. 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 +- Ability to convert to TFP 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. +Convert your CC to TFP in Pool 2. TFP value tracks TFT market price, so if TFT goes up, your TFP position becomes more valuable in CC or USDC terms.
@@ -266,17 +266,17 @@ Fundamentally different. Traditional AMMs use value-weighted pools with instant Now that you understand the overall flow, dive deeper: -1. **[Token System](/core-concepts/token-system)** - Understand TFT, CC, and TFTF roles -2. **[Position-Based Liquidity Pools](/core-concepts/position-based-lp)** - Learn why this approach is fair -3. **[Dutch Auction Exit](/core-concepts/dutch-auction-exit)** - See exactly how exits work with examples -4. **[Yin-Yang Currency](/core-concepts/yin-yang-currency)** - The philosophy behind dual tokens +1. **[Token System](/core-concepts/token-system)** - Understand TFT, CC, and TFP roles +2. **[Position-Based Liquidity Pools](/roadmap/position-based-lp)** - Learn why this approach is fair +3. **[Dutch Auction Exit](/roadmap/dutch-auction-exit)** - See exactly how exits work with examples +4. **[Yin-Yang Currency](/appendix/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) +- **Pool 2**: Move around (CC ↔ TFP) +- **Pool 3**: Get out (TFP → USDC) All three work together to give you **stability**, **flexibility**, and **controlled liquidity**. ::: diff --git a/docs/we_are_different.md b/docs/we_are_different.md new file mode 100644 index 0000000..2aa10f2 --- /dev/null +++ b/docs/we_are_different.md @@ -0,0 +1,56 @@ +--- +sidebar_position: 2 +--- + +# We Are Different + +Dear Reader, we are not the typical Web3 project. + +We are not here to make a quick buck, nor are we here to create unfounded hype or speculation. + +We are here to build a better internet, a more decentralized and sustainable future. + +- We are working hard to create a global, decentralized cloud infrastructure that empowers individuals and communities. +- We are on this now for more than 7 years. +- Our current token TFT does not reflect this vision, and we are committed to changing that. +- Our tech is rock solid see [https://threefold.info/tech](https://threefold.info/tech) + +We will not change our tokenomics to chase short-term gains or to follow the latest trends. + +The TFT will do very well based on + +- Our commitment to building a real, usable product +- 10% burning of all revenue means the token will become more scarce over time +- There are only 1 Billion tokens in circulation and this will decrease over time +- The fact that we are building a dual token system with a stable utility token (Cloud Credits) and a tradable token (TFT) +- Our focus on strong partnerships and real-world adoption + +Yes it took a long time. + +- building the tech we have was hard and took longer than expected, we are grateful for the patience of our community. +- we are now in the final stages of launching TFGrid 4.0, which will revolutionize the way we think about cloud computing and decentralization. + +We will launch our v4.0 in Q1 2026, with a new dual token system, a stable utility token (Cloud Credits) and a tradable token (TFT). + +- The new system will be fairer, more sustainable and more transparent than anything else out there. + +We are fundraising + +- We are fundraising for our tech project called GeoMind (was called TF9/TFTech before). +- This is causing us some delay, but we are confident that we will find the right partners who share our vision and values. +- GeoMind is the main sponsor of the ThreeFold project and has been building all the tech for the past 7 years in an opensource way. + +What we are not promising + +- We do not promise you to get rich quick nor can we guarantee that we will ever be on centralized exchanges. +- We do not promise you that the TFT will moon, but we do promise you that we will work hard to make the ThreeFold Grid a success. + +What do we want to improve on + +- Our communication, we know we can do better and we are working on it. + +We are very excited about the future and we hope you are too. + +regards + +Kristof, diff --git a/sidebars.js b/sidebars.js index 61b0def..3af3628 100644 --- a/sidebars.js +++ b/sidebars.js @@ -15,6 +15,7 @@ const sidebars = { mainSidebar: [ 'intro', + 'we_are_different', 'implementation-roadmap', { type: 'category', @@ -61,6 +62,7 @@ const sidebars = { 'roadmap/dutch-auction-exit', ], }, + 'faq', { type: 'category', label: 'Appendix',