etherscan 0.0.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 22e4fa7464ac88fdc505706394490429a1edbfe8
+  data.tar.gz: 8b88fcd489a48748b35faa0da2be5f9a69f0e38b
+SHA512:
+  metadata.gz: ec04cb7c4cf8e97219b4e7d9702d2e1c40ce540d4fed234c6470f947fdf7426f1f0170ede8f0538b762a122ab8e4f8d4c3b3eaaea99c2cb27afc231dd6f713a3
+  data.tar.gz: 9da44af52fe95171f91d1675360046e12b6f0f7074b55db385f98a11d870ab821b97641390ca96516bb59183cbbc3e3b2a188a650abbc8d2f76fe9dab10c4e5b

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+.idea

data/Gemfile

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

data/README.md

@@ -0,0 +1,17 @@
+# etherscan
+
+Access to the API of etherscan.io and the ethereum blockchain
+
+Forked from: https://github.com/sebs/etherscanio-rb
+
+## Installation
+
+etherscanio is published to rubygems.
+
+Dpl requires ruby with a version greater than 1.9.3
+  * To install: gem install etherscanio
+
+
+## Work in Progress
+
+Neither is is this stable, nor secure. Although all releases will be going through rubygems.

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'yard-ghpages'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task test: :spec
+task default: :spec
+
+Yard::GHPages::Tasks.install_tasks

data/etherscan.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'etherscan'
+  spec.version       = '0.0.6'
+  spec.authors       = ['wuminzhe']
+  spec.email         = ['wuminzhe@gmail.com']
+  spec.description   = '%q{Forked from: https://github.com/sebs/etherscanio-rb. 3rd party using to the API at etherscan.io}'
+  spec.summary       = '3rd party using to the API at etherscan.io'
+  spec.homepage      = 'https://github.com/wuminzhe/etherscanio-rb'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.extra_rdoc_files = ['README.md']
+
+  spec.add_dependency 'rest-client'
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'guard'
+  spec.add_development_dependency 'guard-rspec'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'guard-rubocop'
+  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'yard'
+  spec.add_development_dependency 'yard-ghpages'
+end

data/lib/etherscan.rb

@@ -0,0 +1,10 @@
+require 'rest-client'
+require 'logger'
+require 'etherscan/call'
+require 'etherscan/api'
+
+module Etherscan
+  class << self
+    attr_accessor :logger
+  end
+end

data/lib/etherscan/api.rb

