Script (bitcoinj-core 0.16-SNAPSHOT API)

java.lang.Object
- org.bitcoinj.script.Script

```
public class Script
extends java.lang.Object
```
Programs embedded inside transactions that control redemption of payments.

Bitcoin transactions don't specify what they do directly. Instead a small binary stack language is used to define programs that when evaluated return whether the transaction "accepts" or rejects the other transactions connected to it.

In SPV mode, scripts are not run, because that would require all transactions to be available and lightweight clients don't have that data. In full mode, this class is used to run the interpreted language. It also has static methods for building scripts.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Script.ScriptType` Enumeration to encapsulate the type of this script.
`static class`	`Script.VerifyFlag` Flags to pass to `correctlySpends(Transaction, long, Script, Set)`.

Field Summary

Fields
Modifier and Type	Field and Description
`static java.util.EnumSet<Script.VerifyFlag>`	`ALL_VERIFY_FLAGS`
`protected java.util.List<ScriptChunk>`	`chunks`
`static int`	`MAX_P2SH_SIGOPS` Max number of sigops allowed in a standard p2sh redeem script
`static long`	`MAX_SCRIPT_ELEMENT_SIZE`
`protected byte[]`	`program`
`static int`	`SIG_SIZE`

Constructor Summary

Constructors
Constructor and Description
`Script(byte[] programBytes)` Construct a Script that copies and wraps the programBytes array.
`Script(byte[] programBytes, long creationTimeSeconds)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`correctlySpends(Transaction txContainingThis, int scriptSigIndex, TransactionWitness witness, Coin value, Script scriptPubKey, java.util.Set<Script.VerifyFlag> verifyFlags)` Verifies that this script (interpreted as a scriptSig) correctly spends the given scriptPubKey.
`void`	`correctlySpends(Transaction txContainingThis, long scriptSigIndex, Script scriptPubKey)` Deprecated. Use `correctlySpends(Transaction, int, TransactionWitness, Coin, Script, Set)` instead so that verification flags do not change as new verification options are added.
`void`	`correctlySpends(Transaction txContainingThis, long scriptSigIndex, Script scriptPubKey, java.util.Set<Script.VerifyFlag> verifyFlags)` Verifies that this script (interpreted as a scriptSig) correctly spends the given scriptPubKey.
`Script`	`createEmptyInputScript(ECKey key, Script redeemScript)` Creates an incomplete scriptSig that, once filled with signatures, can redeem output containing this scriptPubKey.
`TransactionWitness`	`createEmptyWitness(ECKey key)`
`static byte[]`	`createInputScript(byte[] signature)`
`static byte[]`	`createInputScript(byte[] signature, byte[] pubkey)`
`static byte[]`	`createMultiSigOutputScript(int threshold, java.util.List<ECKey> pubkeys)` Creates a program that requires at least N of the given keys to sign, using OP_CHECKMULTISIG.
`static int`	`decodeFromOpN(int opcode)`
`static int`	`encodeToOpN(int value)`
`boolean`	`equals(java.lang.Object o)`
`static void`	`executeScript(Transaction txContainingThis, long index, Script script, java.util.LinkedList<byte[]> stack, boolean enforceNullDummy)` Deprecated. Use `executeScript(Transaction, long, Script, LinkedList, Set)` instead.
`static void`	`executeScript(Transaction txContainingThis, long index, Script script, java.util.LinkedList<byte[]> stack, java.util.Set<Script.VerifyFlag> verifyFlags)` Exposes the script interpreter.
`java.util.List<ScriptChunk>`	`getChunks()` Returns an immutable list of the scripts parsed form.
`long`	`getCreationTimeSeconds()`
`int`	`getNumberOfBytesRequiredToSpend(ECKey pubKey, Script redeemScript)` Returns number of bytes required to spend this script.
`int`	`getNumberOfSignaturesRequiredToSpend()` Returns number of signatures required to satisfy this script.
`static long`	`getP2SHSigOpCount(byte[] scriptSig)` Gets the count of P2SH Sig Ops in the Script scriptSig
`byte[]`	`getProgram()` Returns the serialized program as a newly created byte array.
`byte[]`	`getPubKeyHash()` If the program somehow pays to a hash, returns the hash.
`java.util.List<ECKey>`	`getPubKeys()` Returns a list of the keys required by this script, assuming a multi-sig script.
`Script`	`getScriptSigWithSignature(Script scriptSig, byte[] sigBytes, int index)` Returns a copy of the given scriptSig with the signature inserted in the given position.
`Script.ScriptType`	`getScriptType()` Get the `Script.ScriptType`.
`int`	`getSigInsertionIndex(Sha256Hash hash, ECKey signingKey)` Returns the index where a signature by the key should be inserted.
`static int`	`getSigOpCount(byte[] program)` Gets the count of regular SigOps in the script program (counting multisig ops as 20)
`Address`	`getToAddress(NetworkParameters params)` Gets the destination address from this script, if it's in the required form.
`Address`	`getToAddress(NetworkParameters params, boolean forcePayToPubKey)` Gets the destination address from this script, if it's in the required form.
`int`	`hashCode()`
`boolean`	`isOpReturn()` Deprecated. use `ScriptPattern.isOpReturn(Script)`
`boolean`	`isPayToScriptHash()` Deprecated. use `ScriptPattern.isP2SH(Script)`
`boolean`	`isSentToAddress()` Deprecated. use `ScriptPattern.isP2PKH(Script)`
`boolean`	`isSentToMultiSig()` Deprecated. use `ScriptPattern.isSentToMultisig(Script)`
`boolean`	`isSentToRawPubKey()` Deprecated. use `ScriptPattern.isP2PK(Script)`
`static byte[]`	`removeAllInstancesOf(byte[] inputScript, byte[] chunkToRemove)` Returns the script bytes of inputScript with all instances of the specified script object removed
`static byte[]`	`removeAllInstancesOfOp(byte[] inputScript, int opCode)` Returns the script bytes of inputScript with all instances of the given op code removed
`void`	`setCreationTimeSeconds(long creationTimeSeconds)`
`java.lang.String`	`toString()` Returns the program opcodes as a string, for example "[1234] DUP HASH160", or "<empty>".
`static void`	`writeBytes(java.io.OutputStream os, byte[] buf)` Writes out the given byte buffer to the output stream with the correct opcode prefix To write an integer call writeBytes(out, Utils.reverseBytes(Utils.encodeMPI(val, false)));

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - ALL_VERIFY_FLAGS
```
public static final java.util.EnumSet<Script.VerifyFlag> ALL_VERIFY_FLAGS
```
  - MAX_SCRIPT_ELEMENT_SIZE
```
public static final long MAX_SCRIPT_ELEMENT_SIZE
```
    See Also:
    
    Constant Field Values
  - SIG_SIZE
```
public static final int SIG_SIZE
```
    See Also:
    
    Constant Field Values
  - MAX_P2SH_SIGOPS
```
public static final int MAX_P2SH_SIGOPS
```
    Max number of sigops allowed in a standard p2sh redeem script
    
    See Also:
    
    Constant Field Values
  - chunks
```
protected java.util.List<ScriptChunk> chunks
```
  - program
```
protected byte[] program
```
- Constructor Detail
  - Script
```
public Script(byte[] programBytes)
       throws ScriptException
