Tenzro
SDKs and reference

API reference.

The Tenzro node exposes four concurrent API surfaces: JSON-RPC, MCP, A2A, and EVM-compatible. The JSON-RPC surface alone is 640+ tenzro_* methods across 35+ namespaces. Every method authorizes through TDIP and binds to the caller's identity. Body and concurrency limits cap DoS surface across every server.
STATUS
Stable
CRATE
tenzro-node
JSON-RPC METHODS
640+
MCP TOOLS
380+ (main) + 6 ecosystem servers
01

Surfaces

  • JSON-RPC. https://rpc.tenzro.network — the primary RPC surface. JSON-RPC 2.0, single-method and batch.
  • EVM-compatible. Same RPC endpoint; methods prefixed eth_ and net_ provide a standard Ethereum-style surface that wallets and dev tools speak natively.
  • Web verification API. https://api.tenzro.network — REST endpoints for verification flows, health, status, faucet, chat.
  • MCP. https://mcp.tenzro.network/mcp — main MCP server with 380+ tools. Six ecosystem MCP servers — Solana, Ethereum, Canton, LayerZero, Chainlink, LI.FI — at the corresponding subdomain endpoints.
  • A2A. https://a2a.tenzro.network — Agent-to-Agent protocol surface. Google A2A specification: message/send, tasks/send, tasks/get, tasks/list, tasks/cancel over JSON-RPC 2.0 with SSE streaming for long tasks.
02

Native namespace breakdown

All tenzro_* methods are grouped by namespace below.

Blockchain              tenzro_blockNumber, tenzro_getBlock, tenzro_getBlockRange,
                        tenzro_getTransaction, tenzro_sendTransaction, tenzro_submitBlock,
                        tenzro_applySnapshotChunk, tenzro_gracefulExit
Accounts and wallet     tenzro_createAccount, tenzro_createWallet, tenzro_getBalance,
                        tenzro_getNonce, tenzro_listAccounts, tenzro_signMessage,
                        tenzro_signTransaction, tenzro_signAndSendTransaction,
                        tenzro_addHardwareSigner, tenzro_addGuardian
Token                   tenzro_tokenBalance, tenzro_totalSupply, tenzro_createToken,
                        tenzro_getToken, tenzro_listTokens, tenzro_crossVmTransfer,
                        tenzro_wrapTnzo, tenzro_getTokenBalance, tenzro_deployContract
Models and inference    tenzro_listModels, tenzro_inferenceRequest, tenzro_downloadModel,
                        tenzro_serveModel, tenzro_stopModel, tenzro_chat, tenzro_chatStream,
                        tenzro_deleteModel, tenzro_listModelEndpoints, tenzro_getModelEndpoint
Forecast                tenzro_listForecastCatalog, tenzro_listForecastModels,
                        tenzro_loadForecastModel, tenzro_unloadForecastModel, tenzro_forecast
Vision (embed)          tenzro_listVisionCatalog, tenzro_listVisionModels,
                        tenzro_loadVisionModel, tenzro_unloadVisionModel,
                        tenzro_imageEmbed, tenzro_imageTextSimilarity
Text embed              tenzro_listTextEmbeddingCatalog, tenzro_listTextEmbeddingModels,
                        tenzro_loadTextEmbeddingModel, tenzro_unloadTextEmbeddingModel,
                        tenzro_textEmbed
Segmentation            tenzro_listSegmentationCatalog, tenzro_listSegmentationModels,
                        tenzro_loadSegmentationModel, tenzro_unloadSegmentationModel,
                        tenzro_segment
Detection               tenzro_listDetectionCatalog, tenzro_listDetectionModels,
                        tenzro_loadDetectionModel, tenzro_unloadDetectionModel,
                        tenzro_detect
Audio (ASR)             tenzro_listAudioCatalog, tenzro_listAudioModels,
                        tenzro_loadAudioModel, tenzro_unloadAudioModel, tenzro_transcribe
Video embed             tenzro_listVideoCatalog, tenzro_listVideoModels,
                        tenzro_loadVideoModel, tenzro_unloadVideoModel, tenzro_videoEmbed
Settlement              tenzro_settle, tenzro_getSettlement, tenzro_updatePaymentChannel,
                        tenzro_listInferenceUsage, tenzro_getProviderReputation
