JSDoc: Class: Script

Constructor

new Script(optionsopt, nullable)

Create a script.

Parameters:

Name	Type	Attributes	Description
`options`	Object	<optional> <nullable>

Properties:

Name	Type	Attributes	Description
`code`	Array		Parsed script code.
`raw`	Buffer	<nullable>	Serialized script.
`length`	Number		Number of parsed opcodes.

Source:

script/script.js, line 55

Members

(static) flags :Number

Script and locktime flags. See VerifyFlags.

Type:

Number

Source:

script/script.js, line 2365

(static) hashType :SighashType

Sighash Types.

Type:

SighashType

Source:

script/script.js, line 2373

(static, constant) hashTypeByVal :RevMap

Sighash types by value.

Type:

RevMap

Source:

script/script.js, line 2380

(static) opcodes :Number

Script opcodes.

Type:

Number

Source:

script/script.js, line 2351

(static, constant) opcodesByVal :RevMap

Opcodes by value.

Type:

RevMap

Source:

script/script.js, line 2358

(static) types :Number

Output script types.

Type:

Number

Source:

script/script.js, line 2387

(static, constant) typesByVal :RevMap

Output script types by value.

Type:

RevMap

Source:

script/script.js, line 2394

code :Array.<Opcode>

Type:

Array.<Opcode>

Source:

script/script.js, line 67

length

Get length.

Source:

script/script.js, line 78

length

Set length.

Source:

script/script.js, line 87

Methods

(static) fromArray(code) → {Script}

Instantiate script from an array of buffers and numbers.

Parameters:

Name	Type	Description
`code`	Array.<Opcode>

Source:

script/script.js, line 183

Returns:

Type: Script

(static) fromItems(items) → {Script}

Instantiate script from stack items.

Parameters:

Name	Type	Description
`items`	Array.<Buffer>

Source:

script/script.js, line 230

Returns:

Type: Script

(static) fromMultisig(m, n, keys) → {Script}

Create a pay-to-multisig script.

Parameters:

Name	Type	Description
`m`	Number
`n`	Number
`keys`	Array.<Buffer>

Source:

script/script.js, line 1436

Returns:

Type: Script

(static) fromPubkey(key) → {Script}

Create a pay-to-pubkey script.

Parameters:

Name	Type	Description
`key`	Buffer

Source:

script/script.js, line 1357

Returns:

Type: Script

(static) fromPubkeyhash(hash) → {Script}

Create a pay-to-pubkeyhash script.

Parameters:

Name	Type	Description
`hash`	Buffer

Source:

script/script.js, line 1396

Returns:

Type: Script

(static) fromStack(stack) → {Script}

Instantiate script from stack.

Parameters:

Name	Type	Description
`stack`	Stack

Source:

script/script.js, line 259

Returns:

Type: Script

(static) isScript(obj) → {Boolean}

Test whether an object a Script.

Parameters:

Name	Type	Description
`obj`	Object

Source:

script/script.js, line 2340

Returns:

Type: Boolean

(static) verify(witness, addr, tx, index, value, flags)

Verify an input and output script, and a witness if present.

Parameters:

Name	Type	Description
`witness`	Witness
`addr`	Address
`tx`	TX
`index`	Number
`value`	AmountValue
`flags`	VerifyFlags

Source:

script/script.js, line 2249

Throws:

ScriptError

clear() → {this}

Clear the script.

Source:

script/script.js, line 303

Returns:

Type: this

compare(script) → {Number}

Compare against another script.

Parameters:

Name	Type	Description
`script`	Script

Source:

script/script.js, line 293

Returns:

Type: Number

compile()

Re-encode the script internally. Useful if you changed something manually in the code array.

Source:

script/script.js, line 352

decode(data) → {this}

Inject properties from serialized data.

Parameters:

Name	Type	Description
`data`	Buffer

Source:

script/script.js, line 2323

Returns:

Type: this

encode() → {Buffer}

Encode the script to a Buffer. See Script#encode.

Source:

script/script.js, line 387

Returns:

Serialized script.

Type: Buffer

entries()

Instantiate a key and value iterator.

Source:

script/script.js, line 135

equals(script) → {Boolean}

Test equality against script.

Parameters:

Name	Type	Description
`script`	Script

Source:

script/script.js, line 282

Returns:

Type: Boolean

execute(stack, flagsnullable, txnullable, indexnullable, valuenullable)

Execute and interpret the script.

Parameters:

Name	Type	Attributes	Description
`stack`	Stack		Script execution stack.
`flags`	Number	<nullable>	Script standard flags.
`tx`	TX	<nullable>	Transaction being verified.
`index`	Number	<nullable>	Index of input being verified.
`value`	AmountValue	<nullable>	Previous output value.

Source:

script/script.js, line 488

Throws:

Will be thrown on VERIFY failures.
Type ScriptError

format() → {String}

Inspect the script.

Source:

script/script.js, line 314

Returns:

Human-readable script code.

Type: String

fromArray(code) → {this}

Inject properties from an array of of buffers and numbers.

Parameters:

Name	Type	Description
`code`	Array.<Opcode>

Source:

script/script.js, line 165

Returns:

Type: this

fromItems(items) → {this}

Inject data from stack items.

Parameters:

Name	Type	Description
`items`	Array.<Buffer>

Source:

script/script.js, line 213

Returns:

Type: this

fromJSON(json)

Inject properties from json object.

Parameters:

Name	Type	Description
`json`	String

Source:

