lnrpc 0.8.0.beta → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b19fa063d9eb1bfcd10174d0408d7128b35e94f7777dbfb7d44a8dcfe551096
-  data.tar.gz: 04bd4cc2efe2679fd052e337ba46ad0dbe71e287437c32f32cd766663ca62416
+  metadata.gz: 076e28dc0a94e3142ceb908180dea59365aa5dc1caee369499fdcaaeda2b6ece
+  data.tar.gz: a58e71947369db675771cec91858159a5b0fbc481cec1f1a167c425a25e7076f
 SHA512:
-  metadata.gz: 8418c5730ba78e9cd0a8436af0b1c0cdaa36c9d5d50b63ed7c915978c80e5fa1c533d1ad1bca8b0418a272c7fb213d3bb71dada0a53a74e0fbd72c0faf0654ad
-  data.tar.gz: 4c893a07fdd3dc2ac13aa4b31c1d7866e7cdfd81f52818fb5b7ab9f651ef15dbc1ee241c8df422460e68f8658fd3c22aa099a560ef98007352ff63ff92e74b5f
+  metadata.gz: ee72084b683e9970e70bb45d1f4a62d71077f7fd6d64e2204d9af1ba83558380fdbbe358ae8424c2e61e1ddbecbb3124d2904b1fba1b6fc8b3bb9326aa625538
+  data.tar.gz: fd0ae3ca2488ada61c8020f9f2c246a0da05b22f6fe5c52e3cb755b479cd77b0a3afcbdf499d5851c05b9ce1449cca7f591bda998f552817c0eb759290def573

data/.gitignore

@@ -11,3 +11,5 @@
 .rspec_status
 
 .ruby-version
+
+*.gem

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lnrpc (0.8.0.beta)
+    lnrpc (0.10.0)
       google-protobuf (>= 3.7)
       grpc (>= 1.19.0)
 
@@ -15,7 +15,7 @@ GEM
     grpc (1.24.0)
       google-protobuf (~> 3.8)
       googleapis-common-protos-types (~> 1.0)
-    rake (10.5.0)
+    rake (13.0.1)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
@@ -36,7 +36,7 @@ PLATFORMS
 DEPENDENCIES
   bundler (~> 1.17)
   lnrpc!
-  rake (~> 10.0)
+  rake (~> 13.0)
   rspec (~> 3.0)
 
 BUNDLED WITH

data/README.md

