milksad
/
rust-bitcoin-unsafe-fast
14
0
Fork 0
Code Issues Pull Requests Activity

Merge rust-bitcoin/rust-bitcoin#869: Improve docs: script module 

4dcbef6ddd Improve docs: script module (Tobin Harding)

Pull request description:

  Improve the docs in the `blockdata::script` module by doing:

  - Use full sentences (use capitals and full stops)
  - Improve grammar/wording if necessary
  - Remove incorrect/unneeded comments
  - Fix layout of rustdoc i.e., use brief and description sections
  - Use 100 line character width if it makes the comment look better
  - Use third person instead of imperative tense

  ## Note to reviewers

  Sorry to be a bore and request review on all these docs fixes, this one is all in a single patch which makes it a bit harder to review. It is very similar in content to all the others that are open right now so I'm going to be a bit rude and leave it like this. Please say if this is even slightly putting too much demand on you review time.

ACKs for top commit:
  apoelstra:
    ACK 4dcbef6ddd
  dr-orlovsky:
    ACK 4dcbef6ddd

Tree-SHA512: 49fa1d88c4b97decbc563747ba166fe95698da6a634801ccf5f99fd67a4a907067dbf0a4d64e7773d5d5b04aef404167b6cc911382363247d15a61cef5d8965c
This commit is contained in:
Dr. Maxim Orlovsky 2022-03-12 12:08:01 +02:00
parent 7f0d1720d6 4dcbef6ddd
commit 64164db4b4
No known key found for this signature in database
GPG Key ID: AF91255DEA466640
1 changed files with 67 additions and 68 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

135
src/blockdata/script.rs
View File

