lighstorm 0.0.10 → 0.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed188ef291ac08a9cc6f91dca92931be2c88257ee184416fd0f40a3224740b20
-  data.tar.gz: 1be060a12d9e755354764cc8151da8a26e114fcc9a0ecac470e9fe9b685a60a4
+  metadata.gz: 6072337300f3fd850fbca3ba5c7c804842c275d5f35fa288dfb83747fa0b1a56
+  data.tar.gz: 8a16d83cb96f0ed911ebd55e12707b20f0aac00a0acac8d176e544a68abad647
 SHA512:
-  metadata.gz: b37802f04bae65416f4e80590506518025d62f1ca9b502b97db3cc108792b13a077f2ebb89c3e0be4cf311fb10a53f916a3c37e2f6c729b9bf01f187b0ab4892
-  data.tar.gz: ac5f5a1f5f4ff271ab2ddef517763f380f1868b71339bcf1758975e35c7e520ddd65fddb9d210539fedde2dc3830912db8b0bbdbfed1aa454e781c8a6e43e948
+  metadata.gz: 3ccb6cef3322fcd1c0efb1439ddaf756e631113fbc7544218d10d6f71d08ca2ad80cf08b029ae4145e6916dcefc9ee3683124567bb952b02bf70793cc794616b
+  data.tar.gz: 2755ec9d8c2bf041459be7292983103c880f032e5e1e315ce2da2cc97ff945bbfb9f4083259a0c88ec22df8cd0301282c8ea376d63371a438ad58677b7f3d9e6

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lighstorm (0.0.10)
+    lighstorm (0.0.11)
       dotenv (~> 2.8, >= 2.8.1)
       lnd-client (~> 0.0.5)
       zache (~> 0.12.0)
@@ -47,7 +47,7 @@ GEM
     rspec-expectations (3.12.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.3)
+    rspec-mocks (3.12.4)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.0)

data/README.md

