lnrpc 0.14.1 → 0.15.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8892aec70e15ec43c6f400d7042cc385dad68fc911b68effa920d878dfdd7ca
-  data.tar.gz: d490c7df3eb0ad9a2f6fffe41abd5d28e8b9c322cc5b38c94d9948e5cfbc36ae
+  metadata.gz: 87e7353edb174ac9b45e6458caaf524ededd58250eb3533870593e960c484ca2
+  data.tar.gz: 2d6e030e7b69ee58af709f7a3e9bdab8cad97149b2a294e91b40323e37970ad5
 SHA512:
-  metadata.gz: b6964abbe9f69647d61d8af3d4ea07622dc84d6b015558b8ee0a6b77d825ea8ff4192b42cb0e087d4aff1ea78f700ef66cabae359a6778f646d749ea165b106b
-  data.tar.gz: 613b5b9d4492b568483611214dd4ddf263bdf34061613c05a3d3c2b4df1643bcf110443889cd0eafc72ff180bd7572f89c17948ab2afc3c46ece30b5e96b2107
+  metadata.gz: 766f3d18b40f6cac545f17b1486cc511d94e0c58d7a1529ba6456783e9d16ecccd226773eb8c1dfe20ef18f4bcf7ac7a52d549f16e983252610ea0280a9f8882
+  data.tar.gz: 8ff36d206ec1e5777e4fd9e0da530193d67918b480a6e11a1e908c8dc71a9b9391724d430c8d938bb92604f9698156cab0fb59203e6a0df5e6904db37e061516

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lnrpc (0.14.1)
+    lnrpc (0.15.5)
       google-protobuf (>= 3.15.7)
       grpc (>= 1.28.0)
 
@@ -9,11 +9,11 @@ GEM
   remote: https://rubygems.org/
   specs:
     diff-lcs (1.5.0)
-    google-protobuf (3.21.1)
-    googleapis-common-protos-types (1.3.1)
+    google-protobuf (3.22.1)
+    googleapis-common-protos-types (1.5.0)
       google-protobuf (~> 3.14)
-    grpc (1.46.3)
-      google-protobuf (~> 3.19)
+    grpc (1.52.0)
+      google-protobuf (~> 3.21)
       googleapis-common-protos-types (~> 1.0)
     rake (13.0.6)
     rspec (3.11.0)
@@ -40,4 +40,4 @@ DEPENDENCIES
   rspec (~> 3.0)
 
 BUNDLED WITH
-   2.2.33
+   2.4.4

data/README.md

