Talero Public Docs
Public node documentation for builders, wallets, explorers, and operators
Public Integration Surface

Talero public-safe JSON-RPC

Current public-rpc profile methods for wallets, explorers, light clients, builders, and hardened gateways.

Public-safe RPC Generated contract JSON-RPC 2.0 Privacy policy Read-only aware

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.

Scope and Restrictions

The tables on this page are generated from the public-rpc profile in the runtime surface contract. A listed method can still be limited by public mode, privacy mode, safe mode, read-only mode, quotas, or deployment policy.

Address-sensitive reads are public-profile surfaces only with privacy policy applied. Wallet-safe trusted access does not widen anonymous public mode.

Quick Examples

eth_chainId

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_chainId",
  "params": []
}

eth_blockNumber

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_blockNumber",
  "params": []
}

talero_runtimeCapabilities

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "talero_runtimeCapabilities",
  "params": []
}

talero_runtimeReadiness

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "talero_runtimeReadiness",
  "params": []
}

talero_getPqNodeStatus

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "talero_getPqNodeStatus",
  "params": []
}

talero_getPoqProofFeed

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "talero_getPoqProofFeed",
  "params": [
    {
      "limit": 3
    }
  ]
}

talero_getEvmPoqReadSurface

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "talero_getEvmPoqReadSurface",
  "params": []
}

talero_getWalletFinalityStatus

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "talero_getWalletFinalityStatus",
  "params": [
    "0xTRANSACTION_HASH"
  ]
}

talero_verifyDisclosure

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "talero_verifyDisclosure",
  "params": [
    {
      "claim": "balance_gte",
      "proof": "0x..."
    }
  ]
}

Runtime Posture

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

Ethereum and Chain Reads

MethodCategoryPublic profile behaviorNotes
web3_clientVersionMinimalMinimal public status or compatibility surface.evm
eth_chainIdMinimalMinimal public status or compatibility surface.evm
net_versionMinimalMinimal public status or compatibility surface.evm
net_listeningMinimalMinimal public status or compatibility surface.evm
eth_syncingMinimalMinimal public status or compatibility surface.evm
eth_blockNumberMinimalMinimal public status or compatibility surface.evm
eth_getBlockByNumberPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getBlockByHashPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getBlockReceiptsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getTransactionByHashPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getTransactionReceiptPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getTransactionCountAddressSensitivePublic profile can mask, bound, or deny according to privacy policy.privacy-sensitive
eth_getBalanceAddressSensitivePublic profile can mask, bound, or deny according to privacy policy.privacy-sensitive
eth_getCodePublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_callPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_estimateGasPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_gasPriceMinimalMinimal public status or compatibility surface.evm
eth_feeHistoryPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_maxPriorityFeePerGasMinimalMinimal public status or compatibility surface.evm
eth_getLogsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm

Transaction Submission

MethodCategoryPublic profile behaviorNotes
eth_sendRawTransactionTxSubmitWrite-capable public profile only; read-only deployments can deny submission.write-capable
talero_sendTransactionTxSubmitWrite-capable public profile only; read-only deployments can deny submission.write-capable
eth_sendTransactionTxSubmitWrite-capable public profile only; read-only deployments can deny submission.write-capable

eth_sendTransaction appears only because the current contract marks it write-capable under the public-rpc profile. Deployments can still disable it through read-only mode or policy.

PoQ, PQ, and Verification

MethodCategoryPublic profile behaviorNotes
talero_getPqNodeStatusMinimalMinimal public status or compatibility surface.runtime
talero_getEvmPoqReadSurfaceDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPoqProofFeedDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPoqEthereumAnchorDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_posBftGetPqFinalityCertificateDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.finality
talero_posBftGetPqFinalityExportBundleDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.finality
talero_posBftGetPqFinalityArtifactsStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.finality
talero_poqStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.poq
talero_getPoqRecoveryStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPoqRoundDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPoqThresholdStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPoqThresholdRoundDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_listPoqThresholdRoundsDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPqKeyDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPqKeyRegistryDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPqNodeIdentityDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getQuantumCertificateDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.poq
talero_getQuantumCommitteeDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.poq
talero_getQuantumPartialSignaturesDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.poq
talero_isQuantumCertifiedDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.poq
talero_verifyQuantumCertificateDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.poq

