lnd-client 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4f21139f58c13fceea576b5df5c9d799e24591281e4bd6a9132fd7a719fc549
-  data.tar.gz: fb569472611c466c28cf03519e1c756dee704bdf22b21381c3c355cfa983c573
+  metadata.gz: 68daf7177bbbbbc21fe8e5c3b19230777b5d5904364ebc44211953e6fd5f36ed
+  data.tar.gz: e811786dd412c270cb931bd78ee30fa558bbeff87d779e53c2d4d0f6d7f8aec5
 SHA512:
-  metadata.gz: 83f2cce7e6334695e3118ac9dd3ed6bb4c76a1aefdbacafba6a4af785d239e0c475faadf6104392cde059928409e0603e42a84e9fa91bc180a7ccd56a55a7eaa
-  data.tar.gz: cd147a319c1f02c50e19fb220b6dedbe7357d0680530b8a305f083d50c731c2afb8da5ac90d67b7984b1022c61e398cd2326f1fd27e050af4d471375fc3e720a
+  metadata.gz: 3073a130f52bb94942379231f236fc79dc99f459891b696095c2928806611ef0b87e0c980fd9d39e60642ebf2a8a7847d1ee899336dd00a7d46a06ec376822a8
+  data.tar.gz: b63090fa41a852873e74695916614a065bb6bf824322ecd5233c93379b39b4dc2c86b3f575bb549a18869906b063569a440591070ffb128963c20f4fdc8a2fa2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lnd-client (0.0.3)
+    lnd-client (0.0.4)
       grpc (~> 1.51)
 
 GEM

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.4'
 ```
 
 ```ruby
 require 'lnd-client'
 
-puts LNDClient.version # => 0.0.3
+puts LNDClient.version # => 0.0.4
 
 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.4
 
 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.4
 
 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.4.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|

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.4',
+      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.4
 platform: ruby
 authors:
 - icebaker
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-02 00:00:00.000000000 Z
+date: 2023-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grpc