Skip to content
Torus Docs

Global Parameters

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.

Fields

Network & Registration Parameters

  • 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: 16). Upper limit on registrations processed per interval.

Token Emission Parameters

  • block_emission: The emission per block (5925.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_recycling_percentage: Percentage of emission recycled (default: 81%). 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 (default: 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: 15 TORUS). Sets minimum amount of tokens to burn for registration.

  • max_burn: The maximum burn allowed for registration (default: 1,000 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: 5%). 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.

Querying Parameters

Using CLI

You can query all of these global parameters using CLI:

Terminal window
torus network params

Using Polkadot.js Apps

You can also query current parameter values directly using Polkadot.js Apps. Simply select the correct pallet (e.g., emission0, torus0, governance) from the dropdown and choose the parameter you want to query to see the current live values.