kaspa-txscript-errors 2.1.0

Kaspa txscript errors
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use kaspa_hashes::Hash;
use thiserror::Error;

#[derive(Error, PartialEq, Eq, Debug, Clone)]
pub enum TxScriptError {
    #[error("invalid opcode length: {0:02x?}")]
    MalformedPushSize(Vec<u8>),
    #[error("opcode requires {0} bytes, but script only has {1} remaining")]
    MalformedPush(usize, usize),
    #[error("transaction input {0} is out of bounds, should be non-negative below {1}")]
    InvalidInputIndex(i32, usize),
    #[error("transaction input {0} is either out of bounds or has no associated covenant outputs")]
    InvalidCovInputIndex(i32),
    #[error("combined stack size {0} > max allowed {1}")]
    StackSizeExceeded(usize, usize),
    #[error("attempt to execute invalid opcode {0}")]
    InvalidOpcode(String),
    #[error("attempt to execute reserved opcode {0}")]
    OpcodeReserved(String),
    #[error("attempt to execute disabled opcode {0}")]
    OpcodeDisabled(String),
    #[error("attempt to read from empty stack")]
    EmptyStack,
    #[error("stack contains {0} unexpected items")]
    CleanStack(usize),
    // We return error if stack entry is false
    #[error("false stack entry at end of script execution")]
    EvalFalse,
    #[error("script returned early")]
    EarlyReturn,
    #[error("script ran, but verification failed")]
    VerifyError,
    #[error("encountered invalid state while running script: {0}")]
    InvalidState(String),
    #[error("pubkey invalid: {0}")]
    InvalidPubkey(secp256k1::Error),
    #[error("signature invalid: {0}")]
    InvalidSignature(secp256k1::Error),
    #[error("invalid signature in sig cache")]
    SigcacheSignatureInvalid,
    #[error("exceeded max operation limit of {0}")]
    TooManyOperations(i32),
    #[error("Engine is not running on a transaction input")]
    NotATransactionInput,
    #[error("element size {0} exceeds max allowed size {1}")]
    ElementTooBig(usize, usize),
    #[error("push encoding is not minimal: {0}")]
    NotMinimalData(String),
    #[error("opcode not supported on current source: {0}")]
    InvalidSource(String),
    #[error("Unsatisfied lock time: {0}")]
    UnsatisfiedLockTime(String),
    #[error("Number too big: {0}")]
    NumberTooBig(String),
    #[error("not all signatures empty on failed checkmultisig")]
    NullFail,
    #[error("invalid signature count: {0}")]
    InvalidSignatureCount(String),
    #[error("invalid pubkey count: {0}")]
    InvalidPubKeyCount(String),
    #[error("invalid hash type {0:#04x}")]
    InvalidSigHashType(u8),
    #[error("unsupported public key type")]
    PubKeyFormat,
    #[error("no scripts to run")]
    NoScripts,
    #[error("signature script is not push only")]
    SignatureScriptNotPushOnly,
    #[error("end of script reached in conditional execution")]
    ErrUnbalancedConditional,
    #[error("opcode requires at least {0} but stack has only {1}")]
    InvalidStackOperation(usize, usize),
    #[error("script of size {0} exceeded maximum allowed size of {1}")]
    ScriptSize(usize, usize),
    #[error("transaction output {0} is out of bounds, should be non-negative below {1}")]
    InvalidOutputIndex(i32, usize),
    #[error(transparent)]
    Serialization(#[from] SerializationError),
    #[error("script units exceeded the amount committed in the input: used={used}, limit={limit}")]
    ExceededCommittedScriptUnits { used: u64, limit: u64 },
    #[error("ZK Integrity: {0}")]
    ZkIntegrity(String),
    #[error("substring [{0}:{1}] is out of bounds for string of length {2}")]
    OutOfBoundsSubstring(usize, usize, usize),
    #[error("{0} cannot be used as an array index")]
    InvalidIndex(i32),
    #[error("{start}..{end} is not a valid range, {end} must be greater than {start}")]
    InvalidRange { start: usize, end: usize },

    #[error("blockhash must be exactly 32 bytes long, got {0} bytes instead")]
    InvalidLengthOfBlockHash(usize),
    #[error("block {0} not selected")]
    BlockNotSelected(String),
    #[error("block {0} already pruned")]
    BlockAlreadyPruned(String),
    #[error("block {0} is too deep")]
    BlockIsTooDeep(String),
    #[error("covenants error: {0}")]
    CovenantsError(#[from] CovenantsError),
}

#[derive(Error, PartialEq, Eq, Debug, Clone, Copy)]
pub enum SerializationError {
    #[error("Number exceeds {1} bytes: {0}")]
    NumberTooLong(i64, usize),
    #[error("Ark serialization error")]
    ArkSerialization,
}

#[derive(Error, Debug, Clone, PartialEq, Eq)]
pub enum CovenantsError {
    #[error("input #{0} and outputs with covenant id {1} do not correspond to the expected genesis hashing")]
    WrongGenesisCovenantId(usize, Hash),
    #[error("output #{0} covenant authorizing input index {1} is out of bounds")]
    AuthInputOutOfBounds(usize, u16),
    #[error("covenant id {0} input {1} is out of bounds")]
    InvalidCovInIndex(Hash, usize),
    #[error("covenant id {0} output {1} is out of bounds")]
    InvalidCovOutIndex(Hash, usize),
    #[error("{0} is not a valid covenant output index for input {1} with {2} authorized outputs")]
    InvalidAuthCovOutIndex(usize, usize, usize),
}