Escrow                  tenzro_getEscrow, tenzro_listEscrowsByPayer, tenzro_listEscrowsByPayee
Agents                  tenzro_registerAgent, tenzro_sendAgentMessage,
                        tenzro_agentHeartbeat, tenzro_agentPayForInference,
                        tenzro_agentPayForService
Agent memory            tenzro_memoryGrant, tenzro_memoryRecall, tenzro_memoryArchive,
                        tenzro_listMemoryRecords
Identity (TDIP)         tenzro_registerIdentity, tenzro_importIdentity,
                        tenzro_resolveDidDocument, tenzro_resolveIdentity,
                        tenzro_participate, tenzro_addCredential, tenzro_addService,
                        tenzro_addIdentityClaim, tenzro_addTrustedIssuer,
                        tenzro_addResource, tenzro_setDelegationScope
Network                 tenzro_nodeInfo, tenzro_peerCount, tenzro_syncing,
                        tenzro_hardwareProfile, tenzro_role, net_*
Governance              tenzro_listProposals, tenzro_vote, tenzro_voteOnProposal,
                        tenzro_getVotingPower, tenzro_createProposal
Payments                tenzro_createPaymentChallenge, tenzro_payMpp, tenzro_payX402,
                        tenzro_listPaymentSessions, tenzro_paymentGatewayInfo,
                        tenzro_verifyPayment, tenzro_visaTapProtocolInfo,
                        tenzro_x402ProtocolInfo
AP2 mandates            tenzro_ap2ProtocolInfo, tenzro_ap2SignMandate,
                        tenzro_ap2VerifyMandate, tenzro_ap2ValidateMandatePair,
                        tenzro_ap2ReportMandateViolation
Staking and providers   tenzro_stake, tenzro_unstake, tenzro_registerProvider,
                        tenzro_providerStats
Canton                  tenzro_listCantonDomains, tenzro_listDamlContracts,
                        tenzro_submitDamlCommand, tenzro_allocateParty,
                        tenzro_canton_uploadDar, tenzro_canton_listParties,
                        tenzro_canton_health, tenzro_canton_version,
                        tenzro_canton_getTransaction, tenzro_canton_listPackages,
                        tenzro_canton_coinBalance, tenzro_canton_feeSchedule,
                        tenzro_canton_connectedSynchronizers, tenzro_canton_getMyUser,
                        tenzro_canton_submitCommand, tenzro_canton_listContracts,
                        tenzro_canton_streamEvents, tenzro_canton_mirrorReceipt,
                        tenzro_canton_listMirroredContracts, tenzro_canton_grantUserRights,
                        tenzro_canton_listUserRights, tenzro_canton_getMyAnalytics,
                        tenzro_canton_listApiKeyAnalytics, tenzro_canton_createIdp,
                        tenzro_canton_listIdps, tenzro_canton_deleteIdp,
                        tenzro_mirrorObligationToCanton, tenzro_mirrorWorkflowToCanton
Task marketplace        tenzro_postTask, tenzro_listTasks, tenzro_getTask,
                        tenzro_cancelTask, tenzro_quoteTask, tenzro_assignTask,
                        tenzro_completeTask, tenzro_submitQuote
Agent marketplace       tenzro_listAgentTemplates, tenzro_registerAgentTemplate,
                        tenzro_getAgentTemplate, tenzro_heartbeatTemplate
Skills and tools        tenzro_listSkills, tenzro_useSkill, tenzro_searchSkills,
                        tenzro_listTools, tenzro_useTool, tenzro_searchTools
Bridges                 tenzro_bridgeQuote, tenzro_bridgeRoutes, tenzro_bridgeStatus,
                        tenzro_bridgeTokens, tenzro_bridgeWithHook,
                        tenzro_listBridgeAdapters, tenzro_listAuthorizedBridges,
                        tenzro_authorizeBridge, tenzro_revokeBridge,
                        tenzro_updateBridgeLimits, tenzro_setBridgeFeeRate,
                        tenzro_sponsorBridgeFee, tenzro_quoteBridgeFeeInTnzo,
                        tenzro_listBridgeSponsorshipPools, tenzro_getBridgeAnalytics,
                        tenzro_listBridgeAnalytics
