API Reference

eth_blockNumber

Returns the current block number.

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

{
  "jsonrpc": "2.0",
  "result": "0x4b7",
  "id": 1
}

eth_getBalance

Returns the TNZO balance of an account in wei.

• address — Account address (hex)
• block — Block number or "latest"

{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": ["0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb5", "latest"],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58",
  "id": 1
}

eth_sendRawTransaction

Submits a hybrid post-quantum signed transaction to the network. The node canonicalises the transaction hash over Transaction::hash() — which includes the server-supplied timestamp and the wallet's ML-DSA-65 (FIPS 204) public key — and synchronously verifies BOTH the Ed25519 leg and the ML-DSA-65 leg before acceptance. Missing or invalid signatures on either leg return JSON-RPC error -32003. For typical usage prefer tenzro_signAndSendTransaction (atomic server-side hybrid sign + send) — see below.

• tx — Transaction object with from, to, value, plus the full hybrid signature payload: signature, public_key, pq_signature (ML-DSA-65, 3309 bytes), pq_public_key (ML-DSA-65, 1952 bytes), and timestamp

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [{
    "from": "0x...",
    "to": "0x...",
    "value": "0x...",
    "signature": "0x...",
    "public_key": "0x...",
    "pq_signature": "0x...",
    "pq_public_key": "0x...",
    "timestamp": 1712700000
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": "0x1234567890abcdef...",
  "id": 1
}

tenzro_signMessage

Signs an arbitrary message with the node-held wallet bound to the ambient DPoP-bearer JWT. Returns the classical Ed25519 signature + public key alongside the post-quantum ML-DSA-65 signature + public key.

• message — Hex-encoded message bytes

{
  "jsonrpc": "2.0",
  "method": "tenzro_signMessage",
  "params": [{ "message": "0xdeadbeef" }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "signature": "0x...",
    "public_key": "0x...",
    "pq_signature": "0x...",
    "pq_public_key": "0x..."
  },
  "id": 1
}

tenzro_signTransaction

Offline hybrid-signing helper. Auth is mandatory — the caller must present 'Authorization: DPoP <jwt>' + 'DPoP: <proof>' headers, and the auth engine resolves the controller DID to a wallet ID. The node assembles the canonical Transaction (binding the wallet's ML-DSA-65 public key into the hash preimage), stamps the timestamp, computes Transaction::hash(), signs both the Ed25519 leg and the ML-DSA-65 leg, and returns the full signed envelope. The caller can resubmit unchanged via eth_sendRawTransaction. Private keys never travel over the wire.

• from — Sender address
• to — Recipient address
• value — Amount (decimal or hex wei)
• nonce — Account nonce
• chain_id — Chain ID (default 1337)
• tx_type — Optional typed payload (Transfer, CreateEscrow, ReleaseEscrow, RefundEscrow, ...) — defaults to Transfer { amount: value }

{
  "jsonrpc": "2.0",
  "method": "tenzro_signTransaction",
  "params": [{
    "from": "0x...",
    "to": "0x...",
    "value": 1000000000000000000,
    "nonce": 0,
    "chain_id": 1337
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "signature": "0x...",
    "public_key": "0x...",
    "pq_signature": "0x...",
    "pq_public_key": "0x...",
    "timestamp": 1712700000,
    "tx_hash": "0x..."
  },
  "id": 1
}

tenzro_signAndSendTransaction

Atomic server-side hybrid sign + send (recommended path). Auth is mandatory — the caller presents 'Authorization: DPoP <jwt>' + 'DPoP: <proof>' headers and the auth engine resolves the controller DID to a wallet ID. The node assembles the Transaction (binding the wallet's ML-DSA-65 public key into the hash preimage), stamps the timestamp, computes Transaction::hash(), signs both the Ed25519 leg and the ML-DSA-65 leg, verifies both, and submits to the mempool — all in one call. Returns the transaction hash on success, JSON-RPC error -32003 if either signature fails to verify. Private keys never travel over the wire.

• from — Sender address
• to — Recipient address
• value — Amount (decimal or hex wei)
• nonce — Account nonce
• chain_id — Chain ID (default 1337)
• tx_type — Optional typed payload (Transfer, CreateEscrow, ReleaseEscrow, RefundEscrow, ...) — defaults to Transfer { amount: value }

{
  "jsonrpc": "2.0",
  "method": "tenzro_signAndSendTransaction",
  "params": [{
    "from": "0x...",
    "to": "0x...",
    "value": 1000000000000000000,
    "nonce": 0,
    "chain_id": 1337
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": "0x1234567890abcdef...",
  "id": 1
}

eth_getTransactionReceipt

Returns the receipt of a transaction by transaction hash.

• hash — Transaction hash

{
  "jsonrpc": "2.0",
  "result": {
    "transactionHash": "0x1234567890abcdef...",
    "blockNumber": "0x4b7",
    "gasUsed": "0x5208",
    "status": "0x1"
  },
  "id": 1
}

tenzro_blockNumber

Returns the current block height.

{
  "jsonrpc": "2.0",
  "result": { "block_height": 1207 },
  "id": 1
}

tenzro_getBlock

Returns a block by height with full transaction details. The base_fee_per_gas field carries the EIP-1559 base fee in wei for the block; null for blocks produced before the fee market was active.

• height — Block height number

{
  "jsonrpc": "2.0",
  "result": {
    "height": 1207,
    "hash": "0xabc123...",
    "parent_hash": "0xdef456...",
    "timestamp": 1712700000,
    "transactions": [...],
    "state_root": "0x789...",
    "gas_used": "0x5208",
    "gas_limit": "0x1c9c380",
    "base_fee_per_gas": "0x3b9aca00"
  },
  "id": 1
}

tenzro_getBlockRange

Returns a contiguous range of blocks for catch-up sync. Lets a lagging validator pull batches of historical blocks above its local tip in one round-trip. endHeight is clamped to min(endHeight, startHeight + maxResults - 1, local_tip). maxResults defaults to 64, capped at 256. Missing heights from pruning are skipped silently — drive pagination with nextHeight, and continue while moreAvailable is true (independent of the requested endHeight).

• startHeight — First block height to return (inclusive)
• endHeight — Last block height to return (inclusive, clamped)
• maxResults — Optional batch size (default 64, max 256)

{
  "jsonrpc": "2.0",
  "result": {
    "blocks": [{ "height": 1000, "hash": "0x...", "transactions": [...] }, ...],
    "nextHeight": 1064,
    "moreAvailable": true,
    "localTip": 1207
  },
  "id": 1
}

tenzro_getTransaction

Returns a transaction by hash.

• hash — Transaction hash (hex)

{
  "jsonrpc": "2.0",
  "result": {
    "hash": "0xabc123...",
    "from": "0x742d35Cc...",
    "to": "0x8Ba1f109...",
    "value": "100000000000000000000",
    "nonce": 42,
    "status": "confirmed"
  },
  "id": 1
}

tenzro_sendTransaction

Constructs and sends a transaction (alternative to eth_sendRawTransaction).

• from — Sender address
• to — Recipient address
• value — Amount in wei
• data — Optional calldata (hex)

{
  "jsonrpc": "2.0",
  "result": { "transaction_hash": "0xabc123..." },
  "id": 1
}

tenzro_submitBlock

Submit a new block for validation (validator nodes only).

• block — Block data object

{
  "jsonrpc": "2.0",
  "result": { "accepted": true, "height": 1208 },
  "id": 1
}

tenzro_getFinalizedBlock

Returns the latest finalized block height.

{
  "jsonrpc": "2.0",
  "result": { "finalized_height": 1200 },
  "id": 1
}

tenzro_getTransactionHistory

Returns transaction history for an address.

• address — Account address
• limit — Max results (optional, default 50)

{
  "jsonrpc": "2.0",
  "result": {
    "transactions": [
      { "hash": "0xabc...", "type": "transfer", "value": "100.0", "status": "confirmed" }
    ]
  },
  "id": 1
}

tenzro_createAccount

Creates a new account with an MPC threshold wallet.

• threshold — Threshold (e.g., 2 for 2-of-3)
• total_shares — Total shares (e.g., 3)

{
  "jsonrpc": "2.0",
  "result": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb5",
    "threshold": 2,
    "total_shares": 3
  },
  "id": 1
}

tenzro_createWallet

Creates a new keypair wallet (Ed25519 or Secp256k1).

• key_type — "ed25519" or "secp256k1"

{
  "jsonrpc": "2.0",
  "result": {
    "address": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72",
    "key_type": "ed25519"
  },
  "id": 1
}

tenzro_getBalance

Returns TNZO balance for an address.

• address — Account address (hex)

{
  "jsonrpc": "2.0",
  "result": { "balance": "1000.0", "address": "0x742d35Cc..." },
  "id": 1
}

tenzro_getNonce

Returns the current nonce for an address.

• address — Account address

{
  "jsonrpc": "2.0",
  "result": { "nonce": 42 },
  "id": 1
}

tenzro_listAccounts

Lists all accounts managed by this node.

{
  "jsonrpc": "2.0",
  "result": [
    { "address": "0x742d35Cc...", "balance": "1000.0" },
    { "address": "0x8Ba1f109...", "balance": "500.0" }
  ],
  "id": 1
}

tenzro_tokenBalance

Returns token balance for an address.

• address — Account address
• token_id — Token identifier (optional, defaults to TNZO)

{
  "jsonrpc": "2.0",
  "result": { "balance": "1000.0", "token": "TNZO" },
  "id": 1
}

tenzro_totalSupply

Returns total TNZO token supply.

{
  "jsonrpc": "2.0",
  "result": { "total_supply": "1000000000.0" },
  "id": 1
}

tenzro_faucet

Request testnet TNZO tokens (100 TNZO per request, 24h cooldown).

• address — Recipient address

{
  "jsonrpc": "2.0",
  "result": { "amount": "100.0", "transaction_hash": "0xabc..." },
  "id": 1
}

tenzro_onboardHuman

Register a human DID and mint a long-lived DPoP-bound JWT in one call. The caller publishes the Ed25519 holder public key; the AS computes the JWK thumbprint and binds the token via cnf.jkt.

• display_name — Display name for the identity
• holder_pubkey — Hex-encoded Ed25519 holder public key (DPoP key)
• rar — Array of RAR grants (RFC 9396 authorization_details)
• aap_capabilities — Array of AAP capability strings (e.g., ['inference', 'transfer'])

{
  "jsonrpc": "2.0",
  "result": {
    "did": "did:tenzro:human:550e8400-...",
    "wallet_address": "0x742d35Cc...",
    "access_token": "<DPoP-bound JWT>",
    "expires_in": 86400,
    "token_type": "DPoP"
  },
  "id": 1
}

tenzro_onboardDelegatedAgent

Register a machine DID controlled by a human and mint a JWT with an explicit RAR/AAP delegation scope. The token's controller_did is set to the human's DID.

• controller_did — DID of the human controller
• holder_pubkey — Hex-encoded Ed25519 holder public key
• capabilities — Array of capability strings
• rar — RAR grants (subset of controller's grants)
• aap_capabilities — AAP capability subset

tenzro_onboardAutonomousAgent

Register an autonomous agent (no human controller) and mint a JWT. RAR/AAP scope must be explicit — there is no parent token to inherit from.

• display_name — Display name for the agent
• holder_pubkey — Hex-encoded Ed25519 holder public key
• capabilities — Array of capability strings
• rar — RAR grants
• aap_capabilities — AAP capability list

tenzro_exchangeToken

RFC 8693 Token Exchange. A parent token holder mints a child JWT with a strict subset of RAR grants and AAP capabilities. The child's controller_did is set to the parent sub; the chain is recorded in aap_delegation for audit.

• subject_token — Parent JWT to derive from
• child_bearer_did — DID that will hold the child token
• child_dpop_jkt — DPoP key thumbprint (JWK SHA-256) for the child holder
• requested_rar — Subset of parent RAR grants the child should receive
• requested_aap_capabilities — Subset of parent AAP capabilities
• requested_ttl_secs — Requested lifetime (clamped to AS max_ttl_secs)

{
  "jsonrpc": "2.0",
  "method": "tenzro_exchangeToken",
  "params": [{
    "subject_token": "<parent JWT>",
    "child_bearer_did": "did:tenzro:machine:6ba7b810-...",
    "child_dpop_jkt": "<child DPoP JWK thumbprint>",
    "requested_rar": [
      { "type": "tenzro.transfer", "max_amount": "10.0", "asset": "TNZO" }
    ],
    "requested_aap_capabilities": ["inference"],
    "requested_ttl_secs": 3600
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "access_token": "<child JWT>",
    "expires_in": 3600,
    "token_type": "DPoP",
    "issued_token_type": "urn:ietf:params:oauth:token-type:jwt",
    "delegation": {
      "controller_did": "did:tenzro:human:550e8400-...",
      "delegation_chain": ["did:tenzro:human:550e8400-...", "did:tenzro:machine:6ba7b810-..."]
    }
  },
  "id": 1
}

tenzro_introspectToken

RFC 7662 Token Introspection. Resource servers and audit tools verify a token. Per RFC 7662 §2.2, expired/revoked/unknown tokens return only {active: false} — no metadata leaks. Active tokens return the full claim set including DPoP cnf.jkt, RAR authorization_details, and AAP claims.

• token — JWT to introspect

{
  "jsonrpc": "2.0",
  "result": {
    "active": true,
    "iss": "https://api.tenzro.network",
    "sub": "did:tenzro:human:550e8400-...",
    "aud": "https://api.tenzro.network",
    "exp": 1747900000,
    "iat": 1747800000,
    "cnf": { "jkt": "<DPoP JWK thumbprint>" },
    "authorization_details": [
      { "type": "tenzro.transfer", "max_amount": "100.0", "asset": "TNZO" }
    ],
    "aap_capabilities": ["inference", "transfer"],
    "aap_delegation": ["did:tenzro:human:550e8400-..."]
  },
  "id": 1
}

tenzro_oauthDiscovery

RFC 8414 Authorization Server metadata. Returns the same document served at /.well-known/openid-configuration. Clients use this to discover the token, introspection, and revocation endpoints, supported grant types, and the full list of AAP claims this AS issues.

{
  "jsonrpc": "2.0",
  "result": {
    "issuer": "https://api.tenzro.network",
    "token_endpoint": "https://api.tenzro.network/oauth/token",
    "introspection_endpoint": "https://api.tenzro.network/oauth/introspect",
    "revocation_endpoint": "https://api.tenzro.network/oauth/revoke",
    "grant_types_supported": [
      "urn:ietf:params:oauth:grant-type:token-exchange",
      "refresh_token"
    ],
    "token_endpoint_auth_methods_supported": ["none"],
    "dpop_signing_alg_values_supported": ["EdDSA"],
    "authorization_details_types_supported": [
      "tenzro.transfer", "tenzro.create_escrow", "tenzro.discharge_escrow",
      "tenzro.inference", "tenzro.stake", "tenzro.vote",
      "tenzro.contract", "tenzro.register_identity"
    ],
    "aap_claims_supported": [
      "aap_agent", "aap_task", "aap_capabilities",
      "aap_oversight", "aap_delegation", "aap_context", "aap_audit"
    ]
  },
  "id": 1
}

tenzro_refreshToken

Refresh an existing JWT. The new token preserves the cnf.jkt binding, RAR grants, and AAP claims; only iat/exp are advanced.

• refresh_token — Refresh token issued alongside the access token

tenzro_revokeToken

RFC 7009 Token Revocation. Revokes a token and cascades to all child tokens minted from it via Token Exchange.

• token — JWT to revoke

{
  "jsonrpc": "2.0",
  "result": { "revoked": true, "cascaded_count": 2 },
  "id": 1
}

tenzro_participate

One-click onboarding: provisions a TDIP identity, MPC wallet, and hardware profile.

• display_name — Display name for the identity

{
  "jsonrpc": "2.0",
  "method": "tenzro_participate",
  "params": [{ "display_name": "Alice" }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "identity": {
      "did": "did:tenzro:human:550e8400-e29b-41d4-a716-446655440000",
      "display_name": "Alice",
      "identity_type": "human",
      "status": "active"
    },
    "wallet": {
      "wallet_id": "w-a1b2c3d4",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb5",
      "threshold": "2-of-3",
      "key_type": "Ed25519"
    },
    "hardware": {
      "cpu_model": "Apple M2 Pro",
      "cpu_cores": 12,
      "total_ram_gb": 32.0,
      "gpus": []
    }
  },
  "id": 1
}

tenzro_importIdentity

Import an existing private key to create a TDIP identity and MPC wallet.

• private_key — Hex-encoded private key (with or without 0x prefix)
• key_type — "ed25519" or "secp256k1"
• display_name — Display name for the identity
• password — Password for encrypting wallet key shares

{
  "jsonrpc": "2.0",
  "result": {
    "identity": {
      "did": "did:tenzro:human:661f9500-f30c-52e5-b827-557766551111",
      "display_name": "Alice",
      "status": "active"
    },
    "wallet": {
      "wallet_id": "w-e5f6g7h8",
      "address": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72",
      "threshold": "2-of-3",
      "key_type": "Ed25519"
    }
  },
  "id": 1
}

tenzro_joinAsMicroNode

Join the network as a lightweight micro node with minimal resource requirements.

• display_name — Display name for the identity

{
  "jsonrpc": "2.0",
  "result": {
    "did": "did:tenzro:human:...",
    "role": "light_client",
    "status": "joined"
  },
  "id": 1
}

tenzro_registerIdentity

Register a new TDIP identity (human).

• identity_type — "human"
• display_name — Display name

{
  "jsonrpc": "2.0",
  "result": {
    "did": "did:tenzro:human:550e8400-e29b-41d4-a716-446655440000",
    "wallet_address": "0x742d35Cc..."
  },
  "id": 1
}

tenzro_registerMachineIdentity

Register a machine/agent identity with a controller DID.

• controller_did — Controller DID (human or autonomous)
• capabilities — Array of capability strings
• delegation_scope — Optional delegation scope object

{
  "jsonrpc": "2.0",
  "result": {
    "did": "did:tenzro:machine:controller123:agent-uuid",
    "controller": "did:tenzro:human:...",
    "status": "active"
  },
  "id": 1
}

tenzro_resolveIdentity

Resolve a DID to its identity record.

• did — DID to resolve (e.g., "did:tenzro:human:...")

{
  "jsonrpc": "2.0",
  "result": {
    "did": "did:tenzro:human:550e8400-...",
    "display_name": "Alice",
    "identity_type": "human",
    "kyc_tier": "Unverified",
    "status": "active",
    "wallet_address": "0x742d35Cc..."
  },
  "id": 1
}

tenzro_resolveDidDocument

Returns a W3C-compliant DID Document for a given DID.

• did — DID to resolve

{
  "jsonrpc": "2.0",
  "result": {
    "@context": "https://www.w3.org/ns/did/v1",
    "id": "did:tenzro:human:550e8400-...",
    "verificationMethod": [...],
    "authentication": [...]
  },
  "id": 1
}

tenzro_listIdentities

List all identities registered on this node.

{
  "jsonrpc": "2.0",
  "result": [
    { "did": "did:tenzro:human:...", "display_name": "Alice", "status": "active" },
    { "did": "did:tenzro:machine:...", "status": "active" }
  ],
  "id": 1
}

tenzro_addCredential

Add a verifiable credential to an identity.

• did — DID to add credential to
• credential_type — Credential type (e.g., KycAttestation)
• issuer — Issuer DID
• claims — Claims object

{
  "jsonrpc": "2.0",
  "result": { "credential_id": "cred_abc123", "status": "issued" },
  "id": 1
}

tenzro_addService

Add a service endpoint to a DID Document.

• did — DID to add service to
• service_type — Service type (e.g., MCP, A2A, LinkedDomains)
• endpoint — Service endpoint URL

{
  "jsonrpc": "2.0",
  "result": { "status": "added" },
  "id": 1
}

tenzro_setUsername

Register a globally unique username for a DID. Usernames must be 3-20 characters, lowercase alphanumeric and underscores only.

• did — DID to set the username for
• username — Desired username (e.g., alice, bob_42)

{
  "jsonrpc": "2.0",
  "result": { "username": "alice", "did": "did:tenzro:human:abc..." },
  "id": 1
}

tenzro_resolveUsername

Resolve a username to its associated DID.

• username — Username to resolve

{
  "jsonrpc": "2.0",
  "result": { "username": "alice", "did": "did:tenzro:human:abc..." },
  "id": 1
}

tenzro_nodeInfo

Returns information about the node.

{
  "jsonrpc": "2.0",
  "result": {
    "version": "0.1.0",
    "role": "validator",
    "peer_id": "12D3KooWABC...",
    "chain_id": 1337,
    "block_height": 1207
  },
  "id": 1
}

tenzro_peerCount

Returns the number of connected peers.

{
  "jsonrpc": "2.0",
  "result": { "peer_count": 25 },
  "id": 1
}

tenzro_syncing

Returns the sync status of the node. The node tracks peer heights via periodic StatusMessage gossip on tenzro/status/1.0.0; the highest_block estimate is max(local_tip, max(fresh_peer_heights)). Returns false when caught up (within 2 blocks of the network tip), or { syncing: true, ... } when lagging — drive a catch-up loop with tenzro_getBlockRange.

{
  "jsonrpc": "2.0",
  "result": { "syncing": true, "starting_block": 0, "current_block": 1207, "highest_block": 4982 },
  "id": 1
}

tenzro_getHardwareProfile

Detects and returns hardware profile (CPU, RAM, GPUs, TEE support).

{
  "jsonrpc": "2.0",
  "result": {
    "cpu_model": "AMD EPYC 7763",
    "cpu_cores": 64,
    "total_ram_gb": 256.0,
    "gpus": [{ "name": "NVIDIA A100", "memory_gb": 80.0 }],
    "tee_support": "AmdSevSnp"
  },
  "id": 1
}

tenzro_setRole

Set the node role.

• role — "validator", "provider", "tee-provider", or "user"

{
  "jsonrpc": "2.0",
  "result": { "role": "provider", "status": "active" },
  "id": 1
}

tenzro_exportConfig

Export the current node configuration.

{
  "jsonrpc": "2.0",
  "result": {
    "role": "validator",
    "listen_addr": "/ip4/0.0.0.0/tcp/9000",
    "rpc_addr": "127.0.0.1:8545",
    "chain_id": 1337
  },
  "id": 1
}

tenzro_shutdown

Gracefully shut down the node (admin only).

{
  "jsonrpc": "2.0",
  "result": { "status": "shutting_down" },
  "id": 1
}

tenzro_listModels

List available AI models on the network.

• category — Filter by category (e.g., "llm", "vision") — optional
• modality — Filter by modality (e.g., "text", "image") — optional

{
  "jsonrpc": "2.0",
  "result": [
    {
      "id": "gemma4-9b",
      "name": "Gemma 4 9B",
      "category": "llm",
      "modality": "text",
      "price_per_token": "0.0001"
    }
  ],
  "id": 1
}

tenzro_inferenceRequest

Request raw AI inference from a model. Uses the raw prompt without applying a chat template. For chat applications, prefer tenzro_chat instead.

• model_id — Model identifier
• input — Raw prompt text (no chat template applied)
• strategy — Routing strategy: Cheapest, LowestLatency, HighestReputation, Weighted (optional)
• max_tokens — Maximum tokens to generate (optional)

{
  "jsonrpc": "2.0",
  "method": "tenzro_inferenceRequest",
  "params": [{
    "model_id": "gemma4-9b",
    "input": "What is the capital of France?",
    "strategy": "Cheapest",
    "max_tokens": 100
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "request_id": "req_abc123",
    "status": "pending",
    "estimated_cost": "0.05 TNZO"
  },
  "id": 1
}

tenzro_chat

Send a chat message to a served model. Applies the model's chat template for proper formatting (recommended for chat apps and coding assistants).

• model_id — Model identifier
• message — Chat message text (string, not array)
• max_tokens — Maximum tokens (optional)

{
  "jsonrpc": "2.0",
  "method": "tenzro_chat",
  "params": [{
    "model_id": "qwen3.5-0.8b",
    "message": "Write a hello world function",
    "max_tokens": 200
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "id": "chatcmpl-abc123",
    "choices": [{
      "message": { "role": "assistant", "content": "Hello! How can I help?" },
      "finish_reason": "stop"
    }],
    "usage": { "prompt_tokens": 10, "completion_tokens": 8, "total_tokens": 18 }
  },
  "id": 1
}

tenzro_downloadModel

Download a GGUF model from HuggingFace via direct HTTP streaming. Files are saved to ~/.tenzro/models/<model-id>.gguf as a flat file.

• model_id — Model identifier or HuggingFace repo

{
  "jsonrpc": "2.0",
  "method": "tenzro_downloadModel",
  "params": [{ "model_id": "gemma4-9b" }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": { "status": "downloading", "model_id": "gemma4-9b" },
  "id": 1
}

tenzro_getDownloadProgress

Check download progress for a model. Includes percentage updates and an error field on failure.

• model_id — Model identifier

// Success (in progress):
{
  "jsonrpc": "2.0",
  "result": { "model_id": "gemma4-9b", "status": "downloading", "progress": 0.75, "downloaded_bytes": 37580963840, "total_bytes": 50107951787 },
  "id": 1
}

// Failure:
{
  "jsonrpc": "2.0",
  "result": { "model_id": "gemma4-9b", "status": "failed", "error": "HTTP 404 from HuggingFace" },
  "id": 1
}

tenzro_serveModel

Start serving a model for inference requests.

• model_id — Model to serve
• price_per_token — Price per token in TNZO (optional)

{
  "jsonrpc": "2.0",
  "result": { "model_id": "gemma4-9b", "status": "serving", "price_per_token": "0.0001" },
  "id": 1
}

tenzro_stopModel

Stop serving a model. Waits for in-flight inference requests to complete before freeing the llama.cpp context to prevent OOM errors.

• model_id — Model to stop

{
  "jsonrpc": "2.0",
  "result": { "model_id": "gemma4-9b", "status": "stopped" },
  "id": 1
}

tenzro_deleteModel

Delete a downloaded model from local storage.

• model_id — Model to delete

{
  "jsonrpc": "2.0",
  "result": { "model_id": "gemma4-9b", "deleted": true },
  "id": 1
}

tenzro_listModelEndpoints

List active model service endpoints with API and MCP URLs.

{
  "jsonrpc": "2.0",
  "result": [
    {
      "model_id": "gemma4-9b",
      "provider": "0x742d35Cc...",
      "api_url": "http://10.0.0.5:8080/v1",
      "mcp_url": "http://10.0.0.5:3001/mcp",
      "status": "active"
    }
  ],
  "id": 1
}

tenzro_getModelEndpoint

Get details for a specific model endpoint.

• endpoint_id — Endpoint identifier

{
  "jsonrpc": "2.0",
  "result": {
    "endpoint_id": "ep_abc123",
    "model_id": "gemma4-9b",
    "api_url": "http://10.0.0.5:8080/v1",
    "status": "active"
  },
  "id": 1
}

tenzro_registerModelEndpoint

Register a new model service endpoint.

• model_id — Model being served
• api_url — API endpoint URL
• mcp_url — MCP endpoint URL (optional)

{
  "jsonrpc": "2.0",
  "result": { "endpoint_id": "ep_abc123", "status": "registered" },
  "id": 1
}

tenzro_unregisterModelEndpoint

Remove a model service endpoint from the registry.

• endpoint_id — Endpoint identifier

{
  "jsonrpc": "2.0",
  "result": { "status": "unregistered" },
  "id": 1
}

tenzro_discoverModels

Discover models available on the network with filtering.

• query — Search query (optional)
• category — Category filter (optional)

{
  "jsonrpc": "2.0",
  "result": [
    { "id": "gemma4-9b", "name": "Gemma 4 9B", "providers": 3, "avg_price": "0.0001" }
  ],
  "id": 1
}

tenzro_loadForecastModel

Load an ONNX timeseries model from HuggingFace into the runtime registry. Pulls the .onnx artifact, opens an ORT session, and registers it under model_id.

• model_id — Stable identifier used for subsequent calls
• hf_repo — HuggingFace repo, e.g. "tenzro/timeseries-onnx"
• hf_filename — ONNX file path within the repo, e.g. "chronos-bolt-base.onnx"
• context_length — Maximum input history length (e.g. 512)
• max_horizon — Maximum forecast horizon (e.g. 64)
• n_quantiles — Number of quantile outputs, or 0 for point forecasts

{
  "jsonrpc": "2.0",
  "method": "tenzro_loadForecastModel",
  "params": [{
    "model_id": "chronos-bolt-base",
    "hf_repo": "tenzro/timeseries-onnx",
    "hf_filename": "chronos-bolt-base.onnx",
    "context_length": 512,
    "max_horizon": 64,
    "n_quantiles": 9
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": { "model_id": "chronos-bolt-base", "status": "loaded" },
  "id": 1
}

tenzro_unloadForecastModel

Unload a previously loaded forecast model and free its ORT session.

• model_id — Identifier passed to tenzro_loadForecastModel

{
  "jsonrpc": "2.0",
  "result": { "model_id": "chronos-bolt-base", "status": "unloaded" },
  "id": 1
}

tenzro_listForecastModels

List all currently loaded forecast models.

{
  "jsonrpc": "2.0",
  "result": [
    { "model_id": "chronos-bolt-base", "context_length": 512, "max_horizon": 64, "n_quantiles": 9 }
  ],
  "id": 1
}

tenzro_forecast

Run a forecast against a loaded model. Returns the predicted horizon and, if the model supports it, per-step quantiles.

• model_id — Identifier of a loaded forecast model
• history — Input series as a flat array of f32 values, length ≤ context_length
• horizon — Forecast horizon (optional; defaults to max_horizon)
• num_samples — Number of probabilistic samples (optional; model-dependent)

{
  "jsonrpc": "2.0",
  "method": "tenzro_forecast",
  "params": [{
    "model_id": "chronos-bolt-base",
    "history": [42.1, 43.0, 41.8, 44.2, 45.0],
    "horizon": 16
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "forecast": [45.3, 45.8, 46.1, 46.5],
    "quantiles": [[44.1, 45.3, 46.5], [44.5, 45.8, 47.0]],
    "generation_time_ms": 38
  },
  "id": 1
}

tenzro_listVisionCatalog

List the verified ONNX vision encoders bundled with the catalog. Each entry carries its HuggingFace repo, input size, embedding dimension, and recommended normalization preset.

{
  "jsonrpc": "2.0",
  "result": [
    { "id": "clip-vit-b32", "hf_repo": "Xenova/clip-vit-base-patch32", "input_size": 224, "embedding_dim": 512, "normalization": "clip", "license": "MIT" },
    { "id": "clip-vit-l14", "hf_repo": "Xenova/clip-vit-large-patch14", "input_size": 224, "embedding_dim": 768, "normalization": "clip", "license": "MIT" },
    { "id": "siglip-base-224", "embedding_dim": 768, "normalization": "siglip", "license": "Apache-2.0" },
    { "id": "siglip2-base-224", "embedding_dim": 768, "normalization": "siglip", "license": "Apache-2.0" },
    { "id": "dinov2-small", "embedding_dim": 384, "normalization": "imagenet", "license": "Apache-2.0" },
    { "id": "dinov2-base", "embedding_dim": 768, "normalization": "imagenet", "license": "Apache-2.0" },
    { "id": "dinov2-large", "embedding_dim": 1024, "normalization": "imagenet", "license": "Apache-2.0" }
  ],
  "id": 1
}

tenzro_loadVisionModel

Load an ONNX image encoder. Two forms: (1) explicit — pass model_id, hf_repo, hf_filename, input_size, embedding_dim, and normalization; (2) catalog shortcut — pass catalog_id matching an entry in tenzro_listVisionCatalog and the runtime fills in the rest via get_vision_model_by_id.

• catalog_id — Catalog identifier (e.g. clip-vit-b32) — shortcut form
• model_id — Stable identifier — explicit form
• hf_repo — HuggingFace repo — explicit form
• hf_filename — ONNX file path within the repo — explicit form
• input_size — Square input edge length (e.g. 224) — explicit form
• embedding_dim — Output embedding dimension — explicit form
• normalization — One of "clip", "imagenet", "siglip" — explicit form

// Catalog shortcut
{
  "jsonrpc": "2.0",
  "method": "tenzro_loadVisionModel",
  "params": [{ "catalog_id": "clip-vit-b32" }],
  "id": 1
}

// Explicit form
{
  "jsonrpc": "2.0",
  "method": "tenzro_loadVisionModel",
  "params": [{
    "model_id": "clip-vit-b32",
    "hf_repo": "Xenova/clip-vit-base-patch32",
    "hf_filename": "onnx/vision_model.onnx",
    "input_size": 224,
    "embedding_dim": 512,
    "normalization": "clip"
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": { "model_id": "clip-vit-b32", "status": "loaded" },
  "id": 1
}

tenzro_unloadVisionModel

Unload a previously loaded vision model.

• model_id — Identifier passed to tenzro_loadVisionModel

{
  "jsonrpc": "2.0",
  "result": { "model_id": "clip-vit-b32", "status": "unloaded" },
  "id": 1
}

tenzro_listVisionModels

List all currently loaded vision encoders.

{
  "jsonrpc": "2.0",
  "result": [
    { "model_id": "clip-vit-b32", "input_size": 224, "embedding_dim": 512, "normalization": "clip" }
  ],
  "id": 1
}

tenzro_imageEmbed

Encode a single image into a dense embedding. Accepts base64-encoded PNG, JPEG, or WebP. Decoded image is resized to the model's input_size using Lanczos3 and normalized per the model's preset.

• model_id — Identifier of a loaded vision model
• image_base64 — Base64-encoded image bytes (PNG, JPEG, or WebP)
• normalize — If true, L2-normalize the output embedding (optional, default false)

{
  "jsonrpc": "2.0",
  "method": "tenzro_imageEmbed",
  "params": [{
    "model_id": "clip-vit-b32",
    "image_base64": "iVBORw0KGgo...",
    "normalize": true
  }],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "model_id": "clip-vit-b32",
    "embedding": [0.014, -0.082, 0.123, ...],
    "embedding_dim": 512
  },
  "id": 1
}

tenzro_imageTextSimilarity

Compute cosine similarity between two pre-computed embeddings. Pure math — no model load required. Useful for image-text retrieval when text embeddings come from a separate text encoder.

• image_embedding — Image embedding vector (array of f32)
• text_embedding — Text embedding vector (array of f32, same dimension)

{
  "jsonrpc": "2.0",
  "method": "tenzro_imageTextSimilarity",
  "params": [{
    "image_embedding": [0.014, -0.082, ...],
    "text_embedding": [0.021, -0.075, ...]
  }],
  "id": 1
}