borderless-runtime 0.5.0

Definition of the webassembly runtime for borderless smart-contracts and software-agents
Documentation 
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

pub mod db;
pub mod error;

#[cfg(feature = "http")]
pub mod http;

mod rt;

pub use error::{Error, Result};

#[cfg(feature = "contracts")]
pub use rt::contract::{
    MutLock as ContractLock, Runtime as ContractRuntime, SharedRuntime as SharedContractRuntime,
};

#[cfg(feature = "agents")]
pub use rt::agent::{
    MutLock as AgentLock, Runtime as AgentRuntime, SharedRuntime as SharedAgentRuntime,
};

// Forward module content
#[cfg(any(feature = "contracts", feature = "agents"))]
pub use rt::*;

/// Sub-Database for all contract related data
pub const CONTRACT_SUB_DB: &str = "contract-db";

/// Sub-Database for all agent related data
pub const AGENT_SUB_DB: &str = "agent-db";

/// Sub-Database, where the wasm code is stored
pub const WASM_CODE_SUB_DB: &str = "wasm-code-db";

/// Sub-Database to store the relationship between an action and a transaction
pub const ACTION_TX_REL_SUB_DB: &str = "rel-tx-action-db";

/// Sub-Database to store the relationship between contracts and agents, and vice-versa
pub const SUBSCRIPTION_REL_SUB_DB: &str = "rel-subscription-db";

/// Sub-Database, where the ledger information is stored
pub const LEDGER_SUB_DB: &str = "ledger-db";

// TODO: Tracing vs Logging !
// We should make this toggleable via feature switch.

mod log_shim {
    #[cfg(all(feature = "tracing", not(feature = "log")))]
    pub use tracing::{debug, error, info, trace, warn};

    #[cfg(all(feature = "log", not(feature = "tracing")))]
    pub use log::{debug, error, info, trace, warn};

    // If neither logging or tracing are enabled, just send the input into the void
    #[cfg(any(
        all(not(feature = "log"), not(feature = "tracing")),
        all(feature = "log", feature = "tracing")
    ))]
    pub use crate::void as trace;

    #[cfg(any(
        all(not(feature = "log"), not(feature = "tracing")),
        all(feature = "log", feature = "tracing")
    ))]
    pub use crate::void as debug;

    #[cfg(any(
        all(not(feature = "log"), not(feature = "tracing")),
        all(feature = "log", feature = "tracing")
    ))]
    pub use crate::void as info;

    #[cfg(any(
        all(not(feature = "log"), not(feature = "tracing")),
        all(feature = "log", feature = "tracing")
    ))]
    pub use crate::void as warn;

    #[cfg(any(
        all(not(feature = "log"), not(feature = "tracing")),
        all(feature = "log", feature = "tracing")
    ))]
    pub use crate::void as error;

    #[cfg(any(
        all(not(feature = "log"), not(feature = "tracing")),
        all(feature = "log", feature = "tracing")
    ))]
    #[macro_export]
    macro_rules! void {
        ($($t:tt)*) => {{
            let _ = format_args!($($t)*);
        }};
    }

    // NOTE: We emit a compiler warning in the build.rs - which is far better than a compiler error.
    //
    // #[cfg(all(feature = "log", feature = "tracing"))]
    // compile_error!("Features `log` and `tracing` are mutually exclusive.");
}