crea-ruby 0.0.1

data/crea-ruby.gemspec

@@ -0,0 +1,39 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'crea/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'crea-ruby'
+  spec.version = Crea::VERSION
+  spec.authors = ['Creativechain FDN']
+  spec.email = ['info@creativechain.com']
+
+  spec.summary = %q{Crea Ruby Client}
+  spec.description = %q{Client for accessing the Crea blockchain.}
+  spec.homepage = 'https://github.com/creativechain/crea-ruby'
+  spec.license = 'MIT'
+
+  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test)/}) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0', '>= 2.0.1'
+  spec.add_development_dependency 'rake', '~> 12.3', '>= 12.3.0'
+  spec.add_development_dependency 'minitest', '~> 5.10', '>= 5.10.3'
+  spec.add_development_dependency 'minitest-line', '~> 0.6', '>= 0.6.4'
+  spec.add_development_dependency 'minitest-proveit', '~> 1.0', '>= 1.0.0'
+  spec.add_development_dependency 'webmock', '~> 3.3', '>= 3.3.0'
+  spec.add_development_dependency 'simplecov', '~> 0.15', '>= 0.15.1'
+  spec.add_development_dependency 'vcr', '~> 4.0', '>= 4.0.0'
+  spec.add_development_dependency 'yard', '~> 0.9', '>= 0.9.12'
+  spec.add_development_dependency 'pry', '~> 0.11', '>= 0.11.3'
+  spec.add_development_dependency 'awesome_print', '~> 1.8', '>= 1.8.0'
+  
+  spec.add_dependency 'json', '~> 2.1', '>= 2.1.0'
+  spec.add_dependency 'logging', '~> 2.2', '>= 2.2.0'
+  spec.add_dependency 'hashie', '~> 3.5', '>= 3.5.7'
+  spec.add_dependency 'bitcoin-ruby', '~> 0.0', '>= 0.0.18'
+  spec.add_dependency 'ffi', '~> 1.9', '>= 1.9.23'
+  spec.add_dependency 'bindata', '~> 2.4', '>= 2.4.4'
+  spec.add_dependency 'base58', '~> 0.2', '>= 0.2.3'
+end

data/gource.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+gource ./ --user-image-dir images --hide usernames -s 0.5 -b 000000 \
+  -1280x720 --output-ppm-stream - |\
+  ffmpeg -y -r 28 -f image2pipe -vcodec ppm -i - -vcodec libx264 -preset slow \
+  -crf 28 -threads 0 output.mp4

data/lib/crea.rb

@@ -0,0 +1,85 @@
+# encoding: UTF-8
+require 'json' unless defined?(JSON)
+require 'net/https'
+
+require 'hashie'
+require 'crea/version'
+require 'crea/utils'
+require 'crea/base_error'
+require 'crea/mixins/serializable'
+require 'crea/mixins/jsonable'
+require 'crea/mixins/retriable'
+require 'crea/chain_config'
+require 'crea/type/base_type'
+require 'crea/type/amount'
+require 'crea/operation'
+require 'crea/operation/account_create.rb'
+require 'crea/operation/account_create_with_delegation.rb'
+require 'crea/operation/account_update.rb'
+require 'crea/operation/account_witness_proxy.rb'
+require 'crea/operation/account_witness_vote.rb'
+require 'crea/operation/cancel_transfer_from_savings.rb'
+require 'crea/operation/challenge_authority.rb'
+require 'crea/operation/change_recovery_account.rb'
+require 'crea/operation/claim_account.rb'
+require 'crea/operation/claim_reward_balance.rb'
+require 'crea/operation/comment.rb'
+require 'crea/operation/comment_options.rb'
+require 'crea/operation/convert.rb'
+require 'crea/operation/create_claimed_account.rb'
+require 'crea/operation/custom.rb'
+require 'crea/operation/custom_binary.rb'
+require 'crea/operation/custom_json.rb'
+require 'crea/operation/decline_voting_rights.rb'
+require 'crea/operation/delegate_vesting_shares.rb'
+require 'crea/operation/delete_comment.rb'
+require 'crea/operation/escrow_approve.rb'
+require 'crea/operation/escrow_dispute.rb'
+require 'crea/operation/escrow_release.rb'
+require 'crea/operation/escrow_transfer.rb'
+require 'crea/operation/feed_publish.rb'
+require 'crea/operation/limit_order_cancel.rb'
+require 'crea/operation/limit_order_create.rb'
+require 'crea/operation/limit_order_create2.rb'
+require 'crea/operation/prove_authority.rb'
+require 'crea/operation/recover_account.rb'
+require 'crea/operation/report_over_production.rb'
+require 'crea/operation/request_account_recovery.rb'
+require 'crea/operation/reset_account.rb'
+require 'crea/operation/set_reset_account.rb'
+require 'crea/operation/set_withdraw_vesting_route.rb'
+require 'crea/operation/transfer.rb'
+require 'crea/operation/transfer_from_savings.rb'
+require 'crea/operation/transfer_to_savings.rb'
+require 'crea/operation/transfer_to_vesting.rb'
+require 'crea/operation/vote.rb'
+require 'crea/operation/withdraw_vesting.rb'
+require 'crea/operation/witness_update.rb'
+require 'crea/operation/witness_set_properties.rb'
+require 'crea/marshal'
+require 'crea/transaction'
+require 'crea/transaction_builder'
+require 'crea/rpc/base_client'
+require 'crea/rpc/http_client'
+require 'crea/rpc/thread_safe_http_client'
+require 'crea/api'
+require 'crea/jsonrpc'
+require 'crea/block_api'
+require 'crea/formatter'
+require 'crea/broadcast'
+require 'crea/stream'
+
+module Crea
+  def self.api_classes
+    @api_classes ||= {}
+  end
+  
+  def self.const_missing(api_name)
+    api = api_classes[api_name]
+    api ||= Api.clone(freeze: true) rescue Api.clone
+    api.api_name = api_name
+    api_classes[api_name] = api
+  end
+end
+
+Hashie.logger = Logger.new(ENV['HASHIE_LOGGER'])

