blvm-node 0.1.90

Bitcoin Commons BLVM: Minimal Bitcoin node implementation using blvm-protocol and blvm-consensus
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

//! Module system for blvm-node
//!
//! This module provides process-isolated module support, enabling optional features
//! (Lightning, merge mining, privacy enhancements) without affecting consensus or
//! base node stability.
//!
//! ## Architecture
//!
//! - **Process Isolation**: Each module runs in separate process with isolated memory
//! - **API Boundaries**: Modules communicate only through well-defined APIs
//! - **Crash Containment**: Module failures don't propagate to base node
//! - **Consensus Isolation**: Modules cannot modify consensus rules, UTXO set, or block validation
//! - **State Separation**: Module state is completely separate from consensus state

pub mod api;

/// Module ids are `{name}_{32 hex}`. Names may contain underscores.
/// A suffix that is not 32 hex characters is part of the name.
pub fn module_name_from_id(module_id: &str) -> &str {
    if let Some((name, suffix)) = module_id.rsplit_once('_') {
        if suffix.len() == 32 && suffix.bytes().all(|b| b.is_ascii_hexdigit()) {
            return name;
        }
    }
    module_id
}
pub mod encryption;
pub mod github_release_install;
pub mod http;
pub mod integration;
pub mod inter_module;
pub mod ipc;
pub mod loader;
pub mod manager;
pub mod metrics;
pub mod pipeline;
pub mod process;
pub mod registry;
pub mod rpc;
pub mod sandbox;
pub mod security;
pub mod services;
pub mod timers;
pub mod traits;
pub mod validation;
pub mod version_constraint;
#[cfg(feature = "wasm-modules")]
pub mod wasm;
#[cfg(feature = "module-watcher")]
pub mod watcher;

pub use security::{Permission, PermissionChecker, PermissionSet, RequestValidator};

pub use api::NodeApiIpc;
pub use encryption::ModuleEncryption;
pub use integration::ModuleIntegration;
pub use manager::ModuleManager;
pub use process::{ModuleProcess, ModuleProcessMonitor, ModuleProcessSpawner};
pub use traits::{
    EventType, Module, ModuleContext, ModuleError, ModuleMetadata, ModuleState, NodeAPI,
};

// Re-export IPC protocol types
pub use ipc::protocol::{EventMessage, EventPayload, ModuleMessage};

// Re-export IPC types conditionally
#[cfg(unix)]
pub use ipc::{ModuleIpcClient, ModuleIpcServer};