cardano_wallet 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a6e3c345e2c100428cf2bdd638ee903c9df401760a78e75bc531f48d8d2832e3
+  data.tar.gz: d11fd3e81378d4ff2d4687d16ebe3cdcfa78cf33d342d2d907ac8b8ab374c70b
+SHA512:
+  metadata.gz: a2a32cd78ee9ec09f814b1bb9eca9786327b2da53e82da90067aaa9cca6c7a9d146b9d120115173e0e17e4f154c6d3cdf3c6ba7cbe228ce07f53dc7b435a5d88
+  data.tar.gz: 5b2f5263447204632e7d80d8a9e15186a19fa7d33e40ee1a74651c0982aa799157a3b42455ea75aff25cd38db2ba8fea1609506f1ac2689dee3bc31911b950eb

data/.github/workflows/gem-push.yml

@@ -0,0 +1,29 @@
+name: Ruby Gem
+
+on:
+  push:
+    tags:
+    - '*'
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby 2.6
+      uses: actions/setup-ruby@v1
+      with:
+        version: 2.6.x
+
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        GEM_HOST_API_KEY: ${{secrets.RUBYGEMS_AUTH_TOKEN}}

data/.github/workflows/tests.yml

@@ -0,0 +1,41 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Tests
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up cardano-wallet
+      run: docker-compose up --detach
+    - name: Set up Ruby
+    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
+    # change this to (see https://github.com/ruby/setup-ruby#versioning):
+    # uses: ruby/setup-ruby@v1
+      uses: ruby/setup-ruby@ec106b438a1ff6ff109590de34ddc62c540232e0
+      with:
+        ruby-version: 2.6
+    - name: Install dependencies
+      run: bundle install
+    - name: Run tests
+      run: bundle exec rake
+    env:
+      CI: true
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+      NETWORK: testnet
+      WALLET: dev-master-byron
+      NODE: latest

data/.gitignore

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

