...

collections/tfgrid4/alltrust.md

@@ -0,0 +1,56 @@
+<h1>All Trust</h1>
+
+![](img/alltrust.png)
+
+<h2>Table of Contents</h2>
+
+- [A Paradigm of Trust](#a-paradigm-of-trust)
+- [Farmers: Investors in Shared Infrastructure](#farmers-investors-in-shared-infrastructure)
+- [Grid Services: Facilitating System Usage](#grid-services-facilitating-system-usage)
+- [Flexible Pricing Policies](#flexible-pricing-policies)
+- [IOUs Enable Trusted Transactions](#ious-enable-trusted-transactions)
+- [Guardian Circles: Humans Ensuring Oversight](#guardian-circles-humans-ensuring-oversight)
+- [Summary](#summary)
+
+***
+
+## A Paradigm of Trust
+
+What if instead of distrusting others, we embrace a paradigm of trust? The *TFGRID 4.0 system is built on this principle of trust between all participants.
+
+The TFGrid 4.0 comprises different actors, each represented by a 3bot digital assistant. 3bots enable automated interactions between farmers, service providers, and consumers.
+
+## Farmers: Investors in Shared Infrastructure
+
+- Farmers invest in hardware capacity like 3Nodes or OurVerse-based services (web gateways, 5G, etc). Their investments fund the grid infrastructure.
+- Farmers can choose to actively manage their infrastructure using their 3bot. Or they can join a Farming Cooperative to simplify operations.  
+- Either way, farmers earn profits when people purchase and utilize the infrastructure capacity they invested in. Their 3bots handle billing, monitoring, support issues, etc.
+
+## Grid Services: Facilitating System Usage 
+
+- Hundreds of different grid services can exist, from storage and compute to telecom and networking. 
+- These services track usage metrics like bandwidth, storage consumption, RPC requests, etc. Usage data is reported transparently to the relevant farming 3bot.
+- Consumers can interact directly with any service via the OurVerse message bus. Services deploy workloads, fulfill requests, provide monitoring, etc as needed.
+
+## Flexible Pricing Policies 
+
+- Farming 3bots define customized pricing policies for their services based on usage. Costs may vary based on compute time, storage quantities, bandwidth, etc.
+- Pricing flexibility creates an open market. Farmers can price based on costs and desired profit margins. Consumers can shop for services based on performance, reliability, location, and price.
+
+## IOUs Enable Trusted Transactions
+
+- IOUs (I Owe You) represent agreements between farmers and consumers for grid usage. 
+- Both parties digitally sign each IOU, ensuring consensus on the transaction details.
+- At regular intervals, farmers submit IOUs to the OurVerse Pay Bridge operated by a Guardian Circle. This aggregates IOUs and requests payment from the consumer 3bots.
+- Reputations are maintained on the blockchain to identify any bad actors abusing the system. But fundamentally, the system relies on trust between participants.
+
+## Guardian Circles: Humans Ensuring Oversight
+
+- We believe a Guardian Circle has the potential to be as good as blockchain and more because Guardian Circles still provide human oversight over key decisions when needed, the bulk of transactions run automated. 
+- Circles enact decisions when their 9-99 member nodes reach consensus. They manage treasuries, set policies, enable collaboration between regional grids, and more.
+- Their flexibility allows customization by each grid community based on local needs.
+- Circles leverage tools like multisig wallets, OurVerse consensus, and VLang DSLs to codify logic while retaining human checks and balances.
+
+## Summary
+
+In summary, *TFGRID 4.0 demonstrates that with the right incentives and oversight, we can build shared digital ecosystems founded on trust and collaboration.

collections/tfgrid4/alltrust_input.md

@@ -0,0 +1,68 @@
+# All Trust
+
+What if in stead of not trusting anyone, we change the paradigm and we are going to trust everyone.
+
+The TFGrid 4.0 system is built up out of actors, each actor is implemented inside a 3bot.
+
+Some example actors
+
+- farming: represents selected Grid Servives which run on top of 3nodes 
+- farming cooperative: a cooperative of farmers, working on behalf of many farmers, who don't want to manage their own operation
+- 3node: manages one 3node and its operating system called ZOS
+- OurVerse node: manages a OurVerse node, OurVerse can be installed on deskopts, phones, ... 
+- grid service: a grid service can be storage, compute, telecom, network services and can run on ZeroOS or OurVerse Node
+- grid consumer: an actor who works on behalf of a consumer of services of tfgrid, and helps the user to deploy and manage solutions deployed on the grid, payments are done on behalf of user
+
+All of these actors work together to make a super scalable network of services which can support millions (if not billions) of consumers & service providers.
+
+## Farmers
+
+- Invest in 3Nodes or other OurVerse based Services e.g. web gateway, telco service (5G,sms), ...
+- A Farmer invested in the required hardware to run these services.
+- A Farmer or Farming Cooperative will operationally run the services (set billing parameters, monitor environment, manage the networks, optionally give support, ...). Farming Cooperatives define how they distribute the margin they make to their members.
+- A Farmer can actively manage his own infrastructure or become part of a Farming Cooperative.
+- Farmers make profit thanks to people using their infrastructure and optionally monthly fixed farming rewards.
+
+## Grid Services
+
+In TFGrid 4.0 hundreds if eventually not thousands of services can be deployed inside the ecosystem of a new internet
+
+How does it work?
+
+- Grid Services track used capacity (e.g. bandwidth, storage, rpc requests), report this capacity to the relevant farming actor (or farming cooperative).
+- The Grid Consumer can talk to any of the Grid Services directly over OurVerse Reliable Message bus. The Consumer can ask for status reports, monitoring, or can ask for deployment of a serice or ask for a service request e.g. send SMS, send email, ask AI cloud ... 
+- The Farming Actor will use their flexible pricing policies to define the price for the request or deployed capacity. 
+- The Farming Actor will use OurVerse Pay to request payment (my means of request for IOU)
+
+## IOU = I Owe You (Mutual Credit system)
+
+- proofs of consumption & payment
+- farmers & consumers agree on the IOU (think about like a checque in the old banking days)
+- farmers & consumers sign both the IOU (done automatically by the actors using OurVerse for security)
+- the farmer will request the OurVerse Pay Bridge to do the payment at regular intervals e.g. once a day.
+- The OurVerse Pay Bridge is implemented inside a TFGrid Guardian Circle. 
+- The OurVerse Pay Bridge will safely aggregate the IUO's and ask the relevant Consumer Actor to do the payment (in future their might be the notion of escrow accounts, so Consumers need to park money before asking services with a chosen Bridge).
+- Reputation of the Consumers is kept in the relevant TFGrid Guardian Circle, to make sure bad actors cannot cause harm.
+
+## TFGrid Guardian Circle (our replace for blockchain)
+
+- We believe in human chains, which acts and behaves as a blockchain but is directly linked to Humans rather than just a piece of code.
+- A Guardian Circle is a group of minimum 9 people (max 99).
+- Each person runs a 3bot who works on their behalf, so they don't have to do many tasks manually.
+- The Guradian owned 3bots communicate over OurVerse which takes care of security, encryption, consensus and reliable message delivery.
+- The OurVerse Concensus mechanism uses a derivate of Tendermint (see Kosmos blockchain ecosystem) to make sure that the consensus between the members is solid and done in time & space order.
+- A Guardian Circle can own one or more Treasury Wallets which are wallets of money blockchains (Ethereum, Stellar), these wallets use multisignature between all signers of a Guardian Circle.
+- The 3bots use VLang based DSL (Domain Specic coding Language) to describe the functionality.
+- All required actions are executing using 3Script (our own scripting language, super high level and easy), these 3scripts get executed by all members of the Guardian Circle, only if each Guardian 3Node comes to the exact same conclusion the action will be executed.
+- Typical actions as can be executed by a Guardian Circle
+  - voting
+  - roll up of IOU
+  - validation of TFGrid status and auditing of capacity as provided by TFGrid
+  - payments from Treasury as result of vote of roll up of IOU
+  - pricing mechanism
+  - billing for TfGrid Services
+- If needed manual actions (checks) can be done by the humans behind a Gurdian Circle e.g. validate a price chain.
+- Such a TFGrid Guardian Circle is ultra flexible, there can be millions of them and they can all work together, they can be made fully compatible with any chosen money blockchain or other financial institute.
+- Its very easy for developers to extend capabilities of a Guardian Circle (alternative to smart contracts on blockchain)
+
+

collections/tfgrid4/architecture.md

@@ -0,0 +1,13 @@
+
+## Architecture
+
+![image alt text](img/40_1.png)
+
+Each participant (user and/or farmer) of the TFGrid will need  3Bot which can be hosted home or on any of the 3Nodes in the TFGrid. 
+
+There are 2 blockchains who support the operation, one dealing with all money and identity matters, the others with the DAO’s and validation functionality of the TFGrid.
+
+The 3Bots communicate on behalf of the users with the TFGrid or any of the blockchains.
+
+
+> TODO: change picture CHI -> INCA

collections/tfgrid4/consensus_mechanism.md

@@ -0,0 +1,38 @@
+## 2 Consensus Mechanisms
+
+> TODO: needs review, especially if we will use holochain
+
+### Guardian Circles. 
+
+* 9-99 nodes, each Guardian runs one Guardian Circles Node.
+
+Holding all the logic as needed to manage following functions
+
+* Checking uptime. 
+* Management of treasury on CHI Chain
+* Keeping track of capacity used 
+* keeping track of capacity deployed  
+* Providing Proof of Payment (needed for the ZOS nodes to deploy a workload)
+* Identity Verification
+* Federation with other Guardian Circles (e.g. around identity and reputation)
+
+All data is stored in a replicated database and secured by the Guardian Circle and can be replicated as many times as required by the community.
+
+The Guardian Chain functions can be accessed over Open RPC.
+
+Technology: tendermint successor + VLANG 3Bot runtime
+
+
+### CHI Chain
+
+Each regional Internet can chose to run on existing money blockchain or deploy an own Money chain.
+
+If no CHI Chain deployed then more staking will be required per 3node 
+
+Up to 99 nodes. Is a cosmos based delegated staking blockchain. The CHI Chain Validators earn money by deploying and maintaining a node. It's a straightforward deployment process. 
+
+The functions of this blockchain 
+
+* Digital Currency Functions (CHI and wrapped TFT in treasury).  
+* Identities and Reputation. 
+* Integration with other Public Blockchains through IBC protocol (see Cosmos ecosystem)

collections/tfgrid4/guardian.md

@@ -0,0 +1,35 @@
+<h1> Guardians </h1>
+
+![](img/guardian.png)
+
+## Become a Guardian
+
+- TFGrid 3.13 and TFGrid 4.0 regional internet will requires 9 guardians to start with (will be more later).
+
+These Guardians will be the participating members of a Guardian Circle
+
+Requirements
+
+* Good knowledge how to use Linux to allow you to deploy 
+and upgrade your validator starting from code.
+* At least 4h time available per week (will be more at start)
+* Willingness to participate in the forum of TF and coordinate with Coders.
+* You feel aligned with our values of planet and people first
+* Willingness to look at open issues at least 5 times a week (there is chat and email notification) unless during the holiday period.
+* Choose a backup which can help you when needed (sick, holidays, …).
+* Complete your candidacy on our forum on … Fill in the motivation, your profile, … 
+* Get at least 3 people from the community to endorse your skills and motivation.
+
+What do you get in return
+
+* Eternal recognition from your Regional Internet community (-: 
+* TBDk USD per month in INCA reward
+
+
+### INCA Reward
+
+INCA stands for INternet CApacity, is a sort of IOU between TFCloud and the owner of the INCA Token.
+
+The Guardian will receive the INCA Token and TFCloud is obliged to fulfil the obligations as set in the INCA token metadata (the payment).
+
+For the curious you can see the architecture of how an INCA 3script representation looks like [here](inca_3script_example.md)

collections/tfgrid4/holochain.md

@@ -0,0 +1,3 @@
+# Holochain
+
+> TODO: explain how we are planning to use holochain to replace tfchain

collections/tfgrid4/intro.md

@@ -0,0 +1,79 @@
+<h1> TFGrid 4.0 </h1>
+
+![](img/tfgrid4.png)
+
+
+## Introduction
+
+Over the past few years, we've devoted a significant amount of energy and time to developing the current version of the *TFGRID. We've achieved substantial deployment with an active community.
+
+ThreeFold is working to its version 4.0 which is a super exciting new release we are working on
+
+## Benefits
+
+- unlimited scalable
+- no longer dependency on TFChain (limits our scalability, billing and capacity tracking will no longer be done on TFChain)
+- clear distinction between a money chain (e.g. stellar, ethereum, ...) and our own consensus mechanisms, our aim is to support any other blockchain
+- introduction of OurVerse, [more info](ourverse_intro:ourverse.md).
+    - net: unlimited scalable p2p planetary network which looks for shortest path and can reroute
+    - pay: unlimited scalable p2p payment & billing framework
+- introduction of 3bot: your digital self helping you to deploy workloads, manage your farms, ...
+
+**Our aim is to have a first version of TFGrid 4.0 available 2024 in beta mode. The idea is that the grid can run by itself without TFTech operational support.**
+
+> See: Our [All Trust Foundational Concept for our TFGrid 4.0](alltrust.md)
+
+## Simplicity and Decentralization
+
+At ThreeFold Cloud, we consider that simplicity and decentralization is key to a resilient and efficient cloud and AI platform.
+
+### P2P, Distributed and Super Scalable
+
+Threefold Frid 4.0 will be 100% distributed and peer-to-peer.
+
+### 3Bot for TFGrid Participant Functions  
+
+* Your personal bot who helps you to deploy and manage your workloads (solutions) on top of the TFGrid. Your 3bot also helps you to buy and sell your threefold digital currencies.
+* AI Chat Bot to deploy solutions and communicate with 3Bot (proof of concept)
+    * Use artificial intelligence (like chat gpt but private) to talk with your 3bot
+* Personal Chat server 
+    * 3Script support, talk to your 3bot, configure and deploy solutions
+    * Events will show up in your mail or chat client
+* Accept payment requests.
+    * For utilization of the grid, any services of the TFGrid can be automatically be paid for.
+* Liquidity Support
+    * sell buy digital currencies like TFT on your behalf
+    * Sell/Buy TFT from Ethereum and Stellar
+    * Integration with Kraken, BTCAlpha … exchanges (v4.1)
+    * Atomic swaps to sell/buy TFT (v4.1)
+
+### 3Bot for TFGrid farmer functions  
+
+* Your personal bot who helps you to manage your farm and service offerings on top of the TFGrid.
+* Farmer bot can do the power management of your farm (power node’s off and on)
+* Your Farmer Bot will monitor and collect all relevant information from your 3Nodes 
+* You can define your own pricing and your own solution offerings on top of the TFGrid.
+* You don't have to run your own farmer bot but can be part of a farming cooperative.
+
+> See: [All Trust Foundational Concept for our TFGrid 4.0](alltrust.md)
+
+## Simplifications
+
+Our aim is to simplify our TFGrid 4.0 as much as we can and focus on good documentation for the community to be able to contribute or manage the grid without TF Tech’s involvement.
+
+Some examples of what we can simplify, we can remove billing on the chain and replace it with something else, or remove the generic DAO votes, but have them more specific, but so that it's easier for communities to manage their own internet.
+
+### Billing
+
+Billing will not be a native function of tfchain anymore. The idea is that farmers or solution providers can define their own pricing. Maybe there needs to be a minimum price if it's for raw capacity or a maximum. But in general, there will be much more flexibility for the farmer community and the solution providers to define their own pricing, they can build anything on top of the *TFGRID. So it's much easier. For them to define the price they want to have for their own efforts. It will be up to the broader community, the users, to define if they want to pay the price as being asked for by the farmer or the solution provider.
+
+## TFGrid Guardians
+
+There will be multiple roles into *TFGRID 4. 0. One very important role will be given to the Grid Guardians. Grid Guardians are people who need to be willing to spend hours per week in the beginning to deploy and maintain their guardian validators and operate the consensus mechanisms. They will be rewarded as such and become an important cornerstone of our decentralization effort.
+
+A guardian will deploy a guardian validator to be part of a Guardian Circles, there need to be at least nine guardians per regional Internet (this might not be needed if we adopt Holochain). 
+
+A standard validator has all the functions that you would expect from a blockchain and it will be quite easy for a validator to run these services. But some technical expertise will be required. 
+
+A guardian validator is required to keep a grid up and running and safe e.g. the Guardian Validator will check the uptime of the 3Nodes, will do random checks to make sure that the 3Nodes are running our certified validated software, it will do certain other checks to do with billing or capacity checks and also store the results of those checks in a database. 
+

collections/tfgrid4/roadmap_tfgrid.md

@@ -0,0 +1,16 @@
+<h1>TFGrid 4.0 Roadmap</h1>
+
+![](img/roadmap.png)
+
+## Introduction
+
+This section covers the TFGrid 4.0 roadmap. Stay tuned for more information on this.
+
+## TFGrid 4.0 Roadmap Overview
+
+- No more TFChain
+- Many peer-to-peer features
+- Features as descrived in [v4.0](v40/40.md)
+- Concepts as described in [all trust document](v40/alltrust.md).
+
+> Note: More information will follow, TODO link to right sections

collections/tfgrid4/staking.md

@@ -0,0 +1,6 @@
+
+> NOT SURE THIS IS OK, WAITING FEEDBACK
+
+Each TFGrid 4.0 Internet operates on a local currency called CHI and the only way to get CHI is by sending TFT to that chain. The users of the TFGrid will have to stake a certain amount of CHI before they can use our more advanced TFGrid 4.x 
+
+The farmers for TFGrid 4, will also have to stake CHI and there will be a small lock up period in time or until there is a certain utilization on the nodes.  That means that deploying and using independent TFGrids will drive a lot of TFT utilization and as such show support from our community for the ThreeFold truly Decentralized Internet. 

collections/tfgrid4/tokenomics_tfgrid.md

@@ -0,0 +1,29 @@
+
+# TFGrid Tokenomics
+
+
+## TFGrid Tokenomics Upgrade
+
+The tokenomics of any digital ecosystem plays a pivotal role in determining its sustainability, growth, and value proposition. In the case of ThreeFold, there are evident challenges with the current tokenomics model that necessitate an upgrade.
+
+The current tokenomics model of ThreeFold doesn't fully reflect the platform's worth and potential. An upgrade is essential to rectify existing challenges, ensuring that the tokenomics aligns with the platform's growth trajectory and offers a fair representation of its value.
+
+* Lack of Commercial Utilization: 
+    * The present model doesn't sufficiently incentivize commercial utilization. This means that the tokens, instead of being used to facilitate transactions or access services within the ecosystem, are often liquidated.
+* Selling Pressure from Farmers: 
+    * The current dynamics have led to a scenario where ThreeFold farmers frequently sell their tokens. This consistent selling exerts downward pressure on the token's price, preventing it from realizing its true potential value.
+* Undervalued Market Cap: 
+    * The cumulative effect of these factors has resulted in a market capitalization for the liquid tokens that is significantly undervalued. With a market cap hovering around 5 million dollars, it starkly contrasts with the intrinsic value and potential of the ThreeFold ecosystem.
+
+Future Optimism: Despite the current challenges, there's a strong belief in the imminent positive shift in the token's value. As ThreeFold gears up to launch more commercial workloads and with the anticipated funding for TF Cloud, there's an expectation of increased commercial utilization. This, in turn, can drive demand for the token, potentially boosting its price and aligning the market cap more closely with ThreeFold's true value.
+
+We are working on some fundamental changes which will achieve the following
+
+- TFT farming will slow down and there will probably never be more than 1 billion TFT ever
+- Farmers will receive more reward based on Utilization
+- Staking is a required for becoming a future Farmer or Farming Cooperative
+- P2P Billing and Payments will lead to using TFT for much more services, which will have positive impact as well.
+
+> See: [https://github.com/threefoldtech/home/issues/1448](https://github.com/threefoldtech/home/issues/1448) 
+
+