Struct bitcoin::blockdata::script::Script

pub struct Script(_);

A Bitcoin script

Methods

impl Script

pub fn new() -> Script

Creates a new empty script

pub fn new_p2pk(pubkey: &PublicKey) -> Script

Generates P2PK-type of scriptPubkey

pub fn new_p2pkh(pubkey_hash: &PubkeyHash) -> Script

Generates P2PKH-type of scriptPubkey

pub fn new_p2sh(script_hash: &ScriptHash) -> Script

Generates P2SH-type of scriptPubkey with a given hash of the redeem script

pub fn new_v0_wpkh(pubkey_hash: &WPubkeyHash) -> Script

Generates P2WPKH-type of scriptPubkey

pub fn new_v0_wsh(script_hash: &WScriptHash) -> Script

Generates P2WSH-type of scriptPubkey with a given hash of the redeem script

pub fn new_witness_program(ver: u5, program: &[u8]) -> Script

Generates P2WSH-type of scriptPubkey with a given hash of the redeem script

pub fn new_op_return(data: &[u8]) -> Script

Generates OP_RETURN-type of scriptPubkey for a given data

pub fn script_hash(&self) -> ScriptHash

Returns 160-bit hash of the script

pub fn wscript_hash(&self) -> WScriptHash

Returns 256-bit hash of the script for P2WSH outputs

pub fn len(&self) -> usize

The length in bytes of the script

pub fn is_empty(&self) -> bool

Whether the script is the empty script

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

Returns the script data

pub fn to_bytes(&self) -> Vec<u8>

Returns a copy of the script data

pub fn into_bytes(self) -> Vec<u8>

Convert the script into a byte vector

pub fn to_p2sh(&self) -> Script

Compute the P2SH output corresponding to this redeem script

pub fn to_v0_p2wsh(&self) -> Script

Compute the P2WSH output corresponding to this witnessScript (aka the "witness redeem script")

pub fn is_p2sh(&self) -> bool

Checks whether a script pubkey is a p2sh output

pub fn is_p2pkh(&self) -> bool

Checks whether a script pubkey is a p2pkh output

pub fn is_p2pk(&self) -> bool

Checks whether a script pubkey is a p2pk output

pub fn is_witness_program(&self) -> bool

Checks whether a script pubkey is a Segregated Witness (segwit) program.

pub fn is_v0_p2wsh(&self) -> bool

Checks whether a script pubkey is a p2wsh output

pub fn is_v0_p2wpkh(&self) -> bool

Checks whether a script pubkey is a p2wpkh output

pub fn is_op_return(&self) -> bool

Check if this is an OP_RETURN output

pub fn is_provably_unspendable(&self) -> bool

Whether a script can be proven to have no satisfying input

Important traits for Instructions<'a>

impl<'a> Iterator for Instructions<'a> type Item = Result<Instruction<'a>, Error>;

pub fn instructions(&self) -> Instructions

Iterate over the script in the form of Instructions, which are an enum covering opcodes, datapushes and errors. At most one error will be returned and then the iterator will end. To instead iterate over the script as sequence of bytes, treat it as a slice using script[..] or convert it to a vector using into_bytes().

To force minimal pushes, use [instructions_minimal].

Important traits for Instructions<'a>

impl<'a> Iterator for Instructions<'a> type Item = Result<Instruction<'a>, Error>;

pub fn instructions_minimal(&self) -> Instructions

Iterate over the script in the form of Instructions while enforcing minimal pushes.

pub fn fmt_asm(&self, f: &mut dyn Write) -> Result

Write the assembly decoding of the script to the formatter.

pub fn asm(&self) -> String

Get the assembly decoding of the script.

Trait Implementations

impl Serialize for Script

fn serialize(&self) -> Vec<u8>

Serialize a value as raw data.

impl Deserialize for Script

fn deserialize(bytes: &[u8]) -> Result<Self, Error>

Deserialize a value from raw data.

impl Encodable for Script

fn consensus_encode<S: Write>(&self, s: S) -> Result<usize, Error>

Encode an object with a well-defined format. Returns the number of bytes written on success.

impl Decodable for Script

fn consensus_decode<D: Read>(d: D) -> Result<Self, Error>

Decode an object with a well-defined format

impl From<Vec<u8>> for Script

Creates a new script from an existing vector

fn from(v: Vec<u8>) -> Script

Performs the conversion.

impl Ord for Script

fn cmp(&self, other: &Script) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl PartialOrd<Script> for Script

fn partial_cmp(&self, other: &Script) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Default for Script

fn default() -> Script

Returns the "default value" for a type.

impl Clone for Script

fn clone(&self) -> Script

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq<Script> for Script

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Eq for Script

impl Display for Script

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

Formats the value using the given formatter.

impl Debug for Script

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

Formats the value using the given formatter.

impl Index<usize> for Script

type Output = u8

The returned type after indexing.

fn index(&self, index: usize) -> &u8

Performs the indexing (container[index]) operation.

impl Index<Range<usize>> for Script

type Output = [u8]

The returned type after indexing.

fn index(&self, index: Range<usize>) -> &[u8]

Performs the indexing (container[index]) operation.

impl Index<RangeTo<usize>> for Script

type Output = [u8]

The returned type after indexing.

fn index(&self, index: RangeTo<usize>) -> &[u8]

Performs the indexing (container[index]) operation.

impl Index<RangeFrom<usize>> for Script

type Output = [u8]

The returned type after indexing.

fn index(&self, index: RangeFrom<usize>) -> &[u8]

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for Script

type Output = [u8]

The returned type after indexing.

fn index(&self, _: RangeFull) -> &[u8]

Performs the indexing (container[index]) operation.

impl Hash for Script

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl FromStr for Script

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Error>

Parses a string s to return a value of this type.

impl LowerHex for Script

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

Formats the value using the given formatter.

impl UpperHex for Script

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

Formats the value using the given formatter.

impl FromHex for Script

fn from_byte_iter<I>(iter: I) -> Result<Self, Error> where
    I: Iterator<Item = Result<u8, Error>> + ExactSizeIterator + DoubleEndedIterator, 

Produce an object from a byte iterator

fn from_hex(s: &str) -> Result<Self, Error>

Produce an object from a hex string