swapserverrpc: sync with server types

Author: starius

swapserverrpc/instantout.pb.go

@@ -30,7 +30,8 @@ service InstantSwapServer {
     rpc PushPreimage (PushPreimageRequest) returns (PushPreimageResponse);
 
     // CancelInstantSwap tries to cancel the instant swap. This can only be
-    // called if the swap has not been accepted yet.
+    // called if the swap has not been accepted yet. This allows the server to
+    // release the reservation inputs.
     rpc CancelInstantSwap (CancelInstantSwapRequest)
         returns (CancelInstantSwapResponse);
 
@@ -48,7 +49,9 @@ message InstantLoopOutRequest {
     // The hash of the preimage that will be used to settle the htlc.
     bytes swap_hash = 2;
 
-    // The requested absolute block height of the on-chain htlc.
+    // The requested absolute block height of the on-chain htlc. This is
+    // subjected to min and max constraints as reported in the LoopOutTerms
+    // response.
     int32 expiry = 3;
 
     // The fee rate in sat/kw that should be used for the htlc.

swapserverrpc/instantout.proto

@@ -22,6 +22,8 @@ service ReservationService {
 // ReservationNotificationRequest is an empty request sent from the client to
 // the server to open a stream to receive reservation notifications.
 message ReservationNotificationRequest {
+    // protocol_version is the maximum version the client supports.
+    ReservationProtocolVersion protocol_version = 1;
 }
 
 // ServerReservationNotification is a notification sent from the server to the
@@ -64,7 +66,7 @@ enum ReservationProtocolVersion {
     // protocol version is not set.
     RESERVATION_NONE = 0;
 
-    // RESERVATION_SERVER_REQUEST is the first version of the reservation
+    // RESERVATION_SERVER_NOTIFY is the first version of the reservation
     // protocol where the server notifies the client about a reservation.
     RESERVATION_SERVER_NOTIFY = 1;
 };