Class: Bitcoin::Protocol::Version

Inherits:
Object
  • Object
show all
Defined in:
lib/bitcoin/protocol/version.rb

Overview

en.bitcoin.it/wiki/Protocol_specification#version

Constant Summary collapse

NODE_NETWORK =

services bit constants

(1 << 0)

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(opts = {}) ⇒ Version

Returns a new instance of Version.



13
14
15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/bitcoin/protocol/version.rb', line 13

def initialize(opts={})
  @fields = {
    :version    => Bitcoin.network[:protocol_version],
    :services   => NODE_NETWORK,
    :time       => Time.now.tv_sec,
    :from       => "127.0.0.1:8333",
    :to         => "127.0.0.1:8333",
    :nonce      => Bitcoin::Protocol::Uniq,
    :user_agent => "/bitcoin-ruby:#{Bitcoin::VERSION}/",
    :last_block => 0, # 188617
    :relay      => true # BIP0037
  }.merge( opts.reject{|k,v| v == nil } )
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(*a) ⇒ Object 



81
 
# File 'lib/bitcoin/protocol/version.rb', line 81

def method_missing(*a); (@fields[a.first] rescue nil) or super(*a); end

Instance Attribute Details

#fields ⇒ Object (readonly)

Returns the value of attribute fields.



11
12
13
 
# File 'lib/bitcoin/protocol/version.rb', line 11

def fields
  @fields
end

Class Method Details

.parse(payload) ⇒ Object 



83
 
# File 'lib/bitcoin/protocol/version.rb', line 83

def self.parse(payload); new.parse(payload); end

Instance Method Details

#pack_address_field(addr_str) ⇒ Object 



63
64
65
66
67
68
69
70
 
# File 'lib/bitcoin/protocol/version.rb', line 63

def pack_address_field(addr_str)
  host, port = addr_str.split(":")
  port = port ? port.to_i : 8333
  sockaddr = Socket.pack_sockaddr_in(port, host)
  #raise "invalid IPv4 Address: #{addr}" unless sockaddr[0...2] == "\x02\x00"
  port, host = sockaddr[2...4], sockaddr[4...8]
  [[1].pack("Q"), "\x00"*10, "\xFF\xFF",  host, port].join
end

#parse(payload) ⇒ Object 



43
44
45
46
47
48
49
50
51
52
53
54
55
56
 
# File 'lib/bitcoin/protocol/version.rb', line 43

def parse(payload)
  version, services, timestamp, to, from, nonce, payload = payload.unpack("VQQa26a26Qa*")
  to, from = unpack_address_field(to), unpack_address_field(from)
  user_agent, payload = Protocol.unpack_var_string(payload)
  last_block, payload = payload.unpack("Va*")
  relay, payload = unpack_relay_field(version, payload)

  @fields = {
   :version => version, :services => services, :time => timestamp,
   :from => from, :to => to, :nonce => nonce,
   :user_agent => user_agent.to_s, :last_block => last_block, :relay => relay
  }
  self
end

#to_payload ⇒ Object 



27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/bitcoin/protocol/version.rb', line 27

def to_payload
  payload = [
    @fields.values_at(:version, :services, :time).pack("VQQ"),
    pack_address_field(@fields[:from]),
    pack_address_field(@fields[:to]),
    @fields.values_at(:nonce).pack("Q"),
    Protocol.pack_var_string(@fields[:user_agent]),
    @fields.values_at(:last_block).pack("V"),
    Protocol.pack_boolean(@fields[:relay]) # Satoshi 0.8.6 doesn't send this but it does respect it
  ].join
end

#to_pkt ⇒ Object 



39
40
41
 
# File 'lib/bitcoin/protocol/version.rb', line 39

def to_pkt
  Bitcoin::Protocol.pkt("version", to_payload)
end

#unpack_address_field(payload) ⇒ Object 



58
59
60
61
 
# File 'lib/bitcoin/protocol/version.rb', line 58

def unpack_address_field(payload)
  ip, port = payload.unpack("x8x12a4n")
  "#{ip.unpack("C*").join(".")}:#{port}"
end

#unpack_relay_field(version, payload) ⇒ Object

BIP0037: this field starts with version 70001 and is allowed to be missing, defaults to true



73
74
75
 
# File 'lib/bitcoin/protocol/version.rb', line 73

def unpack_relay_field(version, payload)
  ( version >= 70001 and payload ) ? Protocol.unpack_boolean(payload) : [ true, nil ]
end

#uptime ⇒ Object 



77
78
79
 
# File 'lib/bitcoin/protocol/version.rb', line 77

def uptime
  @fields[:time] - Time.now.tv_sec
end