data/lib/crea/api.rb

@@ -0,0 +1,208 @@
+module Crea
+  # This ruby API works with
+  # {https://github.com/creary/crea/releases cread-0.19.10} and other AppBase
+  # compatible upstreams.  To access different API namespaces, use the
+  # following:
+  #
+  #     api = Crea::Api.new
+  #     api.get_dynamic_global_properties
+  #
+  # The above example will make an instance that can access the
+  # {https://developers.crea.io/apidefinitions/condenser-api condenser_api}
+  # namespace.  Alternatively, you may also create a direct instances with its
+  # full name, if you prefer:
+  #
+  #     api = Crea::CondenserApi.new
+  #     api.get_dynamic_global_properties
+  #
+  # If you know the name of another API that is supported by the remote node,
+  # you can create an instance to that instead, for example:
+  #
+  #     api = Crea::MarketHistoryApi.new
+  #     api.get_volume
+  #
+  # All known API by namespace:
+  #
+  # * {AccountByKeyApi}
+  # * {AccountHistoryApi}
+  # * {BlockApi}
+  # * {DatabaseApi}
+  # * {FollowApi}
+  # * {Jsonrpc}
+  # * {MarketHistoryApi}
+  # * {NetworkBroadcastApi}
+  # * {TagsApi}
+  # * {WitnessApi}
+  #
+  # Also see: {https://developers.crea.io/apidefinitions/ Complete API Definitions}
+  class Api
+    attr_accessor :chain, :methods, :rpc_client
+    
+    # Use this for debugging naive thread handler.
+    # DEFAULT_RPC_CLIENT_CLASS = RPC::HttpClient
+    DEFAULT_RPC_CLIENT_CLASS = RPC::ThreadSafeHttpClient
+    
+    def self.api_name=(api_name)
+      @api_name = api_name.to_s.
+        gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+        gsub(/([a-z\d])([A-Z])/,'\1_\2').
+        tr('-', '_').downcase.to_sym
+    end
+    
+    def self.api_name
+      @api_name
+    end
+    
+    def self.api_class_name
+      @api_name.to_s.split('_').map(&:capitalize).join
+    end
+    
+    def self.jsonrpc=(jsonrpc, url = nil)
+      @jsonrpc ||= {}
+      @jsonrpc[url || jsonrpc.rpc_client.uri.to_s] = jsonrpc
+    end
+    
+    def self.jsonrpc(url = nil)
+      if @jsonrpc.size < 2 && url.nil?
+        @jsonrpc.values.first
+      else
+        @jsonrpc[url]
+      end
+    end
+    
+    # Override this if you want to just use your own client.  Otherwise, inject
+    # the default using:
+    #
+    #     Crea::Api.register default_rpc_client_class: MyClient
+    def self.default_rpc_client_class
+      if !!@injected_dependencies && !!@injected_dependencies[:default_rpc_client_class]
+        @injected_dependencies[:default_rpc_client_class]
+      else
+        DEFAULT_RPC_CLIENT_CLASS
+      end
+    end
+    
+    # Used for dependency injection.  Currently, the only key supported is:
+    # 
+    # `default_rpc_client_class`
+    def self.register(register)
+      @injected_dependencies ||= {}
+      @injected_dependencies = @injected_dependencies.merge register
+    end
+    
+    def initialize(options = {})
+      @chain = options[:chain] || :crea
+      @error_pipe = options[:error_pipe] || STDERR
+      @api_name = self.class.api_name ||= :condenser_api
+      
+      @rpc_client = if !!options[:rpc_client]
+        options[:rpc_client]
+      else
+        rpc_client_class = self.class.default_rpc_client_class
+        rpc_client_class.new(options.merge(api_name: @api_name))
+      end
+      
+      if @api_name == :jsonrpc
+        Api::jsonrpc = self
+      else
+        # Note, we have to wait until initialize to check this because we don't
+        # have access to instance options until now.
+        
+        Api::jsonrpc = Jsonrpc.new(options)
+        @methods = Api::jsonrpc(rpc_client.uri.to_s).get_api_methods
+        
+        unless !!@methods[@api_name]
+          raise UnknownApiError, "#{@api_name} (known APIs: #{@methods.keys.join(' ')})"
+        end
+        
+        @methods = @methods[@api_name]
+      end
+        
+      @try_count = 0
+    end
+    
+    def inspect
+      properties = %w(chain methods).map do |prop|
+        if !!(v = instance_variable_get("@#{prop}"))
+          case v
+          when Array then "@#{prop}=<#{v.size} #{v.size == 1 ? 'element' : 'elements'}>" 
+          else; "@#{prop}=#{v}" 
+          end
+        end
+      end.compact.join(', ')
+      
+      "#<#{self.class.api_class_name} [#{properties}]>"
+    end
+  private
+    # @private
+    def args_keys_to_s(rpc_method_name)
+      args = signature(rpc_method_name).args
+      args_keys = JSON[args.to_json]
+    end
+    
+    # @private
+    def signature(rpc_method_name)
+      url = rpc_client.uri.to_s
+      
+      @@signatures ||= {}
+      @@signatures[url] ||= {}
+      @@signatures[url][rpc_method_name] ||= Api::jsonrpc(url).get_signature(method: rpc_method_name).result
+    end
+    
+    # @private
+    def respond_to_missing?(m, include_private = false)
+      methods.nil? ? false : methods.include?(m.to_sym)
+    end
+    
+    # @private
+    def method_missing(m, *args, &block)
+      super unless respond_to_missing?(m)
+      
+      rpc_method_name = "#{@api_name}.#{m}"
+      rpc_args = case @api_name
+      when :condenser_api then args
+      when :jsonrpc then args.first
+      else
+        expected_args = signature(rpc_method_name).args || []
+        expected_args_key_string = if expected_args.size > 0
+          " (#{args_keys_to_s(rpc_method_name)})"
+        end
+        expected_args_size = expected_args.size
+        
+        begin
+          args = args.first.to_h
+          args_size = args.size
+          
+          # Some argument are optional, but if the arguments passed are greater
+          # than the expected arguments size, we can warn.
+          if args_size > expected_args_size
+            @error_pipe.puts "Warning #{rpc_method_name} expects arguments: #{expected_args_size}, got: #{args_size}"
+          end
+        rescue NoMethodError => e
+          error = Crea::ArgumentError.new("#{rpc_method_name} expects arguments: #{expected_args_size}", e)
+          raise error
+        rescue => e
+          raise UnknownError.new("#{rpc_method_name} unknown error.", e)
+        end
+        
+        args
+      end
+      
+      response = rpc_client.rpc_execute(@api_name, m, rpc_args)
+      
+      if !!block
+        case response
+        when Hashie::Mash then yield response.result, response.error, response.id
+        when Hashie::Array
+          response.each do |r|
+            r = Hashie::Mash.new(r)
+            yield r.result, r.error, r.id
+          end
+        else; yield response
+        end
+      else
+        return response
+      end
+    end
+  end
+end

