Reference

Runtime reference

Pallets, extrinsics, and network parameters as configured at alpha. Authoritative source, taken directly from the runtime.

Versioning

These values are accurate for the current preview build. The runtime is upgraded forklessly via governance, so individual parameters can change between releases. Status changes are announced on Status & Roadmap.

Pallets

Theseus is built on Substrate. The runtime composes several Theseus-specific FRAME pallets alongside standard ones (balances, transaction_payment, timestamp, aura, grandpa). The Theseus pallets decouple inference verification from the higher-level callers via the OnInferenceVerified hook on pallet_aivm.

pallet_aivm

Inference job queue and verification kernel. Receives model and agent calls, emits InferenceQueued, verifies proofs via the native KZG host function, routes results to higher pallets via a generic OnInferenceVerified hook.

pallet_models

Model registry. Stores metadata (id, tag, weights root, pricing). Exposes call_model.

pallet_agents

Agent registry and ABG runtime. Stores agent state, behavior graphs, loop positions. Manages lifecycle, wake triggers, and seus balances. Exposes call_agent.

pallet_tools

Tool dispatch. Queues off-chain tool calls (web search, authenticated HTTP) and accepts results via submit_tool_result from the registered enclave identity.

pallet_store

TheseusStore anchoring. Maintains content-addressed roots (weights_root, context_root) for off-chain data with on-chain integrity verification.

pallet_ship

Intent execution and economics. Validates and applies SHIP intents (transfers, context updates, cross-chain messages, contract calls) emitted by agents at ABG terminal nodes.

pallet_contracts

Standard Substrate Wasm contracts. Agents interact via chain extension.

Extrinsics

The minimal set of extrinsics exposed to users, agent deployers, provers, and the registered enclave operator. Caller column shows who can submit each extrinsic.

PalletExtrinsicDescriptionCaller
modelsregister_modelRegister a new model with tag and weights rootRoot
modelsupdate_modelUpdate model metadataRoot
modelscall_modelQueue a direct model inference jobAny user
agentsregister_agentDeploy agent with ABG, system prompt, tools, initial fundingAny user
agentscall_agentInvoke agent with entrypoint and inputAny user
agentsupdate_agentUpdate agent configurationController
aivmsubmit_inference_resultSubmit inference output with proof or signatureProver
toolssubmit_tool_resultSubmit tool execution result (web search, authenticated HTTP)Enclave operator

Network parameters

Configured limits and constants from the alpha runtime. Use these when sizing agent designs and estimating job throughput.

CategoryParameterValue
BlockSlot duration6 s
Block hash count2400
Max block weight2 s ref time
Max block size5 MB
Normal dispatch ratio75%
AIVMMax input size400 KB
Max output size1 MB
Job expiry600 blocks
Max expired per block32
AgentsMax ABG nodes256
Max node size128 KB
Max system prompt10 KB
Agent name length64 bytes
Max input size400 KB
Max state fields64
Max messages per run10
Max steps per run64
Sync steps per tick16
Max call depth2
Inference retries / node2
Tool retries / node2
ToolsMax tools per agent16
Max calls per message8
Tool name length64 bytes
Max tool arguments64 KB
Max tool result size128 KB
Job expiry600 blocks
Max expired per block10
ModelsModel name length64 bytes
ConsensusMax authorities32
SS58 prefix42
EconomicsToken symbolTHE
Token decimals12
Existential deposit10⁹ (1 milli-unit)

Cryptographic primitives

Theseus uses BLS12-381 for proof verification on-chain. Tensor Commits compose these into a single succinct proof per inference.

BLS12-381

Pairing-friendly elliptic curve. Used for KZG commitment verification on-chain via a native host function.

KZG (tiled, multivariate)

Polynomial commitment scheme. Tensors are tiled and committed using a product-power Structured Reference String.

Sumcheck (Fiat–Shamir)

Verifies linear operations (matrix multiplications) over committed tensors. Made non-interactive via Fiat–Shamir.

Plookup-style lookups

Proofs for nonlinear activations (GELU, SiLU, ReLU, softmax/exp) against precomputed tables.

VRF

Verifiable random function used to assign provers to inference jobs without manipulation.

Aura + GRANDPA

Block production (Aura, slot-based round-robin) and BFT finality (GRANDPA, ≥2/3 agreement).

Documentation