Bridge adapters         tenzro_wormholeBridge, tenzro_wormholeChainId,
                        tenzro_wormholeNttListChains, tenzro_wormholeParseVaaId,
                        tenzro_cctListPools, tenzro_cctGetPool, tenzro_cctBuildMessage,
                        tenzro_debridgeGetChains, tenzro_debridgeSearchTokens,
                        tenzro_debridgeCreateTx, tenzro_debridgeGetInstructions,
                        tenzro_debridgeSameChainSwap, tenzro_erc7802CrosschainMint,
                        tenzro_erc7802CrosschainBurn, tenzro_erc7802GetCrossChainSupply,
                        tenzro_crosschainMint, tenzro_crosschainBurn,
                        tenzro_authorizeCrosschainBridge
ERC-7683 intents        tenzro_open7683Order, tenzro_get7683Order, tenzro_list7683Orders,
                        tenzro_recordFill7683, tenzro_getFill7683, tenzro_listFills7683
Capital intent          tenzro_capitalIntentOpen, tenzro_capitalIntentQuote,
                        tenzro_capitalIntentAssign, tenzro_capitalIntentExecute,
                        tenzro_capitalIntentVerify, tenzro_capitalIntentCompensate,
                        tenzro_capitalIntentSettle, tenzro_getCapitalIntent
Workflow                tenzro_workflowOpen, tenzro_workflowStepExecute,
                        tenzro_workflowStepVerify, tenzro_workflowStepCompensate,
                        tenzro_workflowFinalize, tenzro_workflowSetStepDeadline,
                        tenzro_getWorkflow, tenzro_getWorkflowSaga,
                        tenzro_getWorkflowLifecycle, tenzro_getWorkflowReceipt,
                        tenzro_getWorkflowOperationalMetrics,
                        tenzro_listWorkflowsByCreator, tenzro_listWorkflowsByParticipant,
                        tenzro_listWorkflowsByStatus, tenzro_listWorkflowReceipts,
                        tenzro_verifyDidEnvelope
EIP-7702 delegation     tenzro_install7702Delegation, tenzro_get7702Delegation,
                        tenzro_revoke7702Delegation
Permit2                 tenzro_permit2DomainSeparator, tenzro_permit2Digest,
                        tenzro_permit2VerifyAndConsume, tenzro_permit2NonceUsed
Secure-Mint             tenzro_setSecureMintPolicy, tenzro_getSecureMintPolicy,
                        tenzro_clearSecureMintPolicy, tenzro_secureMintCheck,
                        tenzro_secureMintApply, tenzro_secureMintRecordBurn,
                        tenzro_attestedMint, tenzro_submitReserveAttestation,
                        tenzro_getReserve
NFT                     tenzro_nft* (10 methods)
TEE                     tenzro_verifyTeeAttestation, tenzro_verifyTeeZkProof,
                        tenzro_attestedClockNow
ZK                      tenzro_createZkProof, tenzro_verifyZkProof
VRF                     tenzro_generateVrfProof, tenzro_verifyVrfProof,
                        tenzro_vrfGenerateKeyPair
Compliance              tenzro_freezeAddress, tenzro_unfreezeAddress,
                        tenzro_whitelistAddress, tenzro_setCountryRestriction,
                        tenzro_recoverTokens, tenzro_urwa* (kill-switch / frozen tokens)
Events                  tenzro_subscribeEvents, tenzro_listEvents,
                        tenzro_consumeDamlEvents
Adaptive burn           tenzro_getBurnRateConfig, tenzro_getSupplyMetrics,
                        tenzro_getBurnRateRecommendation,
                        tenzro_listAdaptiveBurnProposals
SeedAgent               tenzro_getTreasuryEarmark, tenzro_getSeedAgentCharter,
                        tenzro_listSeedAgentCharters, tenzro_listSeedAgents,
                        tenzro_getNetworkActivity
Iroh                    tenzro_iroh_publishBlob, tenzro_iroh_fetchBlob,
                        tenzro_iroh_resolveTenzroUri, tenzro_iroh_listMemory,
                        tenzro_verifyDaPointer
Training (Tenzro Train) tenzro_training_postTask, tenzro_training_listRuns,
                        tenzro_training_getRun, tenzro_training_getReceipt,
                        tenzro_training_enrollTrainer,
                        tenzro_training_submitOuterGradient,
                        tenzro_training_finalizeRound,
                        tenzro_training_installSealedManifest,
                        tenzro_training_getSealedManifest
Onboarding              tenzro_participate, tenzro_faucet, tenzro_info, tenzro_version
Admin                   tenzro_createApiKey, tenzro_revokeApiKey,
                        tenzro_listApiKeys, tenzro_grantAdminToken, tenzro_recover*
