lnd-client 0.0.3 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4f21139f58c13fceea576b5df5c9d799e24591281e4bd6a9132fd7a719fc549
-  data.tar.gz: fb569472611c466c28cf03519e1c756dee704bdf22b21381c3c355cfa983c573
+  metadata.gz: 8858aaa4661fcc83da3c661a1b05d9be7d8513eeda78ace138f9d92948e345df
+  data.tar.gz: 8006682ff281b1fc745562deb2a58a464c9a09a4c47b564c2db67819fe8224bc
 SHA512:
-  metadata.gz: 83f2cce7e6334695e3118ac9dd3ed6bb4c76a1aefdbacafba6a4af785d239e0c475faadf6104392cde059928409e0603e42a84e9fa91bc180a7ccd56a55a7eaa
-  data.tar.gz: cd147a319c1f02c50e19fb220b6dedbe7357d0680530b8a305f083d50c731c2afb8da5ac90d67b7984b1022c61e398cd2326f1fd27e050af4d471375fc3e720a
+  metadata.gz: 41b85876608369aa56185424294a7c10e5a39938ceba028bc8326312adbe23d51c285a074eff5b3f5646b541c60673c00c27508674dc3beff88184a8eca2fdc2
+  data.tar.gz: 57df549dcc4b4c63c5a0f873393cc731e1242e2abddd030c95d64e16bb330998d26343061993b9ffa14c51a29e7181829a64453d82b6804254c0ff10d41cf1ad

data/Gemfile

@@ -6,6 +6,6 @@ gemspec
 
 group :test, :development do
   gem 'pry-byebug', '~> 3.10', '>= 3.10.1'
-  gem 'rubocop', '~> 1.44', '>= 1.44.1'
+  gem 'rubocop', '~> 1.45', '>= 1.45.1'
   gem 'rubocop-rake', '~> 0.6.0'
 end

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    lnd-client (0.0.3)
-      grpc (~> 1.51)
+    lnd-client (0.0.5)
+      grpc (~> 1.52)
 
 GEM
   remote: https://rubygems.org/
@@ -13,13 +13,13 @@ GEM
     google-protobuf (3.21.12)
     googleapis-common-protos-types (1.5.0)
       google-protobuf (~> 3.14)
-    grpc (1.51.0)
+    grpc (1.52.0-x86_64-linux)
       google-protobuf (~> 3.21)
       googleapis-common-protos-types (~> 1.0)
     json (2.6.3)
     method_source (1.0.0)
     parallel (1.22.1)
-    parser (3.2.0.0)
+    parser (3.2.1.0)
       ast (~> 2.4.1)
     pry (0.14.2)
       coderay (~> 1.1)
@@ -28,9 +28,9 @@ GEM
       byebug (~> 11.0)
       pry (>= 0.13, < 0.15)
     rainbow (3.1.1)
-    regexp_parser (2.6.2)
+    regexp_parser (2.7.0)
     rexml (3.2.5)
-    rubocop (1.44.1)
+    rubocop (1.45.1)
       json (~> 2.3)
       parallel (~> 1.10)
       parser (>= 3.2.0.0)
@@ -40,8 +40,8 @@ GEM
       rubocop-ast (>= 1.24.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.24.1)
-      parser (>= 3.1.1.0)
+    rubocop-ast (1.26.0)
+      parser (>= 3.2.1.0)
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
     ruby-progressbar (1.11.0)
@@ -53,7 +53,7 @@ PLATFORMS
 DEPENDENCIES
   lnd-client!
   pry-byebug (~> 3.10, >= 3.10.1)
-  rubocop (~> 1.44, >= 1.44.1)
+  rubocop (~> 1.45, >= 1.45.1)
   rubocop-rake (~> 0.6.0)
 
 BUNDLED WITH

data/README.md

@@ -2,6 +2,8 @@
 
 > ⚠️ Warning: Early-stage, breaking changes are expected.
 
