new book manual

collections/manual/knowledge_base/farming/_beta/planet_positive_farming.md

@@ -0,0 +1,18 @@
+# Planet Positive Farming
+
+The ThreeFold Grid (“Grid”) has the aim to become a carbon_negative grid by the end of 2022. ThreeFold Farmers (“Farmers”) will be offsetting their carbon emissions three times and through their Farming process, will be directly involved in initiatives with the goal of regenerating the earth and enhancing the life of local communities. ThreeFold will therefore partner with an organization specialized in climate education and involving students and teachers in their quest to fight against climate change. Users of the ThreeFold Grid will therefore purchase carbon-negative internet capacity with ThreeFold Tokens ("TFT").
+ 
+Part of the ThreeFold Token from the farming reward will be allocated for energy compensation and sent onto a pool dedicated for the above project. 
+
+The amount will depend on:
+- The types of 3Node run by the Farmer as each type of server varies in terms of power utilization
+- The location of the 3Node as each country has a different electricity production structure. 
+
+More variables will be taken into account to ensure the reliability of this voluntary carbon offset. 
+ 
+> More information will be communicated to the community soon. Stay tune. 
+
+
+
+
+

collections/manual/knowledge_base/farming/certified/certified_farming.md

@@ -0,0 +1,5 @@
+# Certified Farming
+
+!!!include:farming_certification_benefits
+
+!!!def alias:certified_farming

collections/manual/knowledge_base/farming/certified/certified_node.md