@@ -34,7 +34,7 @@ Although it tries to stay close to [Lightning's terminologies](https://docs.ligh
 Add to your `Gemfile`:
 
 ```ruby
-gem 'lighstorm', '~> 0.0.10'
+gem 'lighstorm', '~> 0.0.11'
 ```
 
 ```ruby
@@ -46,7 +46,7 @@ Lighstorm.config!(
   macaroon_path: '/lnd/data/chain/bitcoin/mainnet/admin.macaroon',
 )
 
-puts Lighstorm.version # => 0.0.10
+puts Lighstorm.version # => 0.0.11
 
 Lighstorm::Node.myself.alias # => icebaker/old-stone
 

data/controllers/invoice/find_by_code.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require_relative '../../ports/grpc'
+require_relative '../../adapters/invoice'
+require_relative '../../models/invoice'
+
+module Lighstorm
+  module Controllers
+    module Invoice
+      module FindByCode
+        def self.fetch(code)
+          at = Time.now
+
+          decoded = Ports::GRPC.lightning.decode_pay_req(pay_req: code).to_h
+
+          { response: {
+            at: at,
+            decode_pay_req: decoded,
+            lookup_invoice: Ports::GRPC.lightning.lookup_invoice(r_hash_str: decoded[:payment_hash]).to_h
+          }, exception: nil }
+        rescue StandardError => e
+          { exception: e }
+        end
+
+        def self.adapt(raw)
+          raise 'missing at' if raw[:at].nil?
+
+          {
+            lookup_invoice: Lighstorm::Adapter::Invoice.lookup_invoice(
+              raw[:lookup_invoice],
+              raw[:at]
+            )
+          }
+        end
+
+        def self.transform(adapted)
+          adapted[:lookup_invoice][:known] = true
+          adapted[:lookup_invoice]
+        end
+
+        def self.data(code, &vcr)
+          raw = vcr.nil? ? fetch(code) : vcr.call(-> { fetch(code) })
+
+          raise_error_if_exists!(raw)
+
+          adapted = adapt(raw[:response])
+
+          transform(adapted)
+        end
+
+        def self.model(data)
+          Lighstorm::Models::Invoice.new(data)
+        end
+
+        def self.raise_error_if_exists!(response)
+          return if response[:exception].nil?
+
+          if response[:exception].is_a?(GRPC::NotFound)
+            raise NoInvoiceFoundError.new(
+              "Invoice not found. Try using Invoice.decode if you don't own the invoice.",
+              grpc: response[:exception]
+            )
+          end
+
+          raise LighstormError.new(grpc: response[:exception])
+        end
+      end
+    end
+  end
+end

data/controllers/invoice/find_by_secret_hash.rb

@@ -9,10 +9,12 @@ module Lighstorm
     module Invoice
       module FindBySecretHash
         def self.fetch(secret_hash)
-          {
+          { response: {
             at: Time.now,
             lookup_invoice: Ports::GRPC.lightning.lookup_invoice(r_hash_str: secret_hash).to_h
-          }
+          }, exception: nil }
+        rescue StandardError => e
+          { exception: e }
         end
 
         def self.adapt(raw)
@@ -34,7 +36,7 @@ module Lighstorm
         def self.data(secret_hash, &vcr)
           raw = vcr.nil? ? fetch(secret_hash) : vcr.call(-> { fetch(secret_hash) })
 
-          adapted = adapt(raw)
+          adapted = adapt(raw[:response])
 
           transform(adapted)
         end

data/controllers/invoice.rb

@@ -3,6 +3,7 @@
 require_relative './invoice/all'
 require_relative './invoice/decode'
 require_relative './invoice/find_by_secret_hash'
+require_relative './invoice/find_by_code'
 require_relative './invoice/actions/create'
 
 module Lighstorm
@@ -20,8 +21,12 @@ module Lighstorm
         All.model(All.data).last
       end
 
-      def self.find_by_secret_hash(secret_hash)
-        FindBySecretHash.model(FindBySecretHash.data(secret_hash))
+      def self.find_by_secret_hash(secret_hash, &vcr)
+        FindBySecretHash.model(FindBySecretHash.data(secret_hash, &vcr))
+      end
+
+      def self.find_by_code(code, &vcr)
+        FindByCode.model(FindByCode.data(code, &vcr))
       end
 
       def self.decode(code, &vcr)

data/controllers/payment/all.rb

@@ -12,7 +12,7 @@ module Lighstorm
   module Controllers
     module Payment
       module All
-        def self.fetch(purpose: nil, limit: nil, fetch: {})
+        def self.fetch(purpose: nil, invoice_code: nil, secret_hash: nil, limit: nil, fetch: {})
           at = Time.now
 
           grpc = Ports::GRPC.session
@@ -31,6 +31,10 @@ module Lighstorm
             response.payments.each do |payment|
               payment = payment.to_h
 
+              next unless invoice_code.nil? || payment[:payment_request] == invoice_code
+
+              next unless secret_hash.nil? || payment[:payment_hash] == secret_hash
+
               payment_purpose = Adapter::Purpose.list_payments(payment, get_info)
 
               case purpose
@@ -391,11 +395,22 @@ module Lighstorm
           list_payments
         end
 
-        def self.data(purpose: nil, limit: nil, fetch: {}, &vcr)
+        def self.data(
+          purpose: nil, invoice_code: nil, secret_hash: nil, limit: nil,
+          fetch: {}, &vcr
+        )
           raw = if vcr.nil?
-                  self.fetch(purpose: purpose, limit: limit, fetch: fetch)
+                  self.fetch(
+                    purpose: purpose, invoice_code: invoice_code, secret_hash: secret_hash,
+                    limit: limit, fetch: fetch
+                  )
                 else
-                  vcr.call(-> { self.fetch(purpose: purpose, limit: limit, fetch: fetch) })
+                  vcr.call(lambda {
+                             self.fetch(
+                               purpose: purpose, invoice_code: invoice_code, secret_hash: secret_hash,
+                               limit: limit, fetch: fetch
+                             )
+                           })
                 end
 
           adapted = adapt(raw)

data/controllers/payment.rb

@@ -16,6 +16,14 @@ module Lighstorm
       def self.last(purpose: nil, fetch: {})
         All.model(All.data(purpose: purpose, fetch: fetch)).last
       end
+
+      def self.find_by_secret_hash(secret_hash, &vcr)
+        All.model(All.data(secret_hash: secret_hash, &vcr)).first
+      end
+
+      def self.find_by_invoice_code(invoice_code, &vcr)
+        All.model(All.data(invoice_code: invoice_code, &vcr)).first
+      end
     end
   end
 end

data/docs/README.md

@@ -27,7 +27,7 @@ Lighstorm::Channel.mine.first.myself.node.alias
 Add to your `Gemfile`:
 
 ```ruby
-gem 'lighstorm', '~> 0.0.10'
+gem 'lighstorm', '~> 0.0.11'
 ```
 
 Run `bundle install`.
@@ -60,7 +60,7 @@ Lighstorm.config!(
 ```ruby
 require 'lighstorm'
 
-puts Lighstorm.version # => 0.0.10
+puts Lighstorm.version # => 0.0.11
 
 Lighstorm::Invoice.create(
   description: 'Coffee', amount: { millisatoshis: 1000 }, payable: 'once'
@@ -462,6 +462,12 @@ Lighstorm::Invoice.find_by_secret_hash(
   '1d438b8100518c9fba0a607e3317d6b36f74ceef3a6591836eb2f679c6853501'
 )
 
+invoice = Lighstorm::Invoice.find_by_code('lnbc20n1pj...0eqps7h0k9')
+
+invoice.secret.valid_proof?(
+  'c504f73f83e3772b802844b54021e44e071c03011eeda476b198f7a093bcb09e'
+) # => true
+
 # _key is helpful for reactive javascript frameworks.
 # Please don't consider it as a unique identifier
 # for the item. Instead, use it as a volatile key for
@@ -526,6 +532,19 @@ action.response
 invoice = action.result
 ```
 
+### Proof of Payment
+
+[Making Payments](https://docs.lightning.engineering/the-lightning-network/multihop-payments)
+
+
+```ruby
+invoice = Lighstorm::Invoice.find_by_code('lnbc20n1pj...0eqps7h0k9')
+
+invoice.secret.valid_proof?(
+  'c504f73f83e3772b802844b54021e44e071c03011eeda476b198f7a093bcb09e'
+) # => true
+```
+
 ### Pay
 
 [Understanding Lightning Invoices](https://docs.lightning.engineering/the-lightning-network/payment-lifecycle/understanding-lightning-invoices)
@@ -547,6 +566,8 @@ payment = action.result
 payment.at
 payment.state
 
+payment.secret.proof
+
 payment.amount.millisatoshis
 payment.fee.millisatoshis
 payment.fee.parts_per_million(
@@ -622,6 +643,7 @@ rescue PaymentError => error
   error.result
 end
 ```
+
 ## Payment
 
 [![This is an image representing Payment as a graph.](https://raw.githubusercontent.com/icebaker/assets/main/lighstorm/graph-payment.png)](https://raw.githubusercontent.com/icebaker/assets/main/lighstorm/graph-payment.png)
@@ -642,6 +664,12 @@ Lighstorm::Payment.all(limit: 10, purpose: 'rebalance')
 # 'self-payment', 'peer-to-peer',
 # 'rebalance', 'payment'
 
+Lighstorm::Payment.find_by_invoice_code('lnbc20n1pj...0eqps7h0k9')
+
+Lighstorm::Payment.find_by_secret_hash(
+  '1d438b8100518c9fba0a607e3317d6b36f74ceef3a6591836eb2f679c6853501'
+)
+
 # _key is helpful for reactive javascript frameworks.
 # Please don't consider it as a unique identifier
 # for the item. Instead, use it as a volatile key for
@@ -671,6 +699,7 @@ payment.purpose
 # https://docs.lightning.engineering/the-lightning-network/multihop-payments
 payment.secret.preimage
 payment.secret.hash
+payment.secret.proof
 
 payment.invoice.created_at
 payment.invoice.expires_at
@@ -747,6 +776,18 @@ payment.hops[0].channel.entry.public_key
 payment.hops[0].channel.entry.alias
 payment.hops[0].channel.entry.color
 ```
+
+### Proof of Payment
+
+[Making Payments](https://docs.lightning.engineering/the-lightning-network/multihop-payments)
+
+```ruby
+payment = Lighstorm::Invoice.decode('lnbc20m1pv...qqdhhwkj').pay.result
+
+payment.secret.proof
+# => 'c504f73f83e3772b802844b54021e44e071c03011eeda476b198f7a093bcb09e'
+```
+
 ### Performance
 Avoid fetching data that you don't need:
 ```ruby
@@ -1003,7 +1044,7 @@ gem 'lighstorm', path: '/home/user/lighstorm'
 # demo.rb
 require 'lighstorm'
 
-puts Lighstorm.version # => 0.0.10
+puts Lighstorm.version # => 0.0.11
 ```
 
 ```sh
@@ -1240,13 +1281,13 @@ gem build lighstorm.gemspec
 
 gem signin
 
-gem push lighstorm-0.0.10.gem
+gem push lighstorm-0.0.11.gem
 ```
 
 _________________
 
 <center>
-  lighstorm 0.0.10
+  lighstorm 0.0.11
   |
   <a href="https://github.com/icebaker/lighstorm" rel="noopener noreferrer" target="_blank">GitHub</a>
   |

data/docs/_coverpage.md

@@ -8,7 +8,7 @@
 - Built for maximum **reliability**.
 - Optimized for programmer **happiness**.
 
-0.0.10
+0.0.11
 
 ⚠️ _Warning: Early-stage, breaking changes are expected._
 

data/docs/index.html

@@ -18,7 +18,7 @@
   <script>
     window.$docsify = {
       coverpage: true,
-      name: 'Lighstorm 0.0.10',
+      name: 'Lighstorm 0.0.11',
       repo: 'https://github.com/icebaker/lighstorm'
     }
   </script>

data/models/errors.rb

@@ -2,7 +2,21 @@
 
 module Lighstorm
   module Errors
-    class LighstormError < StandardError; end
+    class LighstormError < StandardError
+      attr_reader :grpc
+
+      def initialize(message = nil, grpc: nil)
+        super(message)
+        @grpc = grpc
+      end
+
+      def to_h
+        output = { class: self.class, message: message }
+        output[:grpc] = grpc.message unless grpc.nil?
+
+        output
+      end
+    end
 
     class ToDoError < LighstormError; end
 
@@ -19,6 +33,7 @@ module Lighstorm
     class OperationNotAllowedError < LighstormError; end
     class UnexpectedNumberOfHTLCsError < LighstormError; end
     class UnknownChannelError < LighstormError; end
+    class NoInvoiceFoundError < LighstormError; end
 
     class InvoiceMayHaveMultiplePaymentsError < LighstormError; end
 

data/models/secret.rb

@@ -26,6 +26,14 @@ module Lighstorm
         @hash = data[:hash]
       end
 
+      def proof
+        @preimage
+      end
+
+      def valid_proof?(candidate_preimage)
+        candidate_preimage == preimage
+      end
+
       def to_h
         {
           preimage: preimage,

data/static/spec.rb

@@ -4,7 +4,7 @@ module Lighstorm
   module Static
     SPEC = {
       name: 'lighstorm',
-      version: '0.0.10',
+      version: '0.0.11',
       author: 'icebaker',
       summary: 'API for interacting with a Lightning Node.',
       description: 'Lighstorm is an opinionated abstraction layer on top of the lnd-client for interacting with a Lightning Node.',

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lighstorm
 version: !ruby/object:Gem::Version
-  version: 0.0.10
+  version: 0.0.11
 platform: ruby
 authors:
 - icebaker
@@ -103,6 +103,7 @@ files:
 - controllers/invoice/actions/pay_through_route.rb
 - controllers/invoice/all.rb
 - controllers/invoice/decode.rb
+- controllers/invoice/find_by_code.rb
 - controllers/invoice/find_by_secret_hash.rb
 - controllers/node.rb
 - controllers/node/actions/apply_gossip.rb