Merge pull request #3 from renlabs-dev/dev

merge Dev with main

Author: kings177

astro.config.mjs

@@ -80,12 +80,12 @@ export default defineConfig({
           ],
         },
         {
-          label: "Subspace",
+          label: "The Chain",
           items: [
-            { label: "Global Parameters", slug: "subspace/global-parameters" },
+            { label: "Global Parameters", slug: "chain/global-parameters" },
             {
               label: "Running a Local Node",
-              slug: "subspace/running-the-chain",
+              slug: "chain/running-the-chain",
             },
           ],
         },

src/content/docs/chain/global-parameters.mdx

@@ -0,0 +1,89 @@
+---
+title: Global Parameters
+description: Global parameters are the parameters that are used to control the behavior of the Torus blockchain.
+---
+
+Global Parameters apply across the whole protocol. They allow to configure the protocols constraints to optimize its functioning. If problems appear, a parameter change might suffice to mitigate them. New parameters can be introduced.
+
+Global Parameter changes require a proposal to pass through the [DAO governance process](https://dao.torus.network/proposals).
+
+## Fields
+
+### Network & Registration Parameters
+
+- **`max_allowed_agents`**: The maximum number of agents allowed in the network (default: 10.000). Sets an upper limit on the total number of agents that can be registered.
+
+- **`max_registrations_per_block`**: The maximum number of registrations allowed per block (default: 10). Controls how many new registrations can be processed in a single block.
+
+- **`target_registrations_interval`**: The number of blocks that defines the registration interval (default: 142). Defines the target interval for registration calculations.
+
+- **`target_registrations_per_interval`**: The desired number of registrations per interval (default: 3). Sets the target number of registrations within each interval.
+
+- **`max_registrations_per_interval`**: The maximum registrations allowed per interval (default: 32). Upper limit on registrations processed per interval.
+
+### Token Emission Parameters
+
+- **`block_emission`**: The emission per block (~5.93 TORUS). It specifies the amount of new tokens emitted in each block.
+
+- **`halving_interval`**: Token supply at halving events (default: 144,000,000 TORUS). Defines when emission halving occurs.
+
+- **`max_supply`**: Maximum total token supply (default: 144,000,000 TORUS). Hard cap on total tokens that can exist.
+
+- **`emission_reciclying_percentage`**: Percentage of emission recycled (default: 100%). Controls how much emission is recycled back into the system.
+
+- **`incentives_ratio`**: Ratio for incentives distribution (default: 50%). Determines allocation between different incentive mechanisms.
+
+### Agent & Name Parameters
+
+- **`max_name_length`**: The maximum length allowed for an agent name (default: 32 characters). Sets upper limit on agent name length.
+
+- **`min_name_length`**: The minimum length allowed for an agent name (defaul: 2 characters). Sets lower limit on agent name length.
+
+- **`max_agent_url_length`**: The maximum URL length for agents (default: 64 characters). Controls agent URL field length.
+
+### Burn & Stake Parameters
+
+- **`min_burn`**: The minimum burn required for registration (default: 10 TORUS). Sets minimum amount of tokens to burn for registration.
+
+- **`max_burn`**: The maximum burn allowed for registration (default: 150 TORUS). Sets upper limit on registration burn amount.
+
+- **`min_allowed_stake`**: The minimum stake allowed (default: 0.5 TORUS). Specifies minimum amount that can be staked on an agent.
+
+### Fee Parameters
+
+- **`min_staking_fee`**: The minimum staking fee (default: 0%). Sets the lowest percentage that can be charged as staking fee.
+
+- **`min_weight_control_fee`**: The minimum weight control fee (default: 4%). Sets minimum fee for weight control operations.
+
+- **`treasure_emission_fee`**: Treasury fee on emissions (default: 20%). Percentage of emissions allocated to the treasury.
+
+### Weight & Reward Parameters
+
+- **`reward_interval`**: Blocks between reward distributions (default: 100). Determines how often rewards are distributed.
+
+- **`dividends_participation_weight`**: Participation weight for dividends (default: 40%). Controls dividend distribution weighting.
+
+### Governance Parameters
+
+- **`proposal_cost`**: The cost of creating a proposal (default: 10,000 TORUS). Amount required to submit a proposal, retuned when proposal passes.
+
+- **`proposal_expiration`**: The expiration time for proposals (default: 75,600 blocks). Duration after which proposals expire.
+
+- **`proposal_reward_treasury_allocation`**: Treasury allocation for proposal rewards (default: 2%). Percentage allocated for proposal rewards.
+
+- **`max_proposal_reward_treasury_allocation`**: Maximum proposal reward allocation (default: 10,000 TORUS). Cap on proposal reward amounts.
+
+- **`proposal_reward_interval`**: Reward distribution interval (default: 75,600 blocks). How often proposal rewards are distributed.
+
+- **`agent_application_cost`**: Cost to submit an agent application (default: 100 TORUS). Amount required for agent applications.
+
+- **`agent_application_expiration`**: Agent application expiration (default: 216,000 blocks). Duration before agent applications expire.
+
+
+## Listing parameters through CLI
+
+You can query all of these global parameters using CLI:
+
+```bash
+torus network params
+```

…tent/docs/subspace/running-the-chain.mdx …content/docs/chain/running-the-chain.mdxsrc/content/docs/subspace/running-the-chain.mdx renamed to src/content/docs/chain/running-the-chain.mdx src/content/docs/subspace/running-the-chain.mdx renamed to src/content/docs/chain/running-the-chain.mdx

@@ -58,7 +58,7 @@ The v0 represents an early ecosystem growth period while the v1 Torus architectu
   />
   <LinkCard
     title="Blockchain Code Documentation"
-    href="/subspace/torus-substrate"
+    href="/chain/torus-substrate"
     description="Learn the structure of Torus source code, and how to contribute."
   />
   <LinkCard