GenVM Internals

Note

Single text file docs for AI

This is a specification of this implementation of GenVM.

The specification has been split into multiple sections for better organization and maintainability.

Contents:

• Glossary
• Core Architecture
  • GenVM Components Overview
    • Introduction
    • High-Level Architecture
    • GenVM Executor
    • Modules
    • Manager
  • Host Interface Protocol
    • Overview
    • Process Management
    • Communication Protocol
    • Data Types and Results
    • Method ID Reference
    • Error Handling
  • Modules
    • Web Module
    • Large Language Model (LLM) Module
    • Overview
    • Module Architecture
  • Executor
    • No Internal Timeout
    • Implications
    • Debug modes
• VM and Supervisor Architecture
  • Modified Wasmtime Runtime
  • Version Management
    • Detection from contract bytes
    • POST /contract/detect-version
    • Runner manifest
    • Compatibility envelope
  • Consensus Mechanics
    • Roles and the is_leader flag
    • Validator Comparison
    • Disagreement and Timeouts
    • Anti-Cheating
• Greyboxing Documentation
  • Retrieving Data from Host
  • Token Charges
  • Current Built-in Filters
    • Text
    • Image
  • Example Usage
  • Sandbox and Execution Model
  • Entry Points
  • Error Propagation
  • Resource Limits
  • Template Contracts
• Fees, Buckets and Expressions
  • Configuration
  • The Expression Language
    • Syntax
    • Types
    • Builtins
    • Free Variables and node
    • Evaluation Model
  • Charge Lifecycle
  • Failure Modes
  • Configuration Sketch
  • Message-Fee Allocation Matching
    • Funding modes
• Appendix
  • Host Loop Pseudocode
    • Multi-Host
    • Connection Hello Data
    • Protocol Loop
  • Manager API
  • Manager Socket Protocol
    • Framing
    • Method ids
    • Connection hello
    • run
    • attach
    • cancel
    • ack
    • get_artifact
    • event notifications
    • Duration strings
    • Error messages
    • Scope note
  • Log Record Format
    • Fields
    • Audience
    • Manager Sink