Enum ProgramError 

pub enum ProgramError {
    Compilation(String),
    WitnessSatisfaction(String),
    Pruning(ExecutionError),
    BitMachineCreation(LimitError),
    Execution(ExecutionError),
    UtxoIndexOutOfBounds {
        input_index: usize,
        utxo_count: usize,
    },
    ScriptPubkeyMismatch {
        expected_hash: String,
        actual_hash: String,
    },
    TxExtraction(Error),
    InputIndexOverflow(TryFromIntError),
    ProgramGenAbiMeta(String),
}

Errors that can occur when compiling, preparing, and executing Simplicity programs.

Variants

Compilation(String)

Error thrown when compiling the raw Simplicity program source fails.

WitnessSatisfaction(String)

Error indicating failure while matching or satisfying witness values to the program requirements.

Pruning(ExecutionError)

Error indicating pruning the node tree during execution failed safely.

BitMachineCreation(LimitError)

Error thrown when the bit machine cannot be initialized due to complexity or limit restrictions.

Execution(ExecutionError)

Error thrown during bit machine execution due to underlying logical or environment validation errors.

UtxoIndexOutOfBounds

Error indicating an input index points past the bounds of available inputs/UTXOs.

Fields

input_index: usize

The requested input index to spend.

utxo_count: usize

The actual total number of available UTXOs.

ScriptPubkeyMismatch

Error indicating the script pubkey present on the targeted UTXO differs from the expectation.

Fields

expected_hash: String

The expected CMR (Commitment Merkle Root) hash.

actual_hash: String

The actual CMR hash present in the script pubkey.

TxExtraction(Error)

Error thrown when an underlying Elements transaction fails to extract from the PSET wrapper.

InputIndexOverflow(TryFromIntError)

Error indicating an array size overflow if the target index exceeds limits.

ProgramGenAbiMeta(String)

Error thrown if the compiled program fails to export or generate valid ABI metadata.

Trait Implementations

impl Debug for ProgramError

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

Formats the value using the given formatter.

impl Display for ProgramError

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

Formats the value using the given formatter.

impl Error for ProgramError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ProgramError

fn from(source: Error) -> ProgramError

Converts to this type from the input type.

impl From<ExecutionError> for ProgramError

fn from(source: ExecutionError) -> ProgramError

Converts to this type from the input type.

impl From<LimitError> for ProgramError

fn from(source: LimitError) -> ProgramError

Converts to this type from the input type.

impl From<ProgramError> for SignerError

fn from(source: ProgramError) -> SignerError

Converts to this type from the input type.

impl From<TryFromIntError> for ProgramError

fn from(source: TryFromIntError) -> ProgramError

Converts to this type from the input type.