From 94fcafbfe8bde83536659431e3e9a887544d06f2 Mon Sep 17 00:00:00 2001 From: Vitor Date: Sun, 10 Aug 2025 15:41:37 -0300 Subject: [PATCH 1/7] quickfix: broken link in table of contents --- src/content/docs/explanations/table-of-contents.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/src/content/docs/explanations/table-of-contents.mdx b/src/content/docs/explanations/table-of-contents.mdx index 22beaba..7452c56 100644 --- a/src/content/docs/explanations/table-of-contents.mdx +++ b/src/content/docs/explanations/table-of-contents.mdx @@ -46,7 +46,6 @@ Understanding how agent systems work within Torus: - [Agent Registration](https://docs.torus.network/explanations/builders/agent-registration/) — Registration economics, burn mechanisms, and discovery - [Agent Editing](https://docs.torus.network/explanations/builders/agent-editing/) — Update mechanics and storage architecture -- [Capability Permission](https://docs.torus.network/explanations/builders/capability-permission/) — Delegating access to agent endpoints and services - [Demand Signaling](https://docs.torus.network/explanations/builders/demand-signaling/) — Capability coordination and economic incentives - [Agent Server](https://docs.torus.network/explanations/builders/agent-server/) — API architecture, authentication, and capability sharing - [Agent Client](https://docs.torus.network/explanations/builders/agent-client/) — Communication patterns and authentication flow From aec3e64b1cdda15b7ec1cb26375f5247d10dfc9c Mon Sep 17 00:00:00 2001 From: rad2520 <84401808+rad2520@users.noreply.github.com> Date: Mon, 11 Aug 2025 23:47:30 +0200 Subject: [PATCH 2/7] Update index.mdx --- src/content/docs/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index c5d1009..aaa371a 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -8,7 +8,7 @@ import RedText from '/src/components/RedText.astro'; **Torus is a decentralized protocol that enables autonomous agents to self-organize into intelligent swarms to reach complex goals using a recursive permission delegation system.** -In plaint sight, Torus is super-intelligence self-assembling itself from the future, midwifed by renlabs. +In plain sight, Torus is super-intelligence self-assembling itself from the future, midwifed by renlabs. Whether you're looking to stake tokens, build agents, or coordinate with other agents, Torus provides the infrastructure for decentralized autonomous coordination. From ebcfd0cbdd28599614a221d0c3f66a1e1d8490f1 Mon Sep 17 00:00:00 2001 From: "https://github.com/Sipher" Date: Fri, 15 Aug 2025 18:23:14 -0300 Subject: [PATCH 3/7] Refactor documentation for v0.6, adding capability permissions, agent management, and emission permissions while improving links and content clarity --- astro.config.mjs | 29 +-- .../development/network/global-parameters.mdx | 26 ++- .../{agent-editing.mdx => agent-managing.mdx} | 8 +- .../builders/agent-registration.mdx | 4 +- .../capability-permissions.mdx | 4 + .../{v06 => builders}/control-space.mdx | 4 + .../emission-permissions.mdx | 4 + .../goal-leaders/emission-proposals.mdx | 4 +- .../{v06 => goal-leaders}/governance-dao.mdx | 4 + .../{v06 => goal-leaders}/permissions.mdx | 4 + .../recursive-delegation.mdx | 10 +- .../explanations/goal-leaders/root-agents.mdx | 2 +- .../docs/explanations/table-of-contents.mdx | 19 +- .../builders/create-permission.mdx | 6 +- .../builders/manage-capabilities.mdx | 4 +- .../builders/manage-permissions.mdx | 210 ------------------ ...t-your-agent.mdx => manage-your-agent.mdx} | 18 +- .../create-capability-permission.mdx} | 6 +- .../create-emission-permission.mdx | 126 +++++++++++ .../goal-leaders/manage-permissions.mdx | 179 +++++++++++++++ .../docs/how-to-guides/table-of-contents.mdx | 9 +- 21 files changed, 396 insertions(+), 284 deletions(-) rename src/content/docs/explanations/builders/{agent-editing.mdx => agent-managing.mdx} (80%) rename src/content/docs/explanations/{v06 => builders}/capability-permissions.mdx (98%) rename src/content/docs/explanations/{v06 => builders}/control-space.mdx (96%) rename src/content/docs/explanations/{v06 => goal-leaders}/emission-permissions.mdx (97%) rename src/content/docs/explanations/{v06 => goal-leaders}/governance-dao.mdx (94%) rename src/content/docs/explanations/{v06 => goal-leaders}/permissions.mdx (95%) rename src/content/docs/explanations/{v06 => goal-leaders}/recursive-delegation.mdx (85%) delete mode 100644 src/content/docs/how-to-guides/builders/manage-permissions.mdx rename src/content/docs/how-to-guides/builders/{edit-your-agent.mdx => manage-your-agent.mdx} (83%) rename src/content/docs/how-to-guides/{builders/recursive-delegation.mdx => goal-leaders/create-capability-permission.mdx} (96%) create mode 100644 src/content/docs/how-to-guides/goal-leaders/create-emission-permission.mdx create mode 100644 src/content/docs/how-to-guides/goal-leaders/manage-permissions.mdx diff --git a/astro.config.mjs b/astro.config.mjs index 1495d17..416774e 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -33,20 +33,6 @@ export default defineConfig({ label: "Explanations", items: [ { label: "Table of Contents", slug: "explanations/table-of-contents" }, - { - label: "v0.6", - collapsed: true, - items: [ - { label: "Control Space", slug: "explanations/v06/control-space" }, - { label: "Permission System", slug: "explanations/v06/permissions" }, - { - label: "Recursive Delegation", - slug: "explanations/v06/recursive-delegation", - }, - { label: "Emission Permissions", slug: "explanations/v06/emission-permissions" }, - { label: "Governance & DAO", slug: "explanations/v06/governance-dao" }, - ], - }, { label: "Holders", collapsed: true, @@ -61,10 +47,12 @@ export default defineConfig({ collapsed: true, items: [ { label: "Agent Registration", slug: "explanations/builders/agent-registration" }, - { label: "Agent Editing", slug: "explanations/builders/agent-editing" }, + { label: "Agent Managing", slug: "explanations/builders/agent-managing" }, { label: "Demand Signaling", slug: "explanations/builders/demand-signaling" }, { label: "Agent Server", slug: "explanations/builders/agent-server" }, { label: "Agent Client", slug: "explanations/builders/agent-client" }, + { label: "Control Space", slug: "explanations/builders/control-space" }, + { label: "Capability Permissions", slug: "explanations/builders/capability-permissions" }, ], }, { @@ -73,6 +61,10 @@ export default defineConfig({ items: [ { label: "Root Agents", slug: "explanations/goal-leaders/root-agents" }, { label: "Emission Proposals", slug: "explanations/goal-leaders/emission-proposals" }, + { label: "Permission System", slug: "explanations/goal-leaders/permissions" }, + { label: "Recursive Delegation", slug: "explanations/goal-leaders/recursive-delegation" }, + { label: "Emission Permissions", slug: "explanations/goal-leaders/emission-permissions" }, + { label: "Governance & DAO", slug: "explanations/goal-leaders/governance-dao" }, ], }, { label: "Concepts & Terminology", slug: "explanations/concepts-terminology" }, @@ -96,10 +88,8 @@ export default defineConfig({ collapsed: true, items: [ { label: "Register an Agent", slug: "how-to-guides/builders/register-an-agent" }, - { label: "Edit your Agent", slug: "how-to-guides/builders/edit-your-agent" }, + { label: "Manage your Agent", slug: "how-to-guides/builders/manage-your-agent" }, { label: "Manage Capabilities", slug: "how-to-guides/builders/manage-capabilities" }, - { label: "Manage Permissions", slug: "how-to-guides/builders/manage-permissions" }, - { label: "Recursive Delegation", slug: "how-to-guides/builders/recursive-delegation" }, { label: "Create a Signal", slug: "how-to-guides/builders/create-signal" }, { label: "Setup Agent Server", slug: "how-to-guides/builders/setup-agent-server" }, { label: "Setup Agent Client", slug: "how-to-guides/builders/setup-agent-client" }, @@ -111,6 +101,9 @@ export default defineConfig({ items: [ { label: "Become a Root Agent", slug: "how-to-guides/goal-leaders/become-a-root-agent" }, { label: "Create Emission Proposal", slug: "how-to-guides/goal-leaders/create-emission-proposal" }, + { label: "Create Capability Permission", slug: "how-to-guides/goal-leaders/create-capability-permission" }, + { label: "Create Emission Permission", slug: "how-to-guides/goal-leaders/create-emission-permission" }, + { label: "Manage Permissions", slug: "how-to-guides/goal-leaders/manage-permissions" }, ], }, ], diff --git a/src/content/docs/development/network/global-parameters.mdx b/src/content/docs/development/network/global-parameters.mdx index 64a08af..03da304 100644 --- a/src/content/docs/development/network/global-parameters.mdx +++ b/src/content/docs/development/network/global-parameters.mdx @@ -11,25 +11,23 @@ Global Parameter changes require a proposal to pass through the [DAO governance ### 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. +- **`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 (~5.93 TORUS). It specifies the amount of new tokens emitted in each block. +- **`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_reciclying_percentage`**: Percentage of emission recycled (default: 100%). Controls how much emission is recycled back into the system. +- **`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. @@ -37,15 +35,15 @@ Global Parameter changes require a proposal to pass through the [DAO governance - **`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. +- **`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: 10 TORUS). Sets minimum amount of tokens to burn for registration. +- **`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: 150 TORUS). Sets upper limit on registration burn amount. +- **`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. @@ -55,7 +53,7 @@ Global Parameter changes require a proposal to pass through the [DAO governance - **`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. +- **`treasure_emission_fee`**: Treasury fee on emissions (default: 5%). Percentage of emissions allocated to the treasury. ### Weight & Reward Parameters @@ -80,10 +78,16 @@ Global Parameter changes require a proposal to pass through the [DAO governance - **`agent_application_expiration`**: Agent application expiration (default: 216,000 blocks). Duration before agent applications expire. -## Listing parameters through CLI +## Querying Parameters + +### Using CLI You can query all of these global parameters using CLI: ```bash torus network params -``` \ No newline at end of file +``` + +### Using Polkadot.js Apps + +You can also query current parameter values directly using [Polkadot.js Apps](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fapi.torus.network#/chainstate). 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. \ No newline at end of file diff --git a/src/content/docs/explanations/builders/agent-editing.mdx b/src/content/docs/explanations/builders/agent-managing.mdx similarity index 80% rename from src/content/docs/explanations/builders/agent-editing.mdx rename to src/content/docs/explanations/builders/agent-managing.mdx index a719934..48ea890 100644 --- a/src/content/docs/explanations/builders/agent-editing.mdx +++ b/src/content/docs/explanations/builders/agent-managing.mdx @@ -1,5 +1,5 @@ --- -title: Agent Editing +title: Agent Managing description: Understanding agent lifecycle, ownership, and the mechanics of agent updates in Torus. --- @@ -13,8 +13,8 @@ import { } from "@astrojs/starlight/components"; -Agent editing in Torus allows agents to update their metadata, endpoints, and social connections after initial registration. -Only the original registering wallet maintains editing rights, ensuring agent integrity. +Agent managing in Torus allows agents to update their metadata, endpoints, and social connections after initial registration. +Only the original registering wallet maintains management rights, ensuring agent integrity. Agents can modify display information (titles, descriptions), service endpoints, visual assets, and social media links. Core identifiers and cryptographic associations remain immutable once set during registration. @@ -38,5 +38,5 @@ This balances blockchain immutability with the flexibility needed for comprehens - **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - Special considerations for DAO-approved agents diff --git a/src/content/docs/explanations/builders/agent-registration.mdx b/src/content/docs/explanations/builders/agent-registration.mdx index fd60bd4..4025be1 100644 --- a/src/content/docs/explanations/builders/agent-registration.mdx +++ b/src/content/docs/explanations/builders/agent-registration.mdx @@ -45,8 +45,8 @@ Agent metadata is stored off-chain via IPFS but referenced on-chain through cont ### Related Concepts - **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - Agents that receive emissions directly -- **[Permission System](https://docs.torus.network/explanations/v06/permissions/)** - How agents interact and delegate authority -- **[Governance & DAO](https://docs.torus.network/explanations/v06/governance-dao/)** - Understanding DAO decision-making processes +- **[Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/)** - How agents interact and delegate authority +- **[Governance & DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/)** - Understanding DAO decision-making processes