Class: Coinbase::Transaction

Inherits:
Object
  • Object
show all
Defined in:
lib/coinbase/transaction.rb

Overview

A representation of an onchain Transaction. Transactions should be constructed via higher level abstractions like Trade or Transfer.

Defined Under Namespace

Modules: Status

Instance Method Summary collapse

Constructor Details

#initialize(model) ⇒ Transaction

Returns a new Transaction object. Do not use this method directly.



35
36
37
38
39
 
# File 'lib/coinbase/transaction.rb', line 35

def initialize(model)
  raise unless model.is_a?(Coinbase::Client::Transaction)

  @model = model
end

Instance Method Details

#from_address_id ⇒ String

Returns the from address for the Transaction.



67
68
69
 
# File 'lib/coinbase/transaction.rb', line 67

def from_address_id
  @model.from_address_id
end

#inspect ⇒ String

Same as to_s.



148
149
150
 
# File 'lib/coinbase/transaction.rb', line 148

def inspect
  to_s
end

#raw ⇒ Eth::Tx::Eip1559

Returns the underlying raw transaction.



91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/coinbase/transaction.rb', line 91

def raw
  return @raw unless @raw.nil?

  # If the transaction is signed, decode the signed payload.
  unless signed_payload.nil?
    @raw = Eth::Tx::Eip1559.decode(signed_payload)

    return @raw
  end

  # If the transaction is unsigned, parse the unsigned payload into an EIP-1559 transaction.
  raw_payload = [unsigned_payload].pack('H*')
  parsed_payload = JSON.parse(raw_payload)

  params = {
    chain_id: parsed_payload['chainId'].to_i(16),
    nonce: parsed_payload['nonce'].to_i(16),
    priority_fee: parsed_payload['maxPriorityFeePerGas'].to_i(16),
    max_gas_fee: parsed_payload['maxFeePerGas'].to_i(16),
    gas_limit: parsed_payload['gas'].to_i(16), # TODO: Handle multiple currencies.
    from: from_address_id,
    to: parsed_payload['to'],
    value: parsed_payload['value'].to_i(16),
    data: parsed_payload['input'] || ''
  }

  @raw = Eth::Tx::Eip1559.new(Eth::Tx.validate_eip1559_params(params))
end

#sign(key) ⇒ String

Signs the Transaction with the provided key and returns the hex signing payload.



128
129
130
131
132
 
# File 'lib/coinbase/transaction.rb', line 128

def sign(key)
  raw.sign(key)

  signature
end

#signature ⇒ String

Returns the signature of the Transaction.



122
123
124
 
# File 'lib/coinbase/transaction.rb', line 122

def signature
  raw.hex
end

#signed? ⇒ Boolean

Returns whether the Transaction has been signed.



136
137
138
 
# File 'lib/coinbase/transaction.rb', line 136

def signed?
  Eth::Tx.signed?(raw)
end

#signed_payload ⇒ String

Returns the Signed Payload of the Transaction.



49
50
51
 
# File 'lib/coinbase/transaction.rb', line 49

def signed_payload
  @model.signed_payload
end

#status ⇒ Symbol

Returns the status of the Transaction.



61
62
63
 
# File 'lib/coinbase/transaction.rb', line 61

def status
  @model.status
end

#terminal_state? ⇒ Boolean

Returns whether the Transaction is in a terminal state.



79
80
81
 
# File 'lib/coinbase/transaction.rb', line 79

def terminal_state?
  Status::TERMINAL_STATES.include?(status)
end

#to_address_id ⇒ String

Returns the to address for the Transaction.



73
74
75
 
# File 'lib/coinbase/transaction.rb', line 73

def to_address_id
  @model.to_address_id
end

#to_s ⇒ String

Returns a String representation of the Transaction.



142
143
144
 
# File 'lib/coinbase/transaction.rb', line 142

def to_s
  "Coinbase::Transaction{transaction_hash: '#{transaction_hash}', status: '#{status}'}"
end

#transaction_hash ⇒ String

Returns the Transaction Hash of the Transaction.



55
56
57
 
# File 'lib/coinbase/transaction.rb', line 55

def transaction_hash
  @model.transaction_hash
end

#transaction_link ⇒ String

Returns the link to the transaction on the blockchain explorer.



85
86
87
 
# File 'lib/coinbase/transaction.rb', line 85

def transaction_link
  @model.transaction_link
end

#unsigned_payload ⇒ String

Returns the Unsigned Payload of the Transaction.



43
44
45
 
# File 'lib/coinbase/transaction.rb', line 43

def unsigned_payload
  @model.unsigned_payload
end