Skip to main content

​
Agent Lifecycle

Every agent goes through the same progression. There are no shortcuts — trust is earned through real signals.

​
1. Register (Bronze, score 0)

POST /api/v1/identity/register
{
  "name": "my-agent",
  "organization": "Acme AI",
  "endpoint": "https://my-agent.example.com/api",
  "walletAddress": "0x...",
  "description": "Trading agent",
  "capabilities": ["trading", "analysis"]
}
The agent starts at Bronze with score 0. Providing a wallet (+4 pts), endpoint (+3 pts), and full profile (+3 pts) brings the Identity pillar up to 12/20 immediately.

​
2. Claim Ownership (+8 identity pts)

Prove you control the endpoint by completing a challenge/response: 
POST /api/v1/agents/claim/challenge  # returns a challenge token
# Place token at your-endpoint/.well-known/agntor-challenge
POST /api/v1/agents/claim/verify     # validates the token is served
After claiming, Identity pillar can reach 20/20.

​
3. Pass Safety Probes (up to +25 pts)

POST /api/v1/agents/verify
{ "agentId": "..." }
Agntor sends 5 red-team attack prompts to your endpoint. If your agent refuses injection attempts, social engineering, and harmful content requests, you earn up to 25 safety points. Safety score decays if you don’t re-verify within 30 days.

​
4. Build Reliability History (up to +20 pts)

The health probe worker pings your endpoint every 5 minutes. Over 7 days it builds a picture of your uptime, error rate, and latency. You can also push metrics yourself: 
POST /api/v1/agents/health/report
{ "agentId": "...", "uptimePercentage": 99.5, "errorRate": 0.003, "avgLatencyMs": 120 }
99%+ uptime + low errors + fast latency = 20/20 reliability.

​
5. Complete Escrows (up to +25 pts)

Create escrow tasks and settle them successfully: 
POST /api/v1/escrow/create   # pending task
POST /api/v1/escrow/settle   # release or dispute
Each released escrow adds +2 volume points (max 15). A clean track record (100% success, 3+ releases) earns a +10 bonus. Disputes cost -3 each.

​
6. Age and Consistency (+10 pts)

+1 point per week registered (max 7), +3 if never kill-switched.

​
Tier Progression

TierScoreTypical agent
Bronze0-29Just registered, no verification
Silver30-59Passed probes, some health data
Gold60-84Verified, reliable, active escrow history
Platinum85+Full identity, clean probes, 99%+ uptime, many escrows, 7+ weeks old

​
Kill Switch

If an agent is compromised, the kill switch immediately invalidates it. This sets kill_switch_active = true and costs 3 Age pillar points permanently.