lnrpc 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0bfe878e75df63ffd268631872089510d05b50af1a8979c1ccfa2fd54f9dbb78
-  data.tar.gz: e391ec669a7bf1a4c8cba736b82c3bed14857e1c625693ed030cf122e2ba991d
+  metadata.gz: 71f46657870277fc3ea221589d4f56636db84d94a9a2c6b94c3e5b45be71bf74
+  data.tar.gz: e457e296265023dd2a153a70bcfc1b685f278e042ed511e123b6b81bee103f48
 SHA512:
-  metadata.gz: 86cc73ea507f2a0bddd3c07568e8ff8cc73241b65e6398194973562e1536fa2425b3a1ccd5cd4d557c88af1d35129e288c231800f2dbbf9ed9a1dacf42b0bfe7
-  data.tar.gz: e382d37d143abbaac9e9b7d1d67634c224ce867c70949b76f408a53682521663d264c231fa06a0747727ebced9f381f4a716b5a51e132b431cd679b1437afdc3
+  metadata.gz: 899ad8d7157862b9a2dddc6c7972b52124c38d049c102d991d6be5588105eb95a7a54adc4d4f22a3183db9353c4c1816a6af9b2acd849e0a9f5eaec69ac6ada9
+  data.tar.gz: e9377803a209e507fd5d33b1a2568708bcf5d1e5d819e2ddf68bb5a6e5915c3f05f4fe28ac96c632ef5d964238dda030b5d040ce05af996e874f7d387b1a0bc9

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lnrpc (0.5.2)
+    lnrpc (0.7.0)
       google-protobuf (>= 3.7)
       grpc (>= 1.19.0)
 
@@ -9,26 +9,26 @@ GEM
   remote: https://rubygems.org/
   specs:
     diff-lcs (1.3)
-    google-protobuf (3.7.0-x86_64-linux)
-    googleapis-common-protos-types (1.0.3)
+    google-protobuf (3.8.0)
+    googleapis-common-protos-types (1.0.4)
       google-protobuf (~> 3.0)
-    grpc (1.19.0-x86_64-linux)
-      google-protobuf (~> 3.1)
-      googleapis-common-protos-types (~> 1.0.0)
+    grpc (1.21.0)
+      google-protobuf (~> 3.7)
+      googleapis-common-protos-types (~> 1.0)
     rake (10.5.0)
     rspec (3.8.0)
       rspec-core (~> 3.8.0)
       rspec-expectations (~> 3.8.0)
       rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.0)
+    rspec-core (3.8.2)
       rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.2)
+    rspec-expectations (3.8.4)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.0)
+    rspec-mocks (3.8.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.8.0)
-    rspec-support (3.8.0)
+    rspec-support (3.8.2)
 
 PLATFORMS
   ruby

data/README.md

@@ -1,17 +1,17 @@
 # Lnrpc - ruby gRPC client for LND
