/bitcoin/src/script/script_error.cpp

Source
// Copyright (c) 2009-2010 Satoshi Nakamoto
// Copyright (c) 2009-present The Bitcoin Core developers
// Distributed under the MIT software license, see the accompanying
// file COPYING or http://www.opensource.org/licenses/mit-license.php.

#include <script/script_error.h>

#include <string>

std::string ScriptErrorString(const ScriptError serror)
{
    switch (serror)
    {
        case SCRIPT_ERR_OK:
            return "No error";
        case SCRIPT_ERR_EVAL_FALSE:
            return "Script evaluated without error but finished with a false/empty top stack element";
        case SCRIPT_ERR_VERIFY:
            return "Script failed an OP_VERIFY operation";
        case SCRIPT_ERR_EQUALVERIFY:
            return "Script failed an OP_EQUALVERIFY operation";
        case SCRIPT_ERR_CHECKMULTISIGVERIFY:
            return "Script failed an OP_CHECKMULTISIGVERIFY operation";
        case SCRIPT_ERR_CHECKSIGVERIFY:
            return "Script failed an OP_CHECKSIGVERIFY operation";
        case SCRIPT_ERR_NUMEQUALVERIFY:
            return "Script failed an OP_NUMEQUALVERIFY operation";
        case SCRIPT_ERR_SCRIPT_SIZE:
            return "Script is too big";
        case SCRIPT_ERR_PUSH_SIZE:
            return "Push value size limit exceeded";
        case SCRIPT_ERR_OP_COUNT:
            return "Operation limit exceeded";
        case SCRIPT_ERR_STACK_SIZE:
            return "Stack size limit exceeded";
        case SCRIPT_ERR_SIG_COUNT:
            return "Signature count negative or greater than pubkey count";
        case SCRIPT_ERR_PUBKEY_COUNT:
            return "Pubkey count negative or limit exceeded";
        case SCRIPT_ERR_BAD_OPCODE:
            return "Opcode missing or not understood";
        case SCRIPT_ERR_DISABLED_OPCODE:
            return "Attempted to use a disabled opcode";
        case SCRIPT_ERR_INVALID_STACK_OPERATION:
            return "Operation not valid with the current stack size";
        case SCRIPT_ERR_INVALID_ALTSTACK_OPERATION:
            return "Operation not valid with the current altstack size";
        case SCRIPT_ERR_OP_RETURN:
            return "OP_RETURN was encountered";
        case SCRIPT_ERR_UNBALANCED_CONDITIONAL:
            return "Invalid OP_IF construction";
        case SCRIPT_ERR_NEGATIVE_LOCKTIME:
            return "Negative locktime";
        case SCRIPT_ERR_UNSATISFIED_LOCKTIME:
            return "Locktime requirement not satisfied";
        case SCRIPT_ERR_SIG_HASHTYPE:
            return "Signature hash type missing or not understood";
        case SCRIPT_ERR_SIG_DER:
            return "Non-canonical DER signature";
        case SCRIPT_ERR_MINIMALDATA:
            return "Data push larger than necessary";
        case SCRIPT_ERR_SIG_PUSHONLY:
            return "Only push operators allowed in signatures";
        case SCRIPT_ERR_SIG_HIGH_S:
            return "Non-canonical signature: S value is unnecessarily high";
        case SCRIPT_ERR_SIG_NULLDUMMY:
            return "Dummy CHECKMULTISIG argument must be zero";
        case SCRIPT_ERR_MINIMALIF:
            return "OP_IF/NOTIF argument must be minimal";
        case SCRIPT_ERR_SIG_NULLFAIL:
            return "Signature must be zero for failed CHECK(MULTI)SIG operation";
        case SCRIPT_ERR_DISCOURAGE_UPGRADABLE_NOPS:
            return "NOPx reserved for soft-fork upgrades";
        case SCRIPT_ERR_DISCOURAGE_UPGRADABLE_WITNESS_PROGRAM:
            return "Witness version reserved for soft-fork upgrades";
        case SCRIPT_ERR_DISCOURAGE_UPGRADABLE_TAPROOT_VERSION:
            return "Taproot version reserved for soft-fork upgrades";
        case SCRIPT_ERR_DISCOURAGE_OP_SUCCESS:
            return "OP_SUCCESSx reserved for soft-fork upgrades";
        case SCRIPT_ERR_DISCOURAGE_UPGRADABLE_PUBKEYTYPE:
            return "Public key version reserved for soft-fork upgrades";
        case SCRIPT_ERR_PUBKEYTYPE:
            return "Public key is neither compressed or uncompressed";
        case SCRIPT_ERR_CLEANSTACK:
            return "Stack size must be exactly one after execution";
        case SCRIPT_ERR_WITNESS_PROGRAM_WRONG_LENGTH:
            return "Witness program has incorrect length";
        case SCRIPT_ERR_WITNESS_PROGRAM_WITNESS_EMPTY:
            return "Witness program was passed an empty witness";
        case SCRIPT_ERR_WITNESS_PROGRAM_MISMATCH:
            return "Witness program hash mismatch";
        case SCRIPT_ERR_WITNESS_MALLEATED:
            return "Witness requires empty scriptSig";
        case SCRIPT_ERR_WITNESS_MALLEATED_P2SH:
            return "Witness requires only-redeemscript scriptSig";
        case SCRIPT_ERR_WITNESS_UNEXPECTED:
            return "Witness provided for non-witness script";
        case SCRIPT_ERR_WITNESS_PUBKEYTYPE:
            return "Using non-compressed keys in segwit";
        case SCRIPT_ERR_SCHNORR_SIG_SIZE:
            return "Invalid Schnorr signature size";
        case SCRIPT_ERR_SCHNORR_SIG_HASHTYPE:
            return "Invalid Schnorr signature hash type";
        case SCRIPT_ERR_SCHNORR_SIG:
            return "Invalid Schnorr signature";
        case SCRIPT_ERR_TAPROOT_WRONG_CONTROL_SIZE:
            return "Invalid Taproot control block size";
        case SCRIPT_ERR_TAPSCRIPT_VALIDATION_WEIGHT:
            return "Too much signature validation relative to witness weight";
        case SCRIPT_ERR_TAPSCRIPT_CHECKMULTISIG:
            return "OP_CHECKMULTISIG(VERIFY) is not available in tapscript";
        case SCRIPT_ERR_TAPSCRIPT_MINIMALIF:
            return "OP_IF/NOTIF argument must be minimal in tapscript";
        case SCRIPT_ERR_TAPSCRIPT_EMPTY_PUBKEY:
            return "Empty public key in tapscript";
        case SCRIPT_ERR_OP_CODESEPARATOR:
            return "Using OP_CODESEPARATOR in non-witness script";
        case SCRIPT_ERR_SIG_FINDANDDELETE:
            return "Signature is found in scriptCode";
        case SCRIPT_ERR_SCRIPTNUM:
            return "Script number overflowed or is non-minimally encoded";
        case SCRIPT_ERR_UNKNOWN_ERROR:
        case SCRIPT_ERR_ERROR_COUNT:
            break;
    } // no default case, so the compiler can warn about missing cases
    return "unknown error";
}

