Struct Script 

pub struct Script(/* private fields */);

A Bitcoin script, represented as a byte vector newtype.

Implementations

impl Script

pub fn new() -> Self

Create a new empty script.

Returns

An empty Script instance.

pub fn from_hex(hex_str: &str) -> Result<Self, ScriptError>

Create a script from a hex-encoded string.

Arguments

• hex_str - A hex string (e.g. “76a914…88ac”).

Returns

A Script wrapping the decoded bytes, or an error if the hex is invalid.

pub fn from_bytes(bytes: &[u8]) -> Self

Create a script from raw bytes.

Arguments

• bytes - Raw script bytes.

Returns

A Script wrapping a copy of the given bytes.

pub fn from_asm(asm: &str) -> Result<Self, ScriptError>

Create a script from a Bitcoin ASM string.

Parses space-separated tokens where known opcodes (e.g. “OP_DUP”) are emitted directly and hex strings are treated as push data.

Arguments

• asm - A space-separated ASM string.

Returns

A Script, or an error if any token is invalid.

pub fn to_hex(&self) -> String

Encode the script as a hex string.

Returns

A lowercase hex representation of the script bytes.

pub fn to_asm(&self) -> String

Convert the script to its ASM (human-readable assembly) representation.

Each opcode or data push is represented as a space-separated token. Data pushes appear as their hex encoding; opcodes appear by name.

Returns

A space-separated ASM string. Returns empty string for empty/invalid scripts.

pub fn to_bytes(&self) -> &[u8]

Return a reference to the underlying bytes.

Returns

A byte slice of the script contents.

pub fn len(&self) -> usize

Return the length of the script in bytes.

Returns

The number of bytes in the script.

pub fn is_empty(&self) -> bool

Check if the script is empty (zero bytes).

Returns

true if the script has no bytes.

pub fn is_p2pkh(&self) -> bool

Check if this is a Pay-to-Public-Key-Hash (P2PKH) output script.

Pattern: OP_DUP OP_HASH160 <20 bytes> OP_EQUALVERIFY OP_CHECKSIG

Returns

true if the script matches the P2PKH pattern.

pub fn is_p2pk(&self) -> bool

Check if this is a Pay-to-Public-Key (P2PK) output script.

Pattern: <pubkey> OP_CHECKSIG (pubkey is 33 or 65 bytes with valid prefix).

Returns

true if the script matches the P2PK pattern.

pub fn is_p2sh(&self) -> bool

Check if this is a Pay-to-Script-Hash (P2SH) output script.

Pattern: OP_HASH160 <20 bytes> OP_EQUAL

Returns

true if the script matches the P2SH pattern.

pub fn is_data(&self) -> bool

Check if this is a data output script (OP_RETURN or OP_FALSE OP_RETURN).

Returns

true if the script begins with OP_RETURN or OP_FALSE OP_RETURN.

pub fn is_multisig_out(&self) -> bool

Check if this is a multisig output script.

Pattern: OP_N <pubkey1> <pubkey2> ... OP_M OP_CHECKMULTISIG

Returns

true if the script matches the multisig output pattern.

pub fn public_key_hash(&self) -> Result<Vec<u8>, ScriptError>

Extract the public key hash from a P2PKH script.

Returns the 20-byte hash160 if the script starts with OP_DUP OP_HASH160.

Returns

The 20-byte public key hash, or an error if the script is not P2PKH.

pub fn chunks(&self) -> Result<Vec<ScriptChunk>, ScriptError>

Parse the script into a vector of decoded chunks.

Returns

A vector of ScriptChunk values, or an error if the script is malformed.

pub fn append_push_data(&mut self, data: &[u8]) -> Result<(), ScriptError>

Append data bytes to the script with the proper PUSHDATA prefix.

Chooses the minimal encoding: direct push for 1-75 bytes, OP_PUSHDATA1 for 76-255, OP_PUSHDATA2 for 256-65535, etc.

Arguments

• data - The data bytes to push.

Returns

Ok(()) on success, or an error if the data is too large.

pub fn append_push_data_hex(&mut self, hex_str: &str) -> Result<(), ScriptError>

Append hex-encoded data to the script with proper PUSHDATA prefix.

Arguments

• hex_str - Hex string to decode and push.

Returns

Ok(()) on success, or an error if the hex is invalid or data too large.

pub fn append_opcodes(&mut self, opcodes: &[u8]) -> Result<(), ScriptError>

Append raw opcodes to the script.

Rejects push data opcodes (OP_DATA_1..OP_PUSHDATA4) to prevent misuse. Use append_push_data for those.

Arguments

• opcodes - Slice of opcode bytes to append.

Returns

Ok(()) on success, or an error if a push data opcode is encountered.

pub fn equals(&self, other: &Script) -> bool

Check if this script is byte-equal to another script.

Arguments

• other - The other script to compare with.

Returns

true if both scripts have identical bytes.

Trait Implementations

impl Clone for Script

fn clone(&self) -> Script

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Script

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

Formats the value using the given formatter.

impl Default for Script

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Script

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Script

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

Display the script as a lowercase hex string.

impl PartialEq for Script

fn eq(&self, other: &Script) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Script

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Script

impl StructuralPartialEq for Script