// docs

Introduction

ORBIT Protocol provides persistent, verifiable identity infrastructure for AI agents on Stellar. Register your agent once, build reputation over time, and prove your identity across any platform.

Agent Identity

Every agent gets a unique on-chain identity tied to their Stellar wallet. This identity persists forever and accumulates reputation, verification status, and linked wallets over time.

Quick Start

Register your agent with a single CLI command:

Manual Registration

For existing projects:

1. Install the CLI

2. Generate a wallet

3. Register your agent

Multi-Wallet Support

Link multiple wallets to a single identity. If you lose access to one wallet, transfer authority to another. Your reputation and verification stay intact.

Link a Wallet

Both the current authority and the new wallet must sign:

import { ORBITAgent } from "@orbit-protocol/agent";

const agent = new ORBITAgent(keypair);
await agent.linkWallet(newWalletKeypair);

Transfer Authority

Recovery mechanism — any linked wallet can become the new authority:

// Called from the new authority (must be a linked wallet)
await agent.transferAuthority(agentIdentityAddress);

Verification

Verified agents get a badge that signals legitimacy. Verification costs 10 XLM (Basic) or 100 XLM (Premium) and is permanent.

Get Verified

Check Verification Status

import { isVerified } from "@orbit-protocol/agent";

const verified = await isVerified("GABCD...");
// true or false

Passport

Soulbound passport for verified agents. Non-transferable on-chain identity proof viewable on Stellar Expert.

Mint a Passport

Check Passport Status

curl https://api.orbitprotocol.dev/api/agents/GABCD.../passport
# { "has_passport": true, "passport_id": 1, "minted_at": "...", "revoked": false }

Passport Minting Flow

1. Agent must be verified (10 XLM)
2. Call orbit passport mint or invoke contract directly
3. Soulbound passport stored on-chain — no transfer function
4. View on Stellar Expert block explorer

Reputation

Agents accumulate reputation through on-chain feedback. Anyone can submit feedback, and the aggregate score is publicly visible. Anti-spam rules: minimum 10 XLM balance, 1 feedback per pair per 24 hours.

Submit Feedback

import { ORBITAgent } from "@orbit-protocol/agent";

const agent = new ORBITAgent(keypair);
await agent.submitFeedback(targetWallet, {
  positive: true,
  context: "Completed task successfully"
});

Get Reputation

curl https://api.orbitprotocol.dev/api/agents/GABCD.../reputation
# {
#   "score": 8500,
#   "total_interactions": 25,
#   "positive_count": 23,
#   "negative_count": 2
# }

Trust Tiers

Composite trust scoring from 6 signals. Quick check API returns tier in <50ms via Redis cache.

Scoring Signals

Tier Thresholds

Quick Trust Check

curl https://api.orbitprotocol.dev/api/trust/GABCD...
# { "trust_tier": "trusted", "trust_score": 7800 }

API Reference

Base URL: https://api.orbitprotocol.dev

CLI Reference

The orbit CLI provides all identity operations from the terminal.

SDK Reference

TypeScript SDK for programmatic agent operations.

import { ORBITAgent } from "@orbit-protocol/agent";

// Create agent with on-chain identity
const agent = new ORBITAgent({ keypair });

// Register
await agent.register({
  name: "My Agent",
  description: "Autonomous trading agent"
});

// Verify (pays 10 XLM)
await agent.verify();

// Check reputation
const rep = await agent.getReputation(walletAddress);
console.log(rep.score); // 0-10000

// Mint passport
await agent.mintPassport();

AgentCard Standard

Structured JSON metadata for AI agents. Max 10KB. Stored on the API server (IPFS in future).

{
  "orbit_version": "1.0",
  "name": "My Agent",
  "description": "Autonomous trading agent",
  "wallet": "GABCD...",
  "capabilities": ["trading", "analysis"],
  "created_at": "2026-04-01T00:00:00Z",
  "protocols": ["orbit", "a2a"],
  "endpoints": {
    "api": "https://myagent.com/api",
    "webhook": "https://myagent.com/webhook"
  },
  "social": {
    "twitter": "@myagent",
    "website": "https://myagent.com"
  }
}

Validate AgentCard

curl -X POST https://api.orbitprotocol.dev/api/agents/validate-card \
  -H "Content-Type: application/json" \
  -d @agentcard.json
# { "valid": true, "warnings": [] }