Line	Count	Source
1		// Copyright (c) 2009-2010 Satoshi Nakamoto
2		// Copyright (c) 2009-present The Bitcoin Core developers
3		// Distributed under the MIT software license, see the accompanying
4		// file COPYING or http://www.opensource.org/licenses/mit-license.php.
5
6		#include <script/script_error.h>
7
8		#include <string>
9
10		std::string ScriptErrorString(const ScriptError serror)
11	25.4k	{
12	25.4k	switch (serror) Branch (12:13): [True: 0, False: 25.4k]
13	25.4k	{
14	0	case SCRIPT_ERR_OK: Branch (14:9): [True: 0, False: 25.4k]
15	0	return "No error";
16	306	case SCRIPT_ERR_EVAL_FALSE: Branch (16:9): [True: 306, False: 25.1k]
17	306	return "Script evaluated without error but finished with a false/empty top stack element";
18	71	case SCRIPT_ERR_VERIFY: Branch (18:9): [True: 71, False: 25.4k]
19	71	return "Script failed an OP_VERIFY operation";
20	862	case SCRIPT_ERR_EQUALVERIFY: Branch (20:9): [True: 862, False: 24.6k]
21	862	return "Script failed an OP_EQUALVERIFY operation";
22	0	case SCRIPT_ERR_CHECKMULTISIGVERIFY: Branch (22:9): [True: 0, False: 25.4k]
23	0	return "Script failed an OP_CHECKMULTISIGVERIFY operation";
24	68	case SCRIPT_ERR_CHECKSIGVERIFY: Branch (24:9): [True: 68, False: 25.4k]
25	68	return "Script failed an OP_CHECKSIGVERIFY operation";
26	52	case SCRIPT_ERR_NUMEQUALVERIFY: Branch (26:9): [True: 52, False: 25.4k]
27	52	return "Script failed an OP_NUMEQUALVERIFY operation";
28	339	case SCRIPT_ERR_SCRIPT_SIZE: Branch (28:9): [True: 339, False: 25.1k]
29	339	return "Script is too big";
30	44	case SCRIPT_ERR_PUSH_SIZE: Branch (30:9): [True: 44, False: 25.4k]
31	44	return "Push value size limit exceeded";
32	0	case SCRIPT_ERR_OP_COUNT: Branch (32:9): [True: 0, False: 25.4k]
33	0	return "Operation limit exceeded";
34	0	case SCRIPT_ERR_STACK_SIZE: Branch (34:9): [True: 0, False: 25.4k]
35	0	return "Stack size limit exceeded";
36	45	case SCRIPT_ERR_SIG_COUNT: Branch (36:9): [True: 45, False: 25.4k]
37	45	return "Signature count negative or greater than pubkey count";
38	98	case SCRIPT_ERR_PUBKEY_COUNT: Branch (38:9): [True: 98, False: 25.3k]
39	98	return "Pubkey count negative or limit exceeded";
40	4.26k	case SCRIPT_ERR_BAD_OPCODE: Branch (40:9): [True: 4.26k, False: 21.2k]
41	4.26k	return "Opcode missing or not understood";
42	1.39k	case SCRIPT_ERR_DISABLED_OPCODE: Branch (42:9): [True: 1.39k, False: 24.0k]
43	1.39k	return "Attempted to use a disabled opcode";
44	3.65k	case SCRIPT_ERR_INVALID_STACK_OPERATION: Branch (44:9): [True: 3.65k, False: 21.8k]
45	3.65k	return "Operation not valid with the current stack size";
46	95	case SCRIPT_ERR_INVALID_ALTSTACK_OPERATION: Branch (46:9): [True: 95, False: 25.3k]
47	95	return "Operation not valid with the current altstack size";
48	137	case SCRIPT_ERR_OP_RETURN: Branch (48:9): [True: 137, False: 25.3k]
49	137	return "OP_RETURN was encountered";
50	368	case SCRIPT_ERR_UNBALANCED_CONDITIONAL: Branch (50:9): [True: 368, False: 25.1k]
51	368	return "Invalid OP_IF construction";
52	109	case SCRIPT_ERR_NEGATIVE_LOCKTIME: Branch (52:9): [True: 109, False: 25.3k]
53	109	return "Negative locktime";
54	176	case SCRIPT_ERR_UNSATISFIED_LOCKTIME: Branch (54:9): [True: 176, False: 25.2k]
55	176	return "Locktime requirement not satisfied";
56	0	case SCRIPT_ERR_SIG_HASHTYPE: Branch (56:9): [True: 0, False: 25.4k]
57	0	return "Signature hash type missing or not understood";
58	402	case SCRIPT_ERR_SIG_DER: Branch (58:9): [True: 402, False: 25.0k]
59	402	return "Non-canonical DER signature";
60	286	case SCRIPT_ERR_MINIMALDATA: Branch (60:9): [True: 286, False: 25.1k]
61	286	return "Data push larger than necessary";
62	0	case SCRIPT_ERR_SIG_PUSHONLY: Branch (62:9): [True: 0, False: 25.4k]
63	0	return "Only push operators allowed in signatures";
64	0	case SCRIPT_ERR_SIG_HIGH_S: Branch (64:9): [True: 0, False: 25.4k]
65	0	return "Non-canonical signature: S value is unnecessarily high";
66	53	case SCRIPT_ERR_SIG_NULLDUMMY: Branch (66:9): [True: 53, False: 25.4k]
67	53	return "Dummy CHECKMULTISIG argument must be zero";
68	187	case SCRIPT_ERR_MINIMALIF: Branch (68:9): [True: 187, False: 25.2k]
69	187	return "OP_IF/NOTIF argument must be minimal";
70	1.38k	case SCRIPT_ERR_SIG_NULLFAIL: Branch (70:9): [True: 1.38k, False: 24.0k]
71	1.38k	return "Signature must be zero for failed CHECK(MULTI)SIG operation";
72	373	case SCRIPT_ERR_DISCOURAGE_UPGRADABLE_NOPS: Branch (72:9): [True: 373, False: 25.0k]
73	373	return "NOPx reserved for soft-fork upgrades";
74	0	case SCRIPT_ERR_DISCOURAGE_UPGRADABLE_WITNESS_PROGRAM: Branch (74:9): [True: 0, False: 25.4k]
75	0	return "Witness version reserved for soft-fork upgrades";
76	620	case SCRIPT_ERR_DISCOURAGE_UPGRADABLE_TAPROOT_VERSION: Branch (76:9): [True: 620, False: 24.8k]
77	620	return "Taproot version reserved for soft-fork upgrades";
78	169	case SCRIPT_ERR_DISCOURAGE_OP_SUCCESS: Branch (78:9): [True: 169, False: 25.3k]
79	169	return "OP_SUCCESSx reserved for soft-fork upgrades";
80	0	case SCRIPT_ERR_DISCOURAGE_UPGRADABLE_PUBKEYTYPE: Branch (80:9): [True: 0, False: 25.4k]
81	0	return "Public key version reserved for soft-fork upgrades";
82	151	case SCRIPT_ERR_PUBKEYTYPE: Branch (82:9): [True: 151, False: 25.3k]
83	151	return "Public key is neither compressed or uncompressed";
84	2.62k	case SCRIPT_ERR_CLEANSTACK: Branch (84:9): [True: 2.62k, False: 22.8k]
85	2.62k	return "Stack size must be exactly one after execution";
86	0	case SCRIPT_ERR_WITNESS_PROGRAM_WRONG_LENGTH: Branch (86:9): [True: 0, False: 25.4k]
87	0	return "Witness program has incorrect length";
88	5.89k	case SCRIPT_ERR_WITNESS_PROGRAM_WITNESS_EMPTY: Branch (88:9): [True: 5.89k, False: 19.5k]
89	5.89k	return "Witness program was passed an empty witness";
90	86	case SCRIPT_ERR_WITNESS_PROGRAM_MISMATCH: Branch (90:9): [True: 86, False: 25.3k]
91	86	return "Witness program hash mismatch";
92	0	case SCRIPT_ERR_WITNESS_MALLEATED: Branch (92:9): [True: 0, False: 25.4k]
93	0	return "Witness requires empty scriptSig";
94	94	case SCRIPT_ERR_WITNESS_MALLEATED_P2SH: Branch (94:9): [True: 94, False: 25.3k]
95	94	return "Witness requires only-redeemscript scriptSig";
96	0	case SCRIPT_ERR_WITNESS_UNEXPECTED: Branch (96:9): [True: 0, False: 25.4k]
97	0	return "Witness provided for non-witness script";
98	0	case SCRIPT_ERR_WITNESS_PUBKEYTYPE: Branch (98:9): [True: 0, False: 25.4k]
99	0	return "Using non-compressed keys in segwit";
100	7	case SCRIPT_ERR_SCHNORR_SIG_SIZE: Branch (100:9): [True: 7, False: 25.4k]
101	7	return "Invalid Schnorr signature size";
102	0	case SCRIPT_ERR_SCHNORR_SIG_HASHTYPE: Branch (102:9): [True: 0, False: 25.4k]
103	0	return "Invalid Schnorr signature hash type";
104	186	case SCRIPT_ERR_SCHNORR_SIG: Branch (104:9): [True: 186, False: 25.2k]
105	186	return "Invalid Schnorr signature";
106	31	case SCRIPT_ERR_TAPROOT_WRONG_CONTROL_SIZE: Branch (106:9): [True: 31, False: 25.4k]
107	31	return "Invalid Taproot control block size";
108	0	case SCRIPT_ERR_TAPSCRIPT_VALIDATION_WEIGHT: Branch (108:9): [True: 0, False: 25.4k]
109	0	return "Too much signature validation relative to witness weight";
110	0	case SCRIPT_ERR_TAPSCRIPT_CHECKMULTISIG: Branch (110:9): [True: 0, False: 25.4k]
111	0	return "OP_CHECKMULTISIG(VERIFY) is not available in tapscript";
112	0	case SCRIPT_ERR_TAPSCRIPT_MINIMALIF: Branch (112:9): [True: 0, False: 25.4k]
113	0	return "OP_IF/NOTIF argument must be minimal in tapscript";
114	0	case SCRIPT_ERR_TAPSCRIPT_EMPTY_PUBKEY: Branch (114:9): [True: 0, False: 25.4k]
115	0	return "Empty public key in tapscript";
116	24	case SCRIPT_ERR_OP_CODESEPARATOR: Branch (116:9): [True: 24, False: 25.4k]
117	24	return "Using OP_CODESEPARATOR in non-witness script";
118	34	case SCRIPT_ERR_SIG_FINDANDDELETE: Branch (118:9): [True: 34, False: 25.4k]
119	34	return "Signature is found in scriptCode";
120	776	case SCRIPT_ERR_SCRIPTNUM: Branch (120:9): [True: 776, False: 24.6k]
121	776	return "Script number overflowed or is non-minimally encoded";
122	0	case SCRIPT_ERR_UNKNOWN_ERROR: Branch (122:9): [True: 0, False: 25.4k]
123	0	case SCRIPT_ERR_ERROR_COUNT: Branch (123:9): [True: 0, False: 25.4k]
124	0	break;
125	25.4k	} // no default case, so the compiler can warn about missing cases
126	0	return "unknown error";
127	25.4k	}

Coverage Report

Created: 2026-07-14 18:13