```
    Construct a Script that copies and wraps the programBytes array. The array is parsed and checked for syntactic validity.
    
    Parameters:
    
    programBytes - Array of program bytes from a transaction.
    
    Throws:
    
    ScriptException
  - Script
```
public Script(byte[] programBytes,
              long creationTimeSeconds)
       throws ScriptException
```
    Throws:
    
    ScriptException
- Method Detail
  - getCreationTimeSeconds
```
public long getCreationTimeSeconds()
```
  - setCreationTimeSeconds
```
public void setCreationTimeSeconds(long creationTimeSeconds)
```
  - toString
```
public java.lang.String toString()
```
    Returns the program opcodes as a string, for example "[1234] DUP HASH160", or "<empty>".
    
    Overrides:
    
    toString in class java.lang.Object
  - getProgram
```
public byte[] getProgram()
```
    Returns the serialized program as a newly created byte array.
  - getChunks
```
public java.util.List<ScriptChunk> getChunks()
```
    Returns an immutable list of the scripts parsed form. Each chunk is either an opcode or data element.
  - isSentToRawPubKey
```
@Deprecated
public boolean isSentToRawPubKey()
```
    Deprecated. use ScriptPattern.isP2PK(Script)
  - isSentToAddress
```
@Deprecated
public boolean isSentToAddress()
```
    Deprecated. use ScriptPattern.isP2PKH(Script)
  - getPubKeyHash
```
public byte[] getPubKeyHash()
                     throws ScriptException
```
    If the program somehow pays to a hash, returns the hash.
    
    Otherwise this method throws a ScriptException.
    
    Throws:
    
    ScriptException
  - getToAddress
```
public Address getToAddress(NetworkParameters params)
                     throws ScriptException
```
    Gets the destination address from this script, if it's in the required form.
    
    Throws:
    
    ScriptException
  - getToAddress
```
public Address getToAddress(NetworkParameters params,
                            boolean forcePayToPubKey)
                     throws ScriptException
```
    Gets the destination address from this script, if it's in the required form.
    
    Parameters:
    
    forcePayToPubKey - If true, allow payToPubKey to be casted to the corresponding address. This is useful if you prefer showing addresses rather than pubkeys.
    
    Throws:
    
    ScriptException
  - writeBytes
```
public static void writeBytes(java.io.OutputStream os,
                              byte[] buf)
                       throws java.io.IOException