data/.rakeTasks

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Settings><!--This file was automatically generated by Ruby plugin.
+You are allowed to: 
+1. Remove rake task
+2. Add existing rake tasks
+To add existing rake tasks automatically delete this file and reload the project.
+--><RakeGroup description="" fullCmd="" taksId="rake" /></Settings>

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at piotr.stachyra@iohk.io. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [https://contributor-covenant.org/version/1/4][version]
+
+[homepage]: https://contributor-covenant.org
+[version]: https://contributor-covenant.org/version/1/4/

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Piotr Stachyra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,103 @@
+<a href="https://github.com/piotr-iohk/cardano-wallet-rb/releases">
+  <img src="https://img.shields.io/github/release/piotr-iohk/cardano-wallet-rb.svg" />
+</a>
+<a href="https://codecov.io/gh/piotr-iohk/cardano-wallet-rb">
+  <img src="https://codecov.io/gh/piotr-iohk/cardano-wallet-rb/branch/master/graph/badge.svg?token=OmUMUeyR21" />
+</a>
+<a href="https://github.com/piotr-iohk/cardano-wallet-rb/actions?query=workflow%3ATests">
+  <img src="https://github.com/piotr-iohk/cardano-wallet-rb/workflows/Tests/badge.svg" />
+</a>
+
+# cardano-wallet-rb
+
+Ruby wrapper over [cardano-wallet's](https://github.com/input-output-hk/cardano-wallet) REST [API](https://input-output-hk.github.io/cardano-wallet/api/edge/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'cardano_wallet'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install cardano_wallet
+
+## Usage
+
+### Initialize
+
+```ruby
+# default options
+CW = CardanoWallet.new
+
+# custom options
+CW1 = CardanoWallet.new({port: 8091})
+CW2 = CardanoWallet.new({port: 443,
+                        protocol: "https",
+                        cacert: "/root/ca.cert",
+                        pem: "/root/client.pem"})
+```
+### Excercise the API
+```ruby
+CW = CardanoWallet.new
+
+BYRON = CW.byron
+SHELLEY = CW.shelley
+MISC = CW.misc
+PROXY = CW.proxy
+
+#Byron
+BYRON.wallets.list.each_with_index do |wal, i|
+  BYRON.wallets.update_metadata(wal['id'], {name: "Wallet number #{i}"})
+end
+
+#Shelley
+w = SHELLEY.wallets.create{name: "Wallet1",
+	                       mnemonic_sentence: %w[vintage poem topic machine hazard cement dune glimpse fix brief account badge mass silly business],
+	                       passphrase: "Secure Passphrase"}
+
+SHELLEY.wallets.get(w['id'])
+
+#Misc
+MISC.network.information
+MISC.network.clock
+
+#Proxy
+PROXY.submit_external_transaction(File.new("/tmp/blob.bin").read)
+```
+
+Refer to documentation.
+
+## Development
+
+In order to spin up environment for development and testing `docker-compose` can be used.
+
+    $ NETWORK=testnet WALLET=dev-master-byron NODE=latest docker-compose up --detach
+
+This starts:
+  - `cardano-node` latest [release](https://github.com/input-output-hk/cardano-node/releases)
+  - `cardano-wallet-byron` [master](https://github.com/input-output-hk/cardano-wallet)
+
+Run tests on top of that:
+
+    $ rake
+
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/piotr-iohk/cardano-wallet-rb. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/piotr-iohk/cardano-wallet-rb/blob/master/CODE_OF_CONDUCT.md).
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the `cardano-wallet-rb` project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/piotr-iohk/cardano-wallet-rb/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "cardano_wallet"
+
+# 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(__FILE__)

data/bin/setup

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

data/cardano_wallet.gemspec

@@ -0,0 +1,37 @@
+require_relative 'lib/cardano_wallet/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "cardano_wallet"
+  spec.version       = CardanoWallet::VERSION
+  spec.authors       = ["Piotr Stachyra"]
+  spec.email         = ["piotr.stachyra@gmail.com"]
+
+  spec.summary       = %q{Ruby wrapper over cardano-wallet.}
+  spec.description   = %q{Ruby wrapper over cardano-wallet.}
+  spec.homepage      = "https://github.com/piotr-iohk/cardano-wallet-rb"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org/"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = spec.homepage
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'httparty', '~> 0.18.0'
+
+  spec.add_development_dependency 'rake', '~> 12.3'
+  spec.add_development_dependency 'rspec', '~> 3.7'
+  spec.add_development_dependency 'codecov'
+  spec.add_development_dependency 'simplecov'
+
+end

data/docker-compose.yml

@@ -0,0 +1,38 @@
+version: "3.5"
+
+services:
+  cardano-node:
+    image: inputoutput/cardano-node:${NODE}
+    environment:
+      NETWORK:
+    volumes:
+      - node-${NETWORK}-db:/data
+      - node-ipc:/ipc
+      - node-config:/nix/store
+    restart: on-failure
+
+  cardano-wallet:
+    image: inputoutput/cardano-wallet:${WALLET}
+    volumes:
+      - wallet-${NETWORK}-db:/wallet-db
+      - node-ipc:/ipc
+      - node-config:/config
+    ports:
+      - 8090:8090
+    entrypoint: []
+    command: bash -c "
+        ([[ $$NETWORK == \"mainnet\" ]] && $$CMD --mainnet) ||
+        ([[ $$NETWORK == \"testnet\" ]] && $$CMD --testnet /config/*testnet-genesis.json)
+      "
+    environment:
+      CMD: "cardano-wallet-byron serve --node-socket /ipc/node.socket --database /wallet-db --listen-address 0.0.0.0"
+      NETWORK:
+    restart: on-failure
+
+volumes:
+  node-mainnet-db:
+  node-testnet-db:
+  wallet-mainnet-db:
+  wallet-testnet-db:
+  node-ipc:
+  node-config:

data/lib/cardano_wallet.rb

@@ -0,0 +1,15 @@
+require "httparty"
+
+require_relative "cardano_wallet/version"
+require_relative "cardano_wallet/base"
+require_relative "cardano_wallet/utils"
+require_relative "cardano_wallet/shelley"
+require_relative "cardano_wallet/byron"
+require_relative "cardano_wallet/misc"
+require_relative "cardano_wallet/proxy"
+
+module CardanoWallet
+  def self.new(options = {})
+    CardanoWallet::Base.new(options)
+  end
+end

data/lib/cardano_wallet/base.rb

@@ -0,0 +1,47 @@
+module CardanoWallet
+  class Base
+    include HTTParty
+
+    attr_reader :opt
+
+    def initialize(opt = {})
+      raise ArgumentError, "argument should be Hash" unless opt.is_a?(Hash)
+
+      opt[:protocol] ||= 'http'
+      opt[:host] ||= 'localhost'
+      opt[:port] ||= 8090
+      opt[:url] ||= "#{opt[:protocol]}://#{opt[:host]}:#{opt[:port]}/v2"
+      opt[:cacert] ||= ''
+      opt[:pem] ||= ''
+      self.class.base_uri opt[:url]
+
+      unless opt[:cacert].empty?
+        ENV['SSL_CERT_FILE'] = opt[:cacert]
+        self.class.ssl_ca_file(File.read ENV['SSL_CERT_FILE'])
+      end
+      self.class.pem(File.read opt[:pem]) unless opt[:pem].empty?
+
+      @opt = opt
+    end
+
+    # Init API for Shelley
+    def shelley
+      Shelley.new @opt
+    end
+
+    # Init API for Byron
+    def byron
+      Byron.new @opt
+    end
+
+    # Init API for Misc
+    def misc
+      Misc.new @opt
+    end
+
+    # Init API for Proxy
+    def proxy
+      Proxy.new @opt
+    end
+  end
+end

data/lib/cardano_wallet/byron.rb

@@ -0,0 +1,238 @@
+module CardanoWallet
+  module Byron
+
+    def self.new(opt)
+      Init.new opt
+    end
+
+    class Init < Base
+      def initialize opt
+        super
+      end
+
+      # Get API for Byron wallets
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Byron-Wallets
+      def wallets
+        Wallets.new @opt
+      end
+
+      # Get API for Byron addresses
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Byron-Addresses
+      def addresses
+        Addresses.new @opt
+      end
+
+      # Get API for Byron transactions
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postByronTransactionFee
+      def transactions
+        Transactions.new @opt
+      end
+
+      # Get API for Byron migrations
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Byron-Migrations
+      def migrations
+        Migrations.new @opt
+      end
+    end
+
+    # Byron wallets
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Byron-Wallets
+    class Wallets < Base
+      def initialize opt
+        super
+      end
+
+      # List Byron wallets
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/listByronWallets
+      def list
+        self.class.get("/byron-wallets")
+      end
+
+      # Get Byron wallet details
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getByronWallet
+      def get(wid)
+        self.class.get("/byron-wallets/#{wid}")
+      end
+
+      # Create a Byron wallet based on the params.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postByronWallet
+      #
+      # @example
+      #   create({style: "random",
+      #           name: "Random Wallet from mnemonic_sentence",
+      #           passphrase: "Secure Passphrase",
+      #           mnemonic_sentence: %w[arctic decade pink easy jar index base bright vast ocean hard pizza],
+      #          })
+      def create(params)
+        Utils.verify_param_is_hash!(params)
+        self.class.post( "/byron-wallets",
+                         :body => params.to_json,
+                         :headers => { 'Content-Type' => 'application/json' }
+                        )
+      end
+
+      # Delete Byron wallet
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/deleteByronWallet
+      def delete(wid)
+        self.class.delete("/byron-wallets/#{wid}")
+      end
+
+      # Update Byron wallet's metadata
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/putByronWallet
+      #
+      # @example
+      #   update_metadata(wid, {name: "New wallet name"})
+      def update_metadata(wid, params)
+        Utils.verify_param_is_hash!(params)
+        self.class.put("/byron-wallets/#{wid}",
+                       :body => params.to_json,
+                       :headers => { 'Content-Type' => 'application/json' }
+                      )
+      end
+
+      # See Byron wallet's utxo distribution
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getByronUTxOsStatistics
+      def utxo(wid)
+        self.class.get("/byron-wallets/#{wid}/statistics/utxos")
+      end
+
+      # Update Byron wallet's passphrase.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/putByronWalletPassphrase
+      #
+      # @example
+      #   update_passphrase(wid, {old_passphrase: "Secure Passphrase", new_passphrase: "Securer Passphrase"})
+      def update_passphrase(wid, params)
+        Utils.verify_param_is_hash!(params)
+        self.class.put("/byron-wallets/#{wid}/passphrase",
+                       :body => params.to_json,
+                       :headers => { 'Content-Type' => 'application/json' }
+                      )
+      end
+    end
+
+    # Byron addresses
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Byron-Addresses
+    class Addresses < Base
+      def initialize opt
+        super
+      end
+
+      # List Byron addresses.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/listByronAddresses
+      #
+      # @example
+      #   list(wid, {state: "used"})
+      def list(wid, q = {})
+        q.empty? ? query = '' : query = Utils.to_query(q)
+        self.class.get("/byron-wallets/#{wid}/addresses#{query}")
+      end
+
+      # Create address for Byron random wallet.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/createAddress
+      # @param wid [String] wallet id
+      # @param params [Hash] passphrase and (optional) address_index
+      #
+      # @example Create address with index.
+      #   create(wid, {passphrase: "Secure Passphrase", address_index: 2147483648})
+      # @example Create address with random index.
+      #   create(wid, {passphrase: "Secure Passphrase"})
+      def create(wid, params)
+        Utils.verify_param_is_hash!(params)
+        self.class.post( "/byron-wallets/#{wid}/addresses",
+                         :body => params.to_json,
+                         :headers => { 'Content-Type' => 'application/json' }
+                        )
+      end
+
+      # Import address to Byron wallet.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/importAddress
+      # @param wid [String] wallet id
+      # @param addr_id [String] address id
+      def import(wid, addr_id)
+        self.class.put("/byron-wallets/#{wid}/addresses/#{addr_id}")
+      end
+
+    end
+
+    # Byron transactions
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postByronTransactionFee
+    class Transactions < Base
+      def initialize opt
+        super
+      end
+
+      # List all Byron wallet's transactions.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/listByronTransactions
+      #
+      # @example
+      #   list(wid, {start: "2012-09-25T10:15:00Z", order: "descending"})
+      def list(wid, q = {})
+        q.empty? ? query = '' : query = Utils.to_query(q)
+        self.class.get("/byron-wallets/#{wid}/transactions#{query}")
+      end
+
+      # Create a transaction from the Byron wallet.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postByronTransaction
+      # @param wid [String] source wallet id
+      # @param passphrase [String] source wallet's passphrase
+      # @param payments [Hash] addres, amount pair
+      #
+      # @example
+      #   create(wid, passphrase, {addr1: 1000000})
+      def create(wid, passphrase, payments)
+        payments_formatted = Utils.format_payments(payments)
+        self.class.post("/byron-wallets/#{wid}/transactions",
+        :body => { :payments => payments_formatted,
+                   :passphrase => passphrase
+                 }.to_json,
+        :headers => { 'Content-Type' => 'application/json' } )
+      end
+
+      # Estimate fees for transaction
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postTransactionFee
+      #
+      # @example
+      #   payment_fees(wid, {addr1: 1000000})
+      def payment_fees(wid, payments)
+        payments_formatted = Utils.format_payments(payments)
+        self.class.post("/byron-wallets/#{wid}/payment-fees",
+        :body => { :payments => payments_formatted }.to_json,
+        :headers => { 'Content-Type' => 'application/json' } )
+      end
+
+      # Forget a transaction.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/deleteByronTransaction
+      def forget(wid, txid)
+        self.class.delete("/byron-wallets/#{wid}/transactions/#{txid}")
+      end
+    end
+
+    # Byron migrations
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Byron-Migrations
+    class Migrations < Base
+      def initialize opt
+        super
+      end
+
+      # Calculate migration cost
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getByronWalletMigrationInfo
+      def cost(wid)
+        self.class.get("/byron-wallets/#{wid}/migrations")
+      end
+
+      # Migrate all funds from Byron wallet.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/migrateByronWallet
+      # @param wid [String] wallet id
+      # @param passphrase [String] wallet's passphrase
+      # @param [Array] array of addresses
+      def migrate(wid, passphrase, addresses)
+        self.class.post("/byron-wallets/#{wid}/migrations",
+        :body => { :addresses => addresses,
+                   :passphrase => passphrase
+                 }.to_json,
+        :headers => { 'Content-Type' => 'application/json' } )
+      end
+
+    end
+  end
+end

data/lib/cardano_wallet/misc.rb

@@ -0,0 +1,47 @@
+module CardanoWallet
+  module Misc
+
+    def self.new(opt)
+      Init.new opt
+    end
+
+    class Init < Base
+      def initialize opt
+        super
+      end
+
+      # Call API for Network
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Network
+      def network
+        Network.new @opt
+      end
+    end
+
+    # API for Network
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Network
+    class Network < Base
+      def initialize opt
+        super
+      end
+
+      # Get network information
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getNetworkInformation
+      def information
+        self.class.get("/network/information")
+      end
+
+      # Check network clock
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getNetworkClock
+      def clock
+        self.class.get("/network/clock")
+      end
+
+      # Check network parameters
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getNetworkParameters
+      def parameters(epoch_id)
+        self.class.get("/network/parameters/#{epoch_id}")
+      end
+
+    end
+  end
+end

data/lib/cardano_wallet/proxy.rb

@@ -0,0 +1,26 @@
+module CardanoWallet
+  module Proxy
+
+    # Call API for Proxy
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Proxy
+    def self.new(opt)
+      Init.new opt
+    end
+
+    class Init < Base
+      def initialize opt
+        super
+      end
+
+      # Submit a transaction that was created and signed outside of cardano-wallet.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postExternalTransaction
+      # @param binary_blob [String] Signed transaction message binary blob.
+      def submit_external_transaction(binary_blob)
+        self.class.post("/proxy/transactions",
+                        :body => binary_blob,
+                        :headers => { 'Content-Type' => 'application/octet-stream' })
+      end
+    end
+
+  end
+end

data/lib/cardano_wallet/shelley.rb

@@ -0,0 +1,254 @@
+module CardanoWallet
+  # Init API for Shelley
+  module Shelley
+
+    def self.new(opt)
+      Init.new opt
+    end
+
+    class Init < Base
+
+      def initialize opt
+        super
+      end
+
+      # Call API for Wallets
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Wallets
+      def wallets
+        Wallets.new @opt
+      end
+
+      # API for Addresses
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Addresses
+      def addresses
+        Addresses.new @opt
+      end
+
+      # API for CoinSelections
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Coin-Selections
+      def coin_selections
+        CoinSelections.new @opt
+      end
+
+      # API for Transactions
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Transactions
+      def transactions
+        Transactions.new @opt
+      end
+
+      # API for StakePools
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Stake-Pools
+      def stake_pools
+        StakePools.new @opt
+      end
+
+    end
+
+    # API for Wallets
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Wallets
+    class Wallets < Base
+      def initialize opt
+        super
+      end
+
+      # List all wallets
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/listWallets
+      def list
+        self.class.get("/wallets")
+      end
+
+      # Get wallet details
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getWallet
+      def get(wid)
+        self.class.get("/wallets/#{wid}")
+      end
+
+      # Create a wallet based on the params.
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postWallet
+      #
+      # @example Create wallet from mnemonic sentence
+      #   create({name: "Wallet from mnemonic_sentence",
+      #           passphrase: "Secure Passphrase",
+      #           mnemonic_sentence: %w[story egg fun dismiss gasp mad spoon human cloud become garbage panel rhythm knee help],
+      #          })
+      # @example Create wallet from pub key
+      #   create({name: "Wallet from pub key",
+      #           account_public_key: "b47546e661b6c1791452d003d375756dde6cac2250093ce4630f16b9b9c0ac87411337bda4d5bc0216462480b809824ffb48f17e08d95ab9f1b91d391e48e66b",
+      #           address_pool_gap: 20,
+      #          })
+      def create(params)
+        Utils.verify_param_is_hash!(params)
+        self.class.post( "/wallets",
+                         :body => params.to_json,
+                         :headers => { 'Content-Type' => 'application/json' }
+                        )
+      end
+
+      # Delete wallet
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/deleteWallet
+      def delete(wid)
+        self.class.delete("/wallets/#{wid}")
+      end
+
+      # Update wallet's metadata
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/putWallet
+      #
+      # @example
+      #   update_metadata(wid, {name: "New wallet name"})
+      def update_metadata(wid, params)
+        Utils.verify_param_is_hash!(params)
+        self.class.put("/wallets/#{wid}",
+                       :body => params.to_json,
+                       :headers => { 'Content-Type' => 'application/json' }
+                      )
+      end
+
+      # See wallet's utxo distribution
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getUTxOsStatistics
+      def utxo(wid)
+        self.class.get("/wallets/#{wid}/statistics/utxos")
+      end
+
+      # Update wallet's passphrase
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/putWalletPassphrase
+      #
+      # @example
+      #   update_passphrase(wid, {old_passphrase: "Secure Passphrase", new_passphrase: "Securer Passphrase"})
+      def update_passphrase(wid, params)
+        Utils.verify_param_is_hash!(params)
+        self.class.put("/wallets/#{wid}/passphrase",
+                       :body => params.to_json,
+                       :headers => { 'Content-Type' => 'application/json' }
+                      )
+      end
+    end
+
+    # API for Addresses
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Addresses
+    class Addresses < Base
+      def initialize opt
+        super
+      end
+
+      # List addresses
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/listAddresses
+      #
+      # @example
+      #   list(wid, {state: "used"})
+      def list(wid, q = {})
+        q.empty? ? query = '' : query = Utils.to_query(q)
+        self.class.get("/wallets/#{wid}/addresses#{query}")
+      end
+    end
+
+    # API for CoinSelections
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Coin-Selections
+    class CoinSelections < Base
+      def initialize opt
+        super
+      end
+
+      # Show random coin selection for particular payment
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/selectCoins
+      #
+      # @example
+      #   random(wid, {address1: 123, address2: 456})
+      def random(wid, payments)
+        payments_formatted = Utils.format_payments(payments)
+        self.class.post("/wallets/#{wid}/coin-selections/random",
+                        :body => {:payments => payments_formatted}.to_json,
+                        :headers => { 'Content-Type' => 'application/json' })
+      end
+    end
+
+    # API for Transactions
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Transactions
+    class Transactions < Base
+      def initialize opt
+        super
+      end
+
+      # List all wallet's transactions
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/listTransactions
+      #
+      # @example
+      #   list(wid, {start: "2012-09-25T10:15:00Z", order: "descending"})
+      def list(wid, q = {})
+        q.empty? ? query = '' : query = Utils.to_query(q)
+        self.class.get("/wallets/#{wid}/transactions#{query}")
+      end
+
+      # Create a transaction from the wallet
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postTransaction
+      # @param wid [String] source wallet id
+      # @param passphrase [String] source wallet's passphrase
+      # @param payments [Hash] addres, amount pair
+      #
+      # @example
+      #   create(wid, passphrase, {addr1: 1000000})
+      def create(wid, passphrase, payments)
+        payments_formatted = Utils.format_payments(payments)
+        self.class.post("/wallets/#{wid}/transactions",
+        :body => { :payments => payments_formatted,
+                   :passphrase => passphrase
+                 }.to_json,
+        :headers => { 'Content-Type' => 'application/json' } )
+
+      end
+
+      # Estimate fees for transaction
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/postTransactionFee
+      #
+      # @example
+      #   payment_fees(wid, {addr1: 1000000})
+      def payment_fees(wid, payments)
+        payments_formatted = Utils.format_payments(payments)
+        self.class.post("/wallets/#{wid}/payment-fees",
+        :body => { :payments => payments_formatted }.to_json,
+        :headers => { 'Content-Type' => 'application/json' } )
+      end
+
+      # Forget a transaction
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/deleteTransaction
+      def forget(wid, txid)
+        self.class.delete("/wallets/#{wid}/transactions/#{txid}")
+      end
+    end
+
+    # API for StakePools
+    # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#tag/Stake-Pools
+    class StakePools < Base
+      def initialize opt
+        super
+      end
+
+      # List all stake pools
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/listStakePools
+      def list
+        self.class.get("/stake-pools")
+      end
+
+      # Join stake pool
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/joinStakePool
+      def join(sp_id, wid, passphrase)
+        self.class.put("/stake-pools/#{sp_id}/wallets/#{wid}",
+        :body => { :passphrase => passphrase }.to_json,
+        :headers => { 'Content-Type' => 'application/json' } )
+      end
+
+      # Quit stape pool
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/quitStakePool
+      def quit(wid, passphrase)
+        self.class.delete("#{@api}/stake-pools/*/wallets/#{wid}",
+        :body => { :passphrase => passphrase }.to_json,
+        :headers => { 'Content-Type' => 'application/json' } )
+      end
+
+      # Estimate delegation fees
+      # @see https://input-output-hk.github.io/cardano-wallet/api/edge/#operation/getDelegationFee
+      def delegation_fees(wid)
+        self.class.get("/wallets/#{wid}/delegation-fees")
+      end
+    end
+  end
+end

data/lib/cardano_wallet/utils.rb

@@ -0,0 +1,27 @@
+module CardanoWallet
+  module Utils
+
+    def self.verify_param_is_hash!(param)
+      raise ArgumentError, "argument should be Hash" unless param.is_a?(Hash)
+    end
+
+    def self.format_payments(payments)
+      verify_param_is_hash!(payments)
+      payments.collect do |addr, amt|
+        {:address => addr.to_s,
+         :amount => {:quantity => amt.to_i,
+                     :unit => "lovelace"}
+        }
+      end
+    end
+
+    def self.to_query(query)
+      verify_param_is_hash!(query)
+      q = query.collect do |k, v|
+        "#{k}=#{v}"
+      end.join '&'
+      "?#{q}"
+    end
+
+  end
+end

data/lib/cardano_wallet/version.rb

@@ -0,0 +1,3 @@
+module CardanoWallet
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: cardano_wallet
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Piotr Stachyra
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-05-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby wrapper over cardano-wallet.
+email:
+- piotr.stachyra@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/gem-push.yml"
+- ".github/workflows/tests.yml"
+- ".gitignore"
+- ".rakeTasks"
+- ".rspec"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- cardano_wallet.gemspec
+- docker-compose.yml
+- lib/cardano_wallet.rb
+- lib/cardano_wallet/base.rb
+- lib/cardano_wallet/byron.rb
+- lib/cardano_wallet/misc.rb
+- lib/cardano_wallet/proxy.rb
+- lib/cardano_wallet/shelley.rb
+- lib/cardano_wallet/utils.rb
+- lib/cardano_wallet/version.rb
+homepage: https://github.com/piotr-iohk/cardano-wallet-rb
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org/
+  homepage_uri: https://github.com/piotr-iohk/cardano-wallet-rb
+  source_code_uri: https://github.com/piotr-iohk/cardano-wallet-rb
+  changelog_uri: https://github.com/piotr-iohk/cardano-wallet-rb
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper over cardano-wallet.
+test_files: []