looprpc: rename assetamt to max amt

Author: sputn1ck

client.go

@@ -703,11 +703,11 @@ func (s *Client) LoopOutQuote(ctx context.Context,
 		}
 
 		loopOutQuote.LoopOutRfq = &LoopOutRfq{
-			PrepayRfqId:    prepayRfq.Id,
-			PrepayAssetAmt: prepayRfq.AssetAmount,
-			SwapRfqId:      swapRfq.Id,
-			SwapAssetAmt:   swapRfq.AssetAmount,
-			AssetName:      assetName,
+			PrepayRfqId:       prepayRfq.Id,
+			MaxPrepayAssetAmt: prepayRfq.AssetAmount,
+			SwapRfqId:         swapRfq.Id,
+			MaxSwapAssetAmt:   swapRfq.AssetAmount,
+			AssetName:         assetName,
 		}
 	}
 

cmd/loop/quote.go

@@ -269,7 +269,7 @@ func printQuoteOutResp(req *looprpc.QuoteRequest,
 
 	if resp.AssetRfqInfo != nil {
 		fmt.Printf(assetAmtFmt, "Send off-chain:",
-			resp.AssetRfqInfo.SwapAssetAmt,
+			resp.AssetRfqInfo.MaxSwapAssetAmt,
 			resp.AssetRfqInfo.AssetName)
 	} else {
 		fmt.Printf(satAmtFmt, "Send off-chain:", req.Amt)
@@ -289,7 +289,7 @@ func printQuoteOutResp(req *looprpc.QuoteRequest,
 	fmt.Println()
 	if resp.AssetRfqInfo != nil {
 		fmt.Printf(assetAmtFmt, "No show penalty (prepay):",
-			resp.AssetRfqInfo.PrepayAssetAmt,
+			resp.AssetRfqInfo.MaxPrepayAssetAmt,
 			resp.AssetRfqInfo.AssetName)
 	} else {
 		fmt.Printf(satAmtFmt, "No show penalty (prepay):",

interface.go

@@ -224,16 +224,16 @@ type LoopOutRfq struct {
 	// PrepayRfqId is the ID of the prepay RFQ.
 	PrepayRfqId []byte
 
-	// PrepayAssetAmt is the amount of the asset that will be used to pay
-	// for the prepay invoice.
-	PrepayAssetAmt uint64
+	// MaxPrepayAssetAmt is the maximum amount of the asset that will be
+	// used to pay for the prepay invoice.
+	MaxPrepayAssetAmt uint64
 
 	// SwapRfqId is the ID of the swap RFQ.
 	SwapRfqId []byte
 
-	// SwapAssetAmt is the amount of the asset that will be used to pay for
-	// the swap invoice.
-	SwapAssetAmt uint64
+	// MaxSwapAssetAmt is the maxmimum amount of the asset that will be used
+	// to pay for the swap invoice.
+	MaxSwapAssetAmt uint64
 
 	// AssetName is the human readable name of the asset.
 	AssetName string

loopd/swapclient_server.go

@@ -802,11 +802,11 @@ func (s *swapClientServer) LoopOutQuote(ctx context.Context,
 
 	if quote.LoopOutRfq != nil {
 		response.AssetRfqInfo = &looprpc.AssetRfqInfo{
-			PrepayRfqId:    quote.LoopOutRfq.PrepayRfqId,
-			PrepayAssetAmt: quote.LoopOutRfq.PrepayAssetAmt,
-			SwapRfqId:      quote.LoopOutRfq.SwapRfqId,
-			SwapAssetAmt:   quote.LoopOutRfq.SwapAssetAmt,
-			AssetName:      quote.LoopOutRfq.AssetName,
+			PrepayRfqId:       quote.LoopOutRfq.PrepayRfqId,
+			MaxPrepayAssetAmt: quote.LoopOutRfq.MaxPrepayAssetAmt,
+			SwapRfqId:       quote.LoopOutRfq.SwapRfqId,
+			MaxSwapAssetAmt: quote.LoopOutRfq.MaxSwapAssetAmt,
+			AssetName: quote.LoopOutRfq.AssetName,
 		}
 	}
 

looprpc/client.pb.go

@@ -2066,26 +2066,71 @@ message AssetRfqInfo {
     bytes prepay_rfq_id = 1;
 
     /*
-    The actual asset amt to prepay for the swap invoice.
+    The maximum asset amt we'll pay for the prepay payment. This includes the
+    max limit multiplier that was set in the request.
     */
-    uint64 prepay_asset_amt = 2;
+    uint64 max_prepay_asset_amt = 2;
+
+    /*
+    The asset to BTC conversion rate for the prepay invoice.
+    */
+    FixedPoint prepay_asset_rate = 6;
 
     /*
     The Swap RFQ ID to use to pay for the swap invoice.
     */
     bytes swap_rfq_id = 3;
 
     /*
-    The actual asset amt to swap for the swap invoice.
+    The maximum asset amt we'll pay for the swap payment. This includes the
+    max limit multiplier that was set in the request.
     */
-    uint64 swap_asset_amt = 4;
+    uint64 max_swap_asset_amt = 4;
+
+    /*
+    The asset to BTC conversion rate for the swap invoice.
+   */
+    FixedPoint swap_asset_rate = 7;
 
     /*
     The name of the asset to swap.
     */
     string asset_name = 5;
 }
 
+// FixedPoint is a scaled integer representation of a fractional number.
+//
+// This type consists of two integer fields: a coefficient and a scale.
+// Using this format enables precise and consistent representation of fractional
+// numbers while avoiding floating-point data types, which are prone to
+// precision errors.
+//
+// The relationship between the fractional representation and its fixed-point
+// representation is expressed as:
+// ```
+// V = F_c / (10^F_s)
+// ```
+// where:
+//
+// * `V` is the fractional value.
+//
+// * `F_c` is the coefficient component of the fixed-point representation. It is
+//    the scaled-up fractional value represented as an integer.
+//
+// * `F_s` is the scale component. It is an integer specifying how
+//   many decimal places `F_c` should be divided by to obtain the fractional
+//   representation.
+message FixedPoint {
+    // The coefficient is the fractional value scaled-up as an integer. This
+    // integer is represented as a string as it may be too large to fit in a
+    // uint64.
+    string coefficient = 1;
+
+    // The scale is the component that determines how many decimal places
+    // the coefficient should be divided by to obtain the fractional value.
+    uint32 scale = 2;
+}
+
 message AssetLoopOutInfo {
     /*
     The asset id that was used to pay for the swap invoice.

looprpc/client.proto

@@ -731,20 +731,28 @@
           "format": "byte",
           "description": "The Prepay RFQ ID to use to pay for the prepay invoice."
         },
-        "prepay_asset_amt": {
+        "max_prepay_asset_amt": {
           "type": "string",
           "format": "uint64",
-          "description": "The actual asset amt to prepay for the swap invoice."
+          "description": "The maximum asset amt we'll pay for the prepay payment. This includes the\nmax limit multiplier that was set in the request."
+        },
+        "prepay_asset_rate": {
+          "$ref": "#/definitions/looprpcFixedPoint",
+          "description": "The asset to BTC conversion rate for the prepay invoice."
         },
         "swap_rfq_id": {
           "type": "string",
           "format": "byte",
           "description": "The Swap RFQ ID to use to pay for the swap invoice."
         },
-        "swap_asset_amt": {
+        "max_swap_asset_amt": {
           "type": "string",
           "format": "uint64",
-          "description": "The actual asset amt to swap for the swap invoice."
+          "description": "The maximum asset amt we'll pay for the swap payment. This includes the\nmax limit multiplier that was set in the request."
+        },
+        "swap_asset_rate": {
+          "$ref": "#/definitions/looprpcFixedPoint",
+          "description": "The asset to BTC conversion rate for the swap invoice."
         },
         "asset_name": {
           "type": "string",
@@ -896,6 +904,21 @@
     "looprpcFetchL402TokenResponse": {
       "type": "object"
     },
+    "looprpcFixedPoint": {
+      "type": "object",
+      "properties": {
+        "coefficient": {
+          "type": "string",
+          "description": "The coefficient is the fractional value scaled-up as an integer. This\ninteger is represented as a string as it may be too large to fit in a\nuint64."
+        },
+        "scale": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The scale is the component that determines how many decimal places\nthe coefficient should be divided by to obtain the fractional value."
+        }
+      },
+      "description": "FixedPoint is a scaled integer representation of a fractional number.\n\nThis type consists of two integer fields: a coefficient and a scale.\nUsing this format enables precise and consistent representation of fractional\nnumbers while avoiding floating-point data types, which are prone to\nprecision errors.\n\nThe relationship between the fractional representation and its fixed-point\nrepresentation is expressed as:\n```\nV = F_c / (10^F_s)\n```\nwhere:\n\n* `V` is the fractional value.\n\n* `F_c` is the coefficient component of the fixed-point representation. It is\n   the scaled-up fractional value represented as an integer.\n\n* `F_s` is the scale component. It is an integer specifying how\n  many decimal places `F_c` should be divided by to obtain the fractional\n  representation."
+    },
     "looprpcGetInfoResponse": {
       "type": "object",
       "properties": {