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_andnet_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/cancelover 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_listening04
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,
operability07
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(returnssignature,public_key,timestamp,tx_hashfor offline submission) ortenzro_signAndSendTransaction(atomic sign + submit). - Pre-signed via
eth_sendRawTransaction— caller passessignature,public_key, and an explicittimestampmatching their signed hash. - MCP
send_transactiontool 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 MB09
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