etherscanio 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 75235b7097173271620ff5b1c5934c3b0925e984
+  data.tar.gz: e3931309dbcb07e4cbf8bb11cf1f183f3c65e9ce
+SHA512:
+  metadata.gz: 8dae5cd73b1dca8178eeb9b908310a08cd8283a3a89c1bf147f05c55b21f647f96d13bfadaeb8b157e39989869bd95746953f811aa3261264b1ddc84e7128966
+  data.tar.gz: b8fd18b33f4049886995373bbf2c8f9cde3bac51d6d5c3c5b0e6afbafab912b97123a48c1d0c678d12a0b56a5f4f8efb130014372d9f60276c6abd5d33e4dbf7

data/.gitignore

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

data/.rubocop.yml

@@ -0,0 +1,90 @@
+Metrics/BlockLength:
+  Enabled: false
+
+# Disable global vars
+Style/SpecialGlobalVars:
+  Enabled: false
+
+# Disable class length restriction
+Metrics/ClassLength:
+  Enabled: false
+
+# Disable module length restriction
+Metrics/ModuleLength:
+  Enabled: false
+
+# Disable method length restriction
+Metrics/MethodLength:
+  Enabled: false
+
+# Disable checking of ABC metrics (assignment, branch, condition)
+Metrics/AbcSize:
+  Enabled: false
+
+# Disable method perceived complexity (how it is hard to read a method)
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+# Disable cyclomatic complexity which is a number of paths through a method
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+# Block nesting is 5
+Metrics/BlockNesting:
+  Max: 5
+
+# Set max line length to 120
+Metrics/LineLength:
+  Max: 120
+
+# Set max line length to 120
+Metrics/ParameterLists:
+  Max: 6
+
+Style/Documentation:
+  Enabled: false
+
+# Trailing comma helps not to forget to put it
+# if you want to add new value below
+Style/TrailingCommaInLiteral:
+  Enabled: false
+
+# It is totally ok to use block chain by my preference
+# It promotes functional programming style
+Style/MultilineBlockChain:
+  Enabled: false
+
+# Empty lines are enabled to simplify vim paragraph selection
+Style/EmptyLinesAroundBlockBody:
+  Enabled: false
+
+Style/EmptyLinesAroundClassBody:
+  Enabled: false
+
+Style/EmptyLinesAroundMethodBody:
+  Enabled: false
+
+# Disable multiline method indentation, not comfortable with it
+Style/MultilineMethodCallIndentation:
+  Enabled: false
+
+# extend self uses ruby inheritance instead of copying methods
+Style/ModuleFunction:
+  Enabled: false
+
+Style/Lambda:
+  Enabled: false
+
+AllCops:
+  DisplayCopNames: true
+  Exclude:
+    - db/**/*
+    - bin/**
+    - config/**/**
+    - spec/dummy/bin/**
+    - spec/dummy/db/**
+    - Guardfile
+
+Rails:
+  Enabled: false
+  Exclude:

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.14.5

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,51 @@
+
+
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+  # Rails files
+  rails = dsl.rails(view_extensions: %w(erb haml slim))
+  dsl.watch_spec_files_for(rails.app_files)
+  dsl.watch_spec_files_for(rails.views)
+
+  watch(rails.controllers) do |m|
+    [
+      rspec.spec.call("routing/#{m[1]}_routing"),
+      rspec.spec.call("controllers/#{m[1]}_controller"),
+      rspec.spec.call("acceptance/#{m[1]}")
+    ]
+  end
+
+  # Rails config changes
+  watch(rails.spec_helper)     { rspec.spec_dir }
+  watch(rails.routes)          { "#{rspec.spec_dir}/routing" }
+  watch(rails.app_controller)  { "#{rspec.spec_dir}/controllers" }
+
+  # Capybara features specs
+  watch(rails.view_dirs)     { |m| rspec.spec.call("features/#{m[1]}") }
+  watch(rails.layouts)       { |m| rspec.spec.call("features/#{m[1]}") }
+
+  # Turnip features and steps
+  watch(%r{^spec/acceptance/(.+)\.feature$})
+  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) do |m|
+    Dir[File.join("**/#{m[1]}.feature")][0] || "spec/acceptance"
+  end
+end
+
+guard :rubocop do
+  watch(%r{.+\.rb$})
+  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end