Selective Disclosure

MethodCategoryPublic profile behaviorNotes
talero_getDisclosureInputsDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.privacy
talero_getDisclosureMembershipProofDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.privacy
talero_verifyDisclosureDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.privacy

Wallet and Finality

MethodCategoryPublic profile behaviorNotes
talero_getWalletFinalityStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.finality
talero_finalizedHeadPublicChainReadPublic read surface, subject to quotas and runtime safety gates.finality
talero_finalityEstimateDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.finality
talero_getFinalityReceiptBundlePublicChainReadPublic read surface, subject to quotas and runtime safety gates.finality

Observer PoS/BFT

MethodCategoryPublic profile behaviorNotes
talero_posBftStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.finality
talero_posBftGetQcDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.finality
talero_posBftListQcsDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.finality
talero_posGetValidatorSetPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_posGetActiveSetPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_posGetValidatorDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_posGetValidatorStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_posSlashingPolicyPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_posGetEpochSnapshotPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_posGetEpochRewardsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_posGetDelegationsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime

Other Public Contract Methods

MethodCategoryPublic profile behaviorNotes
eth_accountsMinimalMinimal public status or compatibility surface.evm
eth_coinbaseMinimalMinimal public status or compatibility surface.evm
eth_getBlockTransactionCountByHashPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getBlockTransactionCountByNumberPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getFilterChangesPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getFilterLogsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getTransactionByBlockHashAndIndexPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_getTransactionByBlockNumberAndIndexPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_hashrateMinimalMinimal public status or compatibility surface.evm
eth_miningMinimalMinimal public status or compatibility surface.evm
eth_newBlockFilterPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_newFilterPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_newPendingTransactionFilterPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_subscribePublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_uninstallFilterPublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
eth_unsubscribePublicChainReadPublic read surface, subject to quotas and runtime safety gates.evm
rpc_modulesMinimalMinimal public status or compatibility surface.runtime
talero_blockNumberMinimalMinimal public status or compatibility surface.runtime
talero_epochMinimalMinimal public status or compatibility surface.runtime
talero_featuresMinimalMinimal public status or compatibility surface.runtime
talero_feeForecastPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_genesisHashMinimalMinimal public status or compatibility surface.runtime
talero_getAddressSummaryAddressSensitivePublic profile can mask, bound, or deny according to privacy policy.privacy-sensitive
talero_getAddressTxsAddressSensitivePublic profile can mask, bound, or deny according to privacy policy.privacy-sensitive
talero_getBalanceAddressSensitivePublic profile can mask, bound, or deny according to privacy policy.privacy-sensitive
talero_getBasefeeMinimalMinimal public status or compatibility surface.runtime
talero_getBlockByHashPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getBlockByHeightPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getBlockByNumberPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getBlockReceiptsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getBlockSummaryPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getBlockTxsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getBlockWorkPublicChainReadPublic read surface, subject to quotas and runtime safety gates.mining
talero_getBlocksPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getBlocksByRangePublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getBootnodesMinimalMinimal public status or compatibility surface.runtime
talero_getChainHeadPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getChainMetaPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getCheckpointDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getCheckpointHistoryDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getCoinbasePublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getConsensusConfigMinimalMinimal public status or compatibility surface.runtime
talero_getContractMetadataPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getContractMetadataCapabilitiesMinimalMinimal public status or compatibility surface.runtime
talero_getExpectedProposerMinimalMinimal public status or compatibility surface.runtime
talero_getExplorerBlockSummaryPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getForkTipsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getForksAtHeightPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getHardforkScheduleMinimalMinimal public status or compatibility surface.runtime
talero_getHeadPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getHeadersByHashChainPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getHeadersByRangePublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getLastBlockPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getMainnetPostureDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getObservedProposalMinimalMinimal public status or compatibility surface.runtime
talero_getObservedProposalCapabilitiesMinimalMinimal public status or compatibility surface.runtime
talero_getObservedProposalCommitCapabilitiesMinimalMinimal public status or compatibility surface.runtime
talero_getObservedProposalCommitReconcileStatusMinimalMinimal public status or compatibility surface.runtime
talero_getPoqPeerStatsDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_getPrivacyConfigMinimalMinimal public status or compatibility surface.runtime
talero_getProposerScheduleMinimalMinimal public status or compatibility surface.runtime
talero_getReceiptInclusionsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getRecentBlocksPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getReorgsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getStatsByRangePublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getTokenomicsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getTransactionByHashPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getTransactionDetailsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getTransactionInclusionsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getTransactionReceiptPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getTransactionReceiptInclusionsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getTransactionsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getTxInclusionsPublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_getValidatorCommittedObservedStatsMinimalMinimal public status or compatibility surface.runtime
talero_getValidatorLocalProductionSignalsMinimalMinimal public status or compatibility surface.runtime
talero_getValidatorObservedProposalStatsMinimalMinimal public status or compatibility surface.runtime
talero_getValidatorSignalCapabilitiesMinimalMinimal public status or compatibility surface.runtime
talero_getValidatorSignalHistoryMinimalMinimal public status or compatibility surface.runtime
talero_getValidatorSignalsMinimalMinimal public status or compatibility surface.runtime
talero_getValidatorUptimeSignalsMinimalMinimal public status or compatibility surface.runtime
talero_getValidatorWatchtowerIncidentsMinimalMinimal public status or compatibility surface.runtime
talero_get_basefeeMinimalMinimal public status or compatibility surface.runtime
talero_listObservedProposalsMinimalMinimal public status or compatibility surface.runtime
talero_listValidatorLocalProductionSignalsMinimalMinimal public status or compatibility surface.runtime
talero_listValidatorSignalBucketsMinimalMinimal public status or compatibility surface.runtime
talero_listValidatorSignalsMinimalMinimal public status or compatibility surface.runtime
talero_listValidatorWatchtowerIncidentsMinimalMinimal public status or compatibility surface.runtime
talero_miningStatsDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_mining_statsDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_networkDifficultyMinimalMinimal public status or compatibility surface.runtime
talero_networkHashrateMinimalMinimal public status or compatibility surface.mining
talero_nodeHealthMinimalMinimal public status or compatibility surface.runtime
talero_resolvePublicChainReadPublic read surface, subject to quotas and runtime safety gates.runtime
talero_routeHintsDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_txCapabilitiesMinimalMinimal public status or compatibility surface.runtime
talero_txSchemaMinimalMinimal public status or compatibility surface.runtime
talero_txSignHashMinimalMinimal public status or compatibility surface.runtime
talero_txSigningHashMinimalMinimal public status or compatibility surface.runtime
talero_txVerifyPreviewMinimalMinimal public status or compatibility surface.runtime
talero_validateIntentDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics
talero_watchtowerStatusDiagnosticsSafePublic-safe diagnostic summary; safe mode and quotas still apply.diagnostics

