Merge pull request #30 from 0xcyp/feature/update-docs

Update docs

README.md

@@ -16,8 +16,8 @@ If you are familiar with using [Nix shell](https://nix.dev/manual/nix/2.17/comma
 
 ```bash
 # Clone the repository
-git clone https://github.com/status-network/docs.git
-cd docs
+git clone https://github.com/status-im/docs.status.network
+cd docs.status.network
 
 # Install dependencies
 yarn
@@ -69,15 +69,14 @@ We welcome contributions from the community! Here's how you can help improve our
 
 ```
 docs/
-├── introduction/         # Introduction and getting started
-├── tokenomics/          # SNT and AURA token documentation
-├── general-info/        # Network details and contracts
+├── introduction/       # Introduction and getting started
+├── tokenomics/         # Economic model and Karmic Tokenomics
+├── general-info/       # Network details and contracts
 ├── tools/              # Development tools and resources
 ├── tutorials/          # Step-by-step guides
-├── security/           # Security information
 └── other/              # Additional resources
 ```
 
 ---
 
-Made with ❤️ by the Status Network community
+Made with ❤️ by the Status Network team

docs/index.md

@@ -1,18 +1,45 @@
 ---
 id: index
-title: Welcome to Status Network
+title: Status Network · Gasless L2
 description: Status Network is a gasless Layer 2 blockchain network enabling seamless, fee-free decentralized applications. Start building with easy wallet setup, faucets, and deployment tools.
-keywords: [Status Network, Layer 2, gasless blockchain, ethereum scaling, web3 development, dapp development, blockchain development]
+keywords: [Status Network, Layer 2, gasless blockchain, ethereum scaling, L2, validium, web3 development, dapp development, blockchain development]
 slug: /
 sidebar_position: 1
 ---
 
-# Status Network: The Gasless Layer 2 Network
+# Status Network: The Gasless Layer 2
 
+Status Network is the first natively gasless Ethereum L2, optimized for social apps and games, featuring sustainable public funding for developers through native yield and DEX fees. Built on the Linea zkEVM stack, it provides high-performance, gas-free transactions while ensuring economic sustainability through a novel funding model.
 
-## Start Building Today
+## Key Features
 
-Ready to join the future of decentralized applications? Here's how to get started:
+- **Gasless Transactions** 
+
+Developers can create seamless experiences and users can transact freely without worrying about gas fees.
+
+- **Native Yield and Fees** 
+
+To sustain the L2 operation and support developers, Status Network is funded through a combinaison of native yield and fees coming from its native apps, starting with a DEX.
+
+- **Sustainable Public Funding**
+
+The apps funding pool, governed by token holders, continuously allocates capital from native yield and fees to onchain builders.
+
+- **High-Performance Execution**
+
+Status Network is built on Linea’s zkEVM rollup stack, ensuring fast and secure transactions.
+
+- **Spam Protection via RLN**
+
+Rate-Limiting Nullifiers (RLN) prevent spam and DDoS attacks while maintaining a fair allocation of free transactions per user and apps.
+
+- **Deep Integration with IFT**
+
+Status Network is natively integrated with Status Wallet, Keycard, Waku and Codex, all part of [IFT](https://free.technology).
+
+## Getting Started
+
+Wants to skip the explanation part and go straight to building? Here's how to get started:
 
 1. [Add Status Network to Your Wallet](/general-info/add-status-network)
 2. [Get Testnet ETH](/tools/testnet-faucets)
@@ -26,4 +53,4 @@ Connect with our community and access the resources you need:
 - View [Network Details](/general-info/network-details)
 - Browse [Contract Addresses](/general-info/contract-addresses/testnet-contracts)
 
-Ready to build something amazing? Start your journey with Status Network today!
+Ready to build something amazing? Start your journey on the free network today!

docs/tokenomics/economic-model.md

@@ -0,0 +1,18 @@
+# Economic Model
+
+Unlike traditional L2s that generate revenue from gas fees, Status Network operates on a radically different paradigm: users and applications do not pay transaction fees. This necessitates alternative revenue sources to maintain and sustain the network. As gas fees trend toward zero and rollups move toward decentralization, the business model of L2s must shift from execution-based revenue (sequencer fees) to monetizing asset trading volume and yield-bearing total value locked (TVL) on the network.
+
+## Revenue Streams
+
+To achieve sustainability, Status Network derives revenue from the following sources:
+
+- **Native Yield Commission**: Assets bridged to Status Network (ETH and DAI initially) are rehypothecated into yield-bearing equivalents (stETH and sDAI). A portion of the yield generated (30%) is allocated to the network's operational costs.
+
+- **Native DEX Swap Fees**: Status Network features a native DEX where trading fees contribute to network operation. Native DEX liquidity providers can earn extra incentives from the native yield on top of the usual LP fees.
+
+- **Premium Gas Fees**: Users exceeding their free transaction quota must pay a premium fee, which is split between Status Network and RLN (the spam prevention mechanism), incentivizing fair usage and discouraging abuse.
+
+- **Future Native Apps**: The network will later introduce additional revenue streams, such as a lending market, NFT marketplace, and token launchpad, each contributing a percentage of generated fees back into the L2 operation.
+
+This model ensures that Status Network remains economically sustainable while offering free transactions. By leveraging TVL and its associated native yield as well as transaction volume, Status Network aligns incentives between users, liquidity providers, and developers, creating a self-sustaining ecosystem without reliance on inflationary token emissions.
+

docs/tokenomics/karma-token.md

@@ -1 +0,0 @@
-# KARMA token

docs/tokenomics/karmic-tokenomics.md

@@ -0,0 +1,48 @@
+# Karmic Tokenomics
+
+In some Eastern traditions, Karma represents the principle that one's past actions shape their future state. Similarly, on Status Network, every positive action and contribution accumulates Karma, granting greater influence over the network's funding and incentives. Karma ($KARMA) is a non-transferable governance token that rewards staking, bridging, providing liquidity, and building. The more a user or an app contributes to the L2 in liquidity or activity, the more voting power they earn over funding allocations, liquidity incentives, and network roadmap and parameters.
+
+## How Karma is Earned
+
+Karma is minted through six primary mechanisms and cannot be aquired, ensuring that no entity—including the Status team—has any advantage in getting access to it. Everyone earns Karma under the same rules, based solely on their contributions to the network, ensuring it remains a pure representation of meaningful engagement within the network:
+
+1. **Staking SNT** – Anyone staking SNT receives Karma rewards proportionally. The longer one stakes or locks their SNT, the higher the Karma earning rate.
+
+2. **Bridging Yield-Bearing Assets** – Bridging ETH and DAI (initially, with more assets to be added later) to Status Network earns Karma.
+
+3. **Providing Liquidity** – On the native DEX, anyone can provide liquidity to curated pools to earn fees, native yield rewards, and Karma
+
+4. **Building and Using Applications** – Users and developers earn Karma through transaction volume and app traction. The more successful an app is, the higher Karma is allocated to its developers and users.
+
+5. **Paying Premium Gas Fees** – Users and apps exceeding their gasless throughput limit pay a premium gas fee that serves as a penalty but also earns them some Karma in return. Increasing their Karma might actually allow them to unlock higher gas-free transaction limits. 
+
+6. **Direct Donations** – Anyone contributing directly to the public funding pool receives Karma.
+
+The initialization parameters of Karma minting allocations will be announced soon. In the future, Karma holders will be able to modify those parameters through a vote if needed. The ultimate objective is to maximize alignment among stakeholders for a more sustainable growth of the network.
+
+## Utility of Karma
+
+- **Gasless Transactions**: As soon as an account has a positive Karma balance, it gains access to a certain throughput of free transactions. A tiered system allows users and apps with higher Karma to enjoy more free transactions per day. A dynamic rate-limiting mechanism prevents spam and ensures fair usage of the network.
+
+- **Governance Token**: Karma holders vote on the allocation of the apps funding pool. Higher Karma scores have more weight in funding distribution - they can decide to prioritize their favourite applications or protocols.
+
+- **Native DEX Liquidity Incentives**: Karma holders vote on the incentive gauges for all curated liquidity pools on the native DEX.
+
+- **Network Policy Decisions**: Karma holders vote on the L2 economic and operational parameters, inlcuding native yield and fees distribution, Karma minting rate and allocation, etc.
+
+- **Loyalty and Reputation System**: Since Karma is soulbound, high Karma scores signal power users and key contributors within the ecosystem. The users progressively accumulate influence and may gain access to extra incentives and perks (e.g. rewards from apps building on the network and seeking to attract high-quality users).
+
+- **Liquid Grants for Votes**: In the future, apps, protocols, and liquidity providers will be able to offer liquid grants to Karma holders as voting incentives.
+
+
+## Flywheel Effect
+
+1. Users bridge yield-bearing assets, earning Karma and increasing funding for apps and liquidity providers.
+
+2. Higher app funding attracts new apps to deploy on the network.
+
+3. Funded apps onboard more users, increasing transaction volume on the native DEX.
+
+4. Higher native yield and fees attract more TVL as users bridge additional yield-bearing assets.
+
+As TVL and adoption grow, so do funding opportunities, reinforcing network sustainability.

docs/tokenomics/public-funding.md

@@ -0,0 +1,21 @@
+# Public Funding
+
+## Apps Funding Pool and Public Funding Mechanism
+
+One of the most critical components of Status Network is the apps funding pool, designed to provide sustainable financial support for applications built on the network. Unlike traditional blockchain ecosystems where developers rely on grants or short-term incentives, Status Network ensures continuous funding through a self-sustaining mechanism driven by network activity and TVL.
+
+### Why Public Funding Matters
+
+Public funding is essential to ensure that builders have access to capital without dependence on extractive external funding mechanisms. The Status organisation has a long-standing history of investing in open-source projects and decentralised infrastructure, reinforcing its commitment to public goods. The apps funding pool extends this ethos by providing a decentralized, community-driven allocation mechanism where developers can receive financial support directly from the network itself.
+
+### How the Apps Funding Pool Works
+
+- **Funded by Native Yield and Fees**: A significant part of the yield generated from bridged assets (ETH and DAI initially) and from the native DEX swap fees flows directly into the funding pool.
+
+- **Governed by Karma Holders**: Allocation of funds is determined by Karma token holders, ensuring a community-led decision-making process: if the community loves your app, you'll get funding.
+
+- **Transparent and Fair Distribution**: Initially, funding will be capped at a limited number of recipients to maintain quality control, but as the pool grows, more projects will be supported.
+
+- **Aligning Builders with Network Growth**: Developers who actively contribute to network usage and adoption will receive more voting power in the form of Karma, allowing them to vote for themselves and reinforcing the incentive to create valuable applications.
+
+This mechanism ensures a continuous, non-extractive source of capital for builders, allowing them to focus on creating successful applications.

docs/tokenomics/snt-staking.md

@@ -0,0 +1,31 @@
+# SNT Staking
+
+## Status Network Token (SNT)
+
+Launched in June 2017, the Status Network Token (SNT) serves as the native utility token of the Status ecosystem, a decentralized platform combining a messenger, web3 wallet, and gateway to decentralized applications on the Ethereum blockchain. SNT was designed to promote a decentralized and user-governed ecosystem, enabling holders to participate in governance, access features, and engage in various activities within the network. Over the years, SNT has facilitated user interactions within the Status app, allowing for voting on proposals, creating Ethereum Name Service (ENS) names, and accessing exclusive features. 
+
+With the upcoming deployment of the SNT staking contract on Status Network testnet, SNT holders will soon have the opportunity to stake their tokens, earning rewards and contributing to the network's governance and incentivization.
+
+## Staking Contract
+
+The staking contract will introduce Multiplier Points, which reward long-term commitment. SNT holders will have two staking options:
+
+1. **Standard Staking**
+
+Users can stake SNT without a lock-up period.
+They receive Multiplier Points gradually over time.
+If a user stakes for 4 years without unstaking, they achieve a maximum 4x Multiplier.
+
+2. **Locked Staking**
+
+Users can lock their SNT for a predetermined period (up to 4 years).
+They immediately receive a bonus Multiplier Point as well as a bonus Multiplier for each year they lock in advance.
+For example, locking for 4 years grants an instant 5x Multiplier (1x base + 4x for locking).
+Over the four-year period, they continue accumulating additional Multiplier Points, similar to standard staking, until they reach a maximum 9x total Multiplier
+
+### Benefits of Staking SNT
+
+- **Earning Karma**: Stakers accumulate Karma, which grants governance power and access to gasless transactions.
+- **Higher Free Transaction Quotas**: Users with more Karma enjoy greater gasless transaction limits.
+- **Boosted Governance Influence**: As they accumulate Karma, SNT stakers can play a critical role in public funding allocation, liquidity incentivization and network policy decisions.
+- **Higher Reputation**: By staking their SNT, holders can signal alignment with the ecosystem and showcase a reputation score in the form of Karma. Apps in the ecosystem have a strong incentive to attract users with high reputation.

docs/tokenomics/snt-token.md

@@ -1 +0,0 @@
-# SNT Token

sidebars.ts

@@ -10,7 +10,7 @@ const sidebars: SidebarsConfig = {
         {
           type: 'doc',
           id: 'index',
-          label: '🏠 Home',
+          label: '🌴 Home',
         },
         {
           type: 'doc',
@@ -26,13 +26,23 @@ const sidebars: SidebarsConfig = {
       items: [
         {
           type: 'doc',
-          id: 'tokenomics/snt-token',
-          label: '💎 SNT Token',
+          id: 'tokenomics/economic-model',
+          label: '🤝 Economic Model',
         },
         {
           type: 'doc',
-          id: 'tokenomics/karma-token',
-          label: '💠 Karma Token',
+          id: 'tokenomics/public-funding',
+          label: '💰 Public Funding',
+        },  
+        {
+          type: 'doc',
+          id: 'tokenomics/karmic-tokenomics',
+          label: '🐉 Karmic Tokenomics',
+        },       
+        {
+          type: 'doc',
+          id: 'tokenomics/snt-staking',
+          label: '💎 SNT Staking',
         },
       ],
     },
@@ -59,7 +69,7 @@ const sidebars: SidebarsConfig = {
             {
               type: 'doc',
               id: 'general-info/contract-addresses/tokens',
-              label: '💰 Tokens',
+              label: '🪙 Tokens',
             },
             {
               type: 'doc',