astra-lightning 1.1.0 → 1.1.2

package/grpc/protos/rfqrpc/rfq.proto

@@ -236,12 +236,15 @@ message PeerAcceptedBuyQuote {
     // The unique identifier of the quote request.
     bytes id = 2;
 
-    // scid is the short channel ID of the channel over which the payment for
-    // the quote should be made.
+    // The short channel ID of the channel over which the payment for the quote
+    // should be made.
     uint64 scid = 3;
 
-    // asset_amount is the amount of the subject asset.
-    uint64 asset_amount = 4;
+    // The maximum exchange amount denoted in the subject asset. This includes
+    // the user-configured maximum routing fees, so the actual payment amount
+    // will be less than this. This just defines the maximum volume that the
+    // edge node has accepted to divest with the given rate.
+    uint64 asset_max_amount = 4;
 
     // ask_asset_rate is the asset to BTC conversion rate represented as a
     // fixed-point number.
@@ -249,6 +252,12 @@ message PeerAcceptedBuyQuote {
 
     // The unix timestamp in seconds after which the quote is no longer valid.
     uint64 expiry = 6;
+
+    // The smallest amount of asset units that can be transported within a
+    // single HTLC over the Lightning Network with the given rate. This is the
+    // asset unit equivalent of 354 satoshis, which is the minimum amount for an
+    // HTLC to be above the dust limit.
+    uint64 min_transportable_units = 7;
 }
 
 message PeerAcceptedSellQuote {
@@ -271,6 +280,13 @@ message PeerAcceptedSellQuote {
 
     // The unix timestamp in seconds after which the quote is no longer valid.
     uint64 expiry = 6;
+
+    // The minimum amount of milli-satoshis that need to be sent out in order to
+    // transport a single asset unit over the Lightning Network with the given
+    // rate. This is the base amount of 354,000 milli-satoshi (the minimum
+    // amount for a non-dust HTLC) plus the equivalent of one asset unit in
+    // milli-satoshis.
+    uint64 min_transportable_msat = 7;
 }
 
 // QuoteRespStatus is an enum that represents the status of a quote response.

package/grpc/protos/tapchannelrpc.proto

@@ -7,6 +7,7 @@ option go_package = "github.com/lightninglabs/taproot-assets/taprpc/tapchannelrp
 import "rfqrpc/rfq.proto";
 import "lightning.proto";
 import "routerrpc/router.proto";
+import "taprootassets.proto";
 
 service TaprootAssetChannels {
     /*
@@ -39,6 +40,13 @@ service TaprootAssetChannels {
     to the specified asset amount.
     */
     rpc AddInvoice (AddInvoiceRequest) returns (AddInvoiceResponse);
+
+    /*
+    DecodeAssetPayReq is similar to lnd's lnrpc.DecodePayReq, but it accepts an
+    asset ID and returns the invoice amount expressed in asset units along side
+    the normal information.
+    */
+    rpc DecodeAssetPayReq (AssetPayReq) returns (AssetPayReqResponse);
 }
 
 message FundChannelRequest {
@@ -121,6 +129,19 @@ message SendPaymentRequest {
     // contain a valid keysend record (key 5482373484 and a 32-byte preimage
     // that corresponds to the payment hash).
     routerrpc.SendPaymentRequest payment_request = 4;
+
+    // The rfq id to use for this payment. If the user sets this value then the
+    // payment will immediately be dispatched, skipping the rfq negotiation
+    // phase, and using the following rfq id instead.
+    bytes rfq_id = 5;
+
+    // If a small invoice should be paid that is below the amount that always
+    // needs to be sent out to carry a single asset unit, then by default the
+    // payment is rejected. If this flag is set, then the payment will be
+    // allowed to proceed, even if it is uneconomical, meaning that more sats
+    // are sent out to the network than the invoice amount plus routing fees
+    // require to be paid.
+    bool allow_overpay = 6;
 }
 
 message SendPaymentResponse {
@@ -175,4 +196,31 @@ message AddInvoiceResponse {
 
     // The result of the invoice creation.
     lnrpc.AddInvoiceResponse invoice_result = 2;
+}
+
+message AssetPayReq {
+    // The asset ID that will be used to resolve the invoice's satoshi amount.
+    bytes asset_id = 1;
+
+    // The normal LN invoice that whose amount will be mapped to units of the
+    // asset ID.
+    string pay_req_string = 2;
+}
+
+message AssetPayReqResponse {
+    // The invoice amount, expressed in asset units.
+    uint64 asset_amount = 1;
+
+    // The decimal display corresponding to the asset_id.
+    taprpc.DecimalDisplay decimal_display = 2;
+
+    // The group the asset ID belong to, if applicable.
+    taprpc.AssetGroup asset_group = 3;
+
+    // Genesis information for the asset ID which includes the meta hash, and
+    // asset ID.
+    taprpc.GenesisInfo genesis_info = 4;
+
+    // The normal decoded payment request.
+    lnrpc.PayReq pay_req = 5;
 }