Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -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",
},
],
},
Expand Down
89 changes: 89 additions & 0 deletions src/content/docs/chain/global-parameters.mdx
Original file line number Diff line number Diff line change
@@ -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
```
2 changes: 1 addition & 1 deletion src/content/docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
60 changes: 0 additions & 60 deletions src/content/docs/subspace/global-parameters.mdx

This file was deleted.