data/README.md

@@ -0,0 +1,5 @@
+# etherscanio-rb
+
+Access to the API of etherscan.io and the ethereum blockchain
+
+[![Build Status](https://travis-ci.org/sebs/etherscanio-rb.svg?branch=master)](https://travis-ci.org/sebs/etherscanio-rb)

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task test: :spec
+task default: :spec

data/etherscanio.gemspec

@@ -0,0 +1,30 @@
+# 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          = 'etherscanio'
+  spec.version       = '0.0.1'
+  spec.authors       = ['Sebastian Schürmann']
+  spec.email         = ['sebs@2xs.org']
+  spec.description   = '3rd party uinding to the ethereumblockchain API at etherscan.io'
+  spec.summary       = ''
+  spec.homepage      = 'https://github.com/sebs/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.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'
+
+end

data/lib/etherscanio/api.rb

@@ -0,0 +1,70 @@
+module Etherscanio
+  class Api
+    def initialize(_key)
+      nil
+    end
+
+    def account_txlist(address, startblock, endblock, sort = 'desc', page = nil, offset = nil)
+      call = Etherscanio::Call.new('account', 'txlist')
+      call.address = address
+      call.startblock = startblock
+      call.endblock = endblock
+      call.page = page
+      call.offset = offset
+      call.sort = sort
+      call.fetch
+    end
+
+    def account_txlistinternal(address, startblock, endblock, sort = 'desc', page = nil, offset = nil)
+      call = Etherscanio::Call.new('account', 'txlistinternal')
+      call.address = address
+      call.startblock = startblock
+      call.endblock = endblock
+      call.page = page
+      call.offset = offset
+      call.sort = sort
+      call.fetch
+    end
+
+    def account_balance(address, tag)
+      call = Etherscanio::Call.new('account', 'balance')
+      call.address = address
+      call.tag = tag
+      call.fetch
+    end
+
+    def getminedblocks(address, blocktype, page = nil, offset = nil)
+      call = Etherscanio::Call.new('account', 'getminedblocks')
+      call.page = page
+      call.offset = offset
+      call.address = address
+      call.blocktype = blocktype
+      call.fetch
+    end
+
+    def account_balancemulti(address, tag)
+      call = Etherscanio::Call.new('account', 'balancemulti')
+      call.address = address
+      call.tag = tag
+      call.fetch
+    end
+
+    def contract_getabi(address)
+      call = Etherscanio::Call.new('contract', 'getabi')
+      call.address = address
+      call.fetch
+    end
+
+    def transaction_getstatus(txhash)
+      call = Etherscanio::Call.new('transaction', 'getstatus')
+      call.txhash = txhash
+      call.fetch
+    end
+
+    def block_getblockreward(blockno)
+      call = Etherscanio::Call.new('block', 'getblockreward')
+      call.blockno = blockno
+      call.fetch
+    end
+  end
+end

data/lib/etherscanio/call.rb

@@ -0,0 +1,56 @@
+require 'rest-client'
+module Etherscanio
+  class Call
+    attr_accessor :mod,
+                  :action,
+                  :api_key,
+                  :address,
+                  :tag,
+                  :startblock,
+                  :endblock,
+                  :sort,
+                  :page,
+                  :offset,
+                  :sort,
+                  :blocktype,
+                  :txhash,
+                  :blockno
+    def initialize(mod, action)
+      @base = 'http://api.etherscan.io/api?'
+      @mod = mod
+      @action = action
+      @api_key = false
+    end
+
+    def fetch
+      res = RestClient.get(to_s, {}).body
+      parsed = JSON.parse(res)
+      JSON.generate(parsed)
+    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
+      @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_balance' do
+    subject { Etherscanio::Api.new(apikey).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).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