netether 0.0.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 61a74f049468a77ca2b0110b2b485115d89d7442
+  data.tar.gz: 9dde9eee6feb3750c4293b21f40897f21903fa4d
+SHA512:
+  metadata.gz: 7cedbb52d485bd4ed485973a7efda7d39b7628d20a6c8c7a452d9258cb621a46a40aec60f59ed11e8c38bc4b13019428d6fb65eb10e14715e7651ed3b8ca2da1
+  data.tar.gz: 65632bac9bef1923ce8510b21a11f2773637524330c3348d0d3346e82fdaba6182af6329d698f94649decf52141f1b4bb517ec5979173a8a14a5d16aebca8beb

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.0.0
+before_install: gem install bundler -v 1.10.3

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in netether.gemspec
+gem 'rake'
+gem 'byebug'
+gem 'test-unit'
+gem 'test-unit-mock'
+gem 'httpclient'
+gem 'mocha'
+gem 'webmock'

data/LICENSE.txt

@@ -0,0 +1,23 @@
+Copyright (c) 2015, Netki, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted
+provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions
+and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions
+and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse
+or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,36 @@
+![Rubygem](https://img.shields.io/gem/dv/netki/stable.svg)
+
+# Ruby Netki Partner API Client
+
+This Ruby gem provides a client for [Netki's](https://netki.com) Partner API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'netki'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install netki
+
+## Usage
+
+See rdoc-generated documentation for this Gem in doc/
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake false` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/netkicorp/ruby-partner-client.
+

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/test*.rb']
+  t.verbose = true
+end
+
+desc "Run tests"
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require_relative "../lib/netether"
+
+# 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.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

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

data/lib/netether.rb

@@ -0,0 +1,6 @@
+require_relative 'netether/version'
+require_relative 'netether/netether'
+
+module Netether
+
+end

data/lib/netether/netether.rb

@@ -0,0 +1,331 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'httpclient'
+require 'json'
+require_relative 'utilities'
+
+module Netether
+
+  # Request Utility Functionality
+  def self.process_request(api_key, partner_id, uri, method, bodyData=nil)
+
+    raise "Invalid HTTP Method" unless ['GET','POST','PUT','DELETE'].include? method
+
+    # Setup Headers
+    headers = {}
+    headers["Content-Type"] = "application/json"
+    headers["Authorization"] = api_key if api_key
+    headers["X-Partner-ID"] = partner_id if partner_id
+
+    # Setup Request Options
+    opts = {}
+    opts[:header] = headers
+    opts[:body] = bodyData if bodyData
+
+    client = HTTPClient.new
+    _uri = URI.parse(uri)
+    response = client.request(method, _uri, opts)
+
+    # Short Circuit Return if 204 Response on DELETE
+    return {} if response.code == 204 && method == "DELETE"
+
+    # We should have response content at this point
+    raise "Empty Response Received" if response.content.nil? || response.content.empty?
+
+    # Verify we have the correct content type
+    raise "Non-JSON Content Type" if response.headers['Content-Type'] != 'application/json'
+
+    # Make Sure We Can Decode JSON Response
+    begin
+      ret_data = JSON.parse(response.content)
+    rescue JSON::ParserError => e
+      raise "Invalid JSON Response Received"
+    end
+
+    # Process Error
+    if response.code >= 300 || !ret_data['success']
+      return ret_data['message']
+    end
+
+    return ret_data
+  end
+
+  # Obtain a WalletName object by querying the Netki Open API.
+  def self.wallet_lookup(uri, currency, api_url='https://api.netki.com')
+    wallet_name = URI.parse(uri).host || uri.to_s
+
+    response = process_request(nil, nil, "#{api_url}/api/wallet_lookup/#{wallet_name}/#{currency.downcase}", 'GET')
+
+    netki_address = response['wallet_address']
+
+    if !netki_address.nil? && netki_address != 0
+      return netki_address
+    else
+      return false, "No Address Found"
+    end
+  end
+
+##
+# The WalletName object represents a Netki Wallet Name object.
+#
+  class WalletName
+
+    ##
+    # :args: domain_name, name, wallets, external_id, id,
+    def initialize(domain_name, name, wallets={}, external_id: nil, id: nil)
+      @domain_name = domain_name
+      @name = name
+
+      @wallets = wallets.inject({}) do |hsh, (currency, value)|
+        hsh[currency] = value.is_a?(Hash) ? value : { address: value }
+        hsh
+      end
+      @external_id = external_id
+      @id = id
+    end
+
+    attr_accessor :domain_name, :name, :id, :external_id
+
+    # :section: Getters
+
+    # Get Address for Existing Currency
+    def get_address(currency)
+      @wallets[currency][:address]
+    end
+
+    # Get Wallet Name Array of Used Currencies
+    def used_currencies
+      @wallets.keys
+    end
+
+    # :section: Currency Address Operations
+
+    # Set the address or URI for the given currency for this wallet name
+    def set_currency_address(currency, address)
+      @wallets[currency] = { address: address }
+    end
+
+    # Remove a used currency from this wallet name
+    def remove_currency(currency)
+      @wallets.delete(currency) if @wallets.has_key? currency
+    end
+
+    # :section: Setters
+
+    def set_api_opts(api_url, partner_id, api_key) # :nodoc:
+      @api_url = api_url
+      @partner_id = partner_id
+      @api_key = api_key
+    end
+
+    # :section: Actions
+
+    # Save the currency WalletName object to the remote service
+    def save
+      wallet_data = []
+      @wallets.each do |currency, wallet|
+        # NOTE: Unsure if remote service supports storing metadata (params/bip70 req)?
+        wallet_data.push(
+          {
+            currency: currency,
+            wallet_address: wallet[:_raw] ? wallet[:_raw] : wallet[:address]
+          }
+        )
+      end
+
+      wn_data = {
+        domain_name: @domain_name,
+        name: @name,
+        wallets: wallet_data,
+        external_id: @external_id || 'null'
+      }
+
+      wn_api_data = {}
+      wn_api_data['wallet_names'] = [wn_data]
+
+      if @id
+        wn_data['id'] = @id
+        response = Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/partner/walletname", 'PUT', JSON.dump(wn_api_data))
+      else
+        response = Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/partner/walletname", 'POST', JSON.dump(wn_api_data))
+      end
+
+      unless @id
+        response['wallet_names'].each do |wn|
+          if (response['success'] &&
+              wn['domain_name'] == @domain_name &&
+              wn['name'] == @name)
+            @id = wn['id']
+          else
+            raise 'Success, but invalid response received!'
+          end
+        end
+      end
+
+    end
+
+    # Delete this WalletName object from the remote service
+    def delete
+      raise 'Unable to Delete Object that Does Not Exist Remotely' unless @id
+
+      wn_api_data = {
+          wallet_names: [ { domain_name: @domain_name, id: @id } ]
+      }
+
+      Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/partner/walletname", 'DELETE', JSON.dump(wn_api_data))
+    end
+  end
+
+  class NetkiPartner
+
+    ##
+    # The Netki object must be initialized with the Partner ID and API Key to be useful
+    #
+    # * Partner ID -> Netki Partner ID is available on your partner API Key Page
+    # * API Key -> Netki API Key is available only upon API Key creation. Be sure to store it somewhere safe!
+    #
+
+    attr_accessor :partner_id, :api_key, :api_url
+
+    def initialize(partner_id=nil, api_key=nil, api_url='https://api.netki.com')
+      @partner_id = partner_id
+      @api_key = api_key
+      @api_url = api_url
+    end
+
+    ##
+    # Create a new Partner
+    # * partner_name -> Name of new sub-partner to create
+    #
+    def create_new_partner(partner_name)
+      encoded_partner_name = URI.encode(partner_name)
+      response = Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/admin/partner/#{encoded_partner_name}", method='POST')
+      response['partner']['id']
+    end
+
+    ##
+    # List current and sub partners
+    # Returns a list of partner Hashes, each containing an id and name key
+    #
+    def get_partners()
+      response = Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/admin/partner", method='GET')
+      response['partners']
+    end
+
+    ##
+    # Delete a Partner
+    # * partner_name -> Name of sub-partner to delete
+    # NOTE: You cannot delete your own partner resource
+    #
+    def delete_partner(partner_name)
+      encoded_partner_name = URI.encode(partner_name)
+      Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/admin/partner/#{encoded_partner_name}", method='DELETE')
+      true
+    end
+
+    ##
+    # Create a new domain
+    # * domain_name -> Name of new domain to create
+    # * partner_id -> (optional) Partner that should own the new domain
+    #
+    def create_new_domain(domain_name, partner_id=nil)
+      api_data = {}
+      api_data['partner_id'] = partner_id unless partner_id.nil?
+      Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/partner/domain/#{domain_name}", method='POST', JSON.dump(api_data))
+      true
+    end
+
+    ##
+    # List available domain resources
+    # Returns a list of domain Hashes, each containing a domain_name and tld_type key
+    #
+    def get_domains()
+      response = Netether.process_request(@api_key, @partner_id, "#{@api_url}/api/domain", method='GET')
+      response['domains']
+    end
+
+    ##
+    # List status of domain resources
+    # * domain_name -> (Optional) Name of domain to return status for
+    #
+    # If domain_name is omitted status is returned for all available domain resources.
+    #
+    # Returns a list of Hashes, each containing current status for each domain
+    #
+    def get_domain_status(domain_name=nil)
+      uri="#{@api_url}/v1/partner/domain"
+      uri << "/#{domain_name}" unless domain_name.nil?
+
+      response = Netether.process_request(@api_key, @partner_id, uri, method='GET')
+      response['domains'] || response
+    end
+
+    ##
+    # Get DNSSEC Status of Domain
+    # * domain_name -> (Required) Name of domain to get DNSSEC status for
+    #
+    # Returns a hash containing the follow DNSSEC-related keys:
+    # - ds_records (list)
+    # - public_key_signing_key
+    # - nextroll_date
+    # - nameservers (list)
+
+    def get_domain_dnssec(domain_name)
+      Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/partner/domain/dnssec/#{domain_name}", method='GET')
+    end
+
+    ##
+    # Delete a Domain
+    # * domain_name -> Name of delete to delete
+    #
+    def delete_domain(domain_name)
+      Netether.process_request(@api_key, @partner_id, "#{@api_url}/v1/partner/domain/#{domain_name}", method='DELETE')
+      true
+    end
+
+
+    ##
+    # Create a new Wallet Name object using this factory method.
+    # * domain_name -> The pre-configured domain name you would like to add this new wallet name to
+    # * name -> The DNS name that you would like this new wallet name to have (ie.. name.domain_name)
+    # * wallets -> This is a hash where the key is the currency (ie.. btc, ltc, dgc, tusd) and the value is:
+    #              the wallet address OR
+    #              URL of the BIP32 / BIP70 address server OR
+    #              a hash containing an :address and other metadata
+    # * external_id -> Any unique external ID that you may want to use to track this specific wallet name
+    #
+    def create_new_walletname(domain_name, name, wallets={}, external_id=nil)
+      new_wn = WalletName.new(domain_name, name, wallets, external_id: external_id)
+      new_wn.set_api_opts(@api_url, @partner_id, @api_key)
+      new_wn
+    end
+
+    ##
+    # Returns an array of WalletName objects based on the given search parameters:
+    # * domain_name -> The pre-configured domain that you have already been using for wallet names
+    # * external_id -> The external ID previously given to the single wallet name you want to retrieve
+    def get_wallet_names(domain_name=nil, external_id=nil)
+      args = []
+      args.push("domain_name=#{domain_name}") if domain_name
+      args.push("external_id=#{external_id}") if external_id
+
+      uri = "#{@api_url}/v1/partner/walletname"
+      uri = (uri + "?" + args.join("&")) unless args.empty?
+      response = Netether.process_request(@api_key, @partner_id, uri, method='GET')
+
+      return [] if !response.has_key? 'wallet_name_count' || response['wallet_name_count'] == 0
+
+      wn_list = []
+      response['wallet_names'].each do |wn|
+        wallets = {}
+        wn['wallets'].each do |wallet|
+          wallets[wallet['currency']] = wallet['wallet_address']
+        end
+        wn_obj = WalletName.new(wn['domain_name'], wn['name'], wallets, external_id: wn['external_id'], id: wn['id'])
+        wn_obj.set_api_opts(@api_url, @partner_id, @api_key)
+        wn_list.push(wn_obj)
+      end
+      wn_list
+    end
+  end
+end

data/lib/netether/utilities.rb

@@ -0,0 +1,51 @@
+module Netether
+
+  KNOWN_PREFIXES = [ 'bitcoin', 'litecoin', 'dogecoin' ]
+
+  class InvalidURIError < StandardError; end
+
+  def self.parse_bitcoin_uri(uri, tolerate_errors: false)
+    parts = uri.split(':', 2)
+
+    unless KNOWN_PREFIXES.include?(parts.shift)
+      raise InvalidURIError.new("unknown URI prefix")
+    end
+
+    # parts => [base58][?[bitcoinparam, [&bitcoinparam, ...]]
+    base58address, query = parts.first.split('?', 2)
+    response = { address: base58address }
+
+    begin
+      response.merge!(_parse_bip_72(query))
+    rescue InvalidURIError => e
+      raise e unless tolerate_errors
+    end
+
+    response
+  end
+
+  # https://github.com/bitcoin/bips/blob/master/bip-0072.mediawiki
+  def self._parse_bip_72(querystring)
+    params = _parse_bip_21(querystring)
+    { r: params['r'], params: params }
+  end
+
+  # https://github.com/bitcoin/bips/blob/master/bip-0021.mediawiki
+  def self._parse_bip_21(querystring)
+
+    param_pairs = querystring.split('&') # '&' reserved as separator in bip21
+
+    param_pairs.inject({}) do |hsh, pair|
+      parts = pair.split('=') # '=' reserved as separator in bip21
+
+      raise InvalidURIError.new("unbalanced parameter #{pair}") unless (
+        parts.size == 2 &&
+        parts[0].size > 0 &&
+        parts[1].size > 0)
+      raise InvalidURIError.new("duplicate parameter #{parts[0]}") unless hsh[parts[0]].nil?
+
+      hsh[parts[0]] = parts[1]
+      hsh
+    end
+  end
+end

data/lib/netether/version.rb

@@ -0,0 +1,3 @@
+module Netether
+  VERSION = "0.0.6"
+end

data/netether.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'netether/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "netether"
+  spec.version       = Netether::VERSION
+  spec.licenses      = ['BSD-3-Clause']
+  spec.authors       = ["Whit Jackson", "Matt David"]
+  spec.email         = ["whit@tether.to", "opensource@netki.com"]
+
+  spec.summary       = %q{Tether's fork of Netki Partner API}
+  spec.description   = %q{Netki module that provides access to the Netki Wallet Name Partner API}
+  spec.homepage      = "https://github.com/whitj00/netether"
+
+  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_runtime_dependency "httpclient", "~> 2.6"
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "test-unit", "~> 3.1"
+  spec.add_development_dependency "test-unit-mock", "~> 0.3"
+  spec.add_development_dependency "mocha", "~> 1.1"
+  spec.add_development_dependency "webmock", "~> 1.21"
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: netether
+version: !ruby/object:Gem::Version
+  version: 0.0.6
+platform: ruby
+authors:
+- Whit Jackson
+- Matt David
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-10-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: test-unit-mock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+description: Netki module that provides access to the Netki Wallet Name Partner API
+email:
+- whit@tether.to
+- opensource@netki.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/netether.rb
+- lib/netether/netether.rb
+- lib/netether/utilities.rb
+- lib/netether/version.rb
+- netether.gemspec
+homepage: https://github.com/whitj00/netether
+licenses:
+- BSD-3-Clause
+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.8
+signing_key: 
+specification_version: 4
+summary: Tether's fork of Netki Partner API
+test_files: []
+has_rdoc: