diff --git a/astro.config.mjs b/astro.config.mjs index d2e16e6..bc1e301 100644 --- a/astro.config.mjs +++ b/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", }, ], }, diff --git a/src/content/docs/chain/global-parameters.mdx b/src/content/docs/chain/global-parameters.mdx new file mode 100644 index 0000000..623e3d4 --- /dev/null +++ b/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 +``` diff --git a/src/content/docs/subspace/running-the-chain.mdx b/src/content/docs/chain/running-the-chain.mdx similarity index 100% rename from src/content/docs/subspace/running-the-chain.mdx rename to src/content/docs/chain/running-the-chain.mdx diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index 71cd432..664d347 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -58,7 +58,7 @@ The v0 represents an early ecosystem growth period while the v1 Torus architectu />