stellar-base 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d1f8db8c0eef99ea37838371a5718d8ab6df3e0d
-  data.tar.gz: 3170f3c49015a46b0d8337769ea1672194d4f584
+  metadata.gz: dd816d7bbac1d2b4938046e55db9545824e94d00
+  data.tar.gz: af0d72500eed2bd454006f77148714ca228bfccf
 SHA512:
-  metadata.gz: c4ce937a9b9ac9c8b14c1cd8b8557182e1d24c3e6c3d432801c8109fb5df8f3b0b7bb909352368d01cbd67d4d75b46a67495a5e93be274d95aafbbd3a5c76cff
-  data.tar.gz: 632997ffa01f3bf3d380aabb2b56553cbfba65cd74b92af20bd896f054c54f59ec070238d3aca36739a4937106b9fa1c6cc13e31b36e74f0fe5b386d40fc723d
+  metadata.gz: f571ed6a5bb220ec0eb34f056e0642a6441a02e889f113217ba5c08e66848ad281f15d99fc9812fe7b89094287e3df04c132367af08acfabcae9d644eb58ef84
+  data.tar.gz: da9dd38df4f482aca38610469e73ab5d5f3f60d2992b9454abc86ce0dcbdf33fc3b3eb87ca9195aab1865612937a65db61dbf9ae94442204bbbdf64560dc0531

data/lib/stellar-base.rb

@@ -29,3 +29,4 @@ require_relative './stellar/transaction_envelope'
 require_relative './stellar/util/strkey'
 require_relative './stellar/util/continued_fraction'
 require_relative './stellar/convert'
+require_relative './stellar/networks'

data/lib/stellar/base/version.rb

@@ -1,5 +1,5 @@
 module Stellar
   module Base
-    VERSION = "0.2.0"
+    VERSION = "0.3.0"
   end
 end

data/lib/stellar/key_pair.rb

@@ -27,8 +27,13 @@ module Stellar
       new(public_key, secret_key)
     end
 
+    def self.from_network_passphrase(passphrase)
+      network_id = Digest::SHA256.digest(passphrase)
+      from_raw_seed network_id
+    end
+
     def self.master
-      from_raw_seed("allmylifemyhearthasbeensearching")
+      from_raw_seed(Stellar.current_network_id)
     end
 
     def initialize(public_key, secret_key=nil)

data/lib/stellar/networks.rb

@@ -0,0 +1,45 @@
+module Stellar
+  # Provides a container for well-known network passphrases, such as the main network and SDF test network
+  module Networks
+
+    PUBLIC  = "Public Global Stellar Network ; September 2015"
+    TESTNET = "Test SDF Network ; September 2015"
+
+  end
+
+  # Configures the default stellar network passphrase for the current process.  Unless otherwise
+  # specified in a method that needs the passphrase, this value will be used.
+  #
+  # NOTE:  This method is not thread-safe.  It's best to just call this at startup once and use the other
+  #        methods of specifying a network if you need two threads in the same process to communicate with
+  #        different networks
+  #
+  # @see Stellar.default_network
+  # @see Stellar.on_network
+  def self.default_network=(passphrase)
+    @default_network = passphrase
+  end
+
+  # Returns the passphrase for the currently-configured network, as set by Stellar.default_network
+  # or Stellar.on_network
+  def self.current_network
+    Thread.current["stellar_network_passphrase"] || 
+    @default_network || 
+    Stellar::Networks::PUBLIC
+  end
+
+  # Returns the id for the currently configured network, suitable for use in generating
+  # a signature base string or making the root account's keypair.
+  def self.current_network_id
+    Digest::SHA256.digest(self.current_network) 
+  end
+
+  # Executes the provided block in the context of the provided network.
+  def self.on_network(passphrase, &block)
+    old = Thread.current["stellar_network_passphrase"]
+    Thread.current["stellar_network_passphrase"] = passphrase
+    block.call
+  ensure
+    Thread.current["stellar_network_passphrase"] = old
+  end
+end

data/lib/stellar/transaction.rb

@@ -126,7 +126,8 @@ module Stellar
 
     def signature_base_prefix
       val = Stellar::EnvelopeType.envelope_type_tx
-      Stellar::EnvelopeType.to_xdr(val)
+
+      Stellar.current_network_id + Stellar::EnvelopeType.to_xdr(val)
     end
 
     def to_envelope(*key_pairs)

data/spec/lib/stellar/key_pair_spec.rb

@@ -101,6 +101,14 @@ describe Stellar::KeyPair do
     end
   end
 
