diff --git a/api/client/client.go b/api/client/client.go index c1bf025607b..f288fd6a8fd 100644 --- a/api/client/client.go +++ b/api/client/client.go @@ -1261,21 +1261,66 @@ func (c *Client) GetNode(ctx context.Context, namespace, name string) (types.Ser return resp, nil } -// GetNodes returns a list of nodes by namespace. -// Nodes that the user doesn't have access to are filtered out. +// GetNodes returns a complete list of nodes that the user has access to in the given namespace. func (c *Client) GetNodes(ctx context.Context, namespace string) ([]types.Server, error) { if namespace == "" { return nil, trace.BadParameter("missing parameter namespace") } - resp, err := c.grpc.GetNodes(ctx, &types.ResourcesInNamespaceRequest{Namespace: namespace}, c.callOpts...) - if err != nil { - return nil, trail.FromGRPC(err) + + // Retrieve the complete list of nodes in chunks. + var ( + nodes []types.Server + startKey string + chunkSize = defaults.DefaultChunkSize + ) + for { + resp, nextKey, err := c.ListNodes(ctx, namespace, chunkSize, startKey) + if trace.IsLimitExceeded(err) { + // Cut chunkSize in half if gRPC max message size is exceeded. + chunkSize = chunkSize / 2 + // This is an extremely unlikely scenario, but better to cover it anyways. + if chunkSize == 0 { + return nil, trace.Wrap(trail.FromGRPC(err), "Node is too large to retrieve over gRPC (over 4MiB).") + } + continue + } else if err != nil { + return nil, trail.FromGRPC(err) + } + + nodes = append(nodes, resp...) + startKey = nextKey + if startKey == "" { + return nodes, nil + } } - nodes := make([]types.Server, len(resp.Servers)) +} + +// ListNodes returns a paginated list of nodes that the user has access to in the given namespace. +// nextKey can be used as startKey in another call to ListNodes to retrieve the next page of nodes. +// ListNodes will return a trace.LimitExceeded error if the page of nodes retrieved exceeds 4MiB. +func (c *Client) ListNodes(ctx context.Context, namespace string, limit int, startKey string) (nodes []types.Server, nextKey string, err error) { + if namespace == "" { + return nil, "", trace.BadParameter("missing parameter namespace") + } + if limit <= 0 { + return nil, "", trace.BadParameter("nonpositive parameter limit") + } + + resp, err := c.grpc.ListNodes(ctx, &proto.ListNodesRequest{ + Namespace: namespace, + Limit: int32(limit), + StartKey: startKey, + }, c.callOpts...) + if err != nil { + return nil, "", trail.FromGRPC(err) + } + + nodes = make([]types.Server, len(resp.Servers)) for i, node := range resp.Servers { nodes[i] = node } - return nodes, nil + + return nodes, resp.NextKey, nil } // UpsertNode is used by SSH servers to report their presence diff --git a/api/client/client_test.go b/api/client/client_test.go index c882ae29443..637ddecc8a9 100644 --- a/api/client/client_test.go +++ b/api/client/client_test.go @@ -46,6 +46,14 @@ func newMockServer() *mockServer { return m } +// startMockServer starts a new mock server. Parallel tests cannot use the same addr. +func startMockServer(t *testing.T, addr string) { + l, err := net.Listen("tcp", addr) + require.NoError(t, err) + go newMockServer().grpc.Serve(l) + t.Cleanup(func() { require.NoError(t, l.Close()) }) +} + func (m *mockServer) Ping(ctx context.Context, req *proto.PingRequest) (*proto.PingResponse, error) { return &proto.PingResponse{}, nil } @@ -202,11 +210,3 @@ func TestWaitForConnectionReady(t *testing.T) { require.NoError(t, clt.GetConnection().Close()) require.Error(t, clt.waitForConnectionReady(ctx)) } - -// startMockServer starts a new mock server. Parallel tests cannot use the same addr. -func startMockServer(t *testing.T, addr string) { - l, err := net.Listen("tcp", addr) - require.NoError(t, err) - go newMockServer().grpc.Serve(l) - t.Cleanup(func() { require.NoError(t, l.Close()) }) -} diff --git a/api/client/proto/authservice.pb.go b/api/client/proto/authservice.pb.go index 4f964cce375..4fe5659c5a3 100644 --- a/api/client/proto/authservice.pb.go +++ b/api/client/proto/authservice.pb.go @@ -6176,6 +6176,131 @@ func (m *Events) GetLastKey() string { return "" } +type ListNodesRequest struct { + // Namespace is the namespace of resources. + Namespace string `protobuf:"bytes,1,opt,name=Namespace,proto3" json:"Namespace,omitempty"` + // Limit is the maximum amount of nodes to retrieve. + Limit int32 `protobuf:"varint,2,opt,name=Limit,proto3" json:"Limit,omitempty"` + // StartKey is used to start listing nodes from a specific spot. This should + // be set to the previous NextKey value if using pagination, or left empty. + StartKey string `protobuf:"bytes,3,opt,name=StartKey,proto3" json:"StartKey,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` +} + +func (m *ListNodesRequest) Reset() { *m = ListNodesRequest{} } +func (m *ListNodesRequest) String() string { return proto.CompactTextString(m) } +func (*ListNodesRequest) ProtoMessage() {} +func (*ListNodesRequest) Descriptor() ([]byte, []int) { + return fileDescriptor_ce8bd90b12161215, []int{92} +} +func (m *ListNodesRequest) XXX_Unmarshal(b []byte) error { + return m.Unmarshal(b) +} +func (m *ListNodesRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + if deterministic { + return xxx_messageInfo_ListNodesRequest.Marshal(b, m, deterministic) + } else { + b = b[:cap(b)] + n, err := m.MarshalToSizedBuffer(b) + if err != nil { + return nil, err + } + return b[:n], nil + } +} +func (m *ListNodesRequest) XXX_Merge(src proto.Message) { + xxx_messageInfo_ListNodesRequest.Merge(m, src) +} +func (m *ListNodesRequest) XXX_Size() int { + return m.Size() +} +func (m *ListNodesRequest) XXX_DiscardUnknown() { + xxx_messageInfo_ListNodesRequest.DiscardUnknown(m) +} + +var xxx_messageInfo_ListNodesRequest proto.InternalMessageInfo + +func (m *ListNodesRequest) GetNamespace() string { + if m != nil { + return m.Namespace + } + return "" +} + +func (m *ListNodesRequest) GetLimit() int32 { + if m != nil { + return m.Limit + } + return 0 +} + +func (m *ListNodesRequest) GetStartKey() string { + if m != nil { + return m.StartKey + } + return "" +} + +type ListNodesResponse struct { + // Servers is a list of servers. + Servers []*types.ServerV2 `protobuf:"bytes,1,rep,name=Servers,proto3" json:"Servers,omitempty"` + // NextKey is the next Key to use as StartKey in a ListNodesRequest to continue + // retrieving pages of nodes. If NextKey is empty, there are no more pages. + NextKey string `protobuf:"bytes,2,opt,name=NextKey,proto3" json:"NextKey,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` +} + +func (m *ListNodesResponse) Reset() { *m = ListNodesResponse{} } +func (m *ListNodesResponse) String() string { return proto.CompactTextString(m) } +func (*ListNodesResponse) ProtoMessage() {} +func (*ListNodesResponse) Descriptor() ([]byte, []int) { + return fileDescriptor_ce8bd90b12161215, []int{93} +} +func (m *ListNodesResponse) XXX_Unmarshal(b []byte) error { + return m.Unmarshal(b) +} +func (m *ListNodesResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + if deterministic { + return xxx_messageInfo_ListNodesResponse.Marshal(b, m, deterministic) + } else { + b = b[:cap(b)] + n, err := m.MarshalToSizedBuffer(b) + if err != nil { + return nil, err + } + return b[:n], nil + } +} +func (m *ListNodesResponse) XXX_Merge(src proto.Message) { + xxx_messageInfo_ListNodesResponse.Merge(m, src) +} +func (m *ListNodesResponse) XXX_Size() int { + return m.Size() +} +func (m *ListNodesResponse) XXX_DiscardUnknown() { + xxx_messageInfo_ListNodesResponse.DiscardUnknown(m) +} + +var xxx_messageInfo_ListNodesResponse proto.InternalMessageInfo + +func (m *ListNodesResponse) GetServers() []*types.ServerV2 { + if m != nil { + return m.Servers + } + return nil +} + +func (m *ListNodesResponse) GetNextKey() string { + if m != nil { + return m.NextKey + } + return "" +} + func init() { proto.RegisterEnum("proto.Operation", Operation_name, Operation_value) proto.RegisterEnum("proto.UserCertsRequest_CertUsage", UserCertsRequest_CertUsage_name, UserCertsRequest_CertUsage_value) @@ -6273,367 +6398,373 @@ func init() { proto.RegisterType((*GetEventsRequest)(nil), "proto.GetEventsRequest") proto.RegisterType((*GetSessionEventsRequest)(nil), "proto.GetSessionEventsRequest") proto.RegisterType((*Events)(nil), "proto.Events") + proto.RegisterType((*ListNodesRequest)(nil), "proto.ListNodesRequest") + proto.RegisterType((*ListNodesResponse)(nil), "proto.ListNodesResponse") } func init() { proto.RegisterFile("authservice.proto", fileDescriptor_ce8bd90b12161215) } var fileDescriptor_ce8bd90b12161215 = []byte{ - // 5675 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xc4, 0x3c, 0x4d, 0x73, 0x23, 0xc7, - 0x75, 0x3b, 0xe0, 0x27, 0x1e, 0xbf, 0xc0, 0xe6, 0x17, 0x16, 0xcb, 0x25, 0xd6, 0xb3, 0xb6, 0xbc, - 0x96, 0x65, 0x52, 0x06, 0xa5, 0x48, 0x96, 0x2c, 0x29, 0x00, 0xf8, 0xa9, 0xe5, 0xee, 0x52, 0x03, - 0x12, 0x1b, 0x3b, 0xaa, 0x62, 0x86, 0x40, 0x2f, 0x39, 0x45, 0x10, 0x03, 0xcd, 0x0c, 0xb8, 0xda, - 0x9c, 0x92, 0x94, 0x63, 0xa7, 0x92, 0x4a, 0x55, 0x2e, 0x39, 0xe4, 0x94, 0x54, 0xe5, 0x90, 0x9b, - 0x4f, 0xb9, 0xfa, 0xae, 0x4a, 0x55, 0xca, 0xb9, 0xa5, 0x2a, 0x07, 0xc4, 0xd1, 0x11, 0x3f, 0x21, - 0xa7, 0x54, 0xbf, 0xee, 0x9e, 0xe9, 0x1e, 0xcc, 0x80, 0xe4, 0x4a, 0x49, 0x2e, 0xbb, 0x9c, 0xd7, - 0xef, 0xbd, 0x7e, 0xef, 0xf5, 0xeb, 0xf7, 0x5e, 0x77, 0x3f, 0x12, 0xe6, 0xed, 0x6e, 0x70, 0xee, - 0x53, 0xef, 0xca, 0x69, 0xd0, 0xf5, 0x8e, 0xe7, 0x06, 0x2e, 0x19, 0xc3, 0xff, 0x0a, 0x8b, 0x67, - 0xee, 0x99, 0x8b, 0x3f, 0x6e, 0xb0, 0x9f, 0xf8, 0x60, 0xe1, 0xde, 0x99, 0xeb, 0x9e, 0xb5, 0xe8, - 0x06, 0x7e, 0x9d, 0x76, 0x5f, 0x6c, 0xd0, 0xcb, 0x4e, 0xf0, 0x4a, 0x0c, 0x16, 0xe3, 0x83, 0x81, - 0x73, 0x49, 0xfd, 0xc0, 0xbe, 0xec, 0x08, 0x84, 0xf7, 0xce, 0x9c, 0xe0, 0xbc, 0x7b, 0xba, 0xde, - 0x70, 0x2f, 0x37, 0xce, 0x3c, 0xfb, 0xca, 0x09, 0xec, 0xc0, 0x71, 0xdb, 0x76, 0x6b, 0x23, 0xa0, - 0x2d, 0xda, 0x71, 0xbd, 0x60, 0xc3, 0xee, 0x38, 0x1b, 0xc1, 0xab, 0x0e, 0xf5, 0xf9, 0xbf, 0x82, - 0xb0, 0x7a, 0x1b, 0xc2, 0x97, 0x9e, 0xdd, 0xe9, 0x50, 0x2f, 0xfa, 0x41, 0x30, 0xf9, 0xe4, 0x36, - 0x4c, 0xe8, 0x15, 0x6d, 0x07, 0xf2, 0x3f, 0xce, 0xc0, 0xfc, 0xa7, 0x1c, 0x8c, 0x6d, 0x33, 0x00, - 0x79, 0x1f, 0x46, 0x8f, 0x5e, 0x75, 0x68, 0xde, 0x78, 0x60, 0x3c, 0x9a, 0x2d, 0xe5, 0xf8, 0xf8, - 0xfa, 0xb3, 0x0e, 0xf5, 0x90, 0x65, 0x85, 0xf4, 0x7b, 0xc5, 0x59, 0xc6, 0xe8, 0x2d, 0xf7, 0xd2, - 0x09, 0xd0, 0x46, 0x16, 0x52, 0x90, 0xe7, 0x30, 0x6b, 0x51, 0xdf, 0xed, 0x7a, 0x0d, 0xba, 0x47, - 0xed, 0x26, 0xf5, 0xf2, 0x99, 0x07, 0xc6, 0xa3, 0xa9, 0xd2, 0xd2, 0x3a, 0xd7, 0x57, 0x1f, 0xac, - 0x2c, 0xf7, 0x7b, 0x45, 0xe2, 0x09, 0x58, 0xc4, 0x6c, 0xef, 0x8e, 0x15, 0x63, 0x43, 0x3e, 0x87, - 0x99, 0x2a, 0xf5, 0x82, 0x72, 0x37, 0x38, 0x77, 0x3d, 0x27, 0x78, 0x95, 0x1f, 0x41, 0xbe, 0xcb, - 0x82, 0xaf, 0x36, 0x56, 0x2f, 0x55, 0x56, 0xfb, 0xbd, 0x62, 0xbe, 0x41, 0xbd, 0xe0, 0xc4, 0x96, - 0x50, 0x8d, 0xbd, 0xce, 0x8c, 0xfc, 0x01, 0x4c, 0xd7, 0x98, 0xb9, 0x1a, 0x47, 0xee, 0x05, 0x6d, - 0xfb, 0xf9, 0x51, 0x4d, 0x68, 0x75, 0xa8, 0x5e, 0xaa, 0xdc, 0xeb, 0xf7, 0x8a, 0x2b, 0x3e, 0xc2, - 0x4e, 0x02, 0x04, 0x6a, 0xac, 0x35, 0x4e, 0xe4, 0x8f, 0x60, 0xf6, 0xd0, 0x73, 0xaf, 0x1c, 0xdf, - 0x71, 0xdb, 0x08, 0xca, 0x8f, 0x21, 0xef, 0x15, 0xc1, 0x5b, 0x1f, 0xac, 0x97, 0x2a, 0xf7, 0xfb, - 0xbd, 0xe2, 0xdd, 0x8e, 0x84, 0xf2, 0x09, 0x74, 0xcb, 0xe8, 0x24, 0xe4, 0x08, 0xa6, 0xaa, 0xad, - 0xae, 0x1f, 0x50, 0xef, 0xa9, 0x7d, 0x49, 0xf3, 0xe3, 0xc8, 0x7e, 0x51, 0xda, 0x25, 0x1a, 0xa9, - 0x97, 0x2a, 0x85, 0x7e, 0xaf, 0xb8, 0xdc, 0xe0, 0xa0, 0x93, 0xb6, 0x7d, 0xa9, 0x9b, 0x5c, 0x65, - 0x83, 0xf6, 0xe6, 0x9f, 0x55, 0xb7, 0xfd, 0xc2, 0x39, 0xcb, 0x4f, 0xe8, 0xf6, 0x56, 0xc7, 0xea, - 0x9b, 0xc2, 0xde, 0x82, 0x73, 0x03, 0xa1, 0x31, 0x7b, 0xab, 0x04, 0xe4, 0x3d, 0x18, 0x3d, 0xf6, - 0xa9, 0x97, 0x9f, 0x44, 0xa6, 0x33, 0x82, 0x29, 0x03, 0xd5, 0x4b, 0xdc, 0xbb, 0xba, 0x3e, 0xf5, - 0x34, 0x0e, 0x48, 0xc0, 0x08, 0x2d, 0xb7, 0x45, 0xf3, 0x59, 0x8d, 0x90, 0x81, 0xea, 0xef, 0x70, - 0x42, 0xcf, 0x6d, 0xe9, 0x6a, 0x21, 0x01, 0xd9, 0x87, 0x2c, 0xd3, 0xcb, 0xef, 0xd8, 0x0d, 0x9a, - 0x07, 0xa4, 0xce, 0x09, 0xea, 0x10, 0x5e, 0x59, 0xe9, 0xf7, 0x8a, 0x0b, 0x6d, 0xf9, 0xa9, 0x71, - 0x89, 0xa8, 0xc9, 0x27, 0x30, 0x5e, 0xa3, 0xde, 0x15, 0xf5, 0xf2, 0x53, 0xc8, 0x67, 0x4e, 0xba, - 0x09, 0x02, 0xeb, 0xa5, 0xca, 0x62, 0xbf, 0x57, 0xcc, 0xf9, 0xf8, 0xa5, 0xf1, 0x10, 0x64, 0xcc, - 0xb6, 0x16, 0xbd, 0xa2, 0x9e, 0x4f, 0x8f, 0xba, 0xed, 0x36, 0x6d, 0xe5, 0xa7, 0x35, 0xdb, 0x6a, - 0x63, 0xd2, 0x97, 0x3d, 0x0e, 0x3c, 0x09, 0x10, 0xaa, 0xdb, 0x56, 0x23, 0x20, 0xe7, 0x90, 0xe3, - 0x3f, 0x55, 0xdd, 0x76, 0x9b, 0x36, 0xd8, 0x86, 0xcd, 0xcf, 0xe0, 0x04, 0x77, 0xc5, 0x04, 0xf1, - 0xe1, 0x7a, 0xa9, 0x52, 0xec, 0xf7, 0x8a, 0xf7, 0x38, 0x6f, 0xb6, 0x7c, 0x62, 0x40, 0x9b, 0x66, - 0x80, 0x2b, 0xd3, 0xa3, 0xdc, 0x68, 0x50, 0xdf, 0xb7, 0xe8, 0x17, 0x5d, 0xea, 0x07, 0xf9, 0x59, - 0x4d, 0x0f, 0x6d, 0x4c, 0xfa, 0x88, 0x8d, 0xc0, 0x13, 0x8f, 0x43, 0x75, 0x3d, 0x34, 0x02, 0x72, - 0x08, 0x50, 0xee, 0x74, 0x6a, 0xd4, 0x67, 0xae, 0x9e, 0x9f, 0x43, 0xd6, 0x0b, 0x82, 0xf5, 0x73, - 0x7a, 0x2a, 0x06, 0xea, 0xa5, 0xca, 0xdd, 0x7e, 0xaf, 0xb8, 0x64, 0x77, 0x3a, 0x27, 0x3e, 0x07, - 0x69, 0x4c, 0x15, 0x1e, 0xdc, 0xee, 0x97, 0x6e, 0x40, 0x85, 0x33, 0xe6, 0x73, 0x31, 0xbb, 0x2b, - 0x63, 0x52, 0x5e, 0x0f, 0x81, 0x27, 0xc2, 0xb5, 0xe3, 0x76, 0x57, 0x08, 0xd8, 0x4e, 0xdf, 0xb2, - 0x03, 0xfb, 0xd4, 0xf6, 0xa9, 0x70, 0x8f, 0x79, 0x6d, 0xa7, 0xeb, 0x83, 0xf5, 0x4d, 0xbe, 0xd3, - 0x9b, 0x02, 0x7a, 0x92, 0xe0, 0x2f, 0x31, 0x7e, 0xcc, 0x22, 0x91, 0xe2, 0x79, 0x72, 0x8d, 0x45, - 0x5e, 0xd2, 0xd3, 0x64, 0x8b, 0x44, 0xa8, 0x64, 0x0f, 0x26, 0x9f, 0xd3, 0x53, 0x1e, 0x97, 0x16, - 0x90, 0xdf, 0x7c, 0xc4, 0x8f, 0x47, 0xa4, 0x4d, 0xbe, 0x2b, 0x18, 0xb7, 0xc1, 0x58, 0x14, 0x52, - 0x93, 0x3f, 0x37, 0x60, 0x45, 0xc6, 0x0f, 0x1a, 0xbc, 0x74, 0xbd, 0x0b, 0xa7, 0x7d, 0x26, 0x42, - 0xc7, 0x22, 0x72, 0x7e, 0x10, 0x0b, 0x49, 0x31, 0xac, 0x7a, 0xa9, 0xf2, 0xfd, 0x7e, 0xaf, 0xf8, - 0x30, 0x0c, 0x4f, 0xe1, 0x78, 0x52, 0x3c, 0x49, 0x9b, 0x8b, 0xfc, 0xa9, 0x01, 0xcb, 0x42, 0x3b, - 0x8b, 0x36, 0x5c, 0xaf, 0x19, 0x89, 0xb1, 0x84, 0x62, 0x14, 0xc3, 0xdd, 0x9a, 0x84, 0x54, 0x2f, - 0x55, 0xde, 0xe8, 0xf7, 0x8a, 0xa6, 0x30, 0xdc, 0x89, 0x27, 0x87, 0x93, 0x84, 0x48, 0x99, 0x88, - 0x79, 0x02, 0x4b, 0x2d, 0x87, 0x1e, 0x7d, 0x41, 0x3d, 0xda, 0x6e, 0xd0, 0xfc, 0xb2, 0xe6, 0x09, - 0xfa, 0xa0, 0x8c, 0xf9, 0x2c, 0x51, 0x9d, 0x74, 0x42, 0xb0, 0xee, 0x09, 0x3a, 0x09, 0xf9, 0x02, - 0x88, 0x30, 0x40, 0xb9, 0xdb, 0x74, 0x02, 0xa1, 0xe0, 0x0a, 0xce, 0x72, 0x4f, 0xb7, 0xb3, 0x82, - 0x50, 0x2f, 0x55, 0xcc, 0x7e, 0xaf, 0xb8, 0x26, 0x4d, 0x6c, 0xb3, 0xa1, 0x24, 0xc5, 0x12, 0x98, - 0x57, 0x00, 0x26, 0x65, 0x4a, 0x36, 0xf7, 0x60, 0xec, 0xb9, 0x1d, 0x34, 0xce, 0xc9, 0x27, 0x30, - 0xf6, 0xd8, 0x69, 0x37, 0xfd, 0xbc, 0xf1, 0x60, 0x04, 0x23, 0x2a, 0xaf, 0x14, 0x70, 0x90, 0x0d, - 0x54, 0x56, 0xbe, 0xea, 0x15, 0xef, 0xf4, 0x7b, 0xc5, 0xb9, 0x0b, 0x86, 0xa6, 0x94, 0x0b, 0x9c, - 0xce, 0xfc, 0xe7, 0x0c, 0x64, 0x43, 0x6c, 0xb2, 0x0a, 0xa3, 0xec, 0x7f, 0xac, 0x3b, 0xb2, 0x95, - 0xc9, 0x7e, 0xaf, 0x38, 0xca, 0xe8, 0x2c, 0x84, 0x92, 0x12, 0x4c, 0x1d, 0xb8, 0x76, 0xb3, 0x46, - 0x1b, 0x1e, 0x0d, 0x7c, 0x2c, 0x2c, 0x26, 0x2b, 0xb9, 0x7e, 0xaf, 0x38, 0xdd, 0x72, 0xed, 0xe6, - 0x89, 0xcf, 0xe1, 0x96, 0x8a, 0xc4, 0x38, 0x62, 0x56, 0x1c, 0x89, 0x38, 0xb2, 0xf8, 0x6e, 0x21, - 0x94, 0x7c, 0x0a, 0xe3, 0x3b, 0x4e, 0x8b, 0x45, 0x82, 0x51, 0x94, 0x7f, 0x35, 0x2e, 0xff, 0x3a, - 0x1f, 0xde, 0x6e, 0x07, 0xde, 0x2b, 0x1e, 0xd6, 0x5f, 0x20, 0x40, 0x51, 0x44, 0x70, 0x20, 0x6f, - 0xc3, 0x44, 0xad, 0x7b, 0x8a, 0xe2, 0x8f, 0xe1, 0x64, 0x58, 0xdb, 0xf8, 0xdd, 0xd3, 0x13, 0xa6, - 0x82, 0x42, 0x20, 0xd1, 0x0a, 0x3f, 0x81, 0x29, 0x85, 0x3d, 0xc9, 0xc1, 0xc8, 0x05, 0x7d, 0xc5, - 0x75, 0xb7, 0xd8, 0x8f, 0x64, 0x11, 0xc6, 0xae, 0xec, 0x56, 0x97, 0xa2, 0xaa, 0x59, 0x8b, 0x7f, - 0x7c, 0x90, 0x79, 0xdf, 0x30, 0x3f, 0x83, 0x31, 0x56, 0xc0, 0xf8, 0xe4, 0x21, 0x8c, 0xd4, 0x6a, - 0x7b, 0x48, 0x34, 0x5d, 0x99, 0xef, 0xf7, 0x8a, 0x33, 0xbe, 0x7f, 0xae, 0x4c, 0xc6, 0x46, 0x19, - 0xd2, 0xd1, 0x41, 0x0d, 0xb9, 0x08, 0xa4, 0xa0, 0xa5, 0xae, 0x05, 0x1b, 0x35, 0x7f, 0x3b, 0x0e, - 0x39, 0x96, 0x62, 0x91, 0xaf, 0x8c, 0xc1, 0x6f, 0x41, 0xf6, 0xb0, 0x7b, 0xda, 0x72, 0x1a, 0x8f, - 0x85, 0x64, 0xd3, 0x95, 0xd9, 0x7e, 0xaf, 0x08, 0x1d, 0x04, 0x9e, 0x5c, 0xd0, 0x57, 0x56, 0x84, - 0x40, 0x1e, 0xc1, 0x24, 0xe3, 0xc0, 0x0c, 0xcc, 0x45, 0xae, 0x4c, 0xf7, 0x7b, 0xc5, 0xc9, 0xae, - 0x80, 0x59, 0xe1, 0x28, 0xa9, 0xc1, 0xc4, 0xf6, 0x97, 0x1d, 0xc7, 0xa3, 0xbe, 0xa8, 0xe3, 0x0a, - 0xeb, 0xbc, 0xb8, 0x5e, 0x97, 0xc5, 0xf5, 0xfa, 0x91, 0x2c, 0xae, 0x2b, 0xf7, 0x85, 0x0f, 0xcd, - 0x53, 0x4e, 0x12, 0x49, 0xfe, 0x37, 0xff, 0x59, 0x34, 0x2c, 0xc9, 0x89, 0xbc, 0x05, 0xe3, 0x3b, - 0xae, 0x77, 0x69, 0x07, 0x58, 0xbe, 0x65, 0xc5, 0x7a, 0x21, 0x44, 0x5b, 0x2f, 0x84, 0x90, 0x1d, - 0x98, 0xb5, 0xdc, 0x6e, 0x40, 0x8f, 0x5c, 0x99, 0x0d, 0xf8, 0xb2, 0xad, 0xf5, 0x7b, 0xc5, 0x82, - 0xc7, 0x46, 0x4e, 0x02, 0x77, 0x30, 0xee, 0x5b, 0x31, 0x2a, 0xb2, 0x0d, 0xb3, 0x5a, 0xde, 0xf2, - 0xf3, 0xe3, 0x0f, 0x46, 0x1e, 0x65, 0xc5, 0x9e, 0xd6, 0xb2, 0x9d, 0x6a, 0xf3, 0x18, 0x11, 0x79, - 0x0a, 0xf3, 0x8f, 0xbb, 0xa7, 0xd4, 0x6b, 0xd3, 0x80, 0xfa, 0x52, 0xa2, 0x09, 0x94, 0xe8, 0x41, - 0xbf, 0x57, 0x5c, 0xbd, 0x08, 0x07, 0x13, 0x64, 0x1a, 0x24, 0x25, 0x14, 0xe6, 0x84, 0xa0, 0x32, - 0x89, 0x88, 0x62, 0x6b, 0x59, 0xf8, 0x78, 0x6c, 0xb4, 0xf2, 0x50, 0x58, 0xf9, 0x5e, 0xa8, 0xbb, - 0x4c, 0x4d, 0xca, 0x44, 0x71, 0x9e, 0x64, 0x13, 0x26, 0x9f, 0xba, 0x4d, 0x8a, 0x7b, 0x2c, 0x8b, - 0xd2, 0xf2, 0x1a, 0xca, 0x6d, 0xd2, 0x58, 0x81, 0x69, 0x85, 0x88, 0xe4, 0x00, 0xc6, 0x8e, 0x7d, - 0xfb, 0x8c, 0xd7, 0x61, 0xb3, 0xa5, 0xef, 0x08, 0x89, 0xe2, 0xde, 0x87, 0x45, 0x3d, 0x22, 0x56, - 0x16, 0x58, 0x08, 0xe9, 0xb2, 0x1f, 0xd5, 0x10, 0x82, 0x63, 0xe4, 0x33, 0x00, 0x21, 0x55, 0xb9, - 0xd3, 0x11, 0x25, 0xd9, 0xbc, 0xae, 0x64, 0xb9, 0xd3, 0xa9, 0xac, 0x09, 0xfd, 0x96, 0x43, 0xfd, - 0xec, 0x4e, 0x47, 0xe1, 0xa6, 0x30, 0x31, 0xb7, 0x20, 0x1b, 0xce, 0x4d, 0x26, 0x60, 0xa4, 0xdc, - 0x6a, 0xe5, 0xee, 0xb0, 0x1f, 0x6a, 0xb5, 0xbd, 0x9c, 0x41, 0x66, 0x01, 0x22, 0x83, 0xe7, 0x32, - 0x64, 0x1a, 0x26, 0xa5, 0x41, 0x72, 0x23, 0x88, 0xdf, 0xe9, 0xe4, 0x46, 0xcd, 0x7f, 0x37, 0x06, - 0xd6, 0x80, 0xc5, 0xb0, 0x1a, 0x3f, 0x8e, 0xa2, 0xc9, 0x78, 0xa0, 0xc3, 0x18, 0x26, 0x4e, 0xa9, - 0x68, 0x35, 0x4b, 0x45, 0x62, 0xdb, 0xea, 0x90, 0x69, 0xd3, 0x70, 0x5b, 0xea, 0xb6, 0xea, 0x08, - 0x98, 0x15, 0x8e, 0x92, 0x92, 0xb2, 0x01, 0x47, 0xa2, 0x20, 0x24, 0x37, 0xa0, 0xba, 0x18, 0xe1, - 0x56, 0x2c, 0x45, 0xc2, 0x8b, 0x7d, 0x83, 0x34, 0x09, 0x8b, 0x1f, 0xe2, 0x99, 0xbf, 0x31, 0x54, - 0x9b, 0x87, 0x41, 0xd6, 0x48, 0x0c, 0xb2, 0x6f, 0x41, 0x56, 0xe4, 0xc9, 0xfd, 0x2d, 0x21, 0x3f, - 0xc6, 0x10, 0x99, 0x62, 0x9d, 0xa6, 0x15, 0x21, 0x90, 0x0d, 0x00, 0x1e, 0x50, 0xca, 0xcd, 0xa6, - 0x27, 0x94, 0x98, 0xeb, 0xf7, 0x8a, 0x53, 0x22, 0xe4, 0xd8, 0xcd, 0xa6, 0x67, 0x29, 0x28, 0xcc, - 0xa2, 0xea, 0xf1, 0x67, 0x34, 0xb2, 0xa8, 0x7a, 0xd0, 0xd1, 0x0e, 0x37, 0x66, 0x0b, 0x66, 0x77, - 0x69, 0xc0, 0x4c, 0x20, 0x03, 0xdd, 0x70, 0x15, 0x7e, 0x0a, 0x53, 0xcf, 0x9d, 0xe0, 0x5c, 0xcf, - 0x3c, 0x78, 0x98, 0x7a, 0xe9, 0x04, 0xe7, 0x32, 0xf3, 0x28, 0xa6, 0x52, 0xd1, 0xcd, 0x6d, 0x98, - 0x13, 0xb3, 0x85, 0x71, 0xb5, 0xa4, 0x33, 0x34, 0xa2, 0x54, 0xa6, 0x32, 0xd4, 0xd9, 0xd0, 0x78, - 0xa0, 0x21, 0xb5, 0x81, 0xd0, 0xc3, 0xd3, 0x70, 0x5a, 0x01, 0x8e, 0xbb, 0x28, 0x16, 0x92, 0xe2, - 0x81, 0xc8, 0x3c, 0x86, 0x99, 0xc3, 0x56, 0xf7, 0xcc, 0x69, 0xb3, 0xd5, 0xae, 0xd1, 0x2f, 0xc8, - 0x16, 0x40, 0x04, 0x10, 0x33, 0xc8, 0xaa, 0x33, 0x1a, 0xa8, 0x6f, 0x8a, 0x65, 0x42, 0x08, 0xc6, - 0x0e, 0x4b, 0xa1, 0x33, 0xff, 0x72, 0x04, 0x88, 0x98, 0x83, 0x9d, 0x8f, 0x69, 0x8d, 0x06, 0x2c, - 0x4c, 0x2d, 0x43, 0x66, 0x7f, 0x4b, 0x58, 0x7d, 0xbc, 0xdf, 0x2b, 0x66, 0x9c, 0xa6, 0x95, 0xd9, - 0xdf, 0x22, 0xef, 0xc0, 0x18, 0xa2, 0xa1, 0xad, 0x67, 0xc3, 0xf9, 0x54, 0x0e, 0x95, 0x6c, 0xbf, - 0x57, 0x1c, 0x63, 0xe7, 0x70, 0x6a, 0x71, 0x64, 0xf2, 0x2e, 0x64, 0xb7, 0x68, 0x8b, 0x9e, 0xd9, - 0x81, 0x2b, 0x7d, 0x07, 0xc3, 0x51, 0x53, 0x02, 0x95, 0x25, 0x8a, 0x30, 0x59, 0xe2, 0xb0, 0xa8, - 0xed, 0xbb, 0x6d, 0x35, 0x71, 0x78, 0x08, 0x51, 0x13, 0x07, 0xc7, 0x21, 0x7f, 0x6b, 0xc0, 0x54, - 0xb9, 0xdd, 0x76, 0xf9, 0xf5, 0x8a, 0x2f, 0xce, 0xf3, 0x4b, 0xeb, 0xe1, 0x75, 0xcc, 0x81, 0x7d, - 0x4a, 0x5b, 0x75, 0x96, 0xab, 0xfd, 0xca, 0xe7, 0x2c, 0xea, 0xfc, 0x47, 0xaf, 0xf8, 0xe1, 0xeb, - 0xdc, 0xf0, 0xac, 0x1f, 0x79, 0xb6, 0x13, 0xf8, 0x78, 0xbc, 0x89, 0x26, 0x54, 0xdd, 0x4c, 0x91, - 0x83, 0xfc, 0x00, 0xc6, 0xd8, 0x49, 0x57, 0xe6, 0x1f, 0x5c, 0x6c, 0x76, 0x18, 0xd6, 0xaa, 0x2e, - 0xc4, 0x30, 0x1f, 0x42, 0x56, 0x58, 0x72, 0x7f, 0x2b, 0x6d, 0x09, 0xcc, 0x27, 0xf0, 0x86, 0xe5, - 0xa2, 0x75, 0xa9, 0x4f, 0x83, 0x43, 0xdb, 0xf7, 0x5f, 0xba, 0x5e, 0x13, 0xab, 0x7d, 0xe1, 0x92, - 0xd2, 0x9b, 0x1f, 0xc2, 0x04, 0x82, 0x43, 0x36, 0xb8, 0x32, 0x78, 0x5a, 0xb0, 0xe4, 0x88, 0x59, - 0x85, 0xd5, 0x5d, 0x1a, 0x0c, 0xf2, 0xba, 0x15, 0x93, 0x5f, 0x18, 0x50, 0xac, 0x7a, 0x34, 0x51, - 0xa8, 0x9b, 0x6d, 0xe5, 0x55, 0x71, 0xb5, 0x95, 0x89, 0x46, 0x99, 0xd1, 0xc5, 0xf5, 0xd5, 0xf7, - 0x60, 0xe4, 0xe8, 0xe8, 0x00, 0x5d, 0x67, 0x04, 0x2d, 0x38, 0x12, 0x04, 0xad, 0xff, 0xee, 0x15, - 0x27, 0xb7, 0xba, 0xfc, 0xea, 0xcb, 0x62, 0xe3, 0xe6, 0x0c, 0x4c, 0x1d, 0x3a, 0xed, 0x33, 0x31, - 0xa3, 0xf9, 0x57, 0x19, 0x98, 0xe6, 0xdf, 0x7e, 0xc7, 0x6d, 0xf3, 0x28, 0xaf, 0xc6, 0x24, 0xe3, - 0x06, 0x31, 0x89, 0xbc, 0x0f, 0x33, 0xe2, 0x64, 0x48, 0x3d, 0x3c, 0xdf, 0x71, 0x09, 0xf1, 0x4e, - 0x83, 0x9f, 0x0d, 0x4f, 0xae, 0xf8, 0x88, 0xa5, 0x23, 0x92, 0x03, 0x98, 0xe5, 0x80, 0x1d, 0x6a, - 0x07, 0xdd, 0xa8, 0xa6, 0x9a, 0x13, 0x49, 0x50, 0x82, 0xb9, 0x4b, 0x08, 0x5e, 0x2f, 0x04, 0xd0, - 0x8a, 0xd1, 0x92, 0x4f, 0x60, 0xee, 0xd0, 0x73, 0xbf, 0x7c, 0xa5, 0x44, 0x61, 0xbe, 0x2b, 0x96, - 0x58, 0x09, 0xd6, 0x61, 0x43, 0x27, 0x6a, 0x2c, 0x8e, 0x63, 0x9b, 0xbf, 0xcb, 0xc0, 0x64, 0xc8, - 0x6d, 0x5d, 0x4d, 0x95, 0x22, 0xce, 0x61, 0xf4, 0x8f, 0xea, 0x19, 0x4b, 0xc1, 0x20, 0x77, 0x31, - 0x79, 0x8a, 0x08, 0x3b, 0xc1, 0x16, 0xc0, 0xee, 0x74, 0x2c, 0x06, 0x63, 0x7e, 0xba, 0x55, 0x41, - 0xd5, 0x26, 0xb9, 0x9f, 0x36, 0x4f, 0xad, 0xcc, 0x56, 0x85, 0xad, 0xe8, 0xb3, 0xfd, 0xad, 0x2a, - 0x4a, 0x39, 0xc9, 0x57, 0xd4, 0x75, 0x9a, 0x0d, 0x0b, 0xa1, 0x6c, 0xb4, 0x56, 0x7e, 0x72, 0x80, - 0xbb, 0x54, 0x8c, 0xfa, 0xf6, 0x65, 0xcb, 0x42, 0x28, 0xf9, 0x50, 0x46, 0xd0, 0xaa, 0xdb, 0x0e, - 0x3c, 0xb7, 0xe5, 0xe3, 0xf5, 0xd9, 0xa4, 0x16, 0x29, 0x1b, 0x62, 0xc8, 0x8a, 0xa1, 0x92, 0xe7, - 0xb0, 0x52, 0x6e, 0x5e, 0xd9, 0xed, 0x06, 0x6d, 0xf2, 0x91, 0xe7, 0xae, 0x77, 0xf1, 0xa2, 0xe5, - 0xbe, 0xf4, 0xb1, 0x70, 0x9b, 0x14, 0x25, 0xa0, 0x40, 0x39, 0x11, 0xec, 0x5e, 0x4a, 0x24, 0x2b, - 0x8d, 0x9a, 0x14, 0x61, 0xac, 0xda, 0x72, 0xbb, 0x4d, 0xac, 0xd8, 0x26, 0xf9, 0x46, 0x68, 0x30, - 0x80, 0xc5, 0xe1, 0xe6, 0x8f, 0x61, 0x9e, 0x45, 0xaf, 0x80, 0xde, 0x38, 0x85, 0x99, 0x87, 0x00, - 0x35, 0x7a, 0x69, 0x77, 0xce, 0x5d, 0xb6, 0x2c, 0x15, 0xf5, 0x4b, 0xc4, 0x74, 0x12, 0x1e, 0x8c, - 0xc5, 0x40, 0x7d, 0x53, 0x26, 0x6a, 0x89, 0x69, 0x29, 0x54, 0xe6, 0xbf, 0x66, 0x80, 0xe0, 0x01, - 0xb1, 0x16, 0x78, 0xd4, 0xbe, 0x94, 0x62, 0xfc, 0x04, 0xa6, 0xf9, 0x0e, 0xe5, 0x60, 0x14, 0x87, - 0x25, 0x0c, 0xee, 0x8b, 0xea, 0xd0, 0xde, 0x1d, 0x4b, 0x43, 0x65, 0xa4, 0x16, 0xf5, 0xbb, 0x97, - 0x92, 0x34, 0xa3, 0x91, 0xaa, 0x43, 0x8c, 0x54, 0xfd, 0x26, 0x9f, 0xc0, 0x6c, 0xd5, 0xbd, 0xec, - 0x30, 0x9b, 0x08, 0xe2, 0x11, 0x11, 0x96, 0xc5, 0xbc, 0xda, 0x20, 0x3b, 0x51, 0xeb, 0x10, 0xf2, - 0x14, 0x16, 0x76, 0x5a, 0x5d, 0xff, 0xbc, 0xdc, 0x6e, 0x56, 0x5b, 0xae, 0x2f, 0xb9, 0x8c, 0x8a, - 0xd3, 0x89, 0xd8, 0x49, 0x83, 0x18, 0x7b, 0x77, 0xac, 0x24, 0x42, 0xf2, 0x3d, 0x71, 0x97, 0x2e, - 0xd2, 0xc3, 0xcc, 0xba, 0xb8, 0x6a, 0x7f, 0xd6, 0xa6, 0xcf, 0x5e, 0xec, 0xdd, 0xb1, 0xf8, 0x68, - 0x25, 0x0b, 0x13, 0x32, 0x8a, 0x6c, 0xc0, 0xbc, 0x62, 0x4e, 0x96, 0xd0, 0xba, 0x3e, 0x29, 0xc0, - 0xe4, 0x71, 0x87, 0x1d, 0x6f, 0x65, 0x58, 0xb4, 0xc2, 0x6f, 0xf3, 0x2d, 0xdd, 0xd2, 0x64, 0x55, - 0x2d, 0xb4, 0x38, 0x72, 0x04, 0x30, 0xf7, 0x74, 0xe3, 0x0e, 0xc7, 0xd6, 0xe6, 0xcd, 0xc4, 0xe6, - 0xcd, 0xc5, 0x6d, 0x6d, 0x2e, 0x25, 0x1a, 0xcf, 0xfc, 0x33, 0x03, 0x16, 0x77, 0x69, 0x80, 0x37, - 0x70, 0x2c, 0xc6, 0x84, 0x09, 0xe3, 0x87, 0xea, 0x65, 0x2c, 0xf7, 0xd7, 0x99, 0x7e, 0xaf, 0x98, - 0x0d, 0xaf, 0x5e, 0xd5, 0xeb, 0xd6, 0x8f, 0x60, 0xb6, 0x76, 0xe1, 0x74, 0xea, 0x76, 0xcb, 0x69, - 0x62, 0x0c, 0x16, 0xd1, 0x61, 0x09, 0xa3, 0xd9, 0x85, 0xd3, 0x39, 0xb9, 0x8a, 0x86, 0x0c, 0x2b, - 0x86, 0x6c, 0x3e, 0x83, 0xa5, 0x98, 0x0c, 0x22, 0x48, 0xff, 0x1e, 0x4c, 0x08, 0x90, 0xd8, 0x00, - 0x03, 0xf7, 0xb8, 0x53, 0xfd, 0x5e, 0x71, 0xc2, 0x17, 0x64, 0x12, 0xd9, 0x7c, 0x02, 0xcb, 0xc7, - 0x1d, 0x9f, 0x7a, 0x11, 0x4f, 0xa9, 0xd6, 0x66, 0x78, 0x31, 0x6c, 0x24, 0x5f, 0x0c, 0x43, 0xbf, - 0x57, 0x1c, 0xe7, 0x0c, 0xe5, 0x65, 0xb0, 0xd9, 0x80, 0x65, 0xbe, 0x97, 0x07, 0xd8, 0xdd, 0xca, - 0x4a, 0x72, 0xf7, 0x67, 0x12, 0x77, 0xff, 0x3e, 0x14, 0xc4, 0x24, 0xad, 0xd6, 0x37, 0x5b, 0x0e, - 0xf3, 0x5f, 0x0c, 0x58, 0xd9, 0xa5, 0x6d, 0xea, 0xd9, 0x28, 0xb2, 0x96, 0x7a, 0xd5, 0x0b, 0x00, - 0x63, 0xe8, 0x05, 0x40, 0x51, 0x16, 0x2b, 0x19, 0x2c, 0x56, 0x30, 0xc4, 0x61, 0xb1, 0x22, 0x4a, - 0x14, 0x96, 0x08, 0x8e, 0xad, 0x7d, 0x51, 0xc4, 0x61, 0x22, 0xe8, 0x7a, 0x8e, 0xc5, 0x60, 0x64, - 0x3f, 0xba, 0x3c, 0x18, 0xbd, 0xf6, 0xf2, 0x60, 0x41, 0x1c, 0xfb, 0x26, 0xc4, 0xe5, 0x81, 0x76, - 0x65, 0x60, 0x7e, 0x08, 0xf9, 0x41, 0x5d, 0x84, 0x7f, 0x14, 0x61, 0x8c, 0x5f, 0x8c, 0x0e, 0x94, - 0x23, 0x1c, 0x6e, 0x6e, 0x45, 0xde, 0x2d, 0xae, 0x01, 0xc3, 0x4b, 0x93, 0xd8, 0xce, 0x1a, 0x72, - 0xe0, 0x31, 0x6b, 0x91, 0x7f, 0x0a, 0x2e, 0x62, 0xfe, 0x0f, 0x98, 0x7f, 0xf2, 0xab, 0x5e, 0x23, - 0xfd, 0xaa, 0x57, 0xf8, 0x28, 0x27, 0x95, 0x04, 0xe6, 0x73, 0x58, 0xd6, 0x98, 0x46, 0x5e, 0xff, - 0x11, 0x4c, 0x4a, 0x58, 0xac, 0x96, 0xd7, 0xd8, 0xe2, 0xba, 0xf9, 0x92, 0x38, 0x24, 0x31, 0x7f, - 0x6d, 0xc0, 0x0a, 0x0f, 0x3a, 0x83, 0x7a, 0xdf, 0x7c, 0xf5, 0xff, 0x2f, 0x0e, 0x79, 0x9f, 0x8e, - 0x4e, 0x66, 0x72, 0x23, 0x66, 0x1d, 0xf2, 0x83, 0xf2, 0x7e, 0x0b, 0x16, 0xde, 0x85, 0x15, 0x65, - 0xdb, 0x7e, 0xe3, 0xf5, 0x8f, 0x66, 0xfc, 0x16, 0xd7, 0x3f, 0x42, 0xfc, 0xd6, 0xd6, 0x7f, 0x1f, - 0x16, 0x38, 0x63, 0x7d, 0xaf, 0x94, 0xd4, 0xbd, 0x92, 0xf8, 0x88, 0x30, 0xb8, 0x7d, 0x9e, 0xe0, - 0xf6, 0x91, 0x28, 0x91, 0x84, 0xef, 0xc2, 0xb8, 0x78, 0x85, 0xe5, 0xf2, 0x25, 0x30, 0xc3, 0x38, - 0xca, 0x9f, 0x5e, 0x2d, 0x81, 0x6c, 0xe6, 0x51, 0x65, 0x56, 0x4a, 0x8a, 0xbb, 0x13, 0x19, 0xde, - 0xcc, 0xcf, 0x58, 0xc0, 0x8a, 0x8d, 0x7c, 0xc3, 0x1c, 0xf0, 0x0c, 0xf2, 0x3c, 0x07, 0x28, 0x5c, - 0xbf, 0x51, 0x16, 0x78, 0x1f, 0xf2, 0xdc, 0x9d, 0x12, 0x18, 0x0e, 0x0f, 0xed, 0x6b, 0xb0, 0x1a, - 0x86, 0xf6, 0x24, 0xed, 0x7f, 0x65, 0xc0, 0xdd, 0x5d, 0x1a, 0xe8, 0x4f, 0x49, 0xff, 0x2f, 0x99, - 0xf8, 0x73, 0x28, 0x24, 0x09, 0x22, 0x96, 0xe2, 0xe3, 0xf8, 0x52, 0xa4, 0xbe, 0x9b, 0x25, 0x2f, - 0xc9, 0xcf, 0xe1, 0x1e, 0x5f, 0x12, 0x1d, 0x5f, 0x2a, 0xfa, 0x61, 0x6c, 0x55, 0x52, 0xb9, 0x27, - 0xad, 0xce, 0x5f, 0x1b, 0x70, 0x8f, 0x1b, 0x39, 0x99, 0xf9, 0xad, 0xac, 0xf8, 0x10, 0xc6, 0xf7, - 0x5c, 0x76, 0xf2, 0x16, 0x0b, 0x8a, 0xea, 0x9c, 0xbb, 0x7e, 0xc0, 0x02, 0x83, 0x18, 0x1a, 0xfe, - 0x6e, 0x61, 0x3e, 0x85, 0x62, 0xb8, 0xe6, 0xdf, 0xc2, 0xc2, 0x9a, 0x0d, 0x20, 0x92, 0x4d, 0xb5, - 0x66, 0x49, 0x16, 0x77, 0x61, 0xa4, 0x5a, 0xb3, 0xc4, 0xb5, 0x3f, 0xa6, 0xe0, 0x86, 0xef, 0x59, - 0x0c, 0x16, 0x8f, 0xc7, 0x99, 0x9b, 0x5c, 0xba, 0xfd, 0x21, 0x2c, 0x68, 0x93, 0x88, 0x75, 0x5f, - 0x85, 0xd1, 0x2a, 0xf5, 0x02, 0x31, 0x0d, 0x6a, 0xda, 0xa0, 0x5e, 0x60, 0x21, 0x94, 0xbc, 0x01, - 0x13, 0xd5, 0x32, 0x5e, 0x0a, 0x63, 0xa5, 0x30, 0xcd, 0x03, 0x53, 0xc3, 0x3e, 0x69, 0xe0, 0x45, - 0xb1, 0x1c, 0x34, 0xff, 0xc2, 0x50, 0xb8, 0x33, 0xf2, 0xeb, 0x75, 0xd8, 0x60, 0x67, 0x20, 0x66, - 0x33, 0x45, 0x05, 0x4c, 0x42, 0xe2, 0x84, 0x8c, 0x1a, 0x28, 0x28, 0x37, 0xbd, 0x1c, 0xf8, 0x1c, - 0x16, 0x75, 0x49, 0xbe, 0x55, 0x45, 0xbf, 0x8b, 0x57, 0x97, 0xac, 0x46, 0x92, 0x2a, 0x12, 0xf5, - 0xdc, 0x27, 0x1c, 0xe4, 0x3d, 0xc8, 0x09, 0xac, 0x68, 0x83, 0x3d, 0x94, 0x25, 0x17, 0xdf, 0x5e, - 0x7a, 0xef, 0x84, 0xbc, 0x19, 0xfa, 0xbe, 0x3c, 0x59, 0x5e, 0x37, 0xc3, 0x05, 0xe4, 0x9f, 0xec, - 0x94, 0xcb, 0xdd, 0xe0, 0x9c, 0xb6, 0x03, 0xa7, 0x61, 0x07, 0xb4, 0x7a, 0x6e, 0xb7, 0x5a, 0xb4, - 0x7d, 0x86, 0x86, 0x3a, 0x2e, 0xed, 0x84, 0xe9, 0x45, 0xdc, 0xee, 0x97, 0x76, 0x42, 0x0c, 0x8b, - 0x8d, 0x93, 0x47, 0x30, 0x7a, 0xf4, 0xec, 0xe8, 0x50, 0x1c, 0xf3, 0x16, 0x05, 0x1e, 0x03, 0x45, - 0x88, 0x88, 0x61, 0x7e, 0x09, 0x2b, 0xb1, 0xc9, 0x42, 0xad, 0xde, 0x90, 0x73, 0x19, 0x78, 0x84, - 0x0d, 0xe7, 0x92, 0x08, 0x7b, 0x77, 0xf8, 0x64, 0x3f, 0xd0, 0x26, 0x5b, 0x50, 0x26, 0x53, 0x30, - 0x11, 0x45, 0xbc, 0x74, 0x22, 0xcc, 0xfc, 0x63, 0x98, 0x56, 0x05, 0x67, 0xa7, 0xa6, 0xc7, 0xf4, - 0xd5, 0x9e, 0xdd, 0x6e, 0xb6, 0xa4, 0x3d, 0x22, 0x00, 0x1b, 0x0d, 0x51, 0xc5, 0xb1, 0x29, 0x02, - 0x90, 0x45, 0x18, 0x2b, 0x77, 0x3a, 0xfb, 0x5b, 0x7c, 0x53, 0x5b, 0xfc, 0x83, 0xe4, 0x61, 0x42, - 0xde, 0xf8, 0x60, 0x59, 0x63, 0xc9, 0x4f, 0xd3, 0x81, 0x29, 0x45, 0x91, 0x6b, 0xa6, 0x5e, 0x03, - 0xa8, 0xb6, 0x1c, 0xda, 0xc6, 0xf0, 0x27, 0xe6, 0x56, 0x20, 0x78, 0xdc, 0x73, 0xce, 0xda, 0x78, - 0x2d, 0x23, 0x04, 0x88, 0x00, 0xe6, 0x1c, 0xcc, 0x68, 0x76, 0x37, 0x4d, 0x98, 0x56, 0x6d, 0xc3, - 0x5c, 0xa0, 0xea, 0x36, 0x43, 0x17, 0x60, 0x3f, 0x9b, 0xbf, 0x34, 0x60, 0xf1, 0xc9, 0x4e, 0xd9, - 0xa2, 0x67, 0x0e, 0xb6, 0xf6, 0x84, 0x8a, 0x6e, 0xa8, 0x6b, 0x72, 0x4f, 0x5d, 0x93, 0x18, 0xa6, - 0x5c, 0x9c, 0x92, 0xb6, 0x38, 0xab, 0xda, 0xe2, 0x0c, 0x92, 0xf0, 0x55, 0x52, 0x4e, 0xce, 0xbf, - 0x30, 0x60, 0x41, 0x11, 0x24, 0x14, 0x7a, 0x5d, 0x95, 0xa3, 0x30, 0x28, 0x47, 0xdc, 0x47, 0x7e, - 0xac, 0x89, 0x71, 0x2f, 0x41, 0x8c, 0xa1, 0xbe, 0xd2, 0x84, 0xc5, 0x24, 0x25, 0x75, 0xaf, 0x30, - 0x52, 0xbd, 0x22, 0x93, 0xe2, 0x15, 0x23, 0xba, 0x57, 0xd8, 0xb0, 0x90, 0xa0, 0x02, 0x79, 0x13, - 0x72, 0x1c, 0xc6, 0x43, 0x91, 0xb8, 0xab, 0x67, 0x94, 0x03, 0xf0, 0xeb, 0x7c, 0xc5, 0xfc, 0x8d, - 0x01, 0x4b, 0x89, 0xc6, 0x27, 0xcb, 0x2c, 0x8b, 0x36, 0x3c, 0x1a, 0x08, 0xde, 0xe2, 0x8b, 0xc1, - 0xf7, 0x7d, 0xbf, 0x2b, 0xda, 0xfd, 0xb2, 0x96, 0xf8, 0x22, 0xdf, 0x85, 0x99, 0x43, 0xea, 0x39, - 0x6e, 0xb3, 0x46, 0x1b, 0x6e, 0xbb, 0xc9, 0x6f, 0x26, 0x67, 0x2c, 0x1d, 0xc8, 0x0c, 0x54, 0x6e, - 0x9d, 0xb9, 0x9e, 0x13, 0x9c, 0x5f, 0x8a, 0x4d, 0x10, 0x01, 0x18, 0xef, 0x2d, 0xe7, 0xcc, 0x09, - 0xf8, 0x4d, 0xfb, 0x8c, 0x25, 0xbe, 0x98, 0x89, 0xca, 0x8d, 0x86, 0xdb, 0x6d, 0x07, 0x78, 0x69, - 0x97, 0xb5, 0xe4, 0xa7, 0xf9, 0x26, 0x2c, 0x26, 0x2d, 0x5a, 0xa2, 0x13, 0xff, 0x49, 0x06, 0x16, - 0xca, 0xcd, 0xe6, 0x93, 0x9d, 0xf2, 0x16, 0x55, 0x8b, 0xae, 0x77, 0x60, 0x74, 0xbf, 0xed, 0x04, - 0xc2, 0x79, 0xd6, 0x84, 0x2f, 0x24, 0x60, 0x32, 0x2c, 0xe6, 0x0e, 0xec, 0x7f, 0x62, 0xc1, 0xc2, - 0xf6, 0x97, 0x8e, 0x1f, 0x38, 0xed, 0x33, 0x74, 0x48, 0x3e, 0xb1, 0x70, 0x28, 0xc9, 0x24, 0x25, - 0x94, 0xed, 0xdd, 0xb1, 0x92, 0x88, 0xc9, 0x11, 0x2c, 0x3f, 0xa5, 0x2f, 0x13, 0xfc, 0x3b, 0x7c, - 0x3a, 0x0f, 0xd9, 0x26, 0xb8, 0x69, 0x0a, 0xad, 0xba, 0x7d, 0x7e, 0x99, 0x81, 0x45, 0x5d, 0x31, - 0x31, 0xf3, 0x31, 0x2c, 0x2a, 0x02, 0xe9, 0x3e, 0x3c, 0x55, 0x2a, 0x26, 0xab, 0xa3, 0xee, 0xd4, - 0x44, 0x72, 0xf2, 0x1c, 0x56, 0x74, 0xa1, 0xf4, 0x98, 0x19, 0xed, 0xbc, 0x24, 0x94, 0xbd, 0x3b, - 0x56, 0x1a, 0x35, 0x29, 0xc1, 0x48, 0xb9, 0x71, 0x21, 0xcc, 0x92, 0xbc, 0x64, 0x5c, 0xb3, 0x72, - 0xe3, 0x82, 0xed, 0xf9, 0x72, 0xe3, 0x42, 0xdb, 0xc0, 0x7f, 0x67, 0xc0, 0x4a, 0xca, 0x0a, 0xb3, - 0x3d, 0xc3, 0x81, 0x4a, 0x26, 0x54, 0x20, 0xe4, 0x23, 0xe5, 0x5d, 0x61, 0xb6, 0xf4, 0x83, 0xe1, - 0xfe, 0xb2, 0xce, 0x21, 0x47, 0xe1, 0xc3, 0x83, 0x59, 0x94, 0xec, 0xf1, 0x19, 0x62, 0x92, 0x07, - 0x22, 0xfe, 0xe6, 0x7c, 0x5c, 0xda, 0xc9, 0x19, 0x66, 0x35, 0x2e, 0x5a, 0xa8, 0x09, 0x79, 0x04, - 0xe3, 0x1c, 0x28, 0x16, 0x46, 0xf6, 0x35, 0x46, 0xc8, 0x62, 0xdc, 0xfc, 0x07, 0x43, 0x5e, 0x36, - 0x0d, 0xf8, 0xfb, 0x7b, 0x9a, 0xbf, 0xcb, 0x27, 0xf9, 0x64, 0x64, 0xcd, 0xe5, 0x2b, 0x30, 0xf5, - 0x3a, 0xae, 0xae, 0x12, 0xa9, 0xce, 0xf8, 0x8f, 0x86, 0x3c, 0x58, 0x0f, 0xfa, 0xe3, 0x36, 0x4c, - 0xbf, 0x9e, 0x1f, 0x6a, 0x64, 0xe4, 0x5d, 0xee, 0x26, 0x99, 0xe1, 0x9a, 0x0e, 0xf5, 0x94, 0x9f, - 0xca, 0xfb, 0xb4, 0xd7, 0xf1, 0x15, 0x73, 0x35, 0x81, 0x3a, 0x9c, 0xce, 0x5c, 0xc6, 0x73, 0x71, - 0x38, 0x14, 0x1e, 0xe4, 0xaa, 0x78, 0x51, 0xa0, 0xc2, 0xc3, 0xd0, 0x3f, 0x21, 0x40, 0x61, 0x1b, - 0x56, 0xdc, 0x01, 0x24, 0x02, 0x73, 0xf1, 0xbb, 0xc7, 0x3e, 0xf5, 0x6a, 0x4e, 0xfb, 0xac, 0x45, - 0x8f, 0x79, 0x89, 0x1a, 0x1e, 0x1a, 0x7e, 0xa4, 0x39, 0xc1, 0x4a, 0x4a, 0x5f, 0xc6, 0xff, 0xd6, - 0xd2, 0xff, 0xbd, 0x01, 0x85, 0x24, 0xd9, 0xbe, 0xdd, 0xd5, 0x5f, 0x17, 0x65, 0x38, 0x97, 0x36, - 0x2f, 0xc8, 0xc3, 0x39, 0xa5, 0xb2, 0x4c, 0x49, 0xf6, 0xbf, 0xb6, 0xec, 0xbf, 0x36, 0x60, 0x71, - 0xdf, 0x47, 0xf1, 0xbf, 0xe8, 0x3a, 0x1e, 0x6d, 0x4a, 0xc3, 0xad, 0x27, 0x75, 0xef, 0xe0, 0xc2, - 0xef, 0xdd, 0x49, 0xea, 0xce, 0x79, 0x47, 0x69, 0xba, 0xc8, 0x0c, 0x6b, 0xcb, 0xd9, 0xbb, 0x13, - 0xb5, 0x5d, 0x90, 0x37, 0x60, 0xf4, 0x29, 0xcb, 0x5f, 0x23, 0x62, 0x9b, 0x73, 0x0a, 0x06, 0x3a, - 0x70, 0xcf, 0x9c, 0x36, 0x13, 0x99, 0x7d, 0x54, 0x26, 0x61, 0xfc, 0xc8, 0xf6, 0xce, 0x68, 0x60, - 0xbe, 0x0b, 0xd9, 0x70, 0x18, 0xcb, 0x78, 0x25, 0xfd, 0xb1, 0x9f, 0x59, 0xf5, 0x81, 0x83, 0xb2, - 0xfa, 0xc0, 0x0f, 0x73, 0x13, 0x96, 0x62, 0x6a, 0x8a, 0x35, 0x28, 0x30, 0x63, 0x70, 0x18, 0x7f, - 0xcc, 0xb3, 0xc2, 0x6f, 0xb3, 0x0a, 0xf3, 0x03, 0x56, 0x24, 0x44, 0xe9, 0x4f, 0x63, 0x1b, 0xa9, - 0x56, 0xdb, 0x63, 0xb0, 0xb0, 0x1d, 0x8d, 0xc1, 0x8e, 0x0e, 0x6a, 0x95, 0x71, 0xbe, 0x2a, 0x2c, - 0x17, 0xb1, 0x93, 0x0b, 0x3e, 0x8e, 0xf8, 0xd1, 0x05, 0x48, 0xfc, 0x2c, 0xab, 0x9e, 0xa7, 0x2b, - 0x90, 0xad, 0x05, 0x36, 0x9e, 0xfb, 0xa5, 0x31, 0x87, 0x5d, 0x08, 0x4f, 0x7e, 0xd5, 0x2b, 0xde, - 0xc1, 0x5b, 0xe0, 0x88, 0x8c, 0x7c, 0x0c, 0x13, 0xdb, 0xed, 0x26, 0x72, 0x18, 0xb9, 0x05, 0x07, - 0x49, 0xc4, 0x76, 0x3c, 0x8a, 0xcc, 0xa2, 0xb7, 0x8f, 0xcd, 0x84, 0x59, 0x4b, 0x81, 0xa0, 0x99, - 0x9d, 0x4b, 0x87, 0xbf, 0x06, 0x8d, 0x59, 0xfc, 0x83, 0x59, 0x13, 0x45, 0x78, 0x4c, 0x5f, 0x89, - 0x12, 0x26, 0xfc, 0x36, 0x7f, 0x8b, 0xd7, 0xec, 0x81, 0xb8, 0x78, 0xd3, 0xed, 0xa1, 0x69, 0x6c, - 0x7c, 0x63, 0x8d, 0x33, 0xaf, 0xa3, 0x71, 0xa8, 0xd1, 0x48, 0x9a, 0x46, 0xa3, 0x31, 0x8d, 0x76, - 0x61, 0x9c, 0xab, 0xc1, 0x4e, 0xa2, 0xfb, 0x01, 0xbd, 0x8c, 0x4e, 0xa2, 0xea, 0xdb, 0x98, 0xc5, - 0xc7, 0x58, 0x79, 0x77, 0x60, 0xfb, 0xc8, 0x89, 0xfb, 0xa6, 0xfc, 0x7c, 0xf3, 0x4d, 0xc8, 0x86, - 0xbf, 0x8a, 0xc2, 0x52, 0xe5, 0xfe, 0xd3, 0xfd, 0x23, 0x9e, 0x2a, 0x0f, 0x8f, 0x8f, 0x72, 0x06, - 0x01, 0x18, 0xdf, 0xda, 0x3e, 0xd8, 0x3e, 0xda, 0xce, 0x65, 0x4a, 0xbf, 0xfa, 0x10, 0xa6, 0x58, - 0x5c, 0x10, 0xb7, 0x62, 0xe4, 0xa7, 0x30, 0x5b, 0xa3, 0xed, 0xe6, 0x63, 0x4a, 0x3b, 0xe5, 0x96, - 0x73, 0x45, 0x7d, 0x22, 0x83, 0x65, 0x08, 0x2a, 0x2c, 0x0f, 0x58, 0x62, 0xfb, 0xb2, 0x13, 0xbc, - 0x7a, 0x64, 0x90, 0x1f, 0xc2, 0x14, 0xb6, 0x86, 0x0a, 0x3d, 0xa6, 0xd5, 0x76, 0xd1, 0x82, 0xfc, - 0xc2, 0xc1, 0xb7, 0x0d, 0xf2, 0x11, 0x4c, 0xec, 0xd2, 0x00, 0x77, 0xd9, 0x77, 0x62, 0xbf, 0xfd, - 0xb2, 0xdf, 0x0e, 0xdd, 0x57, 0xac, 0x69, 0x21, 0x7e, 0x4b, 0x48, 0xaa, 0x30, 0x29, 0xc8, 0x7d, - 0x62, 0xc6, 0xe8, 0xfd, 0x04, 0x06, 0x0b, 0x31, 0x06, 0x07, 0x8e, 0x1f, 0x90, 0x0d, 0x00, 0x7e, - 0x29, 0x86, 0x62, 0xc4, 0xe7, 0x28, 0x0c, 0xe8, 0x4e, 0x76, 0x59, 0xea, 0x62, 0xa9, 0xe9, 0xa6, - 0x72, 0xa7, 0x18, 0x8b, 0x1c, 0xc0, 0x6c, 0x78, 0x45, 0x75, 0x73, 0x25, 0xd2, 0xb8, 0x7d, 0x00, - 0xf3, 0xf2, 0x9d, 0x26, 0xcc, 0x46, 0x24, 0x2d, 0x3f, 0x85, 0x2b, 0xc1, 0xd1, 0x28, 0x14, 0x54, - 0x5a, 0x3d, 0xbb, 0x90, 0x07, 0x0a, 0x93, 0xc4, 0xa4, 0x58, 0xf8, 0xce, 0x10, 0x0c, 0x1e, 0x16, - 0x1f, 0x19, 0x6f, 0x1b, 0xe4, 0x53, 0x98, 0xd1, 0x62, 0x26, 0x91, 0x55, 0x6c, 0x52, 0xc2, 0x28, - 0xac, 0x26, 0x0f, 0x8a, 0x30, 0xbb, 0xc3, 0xd4, 0x0d, 0x62, 0xdd, 0x5e, 0x85, 0xa4, 0xae, 0x2e, - 0xde, 0x40, 0x5c, 0x90, 0xcf, 0xdc, 0x31, 0x92, 0x6d, 0x58, 0x10, 0x8f, 0x1f, 0xda, 0x6f, 0x56, - 0xa4, 0xf4, 0x87, 0xa5, 0x5a, 0xff, 0x13, 0x58, 0x10, 0x6b, 0xa9, 0xb1, 0xc9, 0x85, 0x0f, 0xf3, - 0xa2, 0x95, 0x28, 0x95, 0xc1, 0xa7, 0xb0, 0x54, 0x8b, 0xe9, 0xc3, 0x1b, 0xb6, 0xee, 0xea, 0x2c, - 0x94, 0xce, 0xb0, 0x54, 0x5e, 0x8f, 0x81, 0xd4, 0xba, 0xa7, 0x97, 0x4e, 0xc8, 0xee, 0xca, 0xa1, - 0x2f, 0xc9, 0xfd, 0x98, 0x4a, 0x0c, 0x88, 0x68, 0x18, 0x3e, 0x0b, 0x29, 0x1a, 0x93, 0x23, 0xfe, - 0xf8, 0xc6, 0xfb, 0x3a, 0xec, 0x8e, 0x7d, 0xea, 0xb4, 0x9c, 0xc0, 0xa1, 0xcc, 0x2d, 0x54, 0x02, - 0x75, 0x48, 0xae, 0xe0, 0xdd, 0x54, 0x0c, 0xf2, 0x31, 0xcc, 0xec, 0xd2, 0x20, 0x6a, 0x7e, 0x23, - 0x2b, 0x03, 0xed, 0x72, 0x62, 0xdd, 0xe4, 0xa5, 0x97, 0xde, 0x71, 0xb7, 0x0f, 0xb9, 0xe3, 0x4e, - 0xd3, 0x0e, 0xa8, 0xc2, 0xe2, 0xfe, 0x00, 0x0b, 0x81, 0x62, 0x7b, 0xf6, 0xa5, 0x9f, 0x6a, 0xad, - 0x0d, 0x18, 0x3d, 0x74, 0xda, 0x67, 0x44, 0xde, 0x8c, 0x29, 0x6d, 0x4b, 0x85, 0x05, 0x0d, 0x26, - 0x5c, 0x2f, 0x80, 0xe2, 0x35, 0x5d, 0x5f, 0xe4, 0x47, 0x61, 0xa9, 0x72, 0x93, 0xee, 0xb0, 0x82, - 0xb2, 0xef, 0x93, 0x11, 0xeb, 0x9b, 0xe4, 0x67, 0xb8, 0x0e, 0x83, 0x18, 0xe4, 0xa1, 0x98, 0x6b, - 0x58, 0xeb, 0x58, 0xe1, 0x5e, 0xea, 0x0c, 0xf5, 0x4d, 0x72, 0x22, 0x1f, 0x00, 0x13, 0xb8, 0xbf, - 0xa1, 0x75, 0xa5, 0xbc, 0xe6, 0x04, 0x1b, 0x18, 0xe7, 0xf1, 0xb7, 0xd3, 0x96, 0x22, 0x69, 0x95, - 0xce, 0x9c, 0x82, 0xfe, 0xfb, 0x6d, 0x64, 0x13, 0x23, 0x3b, 0xf6, 0x83, 0x92, 0x65, 0x9d, 0xc2, - 0x4f, 0x26, 0x79, 0xdb, 0x20, 0x9b, 0x00, 0x5c, 0x4a, 0x9c, 0x48, 0x1f, 0x4e, 0x5d, 0xfd, 0x4d, - 0x16, 0xfe, 0x9b, 0xb7, 0x24, 0xfa, 0x58, 0xa6, 0x00, 0x24, 0xca, 0x6b, 0xe7, 0x23, 0x55, 0xab, - 0x34, 0xfa, 0x7d, 0xc8, 0x95, 0x1b, 0x18, 0xd0, 0xc2, 0x66, 0x21, 0xb2, 0x16, 0x6e, 0x16, 0x7d, - 0x40, 0xf2, 0x5a, 0x8a, 0xf7, 0x1e, 0x1d, 0x50, 0x56, 0xf0, 0xee, 0xc1, 0x4a, 0x98, 0x9a, 0x62, - 0x43, 0xc9, 0x14, 0xa9, 0x42, 0x6d, 0xc3, 0x62, 0xd5, 0x6e, 0x37, 0x68, 0xeb, 0x9b, 0xb1, 0xf9, - 0x00, 0x77, 0xb6, 0xd2, 0x48, 0xb5, 0x1c, 0xa7, 0x17, 0x1b, 0x5b, 0x36, 0xa0, 0x2b, 0xa8, 0x65, - 0x98, 0xe3, 0x46, 0x8c, 0xcc, 0x92, 0x46, 0x9d, 0x36, 0xfd, 0x7b, 0x30, 0xbb, 0xcd, 0x22, 0x5f, - 0xb7, 0xe9, 0xf0, 0x12, 0x99, 0xe8, 0xb5, 0x53, 0x2a, 0xe1, 0x1e, 0xcc, 0x8b, 0x44, 0x10, 0x75, - 0x18, 0x85, 0xc1, 0x77, 0xb0, 0x89, 0xab, 0xb0, 0x28, 0xd9, 0xaa, 0xcd, 0x48, 0x32, 0xcd, 0x69, - 0xed, 0x34, 0x61, 0x9a, 0x4b, 0x6a, 0xf4, 0x09, 0xd3, 0x5c, 0x72, 0x07, 0x4e, 0x05, 0xe6, 0x62, - 0x9d, 0x34, 0xe4, 0xbe, 0x4c, 0xb6, 0x89, 0x1d, 0x36, 0x09, 0x05, 0xcb, 0x9e, 0xb4, 0xea, 0x20, - 0x8f, 0xe4, 0xb6, 0x9a, 0x54, 0x1b, 0x1d, 0x86, 0x59, 0x4e, 0xed, 0x91, 0x21, 0xfa, 0x05, 0x41, - 0x52, 0xff, 0x4c, 0x2a, 0xc7, 0x1a, 0x3b, 0xcb, 0xe8, 0xdd, 0x25, 0x64, 0x2d, 0xb4, 0x48, 0x62, - 0x0b, 0x4d, 0xa1, 0x98, 0x3a, 0x2e, 0x8c, 0xa6, 0x2c, 0x00, 0xff, 0x1d, 0xbe, 0xf8, 0x02, 0xa8, - 0xbd, 0x08, 0x03, 0x0b, 0xa0, 0xb7, 0x18, 0xec, 0xe2, 0x63, 0x92, 0xd2, 0x26, 0x42, 0x52, 0x54, - 0x29, 0xdc, 0x4f, 0xe2, 0x13, 0xad, 0x64, 0x0d, 0x72, 0xf1, 0x2e, 0x8b, 0x50, 0xd3, 0x94, 0x76, - 0x91, 0x50, 0xd3, 0xd4, 0xf6, 0x8c, 0x4f, 0x21, 0x17, 0x6f, 0xb1, 0x08, 0x99, 0xa6, 0xf4, 0x5e, - 0xa4, 0x2e, 0xc5, 0x0e, 0x2c, 0xea, 0x0b, 0x78, 0x8d, 0xbe, 0xe9, 0x95, 0xcc, 0x8c, 0xd6, 0x58, - 0x41, 0x64, 0x6a, 0x88, 0xf5, 0x70, 0x0c, 0x58, 0x3f, 0xa1, 0xc1, 0x83, 0x5b, 0x5f, 0x69, 0xd2, - 0xb8, 0x89, 0xf5, 0x93, 0x7a, 0x3a, 0x42, 0x43, 0x29, 0x72, 0xc9, 0x88, 0x1b, 0x1f, 0xb8, 0x8d, - 0xa1, 0x6e, 0x22, 0x5a, 0x1a, 0x9f, 0x2d, 0x98, 0x52, 0xba, 0x3b, 0xc8, 0x5d, 0xcd, 0x4c, 0x9a, - 0xc7, 0x17, 0x34, 0xe5, 0x74, 0x67, 0xaf, 0xc2, 0xb4, 0xda, 0x23, 0x92, 0x2a, 0xc5, 0xbd, 0x41, - 0x1e, 0xbe, 0x52, 0x4d, 0xcf, 0x86, 0x56, 0xe0, 0xd2, 0xac, 0xc6, 0x8d, 0xa3, 0x09, 0x94, 0xae, - 0x12, 0x51, 0x4d, 0x73, 0x8d, 0x48, 0xe9, 0x99, 0x68, 0x81, 0xe7, 0x64, 0xfd, 0xb7, 0x87, 0x53, - 0x7e, 0x09, 0x79, 0x48, 0xb4, 0x9a, 0x8b, 0x35, 0xb5, 0x10, 0xc5, 0x4b, 0x12, 0x1a, 0x41, 0x0a, - 0x6b, 0x69, 0xc3, 0xc2, 0x4c, 0x07, 0x30, 0x3f, 0xd0, 0xd3, 0x42, 0x8a, 0x5a, 0x3c, 0x1e, 0x6c, - 0x4e, 0x19, 0x72, 0xfe, 0x9b, 0x1f, 0x68, 0x68, 0x09, 0xb9, 0xa5, 0xb5, 0xba, 0xa4, 0x72, 0x3b, - 0x82, 0xa5, 0xc4, 0x26, 0x97, 0xb0, 0x3e, 0x1c, 0xd6, 0x02, 0x93, 0xca, 0xf5, 0x67, 0x40, 0x06, - 0x1b, 0x52, 0xc2, 0x13, 0x61, 0x6a, 0xd3, 0x4c, 0x78, 0x22, 0x1c, 0xd2, 0xcd, 0x72, 0x00, 0x8b, - 0x49, 0xdd, 0x28, 0xc4, 0xd4, 0xec, 0x99, 0xd8, 0x4d, 0x92, 0x90, 0xe4, 0x2c, 0xb9, 0x29, 0x53, - 0xb8, 0x0d, 0xe9, 0x4d, 0x49, 0x55, 0xfe, 0xe7, 0xb2, 0xe3, 0x68, 0xb0, 0x87, 0x24, 0xac, 0x8b, - 0xaf, 0x69, 0x32, 0x19, 0x52, 0x6e, 0xcc, 0xd5, 0x9c, 0xb3, 0xb6, 0xd2, 0xee, 0x11, 0x16, 0x1b, - 0x83, 0x7d, 0x26, 0x61, 0x00, 0x48, 0xea, 0x0e, 0x79, 0x06, 0x8b, 0x32, 0x13, 0xaa, 0x4d, 0x15, - 0x64, 0x80, 0x26, 0xea, 0xf9, 0x08, 0x83, 0x41, 0x62, 0x17, 0x06, 0xaf, 0xd6, 0xf1, 0x4f, 0x42, - 0x28, 0xd5, 0xba, 0xd2, 0xed, 0x50, 0xd0, 0x1b, 0x23, 0xc8, 0x87, 0x58, 0xad, 0xf3, 0xa6, 0xd4, - 0xb4, 0xbd, 0xbe, 0xa2, 0x73, 0x8a, 0xdc, 0x60, 0x53, 0xde, 0xbf, 0xe0, 0x84, 0x3a, 0xe7, 0xeb, - 0x0b, 0x70, 0x24, 0xd2, 0x0b, 0x70, 0x55, 0xd0, 0xf4, 0x13, 0xf2, 0xb4, 0xfa, 0x54, 0x14, 0xda, - 0x2a, 0xe1, 0x31, 0x2a, 0xb4, 0x55, 0xd2, 0xdb, 0x12, 0xd6, 0x7b, 0x47, 0xb2, 0xbe, 0x8a, 0xf8, - 0xdd, 0x1f, 0xfa, 0x38, 0x54, 0x58, 0x1b, 0xfe, 0xa2, 0xa2, 0x54, 0x91, 0xd1, 0x5b, 0x86, 0x5a, - 0xc4, 0x0c, 0xbc, 0x7c, 0xa8, 0x69, 0x34, 0xe1, 0xf9, 0xe3, 0x09, 0xde, 0x18, 0x3f, 0xdb, 0xdf, - 0xaa, 0x8a, 0x3f, 0x4d, 0xe1, 0x7a, 0x03, 0x17, 0x57, 0xca, 0xef, 0xd1, 0x45, 0xd6, 0xe3, 0x28, - 0x1a, 0x61, 0xbd, 0x44, 0x6a, 0x78, 0xf7, 0xa2, 0x41, 0x13, 0xee, 0xae, 0x12, 0x18, 0x16, 0x92, - 0x19, 0xe2, 0x3d, 0x1c, 0x06, 0x7d, 0xe6, 0x07, 0xba, 0x98, 0x29, 0x32, 0x0c, 0xcb, 0x1d, 0xdc, - 0xaa, 0xc9, 0x6c, 0xa4, 0x74, 0xd7, 0x39, 0x08, 0xb7, 0x58, 0xad, 0xfc, 0xe4, 0xe0, 0xb5, 0x2c, - 0xa6, 0x11, 0x86, 0x16, 0xd3, 0xa0, 0xb7, 0xb3, 0x58, 0x8c, 0xa1, 0x6e, 0x31, 0x5d, 0xcc, 0x14, - 0x19, 0xae, 0xb7, 0x58, 0x32, 0x9b, 0x9b, 0x5a, 0xec, 0x33, 0xcc, 0x14, 0xbb, 0xf8, 0x3b, 0x7c, - 0xb7, 0xb2, 0x59, 0x5e, 0xd6, 0x3d, 0x3a, 0x69, 0x7d, 0x93, 0x3c, 0xc7, 0x4e, 0xda, 0x18, 0xfc, - 0x66, 0x76, 0x5b, 0x4d, 0x63, 0x8a, 0x96, 0xdb, 0x87, 0x25, 0x6e, 0xb9, 0xb8, 0xb8, 0xa9, 0xb2, - 0xa4, 0xaa, 0xbd, 0x2b, 0xd3, 0x6e, 0x9c, 0xd5, 0x6d, 0xed, 0xb7, 0x85, 0x2e, 0x72, 0xe4, 0xb1, - 0xaa, 0xa6, 0x39, 0x58, 0xf2, 0xe8, 0x4c, 0xe4, 0x6d, 0x99, 0x8e, 0x5e, 0x2f, 0x91, 0x7d, 0x5c, - 0x05, 0x1d, 0x3c, 0xac, 0x26, 0x4c, 0x66, 0x83, 0x46, 0xda, 0x93, 0xf9, 0x39, 0x26, 0x53, 0xda, - 0xdc, 0xe9, 0x42, 0x85, 0x05, 0xf3, 0x0d, 0xb5, 0x4b, 0x33, 0x11, 0xcf, 0x33, 0xbc, 0x3e, 0xbd, - 0xce, 0x32, 0xf1, 0x3f, 0x1a, 0x45, 0x7e, 0x1f, 0xb2, 0x92, 0xf8, 0x7a, 0x83, 0xc4, 0xa9, 0xd1, - 0x20, 0x1f, 0xc3, 0x94, 0x30, 0x08, 0x4a, 0x90, 0x36, 0x53, 0xaa, 0xf8, 0x1f, 0xc1, 0x94, 0x30, - 0xc3, 0x50, 0x0d, 0xd2, 0xcb, 0xc5, 0xa5, 0x5d, 0x1a, 0x0c, 0xfe, 0xd9, 0x91, 0x6b, 0x95, 0x49, - 0xfa, 0x2b, 0x27, 0x8c, 0x5b, 0x2d, 0x91, 0xdb, 0x30, 0xaa, 0x54, 0xd9, 0xea, 0xd8, 0xb7, 0x9c, - 0xf6, 0x07, 0x67, 0xd2, 0x04, 0xbc, 0xf6, 0xcf, 0xdd, 0x30, 0xbe, 0xb5, 0x74, 0xbe, 0xd7, 0xd2, - 0xa7, 0xca, 0xfb, 0x14, 0x56, 0xf1, 0xa2, 0xf2, 0xb6, 0x12, 0xa7, 0x17, 0xdf, 0x77, 0xa3, 0x97, - 0xc8, 0xf8, 0xdf, 0xba, 0x49, 0x63, 0x76, 0xdd, 0x9f, 0xd9, 0x61, 0x5c, 0x6b, 0xa9, 0x5c, 0xaf, - 0xa3, 0x1e, 0x92, 0xda, 0xee, 0xa1, 0xee, 0xb7, 0x94, 0x76, 0x78, 0xdc, 0x8a, 0xfd, 0xf1, 0x9d, - 0xf4, 0x2a, 0x30, 0xf9, 0xcf, 0xfb, 0x30, 0x2e, 0xb5, 0x01, 0x2e, 0x69, 0xd8, 0xc3, 0x52, 0x19, - 0xaa, 0x76, 0x43, 0x69, 0xd2, 0xef, 0x84, 0xb3, 0xe1, 0x03, 0x3b, 0x51, 0x0a, 0x57, 0xed, 0x89, - 0xb9, 0x30, 0xa3, 0x3e, 0x66, 0xfa, 0xa4, 0xcc, 0x2b, 0x06, 0xf5, 0x31, 0x5a, 0xb9, 0xc9, 0x4a, - 0x7c, 0xa5, 0x8e, 0xb1, 0xa8, 0xe4, 0xbe, 0xfa, 0xaf, 0x35, 0xe3, 0xab, 0xaf, 0xd7, 0x8c, 0x7f, - 0xfb, 0x7a, 0xcd, 0xf8, 0xdd, 0xd7, 0x6b, 0xc6, 0xe9, 0x38, 0x8e, 0x6f, 0xfe, 0x4f, 0x00, 0x00, - 0x00, 0xff, 0xff, 0x11, 0x00, 0x10, 0x2f, 0xa5, 0x51, 0x00, 0x00, + // 5730 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xc4, 0x7c, 0x4b, 0x73, 0x1b, 0x49, + 0x72, 0x30, 0x1b, 0x7c, 0x22, 0xf9, 0x02, 0x8b, 0x2f, 0x08, 0xa4, 0x08, 0x6d, 0x6b, 0x77, 0x56, + 0x33, 0x3b, 0x4b, 0xce, 0x82, 0x33, 0xdf, 0xcc, 0x8e, 0x76, 0x46, 0x1f, 0x00, 0x3e, 0x47, 0x94, + 0xc4, 0x69, 0x80, 0xd0, 0xee, 0x7a, 0x22, 0xe8, 0x26, 0x50, 0x02, 0x3b, 0x08, 0xa2, 0x31, 0xdd, + 0x0d, 0x6a, 0xe4, 0x93, 0xed, 0x58, 0xaf, 0x1d, 0x76, 0x38, 0xc2, 0x17, 0x1f, 0x7c, 0xb2, 0x23, + 0x7c, 0xf0, 0x6d, 0x4f, 0xbe, 0xee, 0xd9, 0x13, 0x8e, 0x70, 0xac, 0x6f, 0x8e, 0xf0, 0x01, 0x5e, + 0xef, 0x11, 0x3f, 0xc1, 0x27, 0x47, 0x3d, 0xbb, 0xaa, 0xd1, 0x0d, 0x92, 0x92, 0x6c, 0x5f, 0x24, + 0x76, 0x56, 0x65, 0x56, 0x66, 0x56, 0x56, 0x66, 0x56, 0x56, 0x92, 0xb0, 0x60, 0x77, 0x83, 0x73, + 0x1f, 0x7b, 0x57, 0x4e, 0x1d, 0x6f, 0x76, 0x3c, 0x37, 0x70, 0xd1, 0x38, 0xfd, 0x2f, 0xb7, 0xd4, + 0x74, 0x9b, 0x2e, 0xfd, 0x71, 0x8b, 0xfc, 0xc4, 0x06, 0x73, 0x6b, 0x4d, 0xd7, 0x6d, 0xb6, 0xf0, + 0x16, 0xfd, 0x3a, 0xeb, 0xbe, 0xd8, 0xc2, 0x97, 0x9d, 0xe0, 0x15, 0x1f, 0xcc, 0x47, 0x07, 0x03, + 0xe7, 0x12, 0xfb, 0x81, 0x7d, 0xd9, 0xe1, 0x13, 0x3e, 0x6e, 0x3a, 0xc1, 0x79, 0xf7, 0x6c, 0xb3, + 0xee, 0x5e, 0x6e, 0x35, 0x3d, 0xfb, 0xca, 0x09, 0xec, 0xc0, 0x71, 0xdb, 0x76, 0x6b, 0x2b, 0xc0, + 0x2d, 0xdc, 0x71, 0xbd, 0x60, 0xcb, 0xee, 0x38, 0x5b, 0xc1, 0xab, 0x0e, 0xf6, 0xd9, 0xbf, 0x1c, + 0xb1, 0x7c, 0x1b, 0xc4, 0x97, 0x9e, 0xdd, 0xe9, 0x60, 0x2f, 0xfc, 0x81, 0x13, 0x79, 0x74, 0x1b, + 0x22, 0xf8, 0x0a, 0xb7, 0x03, 0xf1, 0x1f, 0x23, 0x60, 0xfe, 0x43, 0x06, 0xc6, 0x77, 0x09, 0x00, + 0x7d, 0x02, 0x63, 0xd5, 0x57, 0x1d, 0x9c, 0x35, 0xee, 0x19, 0x0f, 0xe6, 0x0a, 0x19, 0x36, 0xbe, + 0xf9, 0xac, 0x83, 0x3d, 0x4a, 0xb2, 0x84, 0xfa, 0xbd, 0xfc, 0x1c, 0x21, 0xf4, 0xbe, 0x7b, 0xe9, + 0x04, 0x54, 0x47, 0x16, 0xc5, 0x40, 0xcf, 0x61, 0xce, 0xc2, 0xbe, 0xdb, 0xf5, 0xea, 0xf8, 0x00, + 0xdb, 0x0d, 0xec, 0x65, 0x53, 0xf7, 0x8c, 0x07, 0xd3, 0x85, 0xe5, 0x4d, 0x26, 0xaf, 0x3e, 0x58, + 0x5a, 0xe9, 0xf7, 0xf2, 0xc8, 0xe3, 0xb0, 0x90, 0xd8, 0xc1, 0x88, 0x15, 0x21, 0x83, 0xbe, 0x82, + 0xd9, 0x32, 0xf6, 0x82, 0x62, 0x37, 0x38, 0x77, 0x3d, 0x27, 0x78, 0x95, 0x1d, 0xa5, 0x74, 0x57, + 0x38, 0x5d, 0x6d, 0xac, 0x56, 0x28, 0xad, 0xf7, 0x7b, 0xf9, 0x6c, 0x1d, 0x7b, 0xc1, 0xa9, 0x2d, + 0xa0, 0x1a, 0x79, 0x9d, 0x18, 0xfa, 0x29, 0xcc, 0x54, 0x88, 0xba, 0xea, 0x55, 0xf7, 0x02, 0xb7, + 0xfd, 0xec, 0x98, 0xc6, 0xb4, 0x3a, 0x54, 0x2b, 0x94, 0xd6, 0xfa, 0xbd, 0xfc, 0xaa, 0x4f, 0x61, + 0xa7, 0x01, 0x05, 0x6a, 0xa4, 0x35, 0x4a, 0xe8, 0xf7, 0x61, 0xee, 0xd8, 0x73, 0xaf, 0x1c, 0xdf, + 0x71, 0xdb, 0x14, 0x94, 0x1d, 0xa7, 0xb4, 0x57, 0x39, 0x6d, 0x7d, 0xb0, 0x56, 0x28, 0xdd, 0xed, + 0xf7, 0xf2, 0x77, 0x3a, 0x02, 0xca, 0x16, 0xd0, 0x35, 0xa3, 0xa3, 0xa0, 0x2a, 0x4c, 0x97, 0x5b, + 0x5d, 0x3f, 0xc0, 0xde, 0x53, 0xfb, 0x12, 0x67, 0x27, 0x28, 0xf9, 0x25, 0xa1, 0x97, 0x70, 0xa4, + 0x56, 0x28, 0xe5, 0xfa, 0xbd, 0xfc, 0x4a, 0x9d, 0x81, 0x4e, 0xdb, 0xf6, 0xa5, 0xae, 0x72, 0x95, + 0x0c, 0xd5, 0x37, 0xfb, 0x2c, 0xbb, 0xed, 0x17, 0x4e, 0x33, 0x3b, 0xa9, 0xeb, 0x5b, 0x1d, 0xab, + 0x6d, 0x73, 0x7d, 0x73, 0xca, 0x75, 0x0a, 0x8d, 0xe8, 0x5b, 0x45, 0x40, 0x1f, 0xc3, 0xd8, 0x89, + 0x8f, 0xbd, 0xec, 0x14, 0x25, 0x3a, 0xcb, 0x89, 0x12, 0x50, 0xad, 0xc0, 0xac, 0xab, 0xeb, 0x63, + 0x4f, 0xa3, 0x40, 0x11, 0x08, 0xa2, 0xe5, 0xb6, 0x70, 0x36, 0xad, 0x21, 0x12, 0x50, 0xed, 0x43, + 0x86, 0xe8, 0xb9, 0x2d, 0x5d, 0x2c, 0x8a, 0x80, 0x0e, 0x21, 0x4d, 0xe4, 0xf2, 0x3b, 0x76, 0x1d, + 0x67, 0x81, 0x62, 0x67, 0x38, 0xb6, 0x84, 0x97, 0x56, 0xfb, 0xbd, 0xfc, 0x62, 0x5b, 0x7c, 0x6a, + 0x54, 0x42, 0x6c, 0xf4, 0x08, 0x26, 0x2a, 0xd8, 0xbb, 0xc2, 0x5e, 0x76, 0x9a, 0xd2, 0x99, 0x17, + 0x66, 0x42, 0x81, 0xb5, 0x42, 0x69, 0xa9, 0xdf, 0xcb, 0x67, 0x7c, 0xfa, 0xa5, 0xd1, 0xe0, 0x68, + 0x44, 0xb7, 0x16, 0xbe, 0xc2, 0x9e, 0x8f, 0xab, 0xdd, 0x76, 0x1b, 0xb7, 0xb2, 0x33, 0x9a, 0x6e, + 0xb5, 0x31, 0x61, 0xcb, 0x1e, 0x03, 0x9e, 0x06, 0x14, 0xaa, 0xeb, 0x56, 0x43, 0x40, 0xe7, 0x90, + 0x61, 0x3f, 0x95, 0xdd, 0x76, 0x1b, 0xd7, 0xc9, 0x81, 0xcd, 0xce, 0xd2, 0x05, 0xee, 0xf0, 0x05, + 0xa2, 0xc3, 0xb5, 0x42, 0x29, 0xdf, 0xef, 0xe5, 0xd7, 0x18, 0x6d, 0xb2, 0x7d, 0x7c, 0x40, 0x5b, + 0x66, 0x80, 0x2a, 0x91, 0xa3, 0x58, 0xaf, 0x63, 0xdf, 0xb7, 0xf0, 0xd7, 0x5d, 0xec, 0x07, 0xd9, + 0x39, 0x4d, 0x0e, 0x6d, 0x4c, 0xd8, 0x88, 0x4d, 0x81, 0xa7, 0x1e, 0x83, 0xea, 0x72, 0x68, 0x08, + 0xe8, 0x18, 0xa0, 0xd8, 0xe9, 0x54, 0xb0, 0x4f, 0x4c, 0x3d, 0x3b, 0x4f, 0x49, 0x2f, 0x72, 0xd2, + 0xcf, 0xf1, 0x19, 0x1f, 0xa8, 0x15, 0x4a, 0x77, 0xfa, 0xbd, 0xfc, 0xb2, 0xdd, 0xe9, 0x9c, 0xfa, + 0x0c, 0xa4, 0x11, 0x55, 0x68, 0x30, 0xbd, 0x5f, 0xba, 0x01, 0xe6, 0xc6, 0x98, 0xcd, 0x44, 0xf4, + 0xae, 0x8c, 0x09, 0x7e, 0x3d, 0x0a, 0x3c, 0xe5, 0xa6, 0x1d, 0xd5, 0xbb, 0x82, 0x40, 0x4e, 0xfa, + 0x8e, 0x1d, 0xd8, 0x67, 0xb6, 0x8f, 0xb9, 0x79, 0x2c, 0x68, 0x27, 0x5d, 0x1f, 0xac, 0x6d, 0xb3, + 0x93, 0xde, 0xe0, 0xd0, 0xd3, 0x18, 0x7b, 0x89, 0xd0, 0x23, 0x1a, 0x09, 0x05, 0xcf, 0xa2, 0x6b, + 0x34, 0xf2, 0x12, 0x9f, 0xc5, 0x6b, 0x24, 0x9c, 0x8a, 0x0e, 0x60, 0xea, 0x39, 0x3e, 0x63, 0x7e, + 0x69, 0x91, 0xd2, 0x5b, 0x08, 0xe9, 0x31, 0x8f, 0xb4, 0xcd, 0x4e, 0x05, 0xa1, 0x36, 0xe8, 0x8b, + 0x24, 0x36, 0xfa, 0x13, 0x03, 0x56, 0x85, 0xff, 0xc0, 0xc1, 0x4b, 0xd7, 0xbb, 0x70, 0xda, 0x4d, + 0xee, 0x3a, 0x96, 0x28, 0xe5, 0x7b, 0x11, 0x97, 0x14, 0x99, 0x55, 0x2b, 0x94, 0xbe, 0xdf, 0xef, + 0xe5, 0xef, 0x4b, 0xf7, 0x24, 0xc7, 0xe3, 0xfc, 0x49, 0xd2, 0x5a, 0xe8, 0x8f, 0x0c, 0x58, 0xe1, + 0xd2, 0x59, 0xb8, 0xee, 0x7a, 0x8d, 0x90, 0x8d, 0x65, 0xca, 0x46, 0x5e, 0x9e, 0xd6, 0xb8, 0x49, + 0xb5, 0x42, 0xe9, 0x9d, 0x7e, 0x2f, 0x6f, 0x72, 0xc5, 0x9d, 0x7a, 0x62, 0x38, 0x8e, 0x89, 0x84, + 0x85, 0x88, 0x25, 0x90, 0xd0, 0x72, 0xec, 0xe1, 0x17, 0xd8, 0xc3, 0xed, 0x3a, 0xce, 0xae, 0x68, + 0x96, 0xa0, 0x0f, 0x0a, 0x9f, 0x4f, 0x02, 0xd5, 0x69, 0x47, 0x82, 0x75, 0x4b, 0xd0, 0x51, 0xd0, + 0xd7, 0x80, 0xb8, 0x02, 0x8a, 0xdd, 0x86, 0x13, 0x70, 0x01, 0x57, 0xe9, 0x2a, 0x6b, 0xba, 0x9e, + 0x95, 0x09, 0xb5, 0x42, 0xc9, 0xec, 0xf7, 0xf2, 0x1b, 0x42, 0xc5, 0x36, 0x19, 0x8a, 0x13, 0x2c, + 0x86, 0x78, 0x09, 0x60, 0x4a, 0x84, 0x64, 0xf3, 0x00, 0xc6, 0x9f, 0xdb, 0x41, 0xfd, 0x1c, 0x3d, + 0x82, 0xf1, 0xc7, 0x4e, 0xbb, 0xe1, 0x67, 0x8d, 0x7b, 0xa3, 0xd4, 0xa3, 0xb2, 0x4c, 0x81, 0x0e, + 0x92, 0x81, 0xd2, 0xea, 0xb7, 0xbd, 0xfc, 0x48, 0xbf, 0x97, 0x9f, 0xbf, 0x20, 0xd3, 0x94, 0x74, + 0x81, 0xe1, 0x99, 0xff, 0x98, 0x82, 0xb4, 0x9c, 0x8d, 0xd6, 0x61, 0x8c, 0xfc, 0x4f, 0xf3, 0x8e, + 0x74, 0x69, 0xaa, 0xdf, 0xcb, 0x8f, 0x11, 0x3c, 0x8b, 0x42, 0x51, 0x01, 0xa6, 0x8f, 0x5c, 0xbb, + 0x51, 0xc1, 0x75, 0x0f, 0x07, 0x3e, 0x4d, 0x2c, 0xa6, 0x4a, 0x99, 0x7e, 0x2f, 0x3f, 0xd3, 0x72, + 0xed, 0xc6, 0xa9, 0xcf, 0xe0, 0x96, 0x3a, 0x89, 0x50, 0xa4, 0x51, 0x71, 0x34, 0xa4, 0x48, 0xfc, + 0xbb, 0x45, 0xa1, 0xe8, 0x0b, 0x98, 0xd8, 0x73, 0x5a, 0xc4, 0x13, 0x8c, 0x51, 0xfe, 0xd7, 0xa3, + 0xfc, 0x6f, 0xb2, 0xe1, 0xdd, 0x76, 0xe0, 0xbd, 0x62, 0x6e, 0xfd, 0x05, 0x05, 0x28, 0x82, 0x70, + 0x0a, 0xe8, 0x03, 0x98, 0xac, 0x74, 0xcf, 0x28, 0xfb, 0xe3, 0x74, 0x31, 0x9a, 0xdb, 0xf8, 0xdd, + 0xb3, 0x53, 0x22, 0x82, 0x82, 0x20, 0xa6, 0xe5, 0x7e, 0x0c, 0xd3, 0x0a, 0x79, 0x94, 0x81, 0xd1, + 0x0b, 0xfc, 0x8a, 0xc9, 0x6e, 0x91, 0x1f, 0xd1, 0x12, 0x8c, 0x5f, 0xd9, 0xad, 0x2e, 0xa6, 0xa2, + 0xa6, 0x2d, 0xf6, 0xf1, 0x69, 0xea, 0x13, 0xc3, 0xfc, 0x12, 0xc6, 0x49, 0x02, 0xe3, 0xa3, 0xfb, + 0x30, 0x5a, 0xa9, 0x1c, 0x50, 0xa4, 0x99, 0xd2, 0x42, 0xbf, 0x97, 0x9f, 0xf5, 0xfd, 0x73, 0x65, + 0x31, 0x32, 0x4a, 0x26, 0x55, 0x8f, 0x2a, 0x94, 0x0a, 0x9f, 0x14, 0xb4, 0xd4, 0xbd, 0x20, 0xa3, + 0xe6, 0x6f, 0x26, 0x20, 0x43, 0x42, 0x2c, 0xa5, 0x2b, 0x7c, 0xf0, 0xfb, 0x90, 0x3e, 0xee, 0x9e, + 0xb5, 0x9c, 0xfa, 0x63, 0xce, 0xd9, 0x4c, 0x69, 0xae, 0xdf, 0xcb, 0x43, 0x87, 0x02, 0x4f, 0x2f, + 0xf0, 0x2b, 0x2b, 0x9c, 0x80, 0x1e, 0xc0, 0x14, 0xa1, 0x40, 0x14, 0xcc, 0x58, 0x2e, 0xcd, 0xf4, + 0x7b, 0xf9, 0xa9, 0x2e, 0x87, 0x59, 0x72, 0x14, 0x55, 0x60, 0x72, 0xf7, 0x9b, 0x8e, 0xe3, 0x61, + 0x9f, 0xe7, 0x71, 0xb9, 0x4d, 0x96, 0x5c, 0x6f, 0x8a, 0xe4, 0x7a, 0xb3, 0x2a, 0x92, 0xeb, 0xd2, + 0x5d, 0x6e, 0x43, 0x0b, 0x98, 0xa1, 0x84, 0x9c, 0xff, 0xd5, 0x7f, 0xe4, 0x0d, 0x4b, 0x50, 0x42, + 0xef, 0xc3, 0xc4, 0x9e, 0xeb, 0x5d, 0xda, 0x01, 0x4d, 0xdf, 0xd2, 0x7c, 0xbf, 0x28, 0x44, 0xdb, + 0x2f, 0x0a, 0x41, 0x7b, 0x30, 0x67, 0xb9, 0xdd, 0x00, 0x57, 0x5d, 0x11, 0x0d, 0xd8, 0xb6, 0x6d, + 0xf4, 0x7b, 0xf9, 0x9c, 0x47, 0x46, 0x4e, 0x03, 0x77, 0xd0, 0xef, 0x5b, 0x11, 0x2c, 0xb4, 0x0b, + 0x73, 0x5a, 0xdc, 0xf2, 0xb3, 0x13, 0xf7, 0x46, 0x1f, 0xa4, 0xf9, 0x99, 0xd6, 0xa2, 0x9d, 0xaa, + 0xf3, 0x08, 0x12, 0x7a, 0x0a, 0x0b, 0x8f, 0xbb, 0x67, 0xd8, 0x6b, 0xe3, 0x00, 0xfb, 0x82, 0xa3, + 0x49, 0xca, 0xd1, 0xbd, 0x7e, 0x2f, 0xbf, 0x7e, 0x21, 0x07, 0x63, 0x78, 0x1a, 0x44, 0x45, 0x18, + 0xe6, 0x39, 0xa3, 0x22, 0x88, 0xf0, 0x64, 0x6b, 0x85, 0xdb, 0x78, 0x64, 0xb4, 0x74, 0x9f, 0x6b, + 0x79, 0x4d, 0xca, 0x2e, 0x42, 0x93, 0xb2, 0x50, 0x94, 0x26, 0xda, 0x86, 0xa9, 0xa7, 0x6e, 0x03, + 0xd3, 0x33, 0x96, 0xa6, 0xdc, 0xb2, 0x1c, 0xca, 0x6d, 0xe0, 0x48, 0x82, 0x69, 0xc9, 0x89, 0xe8, + 0x08, 0xc6, 0x4f, 0x7c, 0xbb, 0xc9, 0xf2, 0xb0, 0xb9, 0xc2, 0x77, 0x38, 0x47, 0x51, 0xeb, 0xa3, + 0x49, 0x3d, 0x9d, 0x58, 0x5a, 0x24, 0x2e, 0xa4, 0x4b, 0x7e, 0x54, 0x5d, 0x08, 0x1d, 0x43, 0x5f, + 0x02, 0x70, 0xae, 0x8a, 0x9d, 0x0e, 0x4f, 0xc9, 0x16, 0x74, 0x21, 0x8b, 0x9d, 0x4e, 0x69, 0x83, + 0xcb, 0xb7, 0x22, 0xe5, 0xb3, 0x3b, 0x1d, 0x85, 0x9a, 0x42, 0xc4, 0xdc, 0x81, 0xb4, 0x5c, 0x1b, + 0x4d, 0xc2, 0x68, 0xb1, 0xd5, 0xca, 0x8c, 0x90, 0x1f, 0x2a, 0x95, 0x83, 0x8c, 0x81, 0xe6, 0x00, + 0x42, 0x85, 0x67, 0x52, 0x68, 0x06, 0xa6, 0x84, 0x42, 0x32, 0xa3, 0x74, 0x7e, 0xa7, 0x93, 0x19, + 0x33, 0xff, 0xcd, 0x18, 0xd8, 0x03, 0xe2, 0xc3, 0x2a, 0xec, 0x3a, 0x4a, 0x55, 0xc6, 0x1c, 0x1d, + 0xf5, 0x61, 0xfc, 0x96, 0x4a, 0xb5, 0x66, 0xa9, 0x93, 0xc8, 0xb1, 0x3a, 0x26, 0xd2, 0xd4, 0xdd, + 0x96, 0x7a, 0xac, 0x3a, 0x1c, 0x66, 0xc9, 0x51, 0x54, 0x50, 0x0e, 0xe0, 0x68, 0xe8, 0x84, 0xc4, + 0x01, 0x54, 0x37, 0x43, 0x1e, 0xc5, 0x42, 0xc8, 0x3c, 0x3f, 0x37, 0x14, 0x27, 0x66, 0xf3, 0xe5, + 0x3c, 0xf3, 0xd7, 0x86, 0xaa, 0x73, 0xe9, 0x64, 0x8d, 0x58, 0x27, 0xfb, 0x3e, 0xa4, 0x79, 0x9c, + 0x3c, 0xdc, 0xe1, 0xfc, 0x53, 0x1f, 0x22, 0x42, 0xac, 0xd3, 0xb0, 0xc2, 0x09, 0x68, 0x0b, 0x80, + 0x39, 0x94, 0x62, 0xa3, 0xe1, 0x71, 0x21, 0xe6, 0xfb, 0xbd, 0xfc, 0x34, 0x77, 0x39, 0x76, 0xa3, + 0xe1, 0x59, 0xca, 0x14, 0xa2, 0x51, 0xf5, 0xfa, 0x33, 0x16, 0x6a, 0x54, 0xbd, 0xe8, 0x68, 0x97, + 0x1b, 0xb3, 0x05, 0x73, 0xfb, 0x38, 0x20, 0x2a, 0x10, 0x8e, 0x6e, 0xb8, 0x08, 0x3f, 0x81, 0xe9, + 0xe7, 0x4e, 0x70, 0xae, 0x47, 0x1e, 0x7a, 0x99, 0x7a, 0xe9, 0x04, 0xe7, 0x22, 0xf2, 0x28, 0xaa, + 0x52, 0xa7, 0x9b, 0xbb, 0x30, 0xcf, 0x57, 0x93, 0x7e, 0xb5, 0xa0, 0x13, 0x34, 0xc2, 0x50, 0xa6, + 0x12, 0xd4, 0xc9, 0xe0, 0xa8, 0xa3, 0x41, 0x95, 0x01, 0xd7, 0xc3, 0xc2, 0x70, 0x52, 0x02, 0x4e, + 0x4f, 0x51, 0xc4, 0x25, 0x45, 0x1d, 0x91, 0x79, 0x02, 0xb3, 0xc7, 0xad, 0x6e, 0xd3, 0x69, 0x93, + 0xdd, 0xae, 0xe0, 0xaf, 0xd1, 0x0e, 0x40, 0x08, 0xe0, 0x2b, 0x88, 0xac, 0x33, 0x1c, 0xa8, 0x6d, + 0xf3, 0x6d, 0xa2, 0x10, 0xea, 0x3b, 0x2c, 0x05, 0xcf, 0xfc, 0xf3, 0x51, 0x40, 0x7c, 0x0d, 0x72, + 0x3f, 0xc6, 0x15, 0x1c, 0x10, 0x37, 0xb5, 0x02, 0xa9, 0xc3, 0x1d, 0xae, 0xf5, 0x89, 0x7e, 0x2f, + 0x9f, 0x72, 0x1a, 0x56, 0xea, 0x70, 0x07, 0x7d, 0x08, 0xe3, 0x74, 0x1a, 0xd5, 0xf5, 0x9c, 0x5c, + 0x4f, 0xa5, 0x50, 0x4a, 0xf7, 0x7b, 0xf9, 0x71, 0x72, 0x0f, 0xc7, 0x16, 0x9b, 0x8c, 0x3e, 0x82, + 0xf4, 0x0e, 0x6e, 0xe1, 0xa6, 0x1d, 0xb8, 0xc2, 0x76, 0xa8, 0x3b, 0x6a, 0x08, 0xa0, 0xb2, 0x45, + 0xe1, 0x4c, 0x12, 0x38, 0x2c, 0x6c, 0xfb, 0x6e, 0x5b, 0x0d, 0x1c, 0x1e, 0x85, 0xa8, 0x81, 0x83, + 0xcd, 0x41, 0x7f, 0x6d, 0xc0, 0x74, 0xb1, 0xdd, 0x76, 0x59, 0x79, 0xc5, 0xe7, 0xf7, 0xf9, 0xe5, + 0x4d, 0x59, 0x8e, 0x39, 0xb2, 0xcf, 0x70, 0xab, 0x46, 0x62, 0xb5, 0x5f, 0xfa, 0x8a, 0x78, 0x9d, + 0x7f, 0xef, 0xe5, 0x1f, 0xbe, 0x4e, 0x85, 0x67, 0xb3, 0xea, 0xd9, 0x4e, 0xe0, 0xd3, 0xeb, 0x4d, + 0xb8, 0xa0, 0x6a, 0x66, 0x0a, 0x1f, 0xe8, 0x5d, 0x18, 0x27, 0x37, 0x5d, 0x11, 0x7f, 0xe8, 0x66, + 0x93, 0xcb, 0xb0, 0x96, 0x75, 0xd1, 0x19, 0xe6, 0x7d, 0x48, 0x73, 0x4d, 0x1e, 0xee, 0x24, 0x6d, + 0x81, 0xf9, 0x04, 0xde, 0xb1, 0x5c, 0xaa, 0x5d, 0xec, 0xe3, 0xe0, 0xd8, 0xf6, 0xfd, 0x97, 0xae, + 0xd7, 0xa0, 0xd9, 0x3e, 0x37, 0x49, 0x61, 0xcd, 0xf7, 0x61, 0x92, 0x82, 0x25, 0x19, 0xba, 0x33, + 0xf4, 0xb6, 0x60, 0x89, 0x11, 0xb3, 0x0c, 0xeb, 0xfb, 0x38, 0x18, 0xa4, 0x75, 0x2b, 0x22, 0xbf, + 0x30, 0x20, 0x5f, 0xf6, 0x70, 0x2c, 0x53, 0x37, 0x3b, 0xca, 0xeb, 0xbc, 0xb4, 0x95, 0x0a, 0x47, + 0x89, 0xd2, 0x79, 0xf9, 0xea, 0x7b, 0x30, 0x5a, 0xad, 0x1e, 0x51, 0xd3, 0x19, 0xa5, 0x1a, 0x1c, + 0x0d, 0x82, 0xd6, 0x7f, 0xf5, 0xf2, 0x53, 0x3b, 0x5d, 0x56, 0xfa, 0xb2, 0xc8, 0xb8, 0x39, 0x0b, + 0xd3, 0xc7, 0x4e, 0xbb, 0xc9, 0x57, 0x34, 0xff, 0x22, 0x05, 0x33, 0xec, 0xdb, 0xef, 0xb8, 0x6d, + 0xe6, 0xe5, 0x55, 0x9f, 0x64, 0xdc, 0xc0, 0x27, 0xa1, 0x4f, 0x60, 0x96, 0xdf, 0x0c, 0xb1, 0x47, + 0xef, 0x77, 0x8c, 0x43, 0x5a, 0xd3, 0x60, 0x77, 0xc3, 0xd3, 0x2b, 0x36, 0x62, 0xe9, 0x13, 0xd1, + 0x11, 0xcc, 0x31, 0xc0, 0x1e, 0xb6, 0x83, 0x6e, 0x98, 0x53, 0xcd, 0xf3, 0x20, 0x28, 0xc0, 0xcc, + 0x24, 0x38, 0xad, 0x17, 0x1c, 0x68, 0x45, 0x70, 0xd1, 0x23, 0x98, 0x3f, 0xf6, 0xdc, 0x6f, 0x5e, + 0x29, 0x5e, 0x98, 0x9d, 0x8a, 0x65, 0x92, 0x82, 0x75, 0xc8, 0xd0, 0xa9, 0xea, 0x8b, 0xa3, 0xb3, + 0xcd, 0xdf, 0xa6, 0x60, 0x4a, 0x52, 0xdb, 0x54, 0x43, 0x25, 0xf7, 0x73, 0xd4, 0xfb, 0x87, 0xf9, + 0x8c, 0xa5, 0xcc, 0x40, 0x77, 0x68, 0xf0, 0xe4, 0x1e, 0x76, 0x92, 0x6c, 0x80, 0xdd, 0xe9, 0x58, + 0x04, 0x46, 0xec, 0x74, 0xa7, 0x44, 0x45, 0x9b, 0x62, 0x76, 0xda, 0x38, 0xb3, 0x52, 0x3b, 0x25, + 0xb2, 0xa3, 0xcf, 0x0e, 0x77, 0xca, 0x94, 0xcb, 0x29, 0xb6, 0xa3, 0xae, 0xd3, 0xa8, 0x5b, 0x14, + 0x4a, 0x46, 0x2b, 0xc5, 0x27, 0x47, 0xf4, 0x94, 0xf2, 0x51, 0xdf, 0xbe, 0x6c, 0x59, 0x14, 0x8a, + 0x1e, 0x0a, 0x0f, 0x5a, 0x76, 0xdb, 0x81, 0xe7, 0xb6, 0x7c, 0x5a, 0x3e, 0x9b, 0xd2, 0x3c, 0x65, + 0x9d, 0x0f, 0x59, 0x91, 0xa9, 0xe8, 0x39, 0xac, 0x16, 0x1b, 0x57, 0x76, 0xbb, 0x8e, 0x1b, 0x6c, + 0xe4, 0xb9, 0xeb, 0x5d, 0xbc, 0x68, 0xb9, 0x2f, 0x7d, 0x9a, 0xb8, 0x4d, 0xf1, 0x14, 0x90, 0x4f, + 0x39, 0xe5, 0xe4, 0x5e, 0x8a, 0x49, 0x56, 0x12, 0x36, 0xca, 0xc3, 0x78, 0xb9, 0xe5, 0x76, 0x1b, + 0x34, 0x63, 0x9b, 0x62, 0x07, 0xa1, 0x4e, 0x00, 0x16, 0x83, 0x9b, 0x3f, 0x82, 0x05, 0xe2, 0xbd, + 0x02, 0x7c, 0xe3, 0x10, 0x66, 0x1e, 0x03, 0x54, 0xf0, 0xa5, 0xdd, 0x39, 0x77, 0xc9, 0xb6, 0x94, + 0xd4, 0x2f, 0xee, 0xd3, 0x91, 0xbc, 0x18, 0xf3, 0x81, 0xda, 0xb6, 0x08, 0xd4, 0x62, 0xa6, 0xa5, + 0x60, 0x99, 0xff, 0x92, 0x02, 0x44, 0x2f, 0x88, 0x95, 0xc0, 0xc3, 0xf6, 0xa5, 0x60, 0xe3, 0xc7, + 0x30, 0xc3, 0x4e, 0x28, 0x03, 0x53, 0x76, 0x48, 0xc0, 0x60, 0xb6, 0xa8, 0x0e, 0x1d, 0x8c, 0x58, + 0xda, 0x54, 0x82, 0x6a, 0x61, 0xbf, 0x7b, 0x29, 0x50, 0x53, 0x1a, 0xaa, 0x3a, 0x44, 0x50, 0xd5, + 0x6f, 0xf4, 0x08, 0xe6, 0xca, 0xee, 0x65, 0x87, 0xe8, 0x84, 0x23, 0x8f, 0x72, 0xb7, 0xcc, 0xd7, + 0xd5, 0x06, 0xc9, 0x8d, 0x5a, 0x87, 0xa0, 0xa7, 0xb0, 0xb8, 0xd7, 0xea, 0xfa, 0xe7, 0xc5, 0x76, + 0xa3, 0xdc, 0x72, 0x7d, 0x41, 0x65, 0x8c, 0xdf, 0x4e, 0xf8, 0x49, 0x1a, 0x9c, 0x71, 0x30, 0x62, + 0xc5, 0x21, 0xa2, 0xef, 0xf1, 0x5a, 0x3a, 0x0f, 0x0f, 0xb3, 0x9b, 0xbc, 0xd4, 0xfe, 0xac, 0x8d, + 0x9f, 0xbd, 0x38, 0x18, 0xb1, 0xd8, 0x68, 0x29, 0x0d, 0x93, 0xc2, 0x8b, 0x6c, 0xc1, 0x82, 0xa2, + 0x4e, 0x12, 0xd0, 0xba, 0x3e, 0xca, 0xc1, 0xd4, 0x49, 0x87, 0x5c, 0x6f, 0x85, 0x5b, 0xb4, 0xe4, + 0xb7, 0xf9, 0xbe, 0xae, 0x69, 0xb4, 0xae, 0x26, 0x5a, 0x6c, 0x72, 0x08, 0x30, 0x0f, 0x74, 0xe5, + 0x0e, 0x9f, 0xad, 0xad, 0x9b, 0x8a, 0xac, 0x9b, 0x89, 0xea, 0xda, 0x5c, 0x8e, 0x55, 0x9e, 0xf9, + 0xc7, 0x06, 0x2c, 0xed, 0xe3, 0x80, 0x56, 0xe0, 0x88, 0x8f, 0x91, 0x01, 0xe3, 0x07, 0x6a, 0x31, + 0x96, 0xd9, 0xeb, 0x6c, 0xbf, 0x97, 0x4f, 0xcb, 0xd2, 0xab, 0x5a, 0x6e, 0xfd, 0x0c, 0xe6, 0x2a, + 0x17, 0x4e, 0xa7, 0x66, 0xb7, 0x9c, 0x06, 0xf5, 0xc1, 0xdc, 0x3b, 0x2c, 0x53, 0x6f, 0x76, 0xe1, + 0x74, 0x4e, 0xaf, 0xc2, 0x21, 0xc3, 0x8a, 0x4c, 0x36, 0x9f, 0xc1, 0x72, 0x84, 0x07, 0xee, 0xa4, + 0xff, 0x1f, 0x4c, 0x72, 0x10, 0x3f, 0x00, 0x03, 0x75, 0xdc, 0xe9, 0x7e, 0x2f, 0x3f, 0xe9, 0x73, + 0x34, 0x31, 0xd9, 0x7c, 0x02, 0x2b, 0x27, 0x1d, 0x1f, 0x7b, 0x21, 0x4d, 0x21, 0xd6, 0xb6, 0x2c, + 0x0c, 0x1b, 0xf1, 0x85, 0x61, 0xe8, 0xf7, 0xf2, 0x13, 0x8c, 0xa0, 0x28, 0x06, 0x9b, 0x75, 0x58, + 0x61, 0x67, 0x79, 0x80, 0xdc, 0xad, 0xb4, 0x24, 0x4e, 0x7f, 0x2a, 0xf6, 0xf4, 0x1f, 0x42, 0x8e, + 0x2f, 0xd2, 0x6a, 0xbd, 0xd9, 0x76, 0x98, 0xff, 0x6c, 0xc0, 0xea, 0x3e, 0x6e, 0x63, 0xcf, 0xa6, + 0x2c, 0x6b, 0xa1, 0x57, 0x2d, 0x00, 0x18, 0x43, 0x0b, 0x00, 0x79, 0x91, 0xac, 0xa4, 0x68, 0xb2, + 0x42, 0x5d, 0x1c, 0x4d, 0x56, 0x78, 0x8a, 0x42, 0x02, 0xc1, 0x89, 0x75, 0xc8, 0x93, 0x38, 0x1a, + 0x08, 0xba, 0x9e, 0x63, 0x11, 0x18, 0x3a, 0x0c, 0x8b, 0x07, 0x63, 0xd7, 0x16, 0x0f, 0x16, 0xf9, + 0xb5, 0x6f, 0x92, 0x17, 0x0f, 0xb4, 0x92, 0x81, 0xf9, 0x10, 0xb2, 0x83, 0xb2, 0x70, 0xfb, 0xc8, + 0xc3, 0x38, 0x2b, 0x8c, 0x0e, 0xa4, 0x23, 0x0c, 0x6e, 0xee, 0x84, 0xd6, 0xcd, 0xcb, 0x80, 0xb2, + 0x68, 0x12, 0x39, 0x59, 0x43, 0x2e, 0x3c, 0x66, 0x25, 0xb4, 0x4f, 0x4e, 0x85, 0xaf, 0xff, 0x29, + 0xb1, 0x4f, 0x56, 0xea, 0x35, 0x92, 0x4b, 0xbd, 0xdc, 0x46, 0x19, 0xaa, 0x40, 0x30, 0x9f, 0xc3, + 0x8a, 0x46, 0x34, 0xb4, 0xfa, 0xcf, 0x60, 0x4a, 0xc0, 0x22, 0xb9, 0xbc, 0x46, 0x96, 0xee, 0x9b, + 0x2f, 0x90, 0x25, 0x8a, 0xf9, 0x2b, 0x03, 0x56, 0x99, 0xd3, 0x19, 0x94, 0xfb, 0xe6, 0xbb, 0xff, + 0xbf, 0x71, 0xc9, 0xfb, 0x62, 0x6c, 0x2a, 0x95, 0x19, 0x35, 0x6b, 0x90, 0x1d, 0xe4, 0xf7, 0x2d, + 0x68, 0x78, 0x1f, 0x56, 0x95, 0x63, 0xfb, 0xc6, 0xfb, 0x1f, 0xae, 0xf8, 0x16, 0xf7, 0x3f, 0x9c, + 0xf8, 0xd6, 0xf6, 0xff, 0x10, 0x16, 0x19, 0x61, 0xfd, 0xac, 0x14, 0xd4, 0xb3, 0x12, 0xfb, 0x88, + 0x30, 0x78, 0x7c, 0x9e, 0xd0, 0xe3, 0x23, 0xa6, 0x84, 0x1c, 0x7e, 0x04, 0x13, 0xfc, 0x15, 0x96, + 0xf1, 0x17, 0x43, 0x8c, 0xfa, 0x51, 0xf6, 0xf4, 0x6a, 0xf1, 0xc9, 0x66, 0x96, 0x8a, 0x4c, 0x52, + 0x49, 0x5e, 0x3b, 0x11, 0xee, 0xcd, 0xfc, 0x92, 0x38, 0xac, 0xc8, 0xc8, 0x1b, 0xc6, 0x80, 0x67, + 0x90, 0x65, 0x31, 0x40, 0xa1, 0xfa, 0x46, 0x51, 0xe0, 0x13, 0xc8, 0x32, 0x73, 0x8a, 0x21, 0x38, + 0xdc, 0xb5, 0x6f, 0xc0, 0xba, 0x74, 0xed, 0x71, 0xd2, 0xff, 0xa9, 0x01, 0x77, 0xf6, 0x71, 0xa0, + 0x3f, 0x25, 0xfd, 0x9f, 0x44, 0xe2, 0xaf, 0x20, 0x17, 0xc7, 0x08, 0xdf, 0x8a, 0xcf, 0xa3, 0x5b, + 0x91, 0xf8, 0x6e, 0x16, 0xbf, 0x25, 0x3f, 0x87, 0x35, 0xb6, 0x25, 0xfa, 0x7c, 0x21, 0xe8, 0xc3, + 0xc8, 0xae, 0x24, 0x52, 0x8f, 0xdb, 0x9d, 0xbf, 0x34, 0x60, 0x8d, 0x29, 0x39, 0x9e, 0xf8, 0xad, + 0xb4, 0x78, 0x1f, 0x26, 0x0e, 0x5c, 0x72, 0xf3, 0xe6, 0x1b, 0x4a, 0xc5, 0x39, 0x77, 0xfd, 0x80, + 0x38, 0x06, 0x3e, 0x34, 0xfc, 0xdd, 0xc2, 0x7c, 0x0a, 0x79, 0xb9, 0xe7, 0x6f, 0x61, 0x63, 0xcd, + 0x3a, 0x20, 0x41, 0xa6, 0x5c, 0xb1, 0x04, 0x89, 0x3b, 0x30, 0x5a, 0xae, 0x58, 0xbc, 0xec, 0x4f, + 0x43, 0x70, 0xdd, 0xf7, 0x2c, 0x02, 0x8b, 0xfa, 0xe3, 0xd4, 0x4d, 0x8a, 0x6e, 0xbf, 0x07, 0x8b, + 0xda, 0x22, 0x7c, 0xdf, 0xd7, 0x61, 0xac, 0x8c, 0xbd, 0x80, 0x2f, 0x43, 0x25, 0xad, 0x63, 0x2f, + 0xb0, 0x28, 0x14, 0xbd, 0x03, 0x93, 0xe5, 0x22, 0x2d, 0x0a, 0xd3, 0x4c, 0x61, 0x86, 0x39, 0xa6, + 0xba, 0x7d, 0x5a, 0xa7, 0x85, 0x62, 0x31, 0x68, 0xfe, 0x99, 0xa1, 0x50, 0x27, 0xe8, 0xd7, 0xcb, + 0xb0, 0x45, 0xee, 0x40, 0x44, 0x67, 0x8a, 0x08, 0x34, 0x08, 0xf1, 0x1b, 0x32, 0x95, 0x40, 0x99, + 0x72, 0xd3, 0xe2, 0xc0, 0x57, 0xb0, 0xa4, 0x73, 0xf2, 0x56, 0x05, 0xfd, 0x2e, 0x2d, 0x5d, 0x92, + 0x1c, 0x49, 0x88, 0x88, 0xd4, 0x7b, 0x1f, 0x37, 0x90, 0x8f, 0x21, 0xc3, 0x67, 0x85, 0x07, 0xec, + 0xbe, 0x48, 0xb9, 0xd8, 0xf1, 0xd2, 0x7b, 0x27, 0x44, 0x65, 0xe8, 0xfb, 0xe2, 0x66, 0x79, 0xdd, + 0x0a, 0x17, 0x90, 0x7d, 0xb2, 0x57, 0x2c, 0x76, 0x83, 0x73, 0xdc, 0x0e, 0x9c, 0xba, 0x1d, 0xe0, + 0xf2, 0xb9, 0xdd, 0x6a, 0xe1, 0x76, 0x93, 0x2a, 0xea, 0xa4, 0xb0, 0x27, 0xc3, 0x0b, 0xaf, 0xee, + 0x17, 0xf6, 0xe4, 0x0c, 0x8b, 0x8c, 0xa3, 0x07, 0x30, 0x56, 0x7d, 0x56, 0x3d, 0xe6, 0xd7, 0xbc, + 0x25, 0x3e, 0x8f, 0x80, 0xc2, 0x89, 0x74, 0x86, 0xf9, 0x0d, 0xac, 0x46, 0x16, 0x93, 0x52, 0xbd, + 0x23, 0xd6, 0x32, 0xe8, 0x15, 0x56, 0xae, 0x25, 0x26, 0x1c, 0x8c, 0xb0, 0xc5, 0xde, 0xd5, 0x16, + 0x5b, 0x54, 0x16, 0x53, 0x66, 0xd2, 0x29, 0xfc, 0xa5, 0x93, 0xc2, 0xcc, 0x3f, 0x80, 0x19, 0x95, + 0x71, 0x72, 0x6b, 0x7a, 0x8c, 0x5f, 0x1d, 0xd8, 0xed, 0x46, 0x4b, 0xe8, 0x23, 0x04, 0x90, 0x51, + 0x39, 0x95, 0x5f, 0x9b, 0x42, 0x00, 0x5a, 0x82, 0xf1, 0x62, 0xa7, 0x73, 0xb8, 0xc3, 0x0e, 0xb5, + 0xc5, 0x3e, 0x50, 0x16, 0x26, 0x45, 0xc5, 0x87, 0xa6, 0x35, 0x96, 0xf8, 0x34, 0x1d, 0x98, 0x56, + 0x04, 0xb9, 0x66, 0xe9, 0x0d, 0x80, 0x72, 0xcb, 0xc1, 0x6d, 0xea, 0xfe, 0xf8, 0xda, 0x0a, 0x84, + 0x5e, 0xf7, 0x9c, 0x66, 0x9b, 0x96, 0x65, 0x38, 0x03, 0x21, 0xc0, 0x9c, 0x87, 0x59, 0x4d, 0xef, + 0xa6, 0x09, 0x33, 0xaa, 0x6e, 0x88, 0x09, 0x94, 0xdd, 0x86, 0x34, 0x01, 0xf2, 0xb3, 0xf9, 0x4b, + 0x03, 0x96, 0x9e, 0xec, 0x15, 0x2d, 0xdc, 0x74, 0x68, 0x6b, 0x8f, 0x14, 0x74, 0x4b, 0xdd, 0x93, + 0x35, 0x75, 0x4f, 0x22, 0x33, 0xc5, 0xe6, 0x14, 0xb4, 0xcd, 0x59, 0xd7, 0x36, 0x67, 0x10, 0x85, + 0xed, 0x92, 0x72, 0x73, 0xfe, 0x85, 0x01, 0x8b, 0x0a, 0x23, 0x92, 0xe9, 0x4d, 0x95, 0x8f, 0xdc, + 0x20, 0x1f, 0x51, 0x1b, 0xf9, 0x91, 0xc6, 0xc6, 0x5a, 0x0c, 0x1b, 0x43, 0x6d, 0xa5, 0x01, 0x4b, + 0x71, 0x42, 0xea, 0x56, 0x61, 0x24, 0x5a, 0x45, 0x2a, 0xc1, 0x2a, 0x46, 0x75, 0xab, 0xb0, 0x61, + 0x31, 0x46, 0x04, 0xf4, 0x1e, 0x64, 0x18, 0x8c, 0xb9, 0x22, 0x5e, 0xab, 0x27, 0x98, 0x03, 0xf0, + 0xeb, 0x6c, 0xc5, 0xfc, 0xb5, 0x01, 0xcb, 0xb1, 0xca, 0x47, 0x2b, 0x24, 0x8a, 0xd6, 0x3d, 0x1c, + 0x70, 0xda, 0xfc, 0x8b, 0xc0, 0x0f, 0x7d, 0xbf, 0xcb, 0xdb, 0xfd, 0xd2, 0x16, 0xff, 0x42, 0xdf, + 0x85, 0xd9, 0x63, 0xec, 0x39, 0x6e, 0xa3, 0x82, 0xeb, 0x6e, 0xbb, 0xc1, 0x2a, 0x93, 0xb3, 0x96, + 0x0e, 0x24, 0x0a, 0x2a, 0xb6, 0x9a, 0xae, 0xe7, 0x04, 0xe7, 0x97, 0xfc, 0x10, 0x84, 0x00, 0x42, + 0x7b, 0xc7, 0x69, 0x3a, 0x01, 0xab, 0xb4, 0xcf, 0x5a, 0xfc, 0x8b, 0xa8, 0xa8, 0x58, 0xaf, 0xbb, + 0xdd, 0x76, 0x40, 0x8b, 0x76, 0x69, 0x4b, 0x7c, 0x9a, 0xef, 0xc1, 0x52, 0xdc, 0xa6, 0xc5, 0x1a, + 0xf1, 0x1f, 0xa6, 0x60, 0xb1, 0xd8, 0x68, 0x3c, 0xd9, 0x2b, 0xee, 0x60, 0x35, 0xe9, 0xfa, 0x10, + 0xc6, 0x0e, 0xdb, 0x4e, 0xc0, 0x8d, 0x67, 0x83, 0xdb, 0x42, 0xcc, 0x4c, 0x32, 0x8b, 0x98, 0x03, + 0xf9, 0x1f, 0x59, 0xb0, 0xb8, 0xfb, 0x8d, 0xe3, 0x07, 0x4e, 0xbb, 0x49, 0x0d, 0x92, 0x2d, 0xcc, + 0x0d, 0x4a, 0x10, 0x49, 0x70, 0x65, 0x07, 0x23, 0x56, 0x1c, 0x32, 0xaa, 0xc2, 0xca, 0x53, 0xfc, + 0x32, 0xc6, 0xbe, 0xe5, 0xd3, 0xb9, 0x24, 0x1b, 0x63, 0xa6, 0x09, 0xb8, 0xea, 0xf1, 0xf9, 0x65, + 0x0a, 0x96, 0x74, 0xc1, 0xf8, 0xca, 0x27, 0xb0, 0xa4, 0x30, 0xa4, 0xdb, 0xf0, 0x74, 0x21, 0x1f, + 0x2f, 0x8e, 0x7a, 0x52, 0x63, 0xd1, 0xd1, 0x73, 0x58, 0xd5, 0x99, 0xd2, 0x7d, 0x66, 0x78, 0xf2, + 0xe2, 0xa6, 0x1c, 0x8c, 0x58, 0x49, 0xd8, 0xa8, 0x00, 0xa3, 0xc5, 0xfa, 0x05, 0x57, 0x4b, 0xfc, + 0x96, 0x31, 0xc9, 0x8a, 0xf5, 0x0b, 0x72, 0xe6, 0x8b, 0xf5, 0x0b, 0xed, 0x00, 0xff, 0x8d, 0x01, + 0xab, 0x09, 0x3b, 0x4c, 0xce, 0x0c, 0x03, 0x2a, 0x91, 0x50, 0x81, 0xa0, 0xcf, 0x94, 0x77, 0x85, + 0xb9, 0xc2, 0xbb, 0xc3, 0xed, 0x65, 0x93, 0x41, 0xaa, 0xf2, 0xe1, 0xc1, 0xcc, 0x0b, 0xf2, 0xf4, + 0x19, 0x62, 0x8a, 0x39, 0x22, 0xf6, 0xe6, 0x7c, 0x52, 0xd8, 0xcb, 0x18, 0x66, 0x39, 0xca, 0x9a, + 0x94, 0x04, 0x3d, 0x80, 0x09, 0x06, 0xe4, 0x1b, 0x23, 0xfa, 0x1a, 0xc3, 0xc9, 0x7c, 0xdc, 0xfc, + 0x3b, 0x43, 0x14, 0x9b, 0x06, 0xec, 0xfd, 0x63, 0xcd, 0xde, 0xc5, 0x93, 0x7c, 0xfc, 0x64, 0xcd, + 0xe4, 0x4b, 0x30, 0xfd, 0x3a, 0xa6, 0xae, 0x22, 0xa9, 0xc6, 0xf8, 0xf7, 0x86, 0xb8, 0x58, 0x0f, + 0xda, 0xe3, 0x2e, 0xcc, 0xbc, 0x9e, 0x1d, 0x6a, 0x68, 0xe8, 0x23, 0x66, 0x26, 0xa9, 0xe1, 0x92, + 0x0e, 0xb5, 0x94, 0x9f, 0x88, 0x7a, 0xda, 0xeb, 0xd8, 0x8a, 0xb9, 0x1e, 0x83, 0x2d, 0x97, 0x33, + 0x57, 0xe8, 0xbd, 0x58, 0x0e, 0xc9, 0x8b, 0x5c, 0x99, 0x16, 0x0a, 0x54, 0xb8, 0x74, 0xfd, 0x93, + 0x1c, 0x24, 0xdb, 0xb0, 0xa2, 0x06, 0x20, 0x26, 0x10, 0x13, 0xbf, 0x73, 0xe2, 0x63, 0xaf, 0xe2, + 0xb4, 0x9b, 0x2d, 0x7c, 0xc2, 0x52, 0x54, 0x79, 0x69, 0xf8, 0xa1, 0x66, 0x04, 0xab, 0x09, 0x7d, + 0x19, 0xff, 0x53, 0x5b, 0xff, 0xb7, 0x06, 0xe4, 0xe2, 0x78, 0x7b, 0xbb, 0xbb, 0xbf, 0xc9, 0xd3, + 0x70, 0xc6, 0x6d, 0x96, 0xa3, 0xcb, 0x35, 0x85, 0xb0, 0x44, 0x48, 0xf2, 0xbf, 0xb6, 0xed, 0xbf, + 0x32, 0x60, 0xe9, 0xd0, 0xa7, 0xec, 0x7f, 0xdd, 0x75, 0x3c, 0xdc, 0x10, 0x8a, 0xdb, 0x8c, 0xeb, + 0xde, 0xa1, 0x1b, 0x7f, 0x30, 0x12, 0xd7, 0x9d, 0xf3, 0xa1, 0xd2, 0x74, 0x91, 0x1a, 0xd6, 0x96, + 0x73, 0x30, 0x12, 0xb6, 0x5d, 0xa0, 0x77, 0x60, 0xec, 0x29, 0x89, 0x5f, 0xa3, 0xfc, 0x98, 0x33, + 0x0c, 0x02, 0x3a, 0x72, 0x9b, 0x4e, 0x9b, 0xb0, 0x4c, 0x3e, 0x4a, 0x53, 0x30, 0x51, 0xb5, 0xbd, + 0x26, 0x0e, 0xcc, 0x8f, 0x20, 0x2d, 0x87, 0x69, 0x1a, 0xaf, 0x84, 0x3f, 0xf2, 0x33, 0xc9, 0x3e, + 0xe8, 0xa0, 0xc8, 0x3e, 0xe8, 0x87, 0xb9, 0x0d, 0xcb, 0x11, 0x31, 0xf9, 0x1e, 0xe4, 0x88, 0x32, + 0x18, 0x8c, 0x3d, 0xe6, 0x59, 0xf2, 0xdb, 0x2c, 0xc3, 0xc2, 0x80, 0x16, 0x11, 0x52, 0xfa, 0xd3, + 0xc8, 0x41, 0xaa, 0x54, 0x0e, 0x08, 0x4c, 0xb6, 0xa3, 0x11, 0x58, 0xf5, 0xa8, 0x52, 0x9a, 0x60, + 0xbb, 0x42, 0x62, 0x11, 0xb9, 0xb9, 0xd0, 0xc7, 0x11, 0x3f, 0x2c, 0x80, 0x44, 0xef, 0xb2, 0xea, + 0x7d, 0xba, 0x04, 0xe9, 0x4a, 0x60, 0xd3, 0x7b, 0xbf, 0x50, 0xe6, 0xb0, 0x82, 0xf0, 0xd4, 0xb7, + 0xbd, 0xfc, 0x08, 0xad, 0x02, 0x87, 0x68, 0xe8, 0x73, 0x98, 0xdc, 0x6d, 0x37, 0x28, 0x85, 0xd1, + 0x5b, 0x50, 0x10, 0x48, 0xe4, 0xc4, 0x53, 0x96, 0x89, 0xf7, 0xf6, 0x69, 0x33, 0x61, 0xda, 0x52, + 0x20, 0x54, 0xcd, 0xce, 0xa5, 0xc3, 0x5e, 0x83, 0xc6, 0x2d, 0xf6, 0x41, 0xb4, 0x49, 0x59, 0x78, + 0x8c, 0x5f, 0xf1, 0x14, 0x46, 0x7e, 0x9b, 0xbf, 0xa1, 0x65, 0xf6, 0x80, 0x17, 0xde, 0x74, 0x7d, + 0x68, 0x12, 0x1b, 0x6f, 0x2c, 0x71, 0xea, 0x75, 0x24, 0x96, 0x12, 0x8d, 0x26, 0x49, 0x34, 0x16, + 0x91, 0x68, 0x1f, 0x26, 0x98, 0x18, 0xe4, 0x26, 0x7a, 0x18, 0xe0, 0xcb, 0xf0, 0x26, 0xaa, 0xbe, + 0x8d, 0x59, 0x6c, 0x8c, 0xa4, 0x77, 0x47, 0xb6, 0x4f, 0x29, 0x31, 0xdb, 0x14, 0x9f, 0xe6, 0x19, + 0x64, 0x8e, 0x1c, 0x3f, 0x20, 0xf6, 0x7b, 0x43, 0x13, 0x91, 0xcc, 0xa6, 0x92, 0x98, 0x1d, 0x8d, + 0x30, 0xfb, 0x53, 0x58, 0x50, 0xd6, 0xe0, 0xd6, 0xff, 0xee, 0x75, 0xd5, 0x42, 0x59, 0x8d, 0x22, + 0xdc, 0x3f, 0xc5, 0xdf, 0xa8, 0xdc, 0xf3, 0xcf, 0xf7, 0xde, 0x83, 0xb4, 0xfc, 0x45, 0x1a, 0x12, + 0xe8, 0x0f, 0x9f, 0x1e, 0x56, 0x59, 0xa0, 0x3f, 0x3e, 0xa9, 0x66, 0x0c, 0x04, 0x30, 0xb1, 0xb3, + 0x7b, 0xb4, 0x5b, 0xdd, 0xcd, 0xa4, 0x0a, 0xff, 0xf4, 0x10, 0xa6, 0x89, 0x57, 0xe3, 0x35, 0x3d, + 0xf4, 0x13, 0x98, 0xab, 0xe0, 0x76, 0xe3, 0x31, 0xc6, 0x9d, 0x62, 0xcb, 0xb9, 0xc2, 0x3e, 0x12, + 0xae, 0x5e, 0x82, 0x72, 0x2b, 0x03, 0xfb, 0xb8, 0x7b, 0xd9, 0x09, 0x5e, 0x3d, 0x30, 0xd0, 0x0f, + 0x60, 0x9a, 0x36, 0xb6, 0xf2, 0x5d, 0x98, 0x51, 0x9b, 0x5d, 0x73, 0xe2, 0x8b, 0x0e, 0x7e, 0x60, + 0xa0, 0xcf, 0x60, 0x72, 0x1f, 0x53, 0xf9, 0xd1, 0x77, 0x22, 0xbf, 0xbb, 0x73, 0xd8, 0x96, 0x9a, + 0xe5, 0xea, 0xcf, 0x45, 0x15, 0x81, 0xca, 0x30, 0xc5, 0xd1, 0x7d, 0x64, 0x46, 0xf0, 0xfd, 0x18, + 0x02, 0x8b, 0x11, 0x02, 0x44, 0xf9, 0xe8, 0x73, 0x48, 0xcb, 0x4d, 0x40, 0x22, 0x1a, 0x45, 0xb7, + 0x3e, 0x97, 0x1d, 0x1c, 0xe0, 0xfb, 0xb5, 0x05, 0xc0, 0x4a, 0x82, 0x54, 0x8c, 0x28, 0x8f, 0xb9, + 0x01, 0xdd, 0xa1, 0x7d, 0x12, 0xb8, 0x49, 0x60, 0xbe, 0xa9, 0xdc, 0x09, 0xca, 0x46, 0x47, 0x30, + 0x27, 0x0b, 0x74, 0x37, 0x57, 0x42, 0x12, 0xb5, 0x4f, 0x61, 0x41, 0xbc, 0x52, 0xc9, 0x58, 0x8c, + 0x92, 0xa2, 0xb3, 0xdc, 0x49, 0x36, 0x0d, 0x43, 0x4e, 0xc5, 0xd5, 0x63, 0x2b, 0xba, 0xa7, 0x10, + 0x89, 0x4d, 0x09, 0x72, 0xdf, 0x19, 0x32, 0x83, 0xa9, 0xf9, 0x81, 0xf1, 0x81, 0x81, 0xbe, 0x80, + 0x59, 0x2d, 0x62, 0x20, 0x91, 0xc3, 0xc7, 0x85, 0xcb, 0xdc, 0x7a, 0xfc, 0x20, 0xdf, 0xb6, 0x3d, + 0x22, 0x6e, 0x10, 0xe9, 0x75, 0xcb, 0xc5, 0xf5, 0xb4, 0xb1, 0xf6, 0xe9, 0x9c, 0x78, 0xe4, 0x8f, + 0xa0, 0xec, 0xc2, 0x22, 0x7f, 0xfa, 0xd1, 0x7e, 0xaf, 0x24, 0xa1, 0x3b, 0x2e, 0x51, 0xfb, 0x8f, + 0x60, 0x91, 0xef, 0xa5, 0x46, 0x26, 0x23, 0xdb, 0x12, 0x78, 0x23, 0x55, 0x22, 0x81, 0x2f, 0x60, + 0xb9, 0x12, 0x91, 0x87, 0xb5, 0xab, 0xdd, 0xd1, 0x49, 0x28, 0x7d, 0x71, 0x89, 0xb4, 0x1e, 0x03, + 0xaa, 0x74, 0xcf, 0x2e, 0x1d, 0x49, 0xee, 0xca, 0xc1, 0x2f, 0xd1, 0xdd, 0x88, 0x48, 0x04, 0x48, + 0xa7, 0xd1, 0xe0, 0x91, 0x4b, 0x90, 0x18, 0x55, 0xd9, 0xd3, 0x23, 0xeb, 0x6a, 0xb1, 0x3b, 0xf6, + 0x99, 0xd3, 0x72, 0x02, 0x07, 0x13, 0xb3, 0x50, 0x11, 0xd4, 0x21, 0xb1, 0x83, 0x77, 0x12, 0x67, + 0xa0, 0xcf, 0x61, 0x76, 0x1f, 0x07, 0x61, 0xeb, 0x1f, 0x5a, 0x1d, 0x68, 0x16, 0xe4, 0xfb, 0x26, + 0x4a, 0x7e, 0x7a, 0xbf, 0xe1, 0x21, 0x64, 0x4e, 0x3a, 0x0d, 0x3b, 0xc0, 0x0a, 0x89, 0xbb, 0x03, + 0x24, 0xf8, 0x14, 0xdb, 0xb3, 0x2f, 0xfd, 0x44, 0x6d, 0x6d, 0xc1, 0xd8, 0xb1, 0xd3, 0x6e, 0x22, + 0x51, 0x17, 0x54, 0x9a, 0xb6, 0x72, 0x8b, 0x1a, 0x8c, 0x9b, 0x5e, 0x00, 0xf9, 0x6b, 0x7a, 0xde, + 0xd0, 0x0f, 0x65, 0xa2, 0x76, 0x93, 0xde, 0xb8, 0x9c, 0x72, 0xee, 0xe3, 0x27, 0xd6, 0xb6, 0xd1, + 0xcf, 0xe8, 0x3e, 0x0c, 0xce, 0x40, 0xf7, 0xf9, 0x5a, 0xc3, 0x1a, 0xe7, 0x72, 0x6b, 0x89, 0x2b, + 0xd4, 0xb6, 0xd1, 0xa9, 0x78, 0xfe, 0x8c, 0xa1, 0xfe, 0x8e, 0xd6, 0x93, 0xf3, 0x9a, 0x0b, 0x6c, + 0xd1, 0x38, 0x41, 0x7f, 0x37, 0x6f, 0x39, 0xe4, 0x56, 0xe9, 0x4b, 0xca, 0xe9, 0xbf, 0xdd, 0x87, + 0xb6, 0x69, 0x64, 0xa0, 0xdd, 0xb0, 0x68, 0x45, 0xc7, 0xf0, 0xe3, 0x51, 0x3e, 0x30, 0xd0, 0x36, + 0x00, 0xe3, 0x92, 0x2e, 0xa4, 0x0f, 0x27, 0xee, 0xfe, 0x36, 0x71, 0xff, 0x8d, 0x5b, 0x22, 0x7d, + 0x2e, 0x42, 0x00, 0x45, 0xca, 0x6a, 0xb7, 0x43, 0x55, 0xaa, 0x24, 0xfc, 0x43, 0xc8, 0x14, 0xeb, + 0xd4, 0xa1, 0xc9, 0x56, 0x29, 0xb4, 0x21, 0x0f, 0x8b, 0x3e, 0x20, 0x68, 0x2d, 0x47, 0x3b, 0xaf, + 0x8e, 0x30, 0x49, 0xf7, 0x0f, 0x60, 0x55, 0x86, 0xa6, 0xc8, 0x50, 0x3c, 0x46, 0x22, 0x53, 0xbb, + 0xb0, 0x54, 0xb6, 0xdb, 0x75, 0xdc, 0x7a, 0x33, 0x32, 0x9f, 0xd2, 0x93, 0xad, 0xb4, 0x91, 0xad, + 0x44, 0xf1, 0xf9, 0xc1, 0x16, 0xed, 0xf7, 0xca, 0xd4, 0x22, 0xcc, 0x33, 0x25, 0x86, 0x6a, 0x49, + 0xc2, 0x4e, 0x5a, 0xfe, 0x63, 0x98, 0xdb, 0x25, 0x9e, 0xaf, 0xdb, 0x70, 0xd8, 0x05, 0x01, 0xe9, + 0x99, 0x63, 0x22, 0xe2, 0x01, 0x2c, 0xf0, 0x40, 0x10, 0xf6, 0x57, 0x49, 0xe7, 0x3b, 0xd8, 0xc2, + 0x96, 0x5b, 0x12, 0x64, 0xd5, 0x56, 0x2c, 0x11, 0xe6, 0xb4, 0x66, 0x22, 0x19, 0xe6, 0xe2, 0xda, + 0x9c, 0x64, 0x98, 0x8b, 0xef, 0x3f, 0x2a, 0xc1, 0x7c, 0xa4, 0x8f, 0x08, 0xdd, 0x15, 0xc1, 0x36, + 0xb6, 0xbf, 0x28, 0x26, 0x61, 0x39, 0x10, 0x5a, 0x1d, 0xa4, 0x11, 0xdf, 0x54, 0x94, 0xa8, 0xa3, + 0x63, 0x19, 0xe5, 0xd4, 0x0e, 0x21, 0xa4, 0x97, 0x47, 0xe2, 0xba, 0x87, 0x12, 0x29, 0x56, 0xc8, + 0x4d, 0x4e, 0xef, 0xad, 0x41, 0x1b, 0x52, 0x23, 0xb1, 0x0d, 0x44, 0xb9, 0x7c, 0xe2, 0x38, 0x57, + 0x9a, 0xb2, 0x01, 0xec, 0x37, 0x18, 0xa3, 0x1b, 0xa0, 0x76, 0x62, 0x0c, 0x6c, 0x80, 0xde, 0x60, + 0xb1, 0x4f, 0x9f, 0xd2, 0x94, 0x26, 0x19, 0x94, 0x20, 0x4a, 0xee, 0x6e, 0x1c, 0x9d, 0x70, 0x27, + 0x2b, 0x90, 0x89, 0xf6, 0x98, 0x48, 0x49, 0x13, 0x9a, 0x65, 0xa4, 0xa4, 0x89, 0xcd, 0x29, 0x5f, + 0x40, 0x26, 0xda, 0x60, 0x22, 0x89, 0x26, 0x74, 0x9e, 0x24, 0x6e, 0xc5, 0x1e, 0x2c, 0xe9, 0x1b, + 0x78, 0x8d, 0xbc, 0xc9, 0x99, 0xcc, 0xac, 0xd6, 0x56, 0x82, 0x44, 0x68, 0x88, 0x74, 0xb0, 0x0c, + 0x68, 0x3f, 0xa6, 0xbd, 0x85, 0x69, 0x5f, 0x69, 0x51, 0xb9, 0x89, 0xf6, 0xe3, 0x3a, 0x5a, 0xa4, + 0xa2, 0x14, 0xbe, 0x84, 0xc7, 0x8d, 0x0e, 0xdc, 0x46, 0x51, 0x37, 0x61, 0x2d, 0x89, 0xce, 0x0e, + 0x4c, 0x2b, 0xbd, 0x2d, 0xe8, 0x8e, 0xa6, 0x26, 0xcd, 0xe2, 0x73, 0x9a, 0x70, 0xba, 0xb1, 0x97, + 0x61, 0x46, 0xed, 0x90, 0x49, 0xe4, 0x62, 0x6d, 0x90, 0x86, 0xaf, 0x64, 0xd3, 0x73, 0x52, 0x0b, + 0x8c, 0x9b, 0xf5, 0xa8, 0x72, 0x34, 0x86, 0x92, 0x45, 0x42, 0xaa, 0x6a, 0xae, 0x61, 0x29, 0x39, + 0x12, 0x2d, 0xb2, 0x98, 0xac, 0xff, 0xee, 0x74, 0xc2, 0xaf, 0x60, 0x0f, 0xf1, 0x56, 0xf3, 0x91, + 0x96, 0x1e, 0xa4, 0x58, 0x49, 0x4c, 0x1b, 0x4c, 0x6e, 0x23, 0x69, 0x98, 0xab, 0xe9, 0x08, 0x16, + 0x06, 0x3a, 0x7a, 0x50, 0x5e, 0xf3, 0xc7, 0x83, 0xad, 0x39, 0x43, 0xee, 0x7f, 0x0b, 0x03, 0xed, + 0x3c, 0x92, 0x5a, 0x52, 0xa3, 0x4f, 0x22, 0xb5, 0x2a, 0x2c, 0xc7, 0xb6, 0xf8, 0xc8, 0xfc, 0x70, + 0x58, 0x03, 0x50, 0x22, 0xd5, 0x9f, 0x01, 0x1a, 0x6c, 0xc7, 0x91, 0x37, 0xc2, 0xc4, 0x96, 0x21, + 0x79, 0x23, 0x1c, 0xd2, 0xcb, 0x73, 0x04, 0x4b, 0x71, 0xbd, 0x38, 0xc8, 0xd4, 0xf4, 0x19, 0xdb, + 0x4b, 0x13, 0x13, 0xe4, 0x2c, 0x71, 0x28, 0x13, 0xa8, 0x0d, 0xe9, 0xcc, 0x49, 0x14, 0xfe, 0xe7, + 0xa2, 0xdf, 0x6a, 0xb0, 0x83, 0x46, 0xe6, 0xc5, 0xd7, 0xb4, 0xd8, 0x0c, 0x49, 0x37, 0xe6, 0x2b, + 0x4e, 0xb3, 0xad, 0x34, 0xbb, 0xc8, 0x64, 0x63, 0xb0, 0xcb, 0x46, 0x3a, 0x80, 0xb8, 0xde, 0x98, + 0x67, 0xb0, 0x24, 0x22, 0xa1, 0xda, 0x52, 0x82, 0x06, 0x70, 0xc2, 0x8e, 0x17, 0xe9, 0x0c, 0x62, + 0x7b, 0x50, 0x58, 0xb6, 0x4e, 0xff, 0x20, 0x86, 0x92, 0xad, 0x2b, 0xbd, 0x1e, 0x39, 0xbd, 0x2d, + 0x04, 0x3d, 0xa4, 0xd9, 0x3a, 0x6b, 0xc9, 0x4d, 0x3a, 0xeb, 0xab, 0x3a, 0xa5, 0xd0, 0x0c, 0xb6, + 0x45, 0xfd, 0x85, 0x2e, 0xa8, 0x53, 0xbe, 0x3e, 0x01, 0xa7, 0x48, 0x7a, 0x02, 0xae, 0x32, 0x9a, + 0x7c, 0x43, 0x9e, 0x51, 0x1f, 0xca, 0xa4, 0xae, 0x62, 0x9e, 0xe2, 0xa4, 0xae, 0xe2, 0x5e, 0xd6, + 0x68, 0xbe, 0x57, 0x15, 0xf9, 0x55, 0x48, 0xef, 0xee, 0xd0, 0xa7, 0xb1, 0xdc, 0xc6, 0xf0, 0xf7, + 0x24, 0x25, 0x8b, 0x0c, 0x5f, 0x72, 0xd4, 0x24, 0x66, 0xe0, 0xdd, 0x47, 0x0d, 0xa3, 0x31, 0x8f, + 0x3f, 0x4f, 0x68, 0xbd, 0xfc, 0xd9, 0xe1, 0x4e, 0x99, 0xff, 0x61, 0x0e, 0xd7, 0x1b, 0x28, 0x5c, + 0x29, 0xbf, 0x45, 0x18, 0x6a, 0x8f, 0x4d, 0xd1, 0x10, 0x6b, 0x05, 0x54, 0xa1, 0xb5, 0x17, 0x0d, + 0x1a, 0x53, 0xbb, 0x8a, 0x21, 0x98, 0x8b, 0x27, 0x48, 0xeb, 0x78, 0xd4, 0xe9, 0x13, 0x3b, 0xd0, + 0xd9, 0x4c, 0xe0, 0x61, 0x58, 0xec, 0x60, 0x5a, 0x8d, 0x27, 0x23, 0xb8, 0xbb, 0xce, 0x40, 0x98, + 0xc6, 0x2a, 0xc5, 0x27, 0x47, 0xaf, 0xa5, 0x31, 0x0d, 0x51, 0x6a, 0x4c, 0x83, 0xde, 0x4e, 0x63, + 0x11, 0x82, 0xba, 0xc6, 0x74, 0x36, 0x13, 0x78, 0xb8, 0x5e, 0x63, 0xf1, 0x64, 0x6e, 0xaa, 0xb1, + 0x2f, 0x69, 0xa4, 0xd8, 0xa7, 0xbf, 0xc1, 0x78, 0x2b, 0x9d, 0x65, 0x45, 0xde, 0xa3, 0xa3, 0xd6, + 0xb6, 0xd1, 0x73, 0xda, 0x47, 0x1c, 0x81, 0xdf, 0x4c, 0x6f, 0xeb, 0x49, 0x44, 0xa9, 0xe6, 0x0e, + 0x61, 0x99, 0x69, 0x2e, 0xca, 0x6e, 0x22, 0x2f, 0x89, 0x62, 0xef, 0x8b, 0xb0, 0x1b, 0x25, 0x75, + 0x5b, 0xfd, 0xed, 0x50, 0x13, 0xa9, 0x7a, 0x24, 0xab, 0x69, 0x0c, 0xa6, 0x3c, 0x3a, 0x11, 0x51, + 0x2d, 0xd3, 0xa7, 0xd7, 0x0a, 0xe8, 0x90, 0xee, 0x82, 0x0e, 0x1e, 0x96, 0x13, 0xc6, 0x93, 0xa1, + 0x4a, 0x3a, 0x10, 0xf1, 0x39, 0xc2, 0x53, 0xd2, 0xda, 0xc9, 0x4c, 0xc9, 0x84, 0xf9, 0x86, 0xd2, + 0x25, 0xa9, 0x88, 0xc5, 0x19, 0x96, 0x9f, 0x5e, 0xa7, 0x99, 0xe8, 0x9f, 0xcc, 0x42, 0xff, 0x1f, + 0xd2, 0x02, 0xf9, 0x7a, 0x85, 0x44, 0xb1, 0xf9, 0x4b, 0xc3, 0x34, 0x57, 0x08, 0xe5, 0x20, 0x69, + 0xa5, 0x44, 0xf6, 0x3f, 0x83, 0x69, 0xae, 0x86, 0xa1, 0x12, 0x24, 0xa7, 0x8b, 0xcb, 0xfb, 0x38, + 0x18, 0xfc, 0xa3, 0x2b, 0xd7, 0x0a, 0x13, 0xf7, 0x37, 0x5e, 0x08, 0xb5, 0x4a, 0x2c, 0xb5, 0x61, + 0x58, 0x89, 0xbc, 0xd5, 0x68, 0xd7, 0x76, 0xd2, 0x9f, 0xdb, 0x49, 0x62, 0xf0, 0xda, 0x3f, 0xf6, + 0x43, 0xe8, 0x56, 0x92, 0xe9, 0x5e, 0x8b, 0x9f, 0xc8, 0xef, 0x53, 0x58, 0xa7, 0x85, 0xca, 0xdb, + 0x72, 0x9c, 0x9c, 0x7c, 0xdf, 0x09, 0xdf, 0x61, 0xa3, 0x7f, 0xe9, 0x27, 0x89, 0xd8, 0x75, 0x7f, + 0x64, 0x88, 0x50, 0xad, 0x24, 0x52, 0xbd, 0x0e, 0x7b, 0x48, 0x68, 0x5b, 0xa3, 0xb2, 0xdf, 0x92, + 0xdb, 0xe1, 0x7e, 0x2b, 0xf2, 0xa7, 0x87, 0x92, 0xb3, 0xc0, 0xf8, 0x3f, 0x6e, 0x44, 0xa8, 0x54, + 0x06, 0xa8, 0x24, 0xcd, 0x1e, 0x16, 0xca, 0xa8, 0x68, 0x37, 0xe4, 0x26, 0xb9, 0x26, 0x9c, 0x96, + 0xed, 0x05, 0x48, 0x49, 0x5c, 0xb5, 0x07, 0xf6, 0xdc, 0xac, 0xfa, 0x18, 0xea, 0xa3, 0x22, 0xcb, + 0x18, 0xd4, 0xa7, 0x78, 0xa5, 0x92, 0x15, 0xfb, 0x46, 0x1f, 0x21, 0x51, 0xca, 0x7c, 0xfb, 0x9f, + 0x1b, 0xc6, 0xb7, 0xbf, 0xdb, 0x30, 0xfe, 0xf5, 0x77, 0x1b, 0xc6, 0x6f, 0x7f, 0xb7, 0x61, 0x9c, + 0x4d, 0xd0, 0xf1, 0xed, 0xff, 0x0e, 0x00, 0x00, 0xff, 0xff, 0x6f, 0x5a, 0x28, 0x3a, 0xa3, 0x52, + 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. @@ -6655,7 +6786,10 @@ type AuthServiceClient interface { // GetNode retrieves a node described by the given request. GetNode(ctx context.Context, in *types.ResourceInNamespaceRequest, opts ...grpc.CallOption) (*types.ServerV2, error) // GetNodes retrieves all nodes. + // DELETE IN 8.0.0 in favor of ListNodes GetNodes(ctx context.Context, in *types.ResourcesInNamespaceRequest, opts ...grpc.CallOption) (*types.ServerV2List, error) + // ListNodes retrieves a paginated list of nodes. + ListNodes(ctx context.Context, in *ListNodesRequest, opts ...grpc.CallOption) (*ListNodesResponse, error) // UpsertNode upserts a node in a backend. UpsertNode(ctx context.Context, in *types.ServerV2, opts ...grpc.CallOption) (*types.KeepAlive, error) // DeleteNode deletes an existing node in a backend described by the given request. @@ -6972,6 +7106,15 @@ func (c *authServiceClient) GetNodes(ctx context.Context, in *types.ResourcesInN return out, nil } +func (c *authServiceClient) ListNodes(ctx context.Context, in *ListNodesRequest, opts ...grpc.CallOption) (*ListNodesResponse, error) { + out := new(ListNodesResponse) + err := c.cc.Invoke(ctx, "/proto.AuthService/ListNodes", in, out, opts...) + if err != nil { + return nil, err + } + return out, nil +} + func (c *authServiceClient) UpsertNode(ctx context.Context, in *types.ServerV2, opts ...grpc.CallOption) (*types.KeepAlive, error) { out := new(types.KeepAlive) err := c.cc.Invoke(ctx, "/proto.AuthService/UpsertNode", in, out, opts...) @@ -7983,7 +8126,10 @@ type AuthServiceServer interface { // GetNode retrieves a node described by the given request. GetNode(context.Context, *types.ResourceInNamespaceRequest) (*types.ServerV2, error) // GetNodes retrieves all nodes. + // DELETE IN 8.0.0 in favor of ListNodes GetNodes(context.Context, *types.ResourcesInNamespaceRequest) (*types.ServerV2List, error) + // ListNodes retrieves a paginated list of nodes. + ListNodes(context.Context, *ListNodesRequest) (*ListNodesResponse, error) // UpsertNode upserts a node in a backend. UpsertNode(context.Context, *types.ServerV2) (*types.KeepAlive, error) // DeleteNode deletes an existing node in a backend described by the given request. @@ -8224,6 +8370,9 @@ func (*UnimplementedAuthServiceServer) GetNode(ctx context.Context, req *types.R func (*UnimplementedAuthServiceServer) GetNodes(ctx context.Context, req *types.ResourcesInNamespaceRequest) (*types.ServerV2List, error) { return nil, status.Errorf(codes.Unimplemented, "method GetNodes not implemented") } +func (*UnimplementedAuthServiceServer) ListNodes(ctx context.Context, req *ListNodesRequest) (*ListNodesResponse, error) { + return nil, status.Errorf(codes.Unimplemented, "method ListNodes not implemented") +} func (*UnimplementedAuthServiceServer) UpsertNode(ctx context.Context, req *types.ServerV2) (*types.KeepAlive, error) { return nil, status.Errorf(codes.Unimplemented, "method UpsertNode not implemented") } @@ -8609,6 +8758,24 @@ func _AuthService_GetNodes_Handler(srv interface{}, ctx context.Context, dec fun return interceptor(ctx, in, info, handler) } +func _AuthService_ListNodes_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) { + in := new(ListNodesRequest) + if err := dec(in); err != nil { + return nil, err + } + if interceptor == nil { + return srv.(AuthServiceServer).ListNodes(ctx, in) + } + info := &grpc.UnaryServerInfo{ + Server: srv, + FullMethod: "/proto.AuthService/ListNodes", + } + handler := func(ctx context.Context, req interface{}) (interface{}, error) { + return srv.(AuthServiceServer).ListNodes(ctx, req.(*ListNodesRequest)) + } + return interceptor(ctx, in, info, handler) +} + func _AuthService_UpsertNode_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) { in := new(types.ServerV2) if err := dec(in); err != nil { @@ -10438,6 +10605,10 @@ var _AuthService_serviceDesc = grpc.ServiceDesc{ MethodName: "GetNodes", Handler: _AuthService_GetNodes_Handler, }, + { + MethodName: "ListNodes", + Handler: _AuthService_ListNodes_Handler, + }, { MethodName: "UpsertNode", Handler: _AuthService_UpsertNode_Handler, @@ -15824,6 +15995,100 @@ func (m *Events) MarshalToSizedBuffer(dAtA []byte) (int, error) { return len(dAtA) - i, nil } +func (m *ListNodesRequest) Marshal() (dAtA []byte, err error) { + size := m.Size() + dAtA = make([]byte, size) + n, err := m.MarshalToSizedBuffer(dAtA[:size]) + if err != nil { + return nil, err + } + return dAtA[:n], nil +} + +func (m *ListNodesRequest) MarshalTo(dAtA []byte) (int, error) { + size := m.Size() + return m.MarshalToSizedBuffer(dAtA[:size]) +} + +func (m *ListNodesRequest) MarshalToSizedBuffer(dAtA []byte) (int, error) { + i := len(dAtA) + _ = i + var l int + _ = l + if m.XXX_unrecognized != nil { + i -= len(m.XXX_unrecognized) + copy(dAtA[i:], m.XXX_unrecognized) + } + if len(m.StartKey) > 0 { + i -= len(m.StartKey) + copy(dAtA[i:], m.StartKey) + i = encodeVarintAuthservice(dAtA, i, uint64(len(m.StartKey))) + i-- + dAtA[i] = 0x1a + } + if m.Limit != 0 { + i = encodeVarintAuthservice(dAtA, i, uint64(m.Limit)) + i-- + dAtA[i] = 0x10 + } + if len(m.Namespace) > 0 { + i -= len(m.Namespace) + copy(dAtA[i:], m.Namespace) + i = encodeVarintAuthservice(dAtA, i, uint64(len(m.Namespace))) + i-- + dAtA[i] = 0xa + } + return len(dAtA) - i, nil +} + +func (m *ListNodesResponse) Marshal() (dAtA []byte, err error) { + size := m.Size() + dAtA = make([]byte, size) + n, err := m.MarshalToSizedBuffer(dAtA[:size]) + if err != nil { + return nil, err + } + return dAtA[:n], nil +} + +func (m *ListNodesResponse) MarshalTo(dAtA []byte) (int, error) { + size := m.Size() + return m.MarshalToSizedBuffer(dAtA[:size]) +} + +func (m *ListNodesResponse) MarshalToSizedBuffer(dAtA []byte) (int, error) { + i := len(dAtA) + _ = i + var l int + _ = l + if m.XXX_unrecognized != nil { + i -= len(m.XXX_unrecognized) + copy(dAtA[i:], m.XXX_unrecognized) + } + if len(m.NextKey) > 0 { + i -= len(m.NextKey) + copy(dAtA[i:], m.NextKey) + i = encodeVarintAuthservice(dAtA, i, uint64(len(m.NextKey))) + i-- + dAtA[i] = 0x12 + } + if len(m.Servers) > 0 { + for iNdEx := len(m.Servers) - 1; iNdEx >= 0; iNdEx-- { + { + size, err := m.Servers[iNdEx].MarshalToSizedBuffer(dAtA[:i]) + if err != nil { + return 0, err + } + i -= size + i = encodeVarintAuthservice(dAtA, i, uint64(size)) + } + i-- + dAtA[i] = 0xa + } + } + return len(dAtA) - i, nil +} + func encodeVarintAuthservice(dAtA []byte, offset int, v uint64) int { offset -= sovAuthservice(v) base := offset @@ -18210,6 +18475,51 @@ func (m *Events) Size() (n int) { return n } +func (m *ListNodesRequest) Size() (n int) { + if m == nil { + return 0 + } + var l int + _ = l + l = len(m.Namespace) + if l > 0 { + n += 1 + l + sovAuthservice(uint64(l)) + } + if m.Limit != 0 { + n += 1 + sovAuthservice(uint64(m.Limit)) + } + l = len(m.StartKey) + if l > 0 { + n += 1 + l + sovAuthservice(uint64(l)) + } + if m.XXX_unrecognized != nil { + n += len(m.XXX_unrecognized) + } + return n +} + +func (m *ListNodesResponse) Size() (n int) { + if m == nil { + return 0 + } + var l int + _ = l + if len(m.Servers) > 0 { + for _, e := range m.Servers { + l = e.Size() + n += 1 + l + sovAuthservice(uint64(l)) + } + } + l = len(m.NextKey) + if l > 0 { + n += 1 + l + sovAuthservice(uint64(l)) + } + if m.XXX_unrecognized != nil { + n += len(m.XXX_unrecognized) + } + return n +} + func sovAuthservice(x uint64) (n int) { return (math_bits.Len64(x|1) + 6) / 7 } @@ -29473,6 +29783,257 @@ func (m *Events) Unmarshal(dAtA []byte) error { } return nil } +func (m *ListNodesRequest) Unmarshal(dAtA []byte) error { + l := len(dAtA) + iNdEx := 0 + for iNdEx < l { + preIndex := iNdEx + var wire uint64 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowAuthservice + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + wire |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + fieldNum := int32(wire >> 3) + wireType := int(wire & 0x7) + if wireType == 4 { + return fmt.Errorf("proto: ListNodesRequest: wiretype end group for non-group") + } + if fieldNum <= 0 { + return fmt.Errorf("proto: ListNodesRequest: illegal tag %d (wire type %d)", fieldNum, wire) + } + switch fieldNum { + case 1: + if wireType != 2 { + return fmt.Errorf("proto: wrong wireType = %d for field Namespace", wireType) + } + var stringLen uint64 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowAuthservice + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + stringLen |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + intStringLen := int(stringLen) + if intStringLen < 0 { + return ErrInvalidLengthAuthservice + } + postIndex := iNdEx + intStringLen + if postIndex < 0 { + return ErrInvalidLengthAuthservice + } + if postIndex > l { + return io.ErrUnexpectedEOF + } + m.Namespace = string(dAtA[iNdEx:postIndex]) + iNdEx = postIndex + case 2: + if wireType != 0 { + return fmt.Errorf("proto: wrong wireType = %d for field Limit", wireType) + } + m.Limit = 0 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowAuthservice + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + m.Limit |= int32(b&0x7F) << shift + if b < 0x80 { + break + } + } + case 3: + if wireType != 2 { + return fmt.Errorf("proto: wrong wireType = %d for field StartKey", wireType) + } + var stringLen uint64 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowAuthservice + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + stringLen |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + intStringLen := int(stringLen) + if intStringLen < 0 { + return ErrInvalidLengthAuthservice + } + postIndex := iNdEx + intStringLen + if postIndex < 0 { + return ErrInvalidLengthAuthservice + } + if postIndex > l { + return io.ErrUnexpectedEOF + } + m.StartKey = string(dAtA[iNdEx:postIndex]) + iNdEx = postIndex + default: + iNdEx = preIndex + skippy, err := skipAuthservice(dAtA[iNdEx:]) + if err != nil { + return err + } + if (skippy < 0) || (iNdEx+skippy) < 0 { + return ErrInvalidLengthAuthservice + } + if (iNdEx + skippy) > l { + return io.ErrUnexpectedEOF + } + m.XXX_unrecognized = append(m.XXX_unrecognized, dAtA[iNdEx:iNdEx+skippy]...) + iNdEx += skippy + } + } + + if iNdEx > l { + return io.ErrUnexpectedEOF + } + return nil +} +func (m *ListNodesResponse) Unmarshal(dAtA []byte) error { + l := len(dAtA) + iNdEx := 0 + for iNdEx < l { + preIndex := iNdEx + var wire uint64 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowAuthservice + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + wire |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + fieldNum := int32(wire >> 3) + wireType := int(wire & 0x7) + if wireType == 4 { + return fmt.Errorf("proto: ListNodesResponse: wiretype end group for non-group") + } + if fieldNum <= 0 { + return fmt.Errorf("proto: ListNodesResponse: illegal tag %d (wire type %d)", fieldNum, wire) + } + switch fieldNum { + case 1: + if wireType != 2 { + return fmt.Errorf("proto: wrong wireType = %d for field Servers", wireType) + } + var msglen int + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowAuthservice + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + msglen |= int(b&0x7F) << shift + if b < 0x80 { + break + } + } + if msglen < 0 { + return ErrInvalidLengthAuthservice + } + postIndex := iNdEx + msglen + if postIndex < 0 { + return ErrInvalidLengthAuthservice + } + if postIndex > l { + return io.ErrUnexpectedEOF + } + m.Servers = append(m.Servers, &types.ServerV2{}) + if err := m.Servers[len(m.Servers)-1].Unmarshal(dAtA[iNdEx:postIndex]); err != nil { + return err + } + iNdEx = postIndex + case 2: + if wireType != 2 { + return fmt.Errorf("proto: wrong wireType = %d for field NextKey", wireType) + } + var stringLen uint64 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowAuthservice + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + stringLen |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + intStringLen := int(stringLen) + if intStringLen < 0 { + return ErrInvalidLengthAuthservice + } + postIndex := iNdEx + intStringLen + if postIndex < 0 { + return ErrInvalidLengthAuthservice + } + if postIndex > l { + return io.ErrUnexpectedEOF + } + m.NextKey = string(dAtA[iNdEx:postIndex]) + iNdEx = postIndex + default: + iNdEx = preIndex + skippy, err := skipAuthservice(dAtA[iNdEx:]) + if err != nil { + return err + } + if (skippy < 0) || (iNdEx+skippy) < 0 { + return ErrInvalidLengthAuthservice + } + if (iNdEx + skippy) > l { + return io.ErrUnexpectedEOF + } + m.XXX_unrecognized = append(m.XXX_unrecognized, dAtA[iNdEx:iNdEx+skippy]...) + iNdEx += skippy + } + } + + if iNdEx > l { + return io.ErrUnexpectedEOF + } + return nil +} func skipAuthservice(dAtA []byte) (n int, err error) { l := len(dAtA) iNdEx := 0 diff --git a/api/client/proto/authservice.proto b/api/client/proto/authservice.proto index 20ea4ae3265..0aa5049c8e8 100644 --- a/api/client/proto/authservice.proto +++ b/api/client/proto/authservice.proto @@ -867,6 +867,24 @@ message Events { string LastKey = 2; } +message ListNodesRequest { + // Namespace is the namespace of resources. + string Namespace = 1; + // Limit is the maximum amount of nodes to retrieve. + int32 Limit = 2; + // StartKey is used to start listing nodes from a specific spot. This should + // be set to the previous NextKey value if using pagination, or left empty. + string StartKey = 3; +} + +message ListNodesResponse { + // Servers is a list of servers. + repeated types.ServerV2 Servers = 1; + // NextKey is the next Key to use as StartKey in a ListNodesRequest to continue + // retrieving pages of nodes. If NextKey is empty, there are no more pages. + string NextKey = 2; +} + // AuthService is authentication/authorization service implementation service AuthService { // SendKeepAlives allows node to send a stream of keep alive requests @@ -877,7 +895,10 @@ service AuthService { // GetNode retrieves a node described by the given request. rpc GetNode(types.ResourceInNamespaceRequest) returns (types.ServerV2); // GetNodes retrieves all nodes. + // DELETE IN 8.0.0 in favor of ListNodes rpc GetNodes(types.ResourcesInNamespaceRequest) returns (types.ServerV2List); + // ListNodes retrieves a paginated list of nodes. + rpc ListNodes(ListNodesRequest) returns (ListNodesResponse); // UpsertNode upserts a node in a backend. rpc UpsertNode(types.ServerV2) returns (types.KeepAlive); // DeleteNode deletes an existing node in a backend described by the given request. diff --git a/api/defaults/defaults.go b/api/defaults/defaults.go index 840983f10ef..0de3f1be351 100644 --- a/api/defaults/defaults.go +++ b/api/defaults/defaults.go @@ -68,3 +68,8 @@ func EnhancedEvents() []string { constants.EnhancedRecordingNetwork, } } + +const ( + // DefaultChunkSize is the default chunk size for paginated endpoints. + DefaultChunkSize = 1000 +) diff --git a/api/types/types.pb.go b/api/types/types.pb.go index 0791654ff77..5af38792ca5 100644 --- a/api/types/types.pb.go +++ b/api/types/types.pb.go @@ -714,6 +714,7 @@ func (m *ServerV2) XXX_DiscardUnknown() { var xxx_messageInfo_ServerV2 proto.InternalMessageInfo // ServerV2List is a list of servers. +// DELETE IN 8.0.0 only used in deprecated GetNodes rpc type ServerV2List struct { // Servers is a list of servers. Servers []*ServerV2 `protobuf:"bytes,1,rep,name=Servers,proto3" json:"Servers,omitempty"` diff --git a/api/types/types.proto b/api/types/types.proto index 7925b58a635..7767b06efb6 100644 --- a/api/types/types.proto +++ b/api/types/types.proto @@ -217,6 +217,7 @@ message ServerV2 { } // ServerV2List is a list of servers. +// DELETE IN 8.0.0 only used in deprecated GetNodes rpc message ServerV2List { // Servers is a list of servers. repeated ServerV2 Servers = 1; diff --git a/lib/auth/api.go b/lib/auth/api.go index e920aeab4a4..b9aa96f9b85 100644 --- a/lib/auth/api.go +++ b/lib/auth/api.go @@ -98,6 +98,9 @@ type ReadAccessPoint interface { // GetNodes returns a list of registered servers for this cluster. GetNodes(ctx context.Context, namespace string, opts ...services.MarshalOption) ([]types.Server, error) + // ListNodes returns a paginated list of registered servers for this cluster. + ListNodes(ctx context.Context, namespace string, limit int, startKey string) (nodes []types.Server, nextKey string, err error) + // GetProxies returns a list of proxy servers registered in the cluster GetProxies() ([]types.Server, error) diff --git a/lib/auth/auth.go b/lib/auth/auth.go index f26fb55eca4..9725bd0db87 100644 --- a/lib/auth/auth.go +++ b/lib/auth/auth.go @@ -2122,6 +2122,37 @@ func (a *Server) GetNodes(ctx context.Context, namespace string, opts ...service return a.GetCache().GetNodes(ctx, namespace, opts...) } +// ListNodes is a part of auth.AccessPoint implementation +func (a *Server) ListNodes(ctx context.Context, namespace string, limit int, startKey string) ([]types.Server, string, error) { + return a.GetCache().ListNodes(ctx, namespace, limit, startKey) +} + +// NodePageFunc is a function to run on each page iterated over. +type NodePageFunc func(next []types.Server) (stop bool, err error) + +// IterateNodePages can be used to iterate over pages of nodes. +func (a *Server) IterateNodePages(ctx context.Context, namespace string, limit int, startKey string, f NodePageFunc) (string, error) { + for { + nextPage, nextKey, err := a.ListNodes(ctx, namespace, limit, startKey) + if err != nil { + return "", trace.Wrap(err) + } + + stop, err := f(nextPage) + if err != nil { + return "", trace.Wrap(err) + } + + // Iterator stopped before end of pages or + // there are no more pages, return nextKey + if stop || nextKey == "" { + return nextKey, nil + } + + startKey = nextKey + } +} + // GetReverseTunnels is a part of auth.AccessPoint implementation func (a *Server) GetReverseTunnels(opts ...services.MarshalOption) ([]types.ReverseTunnel, error) { return a.GetCache().GetReverseTunnels(opts...) diff --git a/lib/auth/auth_with_roles.go b/lib/auth/auth_with_roles.go index 35786c6c5d2..bb3f4a2694c 100644 --- a/lib/auth/auth_with_roles.go +++ b/lib/auth/auth_with_roles.go @@ -30,6 +30,7 @@ import ( "github.com/gravitational/teleport/api/types/wrappers" apiutils "github.com/gravitational/teleport/api/utils" "github.com/gravitational/teleport/lib/auth/u2f" + "github.com/gravitational/teleport/lib/backend" "github.com/gravitational/teleport/lib/defaults" "github.com/gravitational/teleport/lib/events" "github.com/gravitational/teleport/lib/modules" @@ -661,6 +662,49 @@ func (a *ServerWithRoles) GetNodes(ctx context.Context, namespace string, opts . return filteredNodes, nil } +// ListNodes returns a paginated list of nodes filtered by user access. +func (a *ServerWithRoles) ListNodes(ctx context.Context, namespace string, limit int, startKey string) (page []types.Server, nextKey string, err error) { + if err := a.action(namespace, types.KindNode, types.VerbList); err != nil { + return nil, "", trace.Wrap(err) + } + + return a.filterAndListNodes(ctx, namespace, limit, startKey) +} + +func (a *ServerWithRoles) filterAndListNodes(ctx context.Context, namespace string, limit int, startKey string) (page []types.Server, nextKey string, err error) { + if limit <= 0 { + return nil, "", trace.BadParameter("nonpositive parameter limit") + } + + page = make([]types.Server, 0, limit) + nextKey, err = a.authServer.IterateNodePages(ctx, namespace, limit, startKey, func(nextPage []types.Server) (bool, error) { + // Retrieve and filter pages of nodes until we can fill a page or run out of nodes. + filteredPage, err := a.filterNodes(nextPage) + if err != nil { + return false, trace.Wrap(err) + } + + // We have more than enough nodes to fill the page, cut it to size. + if len(filteredPage) > limit-len(page) { + filteredPage = filteredPage[:limit-len(page)] + } + + // Add filteredPage and break out of iterator if the page is now full. + page = append(page, filteredPage...) + return len(page) == limit, nil + }) + if err != nil { + return nil, "", trace.Wrap(err) + } + + // Filled a page, reset nextKey in case the last node was cut out. + if len(page) == limit { + nextKey = backend.NextPaginationKey(page[len(page)-1]) + } + + return page, nextKey, nil +} + func (a *ServerWithRoles) UpsertAuthServer(s types.Server) error { if err := a.action(apidefaults.Namespace, types.KindAuthServer, types.VerbCreate); err != nil { return trace.Wrap(err) diff --git a/lib/auth/auth_with_roles_test.go b/lib/auth/auth_with_roles_test.go index b86c37cfa98..d42399a78b8 100644 --- a/lib/auth/auth_with_roles_test.go +++ b/lib/auth/auth_with_roles_test.go @@ -24,11 +24,13 @@ import ( "github.com/gravitational/teleport/api/client/proto" "github.com/gravitational/teleport/api/constants" + "github.com/gravitational/teleport/api/defaults" "github.com/gravitational/teleport/api/types" "github.com/gravitational/teleport/lib/tlsca" "github.com/google/go-cmp/cmp" "github.com/google/go-cmp/cmp/cmpopts" + "github.com/pborman/uuid" "github.com/stretchr/testify/require" ) @@ -239,3 +241,58 @@ func resourceDiff(res1, res2 types.Resource) string { cmpopts.IgnoreFields(types.Metadata{}, "ID", "Namespace"), cmpopts.EquateEmpty()) } + +// TestListNodes users can retrieve nodes with the appropriate permissions. +func TestListNodes(t *testing.T) { + t.Parallel() + ctx := context.Background() + srv := newTestTLSServer(t) + + // Create test nodes. + for i := 0; i < 10; i++ { + name := uuid.New() + node, err := types.NewServerWithLabels( + name, + types.KindNode, + types.ServerSpecV2{}, + map[string]string{"name": name}, + ) + require.NoError(t, err) + + _, err = srv.Auth().UpsertNode(ctx, node) + require.NoError(t, err) + } + + testNodes, err := srv.Auth().GetNodes(ctx, defaults.Namespace) + require.NoError(t, err) + + // create user, role, and client + username := "user" + user, role, err := CreateUserAndRole(srv.Auth(), username, nil) + require.NoError(t, err) + identity := TestUser(user.GetName()) + clt, err := srv.NewClient(identity) + require.NoError(t, err) + + // permit user to list all nodes + role.SetNodeLabels(types.Allow, types.Labels{types.Wildcard: {types.Wildcard}}) + require.NoError(t, srv.Auth().UpsertRole(ctx, role)) + + // listing nodes 0-4 should list first 5 nodes + nodes, _, err := clt.ListNodes(ctx, defaults.Namespace, 5, "") + require.NoError(t, err) + require.EqualValues(t, 5, len(nodes)) + expectedNodes := testNodes[:5] + require.Empty(t, cmp.Diff(expectedNodes, nodes)) + + // remove permission for third node + role.SetNodeLabels(types.Deny, types.Labels{"name": {testNodes[3].GetName()}}) + require.NoError(t, srv.Auth().UpsertRole(ctx, role)) + + // listing nodes 0-4 should skip the third node and add the fifth to the end. + nodes, _, err = clt.ListNodes(ctx, defaults.Namespace, 5, "") + require.NoError(t, err) + require.EqualValues(t, 5, len(nodes)) + expectedNodes = append(testNodes[:3], testNodes[4:6]...) + require.Empty(t, cmp.Diff(expectedNodes, nodes)) +} diff --git a/lib/auth/grpcserver.go b/lib/auth/grpcserver.go index 78ed941980a..6ba2763a9b9 100644 --- a/lib/auth/grpcserver.go +++ b/lib/auth/grpcserver.go @@ -2424,6 +2424,7 @@ func (g *GRPCServer) GetNode(ctx context.Context, req *types.ResourceInNamespace } // GetNodes retrieves all nodes in the given namespace. +// DELETE IN 8.0.0 in favor of ListNodes func (g *GRPCServer) GetNodes(ctx context.Context, req *types.ResourcesInNamespaceRequest) (*types.ServerV2List, error) { auth, err := g.authenticate(ctx) if err != nil { @@ -2445,6 +2446,29 @@ func (g *GRPCServer) GetNodes(ctx context.Context, req *types.ResourcesInNamespa }, nil } +// ListNodes retrieves a paginated list of nodes in the given namespace. +func (g *GRPCServer) ListNodes(ctx context.Context, req *proto.ListNodesRequest) (*proto.ListNodesResponse, error) { + auth, err := g.authenticate(ctx) + if err != nil { + return nil, trace.Wrap(err) + } + ns, nextKey, err := auth.ServerWithRoles.ListNodes(ctx, req.Namespace, int(req.Limit), req.StartKey) + if err != nil { + return nil, trace.Wrap(err) + } + serversV2 := make([]*types.ServerV2, len(ns)) + for i, t := range ns { + var ok bool + if serversV2[i], ok = t.(*types.ServerV2); !ok { + return nil, trace.Errorf("encountered unexpected node type: %T", t) + } + } + return &proto.ListNodesResponse{ + Servers: serversV2, + NextKey: nextKey, + }, nil +} + // UpsertNode upserts a node. func (g *GRPCServer) UpsertNode(ctx context.Context, node *types.ServerV2) (*types.KeepAlive, error) { auth, err := g.authenticate(ctx) diff --git a/lib/auth/grpcserver_test.go b/lib/auth/grpcserver_test.go index f3a94244d3d..8249d0a9e76 100644 --- a/lib/auth/grpcserver_test.go +++ b/lib/auth/grpcserver_test.go @@ -36,13 +36,17 @@ import ( "github.com/gravitational/teleport" "github.com/gravitational/teleport/api/client/proto" "github.com/gravitational/teleport/api/constants" + "github.com/gravitational/teleport/api/defaults" + apidefaults "github.com/gravitational/teleport/api/defaults" "github.com/gravitational/teleport/api/metadata" "github.com/gravitational/teleport/api/types" "github.com/gravitational/teleport/api/utils/sshutils" "github.com/gravitational/teleport/lib/auth/mocku2f" "github.com/gravitational/teleport/lib/auth/u2f" + "github.com/gravitational/teleport/lib/backend" "github.com/gravitational/teleport/lib/services" "github.com/gravitational/teleport/lib/tlsca" + "github.com/gravitational/trace" ) func TestMFADeviceManagement(t *testing.T) { @@ -1206,3 +1210,171 @@ func TestSessionRecordingConfigOriginDynamic(t *testing.T) { testOriginDynamicStored(t, setWithOrigin, getStored) } + +func TestNodesCRUD(t *testing.T) { + t.Parallel() + ctx := context.Background() + srv := newTestTLSServer(t) + + clt, err := srv.NewClient(TestAdmin()) + require.NoError(t, err) + + // node1 and node2 will be added to default namespace + node1, err := types.NewServerWithLabels("node1", types.KindNode, types.ServerSpecV2{}, map[string]string{ + // Artificially make a node ~ 3MB to force ListNodes + // to fail when retrieving more than one at a time. + "label": string(make([]byte, 3000000)), + }) + require.NoError(t, err) + node2, err := types.NewServerWithLabels("node2", types.KindNode, types.ServerSpecV2{}, map[string]string{ + // Artificially make a node ~ 3MB to force ListNodes + // to fail when retrieving more than one at a time. + "label": string(make([]byte, 3000000)), + }) + require.NoError(t, err) + + // add largeNode to special namespace. largeNode is too big to send over gRPC. + largeNode, err := types.NewServerWithLabels( + "the_big_one", + types.KindNode, + types.ServerSpecV2{}, + map[string]string{ + // Artificially make a node ~ 5MB to force + // ListNodes to fail regardless of chunk size. + "label": string(make([]byte, 5000000)), + }, + ) + require.NoError(t, err) + largeNodeNamespace := "the_big_one" + largeNode.SetNamespace(largeNodeNamespace) + _, err = srv.Auth().UpsertNode(ctx, largeNode) + require.NoError(t, err) + + t.Run("CreateNode", func(t *testing.T) { + // Initially expect no nodes to be returned. + nodes, err := clt.GetNodes(ctx, apidefaults.Namespace) + require.NoError(t, err) + require.Equal(t, 0, len(nodes)) + + // Create nodes + _, err = clt.UpsertNode(ctx, node1) + require.NoError(t, err) + + _, err = clt.UpsertNode(ctx, node2) + require.NoError(t, err) + + // Fail to create largeNode + _, err = clt.UpsertNode(ctx, largeNode) + require.IsType(t, &trace.LimitExceededError{}, err.(*trace.TraceErr).OrigError()) + }) + + // Run NodeGetters in nested subtests to allow parallelization. + t.Run("NodeGetters", func(t *testing.T) { + t.Run("List Nodes", func(t *testing.T) { + t.Parallel() + // list nodes one at a time, last page should be empty + nodes, nextKey, err := clt.ListNodes(ctx, apidefaults.Namespace, 1, "") + require.NoError(t, err) + require.EqualValues(t, 1, len(nodes)) + require.Empty(t, cmp.Diff([]types.Server{node1}, nodes, + cmpopts.IgnoreFields(types.Metadata{}, "ID"))) + require.EqualValues(t, backend.NextPaginationKey(node1), nextKey) + + nodes, nextKey, err = clt.ListNodes(ctx, apidefaults.Namespace, 1, nextKey) + require.NoError(t, err) + require.EqualValues(t, 1, len(nodes)) + require.Empty(t, cmp.Diff([]types.Server{node2}, nodes, + cmpopts.IgnoreFields(types.Metadata{}, "ID"))) + require.EqualValues(t, backend.NextPaginationKey(node2), nextKey) + + nodes, nextKey, err = clt.ListNodes(ctx, apidefaults.Namespace, 1, nextKey) + require.NoError(t, err) + require.EqualValues(t, 0, len(nodes)) + require.EqualValues(t, "", nextKey) + + // ListNodes should fail if namespace isn't provided + _, _, err = clt.ListNodes(ctx, "", 1, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + + // ListNodes should fail if limit is nonpositive + _, _, err = clt.ListNodes(ctx, apidefaults.Namespace, 0, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + + _, _, err = clt.ListNodes(ctx, apidefaults.Namespace, -1, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + + // ListNodes should return a limit exceeded error when exceeding gRPC message size limit. + _, _, err = clt.ListNodes(ctx, defaults.Namespace, 2, "") + require.IsType(t, &trace.LimitExceededError{}, err.(*trace.TraceErr).OrigError()) + }) + t.Run("GetNodes", func(t *testing.T) { + t.Parallel() + // Get all nodes, transparently handle limit exceeded errors + nodes, err := clt.GetNodes(ctx, apidefaults.Namespace) + require.NoError(t, err) + require.EqualValues(t, len(nodes), 2) + require.Empty(t, cmp.Diff([]types.Server{node1, node2}, nodes, + cmpopts.IgnoreFields(types.Metadata{}, "ID"))) + + // GetNodes should fail if namespace isn't provided + _, err = clt.GetNodes(ctx, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + + // GetNodes should return a limit exceeded error when a single + // node is larger than the gRPC message size limit. + _, err = clt.GetNodes(ctx, largeNodeNamespace) + require.IsType(t, &trace.LimitExceededError{}, err.(*trace.TraceErr).OrigError()) + }) + t.Run("GetNode", func(t *testing.T) { + t.Parallel() + // Get Node + node, err := clt.GetNode(ctx, apidefaults.Namespace, "node1") + require.NoError(t, err) + require.Empty(t, cmp.Diff(node1, node, + cmpopts.IgnoreFields(types.Metadata{}, "ID"))) + + // GetNode should fail if node name isn't provided + _, err = clt.GetNode(ctx, apidefaults.Namespace, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + + // GetNode should fail if namespace isn't provided + _, err = clt.GetNode(ctx, "", "node1") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + }) + }) + + t.Run("DeleteNode", func(t *testing.T) { + // Make sure can't delete with empty namespace or name. + err = clt.DeleteNode(ctx, apidefaults.Namespace, "") + require.Error(t, err) + require.IsType(t, trace.BadParameter(""), err) + + err = clt.DeleteNode(ctx, "", node1.GetName()) + require.Error(t, err) + require.IsType(t, trace.BadParameter(""), err) + + // Delete node. + err = clt.DeleteNode(ctx, apidefaults.Namespace, node1.GetName()) + require.NoError(t, err) + + // Expect node not found + _, err := clt.GetNode(ctx, apidefaults.Namespace, "node1") + require.IsType(t, trace.NotFound(""), err) + }) + + t.Run("DeleteAllNodes", func(t *testing.T) { + // Make sure can't delete with empty namespace. + err = clt.DeleteAllNodes(ctx, "") + require.Error(t, err) + require.IsType(t, trace.BadParameter(""), err) + + // Delete nodes + err = clt.DeleteAllNodes(ctx, apidefaults.Namespace) + require.NoError(t, err) + + // Now expect no nodes to be returned. + nodes, err := clt.GetNodes(ctx, apidefaults.Namespace) + require.NoError(t, err) + require.Equal(t, 0, len(nodes)) + }) +} diff --git a/lib/backend/backend.go b/lib/backend/backend.go index 535b8e3efd3..076a937ea08 100644 --- a/lib/backend/backend.go +++ b/lib/backend/backend.go @@ -26,6 +26,7 @@ import ( "time" "github.com/gravitational/teleport/api/types" + "github.com/jonboulle/clockwork" ) @@ -212,8 +213,10 @@ func (p Params) GetString(key string) string { // NoLimit specifies no limits const NoLimit = 0 -// RangeEnd returns end of the range for given key -func RangeEnd(key []byte) []byte { +// nextKey returns the next possible key. +// If used with a key prefix, this will return +// the end of the range for that key prefix. +func nextKey(key []byte) []byte { end := make([]byte, len(key)) copy(end, key) for i := len(end) - 1; i >= 0; i-- { @@ -231,6 +234,16 @@ var ( noEnd = []byte{0} ) +// RangeEnd returns end of the range for given key. +func RangeEnd(key []byte) []byte { + return nextKey(key) +} + +// NextPaginationKey returns the next pagination key. +func NextPaginationKey(r types.Resource) string { + return string(nextKey([]byte(r.GetName()))) +} + // Items is a sortable list of backend items type Items []Item diff --git a/lib/cache/cache.go b/lib/cache/cache.go index 4fb16d2e1d0..7b00f0e334a 100644 --- a/lib/cache/cache.go +++ b/lib/cache/cache.go @@ -1148,6 +1148,16 @@ func (c *Cache) GetNodes(ctx context.Context, namespace string, opts ...services return rg.presence.GetNodes(ctx, namespace, opts...) } +// ListNodes is a part of auth.AccessPoint implementation +func (c *Cache) ListNodes(ctx context.Context, namespace string, limit int, startKey string) ([]types.Server, string, error) { + rg, err := c.read() + if err != nil { + return nil, "", trace.Wrap(err) + } + defer rg.Release() + return rg.presence.ListNodes(ctx, namespace, limit, startKey) +} + // GetAuthServers returns a list of registered servers func (c *Cache) GetAuthServers() ([]types.Server, error) { rg, err := c.read() diff --git a/lib/services/local/presence.go b/lib/services/local/presence.go index 1dd1e5f8546..c3c7aaa4146 100644 --- a/lib/services/local/presence.go +++ b/lib/services/local/presence.go @@ -251,6 +251,48 @@ func (s *PresenceService) GetNodes(ctx context.Context, namespace string, opts . return servers, nil } +// ListNodes returns a paginated list of registered servers. +// StartKey is a resource name, which is the suffix of its key. +func (s *PresenceService) ListNodes(ctx context.Context, namespace string, limit int, startKey string) (page []types.Server, nextKey string, err error) { + if namespace == "" { + return nil, "", trace.BadParameter("missing namespace value") + } + if limit <= 0 { + return nil, "", trace.BadParameter("nonpositive limit value") + } + + // Get all items in the bucket within the given range. + rangeStart := backend.Key(nodesPrefix, namespace, startKey) + keyPrefix := backend.Key(nodesPrefix, namespace) + rangeEnd := backend.RangeEnd(keyPrefix) + result, err := s.GetRange(ctx, rangeStart, rangeEnd, limit) + if err != nil { + return nil, "", trace.Wrap(err) + } + + // Marshal values into a []services.Server slice. + servers := make([]types.Server, len(result.Items)) + for i, item := range result.Items { + server, err := services.UnmarshalServer( + item.Value, + types.KindNode, + services.WithResourceID(item.ID), + services.WithExpires(item.Expires), + ) + if err != nil { + return nil, "", trace.Wrap(err) + } + servers[i] = server + } + + // If a full page was filled, set nextKey using the last node. + if len(result.Items) == limit { + nextKey = backend.NextPaginationKey(servers[len(servers)-1]) + } + + return servers, nextKey, nil +} + // UpsertNode registers node presence, permanently if TTL is 0 or for the // specified duration with second resolution if it's >= 1 second. func (s *PresenceService) UpsertNode(ctx context.Context, server types.Server) (*types.KeepAlive, error) { diff --git a/lib/services/local/presence_test.go b/lib/services/local/presence_test.go index c41fbbda5b3..37063e84112 100644 --- a/lib/services/local/presence_test.go +++ b/lib/services/local/presence_test.go @@ -21,6 +21,8 @@ import ( "testing" "time" + "github.com/google/go-cmp/cmp" + "github.com/google/go-cmp/cmp/cmpopts" "github.com/jonboulle/clockwork" "github.com/pborman/uuid" "github.com/stretchr/testify/require" @@ -191,3 +193,117 @@ func TestDatabaseServersCRUD(t *testing.T) { require.NoError(t, err) require.Equal(t, 0, len(out)) } + +func TestNodeCRUD(t *testing.T) { + ctx := context.Background() + lite, err := lite.NewWithConfig(ctx, lite.Config{Path: t.TempDir()}) + require.NoError(t, err) + + presence := NewPresenceService(lite) + + node1, err := types.NewServerWithLabels("node1", types.KindNode, types.ServerSpecV2{}, nil) + require.NoError(t, err) + + node2, err := types.NewServerWithLabels("node2", types.KindNode, types.ServerSpecV2{}, nil) + require.NoError(t, err) + + t.Run("CreateNode", func(t *testing.T) { + // Initially expect no nodes to be returned. + nodes, err := presence.GetNodes(ctx, apidefaults.Namespace) + require.NoError(t, err) + require.Equal(t, 0, len(nodes)) + + // Create nodes + _, err = presence.UpsertNode(ctx, node1) + require.NoError(t, err) + _, err = presence.UpsertNode(ctx, node2) + require.NoError(t, err) + }) + + // Run NodeGetters in nested subtests to allow parallelization. + t.Run("NodeGetters", func(t *testing.T) { + t.Run("List Nodes", func(t *testing.T) { + t.Parallel() + // list nodes one at a time, last page should be empty + nodes, nextKey, err := presence.ListNodes(ctx, apidefaults.Namespace, 1, "") + require.NoError(t, err) + require.EqualValues(t, 1, len(nodes)) + require.Empty(t, cmp.Diff([]types.Server{node1}, nodes, + cmpopts.IgnoreFields(types.Metadata{}, "ID"))) + require.EqualValues(t, backend.NextPaginationKey(node1), nextKey) + + nodes, nextKey, err = presence.ListNodes(ctx, apidefaults.Namespace, 1, nextKey) + require.NoError(t, err) + require.EqualValues(t, 1, len(nodes)) + require.Empty(t, cmp.Diff([]types.Server{node2}, nodes, + cmpopts.IgnoreFields(types.Metadata{}, "ID"))) + require.EqualValues(t, backend.NextPaginationKey(node2), nextKey) + + nodes, nextKey, err = presence.ListNodes(ctx, apidefaults.Namespace, 1, nextKey) + require.NoError(t, err) + require.EqualValues(t, 0, len(nodes)) + require.EqualValues(t, "", nextKey) + + // ListNodes should fail if namespace isn't provided + _, _, err = presence.ListNodes(ctx, "", 1, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + + // ListNodes should fail if limit is nonpositive + _, _, err = presence.ListNodes(ctx, apidefaults.Namespace, 0, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + + _, _, err = presence.ListNodes(ctx, apidefaults.Namespace, -1, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + }) + t.Run("GetNodes", func(t *testing.T) { + t.Parallel() + // Get all nodes, transparently handle limit exceeded errors + nodes, err := presence.GetNodes(ctx, apidefaults.Namespace) + require.NoError(t, err) + require.EqualValues(t, len(nodes), 2) + require.Empty(t, cmp.Diff([]types.Server{node1, node2}, nodes, + cmpopts.IgnoreFields(types.Metadata{}, "ID"))) + + // GetNodes should fail if namespace isn't provided + _, err = presence.GetNodes(ctx, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + }) + t.Run("GetNode", func(t *testing.T) { + t.Parallel() + // Get Node + node, err := presence.GetNode(ctx, apidefaults.Namespace, "node1") + require.NoError(t, err) + require.Empty(t, cmp.Diff(node1, node, + cmpopts.IgnoreFields(types.Metadata{}, "ID"))) + + // GetNode should fail if node name isn't provided + _, err = presence.GetNode(ctx, apidefaults.Namespace, "") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + + // GetNode should fail if namespace isn't provided + _, err = presence.GetNode(ctx, "", "node1") + require.IsType(t, &trace.BadParameterError{}, err.(*trace.TraceErr).OrigError()) + }) + }) + + t.Run("DeleteNode", func(t *testing.T) { + // Delete node. + err = presence.DeleteNode(ctx, apidefaults.Namespace, node1.GetName()) + require.NoError(t, err) + + // Expect node not found + _, err := presence.GetNode(ctx, apidefaults.Namespace, "node1") + require.IsType(t, trace.NotFound(""), err) + }) + + t.Run("DeleteAllNodes", func(t *testing.T) { + // Delete nodes + err = presence.DeleteAllNodes(ctx, apidefaults.Namespace) + require.NoError(t, err) + + // Now expect no nodes to be returned. + nodes, err := presence.GetNodes(ctx, apidefaults.Namespace) + require.NoError(t, err) + require.Equal(t, 0, len(nodes)) + }) +} diff --git a/lib/services/presence.go b/lib/services/presence.go index fa4b16bc6a1..f9979450dff 100644 --- a/lib/services/presence.go +++ b/lib/services/presence.go @@ -40,6 +40,9 @@ type Presence interface { // GetNodes returns a list of registered servers. GetNodes(ctx context.Context, namespace string, opts ...MarshalOption) ([]types.Server, error) + // ListNodes returns a paginated list of registered servers. + ListNodes(ctx context.Context, namespace string, limit int, startKey string) (nodes []types.Server, nextKey string, err error) + // DeleteAllNodes deletes all nodes in a namespace. DeleteAllNodes(ctx context.Context, namespace string) error