Class: Bitcoin::Tx
Overview
Transaction class
Constant Summary collapse
- MAX_STANDARD_VERSION =
2
- MAX_STANDARD_TX_WEIGHT =
The maximum weight for transactions we’re willing to relay/mine
400000
- MARKER =
0x00
- FLAG =
0x01
Instance Attribute Summary collapse
-
#flag ⇒ Object
Returns the value of attribute flag.
-
#inputs ⇒ Object
(also: #in)
readonly
Returns the value of attribute inputs.
-
#lock_time ⇒ Object
Returns the value of attribute lock_time.
-
#marker ⇒ Object
Returns the value of attribute marker.
-
#outputs ⇒ Object
(also: #out)
readonly
Returns the value of attribute outputs.
-
#version ⇒ Object
Returns the value of attribute version.
Class Method Summary collapse
Instance Method Summary collapse
- #==(other) ⇒ Object
- #coinbase_tx? ⇒ Boolean
- #hash ⇒ Object
-
#initialize ⇒ Tx
constructor
A new instance of Tx.
-
#serialize_old_format ⇒ Object
serialize tx with old tx format.
-
#serialize_witness_format ⇒ Object
serialize tx with segwit tx format github.com/bitcoin/bips/blob/master/bip-0144.mediawiki.
-
#sighash_for_input(input_index, output_script = nil, opts: {}, hash_type: , sig_version: :base, amount: nil, skip_separator_index: 0, prevouts: []) ⇒ String
get signature hash the script code needs is the witnessScript but removing everything up to and including the last executed OP_CODESEPARATOR before the signature checking opcode being executed.
-
#size ⇒ Object
The serialized transaction size.
-
#standard? ⇒ Boolean
check this tx is standard.
- #to_h ⇒ Object
- #to_payload ⇒ Object
- #tx_hash ⇒ Object
- #txid ⇒ Object
-
#valid? ⇒ Boolean
Verify transaction validity.
-
#verify_input_sig(input_index, script_pubkey, amount: nil, flags: STANDARD_SCRIPT_VERIFY_FLAGS, prevouts: []) ⇒ Boolean
verify input signature.
-
#vsize ⇒ Object
The virtual transaction size (differs from size for witness transactions).
-
#weight ⇒ Object
calculate tx weight weight = (legacy tx payload) * 3 + (witness tx payload).
- #witness? ⇒ Boolean
-
#witness_commitment ⇒ Object
get the witness commitment of coinbase tx.
- #witness_hash ⇒ Object
- #witness_payload ⇒ Object
- #wtxid ⇒ Object
Methods included from HexConverter
Constructor Details
#initialize ⇒ Tx
Returns a new instance of Tx.
26 27 28 29 30 31 |
# File 'lib/bitcoin/tx.rb', line 26 def initialize @inputs = [] @outputs = [] @version = 1 @lock_time = 0 end |
Instance Attribute Details
#flag ⇒ Object
Returns the value of attribute flag.
21 22 23 |
# File 'lib/bitcoin/tx.rb', line 21 def flag @flag end |
#inputs ⇒ Object (readonly) Also known as: in
Returns the value of attribute inputs.
22 23 24 |
# File 'lib/bitcoin/tx.rb', line 22 def inputs @inputs end |
#lock_time ⇒ Object
Returns the value of attribute lock_time.
24 25 26 |
# File 'lib/bitcoin/tx.rb', line 24 def lock_time @lock_time end |
#marker ⇒ Object
Returns the value of attribute marker.
20 21 22 |
# File 'lib/bitcoin/tx.rb', line 20 def marker @marker end |
#outputs ⇒ Object (readonly) Also known as: out
Returns the value of attribute outputs.
23 24 25 |
# File 'lib/bitcoin/tx.rb', line 23 def outputs @outputs end |
#version ⇒ Object
Returns the value of attribute version.
19 20 21 |
# File 'lib/bitcoin/tx.rb', line 19 def version @version end |
Class Method Details
.parse_from_payload(payload, non_witness: false, strict: false) ⇒ Object
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 |
# File 'lib/bitcoin/tx.rb', line 36 def self.parse_from_payload(payload, non_witness: false, strict: false) buf = payload.is_a?(String) ? StringIO.new(payload) : payload tx = new tx.version = buf.read(4).unpack1('V') in_count = Bitcoin.unpack_var_int_from_io(buf) has_witness = false if in_count.zero? && !non_witness tx.marker = 0 tx.flag = buf.read(1).unpack1('c') if tx.flag.zero? buf.pos -= 1 else in_count = Bitcoin.unpack_var_int_from_io(buf) has_witness = true end end in_count.times do tx.inputs << TxIn.parse_from_payload(buf) end out_count = Bitcoin.unpack_var_int_from_io(buf) out_count.times do tx.outputs << TxOut.parse_from_payload(buf) end if has_witness in_count.times do |i| tx.inputs[i].script_witness = Bitcoin::ScriptWitness.parse_from_payload(buf) end end raise ArgumentError, 'Transaction has unexpected data.' if strict && (buf.pos + 4) != buf.length tx.lock_time = buf.read(4).unpack1('V') tx end |
Instance Method Details
#==(other) ⇒ Object
117 118 119 |
# File 'lib/bitcoin/tx.rb', line 117 def ==(other) to_payload == other.to_payload end |
#coinbase_tx? ⇒ Boolean
109 110 111 |
# File 'lib/bitcoin/tx.rb', line 109 def coinbase_tx? inputs.length == 1 && inputs.first.coinbase? end |
#hash ⇒ Object
74 75 76 |
# File 'lib/bitcoin/tx.rb', line 74 def hash to_hex.to_i(16) end |
#serialize_old_format ⇒ Object
serialize tx with old tx format
122 123 124 125 126 127 128 |
# File 'lib/bitcoin/tx.rb', line 122 def serialize_old_format buf = [version].pack('V') buf << Bitcoin.pack_var_int(inputs.length) << inputs.map(&:to_payload).join buf << Bitcoin.pack_var_int(outputs.length) << outputs.map(&:to_payload).join buf << [lock_time].pack('V') buf end |
#serialize_witness_format ⇒ Object
serialize tx with segwit tx format github.com/bitcoin/bips/blob/master/bip-0144.mediawiki
132 133 134 135 136 137 138 |
# File 'lib/bitcoin/tx.rb', line 132 def serialize_witness_format buf = [version, MARKER, FLAG].pack('Vcc') buf << Bitcoin.pack_var_int(inputs.length) << inputs.map(&:to_payload).join buf << Bitcoin.pack_var_int(outputs.length) << outputs.map(&:to_payload).join buf << witness_payload << [lock_time].pack('V') buf end |
#sighash_for_input(input_index, output_script = nil, opts: {}, hash_type: , sig_version: :base, amount: nil, skip_separator_index: 0, prevouts: []) ⇒ String
get signature hash the script code needs is the witnessScript but removing everything up to and including the last executed OP_CODESEPARATOR before the signature checking opcode being executed.
197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 |
# File 'lib/bitcoin/tx.rb', line 197 def sighash_for_input(input_index, output_script = nil, opts: {}, hash_type: SIGHASH_TYPE[:all], sig_version: :base, amount: nil, skip_separator_index: 0, prevouts: []) raise ArgumentError, 'input_index must be specified.' unless input_index raise ArgumentError, 'does not exist input corresponding to input_index.' if input_index >= inputs.size raise ArgumentError, 'script_pubkey must be specified.' if [:base, :witness_v0].include?(sig_version) && output_script.nil? opts[:amount] = amount if amount opts[:skip_separator_index] = skip_separator_index opts[:sig_version] = sig_version opts[:script_code] = output_script opts[:prevouts] = prevouts opts[:last_code_separator_pos] ||= 0xffffffff sig_hash_gen = SigHashGenerator.load(sig_version) sig_hash_gen.generate(self, input_index, hash_type, opts) end |
#size ⇒ Object
The serialized transaction size
168 169 170 |
# File 'lib/bitcoin/tx.rb', line 168 def size to_payload.bytesize end |
#standard? ⇒ Boolean
check this tx is standard.
145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 |
# File 'lib/bitcoin/tx.rb', line 145 def standard? return false if version > MAX_STANDARD_VERSION return false if weight > MAX_STANDARD_TX_WEIGHT inputs.each do |i| # Biggest 'standard' txin is a 15-of-15 P2SH multisig with compressed keys (remember the 520 byte limit on redeemScript size). # That works out to a (15*(33+1))+3=513 byte redeemScript, 513+1+15*(73+1)+3=1627 # bytes of scriptSig, which we round off to 1650 bytes for some minor future-proofing. # That's also enough to spend a 20-of-20 CHECKMULTISIG scriptPubKey, though such a scriptPubKey is not considered standard. return false if i.script_sig.size > 1650 return false unless i.script_sig.push_only? end data_count = 0 outputs.each do |o| return false unless o.script_pubkey.standard? data_count += 1 if o.script_pubkey.op_return? # TODO add non P2SH multisig relay(permitbaremultisig) return false if o.dust? end return false if data_count > 1 true end |
#to_h ⇒ Object
237 238 239 240 241 242 |
# File 'lib/bitcoin/tx.rb', line 237 def to_h { txid: txid, hash: witness_hash.rhex, version: version, size: size, vsize: vsize, locktime: lock_time, vin: inputs.map(&:to_h), vout: outputs.map.with_index{|tx_out, index| tx_out.to_h.merge({n: index})} } end |
#to_payload ⇒ Object
105 106 107 |
# File 'lib/bitcoin/tx.rb', line 105 def to_payload witness? ? serialize_witness_format : serialize_old_format end |
#tx_hash ⇒ Object
78 79 80 |
# File 'lib/bitcoin/tx.rb', line 78 def tx_hash Bitcoin.double_sha256(serialize_old_format).bth end |
#txid ⇒ Object
82 83 84 |
# File 'lib/bitcoin/tx.rb', line 82 def txid tx_hash.rhex end |
#valid? ⇒ Boolean
Verify transaction validity.
246 247 248 249 250 |
# File 'lib/bitcoin/tx.rb', line 246 def valid? state = Bitcoin::ValidationState.new validation = Bitcoin::Validation.new validation.check_tx(self, state) && state.valid? end |
#verify_input_sig(input_index, script_pubkey, amount: nil, flags: STANDARD_SCRIPT_VERIFY_FLAGS, prevouts: []) ⇒ Boolean
verify input signature.
220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 |
# File 'lib/bitcoin/tx.rb', line 220 def verify_input_sig(input_index, script_pubkey, amount: nil, flags: STANDARD_SCRIPT_VERIFY_FLAGS, prevouts: []) script_sig = inputs[input_index].script_sig has_witness = inputs[input_index].has_witness? if script_pubkey.p2sh? flags << SCRIPT_VERIFY_P2SH redeem_script = Script.parse_from_payload(script_sig.chunks.last) script_pubkey = redeem_script if redeem_script.p2wpkh? end if has_witness verify_input_sig_for_witness(input_index, script_pubkey, amount, flags, prevouts) else verify_input_sig_for_legacy(input_index, script_pubkey, flags) end end |
#vsize ⇒ Object
The virtual transaction size (differs from size for witness transactions)
173 174 175 |
# File 'lib/bitcoin/tx.rb', line 173 def vsize (weight.to_f / 4).ceil end |
#weight ⇒ Object
calculate tx weight weight = (legacy tx payload) * 3 + (witness tx payload)
179 180 181 182 183 184 185 |
# File 'lib/bitcoin/tx.rb', line 179 def weight if witness? serialize_old_format.bytesize * (WITNESS_SCALE_FACTOR - 1) + serialize_witness_format.bytesize else serialize_old_format.bytesize * WITNESS_SCALE_FACTOR end end |
#witness? ⇒ Boolean
113 114 115 |
# File 'lib/bitcoin/tx.rb', line 113 def witness? !inputs.find { |i| !i.script_witness.empty? }.nil? end |
#witness_commitment ⇒ Object
get the witness commitment of coinbase tx. if this tx does not coinbase or not have commitment, return nil.
96 97 98 99 100 101 102 103 |
# File 'lib/bitcoin/tx.rb', line 96 def witness_commitment return nil unless coinbase_tx? outputs.each do |output| commitment = output.script_pubkey.witness_commitment return commitment if commitment end nil end |
#witness_hash ⇒ Object
86 87 88 |
# File 'lib/bitcoin/tx.rb', line 86 def witness_hash Bitcoin.double_sha256(to_payload).bth end |
#witness_payload ⇒ Object
140 141 142 |
# File 'lib/bitcoin/tx.rb', line 140 def witness_payload inputs.map { |i| i.script_witness.to_payload }.join end |
#wtxid ⇒ Object
90 91 92 |
# File 'lib/bitcoin/tx.rb', line 90 def wtxid witness_hash.rhex end |