```
    Writes out the given byte buffer to the output stream with the correct opcode prefix To write an integer call writeBytes(out, Utils.reverseBytes(Utils.encodeMPI(val, false)));
    
    Throws:
    
    java.io.IOException
  - createMultiSigOutputScript
```
public static byte[] createMultiSigOutputScript(int threshold,
                                                java.util.List<ECKey> pubkeys)
```
    Creates a program that requires at least N of the given keys to sign, using OP_CHECKMULTISIG.
  - createInputScript
```
public static byte[] createInputScript(byte[] signature,
                                       byte[] pubkey)
```
  - createInputScript
```
public static byte[] createInputScript(byte[] signature)
```
  - createEmptyInputScript
```
public Script createEmptyInputScript(@Nullable
                                     ECKey key,
                                     @Nullable
                                     Script redeemScript)
```
    Creates an incomplete scriptSig that, once filled with signatures, can redeem output containing this scriptPubKey. Instead of the signatures resulting script has OP_0. Having incomplete input script allows to pass around partially signed tx. It is expected that this program later on will be updated with proper signatures.
  - createEmptyWitness
```
public TransactionWitness createEmptyWitness(ECKey key)
```
  - getScriptSigWithSignature
```
public Script getScriptSigWithSignature(Script scriptSig,
                                        byte[] sigBytes,
                                        int index)
```
    Returns a copy of the given scriptSig with the signature inserted in the given position.
  - getSigInsertionIndex
```
public int getSigInsertionIndex(Sha256Hash hash,
                                ECKey signingKey)
```
    Returns the index where a signature by the key should be inserted. Only applicable to a P2SH scriptSig.
  - getPubKeys
```
public java.util.List<ECKey> getPubKeys()
```
    Returns a list of the keys required by this script, assuming a multi-sig script.
    
    Throws:
    
    ScriptException - if the script type is not understood or is pay to address or is P2SH (run this method on the "Redeem script" instead).
  - decodeFromOpN
```
public static int decodeFromOpN(int opcode)
```
  - encodeToOpN
```
public static int encodeToOpN(int value)
```
  - getSigOpCount
```
public static int getSigOpCount(byte[] program)
                         throws ScriptException
```
    Gets the count of regular SigOps in the script program (counting multisig ops as 20)
    
    Throws:
    
    ScriptException
  - getP2SHSigOpCount
```
public static long getP2SHSigOpCount(byte[] scriptSig)
                              throws ScriptException
```
    Gets the count of P2SH Sig Ops in the Script scriptSig
    
    Throws:
    
    ScriptException
  - getNumberOfSignaturesRequiredToSpend
```
public int getNumberOfSignaturesRequiredToSpend()
```
    Returns number of signatures required to satisfy this script.
  - getNumberOfBytesRequiredToSpend
```
public int getNumberOfBytesRequiredToSpend(@Nullable
                                           ECKey pubKey,
                                           @Nullable
                                           Script redeemScript)
```
    Returns number of bytes required to spend this script. It accepts optional ECKey and redeemScript that may be required for certain types of script to estimate target size.
  - isPayToScriptHash
```
@Deprecated
public boolean isPayToScriptHash()
```
    Deprecated. use ScriptPattern.isP2SH(Script)
  - isSentToMultiSig
```
@Deprecated
public boolean isSentToMultiSig()
```
    Deprecated. use ScriptPattern.isSentToMultisig(Script)
  - removeAllInstancesOf
```
public static byte[] removeAllInstancesOf(byte[] inputScript,
                                          byte[] chunkToRemove)
```
    Returns the script bytes of inputScript with all instances of the specified script object removed
  - removeAllInstancesOfOp
```
public static byte[] removeAllInstancesOfOp(byte[] inputScript,
                                            int opCode)
```
    Returns the script bytes of inputScript with all instances of the given op code removed
  - isOpReturn
```
@Deprecated
public boolean isOpReturn()
```
    Deprecated. use ScriptPattern.isOpReturn(Script)
  - executeScript
```
@Deprecated
public static void executeScript(@Nullable
                                             Transaction txContainingThis,
                                             long index,
                                             Script script,
                                             java.util.LinkedList<byte[]> stack,
                                             boolean enforceNullDummy)
                                      throws ScriptException
```
    Deprecated. Use executeScript(Transaction, long, Script, LinkedList, Set) instead.
    
    Exposes the script interpreter. Normally you should not use this directly, instead use TransactionInput.verify(TransactionOutput) or correctlySpends(Transaction, int, TransactionWitness, Coin, Script, Set). This method is useful if you need more precise control or access to the final state of the stack. This interface is very likely to change in future.
    
    Throws:
    
    ScriptException
  - executeScript
```
public static void executeScript(@Nullable
                                 Transaction txContainingThis,
                                 long index,
                                 Script script,
                                 java.util.LinkedList<byte[]> stack,
                                 java.util.Set<Script.VerifyFlag> verifyFlags)
                          throws ScriptException
```
    Exposes the script interpreter. Normally you should not use this directly, instead use TransactionInput.verify(TransactionOutput) or correctlySpends(Transaction, int, TransactionWitness, Coin, Script, Set). This method is useful if you need more precise control or access to the final state of the stack. This interface is very likely to change in future.
    
    Throws:
    
    ScriptException
  - correctlySpends
```
@Deprecated
public void correctlySpends(Transaction txContainingThis,
                                        long scriptSigIndex,
                                        Script scriptPubKey)
                                 throws ScriptException
```
    Deprecated. Use correctlySpends(Transaction, int, TransactionWitness, Coin, Script, Set) instead so that verification flags do not change as new verification options are added.
    
    Verifies that this script (interpreted as a scriptSig) correctly spends the given scriptPubKey, enabling all validation rules.
    
    Parameters:
    
    txContainingThis - The transaction in which this input scriptSig resides. Accessing txContainingThis from another thread while this method runs results in undefined behavior.
    
    scriptSigIndex - The index in txContainingThis of the scriptSig (note: NOT the index of the scriptPubKey).
    
    scriptPubKey - The connected scriptPubKey containing the conditions needed to claim the value.
    
    Throws:
    
    ScriptException
  - correctlySpends
```
public void correctlySpends(Transaction txContainingThis,
                            int scriptSigIndex,
                            @Nullable
                            TransactionWitness witness,
                            @Nullable
                            Coin value,
                            Script scriptPubKey,
                            java.util.Set<Script.VerifyFlag> verifyFlags)
                     throws ScriptException
```
    Verifies that this script (interpreted as a scriptSig) correctly spends the given scriptPubKey.
    
    Parameters:
    
    txContainingThis - The transaction in which this input scriptSig resides. Accessing txContainingThis from another thread while this method runs results in undefined behavior.
    
    scriptSigIndex - The index in txContainingThis of the scriptSig (note: NOT the index of the scriptPubKey).
    
    scriptPubKey - The connected scriptPubKey containing the conditions needed to claim the value.
    
    witness - Transaction witness belonging to the transaction input containing this script. Needed for SegWit.
    
    value - Value of the output. Needed for SegWit scripts.
    
    verifyFlags - Each flag enables one validation rule.
    
    Throws:
    
    ScriptException
  - correctlySpends
```
public void correctlySpends(Transaction txContainingThis,
                            long scriptSigIndex,
                            Script scriptPubKey,
                            java.util.Set<Script.VerifyFlag> verifyFlags)
                     throws ScriptException
```
    Verifies that this script (interpreted as a scriptSig) correctly spends the given scriptPubKey.
    
    Parameters:
    
    txContainingThis - The transaction in which this input scriptSig resides. Accessing txContainingThis from another thread while this method runs results in undefined behavior.
    
    scriptSigIndex - The index in txContainingThis of the scriptSig (note: NOT the index of the scriptPubKey).
    
    scriptPubKey - The connected scriptPubKey containing the conditions needed to claim the value.
    
    verifyFlags - Each flag enables one validation rule.
    
    Throws:
    
    ScriptException
  - getScriptType
```
@Nullable
public Script.ScriptType getScriptType()
```
    Get the Script.ScriptType.
    
    Returns:
    
    The script type, or null if the script is of unknown type
  - equals
```
public boolean equals(java.lang.Object o)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object

Class Script

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ALL_VERIFY_FLAGS

MAX_SCRIPT_ELEMENT_SIZE

SIG_SIZE

MAX_P2SH_SIGOPS

chunks

program

Constructor Detail

Script

Script

Method Detail

getCreationTimeSeconds

setCreationTimeSeconds

toString

getProgram

getChunks

isSentToRawPubKey

isSentToAddress

getPubKeyHash

getToAddress

getToAddress

writeBytes

createMultiSigOutputScript

createInputScript

createInputScript

createEmptyInputScript

createEmptyWitness

getScriptSigWithSignature

getSigInsertionIndex

getPubKeys

decodeFromOpN

encodeToOpN

getSigOpCount

getP2SHSigOpCount

getNumberOfSignaturesRequiredToSpend

getNumberOfBytesRequiredToSpend

isPayToScriptHash

isSentToMultiSig

removeAllInstancesOf

removeAllInstancesOfOp

isOpReturn

executeScript

executeScript

correctlySpends

correctlySpends

correctlySpends

getScriptType

equals

hashCode