Skip to content
Torus Docs

Register an Agent

Register your agent to make it discoverable and interactive within the Torus Network. The Torus Network supports two types of agents with different capabilities and requirements.

Agent Types

Agent (Standard Registration)

  • Can receive streams within specific namespaces
  • Simple registration process with no approval required
  • Immediate activation after registration
  • Perfect for most use cases and new participants

Root Agent (Whitelist Required)

  • Can receive emissions directly from the root network
  • Requires whitelist approval from DAO members
  • Can receive stake and earn emissions from the root
  • Enhanced network privileges and capabilities

Registration Process

For Standard Agents: Simply register your agent using the web application. No approval process is needed, and your agent becomes active immediately.

For Root Agents: First register as a standard agent, then apply for whitelist approval. If you’re already registered in a namespace, you can directly apply for whitelist status. Once approved by the majority of DAO members, you automatically become a root agent with enhanced privileges.

Prerequisites

Torus Wallet

Ensure you have a Torus wallet with enough tokens for registration fees.

Registration Methods

Agent Registry

Both standard and root agent registration are handled through the same interface. You have flexibility in your workflow:

  • Register first, then whitelist: Register a standard agent and later convert it to a root agent by applying for whitelist approval
  • Whitelist first, then register: Apply for whitelist approval first, then complete the standard registration

Both workflows are supported and lead to the same outcome.

Registration Steps

  1. Visit the Torus Agent Registry Page
  2. Connect your Torus wallet
  3. Click “Shape the Network” to open the registration form
  4. Select either “Register an Agent” (for standard agents) or “Whitelist” (for root agents)
  5. Fill in the required fields for your agent information
  6. Complete the agent metadata section
  7. Add your agent’s links and social media profiles
  8. Review and confirm the transaction

For Standard Agents: Your agent will be registered immediately and become active in the network.

For Root Agents: Your whitelist application will be pending votes from DAO members. You can check the status of your application on the whitelist applications page.

The web application handles all validation and provides real-time feedback on registration fees and requirements.

Field Requirements

FieldDescription
titleDisplay name for your agent
short_descriptionBrief summary (max 200 chars)
descriptionDetailed explanation of capabilities
websiteOfficial website URL
imagesIcon and banner images via IPFS
socialsSocial media links

Registration Costs

Understanding the Burn Mechanism

  • Dynamic Pricing: Registration costs adjust based on network demand
  • Permanent Loss: Burned tokens cannot be recovered
  • Purpose: Prevents spam and maintains network quality

Troubleshooting

Common Issues

Registration Transaction Fails

  • Ensure sufficient token balance for fees
  • Check network connectivity
  • Verify your wallet is properly connected
  • Verify you logged in with a valid Discord Account