Router Node¶

Last updated: 2026-06-28

The router node is the main API and agent-facing coordinator for Cortensor work. It connects customers, agent products, miners, session queues, validation flows, payment wrappers, privacy policy, and off-chain payload storage.

Route Families¶

Route family	Availability	Notes
Completions	Implemented in router runtime	`POST /api/v1/completions`, `POST /api/v2/completions`, and `POST /api/v3/completions`; each also accepts `/<session_id>`. v2/v3 store prompts off-chain before submitting tasks. Encrypted flows can disable streaming.
Delegate	Implemented in router runtime	`POST /api/v1/delegate`, `POST /api/v2/delegate`, and `POST /api/v3/delegate`. v3 fans out to predefined v2 delegate sessions by replica count.
Validate	Implemented in router runtime	`POST /api/v1/validate`, `POST /api/v2/validate`, and `POST /api/v3/validate`. v3 aggregates verdicts from predefined v2 validation sessions.
Factcheck	Implemented in router runtime	`POST /api/v1/factcheck` and `POST /api/v1/fact-check`. Supports standard and realtime modes with redundancy/policy fields.
Trial routes	Config-gated	`POST /api/v1/trial/completions[/<session_id>]`, `POST /api/v1/trial/delegate`, `POST /api/v2/trial/delegate`, `POST /api/v1/trial/validate`, `POST /api/v2/trial/validate`, `POST /api/v1/trial/factcheck`, and `POST /api/v1/trial/fact-check`.
x402 routes	Config-gated	`GET /api/v1/x402/ping`, `POST /api/v1/x402/completions[/<session_id>]`, `POST /api/v1/x402/delegate`, `POST /api/v2/x402/delegate`, `POST /api/v1/x402/validate`, `POST /api/v2/x402/validate`, `POST /api/v1/x402/factcheck`, and `POST /api/v1/x402/fact-check`.
`/.well-known/agent.json`, `/api/v1/a2a/*`	Config-gated	Agent discovery card for external agents.
`/api/v3/offchain/result`	Implemented in router runtime	Signed miner result write path.
Privacy routes	Config-gated	`POST /api/v1/auth/payload_enc_key/session` and `POST /api/v1/auth/payload_enc_key/task`, backed by privacy helpers and `PrivacySettingData`.

V3 Policy Wrappers¶

flowchart LR
  Request["v3 request<br/>replicas = 1 / 3 / 5"] --> Select["Select predefined<br/>session pool"]
  Select --> R1["Replica 1<br/>v2 session"]
  Select --> R2["Replica 2<br/>v2 session"]
  Select --> R3["Replica N<br/>v2 session"]
  R1 --> Aggregate["Aggregate outputs<br/>or verdicts"]
  R2 --> Aggregate
  R3 --> Aggregate
  Aggregate --> Response["v3 response<br/>winner / verdict / evidence"]

Route	Behavior
Delegate v3	Normalizes `replicas`, selects predefined delegate sessions, calls `/api/v2/delegate` for each replica, returns winning output plus per-replica payloads.
Validate v3	Normalizes `replicas`, selects predefined validate sessions, calls `/api/v2/validate`, returns majority-style verdict, confidence, reasons, and evidence fields.

Agent Discovery¶

The router A2A card advertises:

completion, delegate, validate, and factcheck capabilities.
trial and x402 route availability.
MCP streamable HTTP and legacy SSE endpoints.
bearer/x402 auth support.
fixed configured sessions for agent-facing tools.

Off-Chain And Privacy¶

Implemented privacy and storage features include:

off-chain prompt storage in v2/v3 completion flows.
signed off-chain result writes.
session task-level encryption checks.
privacy setting reads/writes for allowed miners and encrypted sessions.

Deployment Details¶

Item	Needed
Public URLs	Which hostnames expose which route families.
Auth	Bearer, trial, x402, and MCP policy.
Sessions	Live IDs for completion, delegate, validate, factcheck.
MCP transport	Streamable HTTP, SSE, or both.
Storage	Provider, bucket, retention, deletion, and encryption behavior.
Timeouts	Router, gateway, precommit, and long-running request behavior.