fix(content): update CryptoEcon Section content (#1158)

This PR is adding new description to the CryptoEconomics section of the spec. The description includes a table with the basic parameters, as well as justification for the design principles of Filecoin's cryptoeconomic model.

Co-authored-by: zixuanzh <[email protected]>
Co-authored-by: Hugo Dias <[email protected]>

content/algorithms/cryptoecon/_index.md

@@ -1,26 +1,63 @@
 ---
-title: Cryptoecon
-weight: 8
+title: Filecoin CryptoEconomics
+weight: 9
 dashboardWeight: 2
-dashboardState: incorrect
+dashboardState: reliable
 dashboardAudit: missing
 dashboardTests: 0
 ---
 
-# Cryptoecon
+# Filecoin CryptoEconomics
 
-The Filecoin network is a complex multi-agent economic system. This section aims to explain some mechanisms and parameters in the system that can help achieve network-level goals. For now, just lists some key mechanisms and parameters that are still subject to changes during testnet but that must be resolved before mainnet launch. Note that this is a list of economic levers that are in consideration and not all of them will be used in mainnet. Some may be added or changed after mainnet launch, through the FIP process, requiring a **network upgrade**.
+The Filecoin network is a complex multi-agent economic system. The CryptoEconomics of Filecoin touch on most parts of the system. As such related mechanisms and details have been included in many places across this specification. This section aims to explain in more detail the mechanisms and parameters of the system that contribute to the overall network-level goals.
 
-1. **Block reward minting function** - parameters may change over time, including the exponent of the block reward decay function.
-2. **Block reward vesting function** - block reward earned from mining may be required to vest over some period of time.
-3. **Pledge collateral function and slashing** - pledge collateral needs to satisfy certain security constraints for consensus and hence needs to be re-evaluated.
-4. **Deal collateral requirement** - minimum deal collaterals may be adjusted to achieve appropriate incentive structure.
-5. **Interactive PoRep slashing** - some penalties may be introduced for failing `ProveCommit` in interactive `PoRep`.
-6. **Network transaction fee** - burned as a network fee during proof or transaction submission.
-7. **Reward for pledged but unused storage** - explicit reward for available but unused storage.
-8. **Minimum miner size** - the minimum size of sectors a storage miner must have to produce blocks. There are several security and scalability parameters that depend on this.
+Next, we provide the parameters of the cryptoeconomic model. It is advised that the reader refers to the following sections that are closely related to the Filecoin CryptoEconomic model.
 
-{{< hint warning >}}
-This list is incomplete, you can help by expanding it.
-{{< /hint >}}
+- [Miner Collaterals](miner_collaterals)
+- [The Minting Model](filecoin_token#minting_model)
+- [Token Allocation](filecoin_token#token_allocation)
 
+## Initial Parameter Recommendation
+
+Economic analyses and models were developed to design, validate, and parameterize the mechanisms described in the sections listed above. Cryptoeconomics is a young field, where global expertise is both sparse and shallow. Developing these recommendations is advancing the state of the art, not only in the field of decentralized storage networks, but also of cryptoeconomic mechanism design as a wider discipline.
+
+The following table summarizes initial parameter recommendations for Filecoin. Monitoring, testing, validation and recommendations will continue to evolve and adapt. When changes to these parameters are due they will be announced and applied through FIPs.
+
+
+| **Parameter**  | **Value**   |
+| :------------- | :---------- |
+| Baseline Storage Amount Initial Value | 2.88888888 EB | 
+| Baseline Storage Amount Function  | 100% |
+| Percent simple minting vs baseline minting | 30% / 70% |
+| Reward delay and linear vesting period | 0 days |
+| Linear vesting period | 180 days |
+| Sector quality multipliers | Committed Capacity: 1x <br> Regular Deals: 1x <br> Verified Client Deals: 10x |
+| Initial pledge function | 20 days worth of block reward + <br> share of 30% qa power-normalized circulating supply | 
+| Initial Pledge Cap | 1FIL/32GiB QA Power |
+| Minimum sector lifetime | 180 days |
+| Maximum sector lifetime | 540 days |
+| Minimum deal duration | 180 days |
+| Maximum deal duration | 540 days |
+| Sector Fault Fee | 2.14 days worth of block reward|
+| Sector Fault Detection Fee | 1.5 days worth of estimated block reward |
+| Sector Termination Fee | Estimated number of days of block reward that a sector has earned; capped at 90 days |
+| Minimum Client Deal Collateral | 0 |
+| Minimum Provider Deal Collateral | share of 1% raw byte-normalised circulating supply |
+| Network Transaction Fee | Dynamic fee structure based on network congestion |
+
+
+## Design Principles Justification
+
+**Baseline Minting:** Filecoin tokens are a limited resource. The rate at which tokens are deployed into the network should be controlled to maximize their net benefit to the community, just like the consumption of any exhaustible common-pool resource. The purpose of baseline minting is to: (a) reward participants proportionally to the storage they provide rather than exponentially, based on the time when they joined the network, and (b) to adjust the minting rate based on approximated network utility in order to maintain a relatively steady flow of block rewards over longer time periods.
+
+**Initial Pledge:** The justification for having an initial pledge is as follows: firstly, having an initial pledge forces miners to behave responsibly on their sector commitments and holds them accountable for not keeping up to their promise, even before they earn any block reward. Secondly, requiring a pledge of stake in the network supports and enhances the security of the consensus mechanism.
+
+**Block Reward Vesting:** In order to reduce the initial pledge requirement of a sector, the network considers all vesting block rewards as collateral. However, tracking block rewards on a per-sector level is not scalable. Instead, the protocol tracks rewards at a per-miner level and linearly vests block rewards over a fixed duration.
+
+**Minimum Sector Lifetime:** The justification for a minimum sector lifetime is as follows. Committing a sector to the Filecoin Network currently requires a moderately computationally-expensive "sealing" operation up-front, whose amortized cost is lower if the sector's lifetime is longer. In addition, a sector commitment will involve on-chain transactions, for which gas fees will be paid. The net effect of these transaction costs will be subsidized by the block reward, but only for sectors that will contribute to the network and earn rewards for a sufficiently long duration. Under current constraints, short-lived sectors would reduce the overall capacity of the network to deliver useful storage over time.
+
+**Sector Fault Fee:** If stored sectors are withdrawn from the network only temporarily, a substantial fraction of those sectors' value may be recovered in case the data storage is quickly restored to normal operation — this means that the network need not levy a termination fee immediately. However, even temporary interruptions can be disruptive, and also damage confidence about whether the sector is recoverable or permanently lost. In order to account for this situation, the network charges a much smaller fee per day that a sector is not being proven as promised (until enough days have passed that the network writes off that sector as terminated).
+
+**Sector Fault Detection Fee:** If a sector is temporarily damaged, storage miners are expected to proactively detect, report, and repair the fault. An unannounced interruption in service is both more disruptive for clients and more of a signal that the fault may not have been caught early enough to fully recover. Finally, dishonest storage miners may have some chance of briefly evading detection and earning rewards despite being out of service. For all these reasons, a higher penalty is applied when the network detects an undeclared fault.
+
+**Sector Termination Fee:** The ultimate goal of the Filecoin Network is to provide useful data storage. Use-cases for unreliable data storage, which may vanish without warning, are much rarer than use-cases for reliable data storage, which is guaranteed in advance to be maintained for a given duration. So to the extent that committed sectors disappear from the network, most of the value provided by those sectors is canceled out, in most cases. If storage miners had little to lose by terminating active sectors compared to their realized gains, then this would be a negative externality that fails to be effectively managed by the storage market; termination fees internalize this cost.

content/algorithms/verified_clients/_index.md

@@ -0,0 +1,16 @@
+---
+title: Verified Clients
+weight: 8
+dashboardWeight: 2
+dashboardState: wip
+dashboardAudit: missing
+dashboardTests: 0
+---
+
+# Verified Clients
+
+As described earlier, verified clients as a construction make the Filecoin Economy more robust and valuable.  While a storage miner may choose to forgo deal payments and self-deal to fill their storage and earn block rewards, this is not as valuable to the economy and should not be heavily subsidized. However, in practice, it is impossible to tell useful data apart from encrypted zeros. Introducing verified clients pragmatically solves this problem through social trust and validation. There will be a simple and open verification process to become a verified client; this process should attract clients who will bring real storage demand to the Filecoin Economy.  
+
+Verifiers should eventually form a decentralized, globally distributed network of entities that confirms the useful storage demand of verified clients. If a verifier evaluates and affirms a client’s demand to have real data stored, that client will be able to add up to a certain amount of data to the network as verified client deals; this limit is called a DataCap allocation. Verified clients can request an increased DataCap once they have used their full allocation and Verifiers should perform some due diligence to ensure that the clients are not maliciously exploiting verification. The verification process will evolve over time to become more efficient, decentralized, and robust. 
+
+Storage demand on the network will shape the storage offering provided by miners. With the ability to deploy data with a greater sector quality multiplier, verified clients play an even more important role in shaping the quality of service, geographic distribution, degree of decentralization, and consensus security of the network. Verifiers and verified clients must be cognizant of the value and responsibility that come with their role.  Additionally, it is conceivable for miners to have a business development team to source valuable and useful datasets in the world, growing demand for the storage they provide.  Teams would be incentivized to help their clients through the verification process and start storing data on the Filecoin Network, in addition to providing their clients with strong SLAs.