digix-eth 0.5.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e1f6ccef908b6195cb0a013fbb2a171bdb438373
+  data.tar.gz: 4c5c7cc1e908f9ee021c66e20e45ed0d43eb3ffb
+SHA512:
+  metadata.gz: 36109816da149cb1b7cc9168f4f628108992b0e7c17cb1a9af37b65e6db7c8735b76ff37b7111c18506755d849ae4d52a8e5b4814249e8672a3984d99c351202
+  data.tar.gz: d306ac7fe45c2db63be3c2b1399abd7bc3f3509af2b606382eebc76cbb3b805559e33b9edcd23c2cf124bab1184e92da85d1b25b8cee1434d05536b33b3bf6ad

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.ruby-version

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "spec/fixtures/ethereum_tests"]
+	path = spec/fixtures/ethereum_tests
+	url = https://github.com/ethereum/tests

data/.rspec

@@ -0,0 +1,4 @@
+--require pry
+--require spec_helper
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,7 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.2.0
+  - 2.3.0
+  - 2.4.0
+before_install: gem install bundler -v 1.12.3

data/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Change Log
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## [Unreleased]
+
+## [0.4.3]
+
+### Added
+- Eth::Key::Encrypter class to handle encrypting keys.
+- Eth::Key.encrypt as a nice wrapper around Encrypter class.
+- Eth::Key::Decrypter class to handle encrypting keys.
+- Eth::Key.decrypt as a nice wrapper around Decrypter class.
+
+## [0.4.2]
+
+### Added
+- Address#valid? to validate EIP55 checksums.
+- Address#checksummed to generate EIP55 checksums.
+- Utils.valid_address? to easily validate EIP55 checksums.
+- Utils.format_address to easily convert an address to EIP55 checksummed.
+
+### Changed
+- Dependencies no longer include Ethereum::Base. Eth now implements those helpers directly and includes ffi, digest-sha3, and rlp directly.
+
+
+## [0.4.1]
+
+### Changed
+- Tx#hash includes the '0x' hex prefix.
+
+## [0.4.0]
+
+### Added
+- Tx#data_bin returns the data field of a transaction in binary.
+- Tx#data_hex returns the data field of a transaction as a hexadecimal string.
+- Tx#id is an alias of Tx#hash
+
+### Changed
+- Tx#data is configurable to return either hex or binary: `config.tx_data_hex = true`.
+- Tx#hex includes the '0x' hex prefix.
+- Key#address getter is prepended by '0x'.
+- Extract public key to address method into Utils.public_key_to_address.
+- Tx#from returns an address instead of a public key.
+- Chain ID is updated to the later version of the spec.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ethereum-tx.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Steve Ellis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,141 @@
+# Eth [![Travis-CI](https://travis-ci.org/se3000/ruby-eth.svg?branch=master)](https://travis-ci.org/se3000/ruby-eth) [![Code Climate](https://codeclimate.com/github/se3000/ruby-eth/badges/gpa.svg)](https://codeclimate.com/github/se3000/ruby-eth) [![Gitter](https://badges.gitter.im/ruby-eth/Lobby.svg)](https://gitter.im/ruby-eth/Lobby)
+
+A simple library to build and sign Ethereum transactions. Allows separataion of key and node management. Sign transactions and handle keys anywhere you can run ruby, boradcast transactions through any node.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'eth'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install eth
+
+## Usage
+
+### Keys
+Create a new public/private key and get its address:
+```ruby
+key = Eth::Key.new
+key.private_hex
+key.public_hex
+key.address # EIP55 checksummed address
+```
+Import an existing key:
+```ruby
+old_key = Eth::Key.new priv: private_key
+```
+Or decrypt an [encrypted key](https://github.com/ethereum/wiki/wiki/Web3-Secret-Storage-Definition):
+```ruby
+decrypted_key = Eth::Key.decrypt File.read('./some/path.json'), 'p455w0rD'
+```
+You can also encrypt your keys for use with other ethereum libraries:
+```ruby
+encrypted_key_info = Eth::Key.encrypt key, 'p455w0rD'
+```
+
+### Transactions
+
+Build a transaction from scratch:
+```ruby
+tx = Eth::Tx.new({
+  data: hex_data,
+  gas_limit: 21_000,
+  gas_price: 3_141_592,
+  nonce: 1,
+  to: key2.address,
+  value: 1_000_000_000_000,
+})
+```
+Or decode an encoded raw transaction:
+```ruby
+tx = Eth::Tx.decode hex
+```
+
+Then sign the transaction:
+```ruby
+tx.sign key
+```
+Get the raw transaction with `tx.hex`, and broadcast it through any Ethereum node. Or, just get the TXID with `tx.hash`.
+
+### Utils
+
+Validate an [EIP55](https://github.com/ethereum/EIPs/issues/55) checksummed address:
+```ruby
+Eth::Utils.valid_address? address
+```
+
+Or add a checksum to an existing address:
+```ruby
+Eth::Utils.format_address "0x4bc787699093f11316e819b5692be04a712c4e69" # => "0x4bc787699093f11316e819B5692be04A712C4E69"
+```
+
+### HD Vaults
+
+This branch adds HD wallet functionality which can be seeded with Trezor style mnemonic words.
+
+```ruby
+# Create a new vault
+v = Eth::Vault.new
+key = v.get_key(1) 
+
+# Restore a vault from a mnemonic
+v = Eth::Vault.new(secret_seed_phrase: "trouble mesh impact indoor inquiry aim index deposit weekend alter pottery chef eye page elder awesome paper sport arch illegal muscle another blossom arctic")
+key = v.get_key(2)
+
+# Specify an HD Root Path (see: https://github.com/ethereum/EIPs/issues/84)
+
+v = Eth::Vault.new({secret_seed_phrase: "trouble mesh impact indoor inquiry aim index deposit weekend alter pottery chef eye page elder awesome paper sport arch illegal muscle another blossom arctic"}, "m/44'/60'/0'/0/0")
+key = v.get_key
+
+```
+
+### web3.eth.sign functionality
+
+You can sign arbitrary messages which can be verified on the EVM using ecrecover.  
+
+```
+v = Eth::Vault.new
+signer = Eth::RpcSigner.new(v.get_key)
+a = signer.sign_message('foobar')
+```
+
+### Configure
+In order to prevent replay attacks, you must specify which Ethereum chain your transactions are created for. See [EIP 155](https://github.com/ethereum/EIPs/issues/155) for more detail.
+```ruby
+Eth.configure do |config|
+  config.chain_id = 1 # nil by default, meaning valid on any chain
+end
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/se3000/ethereum-tx. Tests are encouraged.
+
+### Tests
+
+First install the [Ethereum common tests](https://github.com/ethereum/tests):
+```shell
+git submodule update --init
+```
+
+Then run the associated tests:
+```shell
+rspec
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+
+## TODO
+- Better test suite.
+- Expose API for HD keys.
+- Support signing with [libsecp256k1](https://github.com/bitcoin-core/secp256k1).

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Open an irb session preloaded with this library"
+task :console do
+    sh "irb -rubygems -I lib -r eth.rb"
+end
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "eth"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/eth.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'eth/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "digix-eth"
+  spec.version       = Eth::VERSION
+  spec.authors       = ["Steve Ellis", "DigixGlobal"]
+  spec.email         = ["email@steveell.is", "support@digix.io"]
+
+  spec.summary       = %q{Simple API to sign Ethereum transactions.}
+  spec.description   = %q{Forked from: github.com/se3000/ruby-eth. Library to build, parse, and sign Ethereum transactions. This forked gem adds additional support for Trezor style mnemonic and RPC signing}
+  spec.homepage      = "https://github.com/digixglobal/ruby-eth"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'digest-sha3', '~> 1.1'
+  spec.add_dependency 'ffi', '~> 1.0'
+  spec.add_dependency 'money-tree', '~> 0.9'
+  spec.add_dependency 'rlp', '~> 0.7.3'
+  spec.add_dependency 'activesupport', '~> 5.1'
+  spec.add_dependency 'bitcoin-ruby', '0.0.11'
+  spec.add_dependency 'rbnacl', '~> 5.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'pry', '~> 0.1'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

data/lib/eth.rb

@@ -0,0 +1,77 @@
+require 'digest/sha3'
+require 'ffi'
+require 'money-tree'
+require 'rlp'
+require 'bitcoin'
+require 'rbnacl'
+require 'active_support'
+require 'active_support/core_ext'
+
+module Eth
+  BYTE_ZERO = "\x00".freeze
+  UINT_MAX = 2**256 - 1
+
+  autoload :Address, 'eth/address'
+  autoload :Gas, 'eth/gas'
+  autoload :Key, 'eth/key'
+  autoload :OpenSsl, 'eth/open_ssl'
+  autoload :Secp256k1, 'eth/secp256k1'
+  autoload :Sedes, 'eth/sedes'
+  autoload :Tx, 'eth/tx'
+  autoload :Utils, 'eth/utils'
+  autoload :Vault, 'eth/vault'
+  autoload :RpcSigner, 'eth/rpc_signer'
+  autoload :Signature, 'eth/signature'
+
+  class << self
+    def configure
+      yield(configuration)
+    end
+
+    def replayable_chain_id
+      27
+    end
+
+    def chain_id
+      configuration.chain_id
+    end
+
+    def v_base
+      if chain_id
+        (chain_id * 2) + 35
+      else
+        replayable_chain_id
+      end
+    end
+
+    def prevent_replays?
+      !chain_id.nil?
+    end
+
+    def replayable_v?(v)
+      [replayable_chain_id, replayable_chain_id + 1].include? v
+    end
+
+    def tx_data_hex?
+      !!configuration.tx_data_hex
+    end
+
+
+    private
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+  end
+
+  class Configuration
+    attr_accessor :chain_id, :tx_data_hex
+
+    def initialize
+      self.tx_data_hex = true
+    end
+  end
+
+  class ValidationError < StandardError; end
+  class InvalidTransaction < ValidationError; end
+end

data/lib/eth/address.rb

@@ -0,0 +1,62 @@
+module Eth
+  class Address
+
+    def initialize(address)
+      @address = Utils.prefix_hex(address)
+    end
+
+    def valid?
+      if !matches_any_format?
+        false
+      elsif not_checksummed?
+        true
+      else
+        checksum_matches?
+      end
+    end
+
+    def checksummed
+      raise "Invalid address: #{address}" unless matches_any_format?
+
+      cased = unprefixed.chars.zip(checksum.chars).map do |char, check|
+        check.match(/[0-7]/) ? char.downcase : char.upcase
+      end
+
+      Utils.prefix_hex(cased.join)
+    end
+
+
+    private
+
+    attr_reader :address
+
+    def checksum_matches?
+      address == checksummed
+    end
+
+    def not_checksummed?
+      all_uppercase? || all_lowercase?
+    end
+
+    def all_uppercase?
+      address.match(/(?:0[xX])[A-F0-9]{40}/)
+    end
+
+    def all_lowercase?
+      address.match(/(?:0[xX])[a-f0-9]{40}/)
+    end
+
+    def matches_any_format?
+      address.match(/\A(?:0[xX])[a-fA-F0-9]{40}\z/)
+    end
+
+    def checksum
+      Utils.bin_to_hex(Utils.keccak256 unprefixed.downcase)
+    end
+
+    def unprefixed
+      Utils.remove_hex_prefix address
+    end
+
+  end
+end