@@ -0,0 +1,139 @@
+module Etherscan
+  class << self
+    attr_accessor :api_key, :chain
+  end
+
+  module Account
+    class << self
+      def txlist(address, startblock, endblock, sort = 'desc', page = nil, offset = nil)
+        call = Etherscan::Call.new(Etherscan.chain, 'account', 'txlist')
+        call.api_key = Etherscan.api_key
+        call.address = address
+        call.startblock = startblock
+        call.endblock = endblock
+        call.page = page
+        call.offset = offset
+        call.sort = sort
+        call.fetch
+      end
+  
+      def txlistinternal(address, startblock, endblock, sort = 'desc', page = nil, offset = nil)
+        call = Etherscan::Call.new(Etherscan.chain, 'account', 'txlistinternal')
+        call.api_key = Etherscan.api_key
+        call.address = address
+        call.startblock = startblock
+        call.endblock = endblock
+        call.page = page
+        call.offset = offset
+        call.sort = sort
+        call.fetch
+      end
+  
+      def txlistinternal_txhash(txhash)
+        call = Etherscan::Call.new(Etherscan.chain, 'account', 'txlistinternal')
+        call.api_key = Etherscan.api_key
+        call.txhash = txhash
+        call.fetch
+      end
+  
+      def balance(address, tag)
+        call = Etherscan::Call.new(Etherscan.chain, 'account', 'balance')
+        call.api_key = Etherscan.api_key
+        call.address = address
+        call.tag = tag
+        call.fetch
+      end
+  
+      def getminedblocks(address, blocktype, page = nil, offset = nil)
+        call = Etherscan::Call.new(Etherscan.chain, 'account', 'getminedblocks')
+        call.api_key = Etherscan.api_key
+        call.page = page
+        call.offset = offset
+        call.address = address
+        call.blocktype = blocktype
+        call.fetch
+      end
+  
+      def balancemulti(address, tag)
+        call = Etherscan::Call.new(Etherscan.chain, 'account', 'balancemulti')
+        call.api_key = Etherscan.api_key
+        call.address = address
+        call.tag = tag
+        call.fetch
+      end
+    end
+  end
+
+  module Contract
+    class << self
+      def getabi(address)
+        call = Etherscan::Call.new(Etherscan.chain, 'contract', 'getabi')
+        call.api_key = Etherscan.api_key
+        call.address = address
+        call.fetch
+      end
+    end
+  end
+
+  module Transaction
+    class << self
+      def getstatus(txhash)
+        call = Etherscan::Call.new(Etherscan.chain, 'transaction', 'getstatus')
+        call.api_key = Etherscan.api_key
+        call.txhash = txhash
+        call.fetch
+      end
+    end
+  end
+
+  module Block
+    class << self
+      def getblockreward(blockno)
+        call = Etherscan::Call.new(Etherscan.chain, 'block', 'getblockreward')
+        call.api_key = Etherscan.api_key
+        call.blockno = blockno
+        call.fetch
+      end
+    end
+  end
+
+  module Proxy
+    class << self
+      def eth_block_number
+        call = Etherscan::Call.new(Etherscan.chain, 'proxy', 'eth_blockNumber')
+        call.api_key = Etherscan.api_key
+        call.fetch
+      end
+
+      def eth_get_block_by_number(tag, boolean)
+        call = Etherscan::Call.new(Etherscan.chain, 'proxy', 'eth_getBlockByNumber')
+        call.api_key = Etherscan.api_key
+        call.tag = tag
+        call.boolean = boolean
+        call.fetch
+      end
+
+      def eth_send_raw_transaction(hex)
+        call = Etherscan::Call.new(Etherscan.chain, 'proxy', 'eth_sendRawTransaction')
+        call.api_key = Etherscan.api_key
+        call.hex = hex
+        call.fetch
+      end
+
+      def eth_get_transaction_count(address, tag)
+        call = Etherscan::Call.new(Etherscan.chain, 'proxy', 'eth_getTransactionCount')
+        call.api_key = Etherscan.api_key
+        call.address = address
+        call.tag = tag
+        call.fetch
+      end
+
+      def eth_get_transaction_by_hash(txhash)
+        call = Etherscan::Call.new(Etherscan.chain, 'proxy', 'eth_getTransactionByHash')
+        call.api_key = Etherscan.api_key
+        call.txhash = txhash
+        call.fetch
+      end
+    end
+  end
+end

data/lib/etherscan/call.rb

@@ -0,0 +1,81 @@
+require 'rest-client'
+module Etherscan
+  class ReturnError < RuntimeError; end
+
+  class Call
+    attr_accessor :chain,
+                  :mod,
+                  :action,
+                  :api_key,
+                  :address,
+                  :tag,
+                  :startblock,
+                  :endblock,
+                  :sort,
+                  :page,
+                  :offset,
+                  :sort,
+                  :blocktype,
+                  :txhash,
+                  :blockno,
+                  :hex,
+                  :boolean
+
+    CHAINS = {
+      mainnet: 'http://api.etherscan.io/api?',
+      ropsten: 'https://ropsten.etherscan.io/api?',
+      kovan: 'https://kovan.etherscan.io/api?',
+      rinkeby: 'https://rinkeby.etherscan.io/api?'
+    }
+
+    def initialize(chain, mod, action)
+      @chain = chain.to_sym
+      @base = CHAINS[chain.to_sym]
+      @mod = mod
+      @action = action
+      @api_key = false
+    end
+
+    def fetch
+      query_url = to_s
+      Etherscan.logger.debug query_url
+      res = RestClient.get(query_url, {}).body
+      Etherscan.logger.debug res
+      data = JSON.parse(res)
+      return [:error, data['error']] if data['error']
+      return [:error, data['message']] if (data['status'] && data['status'] != '1')
+      return [:ok, data['result']]
+    rescue => e
+      Etherscan.logger.error "Error: #{e}"
+      Etherscan.logger.error e.backtrace[0, 20].join("\n")
+      return [:error, e.message]
+    end
+
+    def to_s
+      uri = 'module=' + mod + '&action=' + action
+      uri += '&apikey=' + api_key if api_key
+      uri += address_fragment
+      uri += '&startblock=' + startblock.to_s if startblock
+      uri += '&endblock=' + endblock.to_s if endblock
+      uri += '&blocktype=' + blocktype if blocktype
+      uri += '&txhash=' + txhash if txhash
+      uri += '&blockno=' + blockno.to_s if blockno
+      uri += '&offset=' + offset.to_s if offset
+      uri += '&sort=' + sort if sort
+      uri += '&page=' + page.to_s if page
+      uri += '&tag=' + tag if tag
+      uri += '&hex=' + hex if hex
+      uri += '&boolean=' + boolean if boolean
+      @base + uri
+    end
+
+    private
+
+    def address_fragment
+      res = ''
+      res += '&address=' + address if (address && !address.is_a?(Array))
+      res += '&address=' + address.join(',') if (address && address.is_a?(Array))
+      res
+    end
+  end
+end

data/spec/api/account/balance_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Etherscanio::Api do
+  describe 'account_balance' do
+    subject { Etherscanio::Api.new(apikey).account_balance(address, tag) }
+
+    context 'one address' do
+      subject { Etherscanio::Api.new(apikey).account_balance(address, tag) }
+      let(:apikey) { 'YourApiKeyToken' }
+      let(:address) { '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' }
+      let(:tag) { 'latest' }
+      it { is_expected.to be_a(Object) }
+    end
+  end
+end

data/spec/api/account/balancemulti_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe Etherscanio::Api do
+  describe 'account_balancemulti' do
+
+    context 'multiple address' do
+      subject { Etherscanio::Api.new(apikey).account_balancemulti(address, tag) }
+      let(:apikey) { 'YourApiKeyToken' }
+      let(:address) do
+        %w(
+          0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a
+          0x63a9975ba31b0b9626b34300f7f627147df1f526
+          0x198ef1ec325a96cc354c7266a038be8b5c558f67
+        )
+      end
+      let(:tag) { 'latest' }
+      it { is_expected.to be_a(Object) }
+    end
+
+  end
+end

data/spec/api/account/getminedblocks_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Etherscanio::Api do
+  describe 'account_getminedblocks' do
+    subject { Etherscanio::Api.new(apikey).account_getminedblocks(address, blocktype) }
+
+    context 'no paging' do
+      let(:apikey) { 'YourApiKeyToken' }
+      let(:address) { '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' }
+      let(:blocktype) { 'block' }
+      it { is_expected.to be_a(Object) }
+    end
+
+    context 'paging' do
+      subject { Etherscanio::Api.new(apikey).account_getminedblocks(address, blocktype, page, offset) }
+      let(:apikey) { 'YourApiKeyToken' }
+      let(:address) { '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' }
+      let(:page) { 1 }
+      let(:offset) { 10 }
+      let(:blocktype) { 'block' }
+      it { is_expected.to be_a(Object) }
+    end
+  end
+end

data/spec/api/account/txlist_internal_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Etherscanio::Api do
+  describe 'account_txlistinternal' do
+    subject { Etherscanio::Api.new(apikey).account_txlistinternal(address, startblock, endblock, sort) }
+
+    context 'no paging' do
+      let(:apikey) { 'YourApiKeyToken' }
+      let(:address) { '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' }
+      let(:startblock) { 0 }
+      let(:endblock) { 99_999_999 }
+      let(:sort) { 'desc' }
+      it { is_expected.to be_a(Object) }
+    end
+
+    context 'paging' do
+      subject { Etherscanio::Api.new(apikey).account_txlistinternal(address, startblock, endblock, sort, page, offset) }
+      let(:apikey) { 'YourApiKeyToken' }
+      let(:address) { '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' }
+      let(:startblock) { 0 }
+      let(:endblock) { 99_999_999 }
+      let(:sort) { 'desc' }
+      let(:page) { 1 }
+      let(:offset) { 10 }
+      it { is_expected.to be_a(Object) }
+    end
+  end
+end

data/spec/api/account/txlist_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe Etherscanio::Api do
+  describe 'account_txlist' do
+    subject { Etherscanio::Api.new(apikey).account_txlist(address, startblock, endblock, sort) }
+
+    context 'no paging' do
+      let(:apikey) { 'YourApiKeyToken' }
+      let(:address) { '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' }
+      let(:startblock) { 0 }
+      let(:endblock) { 99_999_999 }
+      let(:sort) { 'desc' }
+      it { is_expected.to be_a(Object) }
+    end
+    context 'paging' do
+      # subject { Etherscanio::Api.new(apikey).account_txlist(address, startblock, endblock, sort, page, offset) }
+      let(:apikey) { 'YourApiKeyToken' }
+      let(:address) { '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' }
+      let(:startblock) { 0 }
+      let(:endblock) { 99_999_999 }
+      let(:sort) { 'desc' }
+      let(:page) { 1 }
+      let(:offset) { 10 }
+      it { is_expected.to be_a(Object) }
+    end
+  end
+end