script/script.js, line 405

(private) fromMultisig(m, n, keys)

Inject properties from pay-to-multisig script.

Parameters:

Name	Type	Description
`m`	Number
`n`	Number
`keys`	Array.<Buffer>

Source:

script/script.js, line 1408

fromOptions(options) → {this}

Inject properties from options object.

Parameters:

Name	Type	Description
`options`	Object

Source:

script/script.js, line 97

Returns:

Type: this

fromPubkey(key) → {this}

Inject properties from a pay-to-pubkey script.

Parameters:

Name	Type	Description
`key`	Buffer

Source:

script/script.js, line 1334

Returns:

Type: this

(private) fromPubkeyhash(hash)

Inject properties from a pay-to-pubkeyhash script.

Parameters:

Name	Type	Description
`hash`	Buffer

Source:

script/script.js, line 1367

fromStack(stack) → {this}

Inject data from stack.

Parameters:

Name	Type	Description
`stack`	Stack

Source:

script/script.js, line 249

Returns:

Type: this

fromString(code)

Inject properties from bitcoind test string.

Parameters:

Name	Type	Description
`code`	String	Script string.

Source:

script/script.js, line 2182

Throws:

Parse error.

getJSON() → {String}

Convert script to a hex string.

Source:

script/script.js, line 396

Returns:

Type: String

getMultisig(minimalopt) → {Array}

Get multisig m and n values if present.

Parameters:

Name	Type	Attributes	Default	Description
`minimal`	Boolean	<optional>	false	Minimaldata only.

Source:

script/script.js, line 1641

Returns:

[m, n]

Type: Array

getPubkey(minimalopt) → {Buffer|null}

Get P2PK key if present.

Parameters:

Name	Type	Attributes	Default	Description
`minimal`	Boolean	<optional>	false	Minimaldata only.

Source:

script/script.js, line 1544

Returns:

Type: Buffer | null

getPubkeyhash(minimalopt) → {Buffer|null}

Get P2PKH hash if present.

Parameters:

Name	Type	Attributes	Default	Description
`minimal`	Boolean	<optional>	false	Minimaldata only.

Source:

script/script.js, line 1586

Returns:

Type: Buffer | null

getSigops() → {Number}

Count the sigops in the script.

Source:

script/script.js, line 1704

Returns:

sigop count

Type: Number

getSize() → {Number}

Calculate the size of the script excluding the varint size bytes.

Source:

script/script.js, line 1494

Returns:

Type: Number

getSubscript(index) → {this}

Get the script's "subscript" starting at a separator.

Parameters:

Name	Type	Description
`index`	Number	The last separator to sign/verify beyond.

Source:

script/script.js, line 416

Returns:

Subscript.

Type: this

getType() → {common.types}

Get the standard script type.

Source:

script/script.js, line 1445

Returns:

Type: common.types

getVarSize() → {Number}

Calculate the size of the script including the varint size bytes.

Source:

script/script.js, line 1504

Returns:

Type: Number

indexOf(data) → {Number}

Find a data element in a script.

Parameters:

Name	Type	Description
`data`	Buffer	Data element to match against.

Source:

script/script.js, line 1279

Returns:

Index (-1 if not present).

Type: Number

inject(script) → {this}

Inject properties from script. Used for cloning.

Parameters:

Name	Type	Description
`script`	this

Source:

script/script.js, line 270

Returns:

Type: this

isCode() → {Boolean}

Test a script to see if it is likely to be script code (no weird opcodes).

Source:

script/script.js, line 1302

Returns:

Type: Boolean

isMultisig(minimalopt) → {Boolean}

Test whether the output script is pay-to-multisig.

Parameters:

Name	Type	Attributes	Default	Description
`minimal`	Boolean	<optional>	false	Minimaldata only.

Source:

script/script.js, line 1602

Returns:

Type: Boolean

isPubkey(minimalopt) → {Boolean}

Test whether the output script is pay-to-pubkey.

Parameters:

Name	Type	Attributes	Default	Description
`minimal`	Boolean	<optional>	false	Minimaldata only.

Source:

script/script.js, line 1523

Returns:

Type: Boolean

isPubkeyhash(minimalopt) → {Boolean}

Test whether the output script is pay-to-pubkeyhash.

Parameters:

Name	Type	Attributes	Default	Description
`minimal`	Boolean	<optional>	false	Minimaldata only.

Source:

script/script.js, line 1560

Returns:

Type: Boolean

isPushOnly() → {Boolean}

Test the script to see if it contains only push ops. Push ops are: OP_1NEGATE, OP_0-OP_16 and all PUSHDATAs.

Source:

script/script.js, line 1687

Returns:

Type: Boolean

isStandard() → {Boolean}

Test whether the script is standard by policy standards.

Source:

script/script.js, line 1472

Returns:

Type: Boolean

isUnknown() → {Boolean}

Test whether a script is of an unknown/non-standard type.

Source:

script/script.js, line 1463

Returns:

Type: Boolean

isUnspendable() → {Boolean}

Test whether the output script is unspendable.

Source:

script/script.js, line 1653

Returns:

Type: Boolean

read(br)

Inject properties from buffer reader.

Parameters:

Name	Type	Description
`br`	bio.BufferReader

Source:

script/script.js, line 2313

removeSeparators() → {this}

Get the script's "subscript" starting at a separator. Remove all OP_CODESEPARATORs if present. This bizarre behavior is necessary for signing and verification when code separators are present.

Source: