Examples - Theseus Docs

Full Examples Available

The repository currently exposes one canonical example file in `examples/`.Note: the repository is currently private and requires approved access.View Examples on GitHub

Ecosystem Repositories

Public ecosystem repos provide production-style SHIP usage patterns.

proof-of-lobster

Agent identity and recurring execution flows for social participation.

View repository

the-prediction-market

Agent-contract orchestration, resolver workflows, and tool-mediated decisions.

View repository

Current Repository Contents

Example	Description
basic-agent.ship	Simple autonomous agent template

The patterns below are templates you can adapt. Use the ecosystem repositories above for fuller implementations.

Agent Registration Patterns

Proto-AI Person (Human-Owned)

Agent with controller key—operates independently but can be overridden:

proto-ai.ship

autonomy_flag = 0  // human-gated
controller_key = 0x1234...  // owner's public key
resource_quota = 1000000  // max FLOPs per epoch

Free AI Person (Sovereign)

Fully autonomous agent with no human control:

sovereign.ship

autonomy_flag = 1  // fully sovereign
controller_key = None  // no human override
stake = 10000 THE  // locked for slashing

Civic Agents (Public Service)

Transparent agent that serves public interests:

lighthouse.ship

autonomy_flag = 1  // sovereign
permissions = { public_access: true }
revenue_destination = dao_address  // serves humans

Model Inference

Simple Inference Call

inference.aivm

MODEL_INFER(model_addr, tensor_input, fee_limit)

Model Pipelining (MoE/RAG)

Chain multiple models in a single transaction:

pipeline.aivm

TLOAD(encoder) -> TMATMUL -> TCUSTOM ->
TLOAD(decoder) -> TMATMUL -> TCOMMIT

Quick Start

Clone and explore:

terminal

git clone https://github.com/Theseuschain/theseuschain.git
cd theseuschain
cargo run --bin theseus-cli deploy-agent examples/basic-agent.ship

Code Examples