Modules

Overview of GenVM’s core architectural components and design patterns.

• Web Module
  • Web Scraping Capabilities
  • HTTP Request Handling
  • Security and Compliance
• Large Language Model (LLM) Module
  • Capabilities
  • Configuration

Overview

Modules provide GenVM with non-deterministic capabilities that extend beyond traditional blockchain operations. These modules enable intelligent contracts to interact with AI services, access web content, and process real-world data while maintaining consensus through specialized validation mechanisms.

Module Architecture

Design Principles

• Isolation: Modules run in separate processes to prevent contamination of deterministic execution

• Extensibility: Lua scripting support

• Security: Controlled access

Communication Protocol

• WebSocket Interface:

  • Asynchronous communication between GenVM and modules

  • Message serialization using Calldata Encoding

  • Request-response pattern with timeout handling

  • Connection lifecycle management and reconnection

• Message Structure:

  • Standardized request/response envelope

  • Type-safe parameter encoding

  • Error handling and status reporting

Module Lifecycle

• Initialization:

  • Module process startup

  • Configuration loading and validation

  • Initial health check

  • Binding listening address

• Operation:

  • Accepting GenVM connections

  • Request processing and external service interaction

  • Result validation and transformation

  • Resource monitoring and usage tracking

  • Error handling and recovery procedures

• Termination:

  • Graceful shutdown and resource cleanup