docs: Steve/economics of starknet (#1129)

* Fixes to index.adoc.

* Added new page on Economics-of-Starknet

components/Starknet/modules/ROOT/pages/index.adoc

@@ -1,10 +1,10 @@
 [id="overview"]
 = Overview
 
-Starknet is a permissionless, decentralized zero-knowledge rollup (ZK rollup) for Ethereum. It operates as a Layer 2 (L2) blockchain, enabling any dApp to achieve unlimited scale for its computation without compromising on Ethereum’s composability
+Starknet is a permissionless, Validity-Rollup, also known as a zero-knowledge rollup (ZK rollup) for Ethereum. It operates as a Layer 2 (L2) blockchain, enabling any dApp to achieve massive scale for its computation without compromising on Ethereum’s composability
 and security.
 
-Starknet achieves secure low cost transactions and high performance by using the STARK cryptographic proof system. Starknet contracts and the Starknet OS are written in link:https://github.com/starkware-libs/cairo[Cairo], a custom-built and
+Starknet aims to achieves secure low cost transactions and high performance by using the STARK cryptographic proof system. Starknet contracts and the Starknet OS are written in link:https://github.com/starkware-libs/cairo[Cairo], a custom-built and
 specialized programming language.
 
 == Explore Starknet

components/Starknet/modules/architecture_and_concepts/nav.adoc

@@ -38,3 +38,5 @@
 *** xref:Cryptography/p-value.adoc[The STARK field]
 *** xref:Cryptography/stark-curve.adoc[The STARK curve]
 *** xref:Cryptography/hash-functions.adoc[Hash functions]
+
+* xref:Economics-of-Starknet.adoc[The Economics of Starknet]

components/Starknet/modules/architecture_and_concepts/pages/Economics-of-Starknet.adoc

@@ -0,0 +1,100 @@
+[id="economics_of_starknet"]
+= The Economics of Starknet
+
+Starknet is a developing decentralized protocol and the economic mechanisms described here are subject to change based on governance decisions made by the larger community of Starknet. For more details on Starknet’s governance processes see the link:https://governance.starknet.io/[Starknet Governance Hub]. The technical documents provided here describe certain economic fundamentals of the Starknet token. These materials are intended for informational purposes only and are meant to outline the usage and functionalities of the asset within Starknet. It is important to understand that the primary purpose of the Starknet token is to facilitate operations and activities on Starknet and it is not intended to serve as an investment.
+
+
+[#why_are_economics_relevant]
+== Why are economics relevant?
+
+Blockchains work through a combination of cryptography and economic incentives. Cryptography limits what actors in the system can do (e.g. transactions must be validly signed to be included in the chain), while economic incentives encourage actors to voluntarily perform actions that maintain the network’s capabilities, while spending their own resources (e.g. miners or stakers actively publish new blocks to the chain because they can take fees and new tokens as a reward). Blockchains are valuable because they are data structures maintained by diverse and, ideally, large groups of otherwise unaffiliated persons. This gives them resilience: any one participant can disappear but the data structure will be preserved. This also gives them censorship resistance: no single person can unilaterally decide to forbid certain persons from using the network.
+
+Starknet operates as a Layer 2 (L2) network on top of Ethereum. Today, Starknet achieves secure low-cost transactions by using the STARK cryptographic proof system to reduce the size of transaction data while preserving and verifying the integrity of that data. Still under development, Starknet will achieve resilience and censorship resistance by using a token, the Starknet token (STRK), to incentivize network participants to sequence transactions for users of the network and to ensure that there is a provably fair mechanism, a proof-of-stake mechanism, to determine who should sequence and submit a proof for the network blocks. A proof-of-stake mechanism might also be used to facilitate data availability solutions and other significant services required for network operations.
+
+// Mini TOC
+
+
+
+
+
+[#purpose_of_the_token]
+== The purpose of the STRK token
+
+The Starknet token is the mechanism for paying fees to enable operation of the network, maintaining and securing the network by enabling staking for consensus, and deciding on Starknet’s values and technology goals by voting for governance proposals.
+
+* *Transaction fees:* Originally, fees in Starknet were paid only in Ether (ETH). As of v.0.13.0, fees for transactions on the network can be paid for using the Starknet token, as well as Ether.
+
+* *Staking:* Certain services that are critical to the liveness and security of Starknet may require the staking of Starknet tokens. These services might be offered by multiple providers, and could include sequencing, reaching temporary L2 consensus before L1 finality is reached, STARK-proving services, and data availability provisioning, to name a few examples. These https://starkware.co/resource/starknet-decentralization-a-roadmap-in-broad-strokes/[protocol changes] are still under discussion within the larger governance community and are targeted for https://starkware.co/resource/starknet-decentralization-a-roadmap-in-broad-strokes/[2024 -2025].
+
+* *Governance:* Proposals for improving Starknet might require a minimal token support threshold. Voting, either directly or via delegation, will be required for changes to the protocol that are essential to Starknet’s liveness, security, and maintenance. Today, for example, major updates to the Starknet Operating System require the approval of token holders.
+For more information about Governance see the https://governance.starknet.io/[Starknet Governance Hub]
+
+[IMPORTANT]
+====
+As discussed above, the Starknet tokens are digital assets intended to support the operation and usage of Starknet and are not offered as an investment. As such, the Starknet tokens do not represent any equity in StarkWare or the Starknet Foundation, nor do they provide any participation right in StarkWare or grant any right of claim from StarkWare or the Starknet Foundation.
+====
+
+
+[#supply_and_distribution]
+== Supply and distribution
+
+Ten billion Starknet tokens were initially created by StarkWare in May 2022 and minted on chain on November 30, 2022.
+
+The existing ten billion tokens have been or are planned to be distributed according to the following:
+
+[cols="1,2,5",]
+|===
+// |Percentage of total| Recipients | Details
+
+|20.04% |Early Contributors |Tokens allocated for StarkWare’s team members and early contributors. These tokens are subject to a lock-up schedule, as further detailed below.
+|18.17% |Investors |Tokens allocated for StarkWare’s investors. These tokens are subject to a lock-up schedule, as further detailed below.
+|10.76% |StarkWare |Tokens allocated for StarkWare for operation services such as to pay fees, provide other services on Starknet, and engage other service providers.
+|12.93% |Grants including Development Partners (aka DPs) |Tokens allocated for grants for research or work done to develop, test, deploy and maintain the Starknet protocol. The process for applications and allocations related to Starknet Foundation Grants will be outlined in a post at a later date.
+|9.00% |Community Provisions |Tokens distributed to those who contributed to Starknet and powered or developed its underlying technology.
+|9.00% |Community Rebates |Tokens allocated for rebates in Starknet tokens to partially cover the costs of onboarding to Starknet from Ethereum. Community rebates are not yet available and will be announced in 2024 in a subsequent post.
+|https://www.starknet.io/en/content/introducing-the-starknet-foundation[10.00%] |Foundation Strategic Reserves |Tokens allocated for the Starknet Foundation to fund ecosystem activities that are aligned with the Foundation’s mission.
+|8.10% |Foundation Treasury |Token allocated for the Starknet Foundation’s treasury available for operations and other future initiatives by the Starknet Foundation.
+|2.00% |Donations |Tokens reserved for donations to institutions and organizations, such as universities, NGOs, etc, as decided by the Starknet Foundation.
+|===
+
+// Insert chart
+
+To align long-term incentives of the Investors and Early Contributors with the interests of the Starknet community, and following common practice in decentralized ecosystems, all tokens allocated to Investors and Early Contributors will be subject to the following lock-up schedule, where percentages are based on the total token supply:
+
+* up to 13.1% (1.314B tokens) on April 15, 2024
+* up to 0.4% (40M tokens) on April 30, 2024, and thereafter
+* up to 0.8% (80M tokens) in equal monthly installments over the next 31 months (total of 24.68%, or 2.468B tokens over 31 months)
+
+Through this lock-up period, token holders cannot transfer, sell, or pledge their STRK tokens. Delegation of voting is permitted with locked tokens and, when available, staking might also be permitted.
+
+====
+_Token allotments currently retained by the Starknet Foundation, while contractually unlocked, are not considered circulating unless granted, donated, or otherwise allocated out of originating wallets through future grants, provisions, donations, developer initiatives, or other programs._
+====
+
+The total circulating supply of tokens is planned to increase over time with the minting of new tokens by the protocol, as staking rewards, block rewards, or other rewards associated with the staking process. Such minting will be made pursuant to a schedule that will be determined with the community at a later point, not before Starknet services are more decentralized. The supply in circulation might not, therefore, remain fixed. However, as long as StarkWare is the sole operator of the Starknet sequencer, there will be no issuance of new tokens for the purpose of block rewards. For more information, see link:https://starkware.co/resource/a-token-minting-proposal-to-manage-inflation/[_A token-minting proposal to manage inflation_].
+
+[#risks_and_disclaimers]
+== Risks and disclaimers
+
+Starknet is a developing decentralized protocol and the economic mechanisms described herein are subject to change based on decisions made by the larger community of Starknet builders and users. Starknet relies upon third parties to adopt and implement software and protocols as users and contributors of Starknet. It also relies, in whole or partly, on third parties to develop, supply and otherwise support it. There is no assurance or guarantee that such third parties will continue to participate in the network or that the network will continue to function as intended.
+
+The technical documents provided herein describe certain planned and specified economic fundamentals of a digital asset, STRK. These materials are intended for informational purposes only and are meant to outline the usage and functionalities of the asset within Starknet. It is important to understand that the primary purpose of STRK is to pay for fees, provide a mechanism for securing consensus, and allow for decentralized governance on Starknet; it is not intended to serve as an investment.
+
+Starknet relies upon third parties to adopt and implement the software and protocols as users of Starknet. It also relies, in whole or partly, on third parties to develop, supply and otherwise support it. As a Layer 2 network over Ethereum, Starknet also relies upon third parties maintaining and operating the Ethereum network. There is no assurance or guarantee that those third parties will complete their work, properly carry out their obligations, and/or otherwise meet anyone’s needs.
+
+STRK, as the native token of Starknet, may be subject to the risks of the Starknet network, including, without limitation, the following: (i) the technology associated with Starknet may not function as intended; (ii) the details of the Starknet token economics including the total supply and distribution schedule may be changed due to decisions made by the consensus of participants of the Starknet network; (iii) Starknet may fail to attract sufficient interest from key stakeholders or users; (iv) Starknet may not progress satisfactorily and Starknet tokens may not be useful or valuable; (v) Starknet may suffer from attacks by hackers or other individuals; and (vi) Starknet is comprised of open-source technologies that depend on a network of computers to run certain software programs to process transactions, and because of this model StarkWare and the Starknet Foundation have limited control over Starknet. 
+
+Risks related to blockchain technology in general and Starknet in particular may impact the usefulness of Starknet, and, in turn, the utility or value of STRK. The software and hardware, technology and technical concepts and theories applicable to Starknet and STRK are still in an early development stage and unproven, there is no warranty that Starknet will achieve any specific level of functionality or success, nor that the underlying technology will be uninterrupted or error-free, and there is an inherent risk that the technology could contain weaknesses, vulnerabilities or bugs causing, potentially, the complete loss of any Starknet tokens held by Starknet users.
+
+As with most commonly used public blockchains, STRK is accessed using a private key that corresponds to the address at which they are stored. If the private key, or the "seed" used to create the address and corresponding private key are lost or stolen, the tokens associated with that address might be unrecoverable and will be permanently lost. 
+
+Public blockchain-based systems, including Starknet and the underlying Ethereum network, depend on independent verifiers, and therefore may be vulnerable to consensus attacks including, but not limited to, double-spend attacks, majority voting power attacks, race condition attacks, and censorship attacks. These attacks, if successful, could result in the permanent loss of STRK.
+
+Starknet, STRK, and blockchain technology are nascent, and there may be additional risks not described above or that may be new or unanticipated. We recommend only using Starknet or holding STRK if you are familiar with the technology and aware of the risks.
+
+This document and its contents are not, and should not be construed as, an offer to sell, or the solicitation of an offer to buy, any tokens, nor should it or any part of it form the basis or be relied on in connection with any contract or commitment whatsoever. This document is not advice of any kind, including legal, investment, financial, tax, or any other professional advice. Nothing in this document should be read or interpreted as a guarantee or promise of how the Starknet network or its STRK will develop, be utilized, or accrue value.
+
+All information in this document is provided on an “as is” basis without any representation or warranty of any kind. This document only outlines current plans, which could change at the discretion of various parties, and the success of which will depend on many factors outside of Starknet Foundation’s control. Such future statements necessarily involve known and unknown risks, which may cause actual performance and results in future periods to differ materially from what we have described or implied in this document. StarkWare and the Starknet Foundation disclaim all warranties, express or implied, to the fullest extent permitted by law with respect to the functionality of the Starknet and STRK.
+
+
+