+[![Gem Version](https://badge.fury.io/rb/lnrpc.svg)](https://badge.fury.io/rb/lnrpc)
 
 a [gRPC](https://grpc.io/) client for [LND, the Lightning Network Daemon](https://github.com/lightningnetwork/lnd/) packed as ruby gem.
 
-Currently published as [beta release](https://rubygems.org/gems/lnrpc) to rubygems for LND v0.5.2.beta. (see [#Versioning](#Versioning))
-
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'lnrpc'
+gem 'lnrpc', '~> 0.6.1'
 ```
+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)).
 
 And then execute:
 
@@ -140,6 +140,8 @@ Don't have a BTC Pay Server? [Setting one up is easy.](https://medium.com/@Btcpa
 This gem follows the LND versions and will update the gRPC service definitions accordingly.
 e.g. gem version 0.5.2 includes the gRPC service definitions from LND v0.5.2
 
+see [rubygems](https://rubygems.org/gems/lnrpc) for all available releases.
+
 
 ### Update service definitions
 

data/lib/lnrpc/rpc.proto

@@ -175,7 +175,7 @@ message UnlockWalletRequest {
     /**
     recovery_window is an optional argument specifying the address lookahead
     when restoring a wallet seed. The recovery window applies to each
-    invdividual branch of the BIP44 derivation paths. Supplying a recovery
+    individual branch of the BIP44 derivation paths. Supplying a recovery
     window of zero indicates that no addresses should be recovered, such after
     the first initialization of the wallet.
     */
@@ -212,7 +212,7 @@ service Lightning {
     /** lncli: `walletbalance`
     WalletBalance returns total unspent outputs(confirmed and unconfirmed), all
     confirmed unspent outputs and all unconfirmed unspent outputs under control
-    of the wallet. 
+    of the wallet.
     */
     rpc WalletBalance (WalletBalanceRequest) returns (WalletBalanceResponse) {
         option (google.api.http) = {
@@ -398,7 +398,7 @@ service Lightning {
     rpc SubscribeChannelEvents (ChannelEventSubscription) returns (stream ChannelEventUpdate);
 
     /** lncli: `closedchannels`
-    ClosedChannels returns a description of all the closed channels that 
+    ClosedChannels returns a description of all the closed channels that
     this node was a participant in.
     */
     rpc ClosedChannels (ClosedChannelsRequest) returns (ClosedChannelsResponse) {
@@ -621,7 +621,7 @@ service Lightning {
     /** lncli: `queryroutes`
     QueryRoutes attempts to query the daemon's Channel Router for a possible
     route to a target destination capable of carrying a specific amount of
-    satoshis. The retuned route contains the full details required to craft and
+    satoshis. The returned route contains the full details required to craft and
     send an HTLC, also including the necessary information that should be
     present within the Sphinx packet encapsulated within the HTLC.
     */
@@ -814,6 +814,9 @@ message Transaction {
 
     /// Addresses that received funds for this transaction
     repeated string dest_addresses = 8 [ json_name = "dest_addresses" ];
+
+    /// The raw transaction hex.
+    string raw_tx_hex = 9 [ json_name = "raw_tx_hex" ];
 }
 message GetTransactionsRequest {
 }
@@ -896,13 +899,7 @@ message SendToRouteRequest {
     /// An optional hex-encoded payment hash to be used for the HTLC.
     string payment_hash_string = 2;
 
-    /**
-    Deprecated. The set of routes that should be used to attempt to complete the
-    payment. The possibility to pass in multiple routes is deprecated and 
-    instead the single route field below should be used in combination with the 
-    streaming variant of SendToRoute.
-    */
-    repeated Route routes = 3 [deprecated = true];
+    reserved 3;
 
     /// Route that should be used to attempt to complete the payment.
     Route route = 4;
@@ -1162,7 +1159,7 @@ message Channel {
     /// True if we were the ones that created the channel.
     bool initiator = 18 [json_name = "initiator"];
 
-    /// A set of flags showing the current state of the cahnnel.
+    /// A set of flags showing the current state of the channel.
     string chan_status_flags = 19 [json_name = "chan_status_flags"];
 }
 
@@ -1335,6 +1332,9 @@ message GetInfoResponse {
 
     /// A list of active chains the node is connected to
     repeated Chain chains = 16 [json_name = "chains"];
+
+    /// The color of the current node in hex code format
+    string color = 17 [json_name = "color"];
 }
 
 message Chain {
@@ -1523,7 +1523,7 @@ message PendingChannelsResponse {
         /// The balance in satoshis encumbered in this pending channel
         int64 limbo_balance = 3 [ json_name = "limbo_balance" ];
 
-        /// The height at which funds can be sweeped into the wallet
+        /// The height at which funds can be swept into the wallet
         uint32 maturity_height = 4 [ json_name = "maturity_height" ];
 
         /*
@@ -1606,11 +1606,7 @@ message QueryRoutesRequest {
     /// The amount to send expressed in satoshis
     int64 amt = 2;
 
-    /**
-    Deprecated. The max number of routes to return. In the future, QueryRoutes
-    will only return a single route.
-    */
-    int32 num_routes = 3 [deprecated = true]; 
+    reserved 3;
 
     /// An optional CLTV delta from the current height that should be used for the timelock of the final hop
     int32 final_cltv_delta = 4;
@@ -1698,7 +1694,7 @@ message Route {
     /**
     The sum of the fees paid at each hop within the final route.  In the case
     of a one-hop payment, this value will be zero as we don't need to pay a fee
-    it ourself.
+    to ourselves.
     */
     int64 total_fees = 2 [json_name = "total_fees", deprecated = true];
 
@@ -1730,6 +1726,9 @@ message Route {
 message NodeInfoRequest {
     /// The 33-byte hex-encoded compressed public of the target node 
     string pub_key = 1;
+
+    /// If true, will include all known channels associated with the node.
+    bool include_channels = 2;
 }
 
 message NodeInfo {
@@ -1742,8 +1741,14 @@ message NodeInfo {
     */
     LightningNode node = 1 [json_name = "node"];
 
+    /// The total number of channels for the node.
     uint32 num_channels = 2 [json_name = "num_channels"];
+
+    /// The sum of all channels capacity for the node, denominated in satoshis.
     int64 total_capacity = 3 [json_name = "total_capacity"];
+
+    /// A list of all public channels for the node.
+    repeated ChannelEdge channels = 4 [json_name = "channels"];
 }
 
 /**
@@ -1864,6 +1869,7 @@ message NodeUpdate {
     string identity_key = 2;
     bytes global_features = 3;
     string alias = 4;
+    string color = 5;
 }
 message ChannelEdgeUpdate {
     /**
@@ -2152,9 +2158,28 @@ message Payment {
 
     /// The value of the payment in milli-satoshis
     int64 value_msat = 8 [json_name = "value_msat"];
+
+    /// The optional payment request being fulfilled.
+    string payment_request = 9 [json_name = "payment_request"];
+
+    enum PaymentStatus {
+        UNKNOWN = 0;
+        IN_FLIGHT = 1;
+        SUCCEEDED = 2;
+        FAILED = 3;
+    }
+
+    // The status of the payment.
+    PaymentStatus status = 10 [json_name = "status"];
 }
 
 message ListPaymentsRequest {
+    /**
+    If true, then return payments that have not yet fully completed. This means
+    that pending payments, as well as failed payments will show up if this
+    field is set to True.
+    */
+    bool include_incomplete = 1;
 }
 
 message ListPaymentsResponse {
@@ -2298,7 +2323,7 @@ message ForwardingHistoryResponse {
 }
 
 message ExportChannelBackupRequest {
-    /// The target chanenl point to obtain a back up for.
+    /// The target channel point to obtain a back up for.
     ChannelPoint chan_point = 1;
 }
 
@@ -2310,7 +2335,7 @@ message ChannelBackup {
 
     /**
     Is an encrypted single-chan backup. this can be passed to
-    RestoreChannelBackups, or the WalletUnlocker Innit and Unlock methods in
+    RestoreChannelBackups, or the WalletUnlocker Init and Unlock methods in
     order to trigger the recovery protocol.
     */
     bytes chan_backup = 2 [ json_name = "chan_backup" ];

data/lib/lnrpc/rpc_pb.rb

@@ -52,6 +52,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :time_stamp, :int64, 6
     optional :total_fees, :int64, 7
     repeated :dest_addresses, :string, 8
+    optional :raw_tx_hex, :string, 9
   end
   add_message "lnrpc.GetTransactionsRequest" do
   end
@@ -85,7 +86,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "lnrpc.SendToRouteRequest" do
     optional :payment_hash, :bytes, 1
     optional :payment_hash_string, :string, 2
-    repeated :routes, :message, 3, "lnrpc.Route"
     optional :route, :message, 4, "lnrpc.Route"
   end
   add_message "lnrpc.ChannelPoint" do
@@ -273,6 +273,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :version, :string, 14
     optional :num_inactive_channels, :uint32, 15
     repeated :chains, :message, 16, "lnrpc.Chain"
+    optional :color, :string, 17
   end
   add_message "lnrpc.Chain" do
     optional :chain, :string, 1
@@ -406,7 +407,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "lnrpc.QueryRoutesRequest" do
     optional :pub_key, :string, 1
     optional :amt, :int64, 2
-    optional :num_routes, :int32, 3
     optional :final_cltv_delta, :int32, 4
     optional :fee_limit, :message, 5, "lnrpc.FeeLimit"
     repeated :ignored_nodes, :bytes, 6
@@ -440,11 +440,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   end
   add_message "lnrpc.NodeInfoRequest" do
     optional :pub_key, :string, 1
+    optional :include_channels, :bool, 2
   end
   add_message "lnrpc.NodeInfo" do
     optional :node, :message, 1, "lnrpc.LightningNode"
     optional :num_channels, :uint32, 2
     optional :total_capacity, :int64, 3
+    repeated :channels, :message, 4, "lnrpc.ChannelEdge"
   end
   add_message "lnrpc.LightningNode" do
     optional :last_update, :uint32, 1
@@ -515,6 +517,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :identity_key, :string, 2
     optional :global_features, :bytes, 3
     optional :alias, :string, 4
+    optional :color, :string, 5
   end
   add_message "lnrpc.ChannelEdgeUpdate" do
     optional :chan_id, :uint64, 1
@@ -602,8 +605,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :payment_preimage, :string, 6
     optional :value_sat, :int64, 7
     optional :value_msat, :int64, 8
+    optional :payment_request, :string, 9
+    optional :status, :enum, 10, "lnrpc.Payment.PaymentStatus"
+  end
+  add_enum "lnrpc.Payment.PaymentStatus" do
+    value :UNKNOWN, 0
+    value :IN_FLIGHT, 1
+    value :SUCCEEDED, 2
+    value :FAILED, 3
   end
   add_message "lnrpc.ListPaymentsRequest" do
+    optional :include_incomplete, :bool, 1
   end
   add_message "lnrpc.ListPaymentsResponse" do
     repeated :payments, :message, 1, "lnrpc.Payment"
@@ -832,6 +844,7 @@ module Lnrpc
   ListInvoiceResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("lnrpc.ListInvoiceResponse").msgclass
   InvoiceSubscription = Google::Protobuf::DescriptorPool.generated_pool.lookup("lnrpc.InvoiceSubscription").msgclass
   Payment = Google::Protobuf::DescriptorPool.generated_pool.lookup("lnrpc.Payment").msgclass
+  Payment::PaymentStatus = Google::Protobuf::DescriptorPool.generated_pool.lookup("lnrpc.Payment.PaymentStatus").enummodule
   ListPaymentsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("lnrpc.ListPaymentsRequest").msgclass
   ListPaymentsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("lnrpc.ListPaymentsResponse").msgclass
   DeleteAllPaymentsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("lnrpc.DeleteAllPaymentsRequest").msgclass

data/lib/lnrpc/rpc_services_pb.rb

@@ -287,7 +287,7 @@ module Lnrpc
       # * lncli: `queryroutes`
       # QueryRoutes attempts to query the daemon's Channel Router for a possible
       # route to a target destination capable of carrying a specific amount of
-      # satoshis. The retuned route contains the full details required to craft and
+      # satoshis. The returned route contains the full details required to craft and
       # send an HTLC, also including the necessary information that should be
       # present within the Sphinx packet encapsulated within the HTLC.
       rpc :QueryRoutes, QueryRoutesRequest, QueryRoutesResponse

data/lib/lnrpc/version.rb

@@ -1,3 +1,3 @@
 module Lnrpc
-  VERSION = "0.6.1"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lnrpc
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Michael Bumann
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-05-15 00:00:00.000000000 Z
+date: 2019-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler