mobius-client 0.1.0

data/lib/mobius/client/blockchain/account.rb

@@ -0,0 +1,88 @@
+# Service class used to interact with account on Stellar network.
+class Mobius::Client::Blockchain::Account
+  extend Dry::Initializer
+
+  # @!method initialize(keypair)
+  # @param keypair [Stellar::Keypair] account keypair
+  # @!scope instance
+  param :keypair
+
+  # Returns true if trustline exists for given asset and limit is positive.
+  # @param asset [Stellar::Asset] Stellar asset to check or :native
+  # @return [Boolean] true if trustline exists
+  def trustline_exists?(asset = Mobius::Client.stellar_asset)
+    balance = find_balance(asset)
+    (balance && !balance.dig("limit").to_f.zero?) || false
+  end
+
+  # Returns balance for given asset
+  # @param asset [Stellar::Asset] Stellar asset to check or :native
+  # @return [Float] Balance value.
+  def balance(asset = Mobius::Client.stellar_asset)
+    balance = find_balance(asset)
+    balance && balance.dig("balance").to_f
+  end
+
+  # Returns true if given keypair is added as cosigner to current account.
+  # @param to_keypair [Stellar::Keypair] Keypair in question
+  # @return [Boolean] true if cosigner added
+  # TODO: Add weight check/return
+  def authorized?(to_keypair)
+    !find_signer(to_keypair.address).nil?
+  end
+
+  # Returns Stellar::Account instance for given keypair.
+  # @return [Stellar::Account] instance
+  def account
+    @account ||=
+      if keypair.sign?
+        Stellar::Account.from_seed(keypair.seed)
+      else
+        Stellar::Account.from_address(keypair.address)
+      end
+  end
+
+  # Requests and caches Stellar::Account information from network.
+  # @return [Stellar::Account] account information.
+  def info
+    @info ||= Mobius::Client.horizon_client.account_info(account)
+  end
+
+  # Invalidates account information cache.
+  def reload!
+    @info = nil
+  end
+
+  # Invalidates cache and returns next sequence value for given account.
+  # @return [Integer] sequence value.
+  def next_sequence_value
+    reload!
+    info.sequence.to_i + 1
+  end
+
+  private
+
+  def find_balance(asset)
+    info.balances.find { |balance| balance_matches?(asset, balance) }
+  rescue Faraday::ResourceNotFound
+    raise Mobius::Client::Error::AccountMissing
+  end
+
+  def balance_matches?(asset, balance)
+    if [:native, Stellar::Asset.native].include?(asset)
+      balance["asset_type"] == "native"
+    else
+      code = balance["asset_code"]
+      issuer = balance["asset_issuer"]
+      asset_issuer_address = Mobius::Client.to_keypair(asset.issuer).address
+      code == asset.code && issuer == asset_issuer_address
+    end
+  end
+
+  # TODO: Think of adding weight check here
+  def find_signer(address)
+    info.signers.find { |s| s["public_key"] == address }
+  rescue Faraday::ResourceNotFound
+    raise Mobius::Client::Error::AccountMissing
+  end
+end

data/lib/mobius/client/blockchain/add_cosigner.rb

@@ -0,0 +1,58 @@
+# Adds account as cosigner to other account.
+class Mobius::Client::Blockchain::AddCosigner
+  extend Dry::Initializer
+
+  # @!method initialize(keypair)
+  # @param keypair [Stellar::Keypair] Account keypair
+  # @param cosigner_keypair [Stellar::Keypair] Cosigner account keypair
+  # @param weight [Integer] Cosigner weight, default: 1
+  # @!scope instance
+  param :keypair
+  param :cosigner_keypair
+  param :weight, default: -> { 1 }
+
+  # Executes an operation
+  def call
+    client.horizon.transactions._post(
+      tx: tx.to_envelope(keypair).to_xdr(:base64)
+    )
+  rescue Faraday::ResourceNotFound
+    raise Mobius::Client::Error::AccountMissing
+  end
+
+  # Executes an operation
+  class << self
+    def call(*args)
+      new(*args).call
+    end
+  end
+
+  private
+
+  # TODO: weight must be params
+  def tx
+    Stellar::Transaction.set_options(
+      account: keypair,
+      sequence: account.next_sequence_value,
+      signer: signer,
+      master_weight: 10,
+      highThreshold: 10,
+      medThreshold: 1,
+      lowThreshold: 1
+    )
+  end
+
+  def signer
+    Stellar::Signer.new(
+      key: Stellar::SignerKey.new(:signer_key_type_ed25519, cosigner_keypair.raw_public_key), weight: weight
+    )
+  end
+
+  def account
+    @account ||= Mobius::Client::Blockchain::Account.new(keypair)
+  end
+
+  def client
+    @client ||= Mobius::Client.horizon_client
+  end
+end

data/lib/mobius/client/blockchain/create_trustline.rb

@@ -0,0 +1,42 @@
+# Creates unlimited trustline for given asset.
+class Mobius::Client::Blockchain::CreateTrustline
+  extend Dry::Initializer
+
+  # ruby-stellar-base needs to be fixed, it does not accept unlimited now
+  LIMIT = 922337203685
+
+  param :keypair
+  param :asset, default: -> { Mobius::Client.stellar_asset }
+
+  def call
+    client.horizon.transactions._post(tx: tx.to_envelope(keypair).to_xdr(:base64))
+  rescue Faraday::ResourceNotFound
+    raise Mobius::Client::Error::AccountMissing
+  end
+
+  # TODO: DRY
+  class << self
+    def call(*args)
+      new(*args).call
+    end
+  end
+
+  private
+
+  def tx
+    Stellar::Transaction.change_trust(
+      account: keypair,
+      line: [:alphanum4, asset.code, Mobius::Client.to_keypair(asset.issuer)],
+      limit: LIMIT,
+      sequence: account.next_sequence_value
+    )
+  end
+
+  def account
+    @account ||= Mobius::Client::Blockchain::Account.new(keypair)
+  end
+
+  def client
+    @client ||= Mobius::Client.horizon_client
+  end
+end

data/lib/mobius/client/blockchain/friend_bot.rb

@@ -0,0 +1,16 @@
+# Calls Stellar FriendBot
+class Mobius::Client::Blockchain::FriendBot
+  extend Dry::Initializer
+
+  param :keypair
+
+  def call
+    Mobius::Client.horizon_client.horizon.friendbot._post(addr: keypair.address)
+  end
+
+  class << self
+    def call(*args)
+      new(*args).call
+    end
+  end
+end

data/lib/mobius/client/blockchain/key_pair_factory.rb

@@ -0,0 +1,42 @@
+# Transforms given value into Stellar::Keypair object.
+module Mobius::Client::Blockchain::KeyPairFactory
+  class << self
+    # rubocop:disable Metrics/MethodLength, Metrics/CyclomaticComplexity
+    # Generates Stellar::Keypair from subject, use Stellar::Client.to_keypair as shortcut.
+    # @param subject [String||Stellar::Account||Stellar::PublicKey||Stellar::SignerKey||Stellar::Keypair] subject.
+    # @return [Stellar::Keypair] Stellar::Keypair instance.
+    def produce(subject)
+      case subject
+      when String
+        from_string(subject)
+      when Stellar::Account
+        subject.keypair
+      when Stellar::PublicKey
+        from_public_key(subject)
+      when Stellar::SignerKey
+        from_secret_key(subject)
+      when Stellar::KeyPair
+        subject
+      else
+        raise Mobius::Client::Error::UnknownKeyPairType, "Unknown KeyPair type: #{subject.class.name}"
+      end
+    rescue ArgumentError => e
+      raise Mobius::Client::Error::UnknownKeyPairType, "Unknown KeyPair type: #{e.message}"
+    end
+    # rubocop:enable Metrics/MethodLength, Metrics/CyclomaticComplexity
+
+    private
+
+    def from_string(subject)
+      subject[0] == "S" ? Stellar::KeyPair.from_seed(subject) : Stellar::KeyPair.from_address(subject)
+    end
+
+    def from_public_key(subject)
+      Stellar::KeyPair.from_public_key(subject.value)
+    end
+
+    def from_secret_key(subject)
+      Stellar::KeyPair.from_raw_seed(subject.value)
+    end
+  end
+end

data/lib/mobius/client/error.rb

@@ -0,0 +1,49 @@
+class Mobius::Client::Error < StandardError
+  # Raised if stellar account is missing on network
+  class AccountMissing < self
+    def to_s
+      @message || "Stellar account does not exists"
+    end
+  end
+
+  # Raised if there is insufficient balance for payment
+  class InsufficientFunds < self
+  end
+
+  # Raised if transaction in question has invalid structure
+  class MalformedTransaction < self
+  end
+
+  # Raised if transaction has expired.
+  class TokenExpired < self
+  end
+
+  # Raised if transaction has expired (strict mode).
+  class TokenTooOld < self
+  end
+
+  # Raises if account does not contain MOBI trustline
+  class TrustlineMissing < self
+    def to_s
+      @message || "Trustline not found"
+    end
+  end
+
+  # Raises if account does not contain MOBI trustline
+  class AuthorisationMissing < self
+    def to_s
+      @message || "Authorisation missing"
+    end
+  end
+
+  # Raised in transaction in question has invalid or does not have required signatures
+  class Unauthorized < self
+    def to_s
+      @message || "Given transaction signature invalid"
+    end
+  end
+
+  # Raised if unknown or empty value has passed to KeyPairFactory
+  class UnknownKeyPairType < self
+  end
+end

data/lib/mobius/client/friend_bot.rb

@@ -0,0 +1,33 @@
+# Calls Mobius FriendBot for given account.
+class Mobius::Client::FriendBot
+  extend Dry::Initializer
+
+  param :seed
+  param :amount, default: -> { 1000 }
+
+  def call
+    response = http.post(ENDPOINT, addr: seed, amount: amount)
+    return true if response.success?
+    raise "FriendBot failed to respond: #{response.body}"
+  end
+
+  class << self
+    def call(*args)
+      new(*args).call
+    end
+  end
+
+  private
+
+  def http
+    # Mobius::Client.mobius_host
+    Faraday.new(MOBIUS_HOST) do |c|
+      c.request :url_encoded
+      c.response :json, content_type: /\bjson$/
+      c.adapter Faraday.default_adapter
+    end
+  end
+
+  ENDPOINT = "/api/stellar/friendbot".freeze
+  MOBIUS_HOST = "https://mobius.network".freeze
+end

data/lib/mobius/client/version.rb

@@ -0,0 +1,5 @@
+module Mobius
+  module Client
+    VERSION = "0.1.0".freeze
+  end
+end

data/mobius-client.gemspec

@@ -0,0 +1,51 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "mobius/client/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "mobius-client"
+  spec.version       = Mobius::Client::VERSION
+  spec.authors       = ["Viktor Sokolov"]
+  spec.email         = ["gzigzigzeo@gmail.com"]
+
+  spec.summary       = %(Mobius Ruby Client)
+  spec.description   = %(Mobius Ruby Client)
+  spec.homepage      = "https://github.com/mobius-network/mobius-client-ruby"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  end
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |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_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "bundler-audit", "~> 0.6.0"
+  spec.add_development_dependency "httplog", "~> 1.0", ">= 1.0.2"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop", "~> 0.53"
+  spec.add_development_dependency "rubocop-rspec", "~> 1.23"
+  spec.add_development_dependency "simplecov", ">= 0.16.1"
+  spec.add_development_dependency "simplecov-console", ">= 0.4.2"
+  spec.add_development_dependency "timecop", "~> 0.9", ">= 0.9.1"
+  spec.add_development_dependency "vcr", "~> 3.0", ">= 3.0.3"
+  spec.add_development_dependency "webmock", "~> 3.3"
+  spec.add_development_dependency "yard", "~> 0.9", ">= 0.9.12"
+
+  spec.add_dependency "dry-initializer", "~> 2.4"
+  spec.add_dependency "faraday", "~> 0.14"
+  spec.add_dependency "faraday_middleware", "~> 0.12", ">= 0.12.2"
+  spec.add_dependency "jwt", "~> 1.5", ">= 1.5.6"
+  spec.add_dependency "stellar-sdk", "~> 0.3"
+  spec.add_dependency "thor", "~> 0.20"
+end