Not Generic Public RPC

The following methods exist in the node contract but must not be documented or treated as normal public-safe RPC.

MethodCategoryMinimum privilegePublic documentation rule
eth_getProofProofStoragewallet_safe_trustedWallet-safe trusted proof/storage; privacy-sensitive and can be masked or denied publicly.
eth_getStorageAtProofStoragewallet_safe_trustedWallet-safe trusted proof/storage; privacy-sensitive and can be masked or denied publicly.
eth_getWorkMiningpoolMining/pool compatibility helper, not generic public RPC.
eth_submitWorkMiningpoolUnsupported compatibility mining surface; prefer talero_submitWork where mining is enabled.
talero_getWorkMiningpoolCanonical mining work surface, gated by mining/pool profile.
talero_submitWorkMiningpoolCanonical mining submission surface, gated by mining/pool profile.
talero_simulateTxTraceDebugtrustedTrusted TraceDebug simulation, not public-safe.
talero_getNodeDiagnosticsDiagnosticsRestrictedtrustedDiagnosticsRestricted trusted/operator-oriented method.
talero_getModuleStatusDiagnosticsRestrictedtrustedDiagnosticsRestricted trusted/operator-oriented method.
talero_getActivityHintsDiagnosticsRestrictedtrustedDiagnosticsRestricted trusted/operator-oriented method.
talero_getRecentOperationalEventsDiagnosticsRestrictedtrustedDiagnosticsRestricted trusted/operator-oriented method.

Admin/dev validator mutation methods are also outside the wallet-safe public surface. The supported node-side validator lifecycle path is a signed tlro_pos_v1 transaction submitted through a private write endpoint.