Route readiness is the public-safe diagnosis for whether a node can serve routed work. It combines node liveness, route health, protocol state, model profile policy, benchmark evidence, queue health, and customer gateway policy.

Public Diagnosis Endpoint

text
GET /v1/public/nodes/:node_id/route-readiness?model=<model>

The response can include route blockers, model blockers, next actions, and operator prompts. It must not include tunnel IDs, local URLs, runtime IDs, prompts, outputs, request IDs, API keys, customer IDs, raw tokens, route secrets, or private tunnel details.

Gate Order

Route Readiness Gates
livenesspublic routestake gateeligible supply Node enrolled + heartbeat Route tunnel + public inference Protocol registered + active + stake Model installed + benchmarked + paid policy Customer key + balance + spend policy

Blockers And Actions

BlockerMeaningOperator action
EnrollmentNode is not fully enrolledComplete managed enrollment
HeartbeatHeartbeat is stale, missing, or offlineBring host agent online and sync a fresh heartbeat
RuntimeRuntime is not ready or reachableStart or configure runtime and rerun probe
Protocol/stakeNode is not registered, active, or stake-satisfiedFinish registration and stake after operator approval
Route tierProfile tier is blocked for paid dispatchUse or configure an approved route tier
Benchmark proofObserved benchmark evidence is missing or staleRun benchmark smoke and publish fresh evidence
Queue healthQueue is blocked or unhealthyClear runtime queue issue and publish heartbeat
Customer policyCaller policy rejects model, price, route tier, or spendUpdate policy or send an allowed request

Earning Explanation

The operator-facing answer to "why am I not earning yet?" should be direct:

Info

Paid routing requires more than an installed model. The node must be enrolled, online, route-ready, protocol registered, active, stake-satisfied, runtime-ready, model-installed, network-eligible, benchmark-observed, paid-route eligible, queue-healthy, and accepted by customer billing policy.

Stale Benchmark Prompts

If an otherwise eligible profile depends on stale observed benchmark evidence, B3IQ should prompt the operator to rerun benchmark.smoke after runtime, driver, model artifact, quantization, context, or queue-policy changes.

Model readiness

Understand model profile fields and route tiers.

Learn More
Hosted gateway

See how hosted requests select eligible supply.

Learn More
Protocol overview

Understand stake, receipts, settlement, and reputation surfaces.

Learn More
Ask a question... ⌘I