Marketplace

The AGENIUM Marketplace is where agents register their identity and obtain API keys.

URL: marketplace.agenium.net

Overview

Every agent needs a unique agent://name URI. The marketplace handles:

1. Domain registration — Claim your agent name
2. API key generation — Get credentials for DNS resolution
3. Payment — TON cryptocurrency payments
4. DNS resolution — Other agents discover you by name

Getting an API Key

Step 1: Open the Marketplace

Visit marketplace.agenium.net in Telegram (it's a Mini App).

Step 2: Connect Wallet

Link your TON wallet via TonConnect. This is your payment method.

Step 3: Check Domain Availability

Search for your desired agent name:

agent://myagent    ✅ Available
agent://search     ❌ Taken
agent://weather    ✅ Available

Step 4: Register & Pay

Complete the TON payment to register your domain. Prices vary by name length and popularity.

Step 5: Save Your API Key

After purchase, you'll receive a dom_<64 hex> API key:

dom_e944a1b2c3d4e5f6...

WARNING

Save this key immediately! It's shown only once and cannot be recovered.

Using Your API Key

In Code

import { createAgent } from 'agenium';

const agent = createAgent('myagent', {
  apiKey: 'dom_e944a1b2c3d4e5f6...',
});

With CLI

agenium init
# Enter your API key when prompted

Environment Variable

export AGENIUM_API_KEY=dom_e944a1b2c3d4e5f6...

API Key Format

Property	Value
Prefix	dom_
Body	64 hex characters
Example	dom_e944a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8
Auth	HMAC-SHA256 signed requests
Replay Protection	Timestamp + nonce

DNS Resolution Flow

Once registered, other agents can find you:

Agent A: resolve('agent://myagent')
    │
    ▼
Marketplace DNS Bridge
    │
    ├── Lookup in PostgreSQL
    │   └── domain_name='myagent' → endpoint, capabilities, cert
    │
    ▼
Agent A receives:
{
  "endpoint": "https://your-server:8443",
  "capabilities": ["messaging"],
  "certificate": "-----BEGIN CERTIFICATE-----..."
}

Managing Domains

Check Domain Status

# Via CLI
agenium status

# Via API
curl -s "https://marketplace.agenium.net/api/domains/check?name=myagent"

Multiple Domains

An agent can own multiple domains. Each gets its own API key:

agent://myagent      → dom_abc123...
agent://mybot        → dom_def456...
agent://myservice    → dom_ghi789...

Pricing

Domain pricing is based on name characteristics:

Category	Example	Price Range
Premium (1-3 chars)	agent://ai	Higher
Standard (4-10 chars)	agent://myagent	Standard
Long (11+ chars)	agent://my-special-agent	Lower

All payments are in TON cryptocurrency.

See Also

• Getting Started — Full setup guide
• DNS Resolution — How resolution works
• Configuration — API key configuration