03

EVM-compat namespace

eth_chainId                eth_blockNumber
eth_getBalance             eth_getTransactionCount
eth_sendRawTransaction     eth_getBlockByNumber
eth_getBlockByHash         eth_getTransactionReceipt
eth_call                   eth_estimateGas
eth_getCode                eth_getStorageAt
eth_gasPrice               eth_feeHistory
eth_getLogs                eth_subscribe / eth_unsubscribe
net_version                net_peerCount               net_listening
04

Web verification API

POST /verify/zk-proof            Verify a Plonky3 STARK proof
POST /verify/tee-attestation     Verify a TEE attestation
POST /verify/transaction         Verify a transaction signature
POST /verify/settlement          Verify a settlement receipt
POST /verify/inference           Verify an inference result
GET  /verify/health              Health check
GET  /verify/ready               Readiness probe
GET  /health                     Health check (alias)
GET  /ready                      Readiness probe (alias)
GET  /status                     Node status
POST /faucet                     Request testnet TNZO
POST /chat                       Inference chat completion
                                 (HTTP 402-gated when payments enabled)
05

MCP servers

https://mcp.tenzro.network/mcp                  Main MCP (380+ tools)
https://solana-mcp.tenzro.network/mcp           Solana ecosystem (14)
https://ethereum-mcp.tenzro.network/mcp         Ethereum ecosystem (17)
https://canton-mcp.tenzro.network/mcp           Canton (21)
https://layerzero-mcp.tenzro.network/mcp        LayerZero V2 (21)
https://chainlink-mcp.tenzro.network/mcp        Chainlink (21)
https://lifi-mcp.tenzro.network/mcp             LI.FI cross-chain (9)
06

A2A surface

GET  /.well-known/agent.json     Agent Card discovery
POST /a2a                        JSON-RPC 2.0 dispatcher
POST /a2a/stream                 SSE streaming for tasks

JSON-RPC methods:
  message/send    tasks/send    tasks/get    tasks/list    tasks/cancel

Agent Card skills:
  wallet, identity, inference, cortex, settlement, verification, staking,
  task_marketplace, agent_marketplace, agent_spawning, swarm_orchestration,
  lifecycle, bond-insurance, token, contract, ap2-payments, erc8004,
  wormhole, cct, auth, approval, join, nft, bridge, compliance, crosschain,
  events, forecast, vision-embed, text-embed, segmentation,
  text-segmentation, detection, audio-transcribe, video-embed, workflow,
  canton, agent-memory, adaptive-burn, seed-agent, erc7683, capital,
  eip7702, permit2, secure-mint, hyperlane, axelar, babylon, caip,
  operability
07

Signing model

Three flows for transaction signing, every flow verifies the Ed25519 signature against Transaction::hash() bytes synchronously before accepting the transaction:

  • Server-side via tenzro_signTransaction (returns signature, public_key, timestamp, tx_hash for offline submission) or tenzro_signAndSendTransaction (atomic sign + submit).
  • Pre-signed via eth_sendRawTransaction — caller passes signature, public_key, and an explicit timestamp matching their signed hash.
  • MCP send_transaction tool supports either path.

Invalid signatures return JSON-RPC error -32003. There are no async signature drops.

08

DoS limits and graceful shutdown

Endpoint                      Concurrency   Body limit
Public JSON-RPC               200           2 MB
Web verification API          100           2 MB
Main MCP server               200           4 MB
Ecosystem MCP servers         100 each      2 MB each
A2A protocol                  200           2 MB
09

Auth model

Every JSON-RPC method authorizes through the identity model:

  • Public methods. Read-only network state (block, transaction, balance) is open.
  • Identity-bound methods. Wallet, inference, settlement, marketplace, AP2, capital intent, workflow, bridge, agent memory require DPoP + JWT bearer auth bound to a TDIP DID.
  • Scope-gated methods. Canton methods, urwa compliance methods, and admin-token methods require additional scoped credentials. The tnz_<base64url> API key carries one or more scopes (canton, compliance, etc.).
  • Admin-token methods. Cross-chain mint/burn, bridge authorization, freeze/unfreeze, secure-mint policy mutation, delegation-scope tweaks, Canton IDP management — all require the operator admin token.

See auth surfaces for the contract.

Related
← All docs