data/template/dev-wallet.html.erb

@@ -0,0 +1,109 @@
+<html>
+  <head>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/semantic-ui/2.3.1/semantic.min.css">
+    <style>
+      .ui.container {
+        margin: 2em 0em;
+      }
+
+      .ui.container > h1 {
+        font-size: 3em;
+      }
+
+      .ui.container > h2.dividing.header {
+        font-size: 2em;
+        font-weight: normal;
+        margin: 2em 0em 1em;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="ui container">
+      <h1>Mobius Wallet App Dev Auth</h1>
+
+      <h2 class="ui dividing header">Application</h2>
+
+      <form class="ui form">
+        <div class="field">
+          <label>Auth endpoint:</label>
+          <input type="text" value="http://localhost:3000/auth" id="url"></input>
+        </div>
+        <div class="field">
+          <label>Redirect URI:</label>
+          <input type="text" value="http://localhost:3000" id="redirect_url"></input>
+        </div>
+        <div class="field">
+          <label>Public Key:</label>
+          <input type="text" value="<%= app_keypair.address %>"></input>
+        </div>
+        <div class="field">
+          <label>Private Key:</label>
+          <input type="text" value="<%= app_keypair.seed %>"></input>
+        </div>
+      </form>
+
+      <% {
+        "Normal Account" => normal,
+        "Zero Balance Account" => zero_balance,
+        "Unauthorized Account" => unauthorized
+      }.each do |label, keypair| %>
+
+      <h2 class="ui dividing header"><%= label %></h2>
+
+      <form class="ui form">
+        <div class="field">
+          <input type="text" value="<%= keypair.address %>" />
+        </div>
+        <div class="field">
+          <input type="text" value="<%= keypair.seed %>" class="seed" />
+        </div>
+        <div class="field">
+          <input type="submit" class="ui button green" value="Open" />
+        </div>
+      </form>
+
+      <% end %>
+    </div>
+  </body>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/stellar-sdk/0.8.0/stellar-sdk.js"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/axios/0.18.0/axios.min.js"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/semantic-ui/2.3.1/semantic.min.js"></script>
+  <script>
+    StellarSdk.Network.useTestNetwork()
+
+    $(function() {
+      $(".ui.button").on('click', function(e) {
+        e.preventDefault();
+        var seed = $(e.target).closest('.ui.form').find('.seed:first').val();
+        var keypair = StellarSdk.Keypair.fromSecret(seed);
+        var endpoint = $('#url').val();
+
+        var showError = function(err) {
+          if (err) {
+            alert(err);
+          }
+        }
+
+        // NOTE: this should be replaced with mobius js sdk calls
+        axios.get(endpoint).then(function(response) {
+          var xdr = response.data;
+          var tx = new StellarSdk.Transaction(xdr);
+          tx.sign(keypair);
+          var signedChallenge = tx.toEnvelope().toXDR("base64");
+          axios({
+            url: endpoint,
+            method: 'post',
+            params: {
+              xdr: signedChallenge,
+              public_key: keypair.publicKey()
+            }
+          }).then(function(response) {
+            var url = $('#redirect_url').val();
+            document.location = url + '?token=' + response.data;
+          }).catch(showError);
+        }).catch(showError);
+      });
+    });
+  </script>
+</html>