@ -284,10 +284,10 @@ fn read_uint_iter(data: &mut ::core::slice::Iter<'_, u8>, size: usize) -> Result
} }
impl Script { impl Script {
/// Creates a new empty script /// Creates a new empty script.
pub fn new() -> Script { Script(vec![].into_boxed_slice()) } pub fn new() -> Script { Script(vec![].into_boxed_slice()) }
/// Generates P2PK-type of scriptPubkey /// Generates P2PK-type of scriptPubkey.
pub fn new_p2pk(pubkey: &PublicKey) -> Script { pub fn new_p2pk(pubkey: &PublicKey) -> Script {
Builder::new() Builder::new()
.push_key(pubkey) .push_key(pubkey)
@ -295,7 +295,7 @@ impl Script {
.into_script() .into_script()
} }
/// Generates P2PKH-type of scriptPubkey /// Generates P2PKH-type of scriptPubkey.
pub fn new_p2pkh(pubkey_hash: &PubkeyHash) -> Script { pub fn new_p2pkh(pubkey_hash: &PubkeyHash) -> Script {
Builder::new() Builder::new()
.push_opcode(opcodes::all::OP_DUP) .push_opcode(opcodes::all::OP_DUP)
@ -306,7 +306,7 @@ impl Script {
.into_script() .into_script()
} }
/// Generates P2SH-type of scriptPubkey with a given hash of the redeem script /// Generates P2SH-type of scriptPubkey with a given hash of the redeem script.
pub fn new_p2sh(script_hash: &ScriptHash) -> Script { pub fn new_p2sh(script_hash: &ScriptHash) -> Script {
Builder::new() Builder::new()
.push_opcode(opcodes::all::OP_HASH160) .push_opcode(opcodes::all::OP_HASH160)
@ -315,24 +315,24 @@ impl Script {
.into_script() .into_script()
} }
/// Generates P2WPKH-type of scriptPubkey /// Generates P2WPKH-type of scriptPubkey.
#[deprecated(since = "0.28.0", note = "use Script::new_v0_p2wpkh method instead")] #[deprecated(since = "0.28.0", note = "use Script::new_v0_p2wpkh method instead")]
pub fn new_v0_wpkh(pubkey_hash: &WPubkeyHash) -> Script { pub fn new_v0_wpkh(pubkey_hash: &WPubkeyHash) -> Script {
Script::new_v0_p2wpkh(pubkey_hash) Script::new_v0_p2wpkh(pubkey_hash)
} }
/// Generates P2WPKH-type of scriptPubkey /// Generates P2WPKH-type of scriptPubkey.
pub fn new_v0_p2wpkh(pubkey_hash: &WPubkeyHash) -> Script { pub fn new_v0_p2wpkh(pubkey_hash: &WPubkeyHash) -> Script {
Script::new_witness_program(WitnessVersion::V0, &pubkey_hash[..]) Script::new_witness_program(WitnessVersion::V0, &pubkey_hash[..])
} }
/// Generates P2WSH-type of scriptPubkey with a given hash of the redeem script /// Generates P2WSH-type of scriptPubkey with a given hash of the redeem script.
#[deprecated(since = "0.28.0", note = "use Script::new_v0_p2wsh method instead")] #[deprecated(since = "0.28.0", note = "use Script::new_v0_p2wsh method instead")]
pub fn new_v0_wsh(script_hash: &WScriptHash) -> Script { pub fn new_v0_wsh(script_hash: &WScriptHash) -> Script {
Script::new_v0_p2wsh(script_hash) Script::new_v0_p2wsh(script_hash)
} }
/// Generates P2WSH-type of scriptPubkey with a given hash of the redeem script /// Generates P2WSH-type of scriptPubkey with a given hash of the redeem script.
pub fn new_v0_p2wsh(script_hash: &WScriptHash) -> Script { pub fn new_v0_p2wsh(script_hash: &WScriptHash) -> Script {
Script::new_witness_program(WitnessVersion::V0, &script_hash[..]) Script::new_witness_program(WitnessVersion::V0, &script_hash[..])
} }
@ -349,7 +349,7 @@ impl Script {
Script::new_witness_program(WitnessVersion::V1, &output_key.serialize()) Script::new_witness_program(WitnessVersion::V1, &output_key.serialize())
} }
/// Generates P2WSH-type of scriptPubkey with a given hash of the redeem script /// Generates P2WSH-type of scriptPubkey with a given hash of the redeem script.
pub fn new_witness_program(version: WitnessVersion, program: &[u8]) -> Script { pub fn new_witness_program(version: WitnessVersion, program: &[u8]) -> Script {
Builder::new() Builder::new()
.push_opcode(version.into()) .push_opcode(version.into())
@ -357,7 +357,7 @@ impl Script {
.into_script() .into_script()
} }
/// Generates OP_RETURN-type of scriptPubkey for a given data /// Generates OP_RETURN-type of scriptPubkey for the given data.
pub fn new_op_return(data: &[u8]) -> Script { pub fn new_op_return(data: &[u8]) -> Script {
Builder::new() Builder::new()
.push_opcode(opcodes::all::OP_RETURN) .push_opcode(opcodes::all::OP_RETURN)
@ -365,44 +365,44 @@ impl Script {
.into_script() .into_script()
} }
/// Returns 160-bit hash of the script /// Returns 160-bit hash of the script.
pub fn script_hash(&self) -> ScriptHash { pub fn script_hash(&self) -> ScriptHash {
ScriptHash::hash(self.as_bytes()) ScriptHash::hash(self.as_bytes())
} }
/// Returns 256-bit hash of the script for P2WSH outputs /// Returns 256-bit hash of the script for P2WSH outputs.
pub fn wscript_hash(&self) -> WScriptHash { pub fn wscript_hash(&self) -> WScriptHash {
WScriptHash::hash(self.as_bytes()) WScriptHash::hash(self.as_bytes())
} }
/// The length in bytes of the script /// Returns the length in bytes of the script.
pub fn len(&self) -> usize { self.0.len() } pub fn len(&self) -> usize { self.0.len() }
/// Whether the script is the empty script /// Returns whether the script is the empty script.
pub fn is_empty(&self) -> bool { self.0.is_empty() } pub fn is_empty(&self) -> bool { self.0.is_empty() }
/// Returns the script data /// Returns the script data as a byte slice.
pub fn as_bytes(&self) -> &[u8] { &*self.0 } pub fn as_bytes(&self) -> &[u8] { &*self.0 }
/// Returns a copy of the script data /// Returns a copy of the script data.
pub fn to_bytes(&self) -> Vec<u8> { self.0.clone().into_vec() } pub fn to_bytes(&self) -> Vec<u8> { self.0.clone().into_vec() }
/// Convert the script into a byte vector /// Converts the script into a byte vector.
pub fn into_bytes(self) -> Vec<u8> { self.0.into_vec() } pub fn into_bytes(self) -> Vec<u8> { self.0.into_vec() }
/// Compute the P2SH output corresponding to this redeem script /// Computes the P2SH output corresponding to this redeem script.
pub fn to_p2sh(&self) -> Script { pub fn to_p2sh(&self) -> Script {
Script::new_p2sh(&self.script_hash()) Script::new_p2sh(&self.script_hash())
} }
/// Compute the P2WSH output corresponding to this witnessScript (aka the "witness redeem /// Computes the P2WSH output corresponding to this witnessScript (aka the "witness redeem
/// script") /// script").
pub fn to_v0_p2wsh(&self) -> Script { pub fn to_v0_p2wsh(&self) -> Script {
Script::new_v0_p2wsh(&self.wscript_hash()) Script::new_v0_p2wsh(&self.wscript_hash())
} }
/// Compute P2TR output with a given internal key and a single script spending path equal to the /// Computes P2TR output with a given internal key and a single script spending path equal to
/// current script, assuming that the script is a Tapscript /// the current script, assuming that the script is a Tapscript.
#[inline] #[inline]
pub fn to_v1_p2tr<C: Verification>(&self, secp: &Secp256k1<C>, internal_key: UntweakedPublicKey) -> Script { pub fn to_v1_p2tr<C: Verification>(&self, secp: &Secp256k1<C>, internal_key: UntweakedPublicKey) -> Script {
let leaf_hash = TapLeafHash::from_script(&self, LeafVersion::TapScript); let leaf_hash = TapLeafHash::from_script(&self, LeafVersion::TapScript);
@ -415,7 +415,7 @@ impl Script {
self.0.get(0).and_then(|opcode| WitnessVersion::from_opcode(opcodes::All::from(*opcode)).ok()) self.0.get(0).and_then(|opcode| WitnessVersion::from_opcode(opcodes::All::from(*opcode)).ok())
} }
/// Checks whether a script pubkey is a p2sh output /// Checks whether a script pubkey is a P2SH output.
#[inline] #[inline]
pub fn is_p2sh(&self) -> bool { pub fn is_p2sh(&self) -> bool {
self.0.len() == 23 self.0.len() == 23
@ -424,7 +424,7 @@ impl Script {
&& self.0[22] == opcodes::all::OP_EQUAL.into_u8() && self.0[22] == opcodes::all::OP_EQUAL.into_u8()
} }
/// Checks whether a script pubkey is a p2pkh output /// Checks whether a script pubkey is a P2PKH output.
#[inline] #[inline]
pub fn is_p2pkh(&self) -> bool { pub fn is_p2pkh(&self) -> bool {
self.0.len() == 25 self.0.len() == 25
@ -435,7 +435,7 @@ impl Script {
&& self.0[24] == opcodes::all::OP_CHECKSIG.into_u8() && self.0[24] == opcodes::all::OP_CHECKSIG.into_u8()
} }
/// Checks whether a script pubkey is a p2pk output /// Checks whether a script pubkey is a P2PK output.
#[inline] #[inline]
pub fn is_p2pk(&self) -> bool { pub fn is_p2pk(&self) -> bool {
match self.len() { match self.len() {
@ -471,7 +471,7 @@ impl Script {
&& script_len - 2 == push_opbyte as usize && script_len - 2 == push_opbyte as usize
} }
/// Checks whether a script pubkey is a p2wsh output /// Checks whether a script pubkey is a P2WSH output.
#[inline] #[inline]
pub fn is_v0_p2wsh(&self) -> bool { pub fn is_v0_p2wsh(&self) -> bool {
self.0.len() == 34 self.0.len() == 34
@ -479,7 +479,7 @@ impl Script {
&& self.0[1] == opcodes::all::OP_PUSHBYTES_32.into_u8() && self.0[1] == opcodes::all::OP_PUSHBYTES_32.into_u8()
} }
/// Checks whether a script pubkey is a p2wpkh output /// Checks whether a script pubkey is a P2WPKH output.
#[inline] #[inline]
pub fn is_v0_p2wpkh(&self) -> bool { pub fn is_v0_p2wpkh(&self) -> bool {
self.0.len() == 22 self.0.len() == 22
@ -487,7 +487,7 @@ impl Script {
&& self.0[1] == opcodes::all::OP_PUSHBYTES_20.into_u8() && self.0[1] == opcodes::all::OP_PUSHBYTES_20.into_u8()
} }
/// Checks whether a script pubkey is a P2TR output /// Checks whether a script pubkey is a P2TR output.
#[inline] #[inline]
pub fn is_v1_p2tr(&self) -> bool { pub fn is_v1_p2tr(&self) -> bool {
self.0.len() == 34 self.0.len() == 34
@ -495,7 +495,7 @@ impl Script {
&& self.0[1] == opcodes::all::OP_PUSHBYTES_32.into_u8() && self.0[1] == opcodes::all::OP_PUSHBYTES_32.into_u8()
} }
/// Check if this is an OP_RETURN output /// Check if this is an OP_RETURN output.
pub fn is_op_return (&self) -> bool { pub fn is_op_return (&self) -> bool {
match self.0.first() { match self.0.first() {
Some(b) => *b == opcodes::all::OP_RETURN.into_u8(), Some(b) => *b == opcodes::all::OP_RETURN.into_u8(),
@ -503,7 +503,7 @@ impl Script {
} }
} }
/// Whether a script can be proven to have no satisfying input /// Checks whether a script can be proven to have no satisfying input.
pub fn is_provably_unspendable(&self) -> bool { pub fn is_provably_unspendable(&self) -> bool {
use blockdata::opcodes::Class::{ReturnOp, IllegalOp}; use blockdata::opcodes::Class::{ReturnOp, IllegalOp};
@ -518,13 +518,12 @@ impl Script {
} }
} }
/// Gets the minimum value an output with this script should have in order to be /// Returns the minimum value an output with this script should have in order to be
/// broadcastable on today's bitcoin network. /// broadcastable on today's Bitcoin network.
pub fn dust_value(&self) -> ::Amount { pub fn dust_value(&self) -> ::Amount {
// This must never be lower than Bitcoin Core's GetDustThreshold() (as of v0.21) as it may // This must never be lower than Bitcoin Core's GetDustThreshold() (as of v0.21) as it may
// otherwise allow users to create transactions which likely can never be // otherwise allow users to create transactions which likely can never be broadcast/confirmed.
// broadcasted/confirmed. let sats = DUST_RELAY_TX_FEE as u64 / 1000 * // The default dust relay fee is 3000 satoshi/kB (i.e. 3 sat/vByte)
let sats = DUST_RELAY_TX_FEE as u64 / 1000 * // The default dust relay fee is 3000 satoshi/kB (ie 3 sat/vByte)
if self.is_op_return() { if self.is_op_return() {
0 0
} else if self.is_witness_program() { } else if self.is_witness_program() {
@ -540,12 +539,14 @@ impl Script {
::Amount::from_sat(sats) ::Amount::from_sat(sats)
} }
/// Iterate over the script in the form of `Instruction`s, which are an enum covering /// Iterates over the script in the form of `Instruction`s, which are an enum covering opcodes,
/// opcodes, datapushes and errors. At most one error will be returned and then the /// datapushes and errors.
/// 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 [Self::instructions_minimal]. /// 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 [`Self::instructions_minimal`].
pub fn instructions(&self) -> Instructions { pub fn instructions(&self) -> Instructions {
Instructions { Instructions {
data: &self.0[..], data: &self.0[..],
@ -553,8 +554,7 @@ impl Script {
} }
} }
/// Iterate over the script in the form of `Instruction`s while enforcing /// Iterates over the script in the form of `Instruction`s while enforcing minimal pushes.
/// minimal pushes.
pub fn instructions_minimal(&self) -> Instructions { pub fn instructions_minimal(&self) -> Instructions {
Instructions { Instructions {
data: &self.0[..], data: &self.0[..],
@ -562,26 +562,27 @@ impl Script {
} }
} }
/// Shorthand for [Self::verify_with_flags] with flag [bitcoinconsensus::VERIFY_ALL] /// Shorthand for [`Self::verify_with_flags`] with flag [bitcoinconsensus::VERIFY_ALL].
#[cfg(feature="bitcoinconsensus")] #[cfg(feature="bitcoinconsensus")]
#[cfg_attr(docsrs, doc(cfg(feature = "bitcoinconsensus")))] #[cfg_attr(docsrs, doc(cfg(feature = "bitcoinconsensus")))]
pub fn verify (&self, index: usize, amount: ::Amount, spending: &[u8]) -> Result<(), Error> { pub fn verify (&self, index: usize, amount: ::Amount, spending: &[u8]) -> Result<(), Error> {
self.verify_with_flags(index, amount, spending, ::bitcoinconsensus::VERIFY_ALL) self.verify_with_flags(index, amount, spending, ::bitcoinconsensus::VERIFY_ALL)
} }
/// Verify spend of an input script /// Verifies spend of an input script.
///
/// # Parameters /// # Parameters
/// * `index` - the input index in spending which is spending this transaction /// * `index` - The input index in spending which is spending this transaction.
/// * `amount` - the amount this script guards /// * `amount` - The amount this script guards.
/// * `spending` - the transaction that attempts to spend the output holding this script /// * `spending` - The transaction that attempts to spend the output holding this script.
/// * `flags` - verification flags, see [bitcoinconsensus::VERIFY_ALL] and similar /// * `flags` - Verification flags, see [`bitcoinconsensus::VERIFY_ALL`] and similar.
#[cfg(feature="bitcoinconsensus")] #[cfg(feature="bitcoinconsensus")]
#[cfg_attr(docsrs, doc(cfg(feature = "bitcoinconsensus")))] #[cfg_attr(docsrs, doc(cfg(feature = "bitcoinconsensus")))]
pub fn verify_with_flags<F: Into<u32>>(&self, index: usize, amount: ::Amount, spending: &[u8], flags: F) -> Result<(), Error> { pub fn verify_with_flags<F: Into<u32>>(&self, index: usize, amount: ::Amount, spending: &[u8], flags: F) -> Result<(), Error> {
Ok(bitcoinconsensus::verify_with_flags (&self.0[..], amount.as_sat(), spending, index, flags.into())?) Ok(bitcoinconsensus::verify_with_flags (&self.0[..], amount.as_sat(), spending, index, flags.into())?)
} }
/// Write the assembly decoding of the script bytes to the formatter. /// Writes the assembly decoding of the script bytes to the formatter.
pub fn bytes_to_asm_fmt(script: &[u8], f: &mut dyn fmt::Write) -> fmt::Result { pub fn bytes_to_asm_fmt(script: &[u8], f: &mut dyn fmt::Write) -> fmt::Result {
// This has to be a macro because it needs to break the loop // This has to be a macro because it needs to break the loop
macro_rules! read_push_data_len { macro_rules! read_push_data_len {
@ -661,41 +662,41 @@ impl Script {
Ok(()) Ok(())
} }
/// Write the assembly decoding of the script to the formatter. /// Writes the assembly decoding of the script to the formatter.
pub fn fmt_asm(&self, f: &mut dyn fmt::Write) -> fmt::Result { pub fn fmt_asm(&self, f: &mut dyn fmt::Write) -> fmt::Result {
Script::bytes_to_asm_fmt(self.as_ref(), f) Script::bytes_to_asm_fmt(self.as_ref(), f)
} }
/// Create an assembly decoding of the script in the given byte slice. /// Creates an assembly decoding of the script in the given byte slice.
pub fn bytes_to_asm(script: &[u8]) -> String { pub fn bytes_to_asm(script: &[u8]) -> String {
let mut buf = String::new(); let mut buf = String::new();
Script::bytes_to_asm_fmt(script, &mut buf).unwrap(); Script::bytes_to_asm_fmt(script, &mut buf).unwrap();
buf buf
} }
/// Get the assembly decoding of the script. /// Returns the assembly decoding of the script.
pub fn asm(&self) -> String { pub fn asm(&self) -> String {
Script::bytes_to_asm(self.as_ref()) Script::bytes_to_asm(self.as_ref())
} }
} }
/// Creates a new script from an existing vector /// Creates a new script from an existing vector.
impl From<Vec<u8>> for Script { impl From<Vec<u8>> for Script {
fn from(v: Vec<u8>) -> Script { Script(v.into_boxed_slice()) } fn from(v: Vec<u8>) -> Script { Script(v.into_boxed_slice()) }
} }
impl_index_newtype!(Script, u8); impl_index_newtype!(Script, u8);
/// A "parsed opcode" which allows iterating over a Script in a more sensible way /// A "parsed opcode" which allows iterating over a [`Script`] in a more sensible way.
#[derive(Debug, PartialEq, Eq, Clone)] #[derive(Debug, PartialEq, Eq, Clone)]
pub enum Instruction<'a> { pub enum Instruction<'a> {
/// Push a bunch of data /// Push a bunch of data.
PushBytes(&'a [u8]), PushBytes(&'a [u8]),
/// Some non-push opcode /// Some non-push opcode.
Op(opcodes::All), Op(opcodes::All),
} }
/// Iterator over a script returning parsed opcodes /// Iterator over a script returning parsed opcodes.
pub struct Instructions<'a> { pub struct Instructions<'a> {
data: &'a [u8], data: &'a [u8],
enforce_minimal: bool, enforce_minimal: bool,
@ -813,15 +814,15 @@ impl<'a> Iterator for Instructions<'a> {
impl<'a> ::core::iter::FusedIterator for Instructions<'a> {} impl<'a> ::core::iter::FusedIterator for Instructions<'a> {}
impl Builder { impl Builder {
/// Creates a new empty script /// Creates a new empty script.
pub fn new() -> Self { pub fn new() -> Self {
Builder(vec![], None) Builder(vec![], None)
} }
/// The length in bytes of the script /// Returns the length in bytes of the script.
pub fn len(&self) -> usize { self.0.len() } pub fn len(&self) -> usize { self.0.len() }
/// Whether the script is the empty script /// Checks whether the script is the empty script.
pub fn is_empty(&self) -> bool { self.0.is_empty() } pub fn is_empty(&self) -> bool { self.0.is_empty() }
/// Adds instructions to push an integer onto the stack. Integers are /// Adds instructions to push an integer onto the stack. Integers are
@ -849,7 +850,7 @@ impl Builder {
self.push_slice(&build_scriptint(data)) self.push_slice(&build_scriptint(data))
} }
/// Adds instructions to push some arbitrary data onto the stack /// Adds instructions to push some arbitrary data onto the stack.
pub fn push_slice(mut self, data: &[u8]) -> Builder { pub fn push_slice(mut self, data: &[u8]) -> Builder {
// Start with a PUSH opcode // Start with a PUSH opcode
match data.len() as u64 { match data.len() as u64 {
@ -878,7 +879,7 @@ impl Builder {
self self
} }
/// Pushes a public key /// Adds instructions to push a public key onto the stack.
pub fn push_key(self, key: &PublicKey) -> Builder { pub fn push_key(self, key: &PublicKey) -> Builder {
if key.compressed { if key.compressed {
self.push_slice(&key.inner.serialize()[..]) self.push_slice(&key.inner.serialize()[..])
@ -887,7 +888,7 @@ impl Builder {
} }
} }
/// Adds a single opcode to the script /// Adds a single opcode to the script.
pub fn push_opcode(mut self, data: opcodes::All) -> Builder { pub fn push_opcode(mut self, data: opcodes::All) -> Builder {
self.0.push(data.into_u8()); self.0.push(data.into_u8());
self.1 = Some(data); self.1 = Some(data);
@ -896,7 +897,7 @@ impl Builder {
/// Adds an `OP_VERIFY` to the script, unless the most-recently-added /// Adds an `OP_VERIFY` to the script, unless the most-recently-added
/// opcode has an alternate `VERIFY` form, in which case that opcode /// opcode has an alternate `VERIFY` form, in which case that opcode
/// is replaced. e.g. `OP_CHECKSIG` will become `OP_CHECKSIGVERIFY`. /// is replaced e.g., `OP_CHECKSIG` will become `OP_CHECKSIGVERIFY`.
pub fn push_verify(mut self) -> Builder { pub fn push_verify(mut self) -> Builder {
match self.1 { match self.1 {
Some(opcodes::all::OP_EQUAL) => { Some(opcodes::all::OP_EQUAL) => {
@ -919,18 +920,17 @@ impl Builder {
} }
} }
/// Converts the `Builder` into an unmodifiable `Script` /// Converts the `Builder` into an unmodifiable `Script`.
pub fn into_script(self) -> Script { pub fn into_script(self) -> Script {
Script(self.0.into_boxed_slice()) Script(self.0.into_boxed_slice())
} }
} }
/// Adds an individual opcode to the script
impl Default for Builder { impl Default for Builder {
fn default() -> Builder { Builder::new() } fn default() -> Builder { Builder::new() }
} }
/// Creates a new script from an existing vector /// Creates a new builder from an existing vector.
impl From<Vec<u8>> for Builder { impl From<Vec<u8>> for Builder {
fn from(v: Vec<u8>) -> Builder { fn from(v: Vec<u8>) -> Builder {
let script = Script(v.into_boxed_slice()); let script = Script(v.into_boxed_slice());
@ -1020,7 +1020,6 @@ impl serde::Serialize for Script {
} }
} }
// Network serialization
impl Encodable for Script { impl Encodable for Script {
#[inline] #[inline]
fn consensus_encode<S: io::Write>( fn consensus_encode<S: io::Write>(