+This is a low-level client library. For a better experience, you may want to check out the [Lighstorm](https://github.com/icebaker/lighstorm) abstraction.
+
 - [Usage](#usage)
   - [Channel Arguments](#channel-arguments)
   - [Documentation](#documentation)
@@ -14,13 +16,13 @@
 Add to your `Gemfile`:
 
 ```ruby
-gem 'lnd-client', '~> 0.0.3'
+gem 'lnd-client', '~> 0.0.5'
 ```
 
 ```ruby
 require 'lnd-client'
 
-puts LNDClient.version # => 0.0.3
+puts LNDClient.version # => 0.0.5
 
 client = LNDClient.new(
   certificate_path: '/lnd/tls.cert',
@@ -56,7 +58,7 @@ end
 ```ruby
 require 'lnd-client'
 
-puts LNDClient.version # => 0.0.3
+puts LNDClient.version # => 0.0.5
 
 client = LNDClient.new(
   certificate_path: '/lnd/tls.cert',
@@ -79,7 +81,7 @@ graph.edges # => [...]
 ```ruby
 require 'lnd-client'
 
-puts LNDClient.version # => 0.0.3
+puts LNDClient.version # => 0.0.5
 
 client = LNDClient.new(
   certificate_path: '/lnd/tls.cert',
@@ -146,5 +148,5 @@ gem build lnd-client.gemspec
 
 gem signin
 
-gem push lnd-client-0.0.3.gem
+gem push lnd-client-0.0.5.gem
 ```

data/Rakefile

@@ -5,6 +5,6 @@ require_relative './controllers/grpc_generator'
 namespace :grpc do
   desc 'Upgrade lnd Protocol Buffers for gGRPC'
   task :upgrade do
-    GrpcGeneratorController.upgrade!
+    LNDClientInternal::GrpcGeneratorController.upgrade!
   end
 end

data/components/grpc.rb

@@ -3,9 +3,11 @@
 require_relative './grpc/lightning_services_pb'
 require_relative './grpc/routerrpc/router_services_pb'
 
-module GRPC
-  SERVICES = {
-    lightning: Lnrpc::Lightning,
-    router: Routerrpc::Router
-  }.freeze
+module LNDClientInternal
+  module GRPC
+    SERVICES = {
+      lightning: Lnrpc::Lightning,
+      router: Routerrpc::Router
+    }.freeze
+  end
 end

data/controllers/client.rb

@@ -4,28 +4,34 @@ require_relative '../components/grpc'
 require_relative 'config'
 require_relative 'service'
 
-class ClientController
-  attr_reader :config, :doc
+module LNDClientInternal
+  class ClientController
+    attr_reader :config, :doc
 
-  def initialize(options)
-    @config = ConfigController.new(self, options)
-    @services = {}
+    def initialize(options)
+      @config = LNDClientInternal::ConfigController.new(self, options)
+      @services = {}
 
-    doc = Struct.new(:services)
-    @doc = doc.new(GRPC::SERVICES.keys.map(&:to_s))
-  end
+      doc = Struct.new(:services)
+      @doc = doc.new(LNDClientInternal::GRPC::SERVICES.keys.map(&:to_s))
+    end
 
-  def respond_to_missing?(method_name, include_private = false)
-    service_key = method_name.to_sym
+    def respond_to_missing?(method_name, include_private = false)
+      service_key = method_name.to_sym
 
-    GRPC::SERVICES.include?(service_key) || super
-  end
+      LNDClientInternal::GRPC::SERVICES.include?(service_key) || super
+    end
 
-  def method_missing(method_name, *args)
-    service_key = method_name.to_sym
+    def method_missing(method_name, *args)
+      service_key = method_name.to_sym
 
-    raise ArgumentError, "Method `#{method_name}` doesn't exist." unless GRPC::SERVICES.include?(service_key)
+      unless LNDClientInternal::GRPC::SERVICES.include?(service_key)
+        raise ArgumentError, "Method `#{method_name}` doesn't exist."
+      end
 
-    @services[service_key] ||= ServiceController.new(self, GRPC::SERVICES[service_key], *args)
+      @services[service_key] ||= LNDClientInternal::ServiceController.new(
+        self, LNDClientInternal::GRPC::SERVICES[service_key], *args
+      )
+    end
   end
 end

data/controllers/config.rb

@@ -2,34 +2,36 @@
 
 require 'grpc'
 
-class ConfigController
-  attr_reader :socket_address, :credentials, :certificate, :macaroon
+module LNDClientInternal
+  class ConfigController
+    attr_reader :socket_address, :credentials, :certificate, :macaroon
 
-  def initialize(client, options)
-    @client = client
+    def initialize(client, options)
+      @client = client
 
-    @certificate_path = options[:certificate_path]
-    @certificate = options[:certificate]
+      @certificate_path = options[:certificate_path]
+      @certificate = options[:certificate]
 
-    @macaroon_path = options[:macaroon_path]
-    @macaroon = options[:macaroon]
+      @macaroon_path = options[:macaroon_path]
+      @macaroon = options[:macaroon]
 
-    @socket_address = options[:socket_address] || '127.0.0.1:10009'
+      @socket_address = options[:socket_address] || '127.0.0.1:10009'
 
-    setup_certificate!
-    setup_macaroon!
-  end
+      setup_certificate!
+      setup_macaroon!
+    end
 
-  def setup_certificate!
-    raise 'conflicting options for certificate' if @certificate && @certificate_path
+    def setup_certificate!
+      raise 'conflicting options for certificate' if @certificate && @certificate_path
 
-    @certificate = File.read(@certificate_path) if @certificate_path
-    @credentials = GRPC::Core::ChannelCredentials.new(@certificate)
-  end
+      @certificate = File.read(@certificate_path) if @certificate_path
+      @credentials = ::GRPC::Core::ChannelCredentials.new(@certificate)
+    end
 
-  def setup_macaroon!
-    raise 'conflicting options for macaroon' if @macaroon && @macaroon_path
+    def setup_macaroon!
+      raise 'conflicting options for macaroon' if @macaroon && @macaroon_path
 
-    @macaroon = File.read(@macaroon_path).unpack('H*') if @macaroon_path
+      @macaroon = File.read(@macaroon_path).unpack('H*') if @macaroon_path
+    end
   end
 end

data/controllers/documentation.rb

@@ -2,44 +2,46 @@
 
 require_relative '../logic/string'
 
-class DocumentationController
-  attr_reader :available_methods
+module LNDClientInternal
+  class DocumentationController
+    attr_reader :available_methods
 
-  def initialize(service)
-    @service = service
-    @descriptions = {}
-    @grpc = {}
+    def initialize(service)
+      @service = service
+      @descriptions = {}
+      @grpc = {}
 
-    build!
-  end
+      build!
+    end
 
-  def build!
-    @available_methods = @service.service.rpc_descs.values.map do |desc|
-      method_name = StringLogic.underscore(desc.name.to_s)
+    def build!
+      @available_methods = @service.service.rpc_descs.values.map do |desc|
+        method_name = LNDClientInternal::StringLogic.underscore(desc.name.to_s)
 
-      build_description!(method_name, desc)
+        build_description!(method_name, desc)
 
-      @grpc[method_name] = desc
+        @grpc[method_name] = desc
 
-      method_name
-    end.sort
-  end
+        method_name
+      end.sort
+    end
 
-  def build_description!(method_name, desc)
-    input = desc.input.new.to_h if desc.input.respond_to?(:new)
-    output = desc.output.new.to_h if desc.output.respond_to?(:new)
+    def build_description!(method_name, desc)
+      input = desc.input.new.to_h if desc.input.respond_to?(:new)
+      output = desc.output.new.to_h if desc.output.respond_to?(:new)
 
-    @descriptions[method_name] = { method: method_name }
+      @descriptions[method_name] = { method: method_name }
 
-    @descriptions[method_name][:input] = input if input
-    @descriptions[method_name][:output] = output if output
-  end
+      @descriptions[method_name][:input] = input if input
+      @descriptions[method_name][:output] = output if output
+    end
 
-  def describe(method_name)
-    @descriptions[method_name.to_s]
-  end
+    def describe(method_name)
+      @descriptions[method_name.to_s]
+    end
 
-  def grpc(method_name)
-    @grpc[method_name.to_s]
+    def grpc(method_name)
+      @grpc[method_name.to_s]
+    end
   end
 end

data/controllers/grpc_generator.rb

@@ -3,78 +3,80 @@
 require 'fileutils'
 require 'rainbow'
 
-module GrpcGeneratorController
-  REQUIRE_REGEX = /^require\s+['"].*_pb['"]/
+module LNDClientInternal
+  module GrpcGeneratorController
+    REQUIRE_REGEX = /^require\s+['"].*_pb['"]/
 
-  def self.upgrade!
-    cleanup!
+    def self.upgrade!
+      cleanup!
 
-    download!
+      download!
 
-    Dir['temp/grpc-upgrade/lnd/lnrpc/**/*.proto'].each do |proto_file|
-      next if proto_file =~ /googleapis/
+      Dir['temp/grpc-upgrade/lnd/lnrpc/**/*.proto'].each do |proto_file|
+        next if proto_file =~ /googleapis/
 
-      run!(generate_command(proto_file.sub('temp/grpc-upgrade/lnd/lnrpc/', '')), print_output: true)
-    end
+        run!(generate_command(proto_file.sub('temp/grpc-upgrade/lnd/lnrpc/', '')), print_output: true)
+      end
 
-    fix_requires!
+      fix_requires!
 
-    remove_references!
+      remove_references!
 
-    puts "\nDone!"
-  end
+      puts "\nDone!"
+    end
 
-  def self.remove_references!
-    run!('rm -rf temp/grpc-upgrade', print_output: false)
-  end
+    def self.remove_references!
+      run!('rm -rf temp/grpc-upgrade', print_output: false)
+    end
 
-  def self.cleanup!
-    run!('rm -rf components/grpc', print_output: false)
-    run!('rm -rf temp/grpc-upgrade', print_output: false)
+    def self.cleanup!
+      run!('rm -rf components/grpc', print_output: false)
+      run!('rm -rf temp/grpc-upgrade', print_output: false)
 
-    FileUtils.mkdir_p('components/grpc')
-    FileUtils.mkdir_p('temp/grpc-upgrade')
-  end
+      FileUtils.mkdir_p('components/grpc')
+      FileUtils.mkdir_p('temp/grpc-upgrade')
+    end
 
-  def self.download!
-    run!('git clone https://github.com/lightningnetwork/lnd.git temp/grpc-upgrade/lnd', print_output: false)
-    run!('git clone https://github.com/googleapis/googleapis.git temp/grpc-upgrade/lnd/lnrpc/googleapis',
-         print_output: false)
-  end
+    def self.download!
+      run!('git clone https://github.com/lightningnetwork/lnd.git temp/grpc-upgrade/lnd', print_output: false)
+      run!('git clone https://github.com/googleapis/googleapis.git temp/grpc-upgrade/lnd/lnrpc/googleapis',
+           print_output: false)
+    end
 
-  def self.generate_command(proto_file)
-    [
-      'cd temp/grpc-upgrade/lnd/lnrpc/; grpc_tools_ruby_protoc',
-      '--proto_path googleapis:.',
-      '--ruby_out=../../../../components/grpc/',
-      '--grpc_out=../../../../components/grpc/',
-      proto_file
-    ].join(' ')
-  end
+    def self.generate_command(proto_file)
+      [
+        'cd temp/grpc-upgrade/lnd/lnrpc/; grpc_tools_ruby_protoc',
+        '--proto_path googleapis:.',
+        '--ruby_out=../../../../components/grpc/',
+        '--grpc_out=../../../../components/grpc/',
+        proto_file
+      ].join(' ')
+    end
 
-  def self.fix_requires!
-    5.times do
-      Dir['components/grpc/**/*.rb'].each do |file|
-        content = File.read(file)
-        next unless content =~ REQUIRE_REGEX
+    def self.fix_requires!
+      5.times do
+        Dir['components/grpc/**/*.rb'].each do |file|
+          content = File.read(file)
+          next unless content =~ REQUIRE_REGEX
 
-        apply!(file, content)
+          apply!(file, content)
+        end
       end
     end
-  end
 
-  def self.apply!(file, content)
-    old_code = content[REQUIRE_REGEX]
-    new_code = content[REQUIRE_REGEX].sub('require', 'require_relative')
+    def self.apply!(file, content)
+      old_code = content[REQUIRE_REGEX]
+      new_code = content[REQUIRE_REGEX].sub('require', 'require_relative')
 
-    puts "\n#{Rainbow('>').yellow} #{file}"
-    puts "  #{Rainbow(old_code).red} -> #{Rainbow(new_code).green}"
-    File.write(file, content.gsub(old_code, new_code))
-  end
+      puts "\n#{Rainbow('>').yellow} #{file}"
+      puts "  #{Rainbow(old_code).red} -> #{Rainbow(new_code).green}"
+      File.write(file, content.gsub(old_code, new_code))
+    end
 
-  def self.run!(command, print_output: false)
-    puts "\n#{Rainbow('>').yellow} #{command}"
-    output = `#{command}`
-    puts output if print_output
+    def self.run!(command, print_output: false)
+      puts "\n#{Rainbow('>').yellow} #{command}"
+      output = `#{command}`
+      puts output if print_output
+    end
   end
 end

data/controllers/service.rb

@@ -2,39 +2,41 @@
 
 require_relative './documentation'
 
-class ServiceController
-  attr_reader :doc, :service
-
-  def initialize(client, rpc, params = {})
-    @client = client
-    @rpc = rpc
-    @service = rpc.const_get(:Service)
-    @stub = rpc.const_get(:Stub).new(
-      client.config.socket_address,
-      client.config.credentials,
-      **params
-    )
-    @doc = DocumentationController.new(self)
-  end
-
-  def call!(method_key, desc, *args, &block)
-    @stub.method(method_key).call(
-      desc.input.new(*args),
-      { metadata: { macaroon: @client.config.macaroon } },
-      &block
-    )
-  end
-
-  def respond_to_missing?(method_name, include_private = false)
-    desc = @doc.grpc(method_name)
-    (desc && @stub.respond_to?(method_name)) || super
-  end
-
-  def method_missing(method_name, *args, &block)
-    desc = @doc.grpc(method_name)
-
-    raise ArgumentError, "Method `#{method_name}` doesn't exist." unless desc && @stub.respond_to?(method_name)
-
-    call!(method_name, desc, *args, &block)
+module LNDClientInternal
+  class ServiceController
+    attr_reader :doc, :service
+
+    def initialize(client, rpc, params = {})
+      @client = client
+      @rpc = rpc
+      @service = rpc.const_get(:Service)
+      @stub = rpc.const_get(:Stub).new(
+        client.config.socket_address,
+        client.config.credentials,
+        **params
+      )
+      @doc = LNDClientInternal::DocumentationController.new(self)
+    end
+
+    def call!(method_key, desc, *args, &block)
+      @stub.method(method_key).call(
+        desc.input.new(*args),
+        { metadata: { macaroon: @client.config.macaroon } },
+        &block
+      )
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      desc = @doc.grpc(method_name)
+      (desc && @stub.respond_to?(method_name)) || super
+    end
+
+    def method_missing(method_name, *args, &block)
+      desc = @doc.grpc(method_name)
+
+      raise ArgumentError, "Method `#{method_name}` doesn't exist." unless desc && @stub.respond_to?(method_name)
+
+      call!(method_name, desc, *args, &block)
+    end
   end
 end

data/lnd-client.gemspec

@@ -3,23 +3,23 @@
 require_relative 'static/spec'
 
 Gem::Specification.new do |spec|
-  spec.name    = Static::SPEC[:name]
-  spec.version = Static::SPEC[:version]
-  spec.authors = [Static::SPEC[:author]]
+  spec.name    = LNDClientInternal::Static::SPEC[:name]
+  spec.version = LNDClientInternal::Static::SPEC[:version]
+  spec.authors = [LNDClientInternal::Static::SPEC[:author]]
 
-  spec.summary = Static::SPEC[:summary]
-  spec.description = Static::SPEC[:description]
+  spec.summary = LNDClientInternal::Static::SPEC[:summary]
+  spec.description = LNDClientInternal::Static::SPEC[:description]
 
-  spec.homepage = Static::SPEC[:github]
+  spec.homepage = LNDClientInternal::Static::SPEC[:github]
 
-  spec.license = Static::SPEC[:license]
+  spec.license = LNDClientInternal::Static::SPEC[:license]
 
   spec.required_ruby_version = Gem::Requirement.new('>= 3.0.0')
 
   spec.metadata['allowed_push_host'] = 'https://rubygems.org'
 
   spec.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = Static::SPEC[:github]
+  spec.metadata['source_code_uri'] = LNDClientInternal::Static::SPEC[:github]
 
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject do |f|
@@ -29,7 +29,7 @@ Gem::Specification.new do |spec|
 
   spec.require_paths = ['ports/dsl']
 
-  spec.add_dependency 'grpc', '~> 1.51'
+  spec.add_dependency 'grpc', '~> 1.52'
 
   spec.metadata['rubygems_mfa_required'] = 'true'
 end

data/logic/string.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
-module StringLogic
-  def self.underscore(string)
-    string.gsub(/::/, '/')
-          .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
-          .gsub(/([a-z\d])([A-Z])/, '\1_\2')
-          .tr('-', '_')
-          .downcase
+module LNDClientInternal
+  module StringLogic
+    def self.underscore(string)
+      string.gsub(/::/, '/')
+            .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+            .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+            .tr('-', '_')
+            .downcase
+    end
   end
 end

data/ports/dsl/lnd-client.rb

@@ -5,10 +5,10 @@ require_relative '../../static/spec'
 
 module LNDClient
   def self.new(params)
-    ClientController.new(params)
+    LNDClientInternal::ClientController.new(params)
   end
 
   def self.version
-    Static::SPEC[:version]
+    LNDClientInternal::Static::SPEC[:version]
   end
 end

data/static/spec.rb

@@ -1,13 +1,15 @@
 # frozen_string_literal: true
 
-module Static
-  SPEC = {
-    name: 'lnd-client',
-    version: '0.0.3',
-    author: 'icebaker',
-    summary: 'Ruby Lightning Network Daemon (lnd) Client',
-    description: 'Ruby Lightning Network Daemon (lnd) Client',
-    github: 'https://github.com/icebaker/lnd-client',
-    license: 'MIT'
-  }.freeze
+module LNDClientInternal
+  module Static
+    SPEC = {
+      name: 'lnd-client',
+      version: '0.0.5',
+      author: 'icebaker',
+      summary: 'Ruby Lightning Network Daemon (lnd) Client',
+      description: 'Ruby Lightning Network Daemon (lnd) Client',
+      github: 'https://github.com/icebaker/lnd-client',
+      license: 'MIT'
+    }.freeze
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lnd-client
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.5
 platform: ruby
 authors:
 - icebaker
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-02 00:00:00.000000000 Z
+date: 2023-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grpc
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.51'
+        version: '1.52'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.51'
+        version: '1.52'
 description: Ruby Lightning Network Daemon (lnd) Client
 email: 
 executables: []