@@ -8,7 +8,7 @@ a [gRPC](https://grpc.io/) client for [LND, the Lightning Network Daemon](https:
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'lnrpc', '~> 0.13.0'
+gem 'lnrpc', '~> 0.15.5'
 ```
 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)).
 

data/examples.rb

@@ -1,26 +1,34 @@
 require "lnrpc"
 
-lnd = Lnrpc::Client.new() # use defaults for credentials, macaraoon and address
+# establish a connection
+lnd = Lnrpc::Client.new() # use defaults for credentials, macaroon and address
 
+# get basic info
 get_info_res = lnd.lightning.get_info
 puts get_info_res.alias
 
+# get wallet balance
 puts lnd.lightning.wallet_balance.total_balance
 
+# pay an invoice
 pay_request = "lntb50u1pw9mmndpp5nvnff958pxc9eqknwntyxapjw7l5grt5e2y70cmmnu0lljfa0sdqdpsgfkx7cmtwd68yetpd5s9xct5v4kxc6t5v5s8yatz0ysxwetdcqzysxqyz5vqjkhlyn40z76gyn7dx32p9j58dftve9xrlvnqqazht7w2fdauukhyhr9y4k3ngjn8s6srglj8swk7tm70ng54wdkq47ahytpwffvaeusp500csz"
 lnd.pay(payment_request: pay_request) # or:
 lnd.router.send_payment_v2(payment_request: pay_request)
 
+# keysend payment
 dest = Lnrpc.to_byte_array('038474ec195f497cf4036e5994bd820dd365bb0aaa7fb42bd9b536913a1a2dcc9e')
 lnd.keysend(dest: dest, amt: 1000)
 
+# create invoice
 invoice_res = lnd.lightning.add_invoice(value: 1000, memo: 'I :heart: ruby')
 puts invoice_res.payment_request
 
+# get fee estimates
 puts lnd.versioner.get_version
 puts lnd.wallet_kit.estimate_fee(conf_target: 10)
 puts lnd.wallet_kit.next_addr
 
+# print incoming invoices
 lnd.lightning.subscribe_invoices(settle_index: 1).each do |invoice|
   puts invoice.payment_request
 end
@@ -67,3 +75,12 @@ lnd.lightning.update_channel_policy({
   base_fee_msat: 1100,
   chan_point: channel_point
 })
+
+# peer node
+address = {pubkey: "03423790614f023e3c0cdaa654a3578e919947e4c3a14bf5044e7c787ebd11af1a", host: "98.142.251.170:9735"}
+response = lnd.lightning.connect_peer(addr: address)
+
+# open channel
+# note: Lnrpc needs to connect with an admin macaroon, and the node needs to be an existing peer.
+pubkey = Lnrpc.to_byte_array("031f2669adab71548fad4432277a0d90233e3bc07ac29cfb0b3e01bd3fb26cb9fa")
+response = lnd.lightning.open_channel({node_pubkey: pubkey, local_funding_amount: 21000})

data/generate-grpc-service-files.sh

@@ -10,7 +10,7 @@ cd $GOPATH/src/github.com/lightningnetwork/lnd/lnrpc
 
 echo "Generating Ruby GRPC Service Files"
 
-PROTOS="rpc.proto walletunlocker.proto **/*.proto"
+PROTOS="lightning.proto walletunlocker.proto stateservice.proto **/*.proto"
 
 # generate files for each proto
 for file in $PROTOS; do

data/lib/grpc_services/chainrpc/chainnotifier_services_pb.rb

@@ -21,9 +21,11 @@ module Chainrpc
       # 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.
+      # A confirmation request must have a valid output script. It is also possible
+      # to give a transaction ID. If the transaction ID is not set, a notification
+      # is sent once the output script confirms. If the transaction ID is also set,
+      # a notification is sent once the output script confirms in the given
+      # transaction.
       rpc :RegisterConfirmationsNtfn, ::Chainrpc::ConfRequest, stream(::Chainrpc::ConfEvent)
       #
       # RegisterSpendNtfn is a synchronous response-streaming RPC that registers an

data/lib/grpc_services/devrpc/dev_pb.rb

@@ -0,0 +1,17 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: devrpc/dev.proto
+
+require 'google/protobuf'
+
+require 'lightning_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("devrpc/dev.proto", :syntax => :proto3) do
+    add_message "devrpc.ImportGraphResponse" do
+    end
+  end
+end
+
+module Devrpc
+  ImportGraphResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("devrpc.ImportGraphResponse").msgclass
+end

data/lib/grpc_services/devrpc/dev_services_pb.rb

@@ -0,0 +1,25 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: devrpc/dev.proto for package 'devrpc'
+
+require 'grpc'
+require 'devrpc/dev_pb'
+
+module Devrpc
+  module Dev
+    class Service
+
+      include ::GRPC::GenericService
+
+      self.marshal_class_method = :encode
+      self.unmarshal_class_method = :decode
+      self.service_name = 'devrpc.Dev'
+
+      #
+      # ImportGraph imports a ChannelGraph into the graph database. Should only be
+      # used for development.
+      rpc :ImportGraph, ::Lnrpc::ChannelGraph, ::Devrpc::ImportGraphResponse
+    end
+
+    Stub = Service.rpc_stub_class
+  end
+end

data/lib/grpc_services/invoicesrpc/invoices_pb.rb

@@ -3,7 +3,7 @@
 
 require 'google/protobuf'
 
-require 'rpc_pb'
+require 'lightning_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("invoicesrpc/invoices.proto", :syntax => :proto3) do