Public commit record
68/100 · Adequate
What the developer wrote
Authored by Mitchell Bagot
Move normal opcodes to primitives
With the Opcode type moved, the individual opcode constants can now
also be moved to primitives from bitcoin.
Move all opcodes in Ordinary + OP_RETURN + OP_NOP to primitives and
re-export in bitcoin.
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
What changed, and why it matters
This commit is a routine code reorganization: it moves many Bitcoin script opcode constants from the main `bitcoin` crate into a lower-level `primitives` crate, then re-exports them so existing users still see the same names and values. There is no change to what the opcodes mean or how they behave, and no security fix or vulnerability is described.
Recommended action
No security action required. Treat as normal maintenance/refactoring. Reviewers may optionally verify that all moved opcode byte values and doc comments match the originals and that downstream wildcard imports still resolve.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The patch refactors opcode definitions. A new all_opcodes! macro is added in primitives/src/opcodes.rs defining the ‘ordinary’ opcodes (OP_1 through OP_16, OP_NOP, OP_IF, OP_RETURN, arithmetic/logic/crypto opcodes, etc.). bitcoin/src/blockdata/opcodes.rs is updated to re-export those constants via pub use primitives::opcodes::all::* and only keeps ‘defined’ opcodes that are not moved (push-data, reserved/disabled, and OP_RETURN synonyms). The macro in bitcoin is extended with a reexported { ... } list so opcode_to_str can still stringify the moved opcodes. Values and semantics are preserved; this is purely a crate-boundary move.
Changed components
bitcoin/src/blockdata/opcodes.rsprimitives/src/opcodes.rsInspect captured patch +309 / −261
diff --git a/bitcoin/src/blockdata/opcodes.rs b/bitcoin/src/blockdata/opcodes.rs
index f7a4527b..0d314616 100644
--- a/bitcoin/src/blockdata/opcodes.rs
+++ b/bitcoin/src/blockdata/opcodes.rs
@@ -14,7 +14,12 @@ pub use primitives::opcodes::Opcode;
use self::all::*;
macro_rules! all_opcodes {
- ($($op:ident => $val:expr, $doc:expr);*) => {
+ (
+ // Opcodes whose constants are defined directly in bitcoin.
+ defined { $($op:ident => $val:expr, $doc:expr);* $(;)? }
+ // Opcodes re-exported from primitives. Used for opcode_to_str.
+ reexported { $($rop:ident),* $(,)? }
+ ) => {
/// Enables wildcard imports to bring into scope all opcodes and nothing else.
///
/// The `all` module is provided so one can use a wildcard import `use bitcoin::opcodes::all::*` to
@@ -24,6 +29,9 @@ macro_rules! all_opcodes {
/// constants are guaranteed to begin with OP_.
pub mod all {
use super::Opcode;
+
+ pub use primitives::opcodes::all::*;
+
$(
#[doc = $doc]
pub const $op: Opcode = Opcode::from_u8($val);
@@ -34,7 +42,10 @@ macro_rules! all_opcodes {
match opcode {
$(
$op => stringify!($op),
- )+
+ )*
+ $(
+ $rop => stringify!($rop),
+ )*
}
}
@@ -105,265 +116,201 @@ macro_rules! all_opcodes {
}
all_opcodes! {
- OP_PUSHBYTES_0 => 0x00, "Push an empty array onto the stack.";
- OP_PUSHBYTES_1 => 0x01, "Push the next byte as an array onto the stack.";
- OP_PUSHBYTES_2 => 0x02, "Push the next 2 bytes as an array onto the stack.";
- OP_PUSHBYTES_3 => 0x03, "Push the next 3 bytes as an array onto the stack.";
- OP_PUSHBYTES_4 => 0x04, "Push the next 4 bytes as an array onto the stack.";
- OP_PUSHBYTES_5 => 0x05, "Push the next 5 bytes as an array onto the stack.";
- OP_PUSHBYTES_6 => 0x06, "Push the next 6 bytes as an array onto the stack.";
- OP_PUSHBYTES_7 => 0x07, "Push the next 7 bytes as an array onto the stack.";
- OP_PUSHBYTES_8 => 0x08, "Push the next 8 bytes as an array onto the stack.";
- OP_PUSHBYTES_9 => 0x09, "Push the next 9 bytes as an array onto the stack.";
- OP_PUSHBYTES_10 => 0x0a, "Push the next 10 bytes as an array onto the stack.";
- OP_PUSHBYTES_11 => 0x0b, "Push the next 11 bytes as an array onto the stack.";
- OP_PUSHBYTES_12 => 0x0c, "Push the next 12 bytes as an array onto the stack.";
- OP_PUSHBYTES_13 => 0x0d, "Push the next 13 bytes as an array onto the stack.";
- OP_PUSHBYTES_14 => 0x0e, "Push the next 14 bytes as an array onto the stack.";
- OP_PUSHBYTES_15 => 0x0f, "Push the next 15 bytes as an array onto the stack.";
- OP_PUSHBYTES_16 => 0x10, "Push the next 16 bytes as an array onto the stack.";
- OP_PUSHBYTES_17 => 0x11, "Push the next 17 bytes as an array onto the stack.";
- OP_PUSHBYTES_18 => 0x12, "Push the next 18 bytes as an array onto the stack.";
- OP_PUSHBYTES_19 => 0x13, "Push the next 19 bytes as an array onto the stack.";
- OP_PUSHBYTES_20 => 0x14, "Push the next 20 bytes as an array onto the stack.";
- OP_PUSHBYTES_21 => 0x15, "Push the next 21 bytes as an array onto the stack.";
- OP_PUSHBYTES_22 => 0x16, "Push the next 22 bytes as an array onto the stack.";
- OP_PUSHBYTES_23 => 0x17, "Push the next 23 bytes as an array onto the stack.";
- OP_PUSHBYTES_24 => 0x18, "Push the next 24 bytes as an array onto the stack.";
- OP_PUSHBYTES_25 => 0x19, "Push the next 25 bytes as an array onto the stack.";
- OP_PUSHBYTES_26 => 0x1a, "Push the next 26 bytes as an array onto the stack.";
- OP_PUSHBYTES_27 => 0x1b, "Push the next 27 bytes as an array onto the stack.";
- OP_PUSHBYTES_28 => 0x1c, "Push the next 28 bytes as an array onto the stack.";
- OP_PUSHBYTES_29 => 0x1d, "Push the next 29 bytes as an array onto the stack.";
- OP_PUSHBYTES_30 => 0x1e, "Push the next 30 bytes as an array onto the stack.";
- OP_PUSHBYTES_31 => 0x1f, "Push the next 31 bytes as an array onto the stack.";
- OP_PUSHBYTES_32 => 0x20, "Push the next 32 bytes as an array onto the stack.";
- OP_PUSHBYTES_33 => 0x21, "Push the next 33 bytes as an array onto the stack.";
- OP_PUSHBYTES_34 => 0x22, "Push the next 34 bytes as an array onto the stack.";
- OP_PUSHBYTES_35 => 0x23, "Push the next 35 bytes as an array onto the stack.";
- OP_PUSHBYTES_36 => 0x24, "Push the next 36 bytes as an array onto the stack.";
- OP_PUSHBYTES_37 => 0x25, "Push the next 37 bytes as an array onto the stack.";
- OP_PUSHBYTES_38 => 0x26, "Push the next 38 bytes as an array onto the stack.";
- OP_PUSHBYTES_39 => 0x27, "Push the next 39 bytes as an array onto the stack.";
- OP_PUSHBYTES_40 => 0x28, "Push the next 40 bytes as an array onto the stack.";
- OP_PUSHBYTES_41 => 0x29, "Push the next 41 bytes as an array onto the stack.";
- OP_PUSHBYTES_42 => 0x2a, "Push the next 42 bytes as an array onto the stack.";
- OP_PUSHBYTES_43 => 0x2b, "Push the next 43 bytes as an array onto the stack.";
- OP_PUSHBYTES_44 => 0x2c, "Push the next 44 bytes as an array onto the stack.";
- OP_PUSHBYTES_45 => 0x2d, "Push the next 45 bytes as an array onto the stack.";
- OP_PUSHBYTES_46 => 0x2e, "Push the next 46 bytes as an array onto the stack.";
- OP_PUSHBYTES_47 => 0x2f, "Push the next 47 bytes as an array onto the stack.";
- OP_PUSHBYTES_48 => 0x30, "Push the next 48 bytes as an array onto the stack.";
- OP_PUSHBYTES_49 => 0x31, "Push the next 49 bytes as an array onto the stack.";
- OP_PUSHBYTES_50 => 0x32, "Push the next 50 bytes as an array onto the stack.";
- OP_PUSHBYTES_51 => 0x33, "Push the next 51 bytes as an array onto the stack.";
- OP_PUSHBYTES_52 => 0x34, "Push the next 52 bytes as an array onto the stack.";
- OP_PUSHBYTES_53 => 0x35, "Push the next 53 bytes as an array onto the stack.";
- OP_PUSHBYTES_54 => 0x36, "Push the next 54 bytes as an array onto the stack.";
- OP_PUSHBYTES_55 => 0x37, "Push the next 55 bytes as an array onto the stack.";
- OP_PUSHBYTES_56 => 0x38, "Push the next 56 bytes as an array onto the stack.";
- OP_PUSHBYTES_57 => 0x39, "Push the next 57 bytes as an array onto the stack.";
- OP_PUSHBYTES_58 => 0x3a, "Push the next 58 bytes as an array onto the stack.";
- OP_PUSHBYTES_59 => 0x3b, "Push the next 59 bytes as an array onto the stack.";
- OP_PUSHBYTES_60 => 0x3c, "Push the next 60 bytes as an array onto the stack.";
- OP_PUSHBYTES_61 => 0x3d, "Push the next 61 bytes as an array onto the stack.";
- OP_PUSHBYTES_62 => 0x3e, "Push the next 62 bytes as an array onto the stack.";
- OP_PUSHBYTES_63 => 0x3f, "Push the next 63 bytes as an array onto the stack.";
- OP_PUSHBYTES_64 => 0x40, "Push the next 64 bytes as an array onto the stack.";
- OP_PUSHBYTES_65 => 0x41, "Push the next 65 bytes as an array onto the stack.";
- OP_PUSHBYTES_66 => 0x42, "Push the next 66 bytes as an array onto the stack.";
- OP_PUSHBYTES_67 => 0x43, "Push the next 67 bytes as an array onto the stack.";
- OP_PUSHBYTES_68 => 0x44, "Push the next 68 bytes as an array onto the stack.";
- OP_PUSHBYTES_69 => 0x45, "Push the next 69 bytes as an array onto the stack.";
- OP_PUSHBYTES_70 => 0x46, "Push the next 70 bytes as an array onto the stack.";
- OP_PUSHBYTES_71 => 0x47, "Push the next 71 bytes as an array onto the stack.";
- OP_PUSHBYTES_72 => 0x48, "Push the next 72 bytes as an array onto the stack.";
- OP_PUSHBYTES_73 => 0x49, "Push the next 73 bytes as an array onto the stack.";
- OP_PUSHBYTES_74 => 0x4a, "Push the next 74 bytes as an array onto the stack.";
- OP_PUSHBYTES_75 => 0x4b, "Push the next 75 bytes as an array onto the stack.";
- OP_PUSHDATA1 => 0x4c, "Read the next byte as N; push the next N bytes as an array onto the stack.";
- OP_PUSHDATA2 => 0x4d, "Read the next 2 bytes as N; push the next N bytes as an array onto the stack.";
- OP_PUSHDATA4 => 0x4e, "Read the next 4 bytes as N; push the next N bytes as an array onto the stack.";
- OP_1NEGATE => 0x4f, "Push the array `0x81` onto the stack.";
- OP_RESERVED => 0x50, "Synonym for `OP_RETURN`.";
- OP_1 => 0x51, "Push the array `0x01` onto the stack.";
- OP_2 => 0x52, "Push the array `0x02` onto the stack.";
- OP_3 => 0x53, "Push the array `0x03` onto the stack.";
- OP_4 => 0x54, "Push the array `0x04` onto the stack.";
- OP_5 => 0x55, "Push the array `0x05` onto the stack.";
- OP_6 => 0x56, "Push the array `0x06` onto the stack.";
- OP_7 => 0x57, "Push the array `0x07` onto the stack.";
- OP_8 => 0x58, "Push the array `0x08` onto the stack.";
- OP_9 => 0x59, "Push the array `0x09` onto the stack.";
- OP_10 => 0x5a, "Push the array `0x0a` onto the stack.";
- OP_11 => 0x5b, "Push the array `0x0b` onto the stack.";
- OP_12 => 0x5c, "Push the array `0x0c` onto the stack.";
- OP_13 => 0x5d, "Push the array `0x0d` onto the stack.";
- OP_14 => 0x5e, "Push the array `0x0e` onto the stack.";
- OP_15 => 0x5f, "Push the array `0x0f` onto the stack.";
- OP_16 => 0x60, "Push the array `0x10` onto the stack.";
- OP_NOP => 0x61, "Does nothing.";
- OP_VER => 0x62, "Synonym for `OP_RETURN`.";
- OP_IF => 0x63, "Pop and execute the next statements if a nonzero element was popped.";
- OP_NOTIF => 0x64, "Pop and execute the next statements if a zero element was popped.";
- OP_VERIF => 0x65, "Fail the script unconditionally, does not even need to be executed.";
- OP_VERNOTIF => 0x66, "Fail the script unconditionally, does not even need to be executed.";
- OP_ELSE => 0x67, "Execute statements if those after the previous `OP_IF` were not, and vice-versa. \
- If there is no previous `OP_IF`, this acts as a RETURN.";
- OP_ENDIF => 0x68, "Pop and execute the next statements if a zero element was popped.";
- OP_VERIFY => 0x69, "If the top value is zero or the stack is empty, fail; otherwise, pop the stack.";
- OP_RETURN => 0x6a, "Fail the script immediately. (Must be executed.).";
- OP_TOALTSTACK => 0x6b, "Pop one element from the main stack onto the alt stack.";
- OP_FROMALTSTACK => 0x6c, "Pop one element from the alt stack onto the main stack.";
- OP_2DROP => 0x6d, "Drops the top two stack items.";
- OP_2DUP => 0x6e, "Duplicates the top two stack items as `AB` -> `ABAB`.";
- OP_3DUP => 0x6f, "Duplicates the top three stack items as `ABC` -> `ABCABC`.";
- OP_2OVER => 0x70, "Duplicates the third and fourth items from the top of the stack.";
- OP_2ROT => 0x71, "Moves the two stack items four spaces back to the front, as `xxxxAB` -> `ABxxxx`.";
- OP_2SWAP => 0x72, "Swaps the top two pairs, as `ABCD` -> `CDAB`.";
- OP_IFDUP => 0x73, "Duplicate the top stack element unless it is zero.";
- OP_DEPTH => 0x74, "Push the current number of stack items onto the stack.";
- OP_DROP => 0x75, "Drops the top stack item.";
- OP_DUP => 0x76, "Duplicates the top stack item.";
- OP_NIP => 0x77, "Drops the second-to-top stack item.";
- OP_OVER => 0x78, "Copies the second-to-top stack item, as `xA` -> `AxA`.";
- OP_PICK => 0x79, "Pop the top stack element as N. Copy the Nth stack element to the top.";
- OP_ROLL => 0x7a, "Pop the top stack element as N. Move the Nth stack element to the top.";
- OP_ROT => 0x7b, "Rotate the top three stack items, as `[top next1 next2]` -> `[next2 top next1]`.";
- OP_SWAP => 0x7c, "Swap the top two stack items.";
- OP_TUCK => 0x7d, "Copy the top stack item to before the second item, as `[top next]` -> `[top next top]`.";
- OP_CAT => 0x7e, "Fail the script unconditionally, does not even need to be executed.";
- OP_SUBSTR => 0x7f, "Fail the script unconditionally, does not even need to be executed.";
- OP_LEFT => 0x80, "Fail the script unconditionally, does not even need to be executed.";
- OP_RIGHT => 0x81, "Fail the script unconditionally, does not even need to be executed.";
- OP_SIZE => 0x82, "Pushes the length of the top stack item onto the stack.";
- OP_INVERT => 0x83, "Fail the script unconditionally, does not even need to be executed.";
- OP_AND => 0x84, "Fail the script unconditionally, does not even need to be executed.";
- OP_OR => 0x85, "Fail the script unconditionally, does not even need to be executed.";
- OP_XOR => 0x86, "Fail the script unconditionally, does not even need to be executed.";
- OP_EQUAL => 0x87, "Pushes 1 if the inputs are exactly equal, 0 otherwise.";
- OP_EQUALVERIFY => 0x88, "Returns success if the inputs are exactly equal, failure otherwise.";
- OP_RESERVED1 => 0x89, "Synonym for `OP_RETURN`.";
- OP_RESERVED2 => 0x8a, "Synonym for `OP_RETURN`.";
- OP_1ADD => 0x8b, "Increment the top stack element in place.";
- OP_1SUB => 0x8c, "Decrement the top stack element in place.";
- OP_2MUL => 0x8d, "Fail the script unconditionally, does not even need to be executed.";
- OP_2DIV => 0x8e, "Fail the script unconditionally, does not even need to be executed.";
- OP_NEGATE => 0x8f, "Multiply the top stack item by -1 in place.";
- OP_ABS => 0x90, "Absolute value the top stack item in place.";
- OP_NOT => 0x91, "Map 0 to 1 and everything else to 0, in place.";
- OP_0NOTEQUAL => 0x92, "Map 0 to 0 and everything else to 1, in place.";
- OP_ADD => 0x93, "Pop two stack items and push their sum.";
- OP_SUB => 0x94, "Pop two stack items and push the second minus the top.";
- OP_MUL => 0x95, "Fail the script unconditionally, does not even need to be executed.";
- OP_DIV => 0x96, "Fail the script unconditionally, does not even need to be executed.";
- OP_MOD => 0x97, "Fail the script unconditionally, does not even need to be executed.";
- OP_LSHIFT => 0x98, "Fail the script unconditionally, does not even need to be executed.";
- OP_RSHIFT => 0x99, "Fail the script unconditionally, does not even need to be executed.";
- OP_BOOLAND => 0x9a, "Pop the top two stack items and push 1 if both are nonzero, else push 0.";
- OP_BOOLOR => 0x9b, "Pop the top two stack items and push 1 if either is nonzero, else push 0.";
- OP_NUMEQUAL => 0x9c, "Pop the top two stack items and push 1 if both are numerically equal, else push 0.";
- OP_NUMEQUALVERIFY => 0x9d, "Pop the top two stack items and return success if both are numerically equal, else return failure.";
- OP_NUMNOTEQUAL => 0x9e, "Pop the top two stack items and push 0 if both are numerically equal, else push 1.";
- OP_LESSTHAN => 0x9f, "Pop the top two items; push 1 if the second is less than the top, 0 otherwise.";
- OP_GREATERTHAN => 0xa0, "Pop the top two items; push 1 if the second is greater than the top, 0 otherwise.";
- OP_LESSTHANOREQUAL => 0xa1, "Pop the top two items; push 1 if the second is <= the top, 0 otherwise.";
- OP_GREATERTHANOREQUAL => 0xa2, "Pop the top two items; push 1 if the second is >= the top, 0 otherwise.";
- OP_MIN => 0xa3, "Pop the top two items; push the smaller.";
- OP_MAX => 0xa4, "Pop the top two items; push the larger.";
- OP_WITHIN => 0xa5, "Pop the top three items; if the top is >= the second and < the third, push 1, otherwise push 0.";
- OP_RIPEMD160 => 0xa6, "Pop the top stack item and push its RIPEMD160 hash.";
- OP_SHA1 => 0xa7, "Pop the top stack item and push its SHA1 hash.";
- OP_SHA256 => 0xa8, "Pop the top stack item and push its SHA256 hash.";
- OP_HASH160 => 0xa9, "Pop the top stack item and push its RIPEMD(SHA256) hash.";
- OP_HASH256 => 0xaa, "Pop the top stack item and push its SHA256(SHA256) hash.";
- OP_CODESEPARATOR => 0xab, "Ignore this and everything preceding when deciding what to sign when signature-checking.";
- OP_CHECKSIG => 0xac, "<https://en.bitcoin.it/wiki/OP_CHECKSIG> pushing 1/0 for success/failure.";
- OP_CHECKSIGVERIFY => 0xad, "<https://en.bitcoin.it/wiki/OP_CHECKSIG> returning success/failure.";
- OP_CHECKMULTISIG => 0xae, "Pop N, N pubkeys, M, M signatures, a dummy (due to bug in reference code), \
- and verify that all M signatures are valid. Push 1 for 'all valid', 0 otherwise.";
- OP_CHECKMULTISIGVERIFY => 0xaf, "Like the above but return success/failure.";
- OP_NOP1 => 0xb0, "Does nothing.";
- OP_CLTV => 0xb1, "<https://github.com/bitcoin/bips/blob/master/bip-0065.mediawiki>";
- OP_CSV => 0xb2, "<https://github.com/bitcoin/bips/blob/master/bip-0112.mediawiki>";
- OP_NOP4 => 0xb3, "Does nothing.";
- OP_NOP5 => 0xb4, "Does nothing.";
- OP_NOP6 => 0xb5, "Does nothing.";
- OP_NOP7 => 0xb6, "Does nothing.";
- OP_NOP8 => 0xb7, "Does nothing.";
- OP_NOP9 => 0xb8, "Does nothing.";
- OP_NOP10 => 0xb9, "Does nothing.";
- // Every other opcode acts as OP_RETURN
- OP_CHECKSIGADD => 0xba, "`OP_CHECKSIGADD` post tapscript.";
- OP_RETURN_187 => 0xbb, "Synonym for `OP_RETURN`.";
- OP_RETURN_188 => 0xbc, "Synonym for `OP_RETURN`.";
- OP_RETURN_189 => 0xbd, "Synonym for `OP_RETURN`.";
- OP_RETURN_190 => 0xbe, "Synonym for `OP_RETURN`.";
- OP_RETURN_191 => 0xbf, "Synonym for `OP_RETURN`.";
- OP_RETURN_192 => 0xc0, "Synonym for `OP_RETURN`.";
- OP_RETURN_193 => 0xc1, "Synonym for `OP_RETURN`.";
- OP_RETURN_194 => 0xc2, "Synonym for `OP_RETURN`.";
- OP_RETURN_195 => 0xc3, "Synonym for `OP_RETURN`.";
- OP_RETURN_196 => 0xc4, "Synonym for `OP_RETURN`.";
- OP_RETURN_197 => 0xc5, "Synonym for `OP_RETURN`.";
- OP_RETURN_198 => 0xc6, "Synonym for `OP_RETURN`.";
- OP_RETURN_199 => 0xc7, "Synonym for `OP_RETURN`.";
- OP_RETURN_200 => 0xc8, "Synonym for `OP_RETURN`.";
- OP_RETURN_201 => 0xc9, "Synonym for `OP_RETURN`.";
- OP_RETURN_202 => 0xca, "Synonym for `OP_RETURN`.";
- OP_RETURN_203 => 0xcb, "Synonym for `OP_RETURN`.";
- OP_RETURN_204 => 0xcc, "Synonym for `OP_RETURN`.";
- OP_RETURN_205 => 0xcd, "Synonym for `OP_RETURN`.";
- OP_RETURN_206 => 0xce, "Synonym for `OP_RETURN`.";
- OP_RETURN_207 => 0xcf, "Synonym for `OP_RETURN`.";
- OP_RETURN_208 => 0xd0, "Synonym for `OP_RETURN`.";
- OP_RETURN_209 => 0xd1, "Synonym for `OP_RETURN`.";
- OP_RETURN_210 => 0xd2, "Synonym for `OP_RETURN`.";
- OP_RETURN_211 => 0xd3, "Synonym for `OP_RETURN`.";
- OP_RETURN_212 => 0xd4, "Synonym for `OP_RETURN`.";
- OP_RETURN_213 => 0xd5, "Synonym for `OP_RETURN`.";
- OP_RETURN_214 => 0xd6, "Synonym for `OP_RETURN`.";
- OP_RETURN_215 => 0xd7, "Synonym for `OP_RETURN`.";
- OP_RETURN_216 => 0xd8, "Synonym for `OP_RETURN`.";
- OP_RETURN_217 => 0xd9, "Synonym for `OP_RETURN`.";
- OP_RETURN_218 => 0xda, "Synonym for `OP_RETURN`.";
- OP_RETURN_219 => 0xdb, "Synonym for `OP_RETURN`.";
- OP_RETURN_220 => 0xdc, "Synonym for `OP_RETURN`.";
- OP_RETURN_221 => 0xdd, "Synonym for `OP_RETURN`.";
- OP_RETURN_222 => 0xde, "Synonym for `OP_RETURN`.";
- OP_RETURN_223 => 0xdf, "Synonym for `OP_RETURN`.";
- OP_RETURN_224 => 0xe0, "Synonym for `OP_RETURN`.";
- OP_RETURN_225 => 0xe1, "Synonym for `OP_RETURN`.";
- OP_RETURN_226 => 0xe2, "Synonym for `OP_RETURN`.";
- OP_RETURN_227 => 0xe3, "Synonym for `OP_RETURN`.";
- OP_RETURN_228 => 0xe4, "Synonym for `OP_RETURN`.";
- OP_RETURN_229 => 0xe5, "Synonym for `OP_RETURN`.";
- OP_RETURN_230 => 0xe6, "Synonym for `OP_RETURN`.";
- OP_RETURN_231 => 0xe7, "Synonym for `OP_RETURN`.";
- OP_RETURN_232 => 0xe8, "Synonym for `OP_RETURN`.";
- OP_RETURN_233 => 0xe9, "Synonym for `OP_RETURN`.";
- OP_RETURN_234 => 0xea, "Synonym for `OP_RETURN`.";
- OP_RETURN_235 => 0xeb, "Synonym for `OP_RETURN`.";
- OP_RETURN_236 => 0xec, "Synonym for `OP_RETURN`.";
- OP_RETURN_237 => 0xed, "Synonym for `OP_RETURN`.";
- OP_RETURN_238 => 0xee, "Synonym for `OP_RETURN`.";
- OP_RETURN_239 => 0xef, "Synonym for `OP_RETURN`.";
- OP_RETURN_240 => 0xf0, "Synonym for `OP_RETURN`.";
- OP_RETURN_241 => 0xf1, "Synonym for `OP_RETURN`.";
- OP_RETURN_242 => 0xf2, "Synonym for `OP_RETURN`.";
- OP_RETURN_243 => 0xf3, "Synonym for `OP_RETURN`.";
- OP_RETURN_244 => 0xf4, "Synonym for `OP_RETURN`.";
- OP_RETURN_245 => 0xf5, "Synonym for `OP_RETURN`.";
- OP_RETURN_246 => 0xf6, "Synonym for `OP_RETURN`.";
- OP_RETURN_247 => 0xf7, "Synonym for `OP_RETURN`.";
- OP_RETURN_248 => 0xf8, "Synonym for `OP_RETURN`.";
- OP_RETURN_249 => 0xf9, "Synonym for `OP_RETURN`.";
- OP_RETURN_250 => 0xfa, "Synonym for `OP_RETURN`.";
- OP_RETURN_251 => 0xfb, "Synonym for `OP_RETURN`.";
- OP_RETURN_252 => 0xfc, "Synonym for `OP_RETURN`.";
- OP_RETURN_253 => 0xfd, "Synonym for `OP_RETURN`.";
- OP_RETURN_254 => 0xfe, "Synonym for `OP_RETURN`.";
- OP_INVALIDOPCODE => 0xff, "Synonym for `OP_RETURN`."
+ defined {
+ OP_PUSHBYTES_0 => 0x00, "Push an empty array onto the stack.";
+ OP_PUSHBYTES_1 => 0x01, "Push the next byte as an array onto the stack.";
+ OP_PUSHBYTES_2 => 0x02, "Push the next 2 bytes as an array onto the stack.";
+ OP_PUSHBYTES_3 => 0x03, "Push the next 3 bytes as an array onto the stack.";
+ OP_PUSHBYTES_4 => 0x04, "Push the next 4 bytes as an array onto the stack.";
+ OP_PUSHBYTES_5 => 0x05, "Push the next 5 bytes as an array onto the stack.";
+ OP_PUSHBYTES_6 => 0x06, "Push the next 6 bytes as an array onto the stack.";
+ OP_PUSHBYTES_7 => 0x07, "Push the next 7 bytes as an array onto the stack.";
+ OP_PUSHBYTES_8 => 0x08, "Push the next 8 bytes as an array onto the stack.";
+ OP_PUSHBYTES_9 => 0x09, "Push the next 9 bytes as an array onto the stack.";
+ OP_PUSHBYTES_10 => 0x0a, "Push the next 10 bytes as an array onto the stack.";
+ OP_PUSHBYTES_11 => 0x0b, "Push the next 11 bytes as an array onto the stack.";
+ OP_PUSHBYTES_12 => 0x0c, "Push the next 12 bytes as an array onto the stack.";
+ OP_PUSHBYTES_13 => 0x0d, "Push the next 13 bytes as an array onto the stack.";
+ OP_PUSHBYTES_14 => 0x0e, "Push the next 14 bytes as an array onto the stack.";
+ OP_PUSHBYTES_15 => 0x0f, "Push the next 15 bytes as an array onto the stack.";
+ OP_PUSHBYTES_16 => 0x10, "Push the next 16 bytes as an array onto the stack.";
+ OP_PUSHBYTES_17 => 0x11, "Push the next 17 bytes as an array onto the stack.";
+ OP_PUSHBYTES_18 => 0x12, "Push the next 18 bytes as an array onto the stack.";
+ OP_PUSHBYTES_19 => 0x13, "Push the next 19 bytes as an array onto the stack.";
+ OP_PUSHBYTES_20 => 0x14, "Push the next 20 bytes as an array onto the stack.";
+ OP_PUSHBYTES_21 => 0x15, "Push the next 21 bytes as an array onto the stack.";
+ OP_PUSHBYTES_22 => 0x16, "Push the next 22 bytes as an array onto the stack.";
+ OP_PUSHBYTES_23 => 0x17, "Push the next 23 bytes as an array onto the stack.";
+ OP_PUSHBYTES_24 => 0x18, "Push the next 24 bytes as an array onto the stack.";
+ OP_PUSHBYTES_25 => 0x19, "Push the next 25 bytes as an array onto the stack.";
+ OP_PUSHBYTES_26 => 0x1a, "Push the next 26 bytes as an array onto the stack.";
+ OP_PUSHBYTES_27 => 0x1b, "Push the next 27 bytes as an array onto the stack.";
+ OP_PUSHBYTES_28 => 0x1c, "Push the next 28 bytes as an array onto the stack.";
+ OP_PUSHBYTES_29 => 0x1d, "Push the next 29 bytes as an array onto the stack.";
+ OP_PUSHBYTES_30 => 0x1e, "Push the next 30 bytes as an array onto the stack.";
+ OP_PUSHBYTES_31 => 0x1f, "Push the next 31 bytes as an array onto the stack.";
+ OP_PUSHBYTES_32 => 0x20, "Push the next 32 bytes as an array onto the stack.";
+ OP_PUSHBYTES_33 => 0x21, "Push the next 33 bytes as an array onto the stack.";
+ OP_PUSHBYTES_34 => 0x22, "Push the next 34 bytes as an array onto the stack.";
+ OP_PUSHBYTES_35 => 0x23, "Push the next 35 bytes as an array onto the stack.";
+ OP_PUSHBYTES_36 => 0x24, "Push the next 36 bytes as an array onto the stack.";
+ OP_PUSHBYTES_37 => 0x25, "Push the next 37 bytes as an array onto the stack.";
+ OP_PUSHBYTES_38 => 0x26, "Push the next 38 bytes as an array onto the stack.";
+ OP_PUSHBYTES_39 => 0x27, "Push the next 39 bytes as an array onto the stack.";
+ OP_PUSHBYTES_40 => 0x28, "Push the next 40 bytes as an array onto the stack.";
+ OP_PUSHBYTES_41 => 0x29, "Push the next 41 bytes as an array onto the stack.";
+ OP_PUSHBYTES_42 => 0x2a, "Push the next 42 bytes as an array onto the stack.";
+ OP_PUSHBYTES_43 => 0x2b, "Push the next 43 bytes as an array onto the stack.";
+ OP_PUSHBYTES_44 => 0x2c, "Push the next 44 bytes as an array onto the stack.";
+ OP_PUSHBYTES_45 => 0x2d, "Push the next 45 bytes as an array onto the stack.";
+ OP_PUSHBYTES_46 => 0x2e, "Push the next 46 bytes as an array onto the stack.";
+ OP_PUSHBYTES_47 => 0x2f, "Push the next 47 bytes as an array onto the stack.";
+ OP_PUSHBYTES_48 => 0x30, "Push the next 48 bytes as an array onto the stack.";
+ OP_PUSHBYTES_49 => 0x31, "Push the next 49 bytes as an array onto the stack.";
+ OP_PUSHBYTES_50 => 0x32, "Push the next 50 bytes as an array onto the stack.";
+ OP_PUSHBYTES_51 => 0x33, "Push the next 51 bytes as an array onto the stack.";
+ OP_PUSHBYTES_52 => 0x34, "Push the next 52 bytes as an array onto the stack.";
+ OP_PUSHBYTES_53 => 0x35, "Push the next 53 bytes as an array onto the stack.";
+ OP_PUSHBYTES_54 => 0x36, "Push the next 54 bytes as an array onto the stack.";
+ OP_PUSHBYTES_55 => 0x37, "Push the next 55 bytes as an array onto the stack.";
+ OP_PUSHBYTES_56 => 0x38, "Push the next 56 bytes as an array onto the stack.";
+ OP_PUSHBYTES_57 => 0x39, "Push the next 57 bytes as an array onto the stack.";
+ OP_PUSHBYTES_58 => 0x3a, "Push the next 58 bytes as an array onto the stack.";
+ OP_PUSHBYTES_59 => 0x3b, "Push the next 59 bytes as an array onto the stack.";
+ OP_PUSHBYTES_60 => 0x3c, "Push the next 60 bytes as an array onto the stack.";
+ OP_PUSHBYTES_61 => 0x3d, "Push the next 61 bytes as an array onto the stack.";
+ OP_PUSHBYTES_62 => 0x3e, "Push the next 62 bytes as an array onto the stack.";
+ OP_PUSHBYTES_63 => 0x3f, "Push the next 63 bytes as an array onto the stack.";
+ OP_PUSHBYTES_64 => 0x40, "Push the next 64 bytes as an array onto the stack.";
+ OP_PUSHBYTES_65 => 0x41, "Push the next 65 bytes as an array onto the stack.";
+ OP_PUSHBYTES_66 => 0x42, "Push the next 66 bytes as an array onto the stack.";
+ OP_PUSHBYTES_67 => 0x43, "Push the next 67 bytes as an array onto the stack.";
+ OP_PUSHBYTES_68 => 0x44, "Push the next 68 bytes as an array onto the stack.";
+ OP_PUSHBYTES_69 => 0x45, "Push the next 69 bytes as an array onto the stack.";
+ OP_PUSHBYTES_70 => 0x46, "Push the next 70 bytes as an array onto the stack.";
+ OP_PUSHBYTES_71 => 0x47, "Push the next 71 bytes as an array onto the stack.";
+ OP_PUSHBYTES_72 => 0x48, "Push the next 72 bytes as an array onto the stack.";
+ OP_PUSHBYTES_73 => 0x49, "Push the next 73 bytes as an array onto the stack.";
+ OP_PUSHBYTES_74 => 0x4a, "Push the next 74 bytes as an array onto the stack.";
+ OP_PUSHBYTES_75 => 0x4b, "Push the next 75 bytes as an array onto the stack.";
+ OP_PUSHDATA1 => 0x4c, "Read the next byte as N; push the next N bytes as an array onto the stack.";
+ OP_PUSHDATA2 => 0x4d, "Read the next 2 bytes as N; push the next N bytes as an array onto the stack.";
+ OP_PUSHDATA4 => 0x4e, "Read the next 4 bytes as N; push the next N bytes as an array onto the stack.";
+ OP_RESERVED => 0x50, "Synonym for `OP_RETURN`.";
+ OP_VER => 0x62, "Synonym for `OP_RETURN`.";
+ OP_VERIF => 0x65, "Fail the script unconditionally, does not even need to be executed.";
+ OP_VERNOTIF => 0x66, "Fail the script unconditionally, does not even need to be executed.";
+ OP_CAT => 0x7e, "Fail the script unconditionally, does not even need to be executed.";
+ OP_SUBSTR => 0x7f, "Fail the script unconditionally, does not even need to be executed.";
+ OP_LEFT => 0x80, "Fail the script unconditionally, does not even need to be executed.";
+ OP_RIGHT => 0x81, "Fail the script unconditionally, does not even need to be executed.";
+ OP_INVERT => 0x83, "Fail the script unconditionally, does not even need to be executed.";
+ OP_AND => 0x84, "Fail the script unconditionally, does not even need to be executed.";
+ OP_OR => 0x85, "Fail the script unconditionally, does not even need to be executed.";
+ OP_XOR => 0x86, "Fail the script unconditionally, does not even need to be executed.";
+ OP_RESERVED1 => 0x89, "Synonym for `OP_RETURN`.";
+ OP_RESERVED2 => 0x8a, "Synonym for `OP_RETURN`.";
+ OP_2MUL => 0x8d, "Fail the script unconditionally, does not even need to be executed.";
+ OP_2DIV => 0x8e, "Fail the script unconditionally, does not even need to be executed.";
+ OP_MUL => 0x95, "Fail the script unconditionally, does not even need to be executed.";
+ OP_DIV => 0x96, "Fail the script unconditionally, does not even need to be executed.";
+ OP_MOD => 0x97, "Fail the script unconditionally, does not even need to be executed.";
+ OP_LSHIFT => 0x98, "Fail the script unconditionally, does not even need to be executed.";
+ OP_RSHIFT => 0x99, "Fail the script unconditionally, does not even need to be executed.";
+ OP_NOP1 => 0xb0, "Does nothing.";
+ OP_CLTV => 0xb1, "<https://github.com/bitcoin/bips/blob/master/bip-0065.mediawiki>";
+ OP_CSV => 0xb2, "<https://github.com/bitcoin/bips/blob/master/bip-0112.mediawiki>";
+ OP_NOP4 => 0xb3, "Does nothing.";
+ OP_NOP5 => 0xb4, "Does nothing.";
+ OP_NOP6 => 0xb5, "Does nothing.";
+ OP_NOP7 => 0xb6, "Does nothing.";
+ OP_NOP8 => 0xb7, "Does nothing.";
+ OP_NOP9 => 0xb8, "Does nothing.";
+ OP_NOP10 => 0xb9, "Does nothing.";
+ // Every other opcode acts as OP_RETURN
+ OP_RETURN_187 => 0xbb, "Synonym for `OP_RETURN`.";
+ OP_RETURN_188 => 0xbc, "Synonym for `OP_RETURN`.";
+ OP_RETURN_189 => 0xbd, "Synonym for `OP_RETURN`.";
+ OP_RETURN_190 => 0xbe, "Synonym for `OP_RETURN`.";
+ OP_RETURN_191 => 0xbf, "Synonym for `OP_RETURN`.";
+ OP_RETURN_192 => 0xc0, "Synonym for `OP_RETURN`.";
+ OP_RETURN_193 => 0xc1, "Synonym for `OP_RETURN`.";
+ OP_RETURN_194 => 0xc2, "Synonym for `OP_RETURN`.";
+ OP_RETURN_195 => 0xc3, "Synonym for `OP_RETURN`.";
+ OP_RETURN_196 => 0xc4, "Synonym for `OP_RETURN`.";
+ OP_RETURN_197 => 0xc5, "Synonym for `OP_RETURN`.";
+ OP_RETURN_198 => 0xc6, "Synonym for `OP_RETURN`.";
+ OP_RETURN_199 => 0xc7, "Synonym for `OP_RETURN`.";
+ OP_RETURN_200 => 0xc8, "Synonym for `OP_RETURN`.";
+ OP_RETURN_201 => 0xc9, "Synonym for `OP_RETURN`.";
+ OP_RETURN_202 => 0xca, "Synonym for `OP_RETURN`.";
+ OP_RETURN_203 => 0xcb, "Synonym for `OP_RETURN`.";
+ OP_RETURN_204 => 0xcc, "Synonym for `OP_RETURN`.";
+ OP_RETURN_205 => 0xcd, "Synonym for `OP_RETURN`.";
+ OP_RETURN_206 => 0xce, "Synonym for `OP_RETURN`.";
+ OP_RETURN_207 => 0xcf, "Synonym for `OP_RETURN`.";
+ OP_RETURN_208 => 0xd0, "Synonym for `OP_RETURN`.";
+ OP_RETURN_209 => 0xd1, "Synonym for `OP_RETURN`.";
+ OP_RETURN_210 => 0xd2, "Synonym for `OP_RETURN`.";
+ OP_RETURN_211 => 0xd3, "Synonym for `OP_RETURN`.";
+ OP_RETURN_212 => 0xd4, "Synonym for `OP_RETURN`.";
+ OP_RETURN_213 => 0xd5, "Synonym for `OP_RETURN`.";
+ OP_RETURN_214 => 0xd6, "Synonym for `OP_RETURN`.";
+ OP_RETURN_215 => 0xd7, "Synonym for `OP_RETURN`.";
+ OP_RETURN_216 => 0xd8, "Synonym for `OP_RETURN`.";
+ OP_RETURN_217 => 0xd9, "Synonym for `OP_RETURN`.";
+ OP_RETURN_218 => 0xda, "Synonym for `OP_RETURN`.";
+ OP_RETURN_219 => 0xdb, "Synonym for `OP_RETURN`.";
+ OP_RETURN_220 => 0xdc, "Synonym for `OP_RETURN`.";
+ OP_RETURN_221 => 0xdd, "Synonym for `OP_RETURN`.";
+ OP_RETURN_222 => 0xde, "Synonym for `OP_RETURN`.";
+ OP_RETURN_223 => 0xdf, "Synonym for `OP_RETURN`.";
+ OP_RETURN_224 => 0xe0, "Synonym for `OP_RETURN`.";
+ OP_RETURN_225 => 0xe1, "Synonym for `OP_RETURN`.";
+ OP_RETURN_226 => 0xe2, "Synonym for `OP_RETURN`.";
+ OP_RETURN_227 => 0xe3, "Synonym for `OP_RETURN`.";
+ OP_RETURN_228 => 0xe4, "Synonym for `OP_RETURN`.";
+ OP_RETURN_229 => 0xe5, "Synonym for `OP_RETURN`.";
+ OP_RETURN_230 => 0xe6, "Synonym for `OP_RETURN`.";
+ OP_RETURN_231 => 0xe7, "Synonym for `OP_RETURN`.";
+ OP_RETURN_232 => 0xe8, "Synonym for `OP_RETURN`.";
+ OP_RETURN_233 => 0xe9, "Synonym for `OP_RETURN`.";
+ OP_RETURN_234 => 0xea, "Synonym for `OP_RETURN`.";
+ OP_RETURN_235 => 0xeb, "Synonym for `OP_RETURN`.";
+ OP_RETURN_236 => 0xec, "Synonym for `OP_RETURN`.";
+ OP_RETURN_237 => 0xed, "Synonym for `OP_RETURN`.";
+ OP_RETURN_238 => 0xee, "Synonym for `OP_RETURN`.";
+ OP_RETURN_239 => 0xef, "Synonym for `OP_RETURN`.";
+ OP_RETURN_240 => 0xf0, "Synonym for `OP_RETURN`.";
+ OP_RETURN_241 => 0xf1, "Synonym for `OP_RETURN`.";
+ OP_RETURN_242 => 0xf2, "Synonym for `OP_RETURN`.";
+ OP_RETURN_243 => 0xf3, "Synonym for `OP_RETURN`.";
+ OP_RETURN_244 => 0xf4, "Synonym for `OP_RETURN`.";
+ OP_RETURN_245 => 0xf5, "Synonym for `OP_RETURN`.";
+ OP_RETURN_246 => 0xf6, "Synonym for `OP_RETURN`.";
+ OP_RETURN_247 => 0xf7, "Synonym for `OP_RETURN`.";
+ OP_RETURN_248 => 0xf8, "Synonym for `OP_RETURN`.";
+ OP_RETURN_249 => 0xf9, "Synonym for `OP_RETURN`.";
+ OP_RETURN_250 => 0xfa, "Synonym for `OP_RETURN`.";
+ OP_RETURN_251 => 0xfb, "Synonym for `OP_RETURN`.";
+ OP_RETURN_252 => 0xfc, "Synonym for `OP_RETURN`.";
+ OP_RETURN_253 => 0xfd, "Synonym for `OP_RETURN`.";
+ OP_RETURN_254 => 0xfe, "Synonym for `OP_RETURN`.";
+ OP_INVALIDOPCODE => 0xff, "Synonym for `OP_RETURN`."
+ }
+ reexported {
+ OP_1NEGATE,
+ OP_1, OP_2, OP_3, OP_4, OP_5, OP_6, OP_7, OP_8,
+ OP_9, OP_10, OP_11, OP_12, OP_13, OP_14, OP_15, OP_16,
+ OP_NOP, OP_IF, OP_NOTIF, OP_ELSE, OP_ENDIF, OP_VERIFY, OP_RETURN, OP_TOALTSTACK, OP_FROMALTSTACK,
+ OP_2DROP, OP_2DUP, OP_3DUP, OP_2OVER, OP_2ROT, OP_2SWAP, OP_IFDUP, OP_DEPTH,
+ OP_DROP, OP_DUP, OP_NIP, OP_OVER, OP_PICK, OP_ROLL, OP_ROT, OP_SWAP,
+ OP_TUCK, OP_SIZE, OP_EQUAL, OP_EQUALVERIFY, OP_1ADD, OP_1SUB, OP_NEGATE, OP_ABS,
+ OP_NOT, OP_0NOTEQUAL, OP_ADD, OP_SUB, OP_BOOLAND, OP_BOOLOR, OP_NUMEQUAL, OP_NUMEQUALVERIFY,
+ OP_NUMNOTEQUAL, OP_LESSTHAN, OP_GREATERTHAN, OP_LESSTHANOREQUAL, OP_GREATERTHANOREQUAL, OP_MIN, OP_MAX, OP_WITHIN,
+ OP_RIPEMD160, OP_SHA1, OP_SHA256, OP_HASH160, OP_HASH256, OP_CODESEPARATOR, OP_CHECKSIG, OP_CHECKSIGVERIFY,
+ OP_CHECKMULTISIG, OP_CHECKMULTISIGVERIFY, OP_CHECKSIGADD,
+ }
}
/// Classification context for the opcode.
diff --git a/primitives/src/opcodes.rs b/primitives/src/opcodes.rs
index 01680d33..19b94633 100644
--- a/primitives/src/opcodes.rs
+++ b/primitives/src/opcodes.rs
@@ -42,6 +42,107 @@ impl From<u8> for Opcode {
fn from(b: u8) -> Self { Self::from_u8(b) }
}
+macro_rules! all_opcodes {
+ ($($op:ident => $val:expr, $doc:expr);* $(;)?) => {
+ /// Enables wildcard imports to bring into scope all opcodes and nothing else.
+ ///
+ /// The `all` module is provided so one can use a wildcard import `use primitives::opcodes::all::*`
+ /// to get all the `OP_FOO` opcodes without getting other types defined in `opcodes` (e.g. `Opcode`).
+ ///
+ /// This module is guaranteed to never contain anything except opcode constants and all opcode
+ /// constants are guaranteed to begin with `OP_`.
+ pub mod all {
+ use super::Opcode;
+ $(
+ #[doc = $doc]
+ pub const $op: Opcode = Opcode::from_u8($val);
+ )*
+ }
+ }
+}
+
+all_opcodes! {
+ OP_1NEGATE => 0x4f, "Push the array `0x81` onto the stack.";
+ OP_1 => 0x51, "Push the array `0x01` onto the stack.";
+ OP_2 => 0x52, "Push the array `0x02` onto the stack.";
+ OP_3 => 0x53, "Push the array `0x03` onto the stack.";
+ OP_4 => 0x54, "Push the array `0x04` onto the stack.";
+ OP_5 => 0x55, "Push the array `0x05` onto the stack.";
+ OP_6 => 0x56, "Push the array `0x06` onto the stack.";
+ OP_7 => 0x57, "Push the array `0x07` onto the stack.";
+ OP_8 => 0x58, "Push the array `0x08` onto the stack.";
+ OP_9 => 0x59, "Push the array `0x09` onto the stack.";
+ OP_10 => 0x5a, "Push the array `0x0a` onto the stack.";
+ OP_11 => 0x5b, "Push the array `0x0b` onto the stack.";
+ OP_12 => 0x5c, "Push the array `0x0c` onto the stack.";
+ OP_13 => 0x5d, "Push the array `0x0d` onto the stack.";
+ OP_14 => 0x5e, "Push the array `0x0e` onto the stack.";
+ OP_15 => 0x5f, "Push the array `0x0f` onto the stack.";
+ OP_16 => 0x60, "Push the array `0x10` onto the stack.";
+ OP_NOP => 0x61, "Does nothing.";
+ OP_IF => 0x63, "Pop and execute the next statements if a nonzero element was popped.";
+ OP_NOTIF => 0x64, "Pop and execute the next statements if a zero element was popped.";
+ OP_ELSE => 0x67, "Execute statements if those after the previous `OP_IF` were not, and vice-versa. \
+ If there is no previous `OP_IF`, this acts as a RETURN.";
+ OP_ENDIF => 0x68, "Pop and execute the next statements if a zero element was popped.";
+ OP_VERIFY => 0x69, "If the top value is zero or the stack is empty, fail; otherwise, pop the stack.";
+ OP_RETURN => 0x6a, "Fail the script immediately. (Must be executed.).";
+ OP_TOALTSTACK => 0x6b, "Pop one element from the main stack onto the alt stack.";
+ OP_FROMALTSTACK => 0x6c, "Pop one element from the alt stack onto the main stack.";
+ OP_2DROP => 0x6d, "Drops the top two stack items.";
+ OP_2DUP => 0x6e, "Duplicates the top two stack items as `AB` -> `ABAB`.";
+ OP_3DUP => 0x6f, "Duplicates the top three stack items as `ABC` -> `ABCABC`.";
+ OP_2OVER => 0x70, "Duplicates the third and fourth items from the top of the stack.";
+ OP_2ROT => 0x71, "Moves the two stack items four spaces back to the front, as `xxxxAB` -> `ABxxxx`.";
+ OP_2SWAP => 0x72, "Swaps the top two pairs, as `ABCD` -> `CDAB`.";
+ OP_IFDUP => 0x73, "Duplicate the top stack element unless it is zero.";
+ OP_DEPTH => 0x74, "Push the current number of stack items onto the stack.";
+ OP_DROP => 0x75, "Drops the top stack item.";
+ OP_DUP => 0x76, "Duplicates the top stack item.";
+ OP_NIP => 0x77, "Drops the second-to-top stack item.";
+ OP_OVER => 0x78, "Copies the second-to-top stack item, as `xA` -> `AxA`.";
+ OP_PICK => 0x79, "Pop the top stack element as N. Copy the Nth stack element to the top.";
+ OP_ROLL => 0x7a, "Pop the top stack element as N. Move the Nth stack element to the top.";
+ OP_ROT => 0x7b, "Rotate the top three stack items, as `[top next1 next2]` -> `[next2 top next1]`.";
+ OP_SWAP => 0x7c, "Swap the top two stack items.";
+ OP_TUCK => 0x7d, "Copy the top stack item to before the second item, as `[top next]` -> `[top next top]`.";
+ OP_SIZE => 0x82, "Pushes the length of the top stack item onto the stack.";
+ OP_EQUAL => 0x87, "Pushes 1 if the inputs are exactly equal, 0 otherwise.";
+ OP_EQUALVERIFY => 0x88, "Returns success if the inputs are exactly equal, failure otherwise.";
+ OP_1ADD => 0x8b, "Increment the top stack element in place.";
+ OP_1SUB => 0x8c, "Decrement the top stack element in place.";
+ OP_NEGATE => 0x8f, "Multiply the top stack item by -1 in place.";
+ OP_ABS => 0x90, "Absolute value the top stack item in place.";
+ OP_NOT => 0x91, "Map 0 to 1 and everything else to 0, in place.";
+ OP_0NOTEQUAL => 0x92, "Map 0 to 0 and everything else to 1, in place.";
+ OP_ADD => 0x93, "Pop two stack items and push their sum.";
+ OP_SUB => 0x94, "Pop two stack items and push the second minus the top.";
+ OP_BOOLAND => 0x9a, "Pop the top two stack items and push 1 if both are nonzero, else push 0.";
+ OP_BOOLOR => 0x9b, "Pop the top two stack items and push 1 if either is nonzero, else push 0.";
+ OP_NUMEQUAL => 0x9c, "Pop the top two stack items and push 1 if both are numerically equal, else push 0.";
+ OP_NUMEQUALVERIFY => 0x9d, "Pop the top two stack items and return success if both are numerically equal, else return failure.";
+ OP_NUMNOTEQUAL => 0x9e, "Pop the top two stack items and push 0 if both are numerically equal, else push 1.";
+ OP_LESSTHAN => 0x9f, "Pop the top two items; push 1 if the second is less than the top, 0 otherwise.";
+ OP_GREATERTHAN => 0xa0, "Pop the top two items; push 1 if the second is greater than the top, 0 otherwise.";
+ OP_LESSTHANOREQUAL => 0xa1, "Pop the top two items; push 1 if the second is <= the top, 0 otherwise.";
+ OP_GREATERTHANOREQUAL => 0xa2, "Pop the top two items; push 1 if the second is >= the top, 0 otherwise.";
+ OP_MIN => 0xa3, "Pop the top two items; push the smaller.";
+ OP_MAX => 0xa4, "Pop the top two items; push the larger.";
+ OP_WITHIN => 0xa5, "Pop the top three items; if the top is >= the second and < the third, push 1, otherwise push 0.";
+ OP_RIPEMD160 => 0xa6, "Pop the top stack item and push its RIPEMD160 hash.";
+ OP_SHA1 => 0xa7, "Pop the top stack item and push its SHA1 hash.";
+ OP_SHA256 => 0xa8, "Pop the top stack item and push its SHA256 hash.";
+ OP_HASH160 => 0xa9, "Pop the top stack item and push its RIPEMD(SHA256) hash.";
+ OP_HASH256 => 0xaa, "Pop the top stack item and push its SHA256(SHA256) hash.";
+ OP_CODESEPARATOR => 0xab, "Ignore this and everything preceding when deciding what to sign when signature-checking.";
+ OP_CHECKSIG => 0xac, "<https://en.bitcoin.it/wiki/OP_CHECKSIG> pushing 1/0 for success/failure.";
+ OP_CHECKSIGVERIFY => 0xad, "<https://en.bitcoin.it/wiki/OP_CHECKSIG> returning success/failure.";
+ OP_CHECKMULTISIG => 0xae, "Pop N, N pubkeys, M, M signatures, a dummy (due to bug in reference code), \
+ and verify that all M signatures are valid. Push 1 for 'all valid', 0 otherwise.";
+ OP_CHECKMULTISIGVERIFY => 0xaf, "Like the above but return success/failure.";
+ OP_CHECKSIGADD => 0xba, "`OP_CHECKSIGADD` post tapscript.";
+}
+
/// Read the following byte as a length, and read the following
/// bytes as a push of that length.
#[cfg(feature = "alloc")]
Risk score
Our methodology →Why this scored 15/100
Human-validated context
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
No validated notes yet.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.