@@ -3,13 +3,15 @@
 
 a [gRPC](https://grpc.io/) client for [LND, the Lightning Network Daemon](https://github.com/lightningnetwork/lnd/) packed as ruby gem.
 
-
 ## Installation
 
+Note: there is still an GRPC/protobuf [issue with Ruby 2.7](https://github.com/protocolbuffers/protobuf/issues/7070). 
+So lnrpc requires Ruby < 2.7.
+
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'lnrpc', '~> 0.7.0'
+gem 'lnrpc', '~> 0.10.0'
 ```
 lnrpc follows the lnd versioning, thus it is recommended to specify the exact version you need for your lnd node as dependency (see [#Versioning](#Versioning)).
 
@@ -30,10 +32,12 @@ This gem makes the gRPC client classes created from the [LND service defintions]
 ```ruby
 require "lnrpc"
 
-# the gRPC client is available under the Lnrpc namespace, e.g.
+# With the changes in LND v.10.0 this load the `Lnrpc` and `Routerrpc` namespace
 
 Lnrpc::Lightning::Stub
+Routerrpc:::Routerrpc::Stub
 Lnrpc::GetInfoRequest
+...
 ```
 
 Learn more about [gRPC](https://grpc.io/) on [gRPC.io](https://grpc.io/).
@@ -55,17 +59,26 @@ client = Lnrpc::Lightning::Stub.new("localhost:10009", GRPC::Core::ChannelCreden
 request = Lnrpc::GetInfoRequest.new
 response = client.get_info(request, { metadata: { macaroon: macaroon } }) #=> Lnrpc::GetInfoResponse
 puts response.alias
+
+router = Routerprc::Router::Stub.new("localhost:10009", GRPC::Core::ChannelCredentials.new(self.credentials))
+...
+
 ```
 
 ### Client wrapper
 
+NOTE: v10.0 has breaking changes!
+
 An optional client wrapper ([Lnrpc::Client](https://github.com/bumi/lnrpc/blob/master/lib/lnrpc/client.rb)) makes
 initializing the gRPC client easier and removes the need for some boilerplate code for calling RPC methods.
 
 #### Example
 ```ruby
 lnd = Lnrpc::Client.new({credentials_path: '/path/to.cert.cls', macaroon_path: '/path/to/admin.macaroon'})
-lnd.get_info
+lnd.lightning # => Lnrpc::Lightning::Stub
+lnd.router # => Lnrpc::Router::Stub
+
+lnd.ligthning.get_info
 ```
 
 Also have a look at [examples.rb](https://github.com/bumi/lnrpc/blob/master/examples.rb)
@@ -96,7 +109,8 @@ lnd = Lnrpc::Client.new({
 })
 
 # the actual gRPC client is available through:
-lnd.grpc_client
+lnd.lightning.grpc
+lnd.router.grpc
 ```
 
 #### Calling RPC methods
@@ -108,19 +122,19 @@ If the first parameter is a hash or blank the corresponding gRPC request object
 Example:
 
 ```ruby
-client.get_info
+client.lightning.get_info
 # is the same as:
-client.grpc_client.get_info(Lnrpc::GetInfoRequest.new)
+client.lightning.grpc.get_info(Lnrpc::GetInfoRequest.new)
 
-client.list_channels(inactive_only: true)
+client.lightning.list_channels(inactive_only: true)
 # is the same as:
 request = Lnrpc::ListChannelsRequest.new(inactive_only: true)
-client.grpc_client.list_channels(request)
+client.lightning.grpc.list_channels(request)
 
-client.wallet_balance.total_balance
+client.lightning.wallet_balance.total_balance
 # is the same as:
 request = Lnrpc::WalletBalanceRequest.new()
-client.grpc_client.wallet_balance(request).total_balance
+client.lightning.grpc.wallet_balance(request).total_balance
 ```
 
 ## Using with BTC Pay Server
@@ -145,13 +159,11 @@ see [rubygems](https://rubygems.org/gems/lnrpc) for all available releases.
 
 ### Update service definitions
 
-1. Generate `prc_pb.rb` and `rpc_services_pb.rb`
-
-    $ grpc_tools_ruby_protoc -I/usr/local/include -I. -I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis --ruby_out=plugins=grpc,paths=source_relative:. --grpc_out=. rpc.proto
+The script `generate-grpc-service-files.sh` can be used to generate the GRPC ruby files.
+The files will be stored in `lib/grpc_services`
 
-2. Copy `rpc.proto`, `rpc_pb.rb` and `rpc_services_pb.rb` to `lib`
+    $ ./generate-grpc-service-files.sh
 
-3. Update `rpc_services_pb.rb` to use `require_relative` to load `rpc_pb`
 
 ## Other resources
 

data/examples.rb

@@ -1,24 +1,19 @@
 require "lnrpc"
 
-lnd = Lnrpc::Client.new({
-  credentials_path: '/home/bumi/lightning/bullet-testnet/2019-02-27/tls.cert',
-  macaroon_path: '/home/bumi/lightning/bullet-testnet/2019-02-27/admin.macaroon',
-  address: '79.137.71.183:10009'
-}) # use defaults for credentials, macaraoon and address
+lnd = Lnrpc::Client.new() # use defaults for credentials, macaraoon and address
 
-get_info_res = lnd.get_info
+get_info_res = lnd.lightning.get_info
 puts get_info_res.alias
 
-puts lnd.wallet_balance.total_balance
+puts lnd.lightning.wallet_balance.total_balance
 
-exit
 pay_request = "lntb50u1pw9mmndpp5nvnff958pxc9eqknwntyxapjw7l5grt5e2y70cmmnu0lljfa0sdqdpsgfkx7cmtwd68yetpd5s9xct5v4kxc6t5v5s8yatz0ysxwetdcqzysxqyz5vqjkhlyn40z76gyn7dx32p9j58dftve9xrlvnqqazht7w2fdauukhyhr9y4k3ngjn8s6srglj8swk7tm70ng54wdkq47ahytpwffvaeusp500csz"
 lnd.pay(pay_request) # or:
-lnd.send_payment_sync(payment_request: pay_request)
+lnd.router.send_payment_v2(payment_request: pay_request)
 
-invoice_res = lnd.add_invoice(value: 1000, memo: 'I :heart: ruby')
+invoice_res = lnd.lightning.add_invoice(value: 1000, memo: 'I :heart: ruby')
 puts invoice_res.payment_request
 
-lnd.subscribe_invoices(settle_index: 1).each do |invoice|
+lnd.lightning.subscribe_invoices(settle_index: 1).each do |invoice|
   puts invoice.payment_request
 end

data/generate-grpc-service-files.sh

@@ -0,0 +1,30 @@
+#!/bin/sh
+set -o xtrace
+
+FULL_PATH=$(realpath $0)
+GEM_DIR=$(dirname $FULL_PATH)
+LNRPC_TARGET_DIR="$GEM_DIR/lib/grpc_services"
+CURRENT_DIR=$(pwd)
+echo $CURRENT_DIR
+cd $GOPATH/src/github.com/lightningnetwork/lnd/lnrpc
+
+echo "Generating Ruby GRPC Service Files"
+
+PROTOS="rpc.proto walletunlocker.proto **/*.proto"
+
+# generate files for each proto
+for file in $PROTOS; do
+  DIRECTORY=$(dirname "${file}")
+  echo "Generating protos from ${file}, into ${LNRPC_TARGET_DIR}/${DIRECTORY}"
+
+  # writes all ruby files in the ruby directory
+  grpc_tools_ruby_protoc -I/usr/local/include \
+    -I. \
+    -I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis \
+    -I$GOPATH/src/github.com/lightningnetwork/lnd/lnrpc \
+    --ruby_out=plugins=grpc,paths=source_relative:${LNRPC_TARGET_DIR} \
+    --grpc_out=${LNRPC_TARGET_DIR} "${file}"
+
+done
+
+cd $CURRENT_DIR

data/lib/grpc_services/autopilotrpc/autopilot_pb.rb

@@ -0,0 +1,48 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: autopilotrpc/autopilot.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("autopilotrpc/autopilot.proto", :syntax => :proto3) do
+    add_message "autopilotrpc.StatusRequest" do
+    end
+    add_message "autopilotrpc.StatusResponse" do
+      optional :active, :bool, 1
+    end
+    add_message "autopilotrpc.ModifyStatusRequest" do
+      optional :enable, :bool, 1
+    end
+    add_message "autopilotrpc.ModifyStatusResponse" do
+    end
+    add_message "autopilotrpc.QueryScoresRequest" do
+      repeated :pubkeys, :string, 1
+      optional :ignore_local_state, :bool, 2
+    end
+    add_message "autopilotrpc.QueryScoresResponse" do
+      repeated :results, :message, 1, "autopilotrpc.QueryScoresResponse.HeuristicResult"
+    end
+    add_message "autopilotrpc.QueryScoresResponse.HeuristicResult" do
+      optional :heuristic, :string, 1
+      map :scores, :string, :double, 2
+    end
+    add_message "autopilotrpc.SetScoresRequest" do
+      optional :heuristic, :string, 1
+      map :scores, :string, :double, 2
+    end
+    add_message "autopilotrpc.SetScoresResponse" do
+    end
+  end
+end
+
+module Autopilotrpc
+  StatusRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.StatusRequest").msgclass
+  StatusResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.StatusResponse").msgclass
+  ModifyStatusRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.ModifyStatusRequest").msgclass
+  ModifyStatusResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.ModifyStatusResponse").msgclass
+  QueryScoresRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.QueryScoresRequest").msgclass
+  QueryScoresResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.QueryScoresResponse").msgclass
+  QueryScoresResponse::HeuristicResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.QueryScoresResponse.HeuristicResult").msgclass
+  SetScoresRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.SetScoresRequest").msgclass
+  SetScoresResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("autopilotrpc.SetScoresResponse").msgclass
+end

data/lib/grpc_services/autopilotrpc/autopilot_services_pb.rb

@@ -0,0 +1,40 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: autopilotrpc/autopilot.proto for package 'autopilotrpc'
+
+require 'grpc'
+require 'autopilotrpc/autopilot_pb'
+
+module Autopilotrpc
+  module Autopilot
+    # Autopilot is a service that can be used to get information about the current
+    # state of the daemon's autopilot agent, and also supply it with information
+    # that can be used when deciding where to open channels.
+    class Service
+
+      include GRPC::GenericService
+
+      self.marshal_class_method = :encode
+      self.unmarshal_class_method = :decode
+      self.service_name = 'autopilotrpc.Autopilot'
+
+      #
+      # Status returns whether the daemon's autopilot agent is active.
+      rpc :Status, StatusRequest, StatusResponse
+      #
+      # ModifyStatus is used to modify the status of the autopilot agent, like
+      # enabling or disabling it.
+      rpc :ModifyStatus, ModifyStatusRequest, ModifyStatusResponse
+      #
+      # QueryScores queries all available autopilot heuristics, in addition to any
+      # active combination of these heruristics, for the scores they would give to
+      # the given nodes.
+      rpc :QueryScores, QueryScoresRequest, QueryScoresResponse
+      #
+      # SetScores attempts to set the scores used by the running autopilot agent,
+      # if the external scoring heuristic is enabled.
+      rpc :SetScores, SetScoresRequest, SetScoresResponse
+    end
+
+    Stub = Service.rpc_stub_class
+  end
+end

data/lib/grpc_services/chainrpc/chainnotifier_pb.rb

@@ -0,0 +1,67 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: chainrpc/chainnotifier.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("chainrpc/chainnotifier.proto", :syntax => :proto3) do
+    add_message "chainrpc.ConfRequest" do
+      optional :txid, :bytes, 1
+      optional :script, :bytes, 2
+      optional :num_confs, :uint32, 3
+      optional :height_hint, :uint32, 4
+    end
+    add_message "chainrpc.ConfDetails" do
+      optional :raw_tx, :bytes, 1
+      optional :block_hash, :bytes, 2
+      optional :block_height, :uint32, 3
+      optional :tx_index, :uint32, 4
+    end
+    add_message "chainrpc.Reorg" do
+    end
+    add_message "chainrpc.ConfEvent" do
+      oneof :event do
+        optional :conf, :message, 1, "chainrpc.ConfDetails"
+        optional :reorg, :message, 2, "chainrpc.Reorg"
+      end
+    end
+    add_message "chainrpc.Outpoint" do
+      optional :hash, :bytes, 1
+      optional :index, :uint32, 2
+    end
+    add_message "chainrpc.SpendRequest" do
+      optional :outpoint, :message, 1, "chainrpc.Outpoint"
+      optional :script, :bytes, 2
+      optional :height_hint, :uint32, 3
+    end
+    add_message "chainrpc.SpendDetails" do
+      optional :spending_outpoint, :message, 1, "chainrpc.Outpoint"
+      optional :raw_spending_tx, :bytes, 2
+      optional :spending_tx_hash, :bytes, 3
+      optional :spending_input_index, :uint32, 4
+      optional :spending_height, :uint32, 5
+    end
+    add_message "chainrpc.SpendEvent" do
+      oneof :event do
+        optional :spend, :message, 1, "chainrpc.SpendDetails"
+        optional :reorg, :message, 2, "chainrpc.Reorg"
+      end
+    end
+    add_message "chainrpc.BlockEpoch" do
+      optional :hash, :bytes, 1
+      optional :height, :uint32, 2
+    end
+  end
+end
+
+module Chainrpc
+  ConfRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.ConfRequest").msgclass
+  ConfDetails = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.ConfDetails").msgclass
+  Reorg = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.Reorg").msgclass
+  ConfEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.ConfEvent").msgclass
+  Outpoint = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.Outpoint").msgclass
+  SpendRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.SpendRequest").msgclass
+  SpendDetails = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.SpendDetails").msgclass
+  SpendEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.SpendEvent").msgclass
+  BlockEpoch = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("chainrpc.BlockEpoch").msgclass
+end

data/lib/grpc_services/chainrpc/chainnotifier_services_pb.rb

@@ -0,0 +1,51 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: chainrpc/chainnotifier.proto for package 'chainrpc'
+
+require 'grpc'
+require 'chainrpc/chainnotifier_pb'
+
+module Chainrpc
+  module ChainNotifier
+    # ChainNotifier is a service that can be used to get information about the
+    # chain backend by registering notifiers for chain events.
+    class Service
+
+      include GRPC::GenericService
+
+      self.marshal_class_method = :encode
+      self.unmarshal_class_method = :decode
+      self.service_name = 'chainrpc.ChainNotifier'
+
+      #
+      # RegisterConfirmationsNtfn is a synchronous response-streaming RPC that
+      # registers an intent for a client to be notified once a confirmation request
+      # has reached its required number of confirmations on-chain.
+      #
+      # A client can specify whether the confirmation request should be for a
+      # particular transaction by its hash or for an output script by specifying a
+      # zero hash.
+      rpc :RegisterConfirmationsNtfn, ConfRequest, stream(ConfEvent)
+      #
+      # RegisterSpendNtfn is a synchronous response-streaming RPC that registers an
+      # intent for a client to be notification once a spend request has been spent
+      # by a transaction that has confirmed on-chain.
+      #
+      # A client can specify whether the spend request should be for a particular
+      # outpoint  or for an output script by specifying a zero outpoint.
+      rpc :RegisterSpendNtfn, SpendRequest, stream(SpendEvent)
+      #
+      # RegisterBlockEpochNtfn is a synchronous response-streaming RPC that
+      # registers an intent for a client to be notified of blocks in the chain. The
+      # stream will return a hash and height tuple of a block for each new/stale
+      # block in the chain. It is the client's responsibility to determine whether
+      # the tuple returned is for a new or stale block in the chain.
+      #
+      # A client can also request a historical backlog of blocks from a particular
+      # point. This allows clients to be idempotent by ensuring that they do not
+      # missing processing a single block within the chain.
+      rpc :RegisterBlockEpochNtfn, BlockEpoch, stream(BlockEpoch)
+    end
+
+    Stub = Service.rpc_stub_class
+  end
+end

data/lib/grpc_services/invoicesrpc/invoices_pb.rb

@@ -0,0 +1,48 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: invoicesrpc/invoices.proto
+
+require 'google/protobuf'
+
+require 'rpc_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("invoicesrpc/invoices.proto", :syntax => :proto3) do
+    add_message "invoicesrpc.CancelInvoiceMsg" do
+      optional :payment_hash, :bytes, 1
+    end
+    add_message "invoicesrpc.CancelInvoiceResp" do
+    end
+    add_message "invoicesrpc.AddHoldInvoiceRequest" do
+      optional :memo, :string, 1
+      optional :hash, :bytes, 2
+      optional :value, :int64, 3
+      optional :value_msat, :int64, 10
+      optional :description_hash, :bytes, 4
+      optional :expiry, :int64, 5
+      optional :fallback_addr, :string, 6
+      optional :cltv_expiry, :uint64, 7
+      repeated :route_hints, :message, 8, "lnrpc.RouteHint"
+      optional :private, :bool, 9
+    end
+    add_message "invoicesrpc.AddHoldInvoiceResp" do
+      optional :payment_request, :string, 1
+    end
+    add_message "invoicesrpc.SettleInvoiceMsg" do
+      optional :preimage, :bytes, 1
+    end
+    add_message "invoicesrpc.SettleInvoiceResp" do
+    end
+    add_message "invoicesrpc.SubscribeSingleInvoiceRequest" do
+      optional :r_hash, :bytes, 2
+    end
+  end
+end
+
+module Invoicesrpc
+  CancelInvoiceMsg = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("invoicesrpc.CancelInvoiceMsg").msgclass
+  CancelInvoiceResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("invoicesrpc.CancelInvoiceResp").msgclass
+  AddHoldInvoiceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("invoicesrpc.AddHoldInvoiceRequest").msgclass
+  AddHoldInvoiceResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("invoicesrpc.AddHoldInvoiceResp").msgclass
+  SettleInvoiceMsg = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("invoicesrpc.SettleInvoiceMsg").msgclass
+  SettleInvoiceResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("invoicesrpc.SettleInvoiceResp").msgclass
+  SubscribeSingleInvoiceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("invoicesrpc.SubscribeSingleInvoiceRequest").msgclass
+end