wanglu_client 0.0.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 47f4874beebb55803c2984ced904db0a247e9fb3
+  data.tar.gz: d833a41c5343dda1fcc453b4fa6384f4a00ec952
+SHA512:
+  metadata.gz: 4b203549fc229f2c67828c4db80c78a426b01088949b6f4b5dd50beeeadb1ffad3db01d78e6543af4d487ccfb098eb995df6f26fb8966354f11f44272d7b64a7
+  data.tar.gz: a0b407f4392e1153d354907fab68ffb7be100a91c5b169bed89ee5e435990ed4d773eff3f77ef2deb4de1915ce26545fa4245bb8128b64724023f8371035d455

data/README.markdown

@@ -0,0 +1,76 @@
+Ruby client for Wanglu API
+==========================
+
+[![Build Status](https://travis-ci.org/wanglu/wanglu-client-ruby.png?branch=master)](https://travis-ci.org/wanglu/wanglu-client-ruby)
+
+`wanglu-client-ruby` is a client for Wanglu API, support all Wanglu API functions like submit order, get tickers, etc. It's also a reference client implementation, where you can find how to authenticate private Wanglu API.
+
+### Requirements ###
+
+* ruby 2.0.0 or higher (if you want to run 'rake test' in this gem you'll need ruby 2.1.0 or higher)
+* openssl
+
+### Install ###
+
+    gem install wanglu_client
+
+### Usage ###
+
+#### Command line tool ####
+
+TBD
+
+#### REST API client ####
+
+Use `#get` or `#post` to access API after you created a `WangluAPI::Client`:
+
+```ruby
+  require 'wanglu_client'
+
+  # Client can be initialized not providing key and sercet, but this client can only access public APIs
+  client_public = WangluAPI::Client.new endpoint: 'https://exchange.wanglutech.com'
+
+  # GET public api /api/v2/markets
+  client_public.get_public '/api/v2/markets'
+
+  # To build a full functional client which can access both public/private api, access_key/secret_key
+  # are required.
+  #
+  # `endpoint` can be ignored or set to any Wanglu powered exchange.
+  #
+  # If there's no data received in `timeout` seconds, Net::OpenTimeout will be raised. Default to 60.
+  #
+  client = WangluAPI::Client.new access_key: 'your_access_key', secret_key: 'your_secret_key', endpoint: 'https://exchange.wanglutech.com', timeout: 60
+
+  # GET private api /api/v2/orders with 'market=btccny'
+  client.get '/api/v2/orders', market: 'btccny'
+
+  # POST to create an order
+  client.post '/api/v2/orders', market: 'btccny', side: 'sell', volume: '0.11', price: '2955.0'
+
+  # POST to create multiple orders at once
+  client.post '/api/v2/orders/multi', market: 'btccny', orders: [{side: 'buy', volume: '0.15', price: '2955.0'}, {side: 'sell', volume: '0.16', price: '2956'}]
+```
+
+Check [Wanglu API v2 Documents](https://exchange.wanglutech.com/documents/api_v2) for details on Wanglu API.
+
+### Streaming API client ###
+
+Streaming API client is built upon eventmachine, it will start an endless loop to accept updates from server side, you only need to provide a callback block:
+
+```ruby
+  require 'wanglu_client'
+
+  client = WangluAPI::StreamingClient.new access_key: 'your_access_key', secret_key: 'your_secret_key', endpoint: 'wss://exchange.wanglutech.com:8080'
+  client.run do |message|
+    # do whatever you want with message
+  end
+```
+
+### License ###
+
+`wanglu-client-ruby` is released under MIT license. See [http://wanglu.mit-license.org](http://wanglu.mit-license.org) for more information.
+
+### How To Contribute ###
+
+Just create an issue or open a pull request :)

data/lib/wanglu_api/auth.rb

@@ -0,0 +1,36 @@
+module WangluAPI
+  class Auth
+
+    def initialize(access_key, secret_key)
+      @access_key = access_key
+      @secret_key = secret_key
+    end
+
+    def signed_challenge(challenge)
+      signature = OpenSSL::HMAC.hexdigest 'SHA256', @secret_key, "#{@access_key}#{challenge}"
+      {auth: {access_key: @access_key, answer: signature}}
+    end
+
+    def signed_params(verb, path, params={})
+      params    = format_params params
+      signature = sign verb, path, URI.unescape(params.to_query)
+      params.merge(signature: signature)
+    end
+
+    def sign(verb, path, params)
+      OpenSSL::HMAC.hexdigest 'SHA256', @secret_key, payload(verb, path, params)
+    end
+
+    def payload(verb, path, params)
+      "#{verb.upcase}|#{path}|#{params}"
+    end
+
+    def format_params(params)
+      params = params.symbolize_keys
+      params[:access_key] ||= @access_key
+      params[:tonce]      ||= (Time.now.to_f*1000).to_i
+      params
+    end
+
+  end
+end

data/lib/wanglu_api/client.rb

@@ -0,0 +1,80 @@
+require 'json'
+require 'net/http'
+require_relative 'client/version'
+
+module WangluAPI
+  class Client
+
+    attr :auth
+
+    def initialize(options={})
+      options = options.symbolize_keys
+      setup_auth_keys options
+      @endpoint = options[:endpoint] || 'https://exchange.wanglutech.com'
+      @timeout  = options[:timeout]  || 60
+    end
+
+    def get_public(path, params={})
+      uri = URI("#{@endpoint}#{path}")
+      uri.query = URI.encode_www_form params
+
+      request(:get, path, nil, params) do |http, _|
+        http.request_get(uri.request_uri)
+      end
+    end
+
+    def get(path, params={})
+      check_auth!
+
+      uri = URI("#{@endpoint}#{path}")
+
+      request(:get, path, @auth, params) do |http, signed_params|
+        uri.query = URI.encode_www_form signed_params
+        http.request_get(uri.request_uri)
+      end
+    end
+
+    def post(path, params={})
+      check_auth!
+
+      request(:post, path, @auth, params) do |http, signed_params|
+        http.request_post(path, signed_params.to_query)
+      end
+    end
+
+    private
+
+    def request(action, path, auth, params={})
+      uri = URI("#{@endpoint}#{path}")
+      params = auth.signed_params action.to_s.upcase, path, params if auth
+
+      http = Net::HTTP.new(uri.hostname, uri.port)
+      http.open_timeout = @timeout
+      http.use_ssl = true if @endpoint.start_with?('https://')
+
+      http.start do |http|
+        parse yield(http, params)
+      end
+    end
+
+    def parse(response)
+      JSON.parse response.body
+    rescue JSON::ParserError
+      {http_error: {code: response.code, body: response.body}}
+    end
+
+    def setup_auth_keys(options)
+      if options[:access_key] && options[:secret_key]
+        @access_key = options[:access_key]
+        @secret_key = options[:secret_key]
+        @auth       = Auth.new @access_key, @secret_key
+      else
+        #raise ArgumentError, 'Missing access key and/or secret key'
+      end
+    end
+
+    def check_auth!
+      raise ArgumentError, 'Missing access key and/or secret key' if @auth.nil?
+    end
+  end
+end

data/lib/wanglu_api/client/version.rb

@@ -0,0 +1,5 @@
+module WangluAPI
+  class Client
+    VERSION = '0.0.8'
+  end
+end

data/lib/wanglu_api/config.rb

@@ -0,0 +1,12 @@
+module WangluAPI
+  class Config
+
+    def self.get_wanglurc(path)
+      if File.exist? path
+        lines = File.readlines path
+        [ lines[0].strip, lines[1].strip ]
+      end
+    end
+
+  end
+end

data/lib/wanglu_api/core_ext.rb

@@ -0,0 +1,3 @@
+require 'wanglu_api/core_ext/keys'
+require 'wanglu_api/core_ext/to_query'
+

data/lib/wanglu_api/core_ext/keys.rb

@@ -0,0 +1,16 @@
+unless {}.respond_to? :symbolize_keys
+  class Hash
+    def transform_keys
+      return enum_for(:transform_keys) unless block_given?
+      result = self.class.new
+      each_key do |key|
+        result[yield(key)] = self[key]
+      end
+      result
+    end
+
+    def symbolize_keys
+      transform_keys{ |key| key.to_sym rescue key }
+    end
+  end
+end

data/lib/wanglu_api/core_ext/to_query.rb

@@ -0,0 +1,60 @@
+unless Object.new.respond_to? :to_query and Object.new.respond_to? :to_param
+
+  require 'cgi' unless defined?(CGI) && defined?(CGI::escape)
+
+  class Object
+    def to_param
+      to_s
+    end
+
+    def to_query(key)
+      "#{CGI.escape(key.to_param)}=#{CGI.escape(to_param.to_s)}"
+    end
+  end
+
+  class NilClass
+    def to_param
+      self
+    end
+  end
+
+  class TrueClass
+    def to_param
+      self
+    end
+  end
+
+  class FalseClass
+    def to_param
+      self
+    end
+  end
+
+  class Array
+    def to_param
+      collect(&:to_param).join '/'
+    end
+
+    def to_query(key)
+      prefix = "#{key}[]"
+
+      if empty?
+        nil.to_query(prefix)
+      else
+        collect { |value| value.to_query(prefix) }.join '&'
+      end
+    end
+  end
+
+  class Hash
+    def to_query(namespace = nil)
+      collect do |key, value|
+        unless (value.is_a?(Hash) || value.is_a?(Array)) && value.empty?
+          value.to_query(namespace ? "#{namespace}[#{key}]" : key)
+        end
+      end.compact.sort! * '&'
+    end
+
+    alias_method :to_param, :to_query
+  end
+end

data/lib/wanglu_api/streaming_client.rb

@@ -0,0 +1,52 @@
+require 'logger'
+require 'json'
+require 'eventmachine'
+require 'faye/websocket'
+
+module WangluAPI
+  class StreamingClient < Client
+
+    def initialize(options={})
+      super
+      @endpoint = options[:endpoint] || 'wss://wanglutech.com:8080'
+      @logger   = options[:logger] || Logger.new(STDOUT)
+    end
+
+    def run(&callback)
+      EM.run do
+        ws = Faye::WebSocket::Client.new(@endpoint)
+
+        ws.on(:open) do |event|
+          @logger.info "Connected."
+        end
+
+        ws.on(:message) do |event|
+          msg = JSON.parse(event.data)
+
+          key = msg.keys.first
+          data = msg[key]
+          case key
+          when 'challenge'
+            ws.send JSON.dump(@auth.signed_challenge(data))
+          else
+            begin
+              callback.call msg
+            rescue
+              @logger.error "Failed to process message: #{payload}"
+              @logger.error $!
+            end
+          end
+        end
+
+        ws.on(:close) do |event|
+          @logger.info "Closed. Code: #{event.code}, Reason: #{event.reason || 'none'}"
+          ws = nil
+          EM.stop
+        end
+
+      end
+
+    end
+
+  end
+end

data/lib/wanglu_client.rb

@@ -0,0 +1,5 @@
+require_relative 'wanglu_api/core_ext'
+require_relative 'wanglu_api/config'
+require_relative 'wanglu_api/auth'
+require_relative 'wanglu_api/client'
+require_relative 'wanglu_api/streaming_client'

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: wanglu_client
+version: !ruby/object:Gem::Version
+  version: 0.0.8
+platform: ruby
+authors:
+- Wanglu Opensource
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-02-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faye-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.5.1
+description: A ruby client which can access all Wanglu's API.
+email:
+- mutouji1@163.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.markdown
+- lib/wanglu_api/auth.rb
+- lib/wanglu_api/client.rb
+- lib/wanglu_api/client/version.rb
+- lib/wanglu_api/config.rb
+- lib/wanglu_api/core_ext.rb
+- lib/wanglu_api/core_ext/keys.rb
+- lib/wanglu_api/core_ext/to_query.rb
+- lib/wanglu_api/streaming_client.rb
+- lib/wanglu_client.rb
+homepage: https://github.com/wanglu/wanglu-client-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: A ruby client to access Wanglu's API.
+test_files: []