wickra-proof-core 0.1.0

Deterministic Proof-of-Backtest core: fold a (spec, data) pair into a wickra-backtest report and a canonical blake3 hash reproducible byte-for-byte across ten languages.
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

//! Error type for `wickra-proof-core`.

/// Errors returned by wickra-proof-core operations. Every fallible boundary (parsing,
/// engine invocation, canonicalization) maps into one of these; no operation
/// panics on caller-supplied input.
#[derive(Debug, thiserror::Error)]
pub enum Error {
    /// A JSON or TOML value failed to parse.
    #[error("parse: {0}")]
    Parse(String),
    /// The embedded strategy JSON is not a valid `StrategySpec`.
    #[error("bad spec: {0}")]
    BadSpec(String),
    /// The pinned `engine_version` differs from the linked backtest engine.
    #[error("engine mismatch: expected {expected}, linked {linked}")]
    EngineMismatch {
        /// The version pinned in the `ProofSpec`.
        expected: String,
        /// The version of the linked `wickra-backtest` engine.
        linked: String,
    },
    /// The backtest engine returned an error.
    #[error("backtest: {0}")]
    Backtest(String),
    /// The data map lacked the candles required by the strategy.
    #[error("data: {0}")]
    Data(String),
}

/// Result alias for wickra-proof-core.
pub type Result<T> = core::result::Result<T, Error>;

impl From<serde_json::Error> for Error {
    fn from(e: serde_json::Error) -> Self {
        Error::Parse(e.to_string())
    }
}