@@ -0,0 +1,33 @@
+![](img/farming_solutions.jpg)
+
+## Certified Node
+
+A Certified Node is a node which comes BIOS locked and does not allow the owner change how the node boots.  
+
+This makes it impossible for the node owner to make changes to the operating system and secure that the node will run the right certified version of Zero-OS.  
+
+The Titan V2.1 node is a certified node.  Certified nodes are eligible for more [farming rewards](farming_reward).
+
+### Requirements
+
+- Node delivered by a certified hardware vendor or through the ThreeFold website.
+- The farmer who owns a certified node will have to sign specifically created terms and conditions
+  - not done yet, will be part of tfgrid 3.0 launch, see [here](farming_certification_terms_conditions).
+- For 2.0 Farmers who started in 2020 or before: agreement about vesting see [vesting_overview](vesting_overview).
+
+### More Info
+
+- [Certified Farming](certified_farming)
+
+### More Technical Details
+
+- The BIOS gets locked.
+- The BIOS gets configured to use TPM2 
+  - more info about tpm2 [here](https://www.usenix.org/system/files/conference/usenixsecurity16/sec16_paper_raj.pdf).
+- TPM2 is a security implementation on the motherboard which allows Zero-OS to securely store private keys, this mechanism is used to identify Zero-OS nodes and make sure they are registered as certified node.
+- If a user would reset the BIOS then the TPM private keys are gone as well.
+- Starting with our TFGrid 3.0 we will use this TPM feature to verify and validate some checks done from tfchain.
+- A certified farmer is required to use certified_nodes.
+
+
+!!!def alias:certified_node

collections/manual/knowledge_base/farming/certified/farming_certification_benefits.md

@@ -0,0 +1,17 @@
+## Certified Farming Benefits
+
+This certification program has many benefits for the TFGrid user, for the world and the farmer itself.
+
+| For The Planet                                         | For The Cloud User                                   | For The Farmer                                         |
+| ------------------------------------------------------ | ---------------------------------------------------- | ------------------------------------------------------ |
+| More Green                                             | More Secure                                          | Faster Adoption (easier to get to 30% treshold)        |
+| **certified carbon neutral**                           | More Defined Legal Framework                         | More Farming Rewards (income)                          |
+| Better Global Distribution                             | More Uptime (SLA)                                    | Lower Operational Cost                                 |
+| Sovereignity (legal framework)                         | Better Performance                                   | Higher Credibility                                     |
+| More protection for user                               | Possiblity For Support                               | Custom Pricing CU/SU/NU is possible (*)                |
+| **[more info](farming_certification_benefits_planet)** | **[more info](farming_certification_benefits_user)** | **[more info](farming_certification_benefits_farmer)** |
+
+(*) in collaboration with TFTech, and planned for earliest H1 2022.
+
+- [farming certification requirements](farming_certified_requirements)
+- [certified nodes](certified_node)

collections/manual/knowledge_base/farming/certified/farming_certification_benefits_farmer.md

@@ -0,0 +1,63 @@
+![](img/grid_banner.jpg)
+
+## For The Farmer
+
+### Higher Cloud Unit Reward reward = more income
+
+A certified farmer gets more farming_rewards because a certified farmer need to adhere to higher service level agreements and buy certified farming solutions or certifiy their existing 3nodes.
+
+### TF Tech Support
+
+Direct defect and certified build support for Zero-OS from the software creators for the tfgrid_primitives on TFGrid.
+
+### Lower Operational Cost
+
+Certified farms can use the TFTech power management solution which makes sure that 3Nodes are only powered on when there is a need for it. This can save huge amounts of electricity.
+
+### Easier to get to minimal required 30% utilization
+
+The tokens farmed for a 3Node are locked up in a staking pool untill the 3Node gets to 30% utilization.
+
+This is to make sure that people cannot put hardware to the grid which cannot be used and as such get farming rewards.
+
+ThreeFold needs to make sure that there is no abuse and also that 3Nodes are not brought life for just farming which would burn energy for no reason.
+
+ThreeFold & ThreeFold Tech will do a lot of promotion and find channel_partners to get the TFGrid to grow as fast as possible and get capacity used.
+
+Its up to ThreeFold to make sure that certified capacity gets deployed where it is needed first.
+
+All of this leads to much faster utilization of the TF_Farm IT capacity which results in the TF_Farmer getting access to their farmed tokens faster.
+
+### Higher Credibility Because Of Certification
+
+Security advantage as farm, location and nodes have been thoroughly checked and documented (secure boot process guarantees the most stable (best) Zero OS version). This information gets checked by ThreeFold which means the TFGrid user will more likey chose a certified farmer.
+
+### Custom Network (\*):
+
+Ability to implement custom networking based on VxLAN or many other networking technologies.
+
+This is needed for deployments in hybrid or even full private mode where customers have very specific requirements around networking.
+
+### Farmer Bot (\*)
+
+A farmer bot will be made available which makes it easier for a certified farmer to manage their farm in relation to
+
+- power management
+- management farmed tokens
+- network management tools
+- lockout bad actors (e.g. deny access for hackers or other bad actors)
+- ...
+
+### Monitoring Integration (\*)
+
+Possibility to integrate custom monitoring solutions.
+
+### Reputation System (\*)
+
+Farmers and TFGrid users are rated by a reputation system.
+These reputation scores will be visible on the TF_Chain
+
+This allows a farmer to see that the TFGrid users on the TF_Farm can be trusted.
+
+> (\*): planned easliest Q4 2021
+

collections/manual/knowledge_base/farming/certified/farming_certification_benefits_planet.md

@@ -0,0 +1,20 @@
+![](img/grid_banner.jpg)
+
+## For The Planet
+
+### Green
+
+Certified farming capacity will become carbon neutral by end 2021.
+This happens because if using less energy and offsetting remainder of energy usage with buying carbon credits from a climate change action program called TAG = Take Action Global.
+
+### Inclusive
+
+Everyone gets access to this network of capacity everywhere.
+
+Thanks to certification its easier to make sure that the TF_Farmer complies with all requirements.
+
+### Sovereignity
+
+Its important to deliver sovereign solutions to the user and to countries.
+Certification allows ThreeFold to guarantee more requirements and have more visibility in the sovereignty requirements.
+

collections/manual/knowledge_base/farming/certified/farming_certification_benefits_user.md

@@ -0,0 +1,52 @@
+![](img/grid_banner.jpg)
+
+## For The ThreeFold Grid User.
+
+Users of the ThreeFold Grid have an advantage to use a farmer who is certified.
+
+### More information about the farm
+
+Whoever wants to use capacity from the grid gets more information about
+
+- connection capabilities to the internet
+- quality of hardware used
+- service level agreements
+- location of the TF_Farm (country,...)
+- protection mechanisms around fire, water, ...
+
+This information is important for the TFGrid user to make selection where to host their IT workloads.
+
+TFTech will validate this information.
+
+### More uptime
+
+Being certified means that the farmer likely will have more uptime compared to a non certified farmer.
+
+### More security
+
+As part of the certification process, TFTech will make sure that the 3Node has secure boot procedures to allow for more security. The Farmer needs to sign an agreement with ThreeFold Foundation where they commit to a set of standards and security requirements.
+
+### More legal protection
+
+Each certified farmer has to adhere to a set of terms & conditions which protect the TFGrid User.
+
+The terms & conditions describe
+
+- privacy & security protections
+- compliance to legal requirements
+- protection against abuse
+
+### Continuation protection.
+
+The TF_Farmer has to promise to keep the farm operational till the end as specified on farming certificate which gets registered on the TFChain.
+
+- [more info about requirements see here](farming_certified_requirements)
+
+### TFGrid User Can Have Support
+
+All support inquiries will be handled through blocks of 15 minutes which are paid for in ThreeFold Support Tokens(TFTS).
+
+Any TFGrid user can ask for support but only for certified farms.
+
+<!-- [Learn more about the TFTS which is the dedicated token to be used to deliver support](tftech:tfts). -->
+

collections/manual/knowledge_base/farming/certified/farming_certification_terms_conditions.md

@@ -0,0 +1,11 @@
+- sign terms and conditions document with threefold_dubai
+  - we are in the process of formalizing this, this will be done at least before the end 2022.
+- farmer agrees and acknowledges following info: 
+  - TFGrid operates as a DAO with the help of human councils. This means that no organization manages the operations of the TFGrid.
+  - TFTech as subcontractor for threefold_dubai delivers software support for the tfgrid_primitives (only defect support and certified builds).
+  - All information required to be a farmer can be found on our knowledgebase: https://library.threefold.me/
+  - TFT rewards (farming) is the result of the blockchain as operated by consensus3 concept. If SLA is not achieved TFT will NOT be rewarded that month.
+  - TFT rewards are done in line with [farming reward document](farming_reward).
+  - Measurement of SLA (see below) done by consensus3 engine.
+
+

collections/manual/knowledge_base/farming/certified/farming_certified_requirements.md

@@ -0,0 +1,69 @@
+![](img/grid_banner.jpg)
+
+## Certified Farming Requirements 
+
+### Individual Certified Farmer
+
+- Certified Farms are made up of certified_nodes
+- up to 4 certified nodes
+- home or office location
+
+#### Uptime and Network Requirements
+
+- 97% uptime is accepted in home farming situations
+- 1 IP feed (consumer provider)
+- 1 public IP address and NAT allowed
+- enough bandwidth to allow the utilization of the storage/archive (see below)
+- good enough latency (low latency = performance of network)
+
+### Professional Certified Farmer
+
+- Certified Farms are made up of certified_nodes
+- more than 4 certified nodes
+- datacenter location
+
+#### Uptime and Network Requirements
+
+- 99.5% uptime
+- minimal bandwidth as required for the workloads as hosted on the farm
+- maximum network latency
+- more than 1 internet connection (multiple IP feeds)
+- enough IPv4 addresses
+- at least 1 class C ipv4 addr for network farmers.
+- enough bandwidth to allow the utilization of the storage/archive (see below)
+- good enough latency (low latency = performance of network)
+- [install your network in line with Threefold Requirements](tfgrid_networking)
+
+(*) = in case of datacenter or commercial deployment
+
+#### Redundancy Requirements
+
+- protection for fire & water damage
+- enough access to power
+- redundant power systems
+
+#### Terms and Conditions need to be signed
+
+!!!include:farming_certification_terms_conditions
+
+
+### Bandwidth Requirement for archive/storage usecase example.
+
+A storage usecase needs a lot of bandwidth to allow the storage nodes to be filled and also to allow its customers to download the information.
+
+It’s the obligation of the farmer to make sure that enough bandwidth is available. We will measure this by doing random upload & download tests to the storage systems. 
+
+It should always be possible to have at least 1 mbit/sec per Zero_DB (which is a storage container running on 1 harddisk or ssd).
+
+### Reputation & Monitoring Engine
+
+The TFGrid has a reputation engine and a monitoring engine to measure uptime & other SLA requirements, see consensus3.
+
+Factors the TFGrid Reputation_engine will look at (Q4 2021, latest Q1 2022) 
+
+- Available Bandwidth
+- Latency
+- Utilization
+- Uptime (nodes & network)
+
+The monitoring engine could require farmers to execute on certain actions.

collections/manual/knowledge_base/farming/certified/farming_types.md

@@ -0,0 +1,20 @@
+![](img/farming_solutions.jpg)
+
+# Farming Types
+
+## DIY (Do It Yourself) Farming
+
+- Self made or bought bare metal server (compute/storage) capacity (and AMD or Intel system)
+- No license on the software with TF Tech (Company responsible for the ThreeFold Software components).
+- No Support possibility from ThreeFold / TF Tech.
+
+### Certified
+
+- Certified Secured server hardware
+- Comes plug and play
+- Highest Uptime Requirements
+- Certification report given by TFTech or partners to describe farming situation (H2 2021).
+- see [farming certified requirements](farming_certified_requirements)
+
+!!!include:farming_certification_benefits
+

collections/manual/knowledge_base/farming/diy/diy_guide.md

@@ -0,0 +1,44 @@
+# Do-it-Yourself Farming Guide
+
+Any standard computer can become a 3Node on the ThreeFold Grid. This section covers the compatible systems and setup optimization for anyone who wants to purchase or build their own nodes. 
+
+## What kind of hardware is supported?
+
+Any 64-bit hardware with an Intel or AMD processor chip can run Zero-OS and become a 3Node. The following configurations provide guidelines on compatible and recommended setups:
+
+- Servers, desktops and mini computers type hardware are compatible. 
+- A minimum of 500 GB of SSD and a bare minimum of 2 GB of RAM is required. 
+- A ratio of 1:4 between vCPU and RAM (e.g. 8vCPU and 32 GB of RAM) is recommended.
+- The recommended upper limit is 8 GB of RAM per vCPU as farming rewards do not increase beyond that ratio. 
+- A minimum of 500 GB of SSD and a bare minimum of 2 GB of RAM is required. 
+- A wired ethernet connection is highly recommended to maximize reliability and the ability to farm TFT. 
+
+> Note: The team successfully tested ARM based devices, but they are not yet supported. 
+
+The follwoing configurations are not advised or not supported:
+
+- Laptops are not advised and USB based external drives are not supported due to reliability concerns.
+- No graphics or display is required, although it may be helpful during the boot configuration or troubleshooting if necessary.
+- GPU is not yet supported.
+
+## How much power does a node consume?
+
+Power efficiency is important for farmers to spend less on electricity and therefore increase earnings. A small form factor server may be much more power efficient than a gaming PC with similar specs (GPUs are not supported yet). 
+
+> Note: Knowing exactly how much power a system will draw can be complicated, but some manufacturers provide more detailed estimates than the watt rating of a power supply.
+
+## What kind of internet connection is needed?
+
+- A wired network connection should be considered essential to maximize a node's reliability. Any domestic high speed internet plan is adequate for a basic node. 
+- If the node connects more than a few terrabytes of storage, a gigabit or faster connection may be necessary to support the traffic.
+- The Grid is designed with IPv6 in mind, but IPv4 is sufficient for now.
+
+> A node only needs bandwidth when it is being utilized. That means you could scale up your connectivity as utilization of your node grows.
+
+## How to boot a node with Zero-OS?
+
+Zero OS can be booted either from a USB stick (the boot image is tiny, so any size drive will do) or over a network via PXE. In either case, the latest software will be downloaded and cryptographically verified before boot. After the first boot, Zero OS will update itself automatically and requires virtually no maintenance. 
+
+When you’re ready to start farming, follow [these instructions](https://library.threefold.me/info/manual/#/manual__farming) to bring your 3Node online.
+
+> Note: Occasionally, updates to the boot medium may be required.

collections/manual/knowledge_base/farming/farming_circular.md

@@ -0,0 +1,19 @@
+
+Farming is the process of adding Internet capacity (compute, storage and network) to the ThreeFold Grid. 
+
+ThreeFold uses a proof-of-blockstake consensus mechanism. By running Zero-OS on their hardware, Farmers dedicate the computation power and storage capacity of their node to the network, enabling anyone to host data and run IT workloads on a decentralized Internet infrastructure.
+
+![](img/circular_tft3_.jpg ':size=500')
+
+> TODO: we have better one (note: image? could not find)
+
+In decentralized systems like ThreeFold, we need to ensure that everyone is able to provide Internet capacity to the world. Farmers help this happen by connecting hardware that run Zero-OS. Once booted, the hardware is locked to generate Internet capacity for the network. The capacity is registered on TFChain, securing access to a decentralized Internet for users and rewarding farmers with TFT.
+
+<!-- 
+
+Farmers make this happen by recording the Internet capacity they make available to the network 
+
+Farmers connect hardware called 3Nodes to provide Internet Capacity and are consequently rewarded with ThreeFold Token (“TFT”). The 3Node can be installed at home or any location where existing internet connectivity is available. Every month that the 3Node is up and running and connected to the internet, Farmers receive TFT. 
+ 
+Everyone in the world can now use this Compute, Storage, and Network Capacity to deploy apps onto these 3Nodes instead of using centralized datacenters.  -->
+

collections/manual/knowledge_base/farming/farming_intro.md

@@ -0,0 +1,64 @@
+
+# ThreeFold Farming
+
+![](img/farming_intro0.jpeg)  
+
+ThreeFold Farming ("Farming") is the process of connecting Internet capacity to the ThreeFold Grid. This process is undertaken by independent people or organization called ThreeFold Farmers ("Farmers").
+
+## What is Farming?
+
+{{#include farming_circular.md}}
+
+## Who can become a farmer on ThreeFold?
+
+![](img/farming_.png)
+
+Technically, anyone can farm on the ThreeFold Grid using any server-type hardware. By using [Proof-of-Capacity](proof_of_capacity), farming was designed to reward all nodes equally according to the Internt capacity they provide to the ThreeFold Grid. 
+
+## Cost of farming 
+
+Anyone can become a Farmer, and there is no technical knowledge required. ThreeFold's autonomous system does all the heavy lifting, making it easy for anyone to join.
+
+- Potential costs of the hardware necessary to provide Internet capacity and maintain a farming setup.
+- Electrical costs to power the farm.
+- Potential cost of equipment to support larger farming setups such as data centers (ventilation, monitoring, electrical wiring, etc). 
+
+To further explore farming rewards, click [here](@farming_reward). 
+
+## How ThreeFold Internet capacity is farmed?
+
+1. A farmer provides Internet capacity by booting compatible hardware with Zero-OS. 
+2. Once installed, Zero-OS locks the hardware and registers the Internet capacity in TFChain. 
+3. Once verified by the [Proof-of-Capacity](proof_of_capacity) algorythm, the Internet capacity is made available to the network via the explorer. 
+
+> Note: All the compute and storage data remains off-chain in order to protect the privacy of users. Once Zero-OS is booted, the device is locked in such a way that it no longer has any state or remote access, preventing farmers to access user data on a hardware level as well. 
+
+## What kind of hardware can become a 3Node?
+
+Any Intel or AMD server type hardware that contains compute and/ or storage can be connected to the ThreeFold Grid. Farmers need to download Zero-OS and boot their hardware.
+
+Learn more [here](@farming_hardware_overview)
+
+Once booted by Zero OS, the hardware becomes a 3Node, and its total capacity will automatically be detected and registered on the blockchain database. We call this Proof-of-Capacity.
+
+Learn more about Proof-of-Capacity [here](@proof_of_capacity)
+
+<!-- ## Why becoming a Farmer?
+
+### Internet and Its Global Demand 
+
+The Internet represents the largest economy in the world and is growing at a rapid pace.
+
+![](img/token_time_to_get_involved_now_.jpg)
+
+The ThreeFold Grid offers the most scaleable, secure and sustainable infrastructure to supply the increasing Internet demand. 
+
+Learn more about the ThreeFold Grid [here](grid_home).
+
+### Sovereign and Recurrent Wealth 
+
+By participating in the expansion of the ThreeFold Grid, Farmers earn TFT on a monthly basis. ThreeFold Token has value - it represents a unit of reservation of Internet Capacity on the ThreeFold Grid. With the infinite expansion of the ThreeFold Grid and the scarcity of mechanism of the TFT, there will be a constant increase in demand while a decrease in supply, thus providing value of its holders/Farmers. 
+
+Learn more about Farming Rewards [here](@farming_reward). -->
+
+!!!alias become_a_farmer

collections/manual/knowledge_base/farming/farming_reward.md

@@ -0,0 +1,63 @@
+<h1> Farming Reward </h1>
+
+<h2> Table of Contents </h2>
+
+- [Introduction](#introduction)
+- [How do farmers earn TFT?](#how-do-farmers-earn-tft)
+- [Proof-of-Capacity](#proof-of-capacity)
+- [What is proof-of-capacity?](#what-is-proof-of-capacity)
+- [Why proof-of-capacity?](#why-proof-of-capacity)
+- [How does Proof-of-Capacity work?](#how-does-proof-of-capacity-work)
+
+***
+
+> Note: Farming rewards will be updated for the next 3.14 grid release. Stay tuned.
+
+## Introduction
+
+The amount of TFT earned by farmers is relative to the amount of compute, storage or network capacity they provide to the ThreeFold Grid as recorded by the proof-of-capacity algorythm. This section covers some farming and token reward basics. 
+
+## How do farmers earn TFT? 
+
+ThreeFold Blockchain (TFChain) rewards farmers for providing Internet capacity and expanding the ThreeFold Grid. They earn TFT. When successfully verified by proof-of-capacity, farmers earn TFT according to the amount of Internet capacity registered in TFChain.
+
+## Proof-of-Capacity
+
+The Proof-of-Capacity records Internet resources from the 3Node:
+
+The ThreeFold Blockchain (TFChain) uses work algorythm called "Proof-of-Capacity" to verify the Internet capacity provided by 3Nodes. Put simply, PoC verifies, on an ongoing basis, that farms are honestly representing the Internet capacity they provide to the network.
+
+**See Proof-of-Capacity in action** by visiting the [ThreeFold Grid Node Finder](https://dashboard.grid.tf/#/deploy/node-finder/) which represents the best resource to view POC-related data. 
+
+## What is proof-of-capacity? 
+ 
+POC allows ThreeFold Farmers to earn reward according to their contribution. Farming is the "work" itself, the act of providing Internet capacity to the network and making it accessible via our TFDAO and TFChain.
+
+The PoC algorythm records four different types of Internet capacity:
+
+- Compute Capacity (CPU)
+- Memory Capacity (RAM)
+- Storage Capacity (SSD/HDD)
+- Network Capacity (Bandwidth, IP Addresses)
+
+## Why proof-of-capacity? 
+
+PoC comes with a number of benefits, including: 
+
+- Energy efficiency: earning reward in form of TFT does not waste energy, farming TFT is a carbon_negative operation.
+- Lower barriers to entry with reduced hardware requirements: no need for elite hardware to stand a chance for earning rewards.
+- Decentralized: allows anyone to connect a 3node to the network. TFGrid runs as a DAO.
+
+The main advantage of PoC to farmers it makes it really easy to run a 3Node. It doesn't require huge investments in hardware or energy and everyone earns a fair reward for their contribution. It is more decentralized, allowing for increased participation, and more 3Nodes doesn't mean increased returns, like in mining. 
+
+## How does Proof-of-Capacity work?
+
+1. A farmer boots hardware with Zero-OS (multiple boot methods available)
+2. Zero-OS is a low level OS, with no shell, farmers cannot access Zero-OS
+3. Zero-OS reports used IT capacity towards TFChain
+4. TFChain and TFDAO will calculate rewards as required for the farmer (TFGrid 3.1.x)
+5. TFChain will mint the required TFT and send them to account on TFChain of TFFarmer.
+6. Everyone can use the [ThreeFold Node Finder](https://dashboard.grid.tf/#/deploy/node-finder/) to see where capacity is available. This info comes from the TFChain.
+
+
+{{#include farming_reward_disclaimer.md}}

collections/manual/knowledge_base/farming/farming_reward_calculation.md

@@ -0,0 +1,53 @@
+## Farming Reward Calculation
+
+Each 3Node has certain amount of compute, storage and network resources:
+
+- Compute Capacity (CPU)
+- Memory Capacity (RAM)
+- Storage Capacity (SSD/HDD)
+- Network Capacity (Bandwidth, IP Addresses)
+
+For making this Internet Capacity available, Farmers are rewarded with TFT.
+
+The amount of resources availabe in a 3Node are translated into compute units (CU), storage units (SU), Network units (NU) and IP addresses (IPAddr) to calculate farming rewards. See also [Cloud Units Calculation For Farming](../../cloudunits/resource_units_calc_cloudunits.md).
+
+> **Unless explicitly specified otherwise, calculations of "gigabytes" use base
+> 1024. That is, 1 GB is equal to 1073741824 bytes.**
+
+The formula to calculate farming rewards is the following:
+
+```python
+TFT earned per month = 
+    CU farmed * CU farming rewards 
+    + SU farmed * SU farming rewards
+    + NU used * NU farming rewards
+    + IPAddr used * IPAddr farming rewards
+
+```
+
+The below table expands on CU, SU, NU and IPAddr and their farming rewards:
+
+| Unit                | description                                                       | v3 farming rewards in TFT |
+| ------------------- | ----------------------------------------------------------------- | ------------------------- |
+| Compute Unit (CU)   | typically 2 vcpu, 4 GB mem, 50 GB storage                         | $REWARD_CU_TFT TFT/month  |
+| Storage Unit (SU)   | typically 1 TB of netto usable storage                            | $REWARD_SU_TFT TFT/month  |
+| Network Unit (NU)   | 1 GB of data transfered as used by TFGrid user for Public IP Addr | $REWARD_NU_TFT TFT/GB     |
+| Public IPv4 Address | Public IP Address as used by a TFGrid user                        | $REWARD_IP_TFT TFT/hour   |
+
+
+The reward for above items are linked (pegged) to the USD
+
+| Unit                | USD   | Unit                                  |
+| ------------------- | ----- | ------------------------------------- |
+| Compute Unit (CU)   | 2.4   | per month                             |
+| Storage Unit (SU)   | 1     | per month                             |
+| Network Unit (NU)   | 0.03  | per GB transfer (as customers use it) |
+| Public IPv4 Address | 0.005 | per IP address, calculated per hour   |
+
+> IMPORTANT: MORE INFO ABOUT DAO RULES IN RELATION TO PROOF OF CAPACITY, SEE BELOW
+
+> **The rewards above are calculated according to the current TFT to USD price in TFChain of $TFTFARMING** ($NOW). TFDAO is responsible to change this price in accordance to current marketsituation and liquidity.
+
+See below for more info about USD price which will be used to calculate your farming reward as well as any other specifics in relation to farming calculations.
+
+The above farming rewards apply for 3Nodes registered in TFChain for ThreeFold Grid v3. Anyone can calculate their potential rewards using the [Farming Reward Calculator](https://dashboard.grid.tf/calculator/simulator). The same CU, SU, NU and IPAddr principles apply to the sales of Internet capacity in the form [cloud units](../../cloudunits/cloudunits.md).

collections/manual/knowledge_base/farming/farming_reward_disclaimer.md

@@ -0,0 +1,8 @@
+> DISCLAIMER: ThreeFold Foundation organizes this process. This process is the result of the execution of code written by open source developers (Zero-OS and minting code) and a group of people who checks this process voluntarily. No claims can be made or damages asked for to any person or group related to ThreeFold Foundation like, but not limited to, the different councils. This process changes for TFGrid 3.X once the TFDAO is fully active.
+
+> Important note: The ThreeFold Token (TFT) is not an investment instrument.
+> TFTs are used to buy and sell IT capacity on the ThreeFold Grid.
+> More info: see [Proof of Capacity DAO rules](./poc_dao_rules.md)
+
+
+

collections/manual/knowledge_base/farming/farming_toc.md

@@ -0,0 +1,12 @@
+# Farming
+
+This section covers the essential information concerning ThreeFold Farming.
+
+To farm on the ThreeFold Grid, refer to the [Farmers](../../documentation/farmers/farmers.md) section.
+
+<h2>Table of Contents</h2>
+
+- [Farming Rewards](./farming_reward.md)
+- [Proof-of-Capacity](./proof_of_capacity.md)
+- [Proof-of-Utilization](./proof_of_utilization.md)
+- [PoC DAO Rules](./poc_dao_rules.md)

collections/manual/knowledge_base/farming/own_farm_utilization.md

@@ -0,0 +1,10 @@
+# Cost of Utilization of Capacity for a Famer their own farm.
+
+We would like to make sure that a farmer can use their provided capacity super cost effective.
+The ThreeFold Dao will take care of this situation.
+
+The idea is that the farmer will pay only for the burning & validator nodes.
+
+> see [Proof of Capacity DAO rules](poc_dao_rules).
+
+

collections/manual/knowledge_base/farming/poc_dao_rules.md

@@ -0,0 +1,60 @@
+<h1>ThreeFold DAO Rules for Proof-of-Capacity</h1>
+
+<h2> Table of Contents </h2>
+
+- [Introduction](#introduction)
+- [Technical Farming Requirements](#technical-farming-requirements)
+- [Suggested: improvements to proof-of-capacity](#suggested-improvements-to-proof-of-capacity)
+- [TFGrid is a DAO](#tfgrid-is-a-dao)
+- [Grid Enhancement Proposal](#grid-enhancement-proposal)
+
+***
+
+> Note: The proof-of-capacity DAO rules will be updated for the next 3.14 grid release. Stay tuned.
+
+## Introduction
+
+- The CU/SU reward gets expressed in TFT and registered in TFChain at 3Node registration time
+  - For certified Nodes, the CU/SU reward was specified at sales/promotion time, this process is managed by ThreeFold Tech.
+- CU/SU rewards are calculated from Resource Units
+  - Certified Node gets 25% more farming rewards
+  - TFT pricing is pegged to USD (pricing changes in line with TFT/USD rate)
+- Rewards for NU and IP Addresses are dynamic
+  - The TFChain tracks capacity utilization and as such the reward can be calculated for the Farmer
+- All Internet capacity farmed is rewarded on a monthly basis according to minimum service level agreements
+  - Minimum SLA = Service Level Agreement (see special section about SLA) needs to be achieved before TFT can be rewarded
+
+## Technical Farming Requirements
+
+- Make sure you have 50GB SSD capacity min available per logical core (physical core times number of threads it can run), if not your calculated CU will be lower.
+- Make sure your network connection is good enough, in future it will be measured and part of the Service Level Agreement.
+
+{{#include tfgrid_min_sla.md}}
+
+**Important Information around TFT USD Price Used at Registration**
+
+This is for mainnet TFGrid 3.0:
+
+- The TFT USD price used at 3Node registration at launch of mainnet is hardcoded in TFChain 3.0 at 0.08 USD per TFT (TFChain 3.0 as used in Jan 2022).
+- Once the DAO is life, a new price will be approved by the DAO voters. Idea is to have this price re-visited more or less once a month, if needed faster.
+- The TFT USD price used at 3Node registration is defined by the TFDAO at least once a month by means of GEP.
+
+## Suggested: improvements to proof-of-capacity
+
+Suggestions will be made to improve PoC, the DAO will have to come to consensus before changes can be made.
+
+- How to deal with a situation where a 3node adds or removes compute or storage capacity.
+- ThreeFold is developing a way of how to detect possible fraud on PoC using TPM chip and dynamic generated code to execute random PoC checks.
+- If PoC finds fraud e.g. trying to fake Internet capacity provided, the 3Node will be disabled automatically by Zero-OS and flagged as fraudulant. The Farmer will then have to re-register with a lower reputation for transparancy to the ecosystem. If TFTs are staked at that time, they will be locked permanently.
+- How to improve the calculation of CU rewards to mitigate the difference in power provided between new and old hardware. 
+
+
+## TFGrid is a DAO
+
+- All of above information is public and can be see by everone of the community as per 3Node and Farmer (part of TFChain).
+- Farming rewards methodology can and probably will get revised if the community wants this, DAO consensus needs to be achieved before changes can happen, this happens by means of a GEP.
+
+## Grid Enhancement Proposal
+
+- Changes to above described mechanism or any other change request for the TFGrid is managed by grid enhancement proposals (GEP).
+- Because we are a DAO, everything is open for change as long as consensus of community in accordance of TFDAO has been achieved.

collections/manual/knowledge_base/farming/proof_of_capacity.md

@@ -0,0 +1,93 @@
+<h1>Proof-of-Capacity</h1>
+
+<h2> Table of Contents </h2>
+
+- [Introduction](#introduction)
+- [What is proof-of-capacity?](#what-is-proof-of-capacity)
+- [Why proof-of-capacity?](#why-proof-of-capacity)
+- [How does Proof-of-Capacity work?](#how-does-proof-of-capacity-work)
+- [PoC Rewards](#poc-rewards)
+- [Farming Reward Calculation](#farming-reward-calculation)
+
+***
+
+> Note: The proof-of-capacity parameters will be updated for the next 3.14 grid release. Stay tuned.
+
+## Introduction
+
+The ThreeFold Blockchain (TFChain) uses work algorythm called "Proof-of-Capacity" to verify the Internet capacity provided by 3Nodes. Put simply, PoC verifies, on an ongoing basis, that farms are honestly representing the Internet capacity they provide to the network. 
+
+## What is proof-of-capacity? 
+ 
+POC allows ThreeFold Farmers to earn reward according to their contribution. Farming is the "work" itself, the act of providing Internet capacity to the network and making it accessible via our TFDAO and TFChain.
+
+The PoC algorythm records four different types of Internet capacity:
+
+- Compute Capacity (CPU)
+- Memory Capacity (RAM)
+- Storage Capacity (SSD/HDD)
+- Network Capacity (Bandwidth, IP Addresses)
+
+## Why proof-of-capacity? 
+
+PoC comes with a number of benefits, including: 
+
+- Energy efficiency: earning reward in form of TFT does not waste energy.
+- Lower barriers to entry with reduced hardware requirements: no need for elite hardware to stand a chance for earning rewards.
+- Decentralized: allows anyone to connect a 3node to the network. TFGrid runs as a DAO.
+
+The main advantage of PoC to farmers it makes it really easy to run a 3Node. It doesn't require huge investments in hardware or energy and everyone earns a fair reward for their contribution. It is more decentralized, allowing for increased participation, and more 3Nodes doesn't mean increased returns, like in mining. 
+
+## How does Proof-of-Capacity work?
+
+1. A farmer boots hardware with Zero-OS (multiple boot methods available)
+2. Zero-OS is a low level OS, with no shell, farmers cannot access Zero-OS
+3. Zero-OS reports used IT capacity towards TFChain
+4. TFChain and TFDAO will calculate rewards as required for the farmer (TFGrid 3.1.x)
+5. TFChain will mint the required TFT and send them to account on TFChain of the farmer.
+6. Everyone can use the [ThreeFold Node Finder](https://dashboard.grid.tf/#/deploy/node-finder/) to see where capacity is available. This info comes from the TFChain.
+
+
+## PoC Rewards
+
+100% of specified [farming rewards](./farming_reward.md) goes to the farmer.
+
+## Farming Reward Calculation
+
+Each 3Node has certain amount of compute, storage and network resources:
+
+- Compute Capacity (CPU)
+- Memory Capacity (RAM)
+- Storage Capacity (SSD/HDD)
+- Network Capacity (Bandwidth, IP Addresses)
+
+For making this Internet Capacity available, Farmers are rewarded with TFT.
+
+The amount of resources availabe in a 3Node are translated into compute units (CU), storage units (SU), Network units (NU) and IP addresses (IPAddr) to calculate farming rewards. See also [Cloud Units Calculation For Farming](../cloud/resource_units_calc_cloudunits.md).
+
+> **Unless explicitly specified otherwise, calculations of "gigabytes" use base
+> 1024. That is, 1 GB is equal to 1073741824 bytes.**
+
+The formula to calculate farming rewards is the following:
+
+```python
+TFT earned per month = 
+    CU farmed * CU farming rewards 
+    + SU farmed * SU farming rewards
+    + NU used * NU farming rewards
+    + IPAddr used * IPAddr farming rewards
+
+```
+
+The below table expands on CU, SU, NU and IPAddr and their farming rewards:
+
+| Unit                | description                                                       | v3 farming rewards in TFT |
+| ------------------- | ----------------------------------------------------------------- | ------------------------- |
+| Compute Unit (CU)   | typically 2 vcpu, 4 GB mem, 50 GB storage                         | 30.00 TFT/month |
+| Storage Unit (SU)   | typically 1 TB of netto usable storage                            | 12.50 TFT/month  |
+| Network Unit (NU)   | 1 GB of data transfered as used by TFGrid user for Public IP Addr | 0.38 TFT/GB     |
+| Public IPv4 Address | Public IP Address as used by a TFGrid user                        | 0.06 TFT/hour   |
+
+> **The rewards above are calculated according to the current TFT to USD price in TFChain of 0.08. TFDAO is responsible to change this price in accordance to the current market and liquidity.**
+
+The above farming rewards apply for 3Nodes registered in TFChain for ThreeFold Grid v3. Anyone can calculate their potential rewards using the [Farming Reward Simulator](https://dashboard.grid.tf/#/farms/simulator/). The same CU, SU, NU and IPAddr principles apply to the sales of Internet capacity in the form of [cloud units](../cloud/cloudunits.md).

collections/manual/knowledge_base/farming/proof_of_utilization.md

@@ -0,0 +1,58 @@
+<h1>Proof-of-Utilization</h1>
+
+<h2> Table of Contents </h2>
+
+- [Introduction](#introduction)
+- [What is Proof-of-Utilization?](#what-is-proof-of-utilization)
+- [How does Proof-of-Utilization work?](#how-does-proof-of-utilization-work)
+- [ThreeFold DAO rules in Relation To Proof-of-Utilization](#threefold-dao-rules-in-relation-to-proof-of-utilization)
+  - [TFGrid Capacity Utilization](#tfgrid-capacity-utilization)
+  - [Other Ways TFT are Required](#other-ways-tft-are-required)
+
+***
+
+> Note: The proof-of-utilization parameters will be updated for the next 3.14 grid release. Stay tuned.
+
+## Introduction
+
+ThreeFold Token ("TFT") is an Utility token and gets generated by ThreeFold Farmers, see [proof-of-capacity](./proof_of_capacity.md) for more information.
+
+Each ThreeFold Grid user can now use this capacity. The ThreeFold Chain ("TFChain") - ThreeFold Blockchain will track the utilization of this capacity. This process is called Proof-of-Utilization. Each hour the utilization is being tracked on the blockchain and charged to the capacity's user.
+
+## What is Proof-of-Utilization? 
+
+Proof-of-utilization is the underlying mechanisms that verifies the utilization of Internet capacity on the ThreeFold Grid. 
+
+Every hour, the utilization is recorded in TFChain and the user is charged for the Internet capacity used on the ThreeFold Grid. Discount calculated in line with the amount of TFT users have in their accounts on TFChain. Learn more about the discount [here](../cloud/pricing/staking_discount_levels.md).
+
+## How does Proof-of-Utilization work?
+
+1. A user reserves Internet capacity on a given set of 3Nodes.
+2. Zero-OS records the reserved and used CU, SU, NU and IPAddresses in correlation with TFChain records.
+3. The TFChain DAO will charge the costs to the user in line with [discount mechanism](../cloud/pricing/staking_discount_levels.md).
+4. TFT from the user account are burned/distributed in line to table below.
+
+| Percentage | Description                            | Remark                                                                   |
+| ---------- | -------------------------------------- | ------------------------------------------------------------------------ |
+| 35% | TFT burning            | A mechanism used to maintain scarcity in the TFT economy.  |
+| 10% | ThreeFold Foundation   | Funds allocated to promote and grow the ThreeFold Grid.    |
+| 5%  | Validator Staking Pool | Rewards farmers that run TFChain 3.0 validator nodes.      |
+| 50% | Solution providers & sales channel | managed by [ThreeFold DAO](../about/dao/dao.md).             |
+
+> Note: While the solution provider program is still active, the plan is to discontinue the program in the near future. We will update the manual as we get more information. We currently do not accept new solution providers.
+
+## ThreeFold DAO rules in Relation To Proof-of-Utilization
+
+### TFGrid Capacity Utilization
+
+- Each solution provider and sales channel gets registered in TFChain and as such the distribution can be defined and calculated at billing time.
+- For billing purposes, ThreeFold DAO will check if it is from a known sales channel or solution provider. If yes, then the billing smart contract code will know how to distribute the TFTs. If the channel of solution provider is not known, then the 50% will go to the ThreeFold Foundation.
+- For Certified Farming, [ThreeFold Tech](../about/threefold_tech.md) can define the solution & sales channel parameters, these are channels as provided by ThreeFold Tech.
+- Burning can be lowered to 25% if too many tokens would be burned, ThreeFold DAO consensus needs to be achieved.
+
+### Other Ways TFT are Required
+
+- Anyone building solutions on top of the TFGrid can use TFT as a currency to charge for the added value they provide, this gives an extra huge requirement for TFT.
+- Some will use TFT as a store or exchange of value, like money, because TFT is a valuable commodity. The hoarding of TFT means that TFT are not available to be used on the TFGrid.
+
+

collections/manual/knowledge_base/farming/tfgrid_min_sla.md

@@ -0,0 +1,18 @@
+## Minimum requirement Service Level Agreement (SLA)
+
+Minimal SLA's need to be achieved before the farming reward can be earned (uptime, bandwidth, latency, ...). This is not yet fully implemented.
+
+More service levels agreements will be required, the DAO will decide on those changes. 
+Requests can be made by everyone by means of GEP.
+
+Some Ideas
+
+- minimal uptime
+- minimal bandwidth requirement
+- minimal network latency requirement
+- minimal distance between Certified Nodes for the super node concept
+- different uptime requirement for Certified vs DIY nodes
+
+
+If SLA (Service Level Agreement) was not achieved for 3 consecutive months, then the 3Node will have to re-register which means the CU/SU reward will be recalculated at that time and re-registered in TFChain for that node, just like a new one.
+

collections/manual/knowledge_base/farming/utility_token_model.md

@@ -0,0 +1,4 @@
+| Utility Token model                          |                                            |
+| -------------------------------------------- | ------------------------------------------ |
+| [Proof Of Capacity](proof_of_capacity)       | Farming (creation) of TFT                  |
+| [Proof Of Utilization](proof_of_utilization) | Utilization (burning, distribution) of TFT |

collections/manual/knowledge_base/farming/why_farming.md

@@ -0,0 +1,18 @@
+
+## Why becoming a Farmer?
+
+### Internet and Its Global Demand 
+
+The Internet represents the largest economy in the world and is growing at a rapid pace.
+
+![](img/token_time_to_get_involved_now_.jpg)
+
+The ThreeFold Grid offers the most scaleable, secure and sustainable infrastructure to supply the increasing Internet demand. 
+
+Learn more about the ThreeFold Grid [here](grid_intro).
+
+### Sovereign and Recurrent Wealth 
+
+By participating in the expansion of the ThreeFold Grid, Farmers earn [TFT](threefold_token) on a monthly basis. ThreeFold Token has value - it represents a unit of reservation of Internet Capacity on the ThreeFold Grid. With the infinite expansion of the ThreeFold Grid and the scarcity of mechanism of the [TFT](threefold_token), there will be a constant increase in demand while a decrease in supply, thus providing value of its holders/Farmers. 
+
+Learn more about Farming Rewards [here](farming_reward).