nano_rpc 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19d46c77ad8cab903761e7d507889dfc7e4f446df62f88c9fb4dfbf505f332cc
-  data.tar.gz: f8d400e69bb56c02c9d7ada64fe7dd023a58c24d0c64f99f46e5f3a9211b6c8a
+  metadata.gz: 06caeedce48a1cc0e468ca6f0cc98be0f452759601dfb75d4c706da2685a13d3
+  data.tar.gz: 1293ed07fb6fa65c46d775c950c3c411e8c7d656ba8d8258d179ce69a06a8824
 SHA512:
-  metadata.gz: 1b854f7dec81c5f8d5744f57a45f0e5517ba9dffc5d03d5f4acbb9b46a308415f5eb17be22bd245aa3744c42d39b339d391446a204c8d434b1a650d2eb5ef42b
-  data.tar.gz: 17ffae12a7599c097a46554355af5fb6c6b589308668ac2ebb7922bb16f37238b3b1bfc28abf96600cefccbac2c610d4b3e5713e616544f91586f78875732f02
+  metadata.gz: a5f1ed287ecf01ecade72a3f111dcc68c1e4ce03826632286c675d3621c566199265b07cdb209c9abf9bdc033c45a294524b9fe7e3487015972f31ea50d63f27
+  data.tar.gz: 8556558303db38de3e60f4d8f58297c8f80050039f80ad147daa2b64f02c4339cf25d0278a5014d274541fc51e14373e70da13aba50d024095605e8149de0304

data/README.md

@@ -113,6 +113,16 @@ account.pending_balance
 # => 5
 ```
 
+To convert from Nano to raw and back, use `#to_raw` and `#to_nano`, available on all `Numeric` objects:
+
+```ruby
+4622800482000000000000000000000000.to_nano
+# => 4622.800482
+
+4622.800482.to_raw
+# => 4622800482000000000000000000000000
+```
+
 For a comprehensive guide, see the [Wiki](https://github.com/jcraigk/ruby_nano_rpc/wiki).
 
 ## Credits

data/lib/nano_rpc/errors.rb

@@ -2,10 +2,12 @@
 module NanoRpc
   class Error < StandardError; end
 
-  class NodeConnectionFailure < Error; end
   class BadRequest < Error; end
-  class InvalidRequest < Error; end
   class ForbiddenParameter < Error; end
+  class InvalidNanoAmount < Error; end
+  class InvalidRawAmount < Error; end
+  class InvalidRequest < Error; end
   class MissingParameters < Error; end
+  class NodeConnectionFailure < Error; end
   class NodeOpenTimeout < Error; end
 end

data/lib/nano_rpc/numeric.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+module NanoRpc
+  RAW_FACTOR = 30
+  RAW_PRECISION = 6
+
+  module NanoToRaw
+    def to_raw
+      ensure_valid_nano_amount!
+      (self * 10**RAW_PRECISION).floor *
+        10**(RAW_FACTOR - RAW_PRECISION)
+    end
+
+    private
+
+    def ensure_valid_nano_amount!
+      raise NanoRpc::InvalidNanoAmount unless valid_nano_amount?
+    end
+
+    # 133,248,290 total nano in circulation
+    def valid_nano_amount?
+      self <= 133_248_290
+    end
+  end
+
+  module RawToNano
+    def to_nano
+      ensure_valid_raw_amount!
+      (to_f / 10**RAW_FACTOR).round(RAW_PRECISION)
+    end
+
+    private
+
+    def ensure_valid_raw_amount!
+      raise NanoRpc::InvalidRawAmount unless valid_raw_amount?
+    end
+
+    # Ensure at least 10^23
+    def valid_raw_amount?
+      self >= 100_000_000_000_000_000_000_000
+    end
+  end
+end
+
+class Numeric
+  include NanoRpc::NanoToRaw
+  include NanoRpc::RawToNano
+end

data/lib/nano_rpc/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module NanoRpc
-  VERSION = '0.11.0'
+  VERSION = '0.12.0'
 end

data/lib/nano_rpc.rb

@@ -11,6 +11,7 @@ require 'nano_rpc/proxy'
 require 'nano_rpc/node'
 require 'nano_rpc/errors'
 require 'nano_rpc/response'
+require 'nano_rpc/numeric'
 require 'nano_rpc/proxies/account'
 require 'nano_rpc/proxies/accounts'
 require 'nano_rpc/proxies/wallet'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nano_rpc
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Justin Craig-Kuhn (JCK)
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-06-03 00:00:00.000000000 Z
+date: 2018-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -173,6 +173,7 @@ files:
 - lib/nano_rpc/helpers/node_helper.rb
 - lib/nano_rpc/helpers/wallet_helper.rb
 - lib/nano_rpc/node.rb
+- lib/nano_rpc/numeric.rb
 - lib/nano_rpc/proxies/account.rb
 - lib/nano_rpc/proxies/accounts.rb
 - lib/nano_rpc/proxies/wallet.rb