dig-options 0.1.0

The DIG Network canonical Chia option-contract (CHIP-0042) expert crate: a pure, key-free, network-free CoinSpend-builder for covered options — create, exercise, clawback/cancel, inspect. Never holds a key, never signs, never broadcasts — the consumer signs + pushes.
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

//! The crate error taxonomy.
//!
//! Every fallible operation in dig-options returns [`Result`], whose error is [`Error`].
//! The variants separate the three failure sources a pure builder can hit: a lower-level
//! driver failure while constructing a spend, a signer failure while computing the required
//! signatures, and caller-supplied input that cannot produce a valid spend.

use chia_wallet_sdk::driver::DriverError;
use chia_wallet_sdk::signer::SignerError;

/// The result of a dig-options operation.
pub type Result<T> = std::result::Result<T, Error>;

/// Everything that can go wrong while building an option coin spend or reporting the
/// signatures a coin spend requires.
#[derive(Debug, thiserror::Error)]
pub enum Error {
    /// A failure in the underlying chia-wallet-sdk driver while constructing a spend
    /// (allocation, currying, puzzle assembly, launcher mint).
    #[error("driver error: {0}")]
    Driver(#[from] DriverError),

    /// A failure while computing the BLS signatures a coin spend requires.
    #[error("signer error: {0}")]
    Signer(#[from] SignerError),

    /// Caller-supplied input that cannot produce a valid spend (e.g. a zero underlying
    /// amount, an underfunded coin, a wrong-party clawback, or an unsupported strike type).
    /// The message states the precise violation.
    #[error("invalid input: {0}")]
    InvalidInput(String),
}

impl Error {
    /// Construct an [`Error::InvalidInput`] from any displayable message.
    pub(crate) fn invalid(message: impl Into<String>) -> Self {
        Error::InvalidInput(message.into())
    }
}