Struct ModuleManifest 

pub struct ModuleManifest {

    pub name: String,
    pub version: String,
    pub entry_point: String,
    pub description: Option<String>,
    pub author: Option<String>,
    pub capabilities: Vec<String>,
    pub dependencies: HashMap<String, String>,
    pub optional_dependencies: HashMap<String, String>,
    pub config_schema: HashMap<String, String>,
    pub rpc_overrides: Vec<String>,
    pub signatures: Option<SignatureSection>,
    pub binary: Option<BinarySection>,
    pub downloads: HashMap<String, PlatformDownload>,
    pub payment: Option<PaymentSection>,
}

Module manifest (module.toml structure)

The manifest defines a module’s identity, dependencies, and capabilities. It follows a clean, hierarchical structure:

# Core metadata (required)
name = "my-module"
version = "1.0.0"
entry_point = "my-module"

# Optional metadata
description = "What this module does"
author = "Author Name <email@example.com>"

# Capabilities (permissions this module requires)
capabilities = ["read_blockchain", "subscribe_events"]

# Dependencies
[dependencies]
"blvm-lightning" = ">=1.0.0"

[optional_dependencies]
"blvm-mesh" = ">=0.5.0"

# Configuration schema (optional)
[config_schema]
poll_interval = "Polling interval in seconds"

Fields

name: String

Module name (unique identifier, alphanumeric with dashes/underscores)

version: String

Module version (semantic versioning: major.minor.patch)

entry_point: String

Module entry point (binary name or path relative to module directory)

description: Option<String>

Human-readable description of what this module does

author: Option<String>

Module author (name and/or email)

capabilities: Vec<String>

Capabilities this module requires (permissions) These determine what APIs the module can access

dependencies: HashMap<String, String>

Required dependencies (hard dependencies) Module will fail to load if these are missing or unavailable

optional_dependencies: HashMap<String, String>

Optional dependencies (soft dependencies) Module can load and function without these

config_schema: HashMap<String, String>

Configuration schema (descriptions of config keys) Maps config key names to their descriptions

rpc_overrides: Vec<String>

JSON-RPC core methods this module intends to override. Each entry must be in OVERRIDABLE_CORE_RPC_METHODS; validated at load time. The module registers the actual handler at runtime via register_core_rpc_override.

signatures: Option<SignatureSection>

Signature section (for signed/verified modules) Contains maintainer signatures and threshold

binary: Option<BinarySection>

Binary information (local integrity — populated at install time) Contains hash and size for the already-installed binary

downloads: HashMap<String, PlatformDownload>

Remote download coordinates per platform (written by release CI).

The node reads this section during bootstrap install to obtain the correct URL and SHA-256 for the running platform, eliminating the need for a central registry to track per-version binary locations.

Keys: "x86_64-linux" | "aarch64-linux" | "x86_64-apple" | "aarch64-apple"

payment: Option<PaymentSection>

Payment configuration (for paid modules) Contains cryptographically signed payment addresses

Implementations

impl ModuleManifest

pub fn from_file<P>(path: P) -> Result<ModuleManifest, ModuleError>

where P: AsRef<Path>,

Load manifest from file

pub fn to_metadata(&self) -> ModuleMetadata

Convert to ModuleMetadata

pub fn get_threshold(&self) -> Option<(usize, usize)>

Get signature threshold as (required, total) tuple

Parses threshold string like “2-of-3” into (2, 3). Returns None if threshold is not set or cannot be parsed.

pub fn parse_threshold(threshold_str: &str) -> Option<(usize, usize)>

Parse threshold string like “2-of-3” into (2, 3)

pub fn get_signatures(&self) -> Vec<(String, String)>

Get signatures as (maintainer, signature_hex) pairs

pub fn get_public_keys(&self) -> HashMap<String, String>

Get public keys as (maintainer, pubkey_hex) map

pub fn has_signatures(&self) -> bool

Check if manifest has signatures

Trait Implementations

impl Clone for ModuleManifest

fn clone(&self) -> ModuleManifest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ModuleManifest

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ModuleManifest

fn deserialize<__D>( __deserializer: __D, ) -> Result<ModuleManifest, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ModuleManifest

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<ModuleManifest> for ModuleMetadata

type Error = ModuleError

The type returned in the event of a conversion error.

fn try_from( manifest: ModuleManifest, ) -> Result<ModuleMetadata, <ModuleMetadata as TryFrom<ModuleManifest>>::Error>

Performs the conversion.