From 290350516436be4f6c10d5bd7cf3a305de1997ed Mon Sep 17 00:00:00 2001 From: Joost Jager Date: Wed, 24 Jun 2020 12:03:00 +0200 Subject: [PATCH] htlcswitch: expose custom records on intercepted packet --- htlcswitch/interceptable_switch.go | 1 + htlcswitch/interfaces.go | 5 + htlcswitch/link.go | 2 + htlcswitch/packet.go | 5 + lnrpc/routerrpc/forward_interceptor.go | 1 + lnrpc/routerrpc/router.pb.go | 342 ++++++++++--------- lnrpc/routerrpc/router.proto | 3 + lnrpc/routerrpc/router.swagger.json | 8 + lntest/itest/lnd_forward_interceptor_test.go | 14 + 9 files changed, 216 insertions(+), 165 deletions(-) diff --git a/htlcswitch/interceptable_switch.go b/htlcswitch/interceptable_switch.go index d510a5fb..c623c289 100644 --- a/htlcswitch/interceptable_switch.go +++ b/htlcswitch/interceptable_switch.go @@ -127,6 +127,7 @@ func (f *interceptedForward) Packet() InterceptedPacket { OutgoingAmount: f.htlc.Amount, IncomingAmount: f.packet.incomingAmount, IncomingExpiry: f.packet.incomingTimeout, + CustomRecords: f.packet.customRecords, } } diff --git a/htlcswitch/interfaces.go b/htlcswitch/interfaces.go index f9684c59..1f1a1bad 100644 --- a/htlcswitch/interfaces.go +++ b/htlcswitch/interfaces.go @@ -8,6 +8,7 @@ import ( "github.com/lightningnetwork/lnd/lntypes" "github.com/lightningnetwork/lnd/lnwallet" "github.com/lightningnetwork/lnd/lnwire" + "github.com/lightningnetwork/lnd/record" ) // InvoiceDatabase is an interface which represents the persistent subsystem @@ -226,6 +227,10 @@ type InterceptedPacket struct { // IncomingAmount is the amount of the accepted htlc. IncomingAmount lnwire.MilliSatoshi + + // CustomRecords are user-defined records in the custom type range that + // were included in the payload. + CustomRecords record.CustomSet } // InterceptedForward is passed to the ForwardInterceptor for every forwarded diff --git a/htlcswitch/link.go b/htlcswitch/link.go index 9276696c..3931af34 100644 --- a/htlcswitch/link.go +++ b/htlcswitch/link.go @@ -2731,6 +2731,7 @@ func (l *channelLink) processRemoteAdds(fwdPkg *channeldb.FwdPkg, obfuscator: obfuscator, incomingTimeout: pd.Timeout, outgoingTimeout: fwdInfo.OutgoingCTLV, + customRecords: pld.CustomRecords(), } switchPackets = append( switchPackets, updatePacket, @@ -2794,6 +2795,7 @@ func (l *channelLink) processRemoteAdds(fwdPkg *channeldb.FwdPkg, obfuscator: obfuscator, incomingTimeout: pd.Timeout, outgoingTimeout: fwdInfo.OutgoingCTLV, + customRecords: pld.CustomRecords(), } fwdPkg.FwdFilter.Set(idx) diff --git a/htlcswitch/packet.go b/htlcswitch/packet.go index e0aa7527..78c3af8e 100644 --- a/htlcswitch/packet.go +++ b/htlcswitch/packet.go @@ -4,6 +4,7 @@ import ( "github.com/lightningnetwork/lnd/channeldb" "github.com/lightningnetwork/lnd/htlcswitch/hop" "github.com/lightningnetwork/lnd/lnwire" + "github.com/lightningnetwork/lnd/record" ) // htlcPacket is a wrapper around htlc lnwire update, which adds additional @@ -91,6 +92,10 @@ type htlcPacket struct { // will be extraced from the hop payload recevived by the incoming // link. outgoingTimeout uint32 + + // customRecords are user-defined records in the custom type range that + // were included in the payload. + customRecords record.CustomSet } // inKey returns the circuit key used to identify the incoming htlc. diff --git a/lnrpc/routerrpc/forward_interceptor.go b/lnrpc/routerrpc/forward_interceptor.go index 61260854..8c4a48eb 100644 --- a/lnrpc/routerrpc/forward_interceptor.go +++ b/lnrpc/routerrpc/forward_interceptor.go @@ -163,6 +163,7 @@ func (r *forwardInterceptor) holdAndForwardToClient( OutgoingExpiry: htlc.OutgoingExpiry, IncomingAmountMsat: uint64(htlc.IncomingAmount), IncomingExpiry: htlc.IncomingExpiry, + CustomRecords: htlc.CustomRecords, } return r.stream.Send(interceptionRequest) diff --git a/lnrpc/routerrpc/router.pb.go b/lnrpc/routerrpc/router.pb.go index a7c88235..2d16ea87 100644 --- a/lnrpc/routerrpc/router.pb.go +++ b/lnrpc/routerrpc/router.pb.go @@ -1825,10 +1825,12 @@ type ForwardHtlcInterceptRequest struct { // The outgoing htlc amount. OutgoingAmountMsat uint64 `protobuf:"varint,3,opt,name=outgoing_amount_msat,json=outgoingAmountMsat,proto3" json:"outgoing_amount_msat,omitempty"` // The outgoing htlc expiry. - OutgoingExpiry uint32 `protobuf:"varint,4,opt,name=outgoing_expiry,json=outgoingExpiry,proto3" json:"outgoing_expiry,omitempty"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + OutgoingExpiry uint32 `protobuf:"varint,4,opt,name=outgoing_expiry,json=outgoingExpiry,proto3" json:"outgoing_expiry,omitempty"` + // Any custom records that were present in the payload. + CustomRecords map[uint64][]byte `protobuf:"bytes,8,rep,name=custom_records,json=customRecords,proto3" json:"custom_records,omitempty" protobuf_key:"varint,1,opt,name=key,proto3" protobuf_val:"bytes,2,opt,name=value,proto3"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *ForwardHtlcInterceptRequest) Reset() { *m = ForwardHtlcInterceptRequest{} } @@ -1905,6 +1907,13 @@ func (m *ForwardHtlcInterceptRequest) GetOutgoingExpiry() uint32 { return 0 } +func (m *ForwardHtlcInterceptRequest) GetCustomRecords() map[uint64][]byte { + if m != nil { + return m.CustomRecords + } + return nil +} + //* //ForwardHtlcInterceptResponse enables the caller to resolve a previously hold //forward. The caller can choose either to: @@ -2003,173 +2012,176 @@ func init() { proto.RegisterType((*PaymentStatus)(nil), "routerrpc.PaymentStatus") proto.RegisterType((*CircuitKey)(nil), "routerrpc.CircuitKey") proto.RegisterType((*ForwardHtlcInterceptRequest)(nil), "routerrpc.ForwardHtlcInterceptRequest") + proto.RegisterMapType((map[uint64][]byte)(nil), "routerrpc.ForwardHtlcInterceptRequest.CustomRecordsEntry") proto.RegisterType((*ForwardHtlcInterceptResponse)(nil), "routerrpc.ForwardHtlcInterceptResponse") } func init() { proto.RegisterFile("routerrpc/router.proto", fileDescriptor_7a0613f69d37b0a5) } var fileDescriptor_7a0613f69d37b0a5 = []byte{ - // 2551 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xac, 0x59, 0xcb, 0x72, 0x1b, 0xc7, - 0xd5, 0xf6, 0xe0, 0x46, 0xe0, 0xe0, 0xc2, 0x61, 0x83, 0x16, 0xf1, 0x83, 0x92, 0x0d, 0xc3, 0xb6, - 0x84, 0xd2, 0x6f, 0x53, 0x34, 0x93, 0x4a, 0x5c, 0xf1, 0x25, 0x01, 0x81, 0xa1, 0x38, 0x12, 0x08, - 0xc0, 0x0d, 0x90, 0xb6, 0xe3, 0x45, 0xd7, 0x10, 0x68, 0x10, 0x13, 0x0e, 0x66, 0x90, 0x99, 0x86, - 0x64, 0x2e, 0xb3, 0x4b, 0xe5, 0x45, 0xb2, 0xcb, 0x13, 0x64, 0x91, 0x45, 0xde, 0x23, 0xdb, 0xec, - 0x53, 0x95, 0x55, 0x16, 0xa9, 0xbe, 0xcc, 0x60, 0x86, 0x04, 0xa5, 0xa4, 0x2a, 0x1b, 0x09, 0xf3, - 0x9d, 0xaf, 0x4f, 0x9f, 0xee, 0x73, 0xeb, 0x6e, 0xc2, 0x03, 0xdf, 0x5b, 0x31, 0xea, 0xfb, 0xcb, - 0xc9, 0x33, 0xf9, 0xeb, 0x60, 0xe9, 0x7b, 0xcc, 0x43, 0x85, 0x08, 0xaf, 0x17, 0xfc, 0xe5, 0x44, - 0xa2, 0xcd, 0x7f, 0xe4, 0x00, 0x8d, 0xa8, 0x3b, 0x1d, 0x5a, 0x37, 0x0b, 0xea, 0x32, 0x4c, 0x7f, - 0xbb, 0xa2, 0x01, 0x43, 0x08, 0x32, 0x53, 0x1a, 0xb0, 0x9a, 0xd6, 0xd0, 0x5a, 0x25, 0x2c, 0x7e, - 0x23, 0x1d, 0xd2, 0xd6, 0x82, 0xd5, 0x52, 0x0d, 0xad, 0x95, 0xc6, 0xfc, 0x27, 0xfa, 0x3f, 0xc8, - 0x5b, 0x0b, 0x46, 0x16, 0x81, 0xc5, 0x6a, 0x25, 0x01, 0x6f, 0x59, 0x0b, 0x76, 0x16, 0x58, 0x0c, - 0x7d, 0x00, 0xa5, 0xa5, 0x54, 0x49, 0xe6, 0x56, 0x30, 0xaf, 0xa5, 0x85, 0xa2, 0xa2, 0xc2, 0x4e, - 0xad, 0x60, 0x8e, 0x5a, 0xa0, 0xcf, 0x6c, 0xd7, 0x72, 0xc8, 0xc4, 0x61, 0xaf, 0xc8, 0x94, 0x3a, - 0xcc, 0xaa, 0x65, 0x1a, 0x5a, 0x2b, 0x8b, 0x2b, 0x02, 0xef, 0x38, 0xec, 0x55, 0x97, 0xa3, 0xe8, - 0x09, 0x6c, 0x87, 0xca, 0x7c, 0x69, 0x60, 0x2d, 0xdb, 0xd0, 0x5a, 0x05, 0x5c, 0x59, 0x26, 0xcd, - 0x7e, 0x02, 0xdb, 0xcc, 0x5e, 0x50, 0x6f, 0xc5, 0x48, 0x40, 0x27, 0x9e, 0x3b, 0x0d, 0x6a, 0x39, - 0xa9, 0x51, 0xc1, 0x23, 0x89, 0xa2, 0x26, 0x94, 0x67, 0x94, 0x12, 0xc7, 0x5e, 0xd8, 0x8c, 0x70, - 0xf3, 0xb7, 0x84, 0xf9, 0xc5, 0x19, 0xa5, 0x3d, 0x8e, 0x8d, 0x2c, 0x86, 0x3e, 0x82, 0xca, 0x9a, - 0x23, 0xd6, 0x58, 0x16, 0xa4, 0x52, 0x48, 0x12, 0x0b, 0x3d, 0x00, 0xdd, 0x5b, 0xb1, 0x2b, 0xcf, - 0x76, 0xaf, 0xc8, 0x64, 0x6e, 0xb9, 0xc4, 0x9e, 0xd6, 0xf2, 0x0d, 0xad, 0x95, 0x39, 0xce, 0xd4, - 0xb4, 0x43, 0x0d, 0x57, 0x42, 0x69, 0x67, 0x6e, 0xb9, 0xe6, 0x14, 0x3d, 0x85, 0x9d, 0xdb, 0xfc, - 0xa0, 0x56, 0x6d, 0xa4, 0x5b, 0x19, 0xbc, 0x9d, 0xa4, 0x06, 0xe8, 0x31, 0x6c, 0x3b, 0x56, 0xc0, - 0xc8, 0xdc, 0x5b, 0x92, 0xe5, 0xea, 0xf2, 0x9a, 0xde, 0xd4, 0x2a, 0x62, 0x1f, 0xcb, 0x1c, 0x3e, - 0xf5, 0x96, 0x43, 0x01, 0xa2, 0x47, 0x00, 0x62, 0x0f, 0x85, 0xa9, 0xb5, 0x82, 0x58, 0x71, 0x81, - 0x23, 0xc2, 0x4c, 0xf4, 0x19, 0x14, 0x85, 0xef, 0xc9, 0xdc, 0x76, 0x59, 0x50, 0x83, 0x46, 0xba, - 0x55, 0x3c, 0xd2, 0x0f, 0x1c, 0x97, 0x87, 0x01, 0xe6, 0x92, 0x53, 0xdb, 0x65, 0x18, 0xfc, 0xf0, - 0x67, 0x80, 0xa6, 0x50, 0xe5, 0x3e, 0x27, 0x93, 0x55, 0xc0, 0xbc, 0x05, 0xf1, 0xe9, 0xc4, 0xf3, - 0xa7, 0x41, 0xad, 0x28, 0x86, 0xfe, 0xf4, 0x20, 0x0a, 0xa5, 0x83, 0xbb, 0xb1, 0x73, 0xd0, 0xa5, - 0x01, 0xeb, 0x88, 0x71, 0x58, 0x0e, 0x33, 0x5c, 0xe6, 0xdf, 0xe0, 0x9d, 0xe9, 0x6d, 0x1c, 0x7d, - 0x02, 0xc8, 0x72, 0x1c, 0xef, 0x35, 0x09, 0xa8, 0x33, 0x23, 0xca, 0x97, 0xb5, 0xed, 0x86, 0xd6, - 0xca, 0x63, 0x5d, 0x48, 0x46, 0xd4, 0x99, 0x29, 0xf5, 0xe8, 0x67, 0x50, 0x16, 0x36, 0xcd, 0xa8, - 0xc5, 0x56, 0x3e, 0x0d, 0x6a, 0x7a, 0x23, 0xdd, 0xaa, 0x1c, 0xed, 0xa8, 0x85, 0x9c, 0x48, 0xf8, - 0xd8, 0x66, 0xb8, 0xc4, 0x79, 0xea, 0x3b, 0x40, 0xfb, 0x50, 0x58, 0x58, 0x3f, 0x92, 0xa5, 0xe5, - 0xb3, 0xa0, 0xb6, 0xd3, 0xd0, 0x5a, 0x65, 0x9c, 0x5f, 0x58, 0x3f, 0x0e, 0xf9, 0x37, 0x3a, 0x80, - 0xaa, 0xeb, 0x11, 0xdb, 0x9d, 0x39, 0xf6, 0xd5, 0x9c, 0x91, 0xd5, 0x72, 0x6a, 0x31, 0x1a, 0xd4, - 0x90, 0xb0, 0x61, 0xc7, 0xf5, 0x4c, 0x25, 0x39, 0x97, 0x82, 0x7a, 0x17, 0x1e, 0x6c, 0x5e, 0x1f, - 0x4f, 0x0f, 0xee, 0x20, 0x9e, 0x31, 0x19, 0xcc, 0x7f, 0xa2, 0x5d, 0xc8, 0xbe, 0xb2, 0x9c, 0x15, - 0x15, 0x29, 0x53, 0xc2, 0xf2, 0xe3, 0x17, 0xa9, 0xcf, 0xb5, 0xe6, 0x1c, 0xaa, 0x63, 0xdf, 0x9a, - 0x5c, 0xdf, 0xca, 0xba, 0xdb, 0x49, 0xa3, 0xdd, 0x4d, 0x9a, 0x7b, 0xec, 0x4d, 0xdd, 0x63, 0x6f, - 0xf3, 0x6b, 0xd8, 0x16, 0x1e, 0x3e, 0xa1, 0xf4, 0x4d, 0xb9, 0xbd, 0x07, 0x3c, 0x73, 0x45, 0x26, - 0xc8, 0xfc, 0xce, 0x59, 0x0b, 0x9e, 0x04, 0xcd, 0x29, 0xe8, 0xeb, 0xf1, 0xc1, 0xd2, 0x73, 0x03, - 0xca, 0x13, 0x97, 0x07, 0x00, 0x8f, 0x60, 0x9e, 0x20, 0x22, 0x35, 0x34, 0x31, 0xaa, 0xa2, 0xf0, - 0x13, 0x4a, 0x45, 0x72, 0x3c, 0x96, 0xf9, 0x48, 0x1c, 0x6f, 0x72, 0xcd, 0x33, 0xdc, 0xba, 0x51, - 0xea, 0xcb, 0x1c, 0xee, 0x79, 0x93, 0xeb, 0x2e, 0x07, 0x9b, 0x3f, 0xc8, 0x22, 0x34, 0xf6, 0xc4, - 0x5c, 0xff, 0xc5, 0x76, 0x34, 0x21, 0x2b, 0x62, 0x51, 0xa8, 0x2d, 0x1e, 0x95, 0xe2, 0x41, 0x8d, - 0xa5, 0xa8, 0xf9, 0x03, 0x54, 0x13, 0xca, 0xd5, 0x2a, 0xea, 0x90, 0x5f, 0xfa, 0xd4, 0x5e, 0x58, - 0x57, 0x54, 0x69, 0x8e, 0xbe, 0x51, 0x0b, 0xb6, 0x66, 0x96, 0xed, 0xac, 0xfc, 0x50, 0x71, 0x25, - 0x0c, 0x32, 0x89, 0xe2, 0x50, 0xdc, 0x7c, 0x08, 0x75, 0x4c, 0x03, 0xca, 0xce, 0xec, 0x20, 0xb0, - 0x3d, 0xb7, 0xe3, 0xb9, 0xcc, 0xf7, 0x1c, 0xb5, 0x82, 0xe6, 0x23, 0xd8, 0xdf, 0x28, 0x95, 0x26, - 0xf0, 0xc1, 0xdf, 0xac, 0xa8, 0x7f, 0xb3, 0x79, 0xf0, 0x37, 0xb0, 0xbf, 0x51, 0xaa, 0xec, 0xff, - 0x04, 0xb2, 0x4b, 0xcb, 0xf6, 0xb9, 0xef, 0x79, 0x52, 0x3e, 0x88, 0x25, 0xe5, 0xd0, 0xb2, 0xfd, - 0x53, 0x3b, 0x60, 0x9e, 0x7f, 0x83, 0x25, 0xe9, 0x45, 0x26, 0xaf, 0xe9, 0xa9, 0xe6, 0x1f, 0x34, - 0x28, 0xc6, 0x84, 0x3c, 0x35, 0x5c, 0x6f, 0x4a, 0xc9, 0xcc, 0xf7, 0x16, 0xe1, 0x26, 0x70, 0xe0, - 0xc4, 0xf7, 0x16, 0x3c, 0x26, 0x84, 0x90, 0x79, 0x2a, 0x80, 0x73, 0xfc, 0x73, 0xec, 0xa1, 0x4f, - 0x61, 0x6b, 0x2e, 0x15, 0x88, 0xb2, 0x59, 0x3c, 0xaa, 0xde, 0x9a, 0xbb, 0x6b, 0x31, 0x0b, 0x87, - 0x9c, 0x17, 0x99, 0x7c, 0x5a, 0xcf, 0xbc, 0xc8, 0xe4, 0x33, 0x7a, 0xf6, 0x45, 0x26, 0x9f, 0xd5, - 0x73, 0x2f, 0x32, 0xf9, 0x9c, 0xbe, 0xd5, 0xfc, 0xbb, 0x06, 0xf9, 0x90, 0xcd, 0x2d, 0xe1, 0x5b, - 0x4a, 0x78, 0x5c, 0xa8, 0x60, 0xca, 0x73, 0x60, 0x6c, 0x2f, 0x28, 0x6a, 0x40, 0x49, 0x08, 0x93, - 0x21, 0x0a, 0x1c, 0x6b, 0x8b, 0x30, 0x15, 0xf5, 0x3c, 0x64, 0x88, 0x78, 0xcc, 0xa8, 0x7a, 0x2e, - 0x29, 0x61, 0x4b, 0x0a, 0x56, 0x93, 0x09, 0x0d, 0x02, 0x39, 0x4b, 0x56, 0x52, 0x14, 0x26, 0x26, - 0x7a, 0x0c, 0xdb, 0x21, 0x25, 0x9c, 0x2b, 0x27, 0xe3, 0x55, 0xc1, 0x6a, 0xba, 0x16, 0xe8, 0x71, - 0xde, 0x62, 0xdd, 0x41, 0x2a, 0x6b, 0x22, 0x9f, 0x54, 0x2e, 0xbe, 0xf9, 0x1b, 0xd8, 0x13, 0xae, - 0x1c, 0xfa, 0xde, 0xa5, 0x75, 0x69, 0x3b, 0x36, 0xbb, 0x09, 0x83, 0x9c, 0x2f, 0xdc, 0xf7, 0x16, - 0x84, 0xef, 0x6d, 0xe8, 0x02, 0x0e, 0xf4, 0xbd, 0x29, 0xe5, 0x2e, 0x60, 0x9e, 0x14, 0x29, 0x17, - 0x30, 0x4f, 0x08, 0xe2, 0x9d, 0x37, 0x9d, 0xe8, 0xbc, 0xcd, 0x6b, 0xa8, 0xdd, 0x9d, 0x4b, 0xc5, - 0x4c, 0x03, 0x8a, 0xcb, 0x35, 0x2c, 0xa6, 0xd3, 0x70, 0x1c, 0x8a, 0xfb, 0x36, 0xf5, 0x76, 0xdf, - 0x36, 0xff, 0xa8, 0xc1, 0xce, 0xf1, 0xca, 0x76, 0xa6, 0x89, 0xc4, 0x8d, 0x5b, 0xa7, 0x25, 0xcf, - 0x05, 0x9b, 0x9a, 0x7e, 0x6a, 0x63, 0xd3, 0xff, 0x64, 0x43, 0x63, 0x4d, 0x8b, 0xc6, 0x9a, 0xda, - 0xd0, 0x56, 0xdf, 0x87, 0xe2, 0xba, 0x4b, 0x06, 0xb5, 0x4c, 0x23, 0xdd, 0x2a, 0x61, 0x98, 0x87, - 0x2d, 0x32, 0x68, 0x7e, 0x0e, 0x28, 0x6e, 0xa8, 0xda, 0x90, 0xa8, 0x7e, 0x68, 0xf7, 0xd7, 0x8f, - 0x87, 0x50, 0x1f, 0xad, 0x2e, 0x83, 0x89, 0x6f, 0x5f, 0xd2, 0x53, 0xe6, 0x4c, 0x8c, 0x57, 0xd4, - 0x65, 0x41, 0x98, 0xa5, 0xff, 0xcc, 0x40, 0x21, 0x42, 0x79, 0x79, 0xb6, 0xdd, 0x89, 0xb7, 0x08, - 0x8d, 0x76, 0xa9, 0xc3, 0xed, 0x96, 0x4d, 0x61, 0x27, 0x14, 0x75, 0xa4, 0xc4, 0x9c, 0x72, 0x7e, - 0x62, 0x91, 0x8a, 0x9f, 0x92, 0xfc, 0xf8, 0x1a, 0x25, 0xbf, 0x05, 0x7a, 0xa4, 0x7f, 0xce, 0x9c, - 0x49, 0xb4, 0x29, 0xb8, 0x12, 0xe2, 0xdc, 0x18, 0xc9, 0x8c, 0x34, 0x87, 0xcc, 0x8c, 0x64, 0x86, - 0xb8, 0x62, 0x7e, 0x00, 0x25, 0x9e, 0x0f, 0x01, 0xb3, 0x16, 0x4b, 0xe2, 0x06, 0x22, 0x2f, 0x32, - 0xb8, 0x18, 0x61, 0xfd, 0x00, 0x7d, 0x05, 0x40, 0xf9, 0xfa, 0x08, 0xbb, 0x59, 0x52, 0x91, 0x12, - 0x95, 0xa3, 0xf7, 0x62, 0x81, 0x11, 0x6d, 0xc0, 0x81, 0xf8, 0x77, 0x7c, 0xb3, 0xa4, 0xb8, 0x40, - 0xc3, 0x9f, 0xe8, 0x6b, 0x28, 0xcf, 0x3c, 0xff, 0xb5, 0xe5, 0x4f, 0x89, 0x00, 0x55, 0xd9, 0xd8, - 0x8b, 0x69, 0x38, 0x91, 0x72, 0x31, 0xfc, 0xf4, 0x1d, 0x5c, 0x9a, 0xc5, 0xbe, 0xd1, 0x4b, 0x40, - 0xe1, 0x78, 0x91, 0xe5, 0x52, 0x49, 0x5e, 0x28, 0xd9, 0xbf, 0xab, 0x84, 0x17, 0xe9, 0x50, 0x91, - 0x3e, 0xbb, 0x85, 0xa1, 0x2f, 0xa0, 0x14, 0x50, 0xc6, 0x1c, 0xaa, 0xd4, 0x14, 0x84, 0x9a, 0x07, - 0x89, 0x33, 0x0d, 0x17, 0x87, 0x1a, 0x8a, 0xc1, 0xfa, 0x13, 0x1d, 0xc3, 0xb6, 0x63, 0xbb, 0xd7, - 0x71, 0x33, 0x40, 0x8c, 0xaf, 0xc5, 0xc6, 0xf7, 0x6c, 0xf7, 0x3a, 0x6e, 0x43, 0xd9, 0x89, 0x03, - 0xcd, 0x2f, 0xa1, 0x10, 0xed, 0x12, 0x2a, 0xc2, 0xd6, 0x79, 0xff, 0x65, 0x7f, 0xf0, 0x6d, 0x5f, - 0x7f, 0x07, 0xe5, 0x21, 0x33, 0x32, 0xfa, 0x5d, 0x5d, 0xe3, 0x30, 0x36, 0x3a, 0x86, 0x79, 0x61, - 0xe8, 0x29, 0xfe, 0x71, 0x32, 0xc0, 0xdf, 0xb6, 0x71, 0x57, 0x4f, 0x1f, 0x6f, 0x41, 0x56, 0xcc, - 0xdb, 0xfc, 0xb3, 0x06, 0x79, 0xe1, 0x41, 0x77, 0xe6, 0xa1, 0xff, 0x87, 0x28, 0xb8, 0x44, 0x71, - 0xe3, 0x0d, 0x57, 0x44, 0x5d, 0x19, 0x47, 0x01, 0x33, 0x56, 0x38, 0x27, 0x47, 0xa1, 0x11, 0x91, - 0x53, 0x92, 0x1c, 0x0a, 0x22, 0xf2, 0xd3, 0x98, 0xe6, 0x44, 0xc9, 0xc9, 0xe0, 0xed, 0x50, 0x10, - 0x56, 0xd8, 0xf8, 0xd9, 0x36, 0x51, 0x89, 0x63, 0x67, 0x5b, 0xc5, 0x6d, 0xfe, 0x1c, 0x4a, 0x71, - 0x9f, 0xa3, 0x27, 0x90, 0xb1, 0xdd, 0x99, 0xa7, 0x12, 0xb1, 0x7a, 0x2b, 0xb8, 0xf8, 0x22, 0xb1, - 0x20, 0x34, 0x11, 0xe8, 0xb7, 0xfd, 0xdc, 0x2c, 0x43, 0x31, 0xe6, 0xb4, 0xe6, 0xdf, 0x34, 0x28, - 0x27, 0x9c, 0xf0, 0x1f, 0x6b, 0x47, 0x5f, 0x41, 0xe9, 0xb5, 0xed, 0x53, 0x12, 0x6f, 0xff, 0x95, - 0xa3, 0x7a, 0xb2, 0xfd, 0x87, 0xff, 0x77, 0xbc, 0x29, 0xc5, 0x45, 0xce, 0x57, 0x00, 0xfa, 0x25, - 0x54, 0xd4, 0x48, 0x32, 0xa5, 0xcc, 0xb2, 0x1d, 0xb1, 0x55, 0x95, 0x44, 0x78, 0x28, 0x6e, 0x57, - 0xc8, 0x71, 0x79, 0x16, 0xff, 0x44, 0x1f, 0xaf, 0x15, 0x04, 0xcc, 0xb7, 0xdd, 0x2b, 0xb1, 0x7f, - 0x85, 0x88, 0x36, 0x12, 0x20, 0x6f, 0xe4, 0x65, 0x75, 0x78, 0x1c, 0x31, 0x8b, 0xad, 0x02, 0xf4, - 0x29, 0x64, 0x03, 0x66, 0xa9, 0x4a, 0x56, 0x49, 0xe4, 0x56, 0x8c, 0x48, 0xb1, 0x64, 0x25, 0x4e, - 0x3f, 0xa9, 0x3b, 0xa7, 0x9f, 0x2c, 0xaf, 0x18, 0xb2, 0x8a, 0x16, 0x8f, 0x90, 0x5a, 0xfc, 0xe9, - 0xb8, 0xd7, 0x69, 0x33, 0x46, 0x17, 0x4b, 0x86, 0x25, 0x41, 0x75, 0xb7, 0xaf, 0x01, 0x3a, 0xb6, - 0x3f, 0x59, 0xd9, 0xec, 0x25, 0xbd, 0xe1, 0x3d, 0x2b, 0x2c, 0xd7, 0xb2, 0xec, 0xe5, 0x26, 0xb2, - 0x44, 0xef, 0xc1, 0x56, 0x58, 0x88, 0x64, 0x7d, 0xcb, 0xcd, 0x45, 0x01, 0x6a, 0xfe, 0x2b, 0x05, - 0xfb, 0xca, 0xa5, 0xd2, 0x1b, 0x8c, 0xfa, 0x13, 0xba, 0x8c, 0x8e, 0xc5, 0xcf, 0x61, 0x77, 0x5d, - 0x54, 0xe5, 0x44, 0x24, 0x3c, 0x6a, 0x17, 0x8f, 0xde, 0x8d, 0xad, 0x74, 0x6d, 0x06, 0x46, 0x51, - 0xb1, 0x5d, 0x9b, 0x76, 0x18, 0x53, 0x64, 0x2d, 0xbc, 0x95, 0xab, 0x42, 0x54, 0x56, 0x3c, 0xb4, - 0x0e, 0x67, 0x2e, 0x12, 0x11, 0xfd, 0x04, 0xa2, 0x20, 0x27, 0xf4, 0xc7, 0xa5, 0xed, 0xdf, 0x88, - 0xea, 0x57, 0x5e, 0x97, 0x5b, 0x43, 0xa0, 0x77, 0xce, 0xaa, 0xa9, 0xbb, 0x67, 0xd5, 0x2f, 0xa0, - 0x1e, 0x65, 0x87, 0xba, 0xc6, 0xd2, 0x69, 0xd4, 0xda, 0xb6, 0x84, 0x0d, 0x7b, 0x21, 0x03, 0x87, - 0x04, 0xd5, 0xdf, 0x0e, 0x61, 0x37, 0x96, 0x5a, 0x6b, 0xd3, 0x65, 0x26, 0xa2, 0x75, 0x76, 0xc5, - 0x4d, 0x8f, 0x46, 0x28, 0xd3, 0x33, 0xd2, 0xf4, 0x10, 0x96, 0xa6, 0x37, 0xff, 0xa2, 0xc1, 0xc3, - 0xcd, 0xdb, 0xaf, 0x9a, 0xe4, 0xff, 0x6c, 0xff, 0xbf, 0x80, 0x9c, 0x35, 0x61, 0xb6, 0xe7, 0xaa, - 0xb4, 0xfa, 0x30, 0x36, 0x14, 0xd3, 0xc0, 0x73, 0x5e, 0xd1, 0x53, 0xcf, 0x99, 0x2a, 0x63, 0xda, - 0x82, 0x8a, 0xd5, 0x90, 0x44, 0xc4, 0xa6, 0x93, 0x11, 0xfb, 0xf4, 0x77, 0x19, 0x28, 0x27, 0xd2, - 0x2a, 0x59, 0x57, 0xcb, 0x50, 0xe8, 0x0f, 0x48, 0xd7, 0x18, 0xb7, 0xcd, 0x9e, 0xae, 0x21, 0x1d, - 0x4a, 0x83, 0xbe, 0x39, 0xe8, 0x93, 0xae, 0xd1, 0x19, 0x74, 0x79, 0x85, 0x7d, 0x17, 0x76, 0x7a, - 0x66, 0xff, 0x25, 0xe9, 0x0f, 0xc6, 0xc4, 0xe8, 0x99, 0xcf, 0xcd, 0xe3, 0x9e, 0xa1, 0xa7, 0xd1, - 0x2e, 0xe8, 0x83, 0x3e, 0xe9, 0x9c, 0xb6, 0xcd, 0x3e, 0x19, 0x9b, 0x67, 0xc6, 0xe0, 0x7c, 0xac, - 0x67, 0x38, 0xca, 0x53, 0x81, 0x18, 0xdf, 0x75, 0x0c, 0xa3, 0x3b, 0x22, 0x67, 0xed, 0xef, 0xf4, - 0x2c, 0xaa, 0xc1, 0xae, 0xd9, 0x1f, 0x9d, 0x9f, 0x9c, 0x98, 0x1d, 0xd3, 0xe8, 0x8f, 0xc9, 0x71, - 0xbb, 0xd7, 0xee, 0x77, 0x0c, 0x3d, 0x87, 0x1e, 0x00, 0x32, 0xfb, 0x9d, 0xc1, 0xd9, 0xb0, 0x67, - 0x8c, 0x0d, 0x12, 0x56, 0xf2, 0x2d, 0x54, 0x85, 0x6d, 0xa1, 0xa7, 0xdd, 0xed, 0x92, 0x93, 0xb6, - 0xd9, 0x33, 0xba, 0x7a, 0x9e, 0x5b, 0xa2, 0x18, 0x23, 0xd2, 0x35, 0x47, 0xed, 0x63, 0x0e, 0x17, - 0xf8, 0x9c, 0x66, 0xff, 0x62, 0x60, 0x76, 0x0c, 0xd2, 0xe1, 0x6a, 0x39, 0x0a, 0x9c, 0x1c, 0xa2, - 0xe7, 0xfd, 0xae, 0x81, 0x87, 0x6d, 0xb3, 0xab, 0x17, 0xd1, 0x3e, 0xec, 0x85, 0xb0, 0xf1, 0xdd, - 0xd0, 0xc4, 0xdf, 0x93, 0xf1, 0x60, 0x40, 0x46, 0x83, 0x41, 0x5f, 0x2f, 0xc5, 0x35, 0xf1, 0xd5, - 0x0e, 0x86, 0x46, 0x5f, 0x2f, 0xa3, 0x3d, 0xa8, 0x9e, 0x0d, 0x87, 0x24, 0x94, 0x84, 0x8b, 0xad, - 0x70, 0x7a, 0xbb, 0xdb, 0xc5, 0xc6, 0x68, 0x44, 0xce, 0xcc, 0xd1, 0x59, 0x7b, 0xdc, 0x39, 0xd5, - 0xb7, 0xf9, 0x92, 0x46, 0xc6, 0x98, 0x8c, 0x07, 0xe3, 0x76, 0x6f, 0x8d, 0xeb, 0xdc, 0xa0, 0x35, - 0xce, 0x27, 0xed, 0x0d, 0xbe, 0xd5, 0x77, 0xf8, 0x86, 0x73, 0x78, 0x70, 0xa1, 0x4c, 0x44, 0x7c, - 0xed, 0xca, 0x3d, 0xe1, 0x9c, 0x7a, 0x95, 0x83, 0x66, 0xff, 0xa2, 0xdd, 0x33, 0xbb, 0xe4, 0xa5, - 0xf1, 0xbd, 0xe8, 0x84, 0xbb, 0x1c, 0x94, 0x96, 0x91, 0x21, 0x1e, 0x3c, 0xe7, 0x86, 0xe8, 0xef, - 0x22, 0x04, 0x95, 0x8e, 0x89, 0x3b, 0xe7, 0xbd, 0x36, 0x26, 0x78, 0x70, 0x3e, 0x36, 0xf4, 0x07, - 0x4f, 0xff, 0xa4, 0x41, 0x29, 0x5e, 0xe9, 0xb8, 0xd7, 0xcd, 0x3e, 0x39, 0xe9, 0x99, 0xcf, 0x4f, - 0xc7, 0x32, 0x08, 0x46, 0xe7, 0x1d, 0xee, 0x32, 0x83, 0x77, 0x58, 0x04, 0x15, 0xb9, 0xe9, 0xd1, - 0x62, 0x53, 0x7c, 0x2e, 0x85, 0xf5, 0x07, 0x4a, 0x6f, 0x9a, 0x1b, 0xaf, 0x40, 0x03, 0xe3, 0x01, - 0xd6, 0x33, 0xe8, 0x23, 0x68, 0x28, 0x84, 0xfb, 0x15, 0x63, 0xa3, 0x33, 0x26, 0xc3, 0xf6, 0xf7, - 0x67, 0xdc, 0xed, 0x32, 0xc8, 0x46, 0x7a, 0x16, 0xbd, 0x0f, 0xfb, 0x11, 0x6b, 0x53, 0x5c, 0x3c, - 0xfd, 0x12, 0x6a, 0xf7, 0x05, 0x3d, 0x02, 0xc8, 0x8d, 0x8c, 0xf1, 0xb8, 0x67, 0xc8, 0x53, 0xc1, - 0x89, 0x0c, 0x5c, 0x80, 0x1c, 0x36, 0x46, 0xe7, 0x67, 0x86, 0x9e, 0x3a, 0xfa, 0x6b, 0x1e, 0x72, - 0xe2, 0x98, 0xea, 0xa3, 0x5f, 0x41, 0x39, 0xf6, 0x0c, 0x73, 0x71, 0x84, 0x1e, 0xbd, 0xf1, 0x81, - 0xa6, 0x1e, 0x5e, 0x66, 0x15, 0x7c, 0xa8, 0xa1, 0x63, 0xa8, 0xc4, 0xdf, 0x23, 0x2e, 0x8e, 0x50, - 0xfc, 0x74, 0xb7, 0xe1, 0xa9, 0x62, 0x83, 0x8e, 0x97, 0xa0, 0x1b, 0x01, 0xb3, 0x17, 0xbc, 0xc9, - 0xa8, 0x17, 0x03, 0x54, 0x8f, 0x27, 0x78, 0xf2, 0x19, 0xa2, 0xbe, 0xbf, 0x51, 0xa6, 0x4a, 0xce, - 0x37, 0xbc, 0xa1, 0x47, 0x77, 0xf6, 0x3b, 0x0b, 0x4a, 0x3e, 0x14, 0xd4, 0xdf, 0xbb, 0x4f, 0xac, - 0xee, 0xd9, 0xe9, 0xdf, 0xa7, 0xf8, 0x1a, 0xcb, 0x31, 0xd9, 0x86, 0x5d, 0xba, 0xa5, 0x74, 0x43, - 0xdb, 0x43, 0x53, 0xa8, 0x6e, 0xb8, 0xcf, 0xa3, 0x8f, 0x93, 0x75, 0xec, 0x9e, 0xd7, 0x80, 0xfa, - 0xe3, 0xb7, 0xd1, 0xd4, 0xe2, 0xa7, 0x50, 0xdd, 0x70, 0xf1, 0x4f, 0xcc, 0x72, 0xff, 0xb3, 0x41, - 0x62, 0x96, 0x37, 0xbd, 0x1f, 0xfc, 0x00, 0xfa, 0xed, 0x7b, 0x22, 0x6a, 0xde, 0x1e, 0x7b, 0xf7, - 0xc2, 0x5a, 0xff, 0xf0, 0x8d, 0x1c, 0xa5, 0xdc, 0x04, 0x58, 0xdf, 0xb6, 0xd0, 0xc3, 0xd8, 0x90, - 0x3b, 0xb7, 0xc5, 0xfa, 0xa3, 0x7b, 0xa4, 0x4a, 0xd5, 0x18, 0xaa, 0x1b, 0xae, 0x5f, 0x89, 0xdd, - 0xb8, 0xff, 0x7a, 0x56, 0xdf, 0xdd, 0x74, 0x4b, 0x39, 0xd4, 0xd0, 0x99, 0x0c, 0xb0, 0xf0, 0x6d, - 0xf1, 0x2d, 0x19, 0x53, 0xdb, 0x7c, 0x9a, 0x5a, 0x05, 0x22, 0xb4, 0x0e, 0x35, 0x34, 0x80, 0x52, - 0x3c, 0x4b, 0xde, 0x9a, 0x3e, 0x6f, 0x55, 0x38, 0x83, 0xed, 0x44, 0x33, 0xf6, 0x7c, 0xf4, 0xe4, - 0xee, 0x4d, 0x67, 0x63, 0xbf, 0x4e, 0x44, 0xc0, 0x1b, 0xce, 0x55, 0x2d, 0xed, 0x50, 0x3b, 0xfe, - 0xec, 0xd7, 0xcf, 0xae, 0x6c, 0x36, 0x5f, 0x5d, 0x1e, 0x4c, 0xbc, 0xc5, 0x33, 0xf1, 0x74, 0xe8, - 0xda, 0xee, 0x95, 0x4b, 0xd9, 0x6b, 0xcf, 0xbf, 0x7e, 0xe6, 0xb8, 0xd3, 0x67, 0x22, 0x0d, 0x9e, - 0x45, 0x2a, 0x2f, 0x73, 0xe2, 0x2f, 0x07, 0x3f, 0xf9, 0x77, 0x00, 0x00, 0x00, 0xff, 0xff, 0x35, - 0x38, 0x14, 0x00, 0x69, 0x18, 0x00, 0x00, + // 2580 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xac, 0x59, 0x4b, 0x77, 0xdb, 0xc6, + 0xf5, 0x0f, 0x48, 0x88, 0xa2, 0x2e, 0x1f, 0x82, 0x86, 0x8a, 0xc5, 0x3f, 0x65, 0x27, 0x0c, 0x93, + 0xd8, 0x3c, 0xfe, 0x27, 0xb2, 0xa2, 0xf6, 0xb4, 0x69, 0xf3, 0x68, 0x28, 0x12, 0xb2, 0x60, 0x53, + 0x24, 0x33, 0xa4, 0x9c, 0xa4, 0x59, 0x4c, 0x21, 0x72, 0x28, 0xa2, 0x02, 0x01, 0x16, 0x18, 0xda, + 0xd1, 0xb2, 0xbb, 0x9e, 0x7e, 0x8a, 0xee, 0xba, 0xeb, 0x27, 0xe8, 0xa2, 0x8b, 0x7e, 0x8f, 0x6e, + 0xbb, 0xef, 0x39, 0x5d, 0xf7, 0xcc, 0x03, 0x20, 0x20, 0x51, 0x76, 0x7b, 0xda, 0x8d, 0x4d, 0xfc, + 0xee, 0x6f, 0xee, 0xdc, 0x99, 0xfb, 0x9a, 0x19, 0xc1, 0xbd, 0xc0, 0x5f, 0x32, 0x1a, 0x04, 0x8b, + 0xf1, 0x13, 0xf9, 0xeb, 0x60, 0x11, 0xf8, 0xcc, 0x47, 0x5b, 0x31, 0x5e, 0xdb, 0x0a, 0x16, 0x63, + 0x89, 0x36, 0xfe, 0x91, 0x03, 0x34, 0xa4, 0xde, 0x64, 0x60, 0x5f, 0xcf, 0xa9, 0xc7, 0x30, 0xfd, + 0xcd, 0x92, 0x86, 0x0c, 0x21, 0xd0, 0x27, 0x34, 0x64, 0x55, 0xad, 0xae, 0x35, 0x8b, 0x58, 0xfc, + 0x46, 0x06, 0x64, 0xed, 0x39, 0xab, 0x66, 0xea, 0x5a, 0x33, 0x8b, 0xf9, 0x4f, 0xf4, 0x7f, 0x90, + 0xb7, 0xe7, 0x8c, 0xcc, 0x43, 0x9b, 0x55, 0x8b, 0x02, 0xde, 0xb4, 0xe7, 0xec, 0x2c, 0xb4, 0x19, + 0x7a, 0x0f, 0x8a, 0x0b, 0xa9, 0x92, 0xcc, 0xec, 0x70, 0x56, 0xcd, 0x0a, 0x45, 0x05, 0x85, 0x9d, + 0xda, 0xe1, 0x0c, 0x35, 0xc1, 0x98, 0x3a, 0x9e, 0xed, 0x92, 0xb1, 0xcb, 0x5e, 0x92, 0x09, 0x75, + 0x99, 0x5d, 0xd5, 0xeb, 0x5a, 0x73, 0x03, 0x97, 0x05, 0xde, 0x76, 0xd9, 0xcb, 0x0e, 0x47, 0xd1, + 0x23, 0xd8, 0x8e, 0x94, 0x05, 0xd2, 0xc0, 0xea, 0x46, 0x5d, 0x6b, 0x6e, 0xe1, 0xf2, 0x22, 0x6d, + 0xf6, 0x23, 0xd8, 0x66, 0xce, 0x9c, 0xfa, 0x4b, 0x46, 0x42, 0x3a, 0xf6, 0xbd, 0x49, 0x58, 0xcd, + 0x49, 0x8d, 0x0a, 0x1e, 0x4a, 0x14, 0x35, 0xa0, 0x34, 0xa5, 0x94, 0xb8, 0xce, 0xdc, 0x61, 0x84, + 0x9b, 0xbf, 0x29, 0xcc, 0x2f, 0x4c, 0x29, 0xed, 0x72, 0x6c, 0x68, 0x33, 0xf4, 0x01, 0x94, 0x57, + 0x1c, 0xb1, 0xc6, 0x92, 0x20, 0x15, 0x23, 0x92, 0x58, 0xe8, 0x01, 0x18, 0xfe, 0x92, 0x5d, 0xfa, + 0x8e, 0x77, 0x49, 0xc6, 0x33, 0xdb, 0x23, 0xce, 0xa4, 0x9a, 0xaf, 0x6b, 0x4d, 0xfd, 0x58, 0xaf, + 0x6a, 0x87, 0x1a, 0x2e, 0x47, 0xd2, 0xf6, 0xcc, 0xf6, 0xac, 0x09, 0x7a, 0x0c, 0x3b, 0x37, 0xf9, + 0x61, 0xb5, 0x52, 0xcf, 0x36, 0x75, 0xbc, 0x9d, 0xa6, 0x86, 0xe8, 0x21, 0x6c, 0xbb, 0x76, 0xc8, + 0xc8, 0xcc, 0x5f, 0x90, 0xc5, 0xf2, 0xe2, 0x8a, 0x5e, 0x57, 0xcb, 0x62, 0x1f, 0x4b, 0x1c, 0x3e, + 0xf5, 0x17, 0x03, 0x01, 0xa2, 0x07, 0x00, 0x62, 0x0f, 0x85, 0xa9, 0xd5, 0x2d, 0xb1, 0xe2, 0x2d, + 0x8e, 0x08, 0x33, 0xd1, 0x27, 0x50, 0x10, 0xbe, 0x27, 0x33, 0xc7, 0x63, 0x61, 0x15, 0xea, 0xd9, + 0x66, 0xe1, 0xc8, 0x38, 0x70, 0x3d, 0x1e, 0x06, 0x98, 0x4b, 0x4e, 0x1d, 0x8f, 0x61, 0x08, 0xa2, + 0x9f, 0x21, 0x9a, 0x40, 0x85, 0xfb, 0x9c, 0x8c, 0x97, 0x21, 0xf3, 0xe7, 0x24, 0xa0, 0x63, 0x3f, + 0x98, 0x84, 0xd5, 0x82, 0x18, 0xfa, 0xe3, 0x83, 0x38, 0x94, 0x0e, 0x6e, 0xc7, 0xce, 0x41, 0x87, + 0x86, 0xac, 0x2d, 0xc6, 0x61, 0x39, 0xcc, 0xf4, 0x58, 0x70, 0x8d, 0x77, 0x26, 0x37, 0x71, 0xf4, + 0x11, 0x20, 0xdb, 0x75, 0xfd, 0x57, 0x24, 0xa4, 0xee, 0x94, 0x28, 0x5f, 0x56, 0xb7, 0xeb, 0x5a, + 0x33, 0x8f, 0x0d, 0x21, 0x19, 0x52, 0x77, 0xaa, 0xd4, 0xa3, 0x9f, 0x40, 0x49, 0xd8, 0x34, 0xa5, + 0x36, 0x5b, 0x06, 0x34, 0xac, 0x1a, 0xf5, 0x6c, 0xb3, 0x7c, 0xb4, 0xa3, 0x16, 0x72, 0x22, 0xe1, + 0x63, 0x87, 0xe1, 0x22, 0xe7, 0xa9, 0xef, 0x10, 0xed, 0xc3, 0xd6, 0xdc, 0xfe, 0x81, 0x2c, 0xec, + 0x80, 0x85, 0xd5, 0x9d, 0xba, 0xd6, 0x2c, 0xe1, 0xfc, 0xdc, 0xfe, 0x61, 0xc0, 0xbf, 0xd1, 0x01, + 0x54, 0x3c, 0x9f, 0x38, 0xde, 0xd4, 0x75, 0x2e, 0x67, 0x8c, 0x2c, 0x17, 0x13, 0x9b, 0xd1, 0xb0, + 0x8a, 0x84, 0x0d, 0x3b, 0x9e, 0x6f, 0x29, 0xc9, 0xb9, 0x14, 0xd4, 0x3a, 0x70, 0x6f, 0xfd, 0xfa, + 0x78, 0x7a, 0x70, 0x07, 0xf1, 0x8c, 0xd1, 0x31, 0xff, 0x89, 0x76, 0x61, 0xe3, 0xa5, 0xed, 0x2e, + 0xa9, 0x48, 0x99, 0x22, 0x96, 0x1f, 0x3f, 0xcf, 0x7c, 0xaa, 0x35, 0x66, 0x50, 0x19, 0x05, 0xf6, + 0xf8, 0xea, 0x46, 0xd6, 0xdd, 0x4c, 0x1a, 0xed, 0x76, 0xd2, 0xdc, 0x61, 0x6f, 0xe6, 0x0e, 0x7b, + 0x1b, 0x5f, 0xc2, 0xb6, 0xf0, 0xf0, 0x09, 0xa5, 0xaf, 0xcb, 0xed, 0x3d, 0xe0, 0x99, 0x2b, 0x32, + 0x41, 0xe6, 0x77, 0xce, 0x9e, 0xf3, 0x24, 0x68, 0x4c, 0xc0, 0x58, 0x8d, 0x0f, 0x17, 0xbe, 0x17, + 0x52, 0x9e, 0xb8, 0x3c, 0x00, 0x78, 0x04, 0xf3, 0x04, 0x11, 0xa9, 0xa1, 0x89, 0x51, 0x65, 0x85, + 0x9f, 0x50, 0x2a, 0x92, 0xe3, 0xa1, 0xcc, 0x47, 0xe2, 0xfa, 0xe3, 0x2b, 0x9e, 0xe1, 0xf6, 0xb5, + 0x52, 0x5f, 0xe2, 0x70, 0xd7, 0x1f, 0x5f, 0x75, 0x38, 0xd8, 0xf8, 0x5e, 0x16, 0xa1, 0x91, 0x2f, + 0xe6, 0xfa, 0x0f, 0xb6, 0xa3, 0x01, 0x1b, 0x22, 0x16, 0x85, 0xda, 0xc2, 0x51, 0x31, 0x19, 0xd4, + 0x58, 0x8a, 0x1a, 0xdf, 0x43, 0x25, 0xa5, 0x5c, 0xad, 0xa2, 0x06, 0xf9, 0x45, 0x40, 0x9d, 0xb9, + 0x7d, 0x49, 0x95, 0xe6, 0xf8, 0x1b, 0x35, 0x61, 0x73, 0x6a, 0x3b, 0xee, 0x32, 0x88, 0x14, 0x97, + 0xa3, 0x20, 0x93, 0x28, 0x8e, 0xc4, 0x8d, 0xfb, 0x50, 0xc3, 0x34, 0xa4, 0xec, 0xcc, 0x09, 0x43, + 0xc7, 0xf7, 0xda, 0xbe, 0xc7, 0x02, 0xdf, 0x55, 0x2b, 0x68, 0x3c, 0x80, 0xfd, 0xb5, 0x52, 0x69, + 0x02, 0x1f, 0xfc, 0xf5, 0x92, 0x06, 0xd7, 0xeb, 0x07, 0x7f, 0x0d, 0xfb, 0x6b, 0xa5, 0xca, 0xfe, + 0x8f, 0x60, 0x63, 0x61, 0x3b, 0x01, 0xf7, 0x3d, 0x4f, 0xca, 0x7b, 0x89, 0xa4, 0x1c, 0xd8, 0x4e, + 0x70, 0xea, 0x84, 0xcc, 0x0f, 0xae, 0xb1, 0x24, 0x3d, 0xd3, 0xf3, 0x9a, 0x91, 0x69, 0xfc, 0x5e, + 0x83, 0x42, 0x42, 0xc8, 0x53, 0xc3, 0xf3, 0x27, 0x94, 0x4c, 0x03, 0x7f, 0x1e, 0x6d, 0x02, 0x07, + 0x4e, 0x02, 0x7f, 0xce, 0x63, 0x42, 0x08, 0x99, 0xaf, 0x02, 0x38, 0xc7, 0x3f, 0x47, 0x3e, 0xfa, + 0x18, 0x36, 0x67, 0x52, 0x81, 0x28, 0x9b, 0x85, 0xa3, 0xca, 0x8d, 0xb9, 0x3b, 0x36, 0xb3, 0x71, + 0xc4, 0x79, 0xa6, 0xe7, 0xb3, 0x86, 0xfe, 0x4c, 0xcf, 0xeb, 0xc6, 0xc6, 0x33, 0x3d, 0xbf, 0x61, + 0xe4, 0x9e, 0xe9, 0xf9, 0x9c, 0xb1, 0xd9, 0xf8, 0xbb, 0x06, 0xf9, 0x88, 0xcd, 0x2d, 0xe1, 0x5b, + 0x4a, 0x78, 0x5c, 0xa8, 0x60, 0xca, 0x73, 0x60, 0xe4, 0xcc, 0x29, 0xaa, 0x43, 0x51, 0x08, 0xd3, + 0x21, 0x0a, 0x1c, 0x6b, 0x89, 0x30, 0x15, 0xf5, 0x3c, 0x62, 0x88, 0x78, 0xd4, 0x55, 0x3d, 0x97, + 0x94, 0xa8, 0x25, 0x85, 0xcb, 0xf1, 0x98, 0x86, 0xa1, 0x9c, 0x65, 0x43, 0x52, 0x14, 0x26, 0x26, + 0x7a, 0x08, 0xdb, 0x11, 0x25, 0x9a, 0x2b, 0x27, 0xe3, 0x55, 0xc1, 0x6a, 0xba, 0x26, 0x18, 0x49, + 0xde, 0x7c, 0xd5, 0x41, 0xca, 0x2b, 0x22, 0x9f, 0x54, 0x2e, 0xbe, 0xf1, 0x6b, 0xd8, 0x13, 0xae, + 0x1c, 0x04, 0xfe, 0x85, 0x7d, 0xe1, 0xb8, 0x0e, 0xbb, 0x8e, 0x82, 0x9c, 0x2f, 0x3c, 0xf0, 0xe7, + 0x84, 0xef, 0x6d, 0xe4, 0x02, 0x0e, 0xf4, 0xfc, 0x09, 0xe5, 0x2e, 0x60, 0xbe, 0x14, 0x29, 0x17, + 0x30, 0x5f, 0x08, 0x92, 0x9d, 0x37, 0x9b, 0xea, 0xbc, 0x8d, 0x2b, 0xa8, 0xde, 0x9e, 0x4b, 0xc5, + 0x4c, 0x1d, 0x0a, 0x8b, 0x15, 0x2c, 0xa6, 0xd3, 0x70, 0x12, 0x4a, 0xfa, 0x36, 0xf3, 0x66, 0xdf, + 0x36, 0xfe, 0xa8, 0xc1, 0xce, 0xf1, 0xd2, 0x71, 0x27, 0xa9, 0xc4, 0x4d, 0x5a, 0xa7, 0xa5, 0xcf, + 0x05, 0xeb, 0x9a, 0x7e, 0x66, 0x6d, 0xd3, 0xff, 0x68, 0x4d, 0x63, 0xcd, 0x8a, 0xc6, 0x9a, 0x59, + 0xd3, 0x56, 0xdf, 0x85, 0xc2, 0xaa, 0x4b, 0x86, 0x55, 0xbd, 0x9e, 0x6d, 0x16, 0x31, 0xcc, 0xa2, + 0x16, 0x19, 0x36, 0x3e, 0x05, 0x94, 0x34, 0x54, 0x6d, 0x48, 0x5c, 0x3f, 0xb4, 0xbb, 0xeb, 0xc7, + 0x7d, 0xa8, 0x0d, 0x97, 0x17, 0xe1, 0x38, 0x70, 0x2e, 0xe8, 0x29, 0x73, 0xc7, 0xe6, 0x4b, 0xea, + 0xb1, 0x30, 0xca, 0xd2, 0x7f, 0xea, 0xb0, 0x15, 0xa3, 0xbc, 0x3c, 0x3b, 0xde, 0xd8, 0x9f, 0x47, + 0x46, 0x7b, 0xd4, 0xe5, 0x76, 0xcb, 0xa6, 0xb0, 0x13, 0x89, 0xda, 0x52, 0x62, 0x4d, 0x38, 0x3f, + 0xb5, 0x48, 0xc5, 0xcf, 0x48, 0x7e, 0x72, 0x8d, 0x92, 0xdf, 0x04, 0x23, 0xd6, 0x3f, 0x63, 0xee, + 0x38, 0xde, 0x14, 0x5c, 0x8e, 0x70, 0x6e, 0x8c, 0x64, 0xc6, 0x9a, 0x23, 0xa6, 0x2e, 0x99, 0x11, + 0xae, 0x98, 0xef, 0x41, 0x91, 0xe7, 0x43, 0xc8, 0xec, 0xf9, 0x82, 0x78, 0xa1, 0xc8, 0x0b, 0x1d, + 0x17, 0x62, 0xac, 0x17, 0xa2, 0x2f, 0x00, 0x28, 0x5f, 0x1f, 0x61, 0xd7, 0x0b, 0x2a, 0x52, 0xa2, + 0x7c, 0xf4, 0x4e, 0x22, 0x30, 0xe2, 0x0d, 0x38, 0x10, 0xff, 0x8e, 0xae, 0x17, 0x14, 0x6f, 0xd1, + 0xe8, 0x27, 0xfa, 0x12, 0x4a, 0x53, 0x3f, 0x78, 0x65, 0x07, 0x13, 0x22, 0x40, 0x55, 0x36, 0xf6, + 0x12, 0x1a, 0x4e, 0xa4, 0x5c, 0x0c, 0x3f, 0x7d, 0x0b, 0x17, 0xa7, 0x89, 0x6f, 0xf4, 0x1c, 0x50, + 0x34, 0x5e, 0x64, 0xb9, 0x54, 0x92, 0x17, 0x4a, 0xf6, 0x6f, 0x2b, 0xe1, 0x45, 0x3a, 0x52, 0x64, + 0x4c, 0x6f, 0x60, 0xe8, 0x33, 0x28, 0x86, 0x94, 0x31, 0x97, 0x2a, 0x35, 0x5b, 0x42, 0xcd, 0xbd, + 0xd4, 0x99, 0x86, 0x8b, 0x23, 0x0d, 0x85, 0x70, 0xf5, 0x89, 0x8e, 0x61, 0xdb, 0x75, 0xbc, 0xab, + 0xa4, 0x19, 0x20, 0xc6, 0x57, 0x13, 0xe3, 0xbb, 0x8e, 0x77, 0x95, 0xb4, 0xa1, 0xe4, 0x26, 0x81, + 0xc6, 0xe7, 0xb0, 0x15, 0xef, 0x12, 0x2a, 0xc0, 0xe6, 0x79, 0xef, 0x79, 0xaf, 0xff, 0x4d, 0xcf, + 0x78, 0x0b, 0xe5, 0x41, 0x1f, 0x9a, 0xbd, 0x8e, 0xa1, 0x71, 0x18, 0x9b, 0x6d, 0xd3, 0x7a, 0x61, + 0x1a, 0x19, 0xfe, 0x71, 0xd2, 0xc7, 0xdf, 0xb4, 0x70, 0xc7, 0xc8, 0x1e, 0x6f, 0xc2, 0x86, 0x98, + 0xb7, 0xf1, 0x67, 0x0d, 0xf2, 0xc2, 0x83, 0xde, 0xd4, 0x47, 0xff, 0x0f, 0x71, 0x70, 0x89, 0xe2, + 0xc6, 0x1b, 0xae, 0x88, 0xba, 0x12, 0x8e, 0x03, 0x66, 0xa4, 0x70, 0x4e, 0x8e, 0x43, 0x23, 0x26, + 0x67, 0x24, 0x39, 0x12, 0xc4, 0xe4, 0xc7, 0x09, 0xcd, 0xa9, 0x92, 0xa3, 0xe3, 0xed, 0x48, 0x10, + 0x55, 0xd8, 0xe4, 0xd9, 0x36, 0x55, 0x89, 0x13, 0x67, 0x5b, 0xc5, 0x6d, 0xfc, 0x14, 0x8a, 0x49, + 0x9f, 0xa3, 0x47, 0xa0, 0x3b, 0xde, 0xd4, 0x57, 0x89, 0x58, 0xb9, 0x11, 0x5c, 0x7c, 0x91, 0x58, + 0x10, 0x1a, 0x08, 0x8c, 0x9b, 0x7e, 0x6e, 0x94, 0xa0, 0x90, 0x70, 0x5a, 0xe3, 0x6f, 0x1a, 0x94, + 0x52, 0x4e, 0xf8, 0xb7, 0xb5, 0xa3, 0x2f, 0xa0, 0xf8, 0xca, 0x09, 0x28, 0x49, 0xb6, 0xff, 0xf2, + 0x51, 0x2d, 0xdd, 0xfe, 0xa3, 0xff, 0xdb, 0xfe, 0x84, 0xe2, 0x02, 0xe7, 0x2b, 0x00, 0xfd, 0x02, + 0xca, 0x6a, 0x24, 0x99, 0x50, 0x66, 0x3b, 0xae, 0xd8, 0xaa, 0x72, 0x2a, 0x3c, 0x14, 0xb7, 0x23, + 0xe4, 0xb8, 0x34, 0x4d, 0x7e, 0xa2, 0x0f, 0x57, 0x0a, 0x42, 0x16, 0x38, 0xde, 0xa5, 0xd8, 0xbf, + 0xad, 0x98, 0x36, 0x14, 0x20, 0x6f, 0xe4, 0x25, 0x75, 0x78, 0x1c, 0x32, 0x9b, 0x2d, 0x43, 0xf4, + 0x31, 0x6c, 0x84, 0xcc, 0x56, 0x95, 0xac, 0x9c, 0xca, 0xad, 0x04, 0x91, 0x62, 0xc9, 0x4a, 0x9d, + 0x7e, 0x32, 0xb7, 0x4e, 0x3f, 0x1b, 0xbc, 0x62, 0xc8, 0x2a, 0x5a, 0x38, 0x42, 0x6a, 0xf1, 0xa7, + 0xa3, 0x6e, 0xbb, 0xc5, 0x18, 0x9d, 0x2f, 0x18, 0x96, 0x04, 0xd5, 0xdd, 0xbe, 0x04, 0x68, 0x3b, + 0xc1, 0x78, 0xe9, 0xb0, 0xe7, 0xf4, 0x9a, 0xf7, 0xac, 0xa8, 0x5c, 0xcb, 0xb2, 0x97, 0x1b, 0xcb, + 0x12, 0xbd, 0x07, 0x9b, 0x51, 0x21, 0x92, 0xf5, 0x2d, 0x37, 0x13, 0x05, 0xa8, 0xf1, 0x07, 0x1d, + 0xf6, 0x95, 0x4b, 0xa5, 0x37, 0x18, 0x0d, 0xc6, 0x74, 0x11, 0x1f, 0x8b, 0x9f, 0xc2, 0xee, 0xaa, + 0xa8, 0xca, 0x89, 0x48, 0x74, 0xd4, 0x2e, 0x1c, 0xbd, 0x9d, 0x58, 0xe9, 0xca, 0x0c, 0x8c, 0xe2, + 0x62, 0xbb, 0x32, 0xed, 0x30, 0xa1, 0xc8, 0x9e, 0xfb, 0x4b, 0x4f, 0x85, 0xa8, 0xac, 0x78, 0x68, + 0x15, 0xce, 0x5c, 0x24, 0x22, 0xfa, 0x11, 0xc4, 0x41, 0x4e, 0xe8, 0x0f, 0x0b, 0x27, 0xb8, 0x16, + 0xd5, 0xaf, 0xb4, 0x2a, 0xb7, 0xa6, 0x40, 0x6f, 0x9d, 0x55, 0x33, 0xb7, 0xcf, 0xaa, 0x9f, 0x41, + 0x2d, 0xce, 0x0e, 0x75, 0x8d, 0xa5, 0x93, 0xb8, 0xb5, 0x6d, 0x0a, 0x1b, 0xf6, 0x22, 0x06, 0x8e, + 0x08, 0xaa, 0xbf, 0x1d, 0xc2, 0x6e, 0x22, 0xb5, 0x56, 0xa6, 0xcb, 0x4c, 0x44, 0xab, 0xec, 0x4a, + 0x9a, 0x1e, 0x8f, 0x50, 0xa6, 0xeb, 0xd2, 0xf4, 0x08, 0x56, 0xa6, 0xff, 0x0a, 0xca, 0x37, 0xae, + 0x79, 0x79, 0xe1, 0xf7, 0x9f, 0xdd, 0xae, 0xac, 0xeb, 0xdc, 0x73, 0xb0, 0xe6, 0xae, 0x57, 0x1a, + 0x27, 0xb1, 0xda, 0x57, 0x80, 0xfe, 0xcb, 0x0b, 0xd3, 0x5f, 0x34, 0xb8, 0xbf, 0xde, 0x06, 0xd5, + 0xc8, 0xff, 0x67, 0x31, 0xf2, 0x19, 0xe4, 0xec, 0x31, 0x73, 0x7c, 0x4f, 0xa5, 0xfe, 0xfb, 0x89, + 0xa1, 0x98, 0x86, 0xbe, 0xfb, 0x92, 0x9e, 0xfa, 0xee, 0x44, 0x19, 0xd3, 0x12, 0x54, 0xac, 0x86, + 0xa4, 0xb2, 0x2a, 0x9b, 0xce, 0xaa, 0xc7, 0xbf, 0xd5, 0xa1, 0x94, 0x4a, 0xfd, 0x74, 0xed, 0x2f, + 0xc1, 0x56, 0xaf, 0x4f, 0x3a, 0xe6, 0xa8, 0x65, 0x75, 0x0d, 0x0d, 0x19, 0x50, 0xec, 0xf7, 0xac, + 0x7e, 0x8f, 0x74, 0xcc, 0x76, 0xbf, 0xc3, 0xbb, 0xc0, 0xdb, 0xb0, 0xd3, 0xb5, 0x7a, 0xcf, 0x49, + 0xaf, 0x3f, 0x22, 0x66, 0xd7, 0x7a, 0x6a, 0x1d, 0x77, 0x4d, 0x23, 0x8b, 0x76, 0xc1, 0xe8, 0xf7, + 0x48, 0xfb, 0xb4, 0x65, 0xf5, 0xc8, 0xc8, 0x3a, 0x33, 0xfb, 0xe7, 0x23, 0x43, 0xe7, 0x28, 0x4f, + 0x57, 0x62, 0x7e, 0xdb, 0x36, 0xcd, 0xce, 0x90, 0x9c, 0xb5, 0xbe, 0x35, 0x36, 0x50, 0x15, 0x76, + 0xad, 0xde, 0xf0, 0xfc, 0xe4, 0xc4, 0x6a, 0x5b, 0x66, 0x6f, 0x44, 0x8e, 0x5b, 0xdd, 0x56, 0xaf, + 0x6d, 0x1a, 0x39, 0x74, 0x0f, 0x90, 0xd5, 0x6b, 0xf7, 0xcf, 0x06, 0x5d, 0x73, 0x64, 0x92, 0xa8, + 0xdb, 0x6c, 0xa2, 0x0a, 0x6c, 0x0b, 0x3d, 0xad, 0x4e, 0x87, 0x9c, 0xb4, 0xac, 0xae, 0xd9, 0x31, + 0xf2, 0xdc, 0x12, 0xc5, 0x18, 0x92, 0x8e, 0x35, 0x6c, 0x1d, 0x73, 0x78, 0x8b, 0xcf, 0x69, 0xf5, + 0x5e, 0xf4, 0xad, 0xb6, 0x49, 0xda, 0x5c, 0x2d, 0x47, 0x81, 0x93, 0x23, 0xf4, 0xbc, 0xd7, 0x31, + 0xf1, 0xa0, 0x65, 0x75, 0x8c, 0x02, 0xda, 0x87, 0xbd, 0x08, 0x36, 0xbf, 0x1d, 0x58, 0xf8, 0x3b, + 0x32, 0xea, 0xf7, 0xc9, 0xb0, 0xdf, 0xef, 0x19, 0xc5, 0xa4, 0x26, 0xbe, 0xda, 0xfe, 0xc0, 0xec, + 0x19, 0x25, 0xb4, 0x07, 0x95, 0xb3, 0xc1, 0x80, 0x44, 0x92, 0x68, 0xb1, 0x65, 0x4e, 0x6f, 0x75, + 0x3a, 0xd8, 0x1c, 0x0e, 0xc9, 0x99, 0x35, 0x3c, 0x6b, 0x8d, 0xda, 0xa7, 0xc6, 0x36, 0x5f, 0xd2, + 0xd0, 0x1c, 0x91, 0x51, 0x7f, 0xd4, 0xea, 0xae, 0x70, 0x83, 0x1b, 0xb4, 0xc2, 0xf9, 0xa4, 0xdd, + 0xfe, 0x37, 0xc6, 0x0e, 0xdf, 0x70, 0x0e, 0xf7, 0x5f, 0x28, 0x13, 0x11, 0x5f, 0xbb, 0x72, 0x4f, + 0x34, 0xa7, 0x51, 0xe1, 0xa0, 0xd5, 0x7b, 0xd1, 0xea, 0x5a, 0x1d, 0xf2, 0xdc, 0xfc, 0x4e, 0x74, + 0xeb, 0x5d, 0x0e, 0x4a, 0xcb, 0xc8, 0x00, 0xf7, 0x9f, 0x72, 0x43, 0x8c, 0xb7, 0x11, 0x82, 0x72, + 0xdb, 0xc2, 0xed, 0xf3, 0x6e, 0x0b, 0x13, 0xdc, 0x3f, 0x1f, 0x99, 0xc6, 0xbd, 0xc7, 0x7f, 0xd2, + 0xa0, 0x98, 0xac, 0xc6, 0xdc, 0xeb, 0x56, 0x8f, 0x9c, 0x74, 0xad, 0xa7, 0xa7, 0x23, 0x19, 0x04, + 0xc3, 0xf3, 0x36, 0x77, 0x99, 0xc9, 0x4f, 0x01, 0x08, 0xca, 0x72, 0xd3, 0xe3, 0xc5, 0x66, 0xf8, + 0x5c, 0x0a, 0xeb, 0xf5, 0x95, 0xde, 0x2c, 0x37, 0x5e, 0x81, 0x26, 0xc6, 0x7d, 0x6c, 0xe8, 0xe8, + 0x03, 0xa8, 0x2b, 0x84, 0xfb, 0x15, 0x63, 0xb3, 0x3d, 0x22, 0x83, 0xd6, 0x77, 0x67, 0xdc, 0xed, + 0x32, 0xc8, 0x86, 0xc6, 0x06, 0x7a, 0x17, 0xf6, 0x63, 0xd6, 0xba, 0xb8, 0x78, 0xfc, 0x39, 0x54, + 0xef, 0x0a, 0x7a, 0x04, 0x90, 0x1b, 0x9a, 0xa3, 0x51, 0xd7, 0x94, 0x27, 0x97, 0x13, 0x19, 0xb8, + 0x00, 0x39, 0x6c, 0x0e, 0xcf, 0xcf, 0x4c, 0x23, 0x73, 0xf4, 0xd7, 0x3c, 0xe4, 0xc4, 0x51, 0x3a, + 0x40, 0x5f, 0x41, 0x29, 0xf1, 0x54, 0xf4, 0xe2, 0x08, 0x3d, 0x78, 0xed, 0x23, 0x52, 0x2d, 0xba, + 0x70, 0x2b, 0xf8, 0x50, 0x43, 0xc7, 0x50, 0x4e, 0xbe, 0x99, 0xbc, 0x38, 0x42, 0xc9, 0x13, 0xe8, + 0x9a, 0xe7, 0x94, 0x35, 0x3a, 0x9e, 0x83, 0x61, 0x86, 0xcc, 0x99, 0xf3, 0x46, 0xa8, 0x5e, 0x35, + 0x50, 0x2d, 0x99, 0xe0, 0xe9, 0xa7, 0x92, 0xda, 0xfe, 0x5a, 0x99, 0x2a, 0x39, 0x5f, 0xf3, 0x43, + 0x47, 0xfc, 0xae, 0x70, 0x6b, 0x41, 0xe9, 0xc7, 0x8c, 0xda, 0x3b, 0x77, 0x89, 0xd5, 0x5b, 0x40, + 0xf6, 0x77, 0x19, 0xbe, 0xc6, 0x52, 0x42, 0xb6, 0x66, 0x97, 0x6e, 0x28, 0x5d, 0xd3, 0x9a, 0xd1, + 0x04, 0x2a, 0x6b, 0xde, 0x1c, 0xd0, 0x87, 0xe9, 0x3a, 0x76, 0xc7, 0x8b, 0x45, 0xed, 0xe1, 0x9b, + 0x68, 0x6a, 0xf1, 0x13, 0xa8, 0xac, 0x79, 0x9c, 0x48, 0xcd, 0x72, 0xf7, 0xd3, 0x46, 0x6a, 0x96, + 0xd7, 0xbd, 0x71, 0x7c, 0x0f, 0xc6, 0xcd, 0xbb, 0x2c, 0x6a, 0xdc, 0x1c, 0x7b, 0xfb, 0x52, 0x5d, + 0x7b, 0xff, 0xb5, 0x1c, 0xa5, 0xdc, 0x02, 0x58, 0xdd, 0x08, 0xd1, 0xfd, 0xc4, 0x90, 0x5b, 0x37, + 0xda, 0xda, 0x83, 0x3b, 0xa4, 0x4a, 0xd5, 0x08, 0x2a, 0x6b, 0xae, 0x88, 0xa9, 0xdd, 0xb8, 0xfb, + 0x0a, 0x59, 0xdb, 0x5d, 0x77, 0x93, 0x3a, 0xd4, 0xd0, 0x99, 0x0c, 0xb0, 0xe8, 0xfd, 0xf3, 0x0d, + 0x19, 0x53, 0x5d, 0x7f, 0xe2, 0x5b, 0x86, 0x22, 0xb4, 0x0e, 0x35, 0xd4, 0x87, 0x62, 0x32, 0x4b, + 0xde, 0x98, 0x3e, 0x6f, 0x54, 0x38, 0x85, 0xed, 0x54, 0x33, 0xf6, 0x03, 0xf4, 0xe8, 0x8d, 0x67, + 0x06, 0xb9, 0x63, 0xa9, 0x08, 0x78, 0xcd, 0xe1, 0xa2, 0xa9, 0x1d, 0x6a, 0xc7, 0x9f, 0xfc, 0xf2, + 0xc9, 0xa5, 0xc3, 0x66, 0xcb, 0x8b, 0x83, 0xb1, 0x3f, 0x7f, 0x22, 0x9e, 0x37, 0x3d, 0xc7, 0xbb, + 0xf4, 0x28, 0x7b, 0xe5, 0x07, 0x57, 0x4f, 0x5c, 0x6f, 0xf2, 0x44, 0xa4, 0xc1, 0x93, 0x58, 0xe5, + 0x45, 0x4e, 0xfc, 0x75, 0xe3, 0x47, 0xff, 0x0a, 0x00, 0x00, 0xff, 0xff, 0x4a, 0x9f, 0xe0, 0x07, + 0x0d, 0x19, 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. diff --git a/lnrpc/routerrpc/router.proto b/lnrpc/routerrpc/router.proto index ef03b0fa..30ab825e 100644 --- a/lnrpc/routerrpc/router.proto +++ b/lnrpc/routerrpc/router.proto @@ -628,6 +628,9 @@ message ForwardHtlcInterceptRequest { // The outgoing htlc expiry. uint32 outgoing_expiry = 4; + + // Any custom records that were present in the payload. + map custom_records = 8; } /** diff --git a/lnrpc/routerrpc/router.swagger.json b/lnrpc/routerrpc/router.swagger.json index 16a0a0af..ed500d1d 100644 --- a/lnrpc/routerrpc/router.swagger.json +++ b/lnrpc/routerrpc/router.swagger.json @@ -936,6 +936,14 @@ "type": "integer", "format": "int64", "description": "The outgoing htlc expiry." + }, + "custom_records": { + "type": "object", + "additionalProperties": { + "type": "string", + "format": "byte" + }, + "description": "Any custom records that were present in the payload." } } }, diff --git a/lntest/itest/lnd_forward_interceptor_test.go b/lntest/itest/lnd_forward_interceptor_test.go index e85c18ac..95b49dae 100644 --- a/lntest/itest/lnd_forward_interceptor_test.go +++ b/lntest/itest/lnd_forward_interceptor_test.go @@ -21,6 +21,11 @@ import ( "google.golang.org/grpc/status" ) +var ( + customTestKey uint64 = 394829 + customTestValue = []byte{1, 3, 5} +) + type interceptorTestCase struct { amountMsat int64 invoice *lnrpc.Invoice @@ -149,6 +154,10 @@ func testForwardInterceptor(net *lntest.NetworkHarness, t *harnessTest) { request.IncomingAmountMsat, ) + value, ok := request.CustomRecords[customTestKey] + require.True(t.t, ok, "expected custom record") + require.Equal(t.t, customTestValue, value) + testCase := testCases[i] // For held packets we ignore, keeping them in hold status. @@ -369,6 +378,11 @@ func (c *interceptorTestContext) sendAliceToCarolPayment(ctx context.Context, Route: route, } + // Send a custom record to the forwarding node. + route.Hops[0].CustomRecords = map[uint64][]byte{ + customTestKey: customTestValue, + } + // Send the payment. return c.alice.RouterClient.SendToRouteV2(ctx, sendReq) }