+  describe ".master" do
+    subject{ Stellar::KeyPair.master }
+
+    it "returns a keypair whose raw_seed is the current_network_id" do
+      expect(subject.raw_seed).to eql(Stellar.current_network_id)
+    end
+  end
+
   describe "#raw_public_key" do
     let(:key_pair){ Stellar::KeyPair.random }
     subject{ key_pair.raw_public_key }

data/spec/lib/stellar/networks_spec.rb

@@ -0,0 +1,77 @@
+require "spec_helper"
+
+describe Stellar, ".default_network=" do
+
+  before(:each){ Stellar.default_network = "foo" }
+  after(:each){ Stellar.default_network = nil }
+
+  it "sets the value returned by current_network " do
+    expect(Stellar.current_network).to eql("foo")
+  end
+
+end
+
+describe Stellar, ".current_network" do
+
+  after(:each){ Stellar.default_network = nil }
+
+  it "returns the public network absent any other configuration" do
+    expect(Stellar.current_network).to eql(Stellar::Networks::PUBLIC)
+  end
+
+  it "returns the default network if configured and not within a call to on_network" do
+    Stellar.default_network = "foo"
+    expect(Stellar.current_network).to eql("foo")
+  end
+
+  it "returns the network as specified by on_network, even when a default is set" do
+    Stellar.default_network = "foo"
+
+    Stellar.on_network "bar" do
+      expect(Stellar.current_network).to eql("bar")
+    end
+
+    expect(Stellar.current_network).to eql("foo")
+  end
+end
+
+describe Stellar, ".current_network_id" do
+  it "returns the sha256 of the current_network" do
+    expect(Stellar.current_network_id).to eql(Digest::SHA256.digest(Stellar.current_network))
+  end
+end
+
+describe Stellar, ".on_network" do
+
+  after(:each){ Thread.current["stellar_network_passphrase"] = nil }
+
+
+  it "sets the current_network and a thread local" do
+    Stellar.on_network "bar" do
+      expect(Stellar.current_network).to eql("bar")
+      expect(Thread.current["stellar_network_passphrase"]).to eql("bar")
+    end
+  end
+
+
+  it "nests" do
+    Stellar.on_network "foo" do
+      expect(Stellar.current_network).to eql("foo")
+      Stellar.on_network "bar" do
+        expect(Stellar.current_network).to eql("bar")
+      end
+      expect(Stellar.current_network).to eql("foo")
+    end
+  end
+
+
+  it "resets the network value when an error is raised" do
+    begin
+      Stellar.on_network "foo" do
+        raise "kablow"
+      end
+    rescue
+      expect(Stellar.current_network).to_not eql("foo")
+    end
+  end
+end

data/spec/lib/stellar/transaction_spec.rb

@@ -39,4 +39,16 @@ describe Stellar::Transaction do
       expect(result.signatures.first.signature).to eq(subject.sign(key_pair))
     end
   end
+
+  describe "#signature_base" do
+
+    it "is prefixed with the current network id" do
+      expect(subject.signature_base).to start_with(Stellar.current_network_id)
+    end
+
+    it "includes the envelope type" do
+      expect(subject.signature_base[32...36]).to eql("\x00\x00\x00\x02")
+    end
+
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stellar-base
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Scott Fleckenstein
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-31 00:00:00.000000000 Z
+date: 2015-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xdr
@@ -366,6 +366,7 @@ files:
 - lib/stellar/base/version.rb
 - lib/stellar/convert.rb
 - lib/stellar/key_pair.rb
+- lib/stellar/networks.rb
 - lib/stellar/operation.rb
 - lib/stellar/path_payment_result.rb
 - lib/stellar/price.rb
@@ -379,6 +380,7 @@ files:
 - spec/lib/stellar/asset_spec.rb
 - spec/lib/stellar/convert_spec.rb
 - spec/lib/stellar/key_pair_spec.rb
+- spec/lib/stellar/networks_spec.rb
 - spec/lib/stellar/path_payment_result_spec.rb
 - spec/lib/stellar/price_spec.rb
 - spec/lib/stellar/thresholds_spec.rb
@@ -428,6 +430,7 @@ test_files:
 - spec/lib/stellar/asset_spec.rb
 - spec/lib/stellar/convert_spec.rb
 - spec/lib/stellar/key_pair_spec.rb
+- spec/lib/stellar/networks_spec.rb
 - spec/lib/stellar/path_payment_result_spec.rb
 - spec/lib/stellar/price_spec.rb
 - spec/lib/stellar/thresholds_spec.rb