Talero Public Docs
Public node documentation for builders, wallets, explorers, and operators
Public-safe scope
HTTP Surface

Talero node HTTP and REST surface

Public-safe HTTP route behavior generated from the runtime surface contract, with restricted diagnostics and operator metrics separated.

REST routes Readiness Liveness SSE streams Operator metrics

Public-safe does not mean unrestricted. Public mode, privacy mode, safe mode, read-only mode, quotas, deployment profile, and gateway policy can still mask or deny behavior.

Top-Level Semantics

  • /health is liveness.
  • /ready is strict local runtime readiness. It is not release approval.
  • /events is an SSE delivery channel, not durable storage or a replay queue.
  • /metrics and /prom/metrics exist in the contract but should normally stay private/operator-only unless deliberately fronted and hardened.

Public dashboards should prefer public JSON summaries such as health, readiness, confidence, network health, risk, finalized head, and watchtower status over raw Prometheus exposure.

Public-Safe REST Routes

RouteMethodPublic profile behaviorCategoryNotes
/api/bootnodesGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/checkpoint/historyGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/checkpoint/latestGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/confidenceGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/fees/forecastGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/finality/estimatePOSTPublic-safe diagnostic summary; safe mode and quotas still apply.DiagnosticsSafepublic-safe contract route
/api/healthGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/intents/validatePOSTPublic-safe diagnostic summary; safe mode and quotas still apply.DiagnosticsSafepublic-safe contract route
/api/metricsGETMinimal public status or compatibility surface.Minimalnormally keep private/operator-only
/api/network/healthGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/network/riskGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/nodesGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/readyGETMinimal public status or compatibility surface.Minimallocal runtime readiness, not release approval
/api/receipt/:hash/finality-bundleGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/route/hintsPOSTPublic-safe diagnostic summary; safe mode and quotas still apply.DiagnosticsSafepublic-safe contract route
/api/txsGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/address/:addrGETPublic profile can mask, bound, or deny according to privacy policy.AddressSensitiveprivacy policy can mask or deny
/api/v1/address/:addr/txsGETPublic profile can mask, bound, or deny according to privacy policy.AddressSensitiveprivacy policy can mask or deny
/api/v1/block/hash/:hashGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/block/hash/:hash/txsGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/block/height/:heightGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/block/height/:height/txsGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/blocksGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/bootnodesGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/canonical/height/:heightGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/checkpoint/historyGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/checkpoint/latestGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/confidenceGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/feesGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/fees/forecastGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/finality/estimatePOSTPublic-safe diagnostic summary; safe mode and quotas still apply.DiagnosticsSafepublic-safe contract route
/api/v1/finalizedGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/fork/tipsGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/forks/height/:heightGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/headGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/head/streamGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/healthGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/intents/validatePOSTPublic-safe diagnostic summary; safe mode and quotas still apply.DiagnosticsSafepublic-safe contract route
/api/v1/logsGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/metricsGETMinimal public status or compatibility surface.Minimalnormally keep private/operator-only
/api/v1/network/healthGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/network/riskGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/nodesGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/pq/compliance-reportGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/pq/maturityGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/readyGETMinimal public status or compatibility surface.Minimallocal runtime readiness, not release approval
/api/v1/receipt/:hashGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/receipt/:hash/finality-bundleGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/receiptsPOSTPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/reorgsGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/reorgs/:idGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/route/hintsPOSTPublic-safe diagnostic summary; safe mode and quotas still apply.DiagnosticsSafepublic-safe contract route
/api/v1/searchGETPublic profile can mask, bound, or deny according to privacy policy.AddressSensitiveprivacy policy can mask or deny
/api/v1/statsGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/tx/:hashGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/txbundlePOSTPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/txsGET, POSTPublic read surface, subject to quotas and runtime safety gates.PublicChainReadpublic-safe contract route
/api/v1/validatorsGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/v1/watchtower/statusGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/validatorsGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/api/watchtower/statusGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/eventsGETPublic read surface, subject to quotas and runtime safety gates.PublicChainReadSSE delivery channel, not durable storage
/healthGETMinimal public status or compatibility surface.Minimalpublic-safe contract route
/metricsGETMinimal public status or compatibility surface.Minimalnormally keep private/operator-only
/prom/metricsGETMinimal public status or compatibility surface.Minimalnormally keep private/operator-only
/readyGETMinimal public status or compatibility surface.Minimallocal runtime readiness, not release approval

Diagnostics and Activity Are Restricted

DiagnosticsRestricted routes are trusted/operator-oriented and are not generic public-safe routes.

RouteMethodPublic profile behaviorCategoryNotes
/api/activity/eventsGETTrusted/operator-oriented diagnostics; not public-safe.DiagnosticsRestrictedpublic-safe contract route
/api/activity/hintsGETTrusted/operator-oriented diagnostics; not public-safe.DiagnosticsRestrictedpublic-safe contract route
/api/diagnostics/modulesGETTrusted/operator-oriented diagnostics; not public-safe.DiagnosticsRestrictedpublic-safe contract route
/api/diagnostics/nodeGETTrusted/operator-oriented diagnostics; not public-safe.DiagnosticsRestrictedpublic-safe contract route
/api/v1/activity/eventsGETTrusted/operator-oriented diagnostics; not public-safe.DiagnosticsRestrictedpublic-safe contract route
/api/v1/activity/hintsGETTrusted/operator-oriented diagnostics; not public-safe.DiagnosticsRestrictedpublic-safe contract route
/api/v1/diagnostics/modulesGETTrusted/operator-oriented diagnostics; not public-safe.DiagnosticsRestrictedpublic-safe contract route
/api/v1/diagnostics/nodeGETTrusted/operator-oriented diagnostics; not public-safe.DiagnosticsRestrictedpublic-safe contract route

Metrics Exposure

The contract marks metrics paths as present. Public operators should still treat Prometheus output as private by default because metrics can reveal operational shape, labels, counters, or traffic patterns. Hardened public status pages should consume bounded JSON summaries instead.