From 71501ef2e814941c67520539c1899b2173620acb Mon Sep 17 00:00:00 2001 From: carla Date: Mon, 24 May 2021 08:40:12 +0200 Subject: [PATCH] looprpc: add server cancelation rpc to server.proto --- loopdb/protocol_version.go | 9 +- loopdb/protocol_version_test.go | 2 + looprpc/server.pb.go | 549 +++++++++++++++++++++++++++----- looprpc/server.proto | 91 ++++++ 4 files changed, 565 insertions(+), 86 deletions(-) diff --git a/loopdb/protocol_version.go b/loopdb/protocol_version.go index bf612f0..309da14 100644 --- a/loopdb/protocol_version.go +++ b/loopdb/protocol_version.go @@ -39,13 +39,17 @@ const ( // invoice so that the server can perform a multi-path probe. ProtocolVersionMultiLoopIn ProtocolVersion = 6 + // ProtocolVersionLoopOutCancel indicates that the client supports + // canceling loop out swaps. + ProtocolVersionLoopOutCancel = 7 + // ProtocolVersionUnrecorded is set for swaps were created before we // started saving protocol version with swaps. ProtocolVersionUnrecorded ProtocolVersion = math.MaxUint32 // CurrentRPCProtocolVersion defines the version of the RPC protocol // that is currently supported by the loop client. - CurrentRPCProtocolVersion = looprpc.ProtocolVersion_MULTI_LOOP_IN + CurrentRPCProtocolVersion = looprpc.ProtocolVersion_LOOP_OUT_CANCEL // CurrentInternalProtocolVersion defines the RPC current protocol in // the internal representation. @@ -81,6 +85,9 @@ func (p ProtocolVersion) String() string { case ProtocolVersionHtlcV2: return "HTLC V2" + case ProtocolVersionLoopOutCancel: + return "Loop Out Cancel" + default: return "Unknown" } diff --git a/loopdb/protocol_version_test.go b/loopdb/protocol_version_test.go index 130fcb5..9c30b41 100644 --- a/loopdb/protocol_version_test.go +++ b/loopdb/protocol_version_test.go @@ -21,6 +21,7 @@ func TestProtocolVersionSanity(t *testing.T) { ProtocolVersionUserExpiryLoopOut, ProtocolVersionHtlcV2, ProtocolVersionMultiLoopIn, + ProtocolVersionLoopOutCancel, } rpcVersions := [...]looprpc.ProtocolVersion{ @@ -31,6 +32,7 @@ func TestProtocolVersionSanity(t *testing.T) { looprpc.ProtocolVersion_USER_EXPIRY_LOOP_OUT, looprpc.ProtocolVersion_HTLC_V2, looprpc.ProtocolVersion_MULTI_LOOP_IN, + looprpc.ProtocolVersion_LOOP_OUT_CANCEL, } require.Equal(t, len(versions), len(rpcVersions)) diff --git a/looprpc/server.pb.go b/looprpc/server.pb.go index dd9bbba..cad4ff0 100644 --- a/looprpc/server.pb.go +++ b/looprpc/server.pb.go @@ -54,6 +54,8 @@ const ( // The client creates a probe invoice so that the server can perform a // multi-path probe. ProtocolVersion_MULTI_LOOP_IN ProtocolVersion = 6 + // The client supports loop out swap cancelation. + ProtocolVersion_LOOP_OUT_CANCEL ProtocolVersion = 7 ) var ProtocolVersion_name = map[int32]string{ @@ -64,6 +66,7 @@ var ProtocolVersion_name = map[int32]string{ 4: "USER_EXPIRY_LOOP_OUT", 5: "HTLC_V2", 6: "MULTI_LOOP_IN", + 7: "LOOP_OUT_CANCEL", } var ProtocolVersion_value = map[string]int32{ @@ -74,6 +77,7 @@ var ProtocolVersion_value = map[string]int32{ "USER_EXPIRY_LOOP_OUT": 4, "HTLC_V2": 5, "MULTI_LOOP_IN": 6, + "LOOP_OUT_CANCEL": 7, } func (x ProtocolVersion) String() string { @@ -163,6 +167,92 @@ func (ServerSwapState) EnumDescriptor() ([]byte, []int) { return fileDescriptor_ad098daeda4239f7, []int{1} } +type RoutePaymentType int32 + +const ( + // No reason, used to distinguish from the default value. + RoutePaymentType_UNKNOWN RoutePaymentType = 0 + // Prepay route indicates that the swap was canceled because the client + // could not find a route to the server for the prepay. + RoutePaymentType_PREPAY_ROUTE RoutePaymentType = 1 + // Invoice route indicates that the swap was canceled because the client + // could not find a route to the server for the swap invoice. + RoutePaymentType_INVOICE_ROUTE RoutePaymentType = 2 +) + +var RoutePaymentType_name = map[int32]string{ + 0: "UNKNOWN", + 1: "PREPAY_ROUTE", + 2: "INVOICE_ROUTE", +} + +var RoutePaymentType_value = map[string]int32{ + "UNKNOWN": 0, + "PREPAY_ROUTE": 1, + "INVOICE_ROUTE": 2, +} + +func (x RoutePaymentType) String() string { + return proto.EnumName(RoutePaymentType_name, int32(x)) +} + +func (RoutePaymentType) EnumDescriptor() ([]byte, []int) { + return fileDescriptor_ad098daeda4239f7, []int{2} +} + +// PaymentFailureReason describes the reason that a payment failed. These +// values are copied directly from lnd. +type PaymentFailureReason int32 + +const ( + // + //Payment isn't failed (yet). + PaymentFailureReason_FAILURE_REASON_NONE PaymentFailureReason = 0 + // + //There are more routes to try, but the payment timeout was exceeded. + PaymentFailureReason_FAILURE_REASON_TIMEOUT PaymentFailureReason = 1 + // + //All possible routes were tried and failed permanently. Or were no + //routes to the destination at all. + PaymentFailureReason_FAILURE_REASON_NO_ROUTE PaymentFailureReason = 2 + // + //A non-recoverable error has occured. + PaymentFailureReason_FAILURE_REASON_ERROR PaymentFailureReason = 3 + // + //Payment details incorrect (unknown hash, invalid amt or + //invalid final cltv delta) + PaymentFailureReason_FAILURE_REASON_INCORRECT_PAYMENT_DETAILS PaymentFailureReason = 4 + // + //Insufficient local balance. + PaymentFailureReason_FAILURE_REASON_INSUFFICIENT_BALANCE PaymentFailureReason = 5 +) + +var PaymentFailureReason_name = map[int32]string{ + 0: "FAILURE_REASON_NONE", + 1: "FAILURE_REASON_TIMEOUT", + 2: "FAILURE_REASON_NO_ROUTE", + 3: "FAILURE_REASON_ERROR", + 4: "FAILURE_REASON_INCORRECT_PAYMENT_DETAILS", + 5: "FAILURE_REASON_INSUFFICIENT_BALANCE", +} + +var PaymentFailureReason_value = map[string]int32{ + "FAILURE_REASON_NONE": 0, + "FAILURE_REASON_TIMEOUT": 1, + "FAILURE_REASON_NO_ROUTE": 2, + "FAILURE_REASON_ERROR": 3, + "FAILURE_REASON_INCORRECT_PAYMENT_DETAILS": 4, + "FAILURE_REASON_INSUFFICIENT_BALANCE": 5, +} + +func (x PaymentFailureReason) String() string { + return proto.EnumName(PaymentFailureReason_name, int32(x)) +} + +func (PaymentFailureReason) EnumDescriptor() ([]byte, []int) { + return fileDescriptor_ad098daeda4239f7, []int{3} +} + type ServerLoopOutRequest struct { ReceiverKey []byte `protobuf:"bytes,1,opt,name=receiver_key,json=receiverKey,proto3" json:"receiver_key,omitempty"` SwapHash []byte `protobuf:"bytes,2,opt,name=swap_hash,json=swapHash,proto3" json:"swap_hash,omitempty"` @@ -1207,9 +1297,236 @@ func (m *SubscribeLoopInUpdatesResponse) GetState() ServerSwapState { return ServerSwapState_INITIATED } +type RouteCancel struct { + // The type of the payment that failed. + RouteType RoutePaymentType `protobuf:"varint,1,opt,name=route_type,json=routeType,proto3,enum=looprpc.RoutePaymentType" json:"route_type,omitempty"` + // The htlcs that the client tried to pay the server with, if any. + Attempts []*HtlcAttempt `protobuf:"bytes,2,rep,name=attempts,proto3" json:"attempts,omitempty"` + // The reason that the payment failed. + Failure PaymentFailureReason `protobuf:"varint,3,opt,name=failure,proto3,enum=looprpc.PaymentFailureReason" json:"failure,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` +} + +func (m *RouteCancel) Reset() { *m = RouteCancel{} } +func (m *RouteCancel) String() string { return proto.CompactTextString(m) } +func (*RouteCancel) ProtoMessage() {} +func (*RouteCancel) Descriptor() ([]byte, []int) { + return fileDescriptor_ad098daeda4239f7, []int{17} +} + +func (m *RouteCancel) XXX_Unmarshal(b []byte) error { + return xxx_messageInfo_RouteCancel.Unmarshal(m, b) +} +func (m *RouteCancel) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + return xxx_messageInfo_RouteCancel.Marshal(b, m, deterministic) +} +func (m *RouteCancel) XXX_Merge(src proto.Message) { + xxx_messageInfo_RouteCancel.Merge(m, src) +} +func (m *RouteCancel) XXX_Size() int { + return xxx_messageInfo_RouteCancel.Size(m) +} +func (m *RouteCancel) XXX_DiscardUnknown() { + xxx_messageInfo_RouteCancel.DiscardUnknown(m) +} + +var xxx_messageInfo_RouteCancel proto.InternalMessageInfo + +func (m *RouteCancel) GetRouteType() RoutePaymentType { + if m != nil { + return m.RouteType + } + return RoutePaymentType_UNKNOWN +} + +func (m *RouteCancel) GetAttempts() []*HtlcAttempt { + if m != nil { + return m.Attempts + } + return nil +} + +func (m *RouteCancel) GetFailure() PaymentFailureReason { + if m != nil { + return m.Failure + } + return PaymentFailureReason_FAILURE_REASON_NONE +} + +type HtlcAttempt struct { + // The number of hops from the htlc's failure hop that it needed to take + // to reach the server's node. + RemainingHops uint32 `protobuf:"varint,1,opt,name=remaining_hops,json=remainingHops,proto3" json:"remaining_hops,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` +} + +func (m *HtlcAttempt) Reset() { *m = HtlcAttempt{} } +func (m *HtlcAttempt) String() string { return proto.CompactTextString(m) } +func (*HtlcAttempt) ProtoMessage() {} +func (*HtlcAttempt) Descriptor() ([]byte, []int) { + return fileDescriptor_ad098daeda4239f7, []int{18} +} + +func (m *HtlcAttempt) XXX_Unmarshal(b []byte) error { + return xxx_messageInfo_HtlcAttempt.Unmarshal(m, b) +} +func (m *HtlcAttempt) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + return xxx_messageInfo_HtlcAttempt.Marshal(b, m, deterministic) +} +func (m *HtlcAttempt) XXX_Merge(src proto.Message) { + xxx_messageInfo_HtlcAttempt.Merge(m, src) +} +func (m *HtlcAttempt) XXX_Size() int { + return xxx_messageInfo_HtlcAttempt.Size(m) +} +func (m *HtlcAttempt) XXX_DiscardUnknown() { + xxx_messageInfo_HtlcAttempt.DiscardUnknown(m) +} + +var xxx_messageInfo_HtlcAttempt proto.InternalMessageInfo + +func (m *HtlcAttempt) GetRemainingHops() uint32 { + if m != nil { + return m.RemainingHops + } + return 0 +} + +type CancelLoopOutSwapRequest struct { + // The protocol version that the client adheres to. + ProtocolVersion ProtocolVersion `protobuf:"varint,1,opt,name=protocol_version,json=protocolVersion,proto3,enum=looprpc.ProtocolVersion" json:"protocol_version,omitempty"` + // The swap hash. + SwapHash []byte `protobuf:"bytes,2,opt,name=swap_hash,json=swapHash,proto3" json:"swap_hash,omitempty"` + // The payment address for the swap invoice, used to ensure that only the + // swap owner can cancel the payment. + PaymentAddress []byte `protobuf:"bytes,3,opt,name=payment_address,json=paymentAddress,proto3" json:"payment_address,omitempty"` + // Additional information about the swap cancelation. + // + // Types that are valid to be assigned to CancelInfo: + // *CancelLoopOutSwapRequest_RouteCancel + CancelInfo isCancelLoopOutSwapRequest_CancelInfo `protobuf_oneof:"cancel_info"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` +} + +func (m *CancelLoopOutSwapRequest) Reset() { *m = CancelLoopOutSwapRequest{} } +func (m *CancelLoopOutSwapRequest) String() string { return proto.CompactTextString(m) } +func (*CancelLoopOutSwapRequest) ProtoMessage() {} +func (*CancelLoopOutSwapRequest) Descriptor() ([]byte, []int) { + return fileDescriptor_ad098daeda4239f7, []int{19} +} + +func (m *CancelLoopOutSwapRequest) XXX_Unmarshal(b []byte) error { + return xxx_messageInfo_CancelLoopOutSwapRequest.Unmarshal(m, b) +} +func (m *CancelLoopOutSwapRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + return xxx_messageInfo_CancelLoopOutSwapRequest.Marshal(b, m, deterministic) +} +func (m *CancelLoopOutSwapRequest) XXX_Merge(src proto.Message) { + xxx_messageInfo_CancelLoopOutSwapRequest.Merge(m, src) +} +func (m *CancelLoopOutSwapRequest) XXX_Size() int { + return xxx_messageInfo_CancelLoopOutSwapRequest.Size(m) +} +func (m *CancelLoopOutSwapRequest) XXX_DiscardUnknown() { + xxx_messageInfo_CancelLoopOutSwapRequest.DiscardUnknown(m) +} + +var xxx_messageInfo_CancelLoopOutSwapRequest proto.InternalMessageInfo + +func (m *CancelLoopOutSwapRequest) GetProtocolVersion() ProtocolVersion { + if m != nil { + return m.ProtocolVersion + } + return ProtocolVersion_LEGACY +} + +func (m *CancelLoopOutSwapRequest) GetSwapHash() []byte { + if m != nil { + return m.SwapHash + } + return nil +} + +func (m *CancelLoopOutSwapRequest) GetPaymentAddress() []byte { + if m != nil { + return m.PaymentAddress + } + return nil +} + +type isCancelLoopOutSwapRequest_CancelInfo interface { + isCancelLoopOutSwapRequest_CancelInfo() +} + +type CancelLoopOutSwapRequest_RouteCancel struct { + RouteCancel *RouteCancel `protobuf:"bytes,5,opt,name=route_cancel,json=routeCancel,proto3,oneof"` +} + +func (*CancelLoopOutSwapRequest_RouteCancel) isCancelLoopOutSwapRequest_CancelInfo() {} + +func (m *CancelLoopOutSwapRequest) GetCancelInfo() isCancelLoopOutSwapRequest_CancelInfo { + if m != nil { + return m.CancelInfo + } + return nil +} + +func (m *CancelLoopOutSwapRequest) GetRouteCancel() *RouteCancel { + if x, ok := m.GetCancelInfo().(*CancelLoopOutSwapRequest_RouteCancel); ok { + return x.RouteCancel + } + return nil +} + +// XXX_OneofWrappers is for the internal use of the proto package. +func (*CancelLoopOutSwapRequest) XXX_OneofWrappers() []interface{} { + return []interface{}{ + (*CancelLoopOutSwapRequest_RouteCancel)(nil), + } +} + +type CancelLoopOutSwapResponse struct { + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` +} + +func (m *CancelLoopOutSwapResponse) Reset() { *m = CancelLoopOutSwapResponse{} } +func (m *CancelLoopOutSwapResponse) String() string { return proto.CompactTextString(m) } +func (*CancelLoopOutSwapResponse) ProtoMessage() {} +func (*CancelLoopOutSwapResponse) Descriptor() ([]byte, []int) { + return fileDescriptor_ad098daeda4239f7, []int{20} +} + +func (m *CancelLoopOutSwapResponse) XXX_Unmarshal(b []byte) error { + return xxx_messageInfo_CancelLoopOutSwapResponse.Unmarshal(m, b) +} +func (m *CancelLoopOutSwapResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + return xxx_messageInfo_CancelLoopOutSwapResponse.Marshal(b, m, deterministic) +} +func (m *CancelLoopOutSwapResponse) XXX_Merge(src proto.Message) { + xxx_messageInfo_CancelLoopOutSwapResponse.Merge(m, src) +} +func (m *CancelLoopOutSwapResponse) XXX_Size() int { + return xxx_messageInfo_CancelLoopOutSwapResponse.Size(m) +} +func (m *CancelLoopOutSwapResponse) XXX_DiscardUnknown() { + xxx_messageInfo_CancelLoopOutSwapResponse.DiscardUnknown(m) +} + +var xxx_messageInfo_CancelLoopOutSwapResponse proto.InternalMessageInfo + func init() { proto.RegisterEnum("looprpc.ProtocolVersion", ProtocolVersion_name, ProtocolVersion_value) proto.RegisterEnum("looprpc.ServerSwapState", ServerSwapState_name, ServerSwapState_value) + proto.RegisterEnum("looprpc.RoutePaymentType", RoutePaymentType_name, RoutePaymentType_value) + proto.RegisterEnum("looprpc.PaymentFailureReason", PaymentFailureReason_name, PaymentFailureReason_value) proto.RegisterType((*ServerLoopOutRequest)(nil), "looprpc.ServerLoopOutRequest") proto.RegisterType((*ServerLoopOutResponse)(nil), "looprpc.ServerLoopOutResponse") proto.RegisterType((*ServerLoopOutQuoteRequest)(nil), "looprpc.ServerLoopOutQuoteRequest") @@ -1227,96 +1544,122 @@ func init() { proto.RegisterType((*SubscribeUpdatesRequest)(nil), "looprpc.SubscribeUpdatesRequest") proto.RegisterType((*SubscribeLoopOutUpdatesResponse)(nil), "looprpc.SubscribeLoopOutUpdatesResponse") proto.RegisterType((*SubscribeLoopInUpdatesResponse)(nil), "looprpc.SubscribeLoopInUpdatesResponse") + proto.RegisterType((*RouteCancel)(nil), "looprpc.RouteCancel") + proto.RegisterType((*HtlcAttempt)(nil), "looprpc.HtlcAttempt") + proto.RegisterType((*CancelLoopOutSwapRequest)(nil), "looprpc.CancelLoopOutSwapRequest") + proto.RegisterType((*CancelLoopOutSwapResponse)(nil), "looprpc.CancelLoopOutSwapResponse") } func init() { proto.RegisterFile("server.proto", fileDescriptor_ad098daeda4239f7) } var fileDescriptor_ad098daeda4239f7 = []byte{ - // 1336 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xb4, 0x56, 0x4f, 0x73, 0xda, 0x46, - 0x14, 0xaf, 0xc4, 0x1f, 0x9b, 0x07, 0xd8, 0xf2, 0x26, 0x71, 0x30, 0x89, 0x53, 0xac, 0x34, 0x29, - 0xf5, 0xc1, 0xc9, 0xa4, 0xb7, 0xde, 0x14, 0x90, 0x63, 0x4d, 0xb0, 0xa0, 0x02, 0x9c, 0xe4, 0xb4, - 0x5d, 0xe3, 0xad, 0xad, 0x29, 0x48, 0x8a, 0x24, 0x1c, 0x7b, 0x7a, 0xec, 0xe7, 0xe8, 0x4c, 0xa7, - 0xc7, 0x5e, 0xda, 0x4b, 0x3f, 0x41, 0x67, 0xfa, 0x0d, 0xfa, 0x7d, 0x3a, 0xbb, 0x5a, 0x81, 0x04, - 0xb2, 0x13, 0x77, 0xdc, 0x1b, 0x7a, 0xef, 0xb7, 0xef, 0xcf, 0xef, 0xbd, 0xfd, 0x2d, 0x50, 0x09, - 0xa8, 0x7f, 0x4e, 0xfd, 0x3d, 0xcf, 0x77, 0x43, 0x17, 0xad, 0x8c, 0x5d, 0xd7, 0xf3, 0xbd, 0x51, - 0xfd, 0xe1, 0xa9, 0xeb, 0x9e, 0x8e, 0xe9, 0x33, 0xe2, 0xd9, 0xcf, 0x88, 0xe3, 0xb8, 0x21, 0x09, - 0x6d, 0xd7, 0x09, 0x22, 0x98, 0xfa, 0x8b, 0x0c, 0x77, 0xfb, 0xfc, 0x5c, 0xc7, 0x75, 0xbd, 0xee, - 0x34, 0xb4, 0xe8, 0xfb, 0x29, 0x0d, 0x42, 0xb4, 0x03, 0x15, 0x9f, 0x8e, 0xa8, 0x7d, 0x4e, 0x7d, - 0xfc, 0x03, 0xbd, 0xac, 0x49, 0x0d, 0xa9, 0x59, 0xb1, 0xca, 0xb1, 0xed, 0x35, 0xbd, 0x44, 0x0f, - 0xa0, 0x14, 0x7c, 0x20, 0x1e, 0x3e, 0x23, 0xc1, 0x59, 0x4d, 0xe6, 0xfe, 0x55, 0x66, 0x38, 0x20, - 0xc1, 0x19, 0x52, 0x20, 0x47, 0x26, 0x61, 0x2d, 0xd7, 0x90, 0x9a, 0x79, 0x8b, 0xfd, 0x44, 0xdf, - 0xc0, 0x16, 0x87, 0x7b, 0xd3, 0xe3, 0xb1, 0x3d, 0xe2, 0x55, 0xe0, 0x13, 0x4a, 0x4e, 0xc6, 0xb6, - 0x43, 0x6b, 0xf9, 0x86, 0xd4, 0xcc, 0x59, 0xf7, 0x19, 0xa0, 0x37, 0xf7, 0xb7, 0x85, 0x1b, 0xb5, - 0x40, 0xe1, 0xf5, 0x8e, 0xdc, 0x31, 0x3e, 0xa7, 0x7e, 0x60, 0xbb, 0x4e, 0xad, 0xd0, 0x90, 0x9a, - 0x6b, 0x2f, 0x6a, 0x7b, 0xa2, 0xd1, 0xbd, 0x9e, 0x00, 0x1c, 0x45, 0x7e, 0x6b, 0xdd, 0x4b, 0x1b, - 0xd0, 0x26, 0x14, 0xe9, 0x85, 0x67, 0xfb, 0x97, 0xb5, 0x62, 0x43, 0x6a, 0x16, 0x2c, 0xf1, 0x85, - 0xb6, 0x01, 0xa6, 0x01, 0xf5, 0x31, 0x39, 0xa5, 0x4e, 0x58, 0x5b, 0x69, 0x48, 0xcd, 0x92, 0x55, - 0x62, 0x16, 0x8d, 0x19, 0xd4, 0xbf, 0x24, 0xb8, 0xb7, 0x40, 0x51, 0xe0, 0xb9, 0x4e, 0x40, 0x19, - 0x47, 0xbc, 0x23, 0xdb, 0x39, 0x77, 0xed, 0x11, 0xe5, 0x1c, 0x95, 0xac, 0x32, 0xb3, 0x19, 0x91, - 0x09, 0x3d, 0x81, 0x35, 0xcf, 0xa7, 0x1e, 0xb9, 0x9c, 0x81, 0x64, 0x0e, 0xaa, 0x46, 0xd6, 0x18, - 0xb6, 0x0d, 0x10, 0x50, 0xe7, 0x44, 0x70, 0x9d, 0xe3, 0x5c, 0x96, 0x22, 0x0b, 0x63, 0xba, 0x3e, - 0xab, 0x9c, 0xf1, 0x54, 0x78, 0x29, 0xd7, 0xa4, 0x59, 0xf5, 0x4f, 0x60, 0x2d, 0x1a, 0x3c, 0x9e, - 0xd0, 0x20, 0x20, 0xa7, 0x94, 0x13, 0x53, 0xb2, 0xaa, 0x91, 0xf5, 0x30, 0x32, 0xaa, 0x7f, 0x4b, - 0xb0, 0x95, 0xea, 0xe2, 0xdb, 0xa9, 0x1b, 0xd2, 0x78, 0xda, 0x62, 0x5a, 0xd2, 0x27, 0x4e, 0x4b, - 0xbe, 0xf9, 0xb4, 0x72, 0xff, 0x7d, 0x5a, 0xf9, 0xe4, 0xb4, 0xd4, 0x9f, 0x65, 0x40, 0xcb, 0x8d, - 0xa0, 0x5d, 0xd8, 0x88, 0xea, 0x25, 0x97, 0x13, 0xea, 0x84, 0xf8, 0x84, 0x06, 0xa1, 0x18, 0xc8, - 0x3a, 0xaf, 0x33, 0xb2, 0xb7, 0x59, 0xb7, 0x5b, 0xc0, 0xf7, 0x14, 0x7f, 0x4f, 0xe3, 0x56, 0x56, - 0xd8, 0xf7, 0x3e, 0xa5, 0xe8, 0x29, 0x54, 0x63, 0x17, 0xf6, 0x49, 0x48, 0x79, 0xdd, 0x39, 0x4e, - 0x78, 0x59, 0x60, 0x2c, 0x12, 0xf2, 0x81, 0x89, 0xb9, 0x32, 0xde, 0xf2, 0x9c, 0xb7, 0x52, 0x64, - 0xd1, 0x26, 0x21, 0xda, 0x85, 0xf5, 0x89, 0xed, 0x60, 0x1e, 0x8a, 0x4c, 0xdc, 0xa9, 0x13, 0xf2, - 0xa9, 0xe4, 0x79, 0xa0, 0xea, 0xc4, 0x76, 0xfa, 0x1f, 0x88, 0xa7, 0x71, 0x07, 0xc7, 0x92, 0x8b, - 0x14, 0xb6, 0x98, 0xc0, 0x92, 0x8b, 0x04, 0x76, 0x07, 0x60, 0x34, 0x0e, 0xcf, 0xf1, 0x09, 0x1d, - 0x87, 0x84, 0xaf, 0x6a, 0xb4, 0x0c, 0x25, 0x66, 0x6d, 0x33, 0xa3, 0xfa, 0xdd, 0xc2, 0x9c, 0x07, - 0xd4, 0x9f, 0x04, 0xf1, 0x9c, 0xb3, 0x26, 0x23, 0xdd, 0x70, 0x32, 0xea, 0x1f, 0xd2, 0xc2, 0x04, - 0x78, 0x0a, 0xf4, 0x74, 0xb9, 0xe7, 0x68, 0x9f, 0x16, 0xfa, 0x7d, 0xba, 0xdc, 0xaf, 0x2c, 0x70, - 0xa9, 0x5e, 0xbf, 0x80, 0x35, 0x16, 0x2f, 0xd1, 0x6f, 0x8e, 0x2f, 0x42, 0x65, 0x62, 0x3b, 0xad, - 0xb8, 0x5d, 0x8e, 0x22, 0x17, 0x49, 0x54, 0x5e, 0xa0, 0xc8, 0xc5, 0x0c, 0xa5, 0xfe, 0x26, 0xc3, - 0x9d, 0x79, 0xc9, 0x86, 0x13, 0xf3, 0x91, 0xbe, 0x77, 0xd2, 0xe2, 0xbd, 0xbb, 0xa1, 0xc2, 0x2d, - 0xea, 0x41, 0x7e, 0x59, 0x0f, 0xb6, 0x60, 0x75, 0x4c, 0x82, 0x10, 0x9f, 0xb9, 0x1e, 0xdf, 0x88, - 0x8a, 0xb5, 0xc2, 0xbe, 0x0f, 0x5c, 0x2f, 0x73, 0x36, 0xc5, 0x9b, 0xde, 0x9a, 0xc7, 0x50, 0xf5, - 0x7c, 0xf7, 0x98, 0xce, 0x6a, 0x88, 0xe4, 0xac, 0xc2, 0x8d, 0x09, 0xb5, 0x49, 0x08, 0xde, 0xea, - 0xa2, 0xe0, 0x5d, 0x24, 0x9f, 0x04, 0xc6, 0xd5, 0x5c, 0xee, 0x3e, 0xf6, 0x24, 0xcc, 0x2f, 0xad, - 0x9c, 0x92, 0xd8, 0x65, 0x91, 0xca, 0x65, 0x89, 0xd4, 0x7b, 0xa8, 0x25, 0x33, 0x7f, 0x44, 0xa2, - 0xb2, 0x08, 0x93, 0x6f, 0xba, 0xcc, 0xff, 0xa4, 0x74, 0x71, 0x96, 0x53, 0xb4, 0x9c, 0x54, 0x0a, - 0xe9, 0x23, 0x4a, 0x21, 0x67, 0x2b, 0x45, 0x86, 0x14, 0xe4, 0x6f, 0x20, 0x05, 0x85, 0xab, 0xa4, - 0x60, 0x3b, 0x25, 0x05, 0xd1, 0x8b, 0x96, 0x90, 0x01, 0x9c, 0xa6, 0xf2, 0xf6, 0x55, 0x60, 0x04, - 0x1b, 0x4b, 0x09, 0x6e, 0x5b, 0x03, 0xd4, 0x9f, 0x24, 0x68, 0xa4, 0xa4, 0xa6, 0x37, 0x0d, 0xce, - 0x7a, 0x3e, 0xb5, 0x27, 0xe4, 0x94, 0xde, 0x66, 0x3b, 0xa8, 0x0e, 0xab, 0x9e, 0x88, 0x1b, 0xdf, - 0xf4, 0xf8, 0x5b, 0x7d, 0x0c, 0x3b, 0xd7, 0x14, 0x11, 0xad, 0x8a, 0xfa, 0x23, 0xdc, 0xef, 0x4f, - 0x8f, 0x83, 0x91, 0x6f, 0x1f, 0xd3, 0xa1, 0x77, 0x42, 0x42, 0x7a, 0xab, 0x7c, 0x5f, 0xab, 0x45, - 0x6a, 0x08, 0x9f, 0xcf, 0x92, 0x8b, 0x22, 0x67, 0x35, 0xcc, 0x6f, 0x6f, 0x68, 0x4f, 0x68, 0x10, - 0x92, 0x89, 0x87, 0x9d, 0x40, 0xac, 0x73, 0x79, 0x66, 0x33, 0x03, 0xb4, 0x07, 0x85, 0x20, 0x8c, - 0x57, 0x39, 0x59, 0x5c, 0xd4, 0x3d, 0x9b, 0x4b, 0x9f, 0xf9, 0xad, 0x08, 0xa6, 0x06, 0xf0, 0x28, - 0x95, 0xd5, 0x70, 0xfe, 0xff, 0xa4, 0xbb, 0xbf, 0x4a, 0xb0, 0xbe, 0x40, 0x16, 0x02, 0x28, 0x76, - 0xf4, 0x57, 0x5a, 0xeb, 0x9d, 0xf2, 0x19, 0x42, 0xb0, 0x76, 0x38, 0xec, 0x0c, 0x0c, 0xdc, 0xe9, - 0x76, 0x7b, 0xb8, 0x3b, 0x1c, 0x28, 0x12, 0xda, 0x82, 0x7b, 0xa6, 0x36, 0x30, 0x8e, 0x74, 0xdc, - 0xd7, 0x5f, 0xbd, 0x31, 0x06, 0x91, 0xcf, 0x30, 0x15, 0x19, 0xd5, 0x61, 0xb3, 0x67, 0xe9, 0xc6, - 0xa1, 0xf6, 0x4a, 0xc7, 0xbd, 0x61, 0xff, 0x60, 0x7e, 0x2c, 0x87, 0x6a, 0x70, 0x77, 0xd8, 0xd7, - 0x2d, 0xac, 0xbf, 0xed, 0x19, 0xd6, 0xbb, 0xb9, 0x27, 0x8f, 0xca, 0xb0, 0x72, 0x30, 0xe8, 0xb4, - 0xf0, 0xd1, 0x0b, 0xa5, 0x80, 0x36, 0xa0, 0x9a, 0xc8, 0x68, 0x98, 0x4a, 0x71, 0xf7, 0x4f, 0x19, - 0xd6, 0x17, 0xea, 0x47, 0x55, 0x28, 0x19, 0xa6, 0x31, 0x30, 0xb4, 0x81, 0xde, 0x8e, 0xea, 0xe4, - 0x21, 0x7a, 0xc3, 0x97, 0x1d, 0xa3, 0x7f, 0xa0, 0xb7, 0x15, 0x89, 0x85, 0xed, 0x0f, 0x5b, 0x2d, - 0xbd, 0xdf, 0x57, 0x64, 0x06, 0xd8, 0xd7, 0x8c, 0x8e, 0xde, 0xc6, 0x43, 0xf3, 0xb5, 0xd9, 0x7d, - 0x63, 0x2a, 0xb9, 0x84, 0xcd, 0xec, 0x62, 0x76, 0x5c, 0xc9, 0xa3, 0x47, 0x50, 0x17, 0x36, 0xc3, - 0x3c, 0xd2, 0x3a, 0x46, 0x9b, 0x3b, 0xb0, 0x76, 0xd8, 0x1d, 0x9a, 0x03, 0xa5, 0x80, 0x1e, 0x42, - 0x4d, 0xf8, 0xbb, 0xfb, 0xfb, 0xb8, 0x75, 0xa0, 0x19, 0x26, 0x1e, 0x18, 0x87, 0x3a, 0xeb, 0xa4, - 0x98, 0x88, 0x18, 0xdb, 0x56, 0x58, 0xdf, 0xc2, 0xd6, 0x7f, 0xa3, 0xf5, 0x70, 0x5b, 0xd7, 0xda, - 0x1d, 0xc3, 0xd4, 0x95, 0x55, 0xf4, 0x00, 0xee, 0x0b, 0xcf, 0xbc, 0xf6, 0x96, 0x36, 0x30, 0xba, - 0xa6, 0x52, 0x42, 0xf7, 0x60, 0x43, 0xc4, 0x48, 0x34, 0x05, 0x68, 0x13, 0xd0, 0xd0, 0xd4, 0xdf, - 0xf6, 0xf4, 0xd6, 0x40, 0x6f, 0x63, 0x76, 0x7c, 0x68, 0xe9, 0x4a, 0x79, 0x46, 0x40, 0xab, 0x6b, - 0xee, 0x1b, 0xd6, 0xa1, 0xde, 0x56, 0x2a, 0x2f, 0x7e, 0x2f, 0x02, 0x70, 0xc6, 0x38, 0x77, 0xa8, - 0x0b, 0x95, 0xd4, 0x5f, 0x0c, 0x75, 0x61, 0x39, 0x32, 0xfe, 0xe2, 0xd4, 0x1f, 0x5c, 0x83, 0x41, - 0x5d, 0x58, 0x33, 0xe9, 0x07, 0x61, 0x62, 0x89, 0xd0, 0x76, 0x36, 0x3c, 0x8e, 0xf6, 0xe8, 0x2a, - 0xb7, 0x58, 0xf0, 0x31, 0xdc, 0xc9, 0x10, 0x05, 0xf4, 0x55, 0xf6, 0xb1, 0x0c, 0xf5, 0xaa, 0xef, - 0x7e, 0x0a, 0x54, 0x64, 0x9b, 0xf3, 0x11, 0xfd, 0xe9, 0xbd, 0x82, 0x8f, 0xe4, 0xbb, 0x79, 0x15, - 0x1f, 0x51, 0x80, 0x0e, 0x94, 0x93, 0xf2, 0xbd, 0x93, 0x81, 0x4d, 0xbf, 0x1d, 0xf5, 0xfa, 0xd5, - 0x10, 0xd4, 0x81, 0xaa, 0x60, 0xd7, 0xe0, 0x62, 0x8f, 0x1e, 0x66, 0x82, 0xe3, 0x50, 0xdb, 0x57, - 0x78, 0x45, 0xb3, 0x83, 0xb8, 0xb6, 0xa8, 0xd4, 0xec, 0xda, 0x52, 0xad, 0xaa, 0xd7, 0x41, 0x44, - 0xd4, 0xd3, 0x84, 0x4c, 0xa7, 0x95, 0x12, 0x35, 0xe6, 0xc7, 0xb3, 0x85, 0xbc, 0xde, 0x5c, 0x46, - 0x64, 0xab, 0xed, 0x73, 0x09, 0x51, 0xd8, 0xcc, 0x16, 0xc7, 0x4f, 0xc8, 0xf3, 0x65, 0x76, 0x9e, - 0x25, 0x7d, 0x7d, 0x2e, 0x1d, 0x17, 0xf9, 0x3b, 0xf1, 0xf5, 0xbf, 0x01, 0x00, 0x00, 0xff, 0xff, - 0xbd, 0x37, 0x63, 0xb1, 0xfe, 0x0f, 0x00, 0x00, + // 1695 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xbc, 0x57, 0xcd, 0x6e, 0xdb, 0xca, + 0x15, 0x0e, 0x25, 0xd9, 0xb2, 0x8e, 0x24, 0x9b, 0x9e, 0xfc, 0xc9, 0x4a, 0x9c, 0x2a, 0x4c, 0x6f, + 0xa2, 0x1a, 0x45, 0x6e, 0x90, 0x16, 0xe8, 0xcf, 0x8e, 0xa1, 0xe8, 0x88, 0xb8, 0x32, 0xa9, 0x52, + 0x94, 0x73, 0xd3, 0xcd, 0x94, 0x96, 0x27, 0x36, 0x51, 0x89, 0xe4, 0x25, 0x29, 0xc7, 0x46, 0x97, + 0x5d, 0xf6, 0x19, 0x0a, 0x74, 0xdd, 0x55, 0x51, 0xa0, 0xe8, 0x03, 0x14, 0xe8, 0x1b, 0x74, 0xd1, + 0xa7, 0xe8, 0x2b, 0x14, 0xf3, 0x43, 0x89, 0x94, 0xe8, 0x24, 0xbe, 0x30, 0xee, 0x4e, 0x3c, 0xe7, + 0x9b, 0x39, 0xe7, 0x7c, 0xe7, 0xcc, 0x37, 0x23, 0x68, 0xc4, 0x24, 0xba, 0x20, 0xd1, 0xcb, 0x30, + 0x0a, 0x92, 0x00, 0x55, 0xa7, 0x41, 0x10, 0x46, 0xe1, 0xa4, 0xfd, 0xf8, 0x2c, 0x08, 0xce, 0xa6, + 0xe4, 0x6b, 0x37, 0xf4, 0xbe, 0x76, 0x7d, 0x3f, 0x48, 0xdc, 0xc4, 0x0b, 0xfc, 0x98, 0xc3, 0x94, + 0xbf, 0x94, 0xe0, 0xde, 0x88, 0xad, 0x1b, 0x04, 0x41, 0x68, 0xcd, 0x13, 0x9b, 0x7c, 0x37, 0x27, + 0x71, 0x82, 0x9e, 0x42, 0x23, 0x22, 0x13, 0xe2, 0x5d, 0x90, 0x08, 0xff, 0x9e, 0x5c, 0xb5, 0xa4, + 0x8e, 0xd4, 0x6d, 0xd8, 0xf5, 0xd4, 0xf6, 0x0d, 0xb9, 0x42, 0x8f, 0xa0, 0x16, 0x7f, 0x74, 0x43, + 0x7c, 0xee, 0xc6, 0xe7, 0xad, 0x12, 0xf3, 0x6f, 0x51, 0x43, 0xdf, 0x8d, 0xcf, 0x91, 0x0c, 0x65, + 0x77, 0x96, 0xb4, 0xca, 0x1d, 0xa9, 0x5b, 0xb1, 0xe9, 0x4f, 0xf4, 0x6b, 0xd8, 0x63, 0xf0, 0x70, + 0x7e, 0x32, 0xf5, 0x26, 0x2c, 0x0b, 0x7c, 0x4a, 0xdc, 0xd3, 0xa9, 0xe7, 0x93, 0x56, 0xa5, 0x23, + 0x75, 0xcb, 0xf6, 0x43, 0x0a, 0x18, 0x2e, 0xfd, 0x3d, 0xe1, 0x46, 0x1a, 0xc8, 0x2c, 0xdf, 0x49, + 0x30, 0xc5, 0x17, 0x24, 0x8a, 0xbd, 0xc0, 0x6f, 0x6d, 0x74, 0xa4, 0xee, 0xf6, 0xeb, 0xd6, 0x4b, + 0x51, 0xe8, 0xcb, 0xa1, 0x00, 0x1c, 0x73, 0xbf, 0xbd, 0x13, 0xe6, 0x0d, 0xe8, 0x01, 0x6c, 0x92, + 0xcb, 0xd0, 0x8b, 0xae, 0x5a, 0x9b, 0x1d, 0xa9, 0xbb, 0x61, 0x8b, 0x2f, 0xb4, 0x0f, 0x30, 0x8f, + 0x49, 0x84, 0xdd, 0x33, 0xe2, 0x27, 0xad, 0x6a, 0x47, 0xea, 0xd6, 0xec, 0x1a, 0xb5, 0xa8, 0xd4, + 0xa0, 0xfc, 0x4b, 0x82, 0xfb, 0x2b, 0x14, 0xc5, 0x61, 0xe0, 0xc7, 0x84, 0x72, 0xc4, 0x2a, 0xf2, + 0xfc, 0x8b, 0xc0, 0x9b, 0x10, 0xc6, 0x51, 0xcd, 0xae, 0x53, 0x9b, 0xc1, 0x4d, 0xe8, 0x2b, 0xd8, + 0x0e, 0x23, 0x12, 0xba, 0x57, 0x0b, 0x50, 0x89, 0x81, 0x9a, 0xdc, 0x9a, 0xc2, 0xf6, 0x01, 0x62, + 0xe2, 0x9f, 0x0a, 0xae, 0xcb, 0x8c, 0xcb, 0x1a, 0xb7, 0x50, 0xa6, 0xdb, 0x8b, 0xcc, 0x29, 0x4f, + 0x1b, 0x6f, 0x4a, 0x2d, 0x69, 0x91, 0xfd, 0x57, 0xb0, 0xcd, 0x1b, 0x8f, 0x67, 0x24, 0x8e, 0xdd, + 0x33, 0xc2, 0x88, 0xa9, 0xd9, 0x4d, 0x6e, 0x3d, 0xe2, 0x46, 0xe5, 0xdf, 0x12, 0xec, 0xe5, 0xaa, + 0xf8, 0xcd, 0x3c, 0x48, 0x48, 0xda, 0x6d, 0xd1, 0x2d, 0xe9, 0x0b, 0xbb, 0x55, 0xba, 0x79, 0xb7, + 0xca, 0xdf, 0xbf, 0x5b, 0x95, 0x6c, 0xb7, 0x94, 0x3f, 0x97, 0x00, 0xad, 0x17, 0x82, 0x0e, 0x60, + 0x97, 0xe7, 0xeb, 0x5e, 0xcd, 0x88, 0x9f, 0xe0, 0x53, 0x12, 0x27, 0xa2, 0x21, 0x3b, 0x2c, 0x4f, + 0x6e, 0xef, 0xd1, 0x6a, 0xf7, 0x80, 0xcd, 0x29, 0xfe, 0x40, 0xd2, 0x52, 0xaa, 0xf4, 0xfb, 0x90, + 0x10, 0xf4, 0x1c, 0x9a, 0xa9, 0x0b, 0x47, 0x6e, 0x42, 0x58, 0xde, 0x65, 0x46, 0x78, 0x5d, 0x60, + 0x6c, 0x37, 0x61, 0x0d, 0x13, 0x7d, 0xa5, 0xbc, 0x55, 0x18, 0x6f, 0x35, 0x6e, 0x51, 0x67, 0x09, + 0x3a, 0x80, 0x9d, 0x99, 0xe7, 0x63, 0xb6, 0x95, 0x3b, 0x0b, 0xe6, 0x7e, 0xc2, 0xba, 0x52, 0x61, + 0x1b, 0x35, 0x67, 0x9e, 0x3f, 0xfa, 0xe8, 0x86, 0x2a, 0x73, 0x30, 0xac, 0x7b, 0x99, 0xc3, 0x6e, + 0x66, 0xb0, 0xee, 0x65, 0x06, 0xfb, 0x14, 0x60, 0x32, 0x4d, 0x2e, 0xf0, 0x29, 0x99, 0x26, 0x2e, + 0x1b, 0x55, 0x3e, 0x0c, 0x35, 0x6a, 0xed, 0x51, 0xa3, 0xf2, 0xbb, 0x95, 0x3e, 0x3b, 0x24, 0x9a, + 0xc5, 0x69, 0x9f, 0x8b, 0x3a, 0x23, 0xdd, 0xb0, 0x33, 0xca, 0xdf, 0xa4, 0x95, 0x0e, 0xb0, 0x10, + 0xe8, 0xf9, 0x7a, 0xcd, 0x7c, 0x9e, 0x56, 0xea, 0x7d, 0xbe, 0x5e, 0x6f, 0x49, 0xe0, 0x72, 0xb5, + 0xfe, 0x18, 0xb6, 0xe9, 0x7e, 0x99, 0x7a, 0xcb, 0x6c, 0x10, 0x1a, 0x33, 0xcf, 0xd7, 0xd2, 0x72, + 0x19, 0xca, 0xbd, 0xcc, 0xa2, 0x2a, 0x02, 0xe5, 0x5e, 0x2e, 0x50, 0xca, 0x5f, 0x4b, 0x70, 0x77, + 0x99, 0xb2, 0xe1, 0xa7, 0x7c, 0xe4, 0xcf, 0x9d, 0xb4, 0x7a, 0xee, 0x6e, 0xa8, 0x70, 0xab, 0x7a, + 0x50, 0x59, 0xd7, 0x83, 0x3d, 0xd8, 0x9a, 0xba, 0x71, 0x82, 0xcf, 0x83, 0x90, 0x4d, 0x44, 0xc3, + 0xae, 0xd2, 0xef, 0x7e, 0x10, 0x16, 0xf6, 0x66, 0xf3, 0xa6, 0xa7, 0xe6, 0x19, 0x34, 0xc3, 0x28, + 0x38, 0x21, 0x8b, 0x1c, 0xb8, 0x9c, 0x35, 0x98, 0x31, 0xa3, 0x36, 0x19, 0xc1, 0xdb, 0x5a, 0x15, + 0xbc, 0xcb, 0xec, 0x95, 0x40, 0xb9, 0x5a, 0xca, 0xdd, 0xe7, 0xae, 0x84, 0xe5, 0xa1, 0x2d, 0xe5, + 0x24, 0x76, 0x5d, 0xa4, 0xca, 0x45, 0x22, 0xf5, 0x1d, 0xb4, 0xb2, 0x91, 0x3f, 0x23, 0x51, 0x45, + 0x84, 0x95, 0x6e, 0x3a, 0xcc, 0xff, 0xc9, 0xe9, 0xe2, 0x22, 0xa6, 0x28, 0x39, 0xab, 0x14, 0xd2, + 0x67, 0x94, 0xa2, 0x54, 0xac, 0x14, 0x05, 0x52, 0x50, 0xb9, 0x81, 0x14, 0x6c, 0x5c, 0x27, 0x05, + 0xfb, 0x39, 0x29, 0xe0, 0x37, 0x5a, 0x46, 0x06, 0x70, 0x9e, 0xca, 0xdb, 0x57, 0x81, 0x09, 0xec, + 0xae, 0x05, 0xb8, 0x6d, 0x0d, 0x50, 0xfe, 0x28, 0x41, 0x27, 0x27, 0x35, 0xc3, 0x79, 0x7c, 0x3e, + 0x8c, 0x88, 0x37, 0x73, 0xcf, 0xc8, 0x6d, 0x96, 0x83, 0xda, 0xb0, 0x15, 0x8a, 0x7d, 0xd3, 0x93, + 0x9e, 0x7e, 0x2b, 0xcf, 0xe0, 0xe9, 0x27, 0x92, 0xe0, 0xa3, 0xa2, 0xfc, 0x01, 0x1e, 0x8e, 0xe6, + 0x27, 0xf1, 0x24, 0xf2, 0x4e, 0xc8, 0x38, 0x3c, 0x75, 0x13, 0x72, 0xab, 0x7c, 0x7f, 0x52, 0x8b, + 0x94, 0x04, 0x7e, 0xb4, 0x08, 0x2e, 0x92, 0x5c, 0xe4, 0xb0, 0x3c, 0xbd, 0x89, 0x37, 0x23, 0x71, + 0xe2, 0xce, 0x42, 0xec, 0xc7, 0x62, 0x9c, 0xeb, 0x0b, 0x9b, 0x19, 0xa3, 0x97, 0xb0, 0x11, 0x27, + 0xe9, 0x28, 0x67, 0x93, 0xe3, 0xd5, 0xd3, 0xbe, 0x8c, 0xa8, 0xdf, 0xe6, 0x30, 0x25, 0x86, 0x27, + 0xb9, 0xa8, 0x86, 0xff, 0x03, 0x04, 0xfd, 0xbb, 0x04, 0x75, 0x3b, 0x98, 0x27, 0x44, 0x73, 0xfd, + 0x09, 0x99, 0xa2, 0x5f, 0x02, 0x44, 0xf4, 0x13, 0x27, 0x57, 0x21, 0x11, 0xb4, 0xee, 0x2d, 0x36, + 0x61, 0x48, 0x71, 0xf7, 0x3b, 0x57, 0x21, 0xb1, 0x6b, 0x0c, 0x4c, 0x7f, 0xa2, 0x57, 0xb0, 0xe5, + 0x26, 0x09, 0x99, 0x85, 0x49, 0xdc, 0x2a, 0x75, 0xca, 0xdd, 0xfa, 0xeb, 0x7b, 0x8b, 0x75, 0xfd, + 0x64, 0x3a, 0x51, 0xb9, 0xd3, 0x5e, 0xa0, 0xd0, 0x2f, 0xa0, 0xfa, 0xc1, 0xf5, 0xa6, 0xf3, 0x88, + 0x88, 0xf7, 0xcc, 0xfe, 0xb2, 0x7f, 0x3c, 0xc6, 0x21, 0x77, 0xdb, 0xc4, 0x8d, 0x03, 0xdf, 0x4e, + 0xd1, 0xca, 0xcf, 0xa1, 0x9e, 0xd9, 0x91, 0xca, 0x61, 0x44, 0x66, 0xae, 0xe7, 0x7b, 0xfe, 0x19, + 0xbd, 0x0a, 0x38, 0x31, 0x4d, 0xbb, 0xb9, 0xb0, 0xf6, 0x83, 0x30, 0x56, 0xfe, 0x27, 0x41, 0x8b, + 0x57, 0x29, 0x7a, 0x4a, 0xc9, 0xf8, 0xc1, 0x86, 0x0a, 0xbd, 0x80, 0x9d, 0xf4, 0x35, 0xe5, 0x9e, + 0x9e, 0x46, 0x24, 0x8e, 0xc5, 0xcb, 0x74, 0x5b, 0x98, 0x55, 0x6e, 0x45, 0xbf, 0x82, 0x06, 0x6f, + 0xc1, 0x84, 0x25, 0xcb, 0x34, 0x2b, 0x4b, 0x66, 0xa6, 0x5d, 0xfd, 0x3b, 0x76, 0x3d, 0x5a, 0x7e, + 0xbe, 0x69, 0x42, 0x9d, 0x2f, 0xc2, 0x9e, 0xff, 0x21, 0x50, 0x1e, 0xc1, 0x5e, 0x41, 0xc1, 0x7c, + 0x98, 0x0e, 0xfe, 0x29, 0xc1, 0xce, 0x4a, 0x45, 0x08, 0x60, 0x73, 0xa0, 0xbf, 0x55, 0xb5, 0xf7, + 0xf2, 0x1d, 0x84, 0x60, 0xfb, 0x68, 0x3c, 0x70, 0x0c, 0x3c, 0xb0, 0xac, 0x21, 0xb6, 0xc6, 0x8e, + 0x2c, 0xa1, 0x3d, 0xb8, 0x6f, 0xaa, 0x8e, 0x71, 0xac, 0xe3, 0x91, 0xfe, 0xf6, 0x9d, 0xe1, 0x70, + 0x9f, 0x61, 0xca, 0x25, 0xd4, 0x86, 0x07, 0x43, 0x5b, 0x37, 0x8e, 0xd4, 0xb7, 0x3a, 0x1e, 0x8e, + 0x47, 0xfd, 0xe5, 0xb2, 0x32, 0x6a, 0xc1, 0xbd, 0xf1, 0x48, 0xb7, 0xb1, 0xfe, 0xed, 0xd0, 0xb0, + 0xdf, 0x2f, 0x3d, 0x15, 0x54, 0x87, 0x6a, 0xdf, 0x19, 0x68, 0xf8, 0xf8, 0xb5, 0xbc, 0x81, 0x76, + 0xa1, 0x99, 0x89, 0x68, 0x98, 0xf2, 0x26, 0xba, 0x0b, 0x3b, 0x29, 0x1a, 0x6b, 0xaa, 0xa9, 0xe9, + 0x03, 0xb9, 0x7a, 0xf0, 0x8f, 0x12, 0xec, 0xac, 0x8c, 0x33, 0x6a, 0x42, 0xcd, 0x30, 0x0d, 0xc7, + 0x50, 0x1d, 0xbd, 0xc7, 0x93, 0x67, 0xfb, 0x0e, 0xc7, 0x6f, 0x06, 0xc6, 0xa8, 0xaf, 0xf7, 0x64, + 0x89, 0xc6, 0x1a, 0x8d, 0x35, 0x4d, 0x1f, 0x8d, 0xe4, 0x12, 0x05, 0x1c, 0xaa, 0xc6, 0x40, 0xef, + 0xe1, 0xb1, 0xf9, 0x8d, 0x69, 0xbd, 0x33, 0xe5, 0x72, 0xc6, 0x66, 0x5a, 0x98, 0x2e, 0x97, 0x2b, + 0xe8, 0x09, 0xb4, 0x85, 0xcd, 0x30, 0x8f, 0xd5, 0x81, 0xd1, 0x63, 0x0e, 0xac, 0x1e, 0x59, 0x63, + 0xd3, 0x91, 0x37, 0xd0, 0x63, 0x68, 0x09, 0xbf, 0x75, 0x78, 0x88, 0xb5, 0xbe, 0x6a, 0x98, 0xd8, + 0x31, 0x8e, 0x74, 0x5a, 0xde, 0x66, 0x66, 0xc7, 0xd4, 0x56, 0xa5, 0x64, 0x08, 0xdb, 0xe8, 0x9d, + 0x3a, 0xc4, 0x3d, 0x5d, 0xed, 0x0d, 0x0c, 0x53, 0x97, 0xb7, 0xd0, 0x23, 0x78, 0x28, 0x3c, 0xcb, + 0xdc, 0x35, 0xd5, 0x31, 0x2c, 0x53, 0xae, 0xa1, 0xfb, 0xb0, 0x2b, 0xf6, 0xc8, 0x14, 0x05, 0xe8, + 0x01, 0xa0, 0xb1, 0xa9, 0x7f, 0x3b, 0xd4, 0x35, 0x47, 0xef, 0x61, 0xba, 0x7c, 0x6c, 0xeb, 0x72, + 0x7d, 0x41, 0x80, 0x66, 0x99, 0x87, 0x86, 0x7d, 0xa4, 0xf7, 0xe4, 0xc6, 0x41, 0x0f, 0xe4, 0xd5, + 0x03, 0x4c, 0x49, 0x49, 0x09, 0xb8, 0x83, 0x64, 0x68, 0x0c, 0x6d, 0x7d, 0xa8, 0xbe, 0xc7, 0xb6, + 0x35, 0x76, 0x74, 0x59, 0xa2, 0x2d, 0x31, 0xcc, 0x63, 0xcb, 0xd0, 0x74, 0x61, 0x2a, 0x1d, 0xfc, + 0x57, 0x82, 0x7b, 0x45, 0xc7, 0x13, 0x3d, 0x84, 0xbb, 0x22, 0x3e, 0xb6, 0x75, 0x75, 0x64, 0x99, + 0xd8, 0xb4, 0x4c, 0x5d, 0xbe, 0x43, 0x47, 0x63, 0xc5, 0x91, 0xb2, 0x21, 0xa5, 0x35, 0xe7, 0x16, + 0xa5, 0xa1, 0x52, 0xaa, 0x32, 0x4e, 0xdd, 0xb6, 0x2d, 0x5b, 0x2e, 0xa3, 0x9f, 0x42, 0x77, 0xc5, + 0x63, 0x98, 0x9a, 0x65, 0xdb, 0xba, 0xe6, 0xe0, 0xa1, 0xfa, 0xfe, 0x48, 0x37, 0x1d, 0xdc, 0xd3, + 0x1d, 0xd5, 0x18, 0x8c, 0xe4, 0x0a, 0x7a, 0x01, 0xcf, 0xd6, 0xd0, 0xa3, 0xf1, 0xe1, 0xa1, 0xa1, + 0x19, 0x14, 0xf8, 0x46, 0x1d, 0xd0, 0xd1, 0x92, 0x37, 0x5e, 0xff, 0xa9, 0x0a, 0xc0, 0x66, 0x8a, + 0x4d, 0x17, 0xb2, 0xa0, 0x91, 0x7b, 0x93, 0x2b, 0x2b, 0x6a, 0x5a, 0xf0, 0x9f, 0xa0, 0xfd, 0xe8, + 0x13, 0x18, 0x64, 0xc1, 0xb6, 0x49, 0x3e, 0x66, 0x4e, 0x23, 0xda, 0x2f, 0x86, 0xa7, 0xbb, 0x3d, + 0xb9, 0xce, 0x2d, 0x6e, 0x84, 0x29, 0xdc, 0x2d, 0xb8, 0x45, 0xd1, 0x4f, 0x8a, 0x97, 0x15, 0x5c, + 0xf7, 0xed, 0x83, 0x2f, 0x81, 0x8a, 0x68, 0x4b, 0x3e, 0xf8, 0xbf, 0xc4, 0x6b, 0xf8, 0xc8, 0x3e, + 0x34, 0xaf, 0xe3, 0x83, 0x6f, 0x30, 0x80, 0x7a, 0xf6, 0xbd, 0xf3, 0xb4, 0x00, 0x9b, 0x7f, 0x6c, + 0xb5, 0xdb, 0xd7, 0x43, 0xd0, 0x00, 0x9a, 0x82, 0x5d, 0x83, 0xbd, 0x8e, 0xd0, 0xe3, 0x42, 0x70, + 0xba, 0xd5, 0xfe, 0x35, 0x5e, 0x51, 0xac, 0x93, 0xe6, 0xc6, 0x53, 0x2d, 0xce, 0x2d, 0x57, 0xaa, + 0xf2, 0x29, 0x88, 0xd8, 0xf5, 0x2c, 0xf3, 0xae, 0xc9, 0x3f, 0x2d, 0x50, 0x67, 0xb9, 0xbc, 0xf8, + 0xe5, 0xd3, 0xee, 0xae, 0x23, 0x8a, 0x9f, 0x27, 0xaf, 0x24, 0x44, 0xe0, 0x41, 0xf1, 0x6b, 0xe2, + 0x0b, 0xe2, 0xbc, 0x28, 0x8e, 0xb3, 0xf6, 0x20, 0x79, 0x25, 0xa1, 0xdf, 0xc2, 0xee, 0xda, 0x15, + 0x93, 0xe1, 0xea, 0xba, 0xfb, 0x36, 0xc3, 0xd5, 0xb5, 0x37, 0xd4, 0xc9, 0x26, 0xbb, 0x5f, 0x7f, + 0xf6, 0xff, 0x00, 0x00, 0x00, 0xff, 0xff, 0x54, 0x28, 0x45, 0x23, 0x8b, 0x13, 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. @@ -1340,6 +1683,7 @@ type SwapServerClient interface { LoopInQuote(ctx context.Context, in *ServerLoopInQuoteRequest, opts ...grpc.CallOption) (*ServerLoopInQuoteResponse, error) SubscribeLoopOutUpdates(ctx context.Context, in *SubscribeUpdatesRequest, opts ...grpc.CallOption) (SwapServer_SubscribeLoopOutUpdatesClient, error) SubscribeLoopInUpdates(ctx context.Context, in *SubscribeUpdatesRequest, opts ...grpc.CallOption) (SwapServer_SubscribeLoopInUpdatesClient, error) + CancelLoopOutSwap(ctx context.Context, in *CancelLoopOutSwapRequest, opts ...grpc.CallOption) (*CancelLoopOutSwapResponse, error) } type swapServerClient struct { @@ -1477,6 +1821,15 @@ func (x *swapServerSubscribeLoopInUpdatesClient) Recv() (*SubscribeLoopInUpdates return m, nil } +func (c *swapServerClient) CancelLoopOutSwap(ctx context.Context, in *CancelLoopOutSwapRequest, opts ...grpc.CallOption) (*CancelLoopOutSwapResponse, error) { + out := new(CancelLoopOutSwapResponse) + err := c.cc.Invoke(ctx, "/looprpc.SwapServer/CancelLoopOutSwap", in, out, opts...) + if err != nil { + return nil, err + } + return out, nil +} + // SwapServerServer is the server API for SwapServer service. type SwapServerServer interface { LoopOutTerms(context.Context, *ServerLoopOutTermsRequest) (*ServerLoopOutTerms, error) @@ -1488,6 +1841,7 @@ type SwapServerServer interface { LoopInQuote(context.Context, *ServerLoopInQuoteRequest) (*ServerLoopInQuoteResponse, error) SubscribeLoopOutUpdates(*SubscribeUpdatesRequest, SwapServer_SubscribeLoopOutUpdatesServer) error SubscribeLoopInUpdates(*SubscribeUpdatesRequest, SwapServer_SubscribeLoopInUpdatesServer) error + CancelLoopOutSwap(context.Context, *CancelLoopOutSwapRequest) (*CancelLoopOutSwapResponse, error) } // UnimplementedSwapServerServer can be embedded to have forward compatible implementations. @@ -1521,6 +1875,9 @@ func (*UnimplementedSwapServerServer) SubscribeLoopOutUpdates(req *SubscribeUpda func (*UnimplementedSwapServerServer) SubscribeLoopInUpdates(req *SubscribeUpdatesRequest, srv SwapServer_SubscribeLoopInUpdatesServer) error { return status.Errorf(codes.Unimplemented, "method SubscribeLoopInUpdates not implemented") } +func (*UnimplementedSwapServerServer) CancelLoopOutSwap(ctx context.Context, req *CancelLoopOutSwapRequest) (*CancelLoopOutSwapResponse, error) { + return nil, status.Errorf(codes.Unimplemented, "method CancelLoopOutSwap not implemented") +} func RegisterSwapServerServer(s *grpc.Server, srv SwapServerServer) { s.RegisterService(&_SwapServer_serviceDesc, srv) @@ -1694,6 +2051,24 @@ func (x *swapServerSubscribeLoopInUpdatesServer) Send(m *SubscribeLoopInUpdatesR return x.ServerStream.SendMsg(m) } +func _SwapServer_CancelLoopOutSwap_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) { + in := new(CancelLoopOutSwapRequest) + if err := dec(in); err != nil { + return nil, err + } + if interceptor == nil { + return srv.(SwapServerServer).CancelLoopOutSwap(ctx, in) + } + info := &grpc.UnaryServerInfo{ + Server: srv, + FullMethod: "/looprpc.SwapServer/CancelLoopOutSwap", + } + handler := func(ctx context.Context, req interface{}) (interface{}, error) { + return srv.(SwapServerServer).CancelLoopOutSwap(ctx, req.(*CancelLoopOutSwapRequest)) + } + return interceptor(ctx, in, info, handler) +} + var _SwapServer_serviceDesc = grpc.ServiceDesc{ ServiceName: "looprpc.SwapServer", HandlerType: (*SwapServerServer)(nil), @@ -1726,6 +2101,10 @@ var _SwapServer_serviceDesc = grpc.ServiceDesc{ MethodName: "LoopInQuote", Handler: _SwapServer_LoopInQuote_Handler, }, + { + MethodName: "CancelLoopOutSwap", + Handler: _SwapServer_CancelLoopOutSwap_Handler, + }, }, Streams: []grpc.StreamDesc{ { diff --git a/looprpc/server.proto b/looprpc/server.proto index c4febbc..b63aefe 100644 --- a/looprpc/server.proto +++ b/looprpc/server.proto @@ -26,6 +26,9 @@ service SwapServer { rpc SubscribeLoopInUpdates (SubscribeUpdatesRequest) returns (stream SubscribeLoopInUpdatesResponse); + + rpc CancelLoopOutSwap(CancelLoopOutSwapRequest) + returns (CancelLoopOutSwapResponse); } /** @@ -64,6 +67,9 @@ enum ProtocolVersion { // The client creates a probe invoice so that the server can perform a // multi-path probe. MULTI_LOOP_IN = 6; + + // The client supports loop out swap cancelation. + LOOP_OUT_CANCEL = 7; } message ServerLoopOutRequest { @@ -309,3 +315,88 @@ message SubscribeLoopInUpdatesResponse{ // The swap's current state. ServerSwapState state = 2; } + +enum RoutePaymentType { + // No reason, used to distinguish from the default value. + UNKNOWN = 0; + + // Prepay route indicates that the swap was canceled because the client + // could not find a route to the server for the prepay. + PREPAY_ROUTE = 1; + + // Invoice route indicates that the swap was canceled because the client + // could not find a route to the server for the swap invoice. + INVOICE_ROUTE = 2; +} + +// PaymentFailureReason describes the reason that a payment failed. These +// values are copied directly from lnd. +enum PaymentFailureReason { + /* + Payment isn't failed (yet). + */ + FAILURE_REASON_NONE = 0; + + /* + There are more routes to try, but the payment timeout was exceeded. + */ + FAILURE_REASON_TIMEOUT = 1; + + /* + All possible routes were tried and failed permanently. Or were no + routes to the destination at all. + */ + FAILURE_REASON_NO_ROUTE = 2; + + /* + A non-recoverable error has occured. + */ + FAILURE_REASON_ERROR = 3; + + /* + Payment details incorrect (unknown hash, invalid amt or + invalid final cltv delta) + */ + FAILURE_REASON_INCORRECT_PAYMENT_DETAILS = 4; + + /* + Insufficient local balance. + */ + FAILURE_REASON_INSUFFICIENT_BALANCE = 5; +} + +message RouteCancel { + // The type of the payment that failed. + RoutePaymentType route_type = 1; + + // The htlcs that the client tried to pay the server with, if any. + repeated HtlcAttempt attempts = 2; + + // The reason that the payment failed. + PaymentFailureReason failure = 3; +} + +message HtlcAttempt { + // The number of hops from the htlc's failure hop that it needed to take + // to reach the server's node. + uint32 remaining_hops = 1; +} + +message CancelLoopOutSwapRequest { + // The protocol version that the client adheres to. + ProtocolVersion protocol_version = 1; + + // The swap hash. + bytes swap_hash = 2; + + // The payment address for the swap invoice, used to ensure that only the + // swap owner can cancel the payment. + bytes payment_address = 3; + + // Additional information about the swap cancelation. + oneof cancel_info { + RouteCancel route_cancel = 5; + } +} + +message CancelLoopOutSwapResponse{}