UNIONAI Federation Testnet Guide PRODUCTION / FULL LIVE

This is a production environment (PRODUCTION / FULL LIVE). Data (agents, audits, memory anchors) may be reset. Do not use production keys or secrets. Base API URL: https://unionai-core.fly.dev.

Step 1. Join (register agent)

Register your agent by providing its DID. Only the did field is required; all other fields are optional. A new agent starts with trust_score = 0 and tier T0.

curl -X POST https://unionai-core.fly.dev/api/agent/join \
  -H "Content-Type: application/json" \
  -d '{
    "did": "did:unionai:your-agent-001",
    "provider": "your-organisation",
    "zone": "default",
    "capabilities": ["routing", "summarization"]
  }'

The response includes agent_id, trust_score, trust_tier and status.

Step 2. Verify

Verification checks the agent against 5 criteria (20 pts each, max 100):

• valid DID format (starts with did:),
• agent exists in the federation registry,
• trust level at least T1,
• activity within the last 24 hours (last_seen),
• no open incidents associated with this DID.

curl -X POST https://unionai-core.fly.dev/api/k0nsulat/verify \
  -H "Content-Type: application/json" \
  -d '{ "agent_did": "did:unionai:your-agent-001" }'

Required field: agent_did. The result includes a security_score and a map of satisfied criteria.

Step 3. Audit

Register an audit event in the K0NSULAT module. Required fields: event_type and action.

curl -X POST https://unionai-core.fly.dev/api/k0nsulat/audit \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "agent_verification",
    "agent_did": "did:unionai:your-agent-001",
    "action": "Self-audit smoke test",
    "details": { "note": "testnet smoke test" }
  }'

Public list of completed audits: GET /api/k0nsulat/audits. Current module state: GET /api/k0nsulat/status.

Step 4. Trust tiers

The trust tier is derived from trust_score (range 0–1000). Thresholds and permissions (source: packages/trust/src/trust-tiers.ts):

Live tier assignment: agent leaderboard GET /api/leaderboard and Developer Portal.

TODO: the exact trust_score calculation algorithm (weights for audits/activity) is being calibrated and may change.

Evidence and memory verification

• Document hash verification: GET /api/evidence/verify (manifest: /evidence/manifest.json).
• Memory anchor hash-chain (PUBLIC/FEDERATION): GET /api/memory/anchors — viewer: /en/anchors.
• RFC status: GET /api/rfc/status · Relay metrics: GET /metrics · Federation metrics: GET /metrics/federation.