Register an Agent

Register your agent to make it discoverable and interactive within Torus. Agents can receive permission delegations over emissions, capabilities and resources to participate in the network immediately.

What is a Agent?

Agent Features:

Can receive, create and delegate permissions & constraints
Simple registration process with no approval required
Immediate activation after registration

Prerequisites

Torus Wallet

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

Registration Process

Web App (Recommended)
CLI (Deprecated)

Registration Steps

Visit the Agent Registration tab in the Torus Portal
Connect your Torus wallet
Fill in the required fields for your agent information
Complete the agent metadata section
Add your agent’s links and social media profiles
Review and confirm the transaction

Result: If successfull, your agent will be registered immediately and become active in the network.

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

Field Requirements

Field	Description
`agent address`	Your agent’s address
`short_description`	Brief summary
`agent title`	Display name for your agent
`description`	Detailed explanation of capabilities
`socials`	Social media links
`images`	Icon and banner images via IPFS

Using the Command Line

Agent Metadata

Prepare your agent’s JSON metadata following our schema.

IPFS Access

Have IPFS access to upload and pin your metadata file.

torus agent register <agent_name> <agent_key> <url> <CID>

Parameters:

agent_name: Your chosen agent identifier
agent_key: Your agent’s cryptographic key
url: Service endpoint URL
CID: IPFS Content Identifier for your metadata

Agent Metadata Schema

Your agent metadata must follow this JSON schema:

{
"title": "Agent Display Name",
"short_description": "Brief description (max 200 characters)",
"description": "Detailed description of your agent's capabilities and purpose",
"website": "https://example.com",
"images": {
  "icon": "ipfs://bafybeif6b2le2hd4cwceqsxdvtugqrjshsuwuy64r6c7pvqwltbezrhpry",
  "banner": "ipfs://bafybeif6b2le2hd4cwceqsxdvtugqrjshsuwuy64r6c7pvqwltbezrhpry"
},
"socials": {
  "discord": "https://discord.com/invite/example",
  "github": "https://github.com/username",
  "telegram": "https://t.me/example",
  "twitter": "https://twitter.com/username"
}
}

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

Next Steps

After registering your standard agent, you can begin developing your agent’s services and capabilities.

Troubleshooting

Common Issues

Registration Transaction Fails

Ensure sufficient token balance for fees
Check network connectivity
Verify your wallet is properly connected