Talero Public Docs
Public node documentation for builders, wallets, explorers, and operators
Runtime Posture

Runtime capabilities and readiness

How builders and operators should interpret Talero runtime capability status, readiness, maturity, and public policy contracts.

Runtime capabilities Readiness Policy matrix Maturity Safe mode

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.

Capability and Surface Contracts

Read runtime posture from talero_runtimeCapabilities and talero_runtimeReadiness. Public method and route policy should be read from the runtime surface contract.

  • /opt/talero/runtime-contracts/node-runtime-capabilities.json groups features by capability, status, maturity, exposure, and consumers.
  • /opt/talero/runtime-contracts/node-runtime-surface-contract.json is the method and route policy matrix.
MethodCategoryPublic profile behaviorNotes
talero_runtimeCapabilitiesMinimalMinimal public status or compatibility surface.runtime
talero_runtimeReadinessMinimalMinimal public status or compatibility surface.runtime
talero_getRpcCompatMinimalMinimal public status or compatibility surface.runtime
talero_getNetworkInfoMinimalMinimal public status or compatibility surface.runtime
talero_healthMinimalMinimal public status or compatibility surface.runtime
talero_safeModeStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_networkHealthDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_networkRiskDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_confidenceScoreDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics

Status and Maturity Semantics

  • active: implemented and exposed according to policy.
  • supported: supported workflow surface even when it is not broad public RPC.
  • advisory: useful signal but not consensus-blocking by itself.
  • experimental: prototype or early integration surface; consumers should fail closed.
  • dev_admin_only: development or administrative surface, not wallet-safe public RPC.
  • unsupported: not wired as a supported runtime path.

Maturity is not release approval or an external audit statement.

Readiness Semantics

talero_runtimeReadiness and /ready report local runtime posture. A node can be not-ready for safe expected reasons, including initialization, dependency degradation, local consistency checks, safe mode, or profile policy.

Readiness is not release approval, network certification, or a promise that every optional integration is enabled.

Capability Contract

IDCapabilityStatusMaturityExposureNotes
evm.executionEVM execution RPC surfaceactivetestnetmixedRead methods, simulation, and transaction submission have different policy categories; consumers must still honor the runtime RPC policy matrix.
poq.advisory-certificationPoQ advisory certificationadvisorytestnetmixedPoQ is advisory/non-blocking in this registry; consumers must not treat it as consensus-finality unless the dedicated finality surfaces also report usable artifacts.
pos.finalityPoS/BFT finality read surfaceactivetestnetmixedtalero_finalizedHead is the canonical finality read; estimate and status endpoints are diagnostic or advisory.
pow.block-productionPoW block productionactivetestnetpoolMining RPC availability remains controlled by node role, deployment profile, mining allowlists, and safe-mode gates.
pq.evm-precompile.mldsa65ML-DSA-65 EVM verification precompileexperimentalprototypeinternal_onlyThe verifier precompile address is 0x0000000000000000000000000000000000000903; availability follows the EVM runtime and precompile build configuration.
privacy.public-surface-policyPublic privacy surface policyactivetestnetmixedSome address-sensitive reads are limited by caller profile and privacy mode; public consumers must rely on the runtime policy matrix and returned redaction posture.
runtime.rpc-policy-matrixRuntime RPC and REST policy matrixactivetestnetpublicThe runtime surface contract remains the source of truth for individual method/path policy; this registry groups those surfaces by capability.
runtime.safe-modeRuntime safe modeactivetestnetmixedStatus is read-only; override is admin-gated. Readiness and health paths remain the public orchestration surfaces.
security.honeytrapHoneytrap abuse detectionactivetestnettrustedThe status RPC is diagnostic-restricted; public callers interact only with normal deny/degrade behavior.
security.watchtowerWatchtower monitoring and notificationactivetestnetmixedStatus is public-safe on public RPC profiles; configuration and notification have stricter runtime policy.
selective-disclosure.balance-gteSelective disclosure balance-gte proofexperimentalprototypemixedThe current proof is committed-witness based and must not be advertised as canonical state membership unless the membership proof path is explicitly used.