data/lib/crea/base_error.rb

@@ -0,0 +1,218 @@
+module Crea
+  class BaseError < StandardError
+    def initialize(error = nil, cause = nil)
+      @error = error
+      @cause = cause
+    end
+    
+    def to_s
+      detail = {}
+      detail[:error] = @error if !!@error
+      detail[:cause] = @cause if !!@cause
+      
+      JSON[detail] rescue detail.to_s
+    end
+    
+    def self.build_error(error, context)
+      if error.message == 'Unable to acquire database lock'
+        raise Crea::RemoteDatabaseLockError, error.message, build_backtrace(error)
+      end
+      
+      if error.message.include? 'Internal Error'
+        raise Crea::RemoteNodeError, error.message, build_backtrace(error)
+      end
+      
+      if error.message.include? 'Server error'
+        raise Crea::RemoteNodeError, error.message, build_backtrace(error)
+      end
+      
+      if error.message.include? 'plugin not enabled'
+        raise Crea::PluginNotEnabledError, error.message, build_backtrace(error)
+      end
+      
+      if error.message.include? 'argument'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Invalid params'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.start_with? 'Bad Cast:'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'prefix_len'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Parse Error'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'unknown key'
+        raise Crea::ArgumentError, "#{context}: #{error.message} (or content has been deleted)", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Comment is not in account\'s comments'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Could not find comment'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'unable to convert ISO-formatted string to fc::time_point_sec'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Input data have to treated as object.'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'base.amount > share_type(0)'
+        raise Crea::ArgumentError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'blk->transactions.size() > itr->trx_in_block'
+        raise Crea::VirtualOperationsNotAllowedError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'A transaction must have at least one operation'
+        raise Crea::EmptyTransactionError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'transaction expiration exception'
+        raise Crea::TransactionExpiredError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Duplicate transaction check failed'
+        raise Crea::DuplicateTransactionError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'signature is not canonical'
+        raise Crea::NonCanonicalSignatureError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'attempting to push a block that is too old'
+        raise Crea::BlockTooOldError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'irrelevant signature'
+        raise Crea::IrrelevantSignatureError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'missing required posting authority'
+        raise Crea::MissingPostingAuthorityError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'missing required active authority'
+        raise Crea::MissingActiveAuthorityError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'missing required owner authority'
+        raise Crea::MissingOwnerAuthorityError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'missing required other authority'
+        raise Crea::MissingOtherAuthorityError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Upstream response error'
+        raise Crea::UpstreamResponseError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Bad or missing upstream response'
+        raise Crea::BadOrMissingUpstreamResponseError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'operator has disabled operation indexing by transaction_id'
+        raise Crea::TransactionIndexDisabledError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'is_valid_account_name'
+        raise Crea::InvalidAccountError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include?('Method') && error.message.include?(' does not exist.')
+        raise Crea::UnknownMethodError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Invalid operation name'
+        raise Crea::UnknownOperationError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message =~ /Invalid object name: .+_operation/
+        raise Crea::UnknownOperationError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Author not found'
+        raise Crea::AuthorNotFoundError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? ' != fc::time_point_sec::maximum()'
+        raise Crea::ReachedMaximumTimeError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Cannot transfer a negative amount (aka: stealing)'
+        raise Crea::TheftError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'Must transfer a nonzero amount'
+        raise Crea::NonZeroRequiredError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      if error.message.include? 'is_asset_type'
+        raise Crea::UnexpectedAssetError, "#{context}: #{error.message}", build_backtrace(error)
+      end
+      
+      puts JSON.pretty_generate(error) if ENV['DEBUG']
+      raise UnknownError, "#{context}: #{error.message}", build_backtrace(error)
+    end
+  private
+    def self.build_backtrace(error)
+      backtrace = Thread.current.backtrace.reject{ |line| line =~ /base_error/ }
+      JSON.pretty_generate(error) + "\n" + backtrace.join("\n")
+    end
+  end
+  
+  class DeserializationError < BaseError; end
+  class SerializationMismatchError < BaseError; end
+  class UnsupportedChainError < BaseError; end
+  class ArgumentError < BaseError; end
+  class TypeError < BaseError; end
+  class EmptyTransactionError < ArgumentError; end
+  class InvalidAccountError < ArgumentError; end
+  class AuthorNotFoundError < ArgumentError; end
+  class ReachedMaximumTimeError < ArgumentError; end
+  class VirtualOperationsNotAllowedError < ArgumentError; end
+  class TheftError < ArgumentError; end
+  class NonZeroRequiredError < ArgumentError; end
+  class UnexpectedAssetError < ArgumentError; end
+  class TransactionExpiredError < BaseError; end
+  class DuplicateTransactionError < TransactionExpiredError; end
+  class NonCanonicalSignatureError < TransactionExpiredError; end
+  class BlockTooOldError < BaseError; end
+  class IrrelevantSignatureError < BaseError; end
+  class MissingAuthorityError < BaseError; end
+  class MissingPostingAuthorityError < MissingAuthorityError; end
+  class MissingActiveAuthorityError < MissingAuthorityError; end
+  class MissingOwnerAuthorityError < MissingAuthorityError; end
+  class MissingOtherAuthorityError < MissingAuthorityError; end
+  class IncorrectRequestIdError < BaseError; end
+  class IncorrectResponseIdError < BaseError; end
+  class RemoteNodeError < BaseError; end
+  class UpstreamResponseError < RemoteNodeError; end
+  class RemoteDatabaseLockError < UpstreamResponseError; end
+  class PluginNotEnabledError < UpstreamResponseError; end
+  class BadOrMissingUpstreamResponseError < UpstreamResponseError; end
+  class TransactionIndexDisabledError < BaseError; end
+  class NotAppBaseError < BaseError; end
+  class UnknownApiError < BaseError; end
+  class UnknownMethodError < BaseError; end
+  class UnknownOperationError < BaseError; end
+  class JsonRpcBatchMaximumSizeExceededError < BaseError; end
+  class TooManyTimeoutsError < BaseError; end
+  class TooManyRetriesError < BaseError; end
+  class UnknownError < BaseError; end
+end