From 304a9e6ca5b94198ff49d1e47f17d486e5632e88 Mon Sep 17 00:00:00 2001 From: Radu Berinde Date: Mon, 21 Jun 2021 10:18:51 -0700 Subject: [PATCH] server: add TokenBucket connector API This change adds the TokenBucket API proposed in the RFC (#66436), a stub implementation and client for it, and the corresponding KV connector interface. The client and server-side code lives in ccl/multitenantccl/tenantcostclient and tenantcostserver. Release note: None --- .github/CODEOWNERS | 2 + pkg/ccl/BUILD.bazel | 1 + pkg/ccl/ccl_init.go | 1 + pkg/ccl/kvccl/kvtenantccl/connector.go | 44 +- pkg/ccl/kvccl/kvtenantccl/connector_test.go | 8 +- pkg/ccl/multitenantccl/BUILD.bazel | 12 + pkg/ccl/multitenantccl/doc.go | 15 + .../tenantcostclient/BUILD.bazel | 17 + .../tenantcostclient/tenant_side.go | 80 + .../tenantcostserver/BUILD.bazel | 21 + .../multitenantccl/tenantcostserver/server.go | 38 + .../tenanttokenbucket/BUILD.bazel | 9 + .../tenanttokenbucket/tenant_token_bucket.go | 45 + .../tenantcostserver/token_bucket.go | 87 + pkg/kv/kvclient/kvcoord/send_test.go | 6 + pkg/kv/kvclient/kvcoord/transport_test.go | 6 + pkg/kv/kvclient/kvtenant/connector.go | 12 + pkg/multitenant/BUILD.bazel | 16 + pkg/multitenant/cost_controller.go | 24 + pkg/multitenant/doc.go | 13 + pkg/multitenant/tenant_usage.go | 31 + pkg/roachpb/api.pb.go | 1640 +++++++++++------ pkg/roachpb/api.proto | 26 + pkg/roachpb/mocks_generated.go | 20 + pkg/rpc/auth_tenant.go | 5 + pkg/rpc/context.go | 24 +- pkg/rpc/context_test.go | 6 + pkg/server/BUILD.bazel | 1 + pkg/server/node.go | 51 +- pkg/server/server.go | 9 +- pkg/server/server_sql.go | 5 + pkg/server/tenant.go | 28 + pkg/sql/BUILD.bazel | 1 + pkg/sql/exec_util.go | 5 + 34 files changed, 1763 insertions(+), 546 deletions(-) create mode 100644 pkg/ccl/multitenantccl/BUILD.bazel create mode 100644 pkg/ccl/multitenantccl/doc.go create mode 100644 pkg/ccl/multitenantccl/tenantcostclient/BUILD.bazel create mode 100644 pkg/ccl/multitenantccl/tenantcostclient/tenant_side.go create mode 100644 pkg/ccl/multitenantccl/tenantcostserver/BUILD.bazel create mode 100644 pkg/ccl/multitenantccl/tenantcostserver/server.go create mode 100644 pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket/BUILD.bazel create mode 100644 pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket/tenant_token_bucket.go create mode 100644 pkg/ccl/multitenantccl/tenantcostserver/token_bucket.go create mode 100644 pkg/multitenant/BUILD.bazel create mode 100644 pkg/multitenant/cost_controller.go create mode 100644 pkg/multitenant/doc.go create mode 100644 pkg/multitenant/tenant_usage.go diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index d67d5470adf4..003eb4e2014f 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -102,6 +102,7 @@ /pkg/ccl/kvccl/ @cockroachdb/kv-noreview /pkg/ccl/logictestccl/ @cockroachdb/sql-queries-noreview /pkg/ccl/multiregionccl/ @cockroachdb/sql-queries-noreview +/pkg/ccl/multitenantccl/ @cockroachdb/unowned /pkg/ccl/oidcccl/ @cockroachdb/sql-queries /pkg/ccl/partitionccl/ @cockroachdb/sql-schema /pkg/ccl/serverccl/ @cockroachdb/server-prs @@ -175,6 +176,7 @@ /pkg/jobs/ @cockroachdb/sql-schema /pkg/keys/ @cockroachdb/kv /pkg/migration/ @cockroachdb/kv +/pkg/multitenant @cockroachdb/unowned /pkg/release/ @cockroachdb/dev-inf /pkg/roachpb/ @cockroachdb/kv /pkg/rpc/ @cockroachdb/server-prs diff --git a/pkg/ccl/BUILD.bazel b/pkg/ccl/BUILD.bazel index c802b884a91c..d04d86db5cd4 100644 --- a/pkg/ccl/BUILD.bazel +++ b/pkg/ccl/BUILD.bazel @@ -14,6 +14,7 @@ go_library( "//pkg/ccl/importccl", "//pkg/ccl/kvccl", "//pkg/ccl/multiregionccl", + "//pkg/ccl/multitenantccl", "//pkg/ccl/oidcccl", "//pkg/ccl/partitionccl", "//pkg/ccl/storageccl", diff --git a/pkg/ccl/ccl_init.go b/pkg/ccl/ccl_init.go index 50ccee16324a..3baaccba8c76 100644 --- a/pkg/ccl/ccl_init.go +++ b/pkg/ccl/ccl_init.go @@ -22,6 +22,7 @@ import ( _ "github.com/cockroachdb/cockroach/pkg/ccl/importccl" _ "github.com/cockroachdb/cockroach/pkg/ccl/kvccl" _ "github.com/cockroachdb/cockroach/pkg/ccl/multiregionccl" + _ "github.com/cockroachdb/cockroach/pkg/ccl/multitenantccl" _ "github.com/cockroachdb/cockroach/pkg/ccl/oidcccl" _ "github.com/cockroachdb/cockroach/pkg/ccl/partitionccl" _ "github.com/cockroachdb/cockroach/pkg/ccl/storageccl" diff --git a/pkg/ccl/kvccl/kvtenantccl/connector.go b/pkg/ccl/kvccl/kvtenantccl/connector.go index 0f2ffbceb1e9..62d973ae44ba 100644 --- a/pkg/ccl/kvccl/kvtenantccl/connector.go +++ b/pkg/ccl/kvccl/kvtenantccl/connector.go @@ -44,12 +44,17 @@ func init() { } // Connector mediates the communication of cluster-wide state to sandboxed -// SQL-only tenant processes through a restricted interface. A Connector is -// seeded with a set of one or more network addresses that reference existing KV -// nodes in the cluster (or a load-balancer which fans out to some/all KV -// nodes). On startup, it establishes contact with one of these nodes to learn -// about the topology of the cluster and bootstrap the rest of SQL <-> KV -// network communication. +// SQL-only tenant processes through a restricted interface. +// +// A Connector is instantiated inside a tenant's SQL process and is seeded with +// a set of one or more network addresses that reference existing KV nodes in +// the host cluster (or a load-balancer which fans out to some/all KV nodes). On +// startup, it establishes contact with one of these nodes to learn about the +// topology of the cluster and bootstrap the rest of SQL <-> KV network +// communication. +// +// The Connector communicates with the host cluster through the roachpb.Internal +// API. // // See below for the Connector's roles. type Connector struct { @@ -378,6 +383,33 @@ func (c *Connector) FirstRange() (*roachpb.RangeDescriptor, error) { return nil, status.Error(codes.Unauthenticated, "kvtenant.Proxy does not have access to FirstRange") } +// TokenBucket implements the kvtenant.TokenBucketProvider interface. +func (c *Connector) TokenBucket( + ctx context.Context, in *roachpb.TokenBucketRequest, +) (*roachpb.TokenBucketResponse, error) { + // Proxy token bucket requests through the Internal service. + ctx = c.AnnotateCtx(ctx) + for ctx.Err() == nil { + client, err := c.getClient(ctx) + if err != nil { + continue + } + resp, err := client.TokenBucket(ctx, in) + if err != nil { + log.Warningf(ctx, "error issuing TokenBucket RPC: %v", err) + if grpcutil.IsAuthError(err) { + // Authentication or authorization error. Propagate. + return nil, err + } + // Soft RPC error. Drop client and retry. + c.tryForgetClient(ctx, client) + continue + } + return resp, nil + } + return nil, ctx.Err() +} + // getClient returns the singleton InternalClient if one is currently active. If // not, the method attempts to dial one of the configured addresses. The method // blocks until either a connection is successfully established or the provided diff --git a/pkg/ccl/kvccl/kvtenantccl/connector_test.go b/pkg/ccl/kvccl/kvtenantccl/connector_test.go index d92d792f23ad..bbbb171dae18 100644 --- a/pkg/ccl/kvccl/kvtenantccl/connector_test.go +++ b/pkg/ccl/kvccl/kvtenantccl/connector_test.go @@ -77,12 +77,18 @@ func (*mockServer) RangeFeed(*roachpb.RangeFeedRequest, roachpb.Internal_RangeFe panic("unimplemented") } -func (m *mockServer) Join( +func (*mockServer) Join( context.Context, *roachpb.JoinNodeRequest, ) (*roachpb.JoinNodeResponse, error) { panic("unimplemented") } +func (*mockServer) TokenBucket( + ctx context.Context, in *roachpb.TokenBucketRequest, +) (*roachpb.TokenBucketResponse, error) { + panic("unimplemented") +} + func gossipEventForClusterID(clusterID uuid.UUID) *roachpb.GossipSubscriptionEvent { return &roachpb.GossipSubscriptionEvent{ Key: gossip.KeyClusterID, diff --git a/pkg/ccl/multitenantccl/BUILD.bazel b/pkg/ccl/multitenantccl/BUILD.bazel new file mode 100644 index 000000000000..3b02ccd23532 --- /dev/null +++ b/pkg/ccl/multitenantccl/BUILD.bazel @@ -0,0 +1,12 @@ +load("@io_bazel_rules_go//go:def.bzl", "go_library") + +go_library( + name = "multitenantccl", + srcs = ["doc.go"], + importpath = "github.com/cockroachdb/cockroach/pkg/ccl/multitenantccl", + visibility = ["//visibility:public"], + deps = [ + "//pkg/ccl/multitenantccl/tenantcostclient", + "//pkg/ccl/multitenantccl/tenantcostserver", + ], +) diff --git a/pkg/ccl/multitenantccl/doc.go b/pkg/ccl/multitenantccl/doc.go new file mode 100644 index 000000000000..4f6b78835c9d --- /dev/null +++ b/pkg/ccl/multitenantccl/doc.go @@ -0,0 +1,15 @@ +// Copyright 2021 The Cockroach Authors. +// +// Licensed as a CockroachDB Enterprise file under the Cockroach Community +// License (the "License"); you may not use this file except in compliance with +// the License. You may obtain a copy of the License at +// +// https://github.com/cockroachdb/cockroach/blob/master/licenses/CCL.txt + +package multitenantccl + +import ( + // Imports for the CCL init hooks. + _ "github.com/cockroachdb/cockroach/pkg/ccl/multitenantccl/tenantcostclient" + _ "github.com/cockroachdb/cockroach/pkg/ccl/multitenantccl/tenantcostserver" +) diff --git a/pkg/ccl/multitenantccl/tenantcostclient/BUILD.bazel b/pkg/ccl/multitenantccl/tenantcostclient/BUILD.bazel new file mode 100644 index 000000000000..9b96ea6da3fb --- /dev/null +++ b/pkg/ccl/multitenantccl/tenantcostclient/BUILD.bazel @@ -0,0 +1,17 @@ +load("@io_bazel_rules_go//go:def.bzl", "go_library") + +go_library( + name = "tenantcostclient", + srcs = ["tenant_side.go"], + importpath = "github.com/cockroachdb/cockroach/pkg/ccl/multitenantccl/tenantcostclient", + visibility = ["//visibility:public"], + deps = [ + "//pkg/kv/kvclient/kvtenant", + "//pkg/multitenant", + "//pkg/roachpb:with-mocks", + "//pkg/server", + "//pkg/util/log", + "//pkg/util/stop", + "@com_github_cockroachdb_errors//:errors", + ], +) diff --git a/pkg/ccl/multitenantccl/tenantcostclient/tenant_side.go b/pkg/ccl/multitenantccl/tenantcostclient/tenant_side.go new file mode 100644 index 000000000000..c8c4554e1cb9 --- /dev/null +++ b/pkg/ccl/multitenantccl/tenantcostclient/tenant_side.go @@ -0,0 +1,80 @@ +// Copyright 2021 The Cockroach Authors. +// +// Licensed as a CockroachDB Enterprise file under the Cockroach Community +// License (the "License"); you may not use this file except in compliance with +// the License. You may obtain a copy of the License at +// +// https://github.com/cockroachdb/cockroach/blob/master/licenses/CCL.txt + +package tenantcostclient + +import ( + "context" + "time" + + "github.com/cockroachdb/cockroach/pkg/kv/kvclient/kvtenant" + "github.com/cockroachdb/cockroach/pkg/multitenant" + "github.com/cockroachdb/cockroach/pkg/roachpb" + "github.com/cockroachdb/cockroach/pkg/server" + "github.com/cockroachdb/cockroach/pkg/util/log" + "github.com/cockroachdb/cockroach/pkg/util/stop" + "github.com/cockroachdb/errors" +) + +// NewTenantSideCostController creates an object which implements the +// server.TenantSideCostController interface. +func NewTenantSideCostController( + ctx context.Context, tenantID roachpb.TenantID, provider kvtenant.TokenBucketProvider, +) (multitenant.TenantSideCostController, error) { + if tenantID == roachpb.SystemTenantID { + return nil, errors.AssertionFailedf("cost controller can't be used for system tenant") + } + return &tenantSideCostController{ + tenantID: tenantID, + provider: provider, + }, nil +} + +func init() { + server.NewTenantSideCostController = NewTenantSideCostController +} + +type tenantSideCostController struct { + tenantID roachpb.TenantID + provider kvtenant.TokenBucketProvider +} + +var _ multitenant.TenantSideCostController = (*tenantSideCostController)(nil) + +// Start is part of multitenant.TenantSideCostController. +func (c *tenantSideCostController) Start(ctx context.Context, stopper *stop.Stopper) error { + return stopper.RunAsyncTask(ctx, "cost-controller", func(ctx context.Context) { + c.mainLoop(ctx, stopper) + }) +} + +func (c *tenantSideCostController) mainLoop(ctx context.Context, stopper *stop.Stopper) { + ticker := time.NewTicker(10 * time.Second) + defer ticker.Stop() + + for { + select { + case <-ticker.C: + req := roachpb.TokenBucketRequest{ + ConsumptionSinceLastRequest: roachpb.TokenBucketRequest_Consumption{ + // Report a dummy 1 RU consumption each time. + RU: 1, + SQLPodCPUSeconds: 1, + }, + } + _, err := c.provider.TokenBucket(ctx, &req) + if err != nil { + log.Warningf(ctx, "TokenBucket error: %v", err) + } + + case <-stopper.ShouldQuiesce(): + // TODO(radu): send one last request to update consumption. + return + } + } +} diff --git a/pkg/ccl/multitenantccl/tenantcostserver/BUILD.bazel b/pkg/ccl/multitenantccl/tenantcostserver/BUILD.bazel new file mode 100644 index 000000000000..099226b57d3d --- /dev/null +++ b/pkg/ccl/multitenantccl/tenantcostserver/BUILD.bazel @@ -0,0 +1,21 @@ +load("@io_bazel_rules_go//go:def.bzl", "go_library") + +go_library( + name = "tenantcostserver", + srcs = [ + "server.go", + "token_bucket.go", + ], + importpath = "github.com/cockroachdb/cockroach/pkg/ccl/multitenantccl/tenantcostserver", + visibility = ["//visibility:public"], + deps = [ + "//pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket", + "//pkg/kv", + "//pkg/multitenant", + "//pkg/roachpb:with-mocks", + "//pkg/server", + "//pkg/sql", + "//pkg/util/timeutil", + "@com_github_cockroachdb_errors//:errors", + ], +) diff --git a/pkg/ccl/multitenantccl/tenantcostserver/server.go b/pkg/ccl/multitenantccl/tenantcostserver/server.go new file mode 100644 index 000000000000..73a485ea7a1b --- /dev/null +++ b/pkg/ccl/multitenantccl/tenantcostserver/server.go @@ -0,0 +1,38 @@ +// Copyright 2021 The Cockroach Authors. +// +// Licensed as a CockroachDB Enterprise file under the Cockroach Community +// License (the "License"); you may not use this file except in compliance with +// the License. You may obtain a copy of the License at +// +// https://github.com/cockroachdb/cockroach/blob/master/licenses/CCL.txt + +package tenantcostserver + +import ( + "github.com/cockroachdb/cockroach/pkg/kv" + "github.com/cockroachdb/cockroach/pkg/multitenant" + "github.com/cockroachdb/cockroach/pkg/server" + "github.com/cockroachdb/cockroach/pkg/sql" +) + +type instance struct { + db *kv.DB + executor *sql.InternalExecutor +} + +func newInstance(db *kv.DB, executor *sql.InternalExecutor) *instance { + return &instance{ + db: db, + executor: executor, + } +} + +var _ multitenant.TenantUsageServer = (*instance)(nil) + +func init() { + server.NewTenantUsageServer = func( + db *kv.DB, executor *sql.InternalExecutor, + ) multitenant.TenantUsageServer { + return newInstance(db, executor) + } +} diff --git a/pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket/BUILD.bazel b/pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket/BUILD.bazel new file mode 100644 index 000000000000..34c6d1c756da --- /dev/null +++ b/pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket/BUILD.bazel @@ -0,0 +1,9 @@ +load("@io_bazel_rules_go//go:def.bzl", "go_library") + +go_library( + name = "tenanttokenbucket", + srcs = ["tenant_token_bucket.go"], + importpath = "github.com/cockroachdb/cockroach/pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket", + visibility = ["//visibility:public"], + deps = ["//pkg/roachpb:with-mocks"], +) diff --git a/pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket/tenant_token_bucket.go b/pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket/tenant_token_bucket.go new file mode 100644 index 000000000000..fa3366acbf61 --- /dev/null +++ b/pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket/tenant_token_bucket.go @@ -0,0 +1,45 @@ +// Copyright 2021 The Cockroach Authors. +// +// Licensed as a CockroachDB Enterprise file under the Cockroach Community +// License (the "License"); you may not use this file except in compliance with +// the License. You may obtain a copy of the License at +// +// https://github.com/cockroachdb/cockroach/blob/master/licenses/CCL.txt + +// Package tenanttokenbucket implements the tenant token bucket server-side +// algorithm described in the distributed token bucket RFC. It has minimal +// dependencies and is meant to be testable on its own. +package tenanttokenbucket + +import ( + "time" + + "github.com/cockroachdb/cockroach/pkg/roachpb" +) + +// State of the distributed token bucket. +type State struct { + // RUBurstLimit is the burst limit in RUs. + RUBurstLimit float64 + // RURefillRate is the refill rate in RUs/second. + RURefillRate float64 + + // RUCurrent is the available (burst) RUs. + RUCurrent float64 + + // CurrentShareSum is the sum of the last reported share value for + // each active SQL pod for the tenant. + CurrentShareSum float64 +} + +// Request processes a request for more tokens and updates the State +// accordingly. +func (s *State) Request( + req *roachpb.TokenBucketRequest, now time.Time, +) roachpb.TokenBucketResponse { + var res roachpb.TokenBucketResponse + // TODO(radu): fill in response. + return res +} + +// TODO(radu): add Reconfigure API. diff --git a/pkg/ccl/multitenantccl/tenantcostserver/token_bucket.go b/pkg/ccl/multitenantccl/tenantcostserver/token_bucket.go new file mode 100644 index 000000000000..1fd438312719 --- /dev/null +++ b/pkg/ccl/multitenantccl/tenantcostserver/token_bucket.go @@ -0,0 +1,87 @@ +// Copyright 2021 The Cockroach Authors. +// +// Licensed as a CockroachDB Enterprise file under the Cockroach Community +// License (the "License"); you may not use this file except in compliance with +// the License. You may obtain a copy of the License at +// +// https://github.com/cockroachdb/cockroach/blob/master/licenses/CCL.txt + +package tenantcostserver + +import ( + "context" + + "github.com/cockroachdb/cockroach/pkg/ccl/multitenantccl/tenantcostserver/tenanttokenbucket" + "github.com/cockroachdb/cockroach/pkg/kv" + "github.com/cockroachdb/cockroach/pkg/roachpb" + "github.com/cockroachdb/cockroach/pkg/sql" + "github.com/cockroachdb/cockroach/pkg/util/timeutil" + "github.com/cockroachdb/errors" +) + +// TokenBucketRequest is part of the multitenant.TenantUsageServer and +// implements the TokenBucket API of the roachpb.Internal service. This code +// runs on the host cluster to service requests coming from tenants (through the +// kvtenant.Connector). +func (s *instance) TokenBucketRequest( + ctx context.Context, tenantID roachpb.TenantID, in *roachpb.TokenBucketRequest, +) (*roachpb.TokenBucketResponse, error) { + if tenantID == roachpb.SystemTenantID { + return nil, errors.New("token bucket request for system tenant") + } + + result := &roachpb.TokenBucketResponse{} + if err := s.db.Txn(ctx, func(ctx context.Context, txn *kv.Txn) error { + state, err := readTenantUsageState(ctx, s.executor, txn, tenantID) + if err != nil { + return err + } + state.Seq++ + + // Update consumption. + state.Consumption.RU += in.ConsumptionSinceLastRequest.RU + state.Consumption.ReadRequests += in.ConsumptionSinceLastRequest.ReadRequests + state.Consumption.ReadBytes += in.ConsumptionSinceLastRequest.ReadBytes + state.Consumption.WriteRequests += in.ConsumptionSinceLastRequest.WriteRequests + state.Consumption.WriteBytes += in.ConsumptionSinceLastRequest.WriteBytes + state.Consumption.SQLPodCPUSeconds += in.ConsumptionSinceLastRequest.SQLPodCPUSeconds + + *result = state.Bucket.Request(in, timeutil.Now()) + + return updateTenantUsageState(ctx, s.executor, txn, tenantID, state) + }); err != nil { + return nil, err + } + return result, nil +} + +type tenantUsageState struct { + // Seq is a sequence number identifying this state. All state changes are + // strictly sequenced, with consecutive sequence numbers. + Seq int64 + + Bucket tenanttokenbucket.State + + // Current consumption information. + Consumption roachpb.TokenBucketRequest_Consumption +} + +// readCurrentBucketState reads the current (last) bucket state. The zero struct +// is returned if the state is not yet initialized. +func readTenantUsageState( + ctx context.Context, ex *sql.InternalExecutor, txn *kv.Txn, tenantID roachpb.TenantID, +) (tenantUsageState, error) { + // TODO(radu): interact with the system table. + return tenantUsageState{}, nil +} + +func updateTenantUsageState( + ctx context.Context, + ex *sql.InternalExecutor, + txn *kv.Txn, + tenantID roachpb.TenantID, + newState tenantUsageState, +) error { + // TODO(radu): interact with the system table. + return nil +} diff --git a/pkg/kv/kvclient/kvcoord/send_test.go b/pkg/kv/kvclient/kvcoord/send_test.go index 46bbc64fdf9f..5fec0a764389 100644 --- a/pkg/kv/kvclient/kvcoord/send_test.go +++ b/pkg/kv/kvclient/kvcoord/send_test.go @@ -74,6 +74,12 @@ func (n Node) ResetQuorum( panic("unimplemented") } +func (n Node) TokenBucket( + ctx context.Context, in *roachpb.TokenBucketRequest, +) (*roachpb.TokenBucketResponse, error) { + panic("unimplemented") +} + // TestSendToOneClient verifies that Send correctly sends a request // to one server using the heartbeat RPC. func TestSendToOneClient(t *testing.T) { diff --git a/pkg/kv/kvclient/kvcoord/transport_test.go b/pkg/kv/kvclient/kvcoord/transport_test.go index 799a38bc97d9..3ef145a9f41b 100644 --- a/pkg/kv/kvclient/kvcoord/transport_test.go +++ b/pkg/kv/kvclient/kvcoord/transport_test.go @@ -191,3 +191,9 @@ func (m *mockInternalClient) Join( ) (*roachpb.JoinNodeResponse, error) { return nil, fmt.Errorf("unsupported Join call") } + +func (m *mockInternalClient) TokenBucket( + ctx context.Context, in *roachpb.TokenBucketRequest, _ ...grpc.CallOption, +) (*roachpb.TokenBucketResponse, error) { + return nil, fmt.Errorf("unsupported TokenBucket call") +} diff --git a/pkg/kv/kvclient/kvtenant/connector.go b/pkg/kv/kvclient/kvtenant/connector.go index 41fbf186a4e1..35802ebc7b48 100644 --- a/pkg/kv/kvclient/kvtenant/connector.go +++ b/pkg/kv/kvclient/kvtenant/connector.go @@ -64,6 +64,18 @@ type Connector interface { // This is necessary for region validation for zone configurations and // multi-region primitives. serverpb.RegionsServer + + // Connector is capable of providing an endpoint for the TokenBucket API. + TokenBucketProvider +} + +// TokenBucketProvider supplies an endpoint (to tenants) for the TokenBucket API +// (defined in roachpb.Internal), used to interact with the tenant cost control +// token bucket. +type TokenBucketProvider interface { + TokenBucket( + ctx context.Context, in *roachpb.TokenBucketRequest, + ) (*roachpb.TokenBucketResponse, error) } // ConnectorConfig encompasses the configuration required to create a Connector. diff --git a/pkg/multitenant/BUILD.bazel b/pkg/multitenant/BUILD.bazel new file mode 100644 index 000000000000..3df4384bb444 --- /dev/null +++ b/pkg/multitenant/BUILD.bazel @@ -0,0 +1,16 @@ +load("@io_bazel_rules_go//go:def.bzl", "go_library") + +go_library( + name = "multitenant", + srcs = [ + "cost_controller.go", + "doc.go", + "tenant_usage.go", + ], + importpath = "github.com/cockroachdb/cockroach/pkg/multitenant", + visibility = ["//visibility:public"], + deps = [ + "//pkg/roachpb:with-mocks", + "//pkg/util/stop", + ], +) diff --git a/pkg/multitenant/cost_controller.go b/pkg/multitenant/cost_controller.go new file mode 100644 index 000000000000..a3c49493c8ad --- /dev/null +++ b/pkg/multitenant/cost_controller.go @@ -0,0 +1,24 @@ +// Copyright 2021 The Cockroach Authors. +// +// Use of this software is governed by the Business Source License +// included in the file licenses/BSL.txt. +// +// As of the Change Date specified in that file, in accordance with +// the Business Source License, use of this software will be governed +// by the Apache License, Version 2.0, included in the file +// licenses/APL.txt. + +package multitenant + +import ( + "context" + + "github.com/cockroachdb/cockroach/pkg/util/stop" +) + +// TenantSideCostController is an interface through which tenant code reports +// and throttles resource usage. Its implementation lives in the +// tenantcostclient CCL package. +type TenantSideCostController interface { + Start(ctx context.Context, stopper *stop.Stopper) error +} diff --git a/pkg/multitenant/doc.go b/pkg/multitenant/doc.go new file mode 100644 index 000000000000..6c43347f2c01 --- /dev/null +++ b/pkg/multitenant/doc.go @@ -0,0 +1,13 @@ +// Copyright 2021 The Cockroach Authors. +// +// Use of this software is governed by the Business Source License +// included in the file licenses/BSL.txt. +// +// As of the Change Date specified in that file, in accordance with +// the Business Source License, use of this software will be governed +// by the Apache License, Version 2.0, included in the file +// licenses/APL.txt. + +// Package multitenant defines interfaces that are used internally for +// multi-tenant specific functionality. +package multitenant diff --git a/pkg/multitenant/tenant_usage.go b/pkg/multitenant/tenant_usage.go new file mode 100644 index 000000000000..7fca11450716 --- /dev/null +++ b/pkg/multitenant/tenant_usage.go @@ -0,0 +1,31 @@ +// Copyright 2021 The Cockroach Authors. +// +// Use of this software is governed by the Business Source License +// included in the file licenses/BSL.txt. +// +// As of the Change Date specified in that file, in accordance with +// the Business Source License, use of this software will be governed +// by the Apache License, Version 2.0, included in the file +// licenses/APL.txt. + +package multitenant + +import ( + "context" + + "github.com/cockroachdb/cockroach/pkg/roachpb" +) + +// TenantUsageServer is an interface through which tenant usage is reported and +// controlled, used on the host server side. Its implementation lives in the +// tenantcostserver CCL package. +type TenantUsageServer interface { + // TokenBucketRequest implements the TokenBucket API of the roachpb.Internal + // service. Used to to service requests coming from tenants (through the + // kvtenant.Connector) + TokenBucketRequest( + ctx context.Context, tenantID roachpb.TenantID, in *roachpb.TokenBucketRequest, + ) (*roachpb.TokenBucketResponse, error) + + // TODO(radu): add Reconfigure API. +} diff --git a/pkg/roachpb/api.pb.go b/pkg/roachpb/api.pb.go index 5a0160e269fd..f26799871e45 100644 --- a/pkg/roachpb/api.pb.go +++ b/pkg/roachpb/api.pb.go @@ -6873,6 +6873,110 @@ func (m *GossipSubscriptionEvent) XXX_DiscardUnknown() { var xxx_messageInfo_GossipSubscriptionEvent proto.InternalMessageInfo +type TokenBucketRequest struct { + // Consumption that occurred since this node's last request. + ConsumptionSinceLastRequest TokenBucketRequest_Consumption `protobuf:"bytes,1,opt,name=consumption_since_last_request,json=consumptionSinceLastRequest,proto3" json:"consumption_since_last_request"` +} + +func (m *TokenBucketRequest) Reset() { *m = TokenBucketRequest{} } +func (m *TokenBucketRequest) String() string { return proto.CompactTextString(m) } +func (*TokenBucketRequest) ProtoMessage() {} +func (*TokenBucketRequest) Descriptor() ([]byte, []int) { + return fileDescriptor_e08772acc330f58b, []int{109} +} +func (m *TokenBucketRequest) XXX_Unmarshal(b []byte) error { + return m.Unmarshal(b) +} +func (m *TokenBucketRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + b = b[:cap(b)] + n, err := m.MarshalToSizedBuffer(b) + if err != nil { + return nil, err + } + return b[:n], nil +} +func (m *TokenBucketRequest) XXX_Merge(src proto.Message) { + xxx_messageInfo_TokenBucketRequest.Merge(m, src) +} +func (m *TokenBucketRequest) XXX_Size() int { + return m.Size() +} +func (m *TokenBucketRequest) XXX_DiscardUnknown() { + xxx_messageInfo_TokenBucketRequest.DiscardUnknown(m) +} + +var xxx_messageInfo_TokenBucketRequest proto.InternalMessageInfo + +type TokenBucketRequest_Consumption struct { + RU float64 `protobuf:"fixed64,1,opt,name=r_u,json=rU,proto3" json:"r_u,omitempty"` + ReadRequests uint64 `protobuf:"varint,2,opt,name=read_requests,json=readRequests,proto3" json:"read_requests,omitempty"` + ReadBytes uint64 `protobuf:"varint,3,opt,name=read_bytes,json=readBytes,proto3" json:"read_bytes,omitempty"` + WriteRequests uint64 `protobuf:"varint,4,opt,name=write_requests,json=writeRequests,proto3" json:"write_requests,omitempty"` + WriteBytes uint64 `protobuf:"varint,5,opt,name=write_bytes,json=writeBytes,proto3" json:"write_bytes,omitempty"` + SQLPodCPUSeconds float64 `protobuf:"fixed64,6,opt,name=sql_pod_cpu_seconds,json=sqlPodCpuSeconds,proto3" json:"sql_pod_cpu_seconds,omitempty"` +} + +func (m *TokenBucketRequest_Consumption) Reset() { *m = TokenBucketRequest_Consumption{} } +func (m *TokenBucketRequest_Consumption) String() string { return proto.CompactTextString(m) } +func (*TokenBucketRequest_Consumption) ProtoMessage() {} +func (*TokenBucketRequest_Consumption) Descriptor() ([]byte, []int) { + return fileDescriptor_e08772acc330f58b, []int{109, 0} +} +func (m *TokenBucketRequest_Consumption) XXX_Unmarshal(b []byte) error { + return m.Unmarshal(b) +} +func (m *TokenBucketRequest_Consumption) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + b = b[:cap(b)] + n, err := m.MarshalToSizedBuffer(b) + if err != nil { + return nil, err + } + return b[:n], nil +} +func (m *TokenBucketRequest_Consumption) XXX_Merge(src proto.Message) { + xxx_messageInfo_TokenBucketRequest_Consumption.Merge(m, src) +} +func (m *TokenBucketRequest_Consumption) XXX_Size() int { + return m.Size() +} +func (m *TokenBucketRequest_Consumption) XXX_DiscardUnknown() { + xxx_messageInfo_TokenBucketRequest_Consumption.DiscardUnknown(m) +} + +var xxx_messageInfo_TokenBucketRequest_Consumption proto.InternalMessageInfo + +type TokenBucketResponse struct { +} + +func (m *TokenBucketResponse) Reset() { *m = TokenBucketResponse{} } +func (m *TokenBucketResponse) String() string { return proto.CompactTextString(m) } +func (*TokenBucketResponse) ProtoMessage() {} +func (*TokenBucketResponse) Descriptor() ([]byte, []int) { + return fileDescriptor_e08772acc330f58b, []int{110} +} +func (m *TokenBucketResponse) XXX_Unmarshal(b []byte) error { + return m.Unmarshal(b) +} +func (m *TokenBucketResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) { + b = b[:cap(b)] + n, err := m.MarshalToSizedBuffer(b) + if err != nil { + return nil, err + } + return b[:n], nil +} +func (m *TokenBucketResponse) XXX_Merge(src proto.Message) { + xxx_messageInfo_TokenBucketResponse.Merge(m, src) +} +func (m *TokenBucketResponse) XXX_Size() int { + return m.Size() +} +func (m *TokenBucketResponse) XXX_DiscardUnknown() { + xxx_messageInfo_TokenBucketResponse.DiscardUnknown(m) +} + +var xxx_messageInfo_TokenBucketResponse proto.InternalMessageInfo + // JoinNodeRequest is used to specify to the server node what the client's // binary version is. If it's not compatible with the rest of the cluster, the // join attempt is refused. @@ -6884,7 +6988,7 @@ func (m *JoinNodeRequest) Reset() { *m = JoinNodeRequest{} } func (m *JoinNodeRequest) String() string { return proto.CompactTextString(m) } func (*JoinNodeRequest) ProtoMessage() {} func (*JoinNodeRequest) Descriptor() ([]byte, []int) { - return fileDescriptor_e08772acc330f58b, []int{109} + return fileDescriptor_e08772acc330f58b, []int{111} } func (m *JoinNodeRequest) XXX_Unmarshal(b []byte) error { return m.Unmarshal(b) @@ -6923,7 +7027,7 @@ func (m *JoinNodeResponse) Reset() { *m = JoinNodeResponse{} } func (m *JoinNodeResponse) String() string { return proto.CompactTextString(m) } func (*JoinNodeResponse) ProtoMessage() {} func (*JoinNodeResponse) Descriptor() ([]byte, []int) { - return fileDescriptor_e08772acc330f58b, []int{110} + return fileDescriptor_e08772acc330f58b, []int{112} } func (m *JoinNodeResponse) XXX_Unmarshal(b []byte) error { return m.Unmarshal(b) @@ -6963,7 +7067,7 @@ type ContentionEvent struct { func (m *ContentionEvent) Reset() { *m = ContentionEvent{} } func (*ContentionEvent) ProtoMessage() {} func (*ContentionEvent) Descriptor() ([]byte, []int) { - return fileDescriptor_e08772acc330f58b, []int{111} + return fileDescriptor_e08772acc330f58b, []int{113} } func (m *ContentionEvent) XXX_Unmarshal(b []byte) error { return m.Unmarshal(b) @@ -7121,6 +7225,9 @@ func init() { proto.RegisterType((*ResetQuorumResponse)(nil), "cockroach.roachpb.ResetQuorumResponse") proto.RegisterType((*GossipSubscriptionRequest)(nil), "cockroach.roachpb.GossipSubscriptionRequest") proto.RegisterType((*GossipSubscriptionEvent)(nil), "cockroach.roachpb.GossipSubscriptionEvent") + proto.RegisterType((*TokenBucketRequest)(nil), "cockroach.roachpb.TokenBucketRequest") + proto.RegisterType((*TokenBucketRequest_Consumption)(nil), "cockroach.roachpb.TokenBucketRequest.Consumption") + proto.RegisterType((*TokenBucketResponse)(nil), "cockroach.roachpb.TokenBucketResponse") proto.RegisterType((*JoinNodeRequest)(nil), "cockroach.roachpb.JoinNodeRequest") proto.RegisterType((*JoinNodeResponse)(nil), "cockroach.roachpb.JoinNodeResponse") proto.RegisterType((*ContentionEvent)(nil), "cockroach.roachpb.ContentionEvent") @@ -7129,520 +7236,532 @@ func init() { func init() { proto.RegisterFile("roachpb/api.proto", fileDescriptor_e08772acc330f58b) } var fileDescriptor_e08772acc330f58b = []byte{ - // 8195 bytes of a gzipped FileDescriptorProto + // 8392 bytes of a gzipped FileDescriptorProto 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xe4, 0x7d, 0x5f, 0x6c, 0x23, 0x49, - 0x7a, 0x9f, 0x9a, 0xa4, 0x24, 0xf2, 0xa3, 0x44, 0xb6, 0x4a, 0xf3, 0x47, 0xa3, 0xdd, 0x95, 0x66, - 0x7a, 0x76, 0xfe, 0xfa, 0x96, 0xda, 0x99, 0xb9, 0xcb, 0xad, 0x77, 0xd7, 0x7b, 0x16, 0x29, 0xce, - 0x90, 0xd2, 0x48, 0xa3, 0x69, 0x52, 0x33, 0xd8, 0xf5, 0x39, 0xed, 0x56, 0x77, 0x89, 0xea, 0x13, - 0xd9, 0xcd, 0xe9, 0x6e, 0x6a, 0xc4, 0x05, 0xf2, 0x90, 0xc4, 0x70, 0xee, 0x29, 0xb8, 0x00, 0x01, - 0x7c, 0x07, 0x07, 0xc1, 0x39, 0x36, 0x92, 0x87, 0x3c, 0x24, 0x88, 0x83, 0xfc, 0x43, 0x12, 0x23, - 0x4f, 0x39, 0x04, 0x87, 0xdc, 0x19, 0xc8, 0x83, 0x11, 0x20, 0x8a, 0xa3, 0xcb, 0x43, 0x0c, 0x23, - 0x48, 0x10, 0x04, 0x30, 0xb0, 0x40, 0x82, 0xa0, 0xfe, 0xf4, 0x3f, 0xb2, 0x49, 0x51, 0xb3, 0x7d, - 0xf1, 0x02, 0x7e, 0x91, 0xd8, 0x5f, 0xd5, 0xf7, 0x75, 0xd5, 0x57, 0x55, 0x5f, 0x7d, 0xbf, 0xaa, - 0xaf, 0xaa, 0x61, 0xc1, 0xb6, 0x54, 0xed, 0xb0, 0xbb, 0xbf, 0xa6, 0x76, 0x8d, 0x52, 0xd7, 0xb6, - 0x5c, 0x0b, 0x2d, 0x68, 0x96, 0x76, 0x44, 0xc9, 0x25, 0x9e, 0xb8, 0x7c, 0xff, 0xe8, 0x78, 0xed, - 0xe8, 0xd8, 0xc1, 0xf6, 0x31, 0xb6, 0xd7, 0x34, 0xcb, 0xd4, 0x7a, 0xb6, 0x8d, 0x4d, 0xad, 0xbf, - 0xd6, 0xb6, 0xb4, 0x23, 0xfa, 0xc7, 0x30, 0x5b, 0x8c, 0x3d, 0x9a, 0xd7, 0xc6, 0xaa, 0xee, 0xf4, - 0x3a, 0x1d, 0xd5, 0xee, 0xaf, 0xd9, 0x4e, 0x77, 0x7f, 0x8d, 0x3f, 0xf0, 0xbc, 0xc8, 0x7b, 0xbb, - 0xae, 0xba, 0x2a, 0xa7, 0x5d, 0xf2, 0x68, 0xd8, 0xb6, 0x2d, 0xdb, 0xe1, 0xd4, 0x2b, 0x1e, 0xb5, - 0x83, 0x5d, 0x35, 0x94, 0xfb, 0x2d, 0xc7, 0xb5, 0x6c, 0xb5, 0x85, 0xd7, 0xb0, 0xd9, 0x32, 0x4c, - 0x4c, 0x32, 0x1c, 0x6b, 0x1a, 0x4f, 0x7c, 0x3b, 0x36, 0xf1, 0x11, 0x4f, 0x5d, 0xea, 0xb9, 0x46, - 0x7b, 0xed, 0xb0, 0xad, 0xad, 0xb9, 0x46, 0x07, 0x3b, 0xae, 0xda, 0xe9, 0x7a, 0x55, 0xa0, 0x29, - 0xae, 0xad, 0x6a, 0x86, 0xd9, 0xf2, 0xfe, 0x77, 0xf7, 0xd7, 0x6c, 0xac, 0x59, 0xb6, 0x8e, 0x75, - 0xc5, 0xe9, 0xaa, 0xa6, 0x57, 0xdc, 0x96, 0xd5, 0xb2, 0xe8, 0xcf, 0x35, 0xf2, 0x8b, 0x53, 0x57, - 0x5a, 0x96, 0xd5, 0x6a, 0xe3, 0x35, 0xfa, 0xb4, 0xdf, 0x3b, 0x58, 0xd3, 0x7b, 0xb6, 0xea, 0x1a, - 0x16, 0xe7, 0x92, 0xfe, 0x89, 0x00, 0xf3, 0x32, 0x7e, 0xd5, 0xc3, 0x8e, 0x5b, 0xc3, 0xaa, 0x8e, - 0x6d, 0x74, 0x0d, 0xd2, 0x47, 0xb8, 0xbf, 0x94, 0xbe, 0x2e, 0xdc, 0x9d, 0x2b, 0xcf, 0x7e, 0x71, - 0xba, 0x9a, 0xde, 0xc2, 0x7d, 0x99, 0xd0, 0xd0, 0x75, 0x98, 0xc5, 0xa6, 0xae, 0x90, 0xe4, 0x4c, - 0x34, 0x79, 0x06, 0x9b, 0xfa, 0x16, 0xee, 0xa3, 0x6f, 0x43, 0xd6, 0x21, 0xd2, 0x4c, 0x0d, 0x2f, - 0x4d, 0x5f, 0x17, 0xee, 0x4e, 0x97, 0x7f, 0xf9, 0x8b, 0xd3, 0xd5, 0x8f, 0x5b, 0x86, 0x7b, 0xd8, - 0xdb, 0x2f, 0x69, 0x56, 0x67, 0xcd, 0x6f, 0x53, 0x7d, 0x3f, 0xf8, 0xbd, 0xd6, 0x3d, 0x6a, 0xad, - 0x0d, 0xea, 0xa8, 0xd4, 0x3c, 0x31, 0x1b, 0xf8, 0x95, 0xec, 0x4b, 0xdc, 0xcc, 0x64, 0x05, 0x31, - 0xb5, 0x99, 0xc9, 0xa6, 0xc4, 0xb4, 0xf4, 0x93, 0x14, 0x14, 0x64, 0xec, 0x74, 0x2d, 0xd3, 0xc1, - 0xbc, 0xe4, 0xef, 0x43, 0xda, 0x3d, 0x31, 0x69, 0xc9, 0xf3, 0x0f, 0x57, 0x4a, 0x43, 0xbd, 0xa7, - 0xd4, 0xb4, 0x55, 0xd3, 0x51, 0x35, 0x52, 0x7d, 0x99, 0x64, 0x45, 0x1f, 0x40, 0xde, 0xc6, 0x4e, - 0xaf, 0x83, 0xa9, 0x22, 0x69, 0xa5, 0xf2, 0x0f, 0xaf, 0xc6, 0x70, 0x36, 0xba, 0xaa, 0x29, 0x03, - 0xcb, 0x4b, 0x7e, 0xa3, 0x06, 0xcc, 0x73, 0x4e, 0x1b, 0xab, 0x8e, 0x65, 0x2e, 0xcd, 0x5e, 0x17, - 0xee, 0x16, 0x1e, 0x96, 0x62, 0x78, 0xa3, 0xa5, 0x24, 0x8f, 0xbd, 0x0e, 0x96, 0x29, 0x97, 0x3c, - 0x67, 0x87, 0x9e, 0xd0, 0x35, 0xc8, 0x9a, 0xbd, 0x0e, 0xd1, 0xaf, 0x43, 0xb5, 0x97, 0x96, 0x67, - 0xcd, 0x5e, 0x67, 0x0b, 0xf7, 0x1d, 0xf4, 0x16, 0xe4, 0x48, 0xd2, 0x7e, 0xdf, 0xc5, 0xce, 0x52, - 0x96, 0xa6, 0x91, 0xbc, 0x65, 0xf2, 0x2c, 0x7d, 0x02, 0x73, 0x61, 0xa9, 0x08, 0x41, 0x41, 0xae, - 0x36, 0xf6, 0xb6, 0xab, 0xca, 0xde, 0xce, 0xd6, 0xce, 0xb3, 0x97, 0x3b, 0xe2, 0x14, 0xba, 0x04, - 0x22, 0xa7, 0x6d, 0x55, 0x3f, 0x55, 0x9e, 0xd6, 0xb7, 0xeb, 0x4d, 0x51, 0x58, 0xce, 0x7c, 0xf7, - 0x77, 0x56, 0xa6, 0x36, 0x33, 0xd9, 0x19, 0x71, 0x56, 0xfa, 0x1d, 0x01, 0xe0, 0x09, 0x76, 0x79, - 0x6f, 0x40, 0x65, 0x98, 0x39, 0xa4, 0x25, 0x5e, 0x12, 0xa8, 0x5a, 0xae, 0xc7, 0x56, 0x2d, 0xd4, - 0x73, 0xca, 0xd9, 0x1f, 0x9d, 0xae, 0x4e, 0xfd, 0xf4, 0x74, 0x55, 0x90, 0x39, 0x27, 0x7a, 0x0e, - 0xf9, 0x23, 0xdc, 0x57, 0xf8, 0xb8, 0x5c, 0x4a, 0x51, 0x1d, 0xbd, 0x1f, 0x12, 0x74, 0x74, 0x5c, - 0xf2, 0x86, 0x68, 0x29, 0x34, 0x9c, 0x4b, 0x84, 0xa3, 0xd4, 0x70, 0x6d, 0x6c, 0xb6, 0xdc, 0x43, - 0x19, 0x8e, 0x70, 0xff, 0x29, 0x93, 0x21, 0xfd, 0xbe, 0x00, 0x79, 0x5a, 0x4a, 0xa6, 0x54, 0x54, - 0x19, 0x28, 0xe6, 0x8d, 0x73, 0x5b, 0x20, 0xa6, 0x9c, 0x25, 0x98, 0x3e, 0x56, 0xdb, 0x3d, 0x4c, - 0x4b, 0x98, 0x7f, 0xb8, 0x14, 0x23, 0xe3, 0x05, 0x49, 0x97, 0x59, 0x36, 0xf4, 0x11, 0xcc, 0x19, - 0xa6, 0x8b, 0x4d, 0x57, 0x61, 0x6c, 0xe9, 0x73, 0xd8, 0xf2, 0x2c, 0x37, 0x7d, 0x90, 0xfe, 0xb1, - 0x00, 0xb0, 0xdb, 0x4b, 0x54, 0xcf, 0x5f, 0x9f, 0xb0, 0xfc, 0xe5, 0x0c, 0x61, 0xf5, 0x6a, 0x71, - 0x05, 0x66, 0x0c, 0xb3, 0x6d, 0x98, 0xac, 0xfc, 0x59, 0x99, 0x3f, 0xa1, 0x4b, 0x30, 0xbd, 0xdf, - 0x36, 0x4c, 0x9d, 0x8e, 0x87, 0xac, 0xcc, 0x1e, 0x24, 0x19, 0xf2, 0xb4, 0xd4, 0x09, 0xea, 0x5d, - 0x3a, 0x4d, 0xc1, 0xe5, 0x8a, 0x65, 0xea, 0x06, 0x19, 0x92, 0x6a, 0xfb, 0x2b, 0xa1, 0x95, 0x4d, - 0xb8, 0xa4, 0xe3, 0xae, 0x8d, 0x35, 0xd5, 0xc5, 0xba, 0x82, 0x4f, 0xba, 0x13, 0xb6, 0x31, 0x0a, - 0xb8, 0xaa, 0x27, 0x5d, 0x4a, 0x23, 0xa3, 0x96, 0x08, 0x60, 0xa3, 0x76, 0x86, 0x98, 0x4c, 0x39, - 0x8b, 0x4f, 0xba, 0x74, 0xd4, 0xc6, 0xab, 0x19, 0x7d, 0x1d, 0xae, 0xaa, 0xed, 0xb6, 0xf5, 0x5a, - 0x31, 0x0e, 0x14, 0xdd, 0xc2, 0x8e, 0x62, 0x5a, 0xae, 0x82, 0x4f, 0x0c, 0xc7, 0xa5, 0x26, 0x21, - 0x2b, 0x2f, 0xd2, 0xe4, 0xfa, 0xc1, 0x86, 0x85, 0x9d, 0x1d, 0xcb, 0xad, 0x92, 0xa4, 0x50, 0x53, - 0xce, 0x86, 0x9b, 0x52, 0xfa, 0x55, 0xb8, 0x32, 0xa8, 0xdf, 0x24, 0xdb, 0xef, 0xc7, 0x02, 0x14, - 0xea, 0xa6, 0xe1, 0x7e, 0x25, 0x1a, 0xce, 0xd7, 0x67, 0x3a, 0xac, 0xcf, 0xfb, 0x20, 0x1e, 0xa8, - 0x46, 0xfb, 0x99, 0xd9, 0xb4, 0x3a, 0xfb, 0x8e, 0x6b, 0x99, 0xd8, 0xe1, 0x0a, 0x1f, 0xa2, 0x4b, - 0x2f, 0xa0, 0xe8, 0xd7, 0x26, 0x49, 0x35, 0xb9, 0x20, 0xd6, 0x4d, 0xcd, 0xc6, 0x1d, 0x6c, 0x26, - 0xaa, 0xa7, 0xb7, 0x21, 0x67, 0x78, 0x72, 0xa9, 0xae, 0xd2, 0x72, 0x40, 0x90, 0x7a, 0xb0, 0x10, - 0x7a, 0x6b, 0x92, 0xe6, 0x92, 0x4c, 0x46, 0xf8, 0xb5, 0x12, 0xb4, 0x11, 0x99, 0x8c, 0xf0, 0x6b, - 0x66, 0xde, 0x1a, 0x30, 0xbf, 0x81, 0xdb, 0xd8, 0xc5, 0x09, 0xd6, 0x54, 0xda, 0x83, 0x82, 0x27, - 0x34, 0xc9, 0x86, 0xf9, 0x4d, 0x01, 0x10, 0x97, 0xab, 0x9a, 0xad, 0x24, 0x4b, 0x8c, 0x56, 0x89, - 0x6b, 0xe1, 0xf6, 0x6c, 0x93, 0x4d, 0xe7, 0xac, 0x4f, 0x02, 0x23, 0xd1, 0x19, 0x3d, 0x18, 0xb2, - 0x99, 0xf0, 0x90, 0xe5, 0xee, 0xcd, 0x6b, 0x58, 0x8c, 0x14, 0x2c, 0xd9, 0xe6, 0xcb, 0xd0, 0x32, - 0xa5, 0xae, 0xa7, 0xc3, 0x3e, 0x1c, 0x25, 0x4a, 0xdf, 0x17, 0x60, 0xa1, 0xd2, 0xc6, 0xaa, 0x9d, - 0xb8, 0x46, 0xbe, 0x05, 0x59, 0x1d, 0xab, 0x3a, 0xad, 0x32, 0x1b, 0xd8, 0xef, 0x84, 0xa4, 0x10, - 0x4f, 0xb7, 0x74, 0xd8, 0xd6, 0x4a, 0x4d, 0xcf, 0x07, 0xe6, 0xa3, 0xdb, 0x67, 0x92, 0x3e, 0x05, - 0x14, 0x2e, 0x59, 0x92, 0x1d, 0xe1, 0x77, 0x53, 0x80, 0x64, 0x7c, 0x8c, 0x6d, 0x37, 0xf1, 0x6a, - 0x6f, 0x40, 0xde, 0x55, 0xed, 0x16, 0x76, 0x15, 0xe2, 0xdd, 0x5f, 0xa4, 0xe6, 0xc0, 0xf8, 0x08, - 0x19, 0x35, 0xe1, 0x0e, 0x36, 0xd5, 0xfd, 0x36, 0xa6, 0x52, 0x94, 0x7d, 0xab, 0x67, 0xea, 0x8a, - 0xe1, 0x62, 0x5b, 0x75, 0x2d, 0x5b, 0xb1, 0xba, 0xae, 0xd1, 0x31, 0x3e, 0xa7, 0x8e, 0x3d, 0xef, - 0x6a, 0x37, 0x59, 0x76, 0xc2, 0x5c, 0x26, 0x99, 0xeb, 0x3c, 0xef, 0xb3, 0x50, 0x56, 0x54, 0x82, - 0x45, 0xa3, 0x65, 0x5a, 0x36, 0x56, 0x5a, 0x9a, 0xe2, 0x1e, 0xda, 0xd8, 0x39, 0xb4, 0xda, 0xde, - 0x84, 0xb4, 0xc0, 0x92, 0x9e, 0x68, 0x4d, 0x2f, 0x41, 0xfa, 0x0c, 0x16, 0x23, 0x5a, 0x4a, 0xb2, - 0x09, 0xfe, 0xa7, 0x00, 0xf9, 0x86, 0xa6, 0x9a, 0x49, 0xea, 0xfe, 0x13, 0xc8, 0x3b, 0x9a, 0x6a, - 0x2a, 0x07, 0x96, 0xdd, 0x51, 0x5d, 0x5a, 0xaf, 0x42, 0x44, 0xf7, 0xbe, 0x7f, 0xaf, 0xa9, 0xe6, - 0x63, 0x9a, 0x49, 0x06, 0xc7, 0xff, 0x3d, 0xe8, 0xbf, 0x4e, 0x7f, 0x79, 0xff, 0x95, 0x0d, 0xef, - 0xcd, 0x4c, 0x36, 0x2d, 0x66, 0xa4, 0x3f, 0x15, 0x60, 0x8e, 0x55, 0x39, 0xc9, 0xe1, 0xfd, 0x0d, - 0xc8, 0xd8, 0xd6, 0x6b, 0x36, 0xbc, 0xf3, 0x0f, 0xdf, 0x8a, 0x11, 0xb1, 0x85, 0xfb, 0xe1, 0xf9, - 0x93, 0x66, 0x47, 0x65, 0xe0, 0x5e, 0xaa, 0x42, 0xb9, 0xd3, 0x93, 0x72, 0x03, 0xe3, 0x92, 0x89, - 0x8c, 0x3b, 0x50, 0xdc, 0x57, 0x5d, 0xed, 0x50, 0xb1, 0x79, 0x21, 0xc9, 0x5c, 0x9b, 0xbe, 0x3b, - 0x27, 0x17, 0x28, 0xd9, 0x2b, 0xba, 0x43, 0x6a, 0xce, 0xc6, 0x9b, 0x83, 0xff, 0x9c, 0xb5, 0xf9, - 0xff, 0x15, 0xf8, 0x18, 0xf2, 0x6a, 0xfe, 0xe7, 0xad, 0xe9, 0x7f, 0x90, 0x82, 0xab, 0x95, 0x43, - 0xac, 0x1d, 0x55, 0x2c, 0xd3, 0x31, 0x1c, 0x97, 0xe8, 0x2e, 0xc9, 0xf6, 0x7f, 0x0b, 0x72, 0xaf, - 0x0d, 0xf7, 0x50, 0xd1, 0x8d, 0x83, 0x03, 0x6a, 0x6d, 0xb3, 0x72, 0x96, 0x10, 0x36, 0x8c, 0x83, - 0x03, 0xf4, 0x08, 0x32, 0x1d, 0x4b, 0x67, 0xce, 0x7c, 0xe1, 0xe1, 0x6a, 0x8c, 0x78, 0x5a, 0x34, - 0xa7, 0xd7, 0xd9, 0xb6, 0x74, 0x2c, 0xd3, 0xcc, 0x68, 0x05, 0x40, 0x23, 0xd4, 0xae, 0x65, 0x98, - 0x2e, 0x37, 0x8e, 0x21, 0x0a, 0xaa, 0x41, 0xce, 0xc5, 0x76, 0xc7, 0x30, 0x55, 0x17, 0x2f, 0x4d, - 0x53, 0xe5, 0xbd, 0x1b, 0x5b, 0xf0, 0x6e, 0xdb, 0xd0, 0xd4, 0x0d, 0xec, 0x68, 0xb6, 0xd1, 0x75, - 0x2d, 0x9b, 0x6b, 0x31, 0x60, 0x96, 0xfe, 0x7a, 0x06, 0x96, 0x86, 0x75, 0x93, 0x64, 0x0f, 0xd9, - 0x85, 0x19, 0x1b, 0x3b, 0xbd, 0xb6, 0xcb, 0xfb, 0xc8, 0xc3, 0x51, 0x2a, 0x88, 0x29, 0x01, 0x5d, - 0xba, 0x68, 0xbb, 0xbc, 0xd8, 0x5c, 0xce, 0xf2, 0xbf, 0x14, 0x60, 0x86, 0x25, 0xa0, 0x07, 0x90, - 0xb5, 0xc9, 0xc4, 0xa0, 0x18, 0x3a, 0x2d, 0x63, 0xba, 0x7c, 0xe5, 0xec, 0x74, 0x75, 0x96, 0x4e, - 0x16, 0xf5, 0x8d, 0x2f, 0x82, 0x9f, 0xf2, 0x2c, 0xcd, 0x57, 0xd7, 0x49, 0x6b, 0x39, 0xae, 0x6a, - 0xbb, 0x74, 0x51, 0x29, 0xc5, 0x10, 0x12, 0x25, 0x6c, 0xe1, 0x3e, 0xda, 0x84, 0x19, 0xc7, 0x55, - 0xdd, 0x9e, 0xc3, 0xdb, 0xeb, 0x42, 0x85, 0x6d, 0x50, 0x4e, 0x99, 0x4b, 0x20, 0xee, 0x96, 0x8e, - 0x5d, 0xd5, 0x68, 0xd3, 0x06, 0xcc, 0xc9, 0xfc, 0x49, 0xfa, 0x2d, 0x01, 0x66, 0x58, 0x56, 0x74, - 0x15, 0x16, 0xe5, 0xf5, 0x9d, 0x27, 0x55, 0xa5, 0xbe, 0xb3, 0x51, 0x6d, 0x56, 0xe5, 0xed, 0xfa, - 0xce, 0x7a, 0xb3, 0x2a, 0x4e, 0xa1, 0x2b, 0x80, 0xbc, 0x84, 0xca, 0xb3, 0x9d, 0x46, 0xbd, 0xd1, - 0xac, 0xee, 0x34, 0x45, 0x81, 0xae, 0xa9, 0x50, 0x7a, 0x88, 0x9a, 0x42, 0xef, 0xc2, 0xf5, 0x41, - 0xaa, 0xd2, 0x68, 0xae, 0x37, 0x1b, 0x4a, 0xb5, 0xd1, 0xac, 0x6f, 0xaf, 0x37, 0xab, 0x1b, 0x62, - 0x7a, 0x4c, 0x2e, 0xf2, 0x12, 0x59, 0xae, 0x56, 0x9a, 0x62, 0x46, 0x72, 0xe1, 0xb2, 0x8c, 0x35, - 0xab, 0xd3, 0xed, 0xb9, 0x98, 0x94, 0xd2, 0x49, 0x72, 0xa4, 0x5c, 0x85, 0x59, 0xdd, 0xee, 0x2b, - 0x76, 0xcf, 0xe4, 0xe3, 0x64, 0x46, 0xb7, 0xfb, 0x72, 0xcf, 0x94, 0xfe, 0xa1, 0x00, 0x57, 0x06, - 0x5f, 0x9b, 0x64, 0x27, 0x7c, 0x0e, 0x79, 0x55, 0xd7, 0xb1, 0xae, 0xe8, 0xb8, 0xed, 0xaa, 0xdc, - 0x25, 0xba, 0x1f, 0x92, 0xc4, 0x97, 0x02, 0x4b, 0xfe, 0x52, 0xe0, 0xf6, 0x8b, 0x4a, 0x85, 0x16, - 0x64, 0x83, 0x70, 0x78, 0xe6, 0x87, 0x0a, 0xa1, 0x14, 0xe9, 0x07, 0x19, 0x98, 0xaf, 0x9a, 0x7a, - 0xf3, 0x24, 0xd1, 0xb9, 0xe4, 0x0a, 0xcc, 0x68, 0x56, 0xa7, 0x63, 0xb8, 0x9e, 0x82, 0xd8, 0x13, - 0xfa, 0xc5, 0x90, 0x2b, 0x9b, 0x9e, 0xc0, 0xa1, 0x0b, 0x9c, 0x58, 0xf4, 0x6b, 0x70, 0x95, 0x58, - 0x4d, 0xdb, 0x54, 0xdb, 0x0a, 0x93, 0xa6, 0xb8, 0xb6, 0xd1, 0x6a, 0x61, 0x9b, 0x2f, 0x3f, 0xde, - 0x8d, 0x29, 0x67, 0x9d, 0x73, 0x54, 0x28, 0x43, 0x93, 0xe5, 0x97, 0x2f, 0x1b, 0x71, 0x64, 0xf4, - 0x31, 0x00, 0x99, 0x8a, 0xe8, 0x92, 0xa6, 0xc3, 0xed, 0xd1, 0xa8, 0x35, 0x4d, 0xcf, 0x04, 0x11, - 0x06, 0xf2, 0xec, 0xa0, 0xe7, 0x20, 0x1a, 0xa6, 0x72, 0xd0, 0x36, 0x5a, 0x87, 0xae, 0xf2, 0xda, - 0x36, 0x5c, 0xec, 0x2c, 0x2d, 0x50, 0x19, 0x71, 0x4d, 0xdd, 0xe0, 0x4b, 0xb3, 0xfa, 0x4b, 0x92, - 0x93, 0x4b, 0x2b, 0x18, 0xe6, 0x63, 0xca, 0x4f, 0x89, 0x0e, 0x5a, 0x23, 0x50, 0xe8, 0x55, 0xcf, - 0xb0, 0xb1, 0xf2, 0xa0, 0xab, 0xd1, 0x75, 0x90, 0x6c, 0xb9, 0x70, 0x76, 0xba, 0x0a, 0x32, 0x23, - 0x3f, 0xd8, 0xad, 0x10, 0x68, 0xc4, 0x7e, 0x77, 0x35, 0xa2, 0xf6, 0xae, 0x65, 0x38, 0x96, 0xb9, - 0x94, 0x63, 0x6a, 0x67, 0x4f, 0xe8, 0x1e, 0x88, 0xee, 0x89, 0xa9, 0x1c, 0x62, 0xd5, 0x76, 0xf7, - 0xb1, 0xea, 0x92, 0xf9, 0x19, 0x68, 0x8e, 0xa2, 0x7b, 0x62, 0xd6, 0x42, 0xe4, 0xcd, 0x4c, 0x76, - 0x56, 0xcc, 0x6e, 0x66, 0xb2, 0x59, 0x31, 0x27, 0xfd, 0x27, 0x01, 0x0a, 0x5e, 0xdf, 0x48, 0xb2, - 0x1b, 0xdf, 0x05, 0xd1, 0x32, 0xb1, 0xd2, 0x3d, 0x54, 0x1d, 0xcc, 0xdb, 0x92, 0xcf, 0x0e, 0x05, - 0xcb, 0xc4, 0xbb, 0x84, 0xcc, 0x5a, 0x06, 0xed, 0xc2, 0x82, 0xe3, 0xaa, 0x2d, 0xc3, 0x6c, 0x29, - 0xfe, 0x12, 0x3f, 0xf5, 0x2c, 0x26, 0x44, 0x02, 0x22, 0xe7, 0xf6, 0xe9, 0x11, 0x97, 0xe2, 0x0f, - 0x04, 0x58, 0x58, 0xd7, 0x3b, 0x86, 0xd9, 0xe8, 0xb6, 0x8d, 0x44, 0x17, 0x18, 0xde, 0x85, 0x9c, - 0x43, 0x64, 0x06, 0xd6, 0x39, 0x80, 0x8b, 0x59, 0x9a, 0x42, 0xcc, 0xf4, 0x53, 0x28, 0xe2, 0x93, - 0xae, 0xc1, 0xf6, 0x15, 0x18, 0xca, 0xc9, 0x4c, 0x5e, 0xb7, 0x42, 0xc0, 0x4b, 0x92, 0x78, 0x9d, - 0x3e, 0x05, 0x14, 0xae, 0x52, 0x92, 0x40, 0xe3, 0x53, 0x58, 0xa4, 0xa2, 0xf7, 0x4c, 0x27, 0x61, - 0x7d, 0x49, 0xbf, 0x02, 0x97, 0xa2, 0xa2, 0x93, 0x2c, 0xf7, 0x4b, 0xde, 0xca, 0xdb, 0xd8, 0x4e, - 0x14, 0xa1, 0xfa, 0xba, 0xe6, 0x82, 0x93, 0x2c, 0xf3, 0xaf, 0x0b, 0x70, 0x8d, 0xca, 0xa6, 0x5b, - 0x2f, 0x07, 0xd8, 0x7e, 0x8a, 0x55, 0x27, 0x51, 0x78, 0x7d, 0x13, 0x66, 0x18, 0x4c, 0xa6, 0xfd, - 0x73, 0xba, 0x9c, 0x27, 0x6e, 0x46, 0xc3, 0xb5, 0x6c, 0xe2, 0x66, 0xf0, 0x24, 0x49, 0x85, 0xe5, - 0xb8, 0x52, 0x24, 0x59, 0xd3, 0xbf, 0x2d, 0xc0, 0x02, 0xf7, 0xf0, 0x48, 0x57, 0xae, 0x1c, 0x12, - 0x07, 0x07, 0x55, 0x21, 0xaf, 0xd1, 0x5f, 0x8a, 0xdb, 0xef, 0x62, 0x2a, 0xbf, 0x30, 0xce, 0x39, - 0x64, 0x6c, 0xcd, 0x7e, 0x17, 0x13, 0x0f, 0xd3, 0xfb, 0x4d, 0x14, 0x15, 0xaa, 0xe4, 0x58, 0xf7, - 0x92, 0x8e, 0x23, 0x9a, 0xd7, 0xf3, 0xd3, 0xb8, 0x0e, 0x7e, 0x2f, 0xcd, 0x95, 0xc0, 0xde, 0xc1, - 0xb3, 0x27, 0xea, 0x50, 0x7c, 0x06, 0x57, 0x42, 0x4b, 0xe7, 0xe1, 0x8a, 0xa7, 0x2e, 0x50, 0xf1, - 0xd0, 0xf2, 0x7b, 0x40, 0x45, 0x9f, 0x42, 0x68, 0x81, 0x5d, 0x61, 0x75, 0xf2, 0xa0, 0xca, 0x45, - 0xd4, 0xb1, 0x10, 0x48, 0x61, 0x74, 0x07, 0x55, 0x20, 0x8b, 0x4f, 0xba, 0x8a, 0x8e, 0x1d, 0x8d, - 0x1b, 0x2e, 0x29, 0x4e, 0x20, 0x29, 0xca, 0x90, 0xf3, 0x3e, 0x8b, 0x4f, 0xba, 0x84, 0x88, 0xf6, - 0xc8, 0xbc, 0xe9, 0xcd, 0xeb, 0xb4, 0xd8, 0xce, 0xf9, 0x58, 0x20, 0xe8, 0x29, 0x5c, 0x5c, 0xd1, - 0x9f, 0xd2, 0x99, 0x08, 0xe9, 0x87, 0x02, 0xbc, 0x15, 0xdb, 0x6a, 0x49, 0x4e, 0x64, 0x1f, 0x43, - 0x86, 0x56, 0x3e, 0x75, 0xc1, 0xca, 0x53, 0x2e, 0xe9, 0xbb, 0x29, 0x3e, 0xc6, 0x65, 0xdc, 0xb6, - 0x88, 0x62, 0x13, 0x5f, 0x42, 0x7b, 0x06, 0xf3, 0xc7, 0x96, 0x8b, 0x6d, 0xbf, 0xd9, 0x53, 0x17, - 0x6e, 0xf6, 0x39, 0x2a, 0xc0, 0x6b, 0xf1, 0x17, 0xb0, 0x60, 0x5a, 0xa6, 0x12, 0x15, 0x7a, 0xf1, - 0xbe, 0x54, 0x34, 0x2d, 0xf3, 0x45, 0x48, 0xae, 0x6f, 0x67, 0x06, 0x34, 0x91, 0xa4, 0x9d, 0xf9, - 0x9e, 0x00, 0x8b, 0xbe, 0xa7, 0x93, 0xb0, 0xbb, 0xfb, 0x0d, 0x48, 0x9b, 0xd6, 0xeb, 0x8b, 0x2c, - 0x51, 0x92, 0xfc, 0x64, 0xd6, 0x8b, 0x96, 0x28, 0xc9, 0xfa, 0xfe, 0xab, 0x14, 0xe4, 0x9e, 0x54, - 0x92, 0xac, 0xe5, 0xc7, 0x7c, 0xf9, 0x9b, 0xb5, 0x77, 0x5c, 0x6f, 0xf7, 0xdf, 0x57, 0x7a, 0x52, - 0xd9, 0xc2, 0x7d, 0xaf, 0xb7, 0x13, 0x2e, 0xb4, 0x0e, 0xb9, 0xe8, 0x42, 0xe9, 0x84, 0x9a, 0x0a, - 0xb8, 0x96, 0x31, 0x4c, 0x53, 0xb9, 0x5e, 0xa8, 0x85, 0x10, 0x13, 0x6a, 0x41, 0x5e, 0xe3, 0x7b, - 0x8a, 0xa9, 0x8b, 0xbc, 0x26, 0xe4, 0x22, 0x4e, 0x8b, 0x33, 0xd2, 0x73, 0x00, 0x52, 0x9d, 0x24, - 0x9b, 0xe4, 0x37, 0xd2, 0x50, 0xd8, 0xed, 0x39, 0x87, 0x09, 0xf7, 0xbe, 0x0a, 0x40, 0xb7, 0xe7, - 0x1c, 0x92, 0x11, 0x79, 0x62, 0xf2, 0x3a, 0x9f, 0x13, 0xc5, 0xe1, 0x55, 0x9a, 0xf1, 0x35, 0x4f, - 0x4c, 0x54, 0xe3, 0x42, 0xb0, 0x12, 0x84, 0x82, 0xdc, 0x1c, 0x87, 0x2c, 0x9b, 0x27, 0xe6, 0x36, - 0xf6, 0x21, 0x25, 0x93, 0x84, 0x89, 0xa4, 0x8f, 0x61, 0x96, 0x3c, 0x28, 0xae, 0x75, 0x91, 0x66, - 0x9e, 0x21, 0x3c, 0x4d, 0x0b, 0x7d, 0x04, 0x39, 0xc6, 0x4d, 0x66, 0xbf, 0x19, 0x3a, 0xfb, 0xc5, - 0xd5, 0x85, 0xab, 0x91, 0xce, 0x7b, 0x59, 0xca, 0x4a, 0xe6, 0xba, 0x4b, 0x30, 0x7d, 0x60, 0xd9, - 0x9a, 0xb7, 0x99, 0xcb, 0x1e, 0x58, 0x7b, 0x32, 0x48, 0xb3, 0x99, 0xc9, 0xe6, 0x44, 0x90, 0x7e, - 0x4b, 0x80, 0xa2, 0xdf, 0x10, 0x49, 0x4e, 0x08, 0x95, 0x88, 0x16, 0x2f, 0xde, 0x14, 0x44, 0x81, - 0xd2, 0xbf, 0xa5, 0x1e, 0x91, 0x66, 0x1d, 0xd3, 0x96, 0x49, 0xb2, 0xa7, 0x7c, 0xc4, 0x02, 0x7d, - 0x52, 0x17, 0x6d, 0x5d, 0x1a, 0xf3, 0xf3, 0x00, 0x2e, 0x19, 0x1d, 0x62, 0xcf, 0x0d, 0xb7, 0xdd, - 0xe7, 0xb0, 0xcd, 0xc5, 0xde, 0xae, 0xf1, 0x62, 0x90, 0x56, 0xf1, 0x92, 0xa4, 0xdf, 0xa5, 0xab, - 0xd5, 0x41, 0x4d, 0x92, 0x54, 0x75, 0x1d, 0xe6, 0x6d, 0x26, 0x9a, 0xb8, 0x35, 0x17, 0xd4, 0xf6, - 0x9c, 0xcf, 0x4a, 0x14, 0xfe, 0xdb, 0x29, 0x28, 0x3e, 0xef, 0x61, 0xbb, 0xff, 0x55, 0x52, 0xf7, - 0x6d, 0x28, 0xbe, 0x56, 0x0d, 0x57, 0x39, 0xb0, 0x6c, 0xa5, 0xd7, 0xd5, 0x55, 0xd7, 0x8b, 0x36, - 0x99, 0x27, 0xe4, 0xc7, 0x96, 0xbd, 0x47, 0x89, 0x08, 0x03, 0x3a, 0x32, 0xad, 0xd7, 0xa6, 0x42, - 0xc8, 0x14, 0x28, 0x9f, 0x98, 0x7c, 0x09, 0xb9, 0xfc, 0xcd, 0xff, 0x78, 0xba, 0xfa, 0x68, 0xa2, - 0x18, 0x32, 0x1a, 0x2f, 0xd7, 0xeb, 0x19, 0x7a, 0x69, 0x6f, 0xaf, 0xbe, 0x21, 0x8b, 0x54, 0xe4, - 0x4b, 0x26, 0xb1, 0x79, 0x62, 0x3a, 0xd2, 0xdf, 0x4d, 0x81, 0x18, 0xe8, 0x28, 0xc9, 0x86, 0xac, - 0x42, 0xfe, 0x55, 0x0f, 0xdb, 0xc6, 0x1b, 0x34, 0x23, 0x70, 0x46, 0x62, 0x76, 0xee, 0xc3, 0x82, - 0x7b, 0x62, 0x2a, 0x2c, 0xc2, 0x8f, 0x05, 0x7e, 0x78, 0x01, 0x0b, 0x45, 0x97, 0x94, 0x99, 0xd0, - 0x69, 0xd0, 0x87, 0x83, 0x3e, 0x83, 0xb9, 0x88, 0xb6, 0xd2, 0x5f, 0x4e, 0x5b, 0xf9, 0xd7, 0x21, - 0x45, 0xfd, 0xbe, 0x00, 0x88, 0x2a, 0xaa, 0xce, 0xd6, 0xf8, 0xbf, 0x2a, 0xfd, 0xe9, 0x2e, 0x88, - 0x34, 0x1e, 0x53, 0x31, 0x0e, 0x94, 0x8e, 0xe1, 0x38, 0x86, 0xd9, 0xe2, 0x1d, 0xaa, 0x40, 0xe9, - 0xf5, 0x83, 0x6d, 0x46, 0x95, 0xfe, 0x12, 0x2c, 0x46, 0x2a, 0x90, 0x64, 0x63, 0xdf, 0x80, 0xb9, - 0x03, 0xb6, 0x05, 0x4b, 0x85, 0xf3, 0xe5, 0xc1, 0x3c, 0xa5, 0xb1, 0xf7, 0x49, 0x7f, 0x92, 0x82, - 0x4b, 0x32, 0x76, 0xac, 0xf6, 0x31, 0x4e, 0x5e, 0x85, 0x35, 0xe0, 0x7b, 0x2f, 0xca, 0x1b, 0x69, - 0x32, 0xc7, 0x98, 0xd9, 0x34, 0x17, 0x5d, 0x63, 0x7f, 0x77, 0x7c, 0x8f, 0x1d, 0x5e, 0x55, 0xe7, - 0x2b, 0x75, 0x99, 0xc8, 0x4a, 0x9d, 0x05, 0x45, 0xb6, 0x7b, 0xac, 0x2b, 0x0e, 0x7e, 0x65, 0xf6, - 0x3a, 0x1e, 0x18, 0x2a, 0x8d, 0x2b, 0x64, 0x9d, 0xb1, 0x34, 0xf0, 0xab, 0x9d, 0x5e, 0x87, 0xfa, - 0xce, 0xe5, 0x2b, 0xa4, 0xbc, 0x67, 0xa7, 0xab, 0x85, 0x48, 0x9a, 0x23, 0x17, 0x0c, 0xff, 0x99, - 0x48, 0x97, 0xbe, 0x0d, 0x97, 0x07, 0x94, 0x9d, 0xa4, 0xc7, 0xf3, 0x2f, 0xd2, 0x70, 0x2d, 0x2a, - 0x3e, 0x69, 0x88, 0xf3, 0x55, 0x6f, 0xd0, 0x1a, 0xcc, 0x77, 0x0c, 0xf3, 0xcd, 0x56, 0x2f, 0xe7, - 0x3a, 0x86, 0xe9, 0xd3, 0xe2, 0xba, 0xc6, 0xcc, 0xcf, 0xb5, 0x6b, 0xa8, 0xb0, 0x1c, 0xd7, 0x76, - 0x49, 0xf6, 0x8f, 0xef, 0x0a, 0x30, 0x97, 0xf4, 0xb2, 0xdc, 0x9b, 0x45, 0xc1, 0x49, 0x4d, 0x98, - 0xff, 0x39, 0xac, 0xe3, 0xfd, 0xb6, 0x00, 0xa8, 0x69, 0xf7, 0x4c, 0x02, 0x6a, 0x9f, 0x5a, 0xad, - 0x24, 0xab, 0x79, 0x09, 0xa6, 0x0d, 0x53, 0xc7, 0x27, 0xb4, 0x9a, 0x19, 0x99, 0x3d, 0x44, 0xb6, - 0x12, 0xd3, 0x13, 0x6d, 0x25, 0x4a, 0x9f, 0xc1, 0x62, 0xa4, 0x88, 0x49, 0xd6, 0xff, 0x8f, 0x53, - 0xb0, 0xc8, 0x2b, 0x92, 0xf8, 0x0a, 0xe6, 0xd7, 0x61, 0xba, 0x4d, 0x64, 0x8e, 0x69, 0x67, 0xfa, - 0x4e, 0xaf, 0x9d, 0x69, 0x66, 0xf4, 0x4b, 0x00, 0x5d, 0x1b, 0x1f, 0x2b, 0x8c, 0x35, 0x3d, 0x11, - 0x6b, 0x8e, 0x70, 0x50, 0x02, 0xfa, 0xbe, 0x00, 0x45, 0x32, 0xa0, 0xbb, 0xb6, 0xd5, 0xb5, 0x1c, - 0xe2, 0xb3, 0x38, 0x93, 0xc1, 0x9c, 0xe7, 0x67, 0xa7, 0xab, 0xf3, 0xdb, 0x86, 0xb9, 0xcb, 0x19, - 0x9b, 0x8d, 0x89, 0x03, 0xfc, 0xbd, 0x63, 0x0e, 0xa5, 0x4a, 0xdb, 0xd2, 0x8e, 0x82, 0xcd, 0x31, - 0x62, 0x59, 0x7c, 0x71, 0x8e, 0xf4, 0x13, 0x01, 0x2e, 0xfd, 0xdc, 0x96, 0x8b, 0xff, 0x2c, 0x94, - 0x2d, 0xbd, 0x00, 0x91, 0xfe, 0xa8, 0x9b, 0x07, 0x56, 0x92, 0x0b, 0xf7, 0xff, 0x47, 0x80, 0x85, - 0x90, 0xe0, 0x24, 0x1d, 0x9c, 0x37, 0xd5, 0xd3, 0x3c, 0x0b, 0x87, 0x71, 0x27, 0x53, 0x95, 0x3c, - 0xc7, 0xb3, 0xb3, 0x4e, 0x59, 0x82, 0x39, 0x4c, 0xac, 0x18, 0x5d, 0xe2, 0xdd, 0x67, 0x87, 0x4c, - 0x06, 0x56, 0xf4, 0xf3, 0x7e, 0x86, 0x72, 0x5f, 0xfa, 0x15, 0xe2, 0x61, 0x85, 0x07, 0x65, 0x92, - 0x43, 0xfe, 0x9f, 0xa6, 0xe0, 0x4a, 0x85, 0x6d, 0x81, 0x7b, 0x31, 0x21, 0x49, 0x76, 0xc4, 0x25, - 0x98, 0x3d, 0xc6, 0xb6, 0x63, 0x58, 0x6c, 0xb6, 0x9f, 0x97, 0xbd, 0x47, 0xb4, 0x0c, 0x59, 0xc7, - 0x54, 0xbb, 0xce, 0xa1, 0xe5, 0x6d, 0x27, 0xfa, 0xcf, 0x7e, 0xfc, 0xca, 0xf4, 0x9b, 0xc7, 0xaf, - 0xcc, 0x8c, 0x8f, 0x5f, 0x99, 0xfd, 0x12, 0xf1, 0x2b, 0x7c, 0xef, 0xee, 0xdf, 0x09, 0x70, 0x75, - 0x48, 0x73, 0x49, 0x76, 0xce, 0xef, 0x40, 0x5e, 0xe3, 0x82, 0xc9, 0xfc, 0xc0, 0x36, 0x26, 0xeb, - 0x24, 0xdb, 0x1b, 0x42, 0x9f, 0xb3, 0xd3, 0x55, 0xf0, 0x8a, 0x5a, 0xdf, 0xe0, 0xca, 0x21, 0xbf, - 0x75, 0xe9, 0xbf, 0x03, 0x14, 0xab, 0x27, 0x6c, 0x51, 0xbe, 0xc1, 0xbc, 0x12, 0xf4, 0x18, 0xb2, - 0x5d, 0xdb, 0x3a, 0x36, 0xbc, 0x6a, 0x14, 0x22, 0xc1, 0x0b, 0x5e, 0x35, 0x06, 0xb8, 0x76, 0x39, - 0x87, 0xec, 0xf3, 0xa2, 0x26, 0xe4, 0x9e, 0x5a, 0x9a, 0xda, 0x7e, 0x6c, 0xb4, 0xbd, 0x81, 0xf6, - 0xfe, 0xf9, 0x82, 0x4a, 0x3e, 0xcf, 0xae, 0xea, 0x1e, 0x7a, 0x8d, 0xe0, 0x13, 0x51, 0x1d, 0xb2, - 0x35, 0xd7, 0xed, 0x92, 0x44, 0x3e, 0xfe, 0xee, 0x4c, 0x20, 0x94, 0xb0, 0x78, 0x11, 0xb7, 0x1e, - 0x3b, 0x6a, 0xc2, 0xc2, 0x13, 0x7a, 0x7e, 0xac, 0xd2, 0xb6, 0x7a, 0x7a, 0xc5, 0x32, 0x0f, 0x8c, - 0x16, 0x9f, 0x26, 0x6e, 0x4f, 0x20, 0xf3, 0x49, 0xa5, 0x21, 0x0f, 0x0b, 0x40, 0xeb, 0x90, 0x6d, - 0x3c, 0xe2, 0xc2, 0x98, 0x1b, 0x79, 0x6b, 0x02, 0x61, 0x8d, 0x47, 0xb2, 0xcf, 0x86, 0x36, 0x21, - 0xbf, 0xfe, 0x79, 0xcf, 0xc6, 0x5c, 0xca, 0xcc, 0xc8, 0xc8, 0x89, 0x41, 0x29, 0x94, 0x4b, 0x0e, - 0x33, 0xa3, 0x6f, 0x43, 0x91, 0xe8, 0xad, 0xa9, 0xee, 0xb7, 0x3d, 0x79, 0x59, 0x2a, 0xef, 0x6b, - 0x13, 0xc8, 0xf3, 0x39, 0xbd, 0x2d, 0x81, 0x01, 0x51, 0xcb, 0x32, 0xcc, 0x47, 0xda, 0x0b, 0x21, - 0xc8, 0x74, 0x49, 0xd3, 0x08, 0x34, 0x0c, 0x89, 0xfe, 0x46, 0xef, 0xc1, 0xac, 0x69, 0xe9, 0xd8, - 0xeb, 0xcc, 0xf3, 0xe5, 0x4b, 0x67, 0xa7, 0xab, 0x33, 0x3b, 0x96, 0xce, 0x7c, 0x1d, 0xfe, 0x4b, - 0x9e, 0x21, 0x99, 0xea, 0xfa, 0xf2, 0x75, 0xc8, 0x90, 0x26, 0x22, 0x36, 0x64, 0x5f, 0x75, 0xf0, - 0x9e, 0x6d, 0x70, 0x69, 0xde, 0xe3, 0xf2, 0x3f, 0x48, 0x41, 0xaa, 0xf1, 0x88, 0x78, 0xf3, 0xfb, - 0x3d, 0xed, 0x08, 0xbb, 0x3c, 0x9d, 0x3f, 0x51, 0x2f, 0xdf, 0xc6, 0x07, 0x06, 0x73, 0xba, 0x72, - 0x32, 0x7f, 0x42, 0xef, 0x00, 0xa8, 0x9a, 0x86, 0x1d, 0x47, 0xf1, 0x8e, 0x00, 0xe6, 0xe4, 0x1c, - 0xa3, 0x6c, 0xe1, 0x3e, 0x61, 0x73, 0xb0, 0x66, 0x63, 0xd7, 0x8b, 0xa1, 0x62, 0x4f, 0x84, 0xcd, - 0xc5, 0x9d, 0xae, 0xe2, 0x5a, 0x47, 0xd8, 0xa4, 0x4d, 0x9a, 0x23, 0x56, 0xa1, 0xd3, 0x6d, 0x12, - 0x02, 0x31, 0x68, 0xd8, 0xd4, 0x03, 0xeb, 0x93, 0x93, 0xfd, 0x67, 0x22, 0xd2, 0xc6, 0x2d, 0x83, - 0x1f, 0xa0, 0xcb, 0xc9, 0xfc, 0x89, 0x68, 0x49, 0xed, 0xb9, 0x87, 0xb4, 0x25, 0x72, 0x32, 0xfd, - 0x8d, 0x6e, 0x43, 0x91, 0x85, 0x5d, 0x2a, 0xd8, 0xd4, 0x14, 0x6a, 0x07, 0x73, 0x34, 0x79, 0x9e, - 0x91, 0xab, 0xa6, 0x46, 0xac, 0x1e, 0x7a, 0x04, 0x9c, 0xa0, 0x1c, 0x75, 0x1c, 0xa2, 0x53, 0x20, - 0xb9, 0xca, 0xc5, 0xb3, 0xd3, 0xd5, 0x7c, 0x83, 0x26, 0x6c, 0x6d, 0x37, 0xc8, 0x5c, 0xc2, 0x72, - 0x6d, 0x75, 0x9c, 0xba, 0xbe, 0xfc, 0x37, 0x05, 0x48, 0x3f, 0xa9, 0x34, 0x2e, 0xac, 0x32, 0xaf, - 0xa0, 0xe9, 0x50, 0x41, 0xef, 0x40, 0x71, 0xdf, 0x68, 0xb7, 0x0d, 0xb3, 0x45, 0xfc, 0xab, 0xef, - 0x60, 0xcd, 0x53, 0x58, 0x81, 0x93, 0x77, 0x19, 0x15, 0x5d, 0x87, 0xbc, 0x66, 0x63, 0x1d, 0x9b, - 0xae, 0xa1, 0xb6, 0x1d, 0xae, 0xb9, 0x30, 0x69, 0xf9, 0x2f, 0x0b, 0x30, 0x4d, 0x3b, 0x2b, 0x7a, - 0x1b, 0x72, 0x9a, 0x65, 0xba, 0xaa, 0x61, 0x72, 0xab, 0x93, 0x93, 0x03, 0xc2, 0xc8, 0xe2, 0xdd, - 0x80, 0x39, 0x55, 0xd3, 0xac, 0x9e, 0xe9, 0x2a, 0xa6, 0xda, 0xc1, 0xbc, 0x98, 0x79, 0x4e, 0xdb, - 0x51, 0x3b, 0x18, 0xad, 0x82, 0xf7, 0xe8, 0x9f, 0xec, 0xcc, 0xc9, 0xc0, 0x49, 0x5b, 0xb8, 0xbf, - 0x8c, 0x21, 0xe7, 0xf7, 0x6a, 0x52, 0xdf, 0x9e, 0xe3, 0x97, 0x80, 0xfe, 0x46, 0xef, 0xc3, 0xa5, - 0x57, 0x3d, 0xb5, 0x6d, 0x1c, 0xd0, 0xc5, 0x2f, 0x1a, 0xa5, 0x4e, 0x5f, 0xc6, 0x8a, 0x82, 0xfc, - 0x34, 0x2a, 0x81, 0xbe, 0xd3, 0x1b, 0x04, 0xe9, 0x60, 0x10, 0xb0, 0x90, 0x1d, 0xa9, 0x0f, 0x0b, - 0x32, 0x76, 0xed, 0x7e, 0x93, 0x1d, 0x76, 0xad, 0x1e, 0x63, 0xd3, 0x25, 0x75, 0xb7, 0xba, 0x98, - 0x05, 0x89, 0x78, 0x75, 0xf7, 0x09, 0xe8, 0x16, 0x14, 0x54, 0x97, 0x74, 0x37, 0x57, 0x31, 0x7b, - 0x9d, 0x7d, 0x6c, 0xb3, 0x50, 0x00, 0x79, 0x9e, 0x53, 0x77, 0x28, 0x91, 0x9f, 0xc8, 0xb0, 0xfb, - 0x0a, 0x5d, 0x27, 0xe2, 0xaf, 0x06, 0x4a, 0xaa, 0x12, 0x8a, 0x74, 0x0f, 0x2e, 0x93, 0x7a, 0x56, - 0x4d, 0xcd, 0xee, 0x77, 0x89, 0xe4, 0x67, 0xf4, 0xaf, 0x83, 0xc4, 0xd0, 0x3e, 0x0d, 0xdd, 0x9e, - 0x91, 0x7e, 0x3c, 0x03, 0xf3, 0xd5, 0x93, 0xae, 0x65, 0x27, 0xba, 0xaa, 0x53, 0x86, 0x59, 0x0e, - 0x7c, 0xc7, 0x6c, 0xc5, 0x0e, 0x58, 0x20, 0x6f, 0x1f, 0x9a, 0x33, 0xa2, 0x32, 0x00, 0x0b, 0xa8, - 0xa4, 0x71, 0x38, 0xe9, 0x0b, 0xec, 0x1c, 0x51, 0x36, 0x7a, 0xd8, 0x60, 0x07, 0xf2, 0x9d, 0x63, - 0x4d, 0x53, 0x0e, 0x8c, 0xb6, 0xcb, 0xe3, 0xd2, 0xe2, 0x43, 0xa8, 0xb7, 0x5f, 0x54, 0x2a, 0x8f, - 0x69, 0x26, 0x16, 0xcf, 0x15, 0x3c, 0xcb, 0x40, 0x24, 0xb0, 0xdf, 0xe8, 0x6b, 0xc0, 0x0f, 0xbe, - 0x28, 0x8e, 0x77, 0x8c, 0xad, 0x3c, 0x7f, 0x76, 0xba, 0x9a, 0x93, 0x29, 0xb5, 0xd1, 0x68, 0xca, - 0x39, 0x96, 0xa1, 0xe1, 0xb8, 0x17, 0x39, 0xea, 0x30, 0x3b, 0xf9, 0x51, 0x87, 0xbf, 0x26, 0xc0, - 0x15, 0xae, 0x23, 0x65, 0x9f, 0x86, 0x77, 0xab, 0x6d, 0xc3, 0xed, 0x2b, 0x47, 0xc7, 0x4b, 0x59, - 0xea, 0xf2, 0xfc, 0x62, 0xac, 0xae, 0x43, 0x4d, 0x5c, 0xf2, 0x34, 0xde, 0x7f, 0xca, 0x99, 0xb7, - 0x8e, 0xab, 0xa6, 0x6b, 0xf7, 0xcb, 0x57, 0xcf, 0x4e, 0x57, 0x17, 0x87, 0x53, 0x5f, 0xc8, 0x8b, - 0xce, 0x30, 0x0b, 0xaa, 0x01, 0x60, 0xbf, 0x8b, 0x51, 0x0b, 0x16, 0x3f, 0x75, 0xc5, 0xf6, 0x45, - 0x39, 0xc4, 0x8b, 0xee, 0x82, 0xc8, 0x8f, 0x96, 0x1c, 0x18, 0x6d, 0xac, 0x38, 0xc6, 0xe7, 0x98, - 0xda, 0xba, 0xb4, 0x5c, 0x60, 0x74, 0x22, 0xa2, 0x61, 0x7c, 0x8e, 0xd1, 0x03, 0xb8, 0x1c, 0xb4, - 0x80, 0xb2, 0x8f, 0xdb, 0xd6, 0x6b, 0x96, 0x3d, 0x4f, 0xb3, 0x23, 0x5f, 0xfb, 0x65, 0x92, 0x44, - 0x58, 0x96, 0xbf, 0x03, 0x4b, 0xa3, 0x2a, 0x1c, 0x1e, 0x10, 0x39, 0xb6, 0x5f, 0xf9, 0x41, 0x74, - 0xb1, 0x62, 0x82, 0x8e, 0xcb, 0x17, 0x2c, 0x3e, 0x4c, 0x7d, 0x20, 0x48, 0x7f, 0x3f, 0x05, 0xf3, - 0xe5, 0x5e, 0xfb, 0xe8, 0x59, 0xb7, 0xc1, 0x8e, 0xe5, 0xa3, 0xb7, 0x20, 0xa7, 0xab, 0xae, 0xca, - 0x0a, 0x29, 0xb0, 0x23, 0x66, 0x84, 0x40, 0x6b, 0x73, 0x07, 0x8a, 0xa1, 0x58, 0x10, 0x1e, 0xf1, - 0x4e, 0xab, 0x1d, 0x90, 0x69, 0x50, 0xfa, 0x07, 0xb0, 0x14, 0xca, 0x48, 0x57, 0x16, 0x14, 0x6c, - 0xba, 0xb6, 0x81, 0xd9, 0xea, 0x58, 0x5a, 0x0e, 0x05, 0xac, 0xd4, 0x49, 0x72, 0x95, 0xa5, 0xa2, - 0x26, 0xcc, 0x91, 0x8c, 0x7d, 0x85, 0x5a, 0x41, 0x6f, 0xf5, 0xf2, 0x41, 0x4c, 0xb5, 0x22, 0xe5, - 0x2e, 0x51, 0xfd, 0x54, 0x28, 0x0f, 0xfd, 0x29, 0xe7, 0x71, 0x40, 0x59, 0xfe, 0x04, 0xc4, 0xc1, - 0x0c, 0x61, 0x5d, 0x66, 0x98, 0x2e, 0x2f, 0x85, 0x75, 0x99, 0x0e, 0xe9, 0x69, 0x33, 0x93, 0xcd, - 0x88, 0xd3, 0xd2, 0x4f, 0xd2, 0x50, 0xf0, 0x7a, 0x66, 0x92, 0x6e, 0x75, 0x19, 0xa6, 0x49, 0x3f, - 0xf2, 0xc2, 0x2b, 0x6e, 0x8f, 0x19, 0x10, 0x3c, 0xc6, 0x9a, 0xf4, 0x2f, 0x0f, 0x01, 0x52, 0xd6, - 0x24, 0xcc, 0xcf, 0xf2, 0xff, 0x10, 0x20, 0x43, 0x3d, 0xd9, 0x07, 0x90, 0xa1, 0xe7, 0xf2, 0x85, - 0xb1, 0xe7, 0xf2, 0xbd, 0xed, 0x79, 0x92, 0xd5, 0x9f, 0x58, 0x52, 0x21, 0xef, 0xaa, 0x4c, 0xe3, - 0x7b, 0x2c, 0xdb, 0xc5, 0x3a, 0xf7, 0x14, 0xaf, 0x9f, 0xd7, 0x8e, 0x9e, 0x27, 0xec, 0xf1, 0xa1, - 0x6b, 0x90, 0x26, 0xb6, 0x6b, 0x96, 0x6d, 0xd5, 0x9f, 0x9d, 0xae, 0xa6, 0x89, 0xd5, 0x22, 0x34, - 0xb4, 0x06, 0xf9, 0xa8, 0x35, 0x21, 0xce, 0x06, 0x35, 0x87, 0x21, 0x4b, 0x00, 0x6d, 0x7f, 0x08, - 0x31, 0x94, 0xc4, 0xda, 0x92, 0x6f, 0xd2, 0xff, 0xba, 0xc0, 0x63, 0x12, 0x1b, 0x1a, 0x99, 0xb3, - 0xec, 0x24, 0x27, 0x95, 0x7b, 0x20, 0xda, 0xaa, 0xa9, 0x5b, 0x1d, 0xe3, 0x73, 0xcc, 0x50, 0xb9, - 0xc3, 0xb7, 0x2b, 0x8a, 0x3e, 0x9d, 0xc2, 0x67, 0x47, 0xfa, 0x6f, 0x02, 0x8f, 0x5f, 0xf4, 0x8b, - 0x91, 0xec, 0xa6, 0x72, 0x9e, 0x2f, 0xe9, 0x99, 0x07, 0x96, 0x17, 0x7e, 0xf1, 0xf6, 0xa8, 0x60, - 0xa3, 0xba, 0x79, 0x60, 0x79, 0xdb, 0x63, 0xb6, 0x47, 0x70, 0x96, 0x7f, 0x19, 0xa6, 0x69, 0xf2, - 0x1b, 0xf4, 0x0d, 0x3f, 0x66, 0x36, 0x25, 0xa6, 0xa5, 0x3f, 0x4a, 0xc1, 0xbb, 0xb4, 0xaa, 0x2f, - 0xb0, 0x6d, 0x1c, 0xf4, 0x77, 0x6d, 0xcb, 0xc5, 0x9a, 0x8b, 0xf5, 0x60, 0x55, 0x2a, 0xc1, 0x26, - 0xd0, 0x21, 0xc7, 0xf7, 0xf3, 0x0c, 0x9d, 0xdf, 0x9c, 0xf1, 0xe4, 0xcb, 0xa1, 0xd5, 0x2c, 0xdb, - 0x07, 0xac, 0x6f, 0xc8, 0x59, 0x26, 0xb9, 0xae, 0xa3, 0x75, 0xc8, 0x75, 0xbd, 0x6a, 0x5c, 0x28, - 0x64, 0xc4, 0xe7, 0x42, 0x5b, 0x50, 0xe4, 0x05, 0x55, 0xdb, 0xc6, 0x31, 0x56, 0x54, 0xf7, 0x22, - 0x43, 0x78, 0x9e, 0xf1, 0xae, 0x13, 0xd6, 0x75, 0x57, 0xfa, 0x1b, 0x19, 0xb8, 0x75, 0x8e, 0x8a, - 0x93, 0xec, 0x5e, 0xcb, 0x90, 0x3d, 0x26, 0x2f, 0x32, 0x78, 0xed, 0xb3, 0xb2, 0xff, 0x8c, 0xf6, - 0x23, 0xf3, 0xc0, 0x81, 0x6a, 0xb4, 0xc9, 0xbc, 0xc1, 0x82, 0xf4, 0x46, 0x87, 0x01, 0xc5, 0x07, - 0xbd, 0x85, 0x66, 0x8c, 0xc7, 0x54, 0x10, 0xcd, 0xe6, 0xa0, 0xef, 0x0a, 0xb0, 0xcc, 0x5e, 0xc8, - 0x22, 0xc5, 0x06, 0x5e, 0x93, 0xa1, 0xaf, 0xd9, 0x88, 0x79, 0xcd, 0x44, 0x3a, 0x2a, 0x85, 0xde, - 0xc5, 0x0b, 0xb2, 0x14, 0x7e, 0x5b, 0xb8, 0x28, 0xcb, 0xbf, 0x29, 0x40, 0x3e, 0x44, 0x40, 0xb7, - 0x87, 0xce, 0xe5, 0xe4, 0xcf, 0xe2, 0x0e, 0xe3, 0xdc, 0x1a, 0x3a, 0x8c, 0x53, 0xce, 0x7e, 0x71, - 0xba, 0x9a, 0x91, 0x59, 0xbc, 0xb7, 0x77, 0x2c, 0xe7, 0x46, 0x70, 0x0d, 0x4c, 0x7a, 0x20, 0x93, - 0x77, 0x0f, 0x0c, 0x85, 0x75, 0xaa, 0xb7, 0x8d, 0x44, 0x61, 0x1d, 0x79, 0x92, 0x7e, 0x90, 0x82, - 0x85, 0x75, 0x5d, 0x6f, 0x34, 0x28, 0x14, 0x48, 0x72, 0x8c, 0x21, 0xc8, 0x10, 0xff, 0x80, 0x9f, - 0x21, 0xa2, 0xbf, 0xd1, 0x7b, 0x80, 0x74, 0xc3, 0x61, 0xd7, 0x29, 0x38, 0x87, 0xaa, 0x6e, 0xbd, - 0x0e, 0x76, 0x8b, 0x17, 0xbc, 0x94, 0x86, 0x97, 0x80, 0x1a, 0x40, 0x9d, 0x56, 0xc5, 0x71, 0x55, - 0x7f, 0x35, 0xfc, 0xd6, 0x44, 0xa7, 0x52, 0x98, 0x37, 0xeb, 0x3f, 0xca, 0x39, 0x22, 0x87, 0xfe, - 0x24, 0x3e, 0x9a, 0x41, 0x1a, 0xc5, 0x55, 0x54, 0xc7, 0x3b, 0x4f, 0xc1, 0x2e, 0x72, 0x28, 0x30, - 0xfa, 0xba, 0xc3, 0x8e, 0x49, 0xb0, 0x30, 0xec, 0x40, 0x35, 0x49, 0xae, 0x65, 0xfe, 0x1d, 0x01, - 0x0a, 0x32, 0x3e, 0xb0, 0xb1, 0x73, 0x98, 0xa4, 0xce, 0x1f, 0xc3, 0x9c, 0xcd, 0xa4, 0x2a, 0x07, - 0xb6, 0xd5, 0xb9, 0x88, 0xad, 0xc8, 0x73, 0xc6, 0xc7, 0xb6, 0xd5, 0xe1, 0x26, 0xf9, 0x05, 0x14, - 0xfd, 0x32, 0x26, 0x59, 0xf9, 0xbf, 0x47, 0x4f, 0x5c, 0x32, 0xc1, 0x49, 0x6f, 0xdb, 0x26, 0xab, - 0x01, 0xba, 0x9e, 0x1d, 0x2e, 0x68, 0x92, 0x6a, 0xf8, 0xaf, 0x02, 0x14, 0x1a, 0xbd, 0x7d, 0x76, - 0x4d, 0x50, 0x72, 0x1a, 0xa8, 0x42, 0xae, 0x8d, 0x0f, 0x5c, 0xe5, 0x8d, 0x02, 0x88, 0xb3, 0x84, - 0x95, 0x86, 0x4f, 0x3f, 0x01, 0xb0, 0xe9, 0x91, 0x23, 0x2a, 0x27, 0x7d, 0x41, 0x39, 0x39, 0xca, - 0x4b, 0xc8, 0x64, 0xd6, 0x29, 0xfa, 0xd5, 0x4c, 0x72, 0x7e, 0x79, 0x19, 0xb1, 0x0e, 0xe9, 0x8b, - 0x58, 0x87, 0x05, 0xbe, 0x53, 0x1d, 0x6f, 0x21, 0x4a, 0xb0, 0x48, 0xdd, 0x32, 0x45, 0xed, 0x76, - 0xdb, 0x86, 0x87, 0x53, 0xa8, 0xfd, 0xc9, 0xc8, 0x0b, 0x34, 0x69, 0x9d, 0xa5, 0x50, 0x84, 0x82, - 0x7e, 0x43, 0x80, 0xb9, 0x03, 0x1b, 0xe3, 0xcf, 0xb1, 0x42, 0x4d, 0xf2, 0x64, 0x5b, 0xf1, 0x1b, - 0xa4, 0x0c, 0x5f, 0x7a, 0xab, 0x2e, 0xcf, 0x5e, 0xdc, 0x20, 0xef, 0x45, 0x3b, 0x20, 0x6a, 0x6d, - 0xb6, 0x79, 0xe8, 0x87, 0x05, 0xcc, 0x4c, 0x3e, 0x00, 0x8a, 0x8c, 0x39, 0x88, 0x0c, 0x78, 0x4e, - 0x06, 0x93, 0xaa, 0x2b, 0xfc, 0x6a, 0x36, 0xea, 0x6c, 0x47, 0xc3, 0x02, 0xc2, 0x47, 0xaf, 0x43, - 0x37, 0xba, 0x95, 0x64, 0xac, 0xea, 0xdc, 0x73, 0x27, 0xe3, 0xca, 0x7f, 0xe0, 0xe3, 0xea, 0x25, - 0x2c, 0xd0, 0x7e, 0x93, 0xf4, 0x09, 0x4a, 0xe9, 0x1f, 0xa5, 0x01, 0x85, 0x25, 0xff, 0xfc, 0xfa, - 0x5b, 0x2a, 0xb9, 0xfe, 0xb6, 0x09, 0x52, 0xc8, 0x19, 0x6a, 0xab, 0x8e, 0xab, 0xb0, 0xf8, 0x33, - 0x47, 0xe9, 0x62, 0x5b, 0x71, 0xb0, 0x66, 0xf1, 0x4b, 0x74, 0x04, 0x79, 0x25, 0xc8, 0xf9, 0x54, - 0x75, 0xdc, 0xe7, 0x2c, 0xdf, 0x2e, 0xb6, 0x1b, 0x34, 0x17, 0x7a, 0x04, 0x57, 0x3a, 0xea, 0x49, - 0x1c, 0xff, 0x34, 0xe5, 0x5f, 0xec, 0xa8, 0x27, 0x43, 0x4c, 0x1f, 0xc2, 0x72, 0x3c, 0x93, 0xe2, - 0x60, 0x6f, 0x7f, 0xea, 0x4a, 0x0c, 0x63, 0x03, 0xbb, 0x68, 0x1d, 0x20, 0x00, 0x11, 0x7c, 0x8e, - 0x9e, 0x04, 0x43, 0xe4, 0x7c, 0x0c, 0x21, 0x7d, 0x4f, 0x80, 0xc2, 0xb6, 0xd1, 0xb2, 0xd5, 0x44, - 0xaf, 0xa8, 0x41, 0x1f, 0x46, 0x37, 0xf4, 0xf2, 0x0f, 0x97, 0xe3, 0x02, 0x36, 0x58, 0x0e, 0x6f, - 0xd1, 0x8e, 0x33, 0x90, 0xa9, 0xcf, 0x2f, 0x51, 0x92, 0x36, 0xff, 0x3f, 0x5c, 0x83, 0x39, 0x5e, - 0xee, 0x3d, 0xd3, 0xb0, 0x4c, 0xf4, 0x00, 0xd2, 0x2d, 0xbe, 0xb4, 0x9d, 0x8f, 0x5d, 0xd1, 0x0b, - 0x2e, 0x80, 0xab, 0x4d, 0xc9, 0x24, 0x2f, 0x61, 0xe9, 0xf6, 0xdc, 0x18, 0x40, 0x11, 0xc4, 0x30, - 0x87, 0x59, 0xba, 0x3d, 0x17, 0x35, 0xa0, 0xa8, 0x05, 0xb7, 0x4e, 0x29, 0x84, 0x3d, 0x3d, 0x72, - 0x99, 0x2b, 0xf6, 0xfe, 0xaf, 0xda, 0x94, 0x5c, 0xd0, 0x22, 0x09, 0xa8, 0x12, 0xbe, 0xec, 0x28, - 0x33, 0x14, 0x20, 0x15, 0x1c, 0x95, 0x8d, 0x5e, 0xb4, 0x54, 0x9b, 0x0a, 0xdd, 0x89, 0x84, 0x3e, - 0x84, 0x19, 0x9d, 0x5e, 0xab, 0xc3, 0x8d, 0x66, 0x5c, 0x43, 0x47, 0x6e, 0x2f, 0xaa, 0x4d, 0xc9, - 0x9c, 0x03, 0x6d, 0xc2, 0x1c, 0xfb, 0xc5, 0x5c, 0x7a, 0x6e, 0xea, 0x6e, 0x8d, 0x96, 0x10, 0x72, - 0x36, 0x6a, 0x53, 0x72, 0x5e, 0x0f, 0xa8, 0xe8, 0x09, 0xe4, 0xb5, 0x36, 0x56, 0x6d, 0x2e, 0xea, - 0xf6, 0xc8, 0x53, 0x5d, 0x43, 0x57, 0xf1, 0xd4, 0xa6, 0x64, 0xd0, 0x7c, 0x22, 0x29, 0x94, 0x4d, - 0x6f, 0x64, 0xe1, 0x92, 0xde, 0x1f, 0x59, 0xa8, 0xe1, 0xeb, 0x6d, 0x6a, 0xd4, 0x09, 0xf1, 0xa9, - 0xe8, 0xeb, 0x90, 0x71, 0x34, 0xd5, 0xe4, 0x76, 0x77, 0x65, 0xc4, 0x95, 0x19, 0x01, 0x33, 0xcd, - 0x8d, 0x3e, 0x62, 0x68, 0xc0, 0x3d, 0xf1, 0xd6, 0x32, 0xe3, 0x74, 0x1a, 0x39, 0x9a, 0x4d, 0x74, - 0x8a, 0x29, 0x81, 0xe8, 0x41, 0x25, 0xf0, 0x47, 0xa1, 0xe7, 0x25, 0xe9, 0xe2, 0x65, 0xbc, 0x1e, - 0x86, 0xce, 0xb7, 0xd6, 0xe8, 0xf9, 0x6f, 0x8f, 0x88, 0xb6, 0x61, 0x9e, 0x09, 0xea, 0xb1, 0xa3, - 0x97, 0x4b, 0x6b, 0x23, 0x77, 0x29, 0x63, 0x0e, 0x7f, 0xd6, 0xa6, 0xe4, 0x39, 0x35, 0x44, 0x0e, - 0xca, 0xd5, 0xc1, 0x76, 0x8b, 0xad, 0x92, 0x8e, 0x29, 0x57, 0x38, 0xf4, 0xcb, 0x2f, 0x17, 0x25, - 0xa2, 0x5f, 0x83, 0x4b, 0x4c, 0x90, 0xcb, 0x23, 0x5a, 0x78, 0x60, 0xc4, 0x3b, 0x23, 0x77, 0x18, - 0x47, 0x1e, 0x97, 0xac, 0x4d, 0xc9, 0x48, 0x1d, 0x4a, 0x44, 0x1a, 0x5c, 0x66, 0x6f, 0xe0, 0xe7, - 0xed, 0x6c, 0x7e, 0x44, 0x6c, 0xe9, 0x26, 0x7d, 0xc5, 0x7b, 0xa3, 0x5e, 0x11, 0x7b, 0x0c, 0xb0, - 0x36, 0x25, 0x2f, 0xaa, 0xc3, 0xa9, 0x41, 0x35, 0x6c, 0x7e, 0xb2, 0x89, 0x77, 0xb7, 0xf7, 0xc6, - 0x57, 0x23, 0xee, 0x44, 0x98, 0x5f, 0x8d, 0x48, 0x22, 0x69, 0x40, 0xff, 0x5c, 0x37, 0xed, 0x4c, - 0x73, 0x23, 0x1b, 0x30, 0xe6, 0xf8, 0x13, 0x69, 0xc0, 0xc3, 0x10, 0x19, 0x95, 0x20, 0xd5, 0xd2, - 0x96, 0xe6, 0x47, 0xce, 0x0f, 0xfe, 0x11, 0x9f, 0xda, 0x94, 0x9c, 0x6a, 0x69, 0xe8, 0x13, 0xc8, - 0xb2, 0xf3, 0x1a, 0x27, 0xe6, 0x52, 0x61, 0xa4, 0xc1, 0x8d, 0x9e, 0x7a, 0xa9, 0x4d, 0xc9, 0xf4, - 0x88, 0x08, 0xef, 0xc8, 0x3c, 0x16, 0x9f, 0x8a, 0x28, 0x8d, 0x39, 0xa6, 0x39, 0x70, 0x22, 0x82, - 0x74, 0x18, 0xdb, 0x27, 0xa2, 0x5d, 0x28, 0xd8, 0x2c, 0x5a, 0xd1, 0x8b, 0x2d, 0x16, 0x47, 0xee, - 0xe1, 0xc7, 0x85, 0x17, 0xd7, 0xe8, 0x3a, 0x4c, 0x88, 0x4e, 0xda, 0x2e, 0x2a, 0x91, 0xb7, 0xdd, - 0xc2, 0xc8, 0xb6, 0x1b, 0x19, 0xea, 0x4a, 0xda, 0xce, 0x1e, 0x4a, 0x44, 0xdf, 0x84, 0x69, 0x36, - 0x4e, 0x10, 0x15, 0x19, 0x17, 0x96, 0x32, 0x30, 0x44, 0x58, 0x7e, 0x62, 0xbd, 0x5c, 0x1e, 0xb2, - 0xa7, 0xb4, 0xad, 0xd6, 0xd2, 0xe2, 0x48, 0xeb, 0x35, 0x1c, 0x7c, 0x48, 0xac, 0x97, 0x1b, 0x50, - 0x49, 0x07, 0xb2, 0x59, 0x0a, 0x1f, 0x62, 0x97, 0x46, 0x76, 0xa0, 0x98, 0x48, 0xbe, 0x1a, 0x3d, - 0x4c, 0x11, 0x90, 0x7d, 0xc3, 0xea, 0x60, 0x85, 0x1a, 0xc5, 0xcb, 0xe3, 0x0d, 0x6b, 0xe4, 0x1e, - 0x23, 0xdf, 0xb0, 0x32, 0x2a, 0x7a, 0x01, 0x22, 0xbf, 0x4c, 0x43, 0xf1, 0x22, 0x4b, 0x96, 0xae, - 0x50, 0x79, 0xf7, 0x62, 0x27, 0xc4, 0xb8, 0xa0, 0xa3, 0x1a, 0x71, 0x98, 0xa3, 0x29, 0xe8, 0x53, - 0x58, 0xa0, 0xf2, 0x14, 0x2d, 0xb8, 0xff, 0x64, 0x69, 0x69, 0xe8, 0x36, 0x8d, 0xd1, 0x57, 0xa5, - 0x78, 0x92, 0x45, 0x6d, 0x20, 0x89, 0x8c, 0x07, 0xc3, 0x34, 0x5c, 0x3a, 0x77, 0x2f, 0x8f, 0x1c, - 0x0f, 0xd1, 0xbb, 0x1f, 0xc9, 0x78, 0x30, 0x18, 0x85, 0x74, 0xe3, 0x01, 0x8b, 0xf7, 0xf6, 0xc8, - 0x6e, 0x3c, 0xc2, 0xd8, 0xcd, 0xbb, 0x11, 0x3b, 0xb7, 0x01, 0xc0, 0x60, 0x12, 0xf5, 0xfc, 0x56, - 0x46, 0x3a, 0x00, 0x83, 0x91, 0x76, 0xc4, 0x01, 0x68, 0x7b, 0x34, 0xe2, 0x00, 0xb0, 0x35, 0xfd, - 0xa5, 0xeb, 0xa3, 0x27, 0xab, 0xf0, 0xae, 0x1f, 0x9d, 0xac, 0x28, 0x01, 0xad, 0x43, 0x8e, 0xf8, - 0xac, 0x7d, 0x3a, 0xc2, 0x6f, 0x8c, 0x84, 0xa8, 0x03, 0x47, 0x70, 0x6a, 0x53, 0x72, 0xf6, 0x15, - 0x27, 0x91, 0x5e, 0xc5, 0x44, 0xf0, 0xb1, 0x7d, 0x7f, 0x64, 0xaf, 0x1a, 0x3e, 0x7b, 0x41, 0x7a, - 0xd5, 0xab, 0x80, 0x1a, 0x4c, 0x79, 0x0e, 0x5b, 0xad, 0x5f, 0x7a, 0x77, 0xfc, 0x94, 0x17, 0xdd, - 0x5b, 0xf0, 0xa7, 0x3c, 0x4e, 0x66, 0x53, 0x9e, 0xae, 0x38, 0x0e, 0xdd, 0xc0, 0x5f, 0xba, 0x35, - 0x66, 0xca, 0x1b, 0x58, 0xbf, 0x63, 0x53, 0x9e, 0xde, 0x60, 0x9c, 0xc4, 0xfb, 0xb3, 0xbd, 0xcb, - 0x63, 0x38, 0x7a, 0xb9, 0x33, 0xd2, 0xfb, 0x8b, 0xbd, 0xdd, 0x86, 0x78, 0x7f, 0x76, 0x24, 0x01, - 0xfd, 0x12, 0xcc, 0xf2, 0xf5, 0x92, 0xa5, 0xbb, 0x63, 0xfc, 0xe1, 0xf0, 0x12, 0x17, 0xe9, 0x8e, - 0x9c, 0x87, 0x19, 0x07, 0xb6, 0x4e, 0xc3, 0x8c, 0xdf, 0xbd, 0x31, 0xc6, 0x61, 0x68, 0xa9, 0x88, - 0x19, 0x87, 0x80, 0x4c, 0x4a, 0xe3, 0xb0, 0x35, 0x86, 0xa5, 0x5f, 0x18, 0x59, 0x9a, 0xe8, 0x62, - 0x0b, 0x29, 0x0d, 0xe7, 0xa1, 0x93, 0x05, 0x9d, 0xab, 0x99, 0x76, 0xbe, 0x36, 0x7a, 0xb2, 0x18, - 0x44, 0xad, 0x35, 0x6f, 0x37, 0x84, 0x69, 0xe5, 0xaf, 0x08, 0x70, 0x9d, 0xf5, 0x01, 0xba, 0x16, - 0xdc, 0x57, 0xfc, 0xa5, 0xfc, 0x10, 0x24, 0x7f, 0x40, 0xc5, 0x7f, 0xf3, 0xe2, 0x2b, 0xcf, 0xde, - 0x1b, 0xdf, 0x51, 0xc7, 0xe5, 0x23, 0xca, 0xe8, 0x30, 0xf0, 0xb2, 0xf4, 0x70, 0xa4, 0x32, 0xa2, - 0x80, 0x8b, 0x28, 0x83, 0xf3, 0x94, 0x67, 0xf9, 0x6e, 0xa7, 0x7f, 0xb2, 0xb1, 0x28, 0x8a, 0x9b, - 0x99, 0xec, 0x55, 0x71, 0x69, 0x33, 0x93, 0xbd, 0x26, 0x2e, 0x6f, 0x66, 0xb2, 0x6f, 0x89, 0x6f, - 0x6f, 0x66, 0xb2, 0xab, 0xe2, 0xf5, 0xcd, 0x4c, 0x56, 0x12, 0x6f, 0x4a, 0xbf, 0x77, 0x0d, 0xe6, - 0x3d, 0xec, 0xc3, 0x70, 0xcd, 0xc3, 0x30, 0xae, 0x59, 0x19, 0x85, 0x6b, 0x38, 0x5a, 0xe2, 0xc0, - 0xe6, 0x61, 0x18, 0xd8, 0xac, 0x8c, 0x02, 0x36, 0x01, 0x0f, 0x41, 0x36, 0xcd, 0x51, 0xc8, 0xe6, - 0xde, 0x04, 0xc8, 0xc6, 0x17, 0x35, 0x08, 0x6d, 0x36, 0x86, 0xa1, 0xcd, 0xbb, 0xe3, 0xa1, 0x8d, - 0x2f, 0x2a, 0x84, 0x6d, 0x3e, 0x1a, 0xc0, 0x36, 0x37, 0xc6, 0x60, 0x1b, 0x9f, 0xdf, 0x03, 0x37, - 0x5b, 0xb1, 0xe0, 0xe6, 0xf6, 0x79, 0xe0, 0xc6, 0x97, 0x13, 0x41, 0x37, 0xb5, 0x38, 0x74, 0x73, - 0xeb, 0x1c, 0x74, 0xe3, 0x8b, 0x0a, 0xc3, 0x9b, 0xad, 0x58, 0x78, 0x73, 0xfb, 0x3c, 0x78, 0x13, - 0x14, 0x2b, 0x8c, 0x6f, 0xbe, 0x11, 0xc1, 0x37, 0xab, 0x23, 0xf1, 0x8d, 0xcf, 0xcd, 0x00, 0xce, - 0xc7, 0x83, 0x00, 0xe7, 0xc6, 0x18, 0x80, 0x13, 0x28, 0x96, 0x23, 0x9c, 0x5a, 0x1c, 0xc2, 0xb9, - 0x75, 0x0e, 0xc2, 0x09, 0x74, 0x11, 0x82, 0x38, 0x3b, 0xf1, 0x10, 0xe7, 0xce, 0xb9, 0x10, 0xc7, - 0x97, 0x16, 0xc5, 0x38, 0xb5, 0x38, 0x8c, 0x73, 0xeb, 0x1c, 0x8c, 0x33, 0x50, 0x32, 0x06, 0x72, - 0xd4, 0xb1, 0x20, 0xe7, 0xbd, 0x09, 0x41, 0x8e, 0x2f, 0x3a, 0x0e, 0xe5, 0xe8, 0xe3, 0x51, 0x4e, - 0x69, 0x52, 0x94, 0xe3, 0xbf, 0x24, 0x16, 0xe6, 0xa8, 0x63, 0x61, 0xce, 0x7b, 0x13, 0xc2, 0x9c, - 0x81, 0x8a, 0x44, 0x71, 0xce, 0x4e, 0x3c, 0xce, 0xb9, 0x73, 0x2e, 0xce, 0x09, 0x5a, 0x31, 0x02, - 0x74, 0xd6, 0x42, 0x40, 0xe7, 0x9d, 0x11, 0x40, 0xc7, 0x67, 0x25, 0x48, 0xe7, 0x5b, 0x43, 0x48, - 0x47, 0x1a, 0x87, 0x74, 0x7c, 0x5e, 0x1f, 0xea, 0xd4, 0xe2, 0xa0, 0xce, 0xad, 0x73, 0xa0, 0x4e, - 0xd0, 0x6f, 0x42, 0x58, 0xe7, 0xf9, 0x08, 0xac, 0x73, 0xf7, 0x7c, 0xac, 0xe3, 0xcb, 0x1b, 0x00, - 0x3b, 0xea, 0x58, 0xb0, 0xf3, 0xde, 0x84, 0x60, 0x27, 0x68, 0xc1, 0x18, 0xb4, 0xf3, 0x41, 0x14, - 0xed, 0x5c, 0x1f, 0x8d, 0x76, 0x7c, 0x31, 0x1c, 0xee, 0x6c, 0xc5, 0xc2, 0x9d, 0xdb, 0xe7, 0xc1, - 0x9d, 0xc0, 0x9a, 0x85, 0xf1, 0xce, 0x4e, 0x3c, 0xde, 0xb9, 0x73, 0x2e, 0xde, 0x09, 0x3a, 0x52, - 0x04, 0xf0, 0x6c, 0xc5, 0x02, 0x9e, 0xdb, 0xe7, 0x01, 0x9e, 0x01, 0x53, 0xcb, 0x11, 0xcf, 0xcb, - 0x91, 0x88, 0xe7, 0xfe, 0x24, 0x88, 0xc7, 0x17, 0x3a, 0x04, 0x79, 0x3e, 0x1b, 0x0d, 0x79, 0x7e, - 0xe1, 0x02, 0xb7, 0x43, 0xc6, 0x62, 0x9e, 0x6f, 0x0d, 0x61, 0x1e, 0x69, 0x1c, 0xe6, 0x09, 0x46, - 0x86, 0x07, 0x7a, 0xaa, 0x31, 0x10, 0xe5, 0xdd, 0xf1, 0x10, 0x25, 0x98, 0xc8, 0x03, 0x8c, 0xf2, - 0xd1, 0x00, 0x46, 0xb9, 0x71, 0x6e, 0x20, 0x56, 0x08, 0xa4, 0x94, 0x87, 0x41, 0xca, 0xcd, 0xb1, - 0x20, 0xc5, 0x97, 0x10, 0xa0, 0x94, 0xad, 0x58, 0x94, 0x72, 0xfb, 0x3c, 0x94, 0x12, 0x74, 0x85, - 0x30, 0x4c, 0xd9, 0x89, 0x87, 0x29, 0x77, 0xce, 0x85, 0x29, 0x03, 0xd3, 0x96, 0x87, 0x53, 0x6a, - 0x71, 0x38, 0xe5, 0xd6, 0x39, 0x38, 0x25, 0x3c, 0x6d, 0xf9, 0x40, 0xa5, 0x39, 0x0a, 0xa8, 0xdc, - 0x9b, 0x00, 0xa8, 0x04, 0xce, 0xdc, 0x00, 0x52, 0xf9, 0x64, 0x10, 0xa9, 0x48, 0xe3, 0x90, 0x4a, - 0xd0, 0x89, 0x3c, 0xa8, 0xb2, 0x13, 0x0f, 0x55, 0xee, 0x9c, 0x0b, 0x55, 0xc2, 0xe3, 0x3a, 0x84, - 0x55, 0x3e, 0x19, 0xc4, 0x2a, 0xd2, 0x38, 0xac, 0x12, 0x94, 0xc7, 0x03, 0x2b, 0xb5, 0x38, 0xb0, - 0x72, 0xeb, 0x1c, 0xb0, 0x12, 0x32, 0xf7, 0x01, 0x5a, 0xf9, 0xab, 0x93, 0xa3, 0x95, 0x0f, 0xde, - 0x34, 0x4e, 0xe6, 0x7c, 0xb8, 0xf2, 0xc9, 0x20, 0x5c, 0x91, 0xc6, 0xc1, 0x95, 0x40, 0x1f, 0x17, - 0xc6, 0x2b, 0x6f, 0x8b, 0xef, 0x44, 0x50, 0xcb, 0x9f, 0xcc, 0xc0, 0x0c, 0xff, 0x52, 0x51, 0xe4, - 0x76, 0x1f, 0xe1, 0x4d, 0x6e, 0xf7, 0x41, 0x1b, 0xa4, 0x9b, 0x51, 0xb7, 0xe5, 0xfc, 0x3b, 0xe1, - 0x86, 0x6f, 0x2d, 0xe3, 0xac, 0x6f, 0x70, 0xcc, 0x16, 0x7d, 0x03, 0xe6, 0x7b, 0x0e, 0xb6, 0x95, - 0xae, 0x6d, 0x58, 0xb6, 0xe1, 0xb2, 0x03, 0x03, 0x42, 0x59, 0xfc, 0xe2, 0x74, 0x75, 0x6e, 0xcf, - 0xc1, 0xf6, 0x2e, 0xa7, 0xcb, 0x73, 0xbd, 0xd0, 0x93, 0xf7, 0x71, 0xa6, 0xe9, 0xc9, 0x3f, 0xce, - 0xf4, 0x1c, 0x44, 0xba, 0x1d, 0x1c, 0xb6, 0xf4, 0xec, 0x26, 0x9d, 0xf8, 0x49, 0x49, 0xd5, 0x43, - 0xc6, 0x9c, 0xde, 0xa8, 0x53, 0xb4, 0xa3, 0x44, 0xd4, 0x00, 0x7a, 0xc7, 0x85, 0xd2, 0xb5, 0xda, - 0x86, 0xd6, 0xa7, 0x13, 0x78, 0xf4, 0x56, 0xe1, 0xb1, 0x77, 0x7b, 0xbf, 0x54, 0x0d, 0x77, 0x97, - 0x72, 0xca, 0xf0, 0xda, 0xff, 0x8d, 0x1e, 0xc0, 0xe5, 0x8e, 0x7a, 0x42, 0xaf, 0x5b, 0x55, 0xbc, - 0x19, 0x99, 0x5e, 0x30, 0xc5, 0x3e, 0xd3, 0x84, 0x3a, 0xea, 0x09, 0xfd, 0x7c, 0x14, 0x4b, 0xa2, - 0xdf, 0x7e, 0xb8, 0x01, 0x73, 0x3c, 0x70, 0x9b, 0x7d, 0x1a, 0xa6, 0x48, 0x73, 0xf2, 0xef, 0x04, - 0xb0, 0xaf, 0xc3, 0xdc, 0x82, 0x82, 0x6e, 0x38, 0xae, 0x61, 0x6a, 0x2e, 0xbf, 0xc9, 0x95, 0xdd, - 0x85, 0x3a, 0xef, 0x51, 0xd9, 0x75, 0xad, 0x4d, 0x58, 0xd0, 0xda, 0x86, 0xef, 0xe7, 0xb0, 0x99, - 0x67, 0x61, 0x64, 0xbf, 0xae, 0xd0, 0xbc, 0x83, 0x9b, 0xa3, 0x45, 0x2d, 0x4a, 0x46, 0x15, 0x28, - 0xb6, 0x54, 0x17, 0xbf, 0x56, 0xfb, 0x8a, 0x77, 0x2e, 0x29, 0x4f, 0xcf, 0x62, 0xbe, 0x75, 0x76, - 0xba, 0x3a, 0xff, 0x84, 0x25, 0x0d, 0x1d, 0x4f, 0x9a, 0x6f, 0x85, 0x12, 0x74, 0x74, 0x07, 0x8a, - 0xaa, 0xd3, 0x37, 0x35, 0xda, 0x80, 0xd8, 0x74, 0x7a, 0x0e, 0x75, 0x53, 0xb3, 0x72, 0x81, 0x92, - 0x2b, 0x1e, 0x15, 0x7d, 0x04, 0xcb, 0xfc, 0xc2, 0xf6, 0xd7, 0xaa, 0xad, 0x2b, 0xb4, 0xd1, 0x83, - 0xe1, 0x21, 0x52, 0x9e, 0xab, 0xec, 0x82, 0x76, 0x92, 0x81, 0xb4, 0x74, 0xf8, 0x22, 0x54, 0x76, - 0xd1, 0x2b, 0x88, 0xf9, 0xcd, 0x4c, 0x76, 0x4e, 0x9c, 0xdf, 0xcc, 0x64, 0x0b, 0x62, 0x51, 0xfa, - 0x37, 0x02, 0x14, 0x89, 0xc5, 0x70, 0x1c, 0xc3, 0x32, 0x6b, 0x7e, 0x88, 0xa0, 0xdf, 0x6b, 0x05, - 0x7a, 0x44, 0xc4, 0x7f, 0x46, 0xab, 0xf4, 0x28, 0x0e, 0xf1, 0xcc, 0xfc, 0xcf, 0x34, 0xa4, 0x65, - 0x60, 0x24, 0x7a, 0x28, 0x62, 0x1d, 0x66, 0x1c, 0xab, 0x67, 0x6b, 0xde, 0xe5, 0xe1, 0xf7, 0x46, - 0x98, 0xa8, 0xd0, 0x0b, 0x4b, 0x0d, 0xca, 0x20, 0x73, 0x46, 0xa9, 0x04, 0x33, 0x8c, 0x82, 0x72, - 0x30, 0xfd, 0xac, 0x59, 0xab, 0xca, 0xe2, 0x14, 0x9a, 0x83, 0xec, 0x63, 0xf9, 0xd9, 0xb6, 0xd2, - 0x78, 0xfe, 0x54, 0x14, 0x50, 0x1e, 0x66, 0xe5, 0x67, 0xcf, 0x9a, 0xca, 0xd6, 0x0b, 0x31, 0x25, - 0xfd, 0xb1, 0x00, 0x73, 0x65, 0x76, 0x7b, 0x3a, 0xdb, 0xa7, 0xfe, 0x68, 0x60, 0x53, 0xf8, 0x5a, - 0x3c, 0x6a, 0x88, 0xdf, 0xa0, 0x5e, 0x87, 0x2c, 0xef, 0x9e, 0x5e, 0x84, 0xf7, 0xea, 0x68, 0x5f, - 0x91, 0x2e, 0xab, 0x78, 0x51, 0x3a, 0x1e, 0x1b, 0x6a, 0x80, 0xa8, 0x7a, 0x55, 0x54, 0x78, 0x49, - 0x46, 0xc7, 0xea, 0x0c, 0x68, 0xc3, 0xeb, 0x6c, 0x6a, 0x94, 0xfc, 0x61, 0xe6, 0xfb, 0x3f, 0x5c, - 0x9d, 0x92, 0xfe, 0x34, 0x03, 0xf3, 0xe5, 0xf0, 0x4d, 0xf1, 0xa8, 0x3e, 0x50, 0xd9, 0xb8, 0x19, - 0x30, 0xc2, 0x51, 0x1a, 0xf3, 0x0d, 0x8e, 0x5c, 0x70, 0x2d, 0x3d, 0xab, 0xfb, 0xf5, 0x31, 0xfb, - 0xe9, 0xe1, 0xca, 0x07, 0x8c, 0xcb, 0xff, 0x3e, 0xed, 0x1b, 0xf0, 0x12, 0x4c, 0xb3, 0x53, 0x44, - 0xc2, 0xd0, 0x01, 0x67, 0x6a, 0x42, 0x88, 0x87, 0x46, 0xd2, 0x65, 0x96, 0x8d, 0x18, 0xfc, 0xe6, - 0x1b, 0x5d, 0xe7, 0x16, 0xcc, 0x5b, 0x17, 0xff, 0xba, 0x5d, 0x8f, 0x5d, 0xe7, 0xf7, 0xff, 0x31, - 0x3c, 0x88, 0xbc, 0x0f, 0xfd, 0x2a, 0x14, 0x35, 0xab, 0xdd, 0x66, 0x13, 0x3b, 0x33, 0x5d, 0xc3, - 0x17, 0x7c, 0xd0, 0x22, 0xf0, 0x0f, 0x1a, 0x96, 0xfc, 0x0f, 0x1b, 0x96, 0x64, 0xfe, 0x61, 0xc3, - 0x50, 0xec, 0x76, 0xc1, 0x17, 0xc6, 0x2c, 0xde, 0x40, 0x18, 0xf9, 0xec, 0x9b, 0x84, 0x91, 0xb3, - 0xe0, 0x7b, 0xde, 0xf3, 0xfe, 0x40, 0xe0, 0x41, 0x3c, 0x4f, 0x2d, 0xeb, 0xa8, 0xe7, 0x07, 0x7e, - 0x2f, 0x87, 0x2f, 0xe7, 0x0b, 0x22, 0x5c, 0xe9, 0x09, 0x8d, 0xb8, 0xa9, 0x29, 0xf5, 0xe5, 0xa6, - 0xa6, 0x1b, 0x30, 0xd7, 0xb5, 0xf1, 0x01, 0x76, 0xb5, 0x43, 0xc5, 0xec, 0x75, 0xf8, 0xf1, 0x94, - 0xbc, 0x47, 0xdb, 0xe9, 0x75, 0xd0, 0x3d, 0x10, 0xfd, 0x2c, 0x1c, 0x6c, 0x79, 0x37, 0x43, 0x79, - 0x74, 0x0e, 0xcd, 0xa4, 0xff, 0x25, 0xc0, 0x62, 0xa4, 0x4e, 0x7c, 0x4c, 0x6d, 0x42, 0x5e, 0xf7, - 0x9d, 0x01, 0x67, 0x49, 0xb8, 0x60, 0xec, 0x73, 0x98, 0x19, 0x29, 0x70, 0xc5, 0x7b, 0x2d, 0xbd, - 0xca, 0x3d, 0x10, 0x9b, 0xba, 0xa0, 0xd8, 0xcb, 0x81, 0x9c, 0x8d, 0xd0, 0x0b, 0xfc, 0x41, 0x96, - 0x9e, 0x68, 0x90, 0x49, 0xff, 0x5b, 0x00, 0x91, 0xbe, 0xe0, 0x31, 0xc6, 0x7a, 0x22, 0x26, 0xd3, - 0x3b, 0x64, 0x90, 0x9a, 0xfc, 0x00, 0x4a, 0xe4, 0xf3, 0x13, 0xe9, 0x81, 0xcf, 0x4f, 0xc4, 0xd9, - 0xcf, 0xcc, 0x97, 0xb4, 0x9f, 0xd2, 0x0f, 0x05, 0x28, 0xf8, 0xd5, 0x66, 0xdf, 0x9d, 0x1b, 0x73, - 0xb1, 0xe4, 0x9b, 0x7d, 0x5b, 0xcd, 0xbb, 0x00, 0x63, 0xa2, 0x4f, 0xe1, 0x85, 0x2f, 0xc0, 0x60, - 0xdf, 0x04, 0xfb, 0x5b, 0x5e, 0x77, 0x24, 0x45, 0xac, 0x04, 0x37, 0x0f, 0xbc, 0xc1, 0x01, 0x1f, - 0x99, 0x7e, 0xb2, 0xd3, 0x6a, 0x1f, 0xb3, 0x3b, 0x4b, 0x26, 0xb2, 0xa5, 0x88, 0xc7, 0xc3, 0x01, - 0x5f, 0xeb, 0xd1, 0x9b, 0x0d, 0xfa, 0x31, 0x4f, 0xf6, 0xdb, 0x91, 0x1e, 0x87, 0x14, 0x48, 0x7b, - 0x14, 0xd1, 0xd2, 0x44, 0xf6, 0xdd, 0xd3, 0x12, 0xeb, 0x80, 0x3f, 0x0e, 0xb7, 0x04, 0x3b, 0xb9, - 0xfa, 0x08, 0xd2, 0xc7, 0x6a, 0x7b, 0x5c, 0x0c, 0x57, 0xa4, 0xe5, 0x64, 0x92, 0x1b, 0x3d, 0x8e, - 0x5c, 0xd8, 0x90, 0x1a, 0xbd, 0x10, 0x33, 0xac, 0xd2, 0xc8, 0xc5, 0x0e, 0xdf, 0x8c, 0x0e, 0xa0, - 0xb1, 0xaf, 0x0f, 0x8f, 0xa4, 0x0f, 0x33, 0x3f, 0xfa, 0xe1, 0xaa, 0x20, 0x7d, 0x0c, 0x48, 0xc6, - 0x0e, 0x76, 0x9f, 0xf7, 0x2c, 0x3b, 0xb8, 0xfc, 0x62, 0xf0, 0x30, 0xc1, 0x74, 0xfc, 0x61, 0x02, - 0xe9, 0x32, 0x2c, 0x46, 0xb8, 0x99, 0x05, 0x92, 0xbe, 0x09, 0xd7, 0x9e, 0x58, 0x8e, 0x63, 0x74, - 0x09, 0xe4, 0xa4, 0x43, 0x9d, 0xcc, 0x57, 0xbe, 0xcd, 0xcd, 0x76, 0x29, 0xca, 0x37, 0x99, 0x6d, - 0xca, 0xc9, 0xfe, 0xb3, 0xf4, 0xaf, 0x05, 0xb8, 0x3a, 0xcc, 0xc9, 0xb4, 0x1c, 0x77, 0x1e, 0x71, - 0x56, 0xb3, 0x82, 0xbb, 0xd9, 0xce, 0xef, 0xad, 0x5e, 0x76, 0xe2, 0xb6, 0xf2, 0x77, 0x2a, 0x1d, - 0x95, 0xda, 0x24, 0x7e, 0x54, 0xb8, 0xc0, 0xc9, 0xdb, 0x8c, 0x1a, 0x98, 0xa7, 0xcc, 0x64, 0xe6, - 0xa9, 0x09, 0xc5, 0x4d, 0xcb, 0x30, 0x89, 0x77, 0xec, 0xd5, 0x77, 0x1d, 0x0a, 0xfb, 0x86, 0xa9, - 0xda, 0x7d, 0xc5, 0x0b, 0x1d, 0x14, 0xce, 0x0b, 0x1d, 0x94, 0xe7, 0x19, 0x07, 0x7f, 0x94, 0x7e, - 0x2a, 0x80, 0x18, 0x88, 0xe5, 0x66, 0xfe, 0x6b, 0x00, 0x5a, 0xbb, 0xe7, 0xb8, 0xd8, 0xf6, 0x5a, - 0x69, 0x8e, 0x1d, 0x51, 0xa8, 0x30, 0x6a, 0x7d, 0x43, 0xce, 0xf1, 0x0c, 0x75, 0x1d, 0xdd, 0x8c, - 0xde, 0x3e, 0x30, 0x5d, 0x86, 0xb3, 0xa1, 0x3b, 0x07, 0x48, 0xb3, 0x3b, 0xae, 0x65, 0xfb, 0x48, - 0x91, 0x37, 0xbb, 0x77, 0x2f, 0x0b, 0x3d, 0x7f, 0x8c, 0xe9, 0x29, 0xa4, 0x02, 0xf1, 0x41, 0x8e, - 0xb1, 0x5f, 0xa5, 0xcc, 0xf9, 0x55, 0x62, 0x1c, 0x5e, 0x95, 0xfe, 0xb9, 0x00, 0xc5, 0x0a, 0x6b, - 0x0d, 0xbf, 0x85, 0xc7, 0x58, 0xb4, 0x0d, 0xc8, 0xba, 0x27, 0xa6, 0xd2, 0xc1, 0xfe, 0xa7, 0x44, - 0x2e, 0x70, 0x71, 0xda, 0xac, 0xcb, 0x1e, 0xe9, 0xd7, 0xe9, 0xf8, 0xa7, 0x91, 0xf9, 0x70, 0xb9, - 0x56, 0x62, 0xdf, 0x4e, 0x2e, 0x79, 0xdf, 0x4e, 0x2e, 0x6d, 0xf0, 0x0c, 0x6c, 0xa6, 0xf8, 0xfe, - 0x7f, 0x5e, 0x15, 0x64, 0x9f, 0x89, 0x39, 0x13, 0xf7, 0x1b, 0xa4, 0xd7, 0x0f, 0x4d, 0xf7, 0xa8, - 0x00, 0x10, 0xfa, 0x46, 0x0c, 0xff, 0x1a, 0xef, 0xfa, 0x86, 0xb2, 0xb7, 0x53, 0x79, 0xb6, 0xbd, - 0x5d, 0x6f, 0x36, 0xab, 0x1b, 0xa2, 0x80, 0x44, 0x98, 0x8b, 0x7c, 0x61, 0x26, 0xc5, 0xbe, 0xcf, - 0x7b, 0xff, 0x2f, 0x00, 0x04, 0x1f, 0xab, 0x22, 0xb2, 0xb6, 0xaa, 0x9f, 0x2a, 0x2f, 0xd6, 0x9f, - 0xee, 0x55, 0x1b, 0xe2, 0x14, 0x42, 0x50, 0x28, 0xaf, 0x37, 0x2b, 0x35, 0x45, 0xae, 0x36, 0x76, - 0x9f, 0xed, 0x34, 0xaa, 0xde, 0x77, 0x7d, 0xef, 0x6f, 0xc0, 0x5c, 0xf8, 0x3a, 0x18, 0xb4, 0x08, - 0xc5, 0x4a, 0xad, 0x5a, 0xd9, 0x52, 0x5e, 0xd4, 0xd7, 0x95, 0xe7, 0x7b, 0xd5, 0xbd, 0xaa, 0x38, - 0x45, 0x8b, 0x46, 0x89, 0x8f, 0xf7, 0x9e, 0x12, 0x04, 0x52, 0x84, 0x3c, 0x7b, 0xa6, 0x5f, 0xa3, - 0x11, 0x53, 0xf7, 0xb7, 0x21, 0x1f, 0xba, 0xa6, 0x96, 0xbc, 0x6e, 0x77, 0xaf, 0x51, 0x53, 0x9a, - 0xf5, 0xed, 0x6a, 0xa3, 0xb9, 0xbe, 0xbd, 0xcb, 0x64, 0x50, 0xda, 0x7a, 0xf9, 0x99, 0xdc, 0x14, - 0x05, 0xff, 0xb9, 0xf9, 0x6c, 0xaf, 0x52, 0xf3, 0xaa, 0x21, 0x65, 0xb2, 0x69, 0x31, 0x7d, 0xff, - 0x04, 0xae, 0x8e, 0xb8, 0x19, 0x85, 0x80, 0x9f, 0x3d, 0x93, 0x5e, 0xd9, 0x29, 0x4e, 0xa1, 0x79, - 0xc8, 0x91, 0xae, 0x47, 0xcf, 0x4d, 0x8a, 0x02, 0xca, 0x42, 0xe6, 0xd0, 0x75, 0xbb, 0x62, 0x0a, - 0xcd, 0x40, 0xca, 0x79, 0x24, 0xa6, 0xc9, 0xff, 0x96, 0x23, 0x66, 0x08, 0x96, 0x52, 0x3f, 0xef, - 0xd9, 0x58, 0x9c, 0x26, 0x58, 0xaa, 0xe7, 0x60, 0xfb, 0xc0, 0x68, 0x63, 0x71, 0x96, 0xb0, 0x98, - 0xbd, 0x76, 0x5b, 0xcc, 0x4a, 0x99, 0xec, 0x8c, 0x38, 0x73, 0xff, 0x06, 0x84, 0x0e, 0xa8, 0x23, - 0x80, 0x99, 0xa7, 0xaa, 0x8b, 0x1d, 0x57, 0x9c, 0x42, 0xb3, 0x90, 0x5e, 0x6f, 0xb7, 0x45, 0xe1, - 0xe1, 0x3f, 0xcb, 0x40, 0xd6, 0xfb, 0xd8, 0x0a, 0x7a, 0x0a, 0xd3, 0x14, 0x5f, 0xa0, 0xd5, 0xd1, - 0xc8, 0x83, 0x8e, 0xe3, 0xe5, 0xeb, 0xe7, 0x41, 0x13, 0x69, 0x0a, 0xfd, 0x45, 0xc8, 0x87, 0x3c, - 0x32, 0x34, 0x72, 0x05, 0x2d, 0xe2, 0x85, 0x2e, 0xdf, 0x3e, 0x2f, 0x9b, 0x2f, 0xff, 0x25, 0xe4, - 0x7c, 0x63, 0x8e, 0x6e, 0x8e, 0x33, 0xf5, 0x9e, 0xec, 0xf1, 0xf3, 0x01, 0x19, 0x76, 0xd2, 0xd4, - 0xfb, 0x02, 0xb2, 0x01, 0x0d, 0xdb, 0x5d, 0x14, 0x17, 0x37, 0x36, 0xd2, 0xb0, 0x2f, 0xdf, 0x9f, - 0x28, 0x77, 0xf0, 0x4e, 0xa2, 0xac, 0x60, 0xf2, 0x88, 0x57, 0xd6, 0xd0, 0xd4, 0x14, 0xaf, 0xac, - 0x98, 0x39, 0x68, 0x0a, 0x3d, 0x87, 0x0c, 0x31, 0x9a, 0x28, 0xce, 0xed, 0x1a, 0x30, 0xd2, 0xcb, - 0x37, 0xc7, 0xe6, 0xf1, 0x44, 0x96, 0xef, 0xfd, 0xe8, 0xbf, 0xac, 0x4c, 0xfd, 0xe8, 0x6c, 0x45, - 0xf8, 0xe9, 0xd9, 0x8a, 0xf0, 0x87, 0x67, 0x2b, 0xc2, 0x1f, 0x9d, 0xad, 0x08, 0xdf, 0xfb, 0xd9, - 0xca, 0xd4, 0x4f, 0x7f, 0xb6, 0x32, 0xf5, 0x87, 0x3f, 0x5b, 0x99, 0xfa, 0x6c, 0x96, 0x73, 0xef, - 0xcf, 0x50, 0x8b, 0xf2, 0xe8, 0xff, 0x05, 0x00, 0x00, 0xff, 0xff, 0x47, 0x4a, 0x72, 0x7d, 0xf4, - 0x7e, 0x00, 0x00, + 0x7a, 0x9f, 0x9a, 0xa4, 0x24, 0xf2, 0xa3, 0x44, 0xb6, 0x4a, 0xf3, 0x47, 0xa3, 0xd9, 0x95, 0x66, + 0x7a, 0x76, 0xfe, 0xfa, 0x96, 0xda, 0x99, 0xb9, 0xcb, 0xae, 0x77, 0xd7, 0x6b, 0x8b, 0x14, 0x67, + 0x48, 0x69, 0xa4, 0xd1, 0x34, 0xa9, 0x19, 0xec, 0xfa, 0x9c, 0x76, 0xab, 0xbb, 0x44, 0xf5, 0x89, + 0xec, 0xe6, 0x74, 0x37, 0x35, 0xe2, 0x22, 0x79, 0x48, 0x72, 0x70, 0xee, 0x29, 0xb8, 0x00, 0x01, + 0xbc, 0x07, 0x07, 0xc1, 0x39, 0x36, 0x92, 0x87, 0x3c, 0x24, 0x88, 0x83, 0x04, 0x09, 0x92, 0x18, + 0x79, 0xca, 0x21, 0x38, 0xe4, 0xce, 0x40, 0x1e, 0x8c, 0x00, 0x51, 0x9c, 0xb9, 0x3c, 0xc4, 0x30, + 0x02, 0x07, 0x41, 0x00, 0x03, 0x0b, 0x24, 0x08, 0xea, 0x4f, 0xff, 0x23, 0x9b, 0x14, 0x35, 0xdb, + 0x97, 0x2c, 0xe0, 0x17, 0x89, 0xfd, 0x55, 0x7d, 0x5f, 0x57, 0x7d, 0x55, 0xf5, 0xd5, 0xf7, 0xab, + 0xfa, 0xaa, 0x1a, 0x16, 0x6c, 0x4b, 0xd5, 0x0e, 0xbb, 0xfb, 0x6b, 0x6a, 0xd7, 0x28, 0x75, 0x6d, + 0xcb, 0xb5, 0xd0, 0x82, 0x66, 0x69, 0x47, 0x94, 0x5c, 0xe2, 0x89, 0xcb, 0xf7, 0x8e, 0x8e, 0xd7, + 0x8e, 0x8e, 0x1d, 0x6c, 0x1f, 0x63, 0x7b, 0x4d, 0xb3, 0x4c, 0xad, 0x67, 0xdb, 0xd8, 0xd4, 0xfa, + 0x6b, 0x6d, 0x4b, 0x3b, 0xa2, 0x7f, 0x0c, 0xb3, 0xc5, 0xd8, 0xa3, 0x79, 0x6d, 0xac, 0xea, 0x4e, + 0xaf, 0xd3, 0x51, 0xed, 0xfe, 0x9a, 0xed, 0x74, 0xf7, 0xd7, 0xf8, 0x03, 0xcf, 0x8b, 0xbc, 0xb7, + 0xeb, 0xaa, 0xab, 0x72, 0xda, 0x05, 0x8f, 0x86, 0x6d, 0xdb, 0xb2, 0x1d, 0x4e, 0xbd, 0xe4, 0x51, + 0x3b, 0xd8, 0x55, 0x43, 0xb9, 0xaf, 0x3a, 0xae, 0x65, 0xab, 0x2d, 0xbc, 0x86, 0xcd, 0x96, 0x61, + 0x62, 0x92, 0xe1, 0x58, 0xd3, 0x78, 0xe2, 0x5b, 0xb1, 0x89, 0x0f, 0x79, 0xea, 0x52, 0xcf, 0x35, + 0xda, 0x6b, 0x87, 0x6d, 0x6d, 0xcd, 0x35, 0x3a, 0xd8, 0x71, 0xd5, 0x4e, 0xd7, 0xab, 0x02, 0x4d, + 0x71, 0x6d, 0x55, 0x33, 0xcc, 0x96, 0xf7, 0xbf, 0xbb, 0xbf, 0x66, 0x63, 0xcd, 0xb2, 0x75, 0xac, + 0x2b, 0x4e, 0x57, 0x35, 0xbd, 0xe2, 0xb6, 0xac, 0x96, 0x45, 0x7f, 0xae, 0x91, 0x5f, 0x9c, 0xba, + 0xd2, 0xb2, 0xac, 0x56, 0x1b, 0xaf, 0xd1, 0xa7, 0xfd, 0xde, 0xc1, 0x9a, 0xde, 0xb3, 0x55, 0xd7, + 0xb0, 0x3c, 0xae, 0xd5, 0xc1, 0xf4, 0x81, 0x22, 0x48, 0xff, 0x54, 0x80, 0x79, 0x19, 0xbf, 0xec, + 0x61, 0xc7, 0xad, 0x61, 0x55, 0xc7, 0x36, 0xba, 0x02, 0xe9, 0x23, 0xdc, 0x5f, 0x4a, 0x5f, 0x13, + 0xee, 0xcc, 0x95, 0x67, 0xbf, 0x3c, 0x5d, 0x4d, 0x6f, 0xe1, 0xbe, 0x4c, 0x68, 0xe8, 0x1a, 0xcc, + 0x62, 0x53, 0x57, 0x48, 0x72, 0x26, 0x9a, 0x3c, 0x83, 0x4d, 0x7d, 0x0b, 0xf7, 0xd1, 0xb7, 0x21, + 0xeb, 0x10, 0x69, 0xa6, 0x86, 0x97, 0xa6, 0xaf, 0x09, 0x77, 0xa6, 0xcb, 0xbf, 0xf2, 0xe5, 0xe9, + 0xea, 0xc7, 0x2d, 0xc3, 0x3d, 0xec, 0xed, 0x97, 0x34, 0xab, 0xb3, 0xe6, 0x37, 0xba, 0xbe, 0x1f, + 0xfc, 0x5e, 0xeb, 0x1e, 0xb5, 0xd6, 0x06, 0x95, 0x58, 0x6a, 0x9e, 0x98, 0x0d, 0xfc, 0x52, 0xf6, + 0x25, 0x6e, 0x66, 0xb2, 0x82, 0x98, 0xda, 0xcc, 0x64, 0x53, 0x62, 0x5a, 0xfa, 0x49, 0x0a, 0x0a, + 0x32, 0x76, 0xba, 0x96, 0xe9, 0x60, 0x5e, 0xf2, 0xf7, 0x20, 0xed, 0x9e, 0x98, 0xb4, 0xe4, 0xf9, + 0x07, 0x2b, 0xa5, 0xa1, 0xee, 0x55, 0x6a, 0xda, 0xaa, 0xe9, 0xa8, 0x1a, 0xd1, 0x8f, 0x4c, 0xb2, + 0xa2, 0x0f, 0x20, 0x6f, 0x63, 0xa7, 0xd7, 0xc1, 0x54, 0xd3, 0xb4, 0x52, 0xf9, 0x07, 0x97, 0x63, + 0x38, 0x1b, 0x5d, 0xd5, 0x94, 0x81, 0xe5, 0x25, 0xbf, 0x51, 0x03, 0xe6, 0x39, 0xa7, 0x8d, 0x55, + 0xc7, 0x32, 0x97, 0x66, 0xaf, 0x09, 0x77, 0x0a, 0x0f, 0x4a, 0x31, 0xbc, 0xd1, 0x52, 0x92, 0xc7, + 0x5e, 0x07, 0xcb, 0x94, 0x4b, 0x9e, 0xb3, 0x43, 0x4f, 0xe8, 0x0a, 0x64, 0xcd, 0x5e, 0x87, 0xe8, + 0xd7, 0xa1, 0xda, 0x4b, 0xcb, 0xb3, 0x66, 0xaf, 0xb3, 0x85, 0xfb, 0x0e, 0xba, 0x0a, 0x39, 0x92, + 0xb4, 0xdf, 0x77, 0xb1, 0xb3, 0x94, 0xa5, 0x69, 0x24, 0x6f, 0x99, 0x3c, 0x4b, 0x9f, 0xc0, 0x5c, + 0x58, 0x2a, 0x42, 0x50, 0x90, 0xab, 0x8d, 0xbd, 0xed, 0xaa, 0xb2, 0xb7, 0xb3, 0xb5, 0xf3, 0xf4, + 0xc5, 0x8e, 0x38, 0x85, 0x2e, 0x80, 0xc8, 0x69, 0x5b, 0xd5, 0x4f, 0x95, 0x27, 0xf5, 0xed, 0x7a, + 0x53, 0x14, 0x96, 0x33, 0xdf, 0xfb, 0x9d, 0x95, 0xa9, 0xcd, 0x4c, 0x76, 0x46, 0x9c, 0x95, 0x7e, + 0x47, 0x00, 0x78, 0x8c, 0x5d, 0xde, 0x1b, 0x50, 0x19, 0x66, 0x0e, 0x69, 0x89, 0x97, 0x04, 0xaa, + 0x96, 0x6b, 0xb1, 0x55, 0x0b, 0xf5, 0x9c, 0x72, 0xf6, 0x47, 0xa7, 0xab, 0x53, 0x3f, 0x3d, 0x5d, + 0x15, 0x64, 0xce, 0x89, 0x9e, 0x41, 0xfe, 0x08, 0xf7, 0x15, 0x3e, 0x70, 0x97, 0x52, 0x54, 0x47, + 0xef, 0x85, 0x04, 0x1d, 0x1d, 0x97, 0xbc, 0x31, 0x5c, 0x0a, 0x8d, 0xf7, 0x12, 0xe1, 0x28, 0x35, + 0x5c, 0x1b, 0x9b, 0x2d, 0xf7, 0x50, 0x86, 0x23, 0xdc, 0x7f, 0xc2, 0x64, 0x48, 0xbf, 0x2f, 0x40, + 0x9e, 0x96, 0x92, 0x29, 0x15, 0x55, 0x06, 0x8a, 0x79, 0xfd, 0xcc, 0x16, 0x88, 0x29, 0x67, 0x09, + 0xa6, 0x8f, 0xd5, 0x76, 0x0f, 0xd3, 0x12, 0xe6, 0x1f, 0x2c, 0xc5, 0xc8, 0x78, 0x4e, 0xd2, 0x65, + 0x96, 0x0d, 0x7d, 0x04, 0x73, 0x86, 0xe9, 0x62, 0xd3, 0x55, 0x18, 0x5b, 0xfa, 0x0c, 0xb6, 0x3c, + 0xcb, 0x4d, 0x1f, 0xa4, 0x7f, 0x22, 0x00, 0xec, 0xf6, 0x12, 0xd5, 0xf3, 0x37, 0x27, 0x2c, 0x7f, + 0x39, 0x43, 0x58, 0xbd, 0x5a, 0x5c, 0x82, 0x19, 0xc3, 0x6c, 0x1b, 0x26, 0x2b, 0x7f, 0x56, 0xe6, + 0x4f, 0xe8, 0x02, 0x4c, 0xef, 0xb7, 0x0d, 0x53, 0xa7, 0xe3, 0x21, 0x2b, 0xb3, 0x07, 0x49, 0x86, + 0x3c, 0x2d, 0x75, 0x82, 0x7a, 0x97, 0x4e, 0x53, 0x70, 0xb1, 0x62, 0x99, 0xba, 0x41, 0x86, 0xa4, + 0xda, 0xfe, 0x5a, 0x68, 0x65, 0x13, 0x2e, 0xe8, 0xb8, 0x6b, 0x63, 0x4d, 0x75, 0xb1, 0xae, 0xe0, + 0x93, 0xee, 0x84, 0x6d, 0x8c, 0x02, 0xae, 0xea, 0x49, 0x97, 0xd2, 0xc8, 0xa8, 0x25, 0x02, 0xd8, + 0xa8, 0x9d, 0x21, 0x26, 0x53, 0xce, 0xe2, 0x93, 0x2e, 0x1d, 0xb5, 0xf1, 0x6a, 0x46, 0xdf, 0x84, + 0xcb, 0x6a, 0xbb, 0x6d, 0xbd, 0x52, 0x8c, 0x03, 0x45, 0xb7, 0xb0, 0xa3, 0x98, 0x96, 0xab, 0xe0, + 0x13, 0xc3, 0x71, 0xa9, 0x49, 0xc8, 0xca, 0x8b, 0x34, 0xb9, 0x7e, 0xb0, 0x61, 0x61, 0x67, 0xc7, + 0x72, 0xab, 0x24, 0x29, 0xd4, 0x94, 0xb3, 0xe1, 0xa6, 0x94, 0x7e, 0x0d, 0x2e, 0x0d, 0xea, 0x37, + 0xc9, 0xf6, 0xfb, 0xb1, 0x00, 0x85, 0xba, 0x69, 0xb8, 0x5f, 0x8b, 0x86, 0xf3, 0xf5, 0x99, 0x0e, + 0xeb, 0xf3, 0x1e, 0x88, 0x07, 0xaa, 0xd1, 0x7e, 0x6a, 0x36, 0xad, 0xce, 0xbe, 0xe3, 0x5a, 0x26, + 0x76, 0xb8, 0xc2, 0x87, 0xe8, 0xd2, 0x73, 0x28, 0xfa, 0xb5, 0x49, 0x52, 0x4d, 0x2e, 0x88, 0x75, + 0x53, 0xb3, 0x71, 0x07, 0x9b, 0x89, 0xea, 0xe9, 0x2d, 0xc8, 0x19, 0x9e, 0x5c, 0xaa, 0xab, 0xb4, + 0x1c, 0x10, 0xa4, 0x1e, 0x2c, 0x84, 0xde, 0x9a, 0xa4, 0xb9, 0x24, 0x93, 0x11, 0x7e, 0xa5, 0x04, + 0x6d, 0x44, 0x26, 0x23, 0xfc, 0x8a, 0x99, 0xb7, 0x06, 0xcc, 0x6f, 0xe0, 0x36, 0x76, 0x71, 0x82, + 0x35, 0x95, 0xf6, 0xa0, 0xe0, 0x09, 0x4d, 0xb2, 0x61, 0x7e, 0x53, 0x00, 0xc4, 0xe5, 0xaa, 0x66, + 0x2b, 0xc9, 0x12, 0xa3, 0x55, 0xe2, 0x5a, 0xb8, 0x3d, 0xdb, 0x64, 0xd3, 0x39, 0xeb, 0x93, 0xc0, + 0x48, 0x74, 0x46, 0x0f, 0x86, 0x6c, 0x26, 0x3c, 0x64, 0xb9, 0x7b, 0xf3, 0x0a, 0x16, 0x23, 0x05, + 0x4b, 0xb6, 0xf9, 0x32, 0xb4, 0x4c, 0xa9, 0x6b, 0xe9, 0xb0, 0x0f, 0x47, 0x89, 0xd2, 0x17, 0x02, + 0x2c, 0x54, 0xda, 0x58, 0xb5, 0x13, 0xd7, 0xc8, 0x2f, 0x43, 0x56, 0xc7, 0xaa, 0x4e, 0xab, 0xcc, + 0x06, 0xf6, 0xdb, 0x21, 0x29, 0xc4, 0x15, 0x2e, 0x1d, 0xb6, 0xb5, 0x52, 0xd3, 0xf3, 0x50, 0xf9, + 0xe8, 0xf6, 0x99, 0xa4, 0x4f, 0x01, 0x85, 0x4b, 0x96, 0x64, 0x47, 0xf8, 0xdd, 0x14, 0x20, 0x19, + 0x1f, 0x63, 0xdb, 0x4d, 0xbc, 0xda, 0x1b, 0x90, 0x77, 0x55, 0xbb, 0x85, 0x5d, 0x85, 0xf8, 0xde, + 0xe7, 0xa9, 0x39, 0x30, 0x3e, 0x42, 0x46, 0x4d, 0xb8, 0x8d, 0x4d, 0x75, 0xbf, 0x8d, 0xa9, 0x14, + 0x65, 0xdf, 0xea, 0x99, 0xba, 0x62, 0xb8, 0xd8, 0x56, 0x5d, 0xcb, 0x56, 0xac, 0xae, 0x6b, 0x74, + 0x8c, 0xcf, 0xa9, 0xe7, 0xcf, 0xbb, 0xda, 0x0d, 0x96, 0x9d, 0x30, 0x97, 0x49, 0xe6, 0x3a, 0xcf, + 0xfb, 0x34, 0x94, 0x15, 0x95, 0x60, 0xd1, 0x68, 0x99, 0x96, 0x8d, 0x95, 0x96, 0xa6, 0xb8, 0x87, + 0x36, 0x76, 0x0e, 0xad, 0xb6, 0x37, 0x21, 0x2d, 0xb0, 0xa4, 0xc7, 0x5a, 0xd3, 0x4b, 0x90, 0x3e, + 0x83, 0xc5, 0x88, 0x96, 0x92, 0x6c, 0x82, 0xff, 0x21, 0x40, 0xbe, 0xa1, 0xa9, 0x66, 0x92, 0xba, + 0xff, 0x04, 0xf2, 0x8e, 0xa6, 0x9a, 0xca, 0x81, 0x65, 0x77, 0x54, 0x97, 0xd6, 0xab, 0x10, 0xd1, + 0xbd, 0xef, 0xdf, 0x6b, 0xaa, 0xf9, 0x88, 0x66, 0x92, 0xc1, 0xf1, 0x7f, 0x0f, 0xfa, 0xaf, 0xd3, + 0x5f, 0xdd, 0x7f, 0x65, 0xc3, 0x7b, 0x33, 0x93, 0x4d, 0x8b, 0x19, 0xe9, 0xcf, 0x04, 0x98, 0x63, + 0x55, 0x4e, 0x72, 0x78, 0x7f, 0x0b, 0x32, 0xb6, 0xf5, 0x8a, 0x0d, 0xef, 0xfc, 0x83, 0xab, 0x31, + 0x22, 0xb6, 0x70, 0x3f, 0x3c, 0x7f, 0xd2, 0xec, 0xa8, 0x0c, 0xdc, 0x4b, 0x55, 0x28, 0x77, 0x7a, + 0x52, 0x6e, 0x60, 0x5c, 0x32, 0x91, 0x71, 0x1b, 0x8a, 0xfb, 0xaa, 0xab, 0x1d, 0x2a, 0x36, 0x2f, + 0x24, 0x99, 0x6b, 0xd3, 0x77, 0xe6, 0xe4, 0x02, 0x25, 0x7b, 0x45, 0x77, 0x48, 0xcd, 0xd9, 0x78, + 0x73, 0xf0, 0x9f, 0xb3, 0x36, 0xff, 0x3f, 0x02, 0x1f, 0x43, 0x5e, 0xcd, 0xff, 0xbc, 0x35, 0xfd, + 0x0f, 0x52, 0x70, 0xb9, 0x72, 0x88, 0xb5, 0xa3, 0x8a, 0x65, 0x3a, 0x86, 0xe3, 0x12, 0xdd, 0x25, + 0xd9, 0xfe, 0x57, 0x21, 0xf7, 0xca, 0x70, 0x0f, 0x15, 0xdd, 0x38, 0x38, 0xa0, 0xd6, 0x36, 0x2b, + 0x67, 0x09, 0x61, 0xc3, 0x38, 0x38, 0x40, 0x0f, 0x21, 0xd3, 0xb1, 0x74, 0xe6, 0xcc, 0x17, 0x1e, + 0xac, 0xc6, 0x88, 0xa7, 0x45, 0x73, 0x7a, 0x9d, 0x6d, 0x4b, 0xc7, 0x32, 0xcd, 0x8c, 0x56, 0x00, + 0x34, 0x42, 0xed, 0x5a, 0x86, 0xe9, 0x72, 0xe3, 0x18, 0xa2, 0xa0, 0x1a, 0xe4, 0x5c, 0x6c, 0x77, + 0x0c, 0x53, 0x75, 0xf1, 0xd2, 0x34, 0x55, 0xde, 0x3b, 0xb1, 0x05, 0xef, 0xb6, 0x0d, 0x4d, 0xdd, + 0xc0, 0x8e, 0x66, 0x1b, 0x5d, 0xd7, 0xb2, 0xb9, 0x16, 0x03, 0x66, 0xe9, 0x6f, 0x64, 0x60, 0x69, + 0x58, 0x37, 0x49, 0xf6, 0x90, 0x5d, 0x98, 0xb1, 0xb1, 0xd3, 0x6b, 0xbb, 0xbc, 0x8f, 0x3c, 0x18, + 0xa5, 0x82, 0x98, 0x12, 0xd0, 0xa5, 0x8b, 0xb6, 0xcb, 0x8b, 0xcd, 0xe5, 0x2c, 0xff, 0x4b, 0x01, + 0x66, 0x58, 0x02, 0xba, 0x0f, 0x59, 0x9b, 0x4c, 0x0c, 0x8a, 0xa1, 0xd3, 0x32, 0xa6, 0xcb, 0x97, + 0x5e, 0x9f, 0xae, 0xce, 0xd2, 0xc9, 0xa2, 0xbe, 0xf1, 0x65, 0xf0, 0x53, 0x9e, 0xa5, 0xf9, 0xea, + 0x3a, 0x69, 0x2d, 0xc7, 0x55, 0x6d, 0x97, 0x2e, 0x2a, 0xa5, 0x18, 0x42, 0xa2, 0x84, 0x2d, 0xdc, + 0x47, 0x9b, 0x30, 0xe3, 0xb8, 0xaa, 0xdb, 0x73, 0x78, 0x7b, 0x9d, 0xab, 0xb0, 0x0d, 0xca, 0x29, + 0x73, 0x09, 0xc4, 0xdd, 0xd2, 0xb1, 0xab, 0x1a, 0x6d, 0xda, 0x80, 0x39, 0x99, 0x3f, 0x49, 0xbf, + 0x25, 0xc0, 0x0c, 0xcb, 0x8a, 0x2e, 0xc3, 0xa2, 0xbc, 0xbe, 0xf3, 0xb8, 0xaa, 0xd4, 0x77, 0x36, + 0xaa, 0xcd, 0xaa, 0xbc, 0x5d, 0xdf, 0x59, 0x6f, 0x56, 0xc5, 0x29, 0x74, 0x09, 0x90, 0x97, 0x50, + 0x79, 0xba, 0xd3, 0xa8, 0x37, 0x9a, 0xd5, 0x9d, 0xa6, 0x28, 0xd0, 0x35, 0x15, 0x4a, 0x0f, 0x51, + 0x53, 0xe8, 0x1d, 0xb8, 0x36, 0x48, 0x55, 0x1a, 0xcd, 0xf5, 0x66, 0x43, 0xa9, 0x36, 0x9a, 0xf5, + 0xed, 0xf5, 0x66, 0x75, 0x43, 0x4c, 0x8f, 0xc9, 0x45, 0x5e, 0x22, 0xcb, 0xd5, 0x4a, 0x53, 0xcc, + 0x48, 0x2e, 0x5c, 0x94, 0xb1, 0x66, 0x75, 0xba, 0x3d, 0x17, 0x93, 0x52, 0x3a, 0x49, 0x8e, 0x94, + 0xcb, 0x30, 0xab, 0xdb, 0x7d, 0xc5, 0xee, 0x99, 0x7c, 0x9c, 0xcc, 0xe8, 0x76, 0x5f, 0xee, 0x99, + 0xd2, 0x3f, 0x12, 0xe0, 0xd2, 0xe0, 0x6b, 0x93, 0xec, 0x84, 0xcf, 0x20, 0xaf, 0xea, 0x3a, 0xd6, + 0x15, 0x1d, 0xb7, 0x5d, 0x95, 0xbb, 0x44, 0xf7, 0x42, 0x92, 0xf8, 0x52, 0x60, 0xc9, 0x5f, 0x0a, + 0xdc, 0x7e, 0x5e, 0xa9, 0xd0, 0x82, 0x6c, 0x10, 0x0e, 0xcf, 0xfc, 0x50, 0x21, 0x94, 0x22, 0xfd, + 0x20, 0x03, 0xf3, 0x55, 0x53, 0x6f, 0x9e, 0x24, 0x3a, 0x97, 0x5c, 0x82, 0x19, 0xcd, 0xea, 0x74, + 0x0c, 0xd7, 0x53, 0x10, 0x7b, 0x42, 0xbf, 0x18, 0x72, 0x65, 0xd3, 0x13, 0x38, 0x74, 0x81, 0x13, + 0x8b, 0x7e, 0x1d, 0x2e, 0x13, 0xab, 0x69, 0x9b, 0x6a, 0x5b, 0x61, 0xd2, 0x14, 0xd7, 0x36, 0x5a, + 0x2d, 0x6c, 0xf3, 0xe5, 0xc7, 0x3b, 0x31, 0xe5, 0xac, 0x73, 0x8e, 0x0a, 0x65, 0x68, 0xb2, 0xfc, + 0xf2, 0x45, 0x23, 0x8e, 0x8c, 0x3e, 0x06, 0x20, 0x53, 0x11, 0x5d, 0xd2, 0x74, 0xb8, 0x3d, 0x1a, + 0xb5, 0xa6, 0xe9, 0x99, 0x20, 0xc2, 0x40, 0x9e, 0x1d, 0xf4, 0x0c, 0x44, 0xc3, 0x54, 0x0e, 0xda, + 0x46, 0xeb, 0xd0, 0x55, 0x5e, 0xd9, 0x86, 0x8b, 0x9d, 0xa5, 0x05, 0x2a, 0x23, 0xae, 0xa9, 0x1b, + 0x7c, 0x69, 0x56, 0x7f, 0x41, 0x72, 0x72, 0x69, 0x05, 0xc3, 0x7c, 0x44, 0xf9, 0x29, 0xd1, 0x41, + 0x6b, 0x04, 0x0a, 0xbd, 0xec, 0x19, 0x36, 0x56, 0xee, 0x77, 0x35, 0xba, 0x0e, 0x92, 0x2d, 0x17, + 0x5e, 0x9f, 0xae, 0x82, 0xcc, 0xc8, 0xf7, 0x77, 0x2b, 0x04, 0x1a, 0xb1, 0xdf, 0x5d, 0x8d, 0xa8, + 0xbd, 0x6b, 0x19, 0x8e, 0x65, 0x2e, 0xe5, 0x98, 0xda, 0xd9, 0x13, 0xba, 0x0b, 0xa2, 0x7b, 0x62, + 0x2a, 0x87, 0x58, 0xb5, 0xdd, 0x7d, 0xac, 0xba, 0x64, 0x7e, 0x06, 0x9a, 0xa3, 0xe8, 0x9e, 0x98, + 0xb5, 0x10, 0x79, 0x33, 0x93, 0x9d, 0x15, 0xb3, 0x9b, 0x99, 0x6c, 0x56, 0xcc, 0x49, 0xff, 0x49, + 0x80, 0x82, 0xd7, 0x37, 0x92, 0xec, 0xc6, 0x77, 0x40, 0xb4, 0x4c, 0xac, 0x74, 0x0f, 0x55, 0x07, + 0xf3, 0xb6, 0xe4, 0xb3, 0x43, 0xc1, 0x32, 0xf1, 0x2e, 0x21, 0xb3, 0x96, 0x41, 0xbb, 0xb0, 0xe0, + 0xb8, 0x6a, 0xcb, 0x30, 0x5b, 0x8a, 0xbf, 0x00, 0x4f, 0x3d, 0x8b, 0x09, 0x91, 0x80, 0xc8, 0xb9, + 0x7d, 0x7a, 0xc4, 0xa5, 0xf8, 0x03, 0x01, 0x16, 0xd6, 0xf5, 0x8e, 0x61, 0x36, 0xba, 0x6d, 0x23, + 0xd1, 0x05, 0x86, 0x77, 0x20, 0xe7, 0x10, 0x99, 0x81, 0x75, 0x0e, 0xe0, 0x62, 0x96, 0xa6, 0x10, + 0x33, 0xfd, 0x04, 0x8a, 0xf8, 0xa4, 0x6b, 0xb0, 0x8d, 0x07, 0x86, 0x72, 0x32, 0x93, 0xd7, 0xad, + 0x10, 0xf0, 0x92, 0x24, 0x5e, 0xa7, 0x4f, 0x01, 0x85, 0xab, 0x94, 0x24, 0xd0, 0xf8, 0x14, 0x16, + 0xa9, 0xe8, 0x3d, 0xd3, 0x49, 0x58, 0x5f, 0xd2, 0xaf, 0xc2, 0x85, 0xa8, 0xe8, 0x24, 0xcb, 0xfd, + 0x82, 0xb7, 0xf2, 0x36, 0xb6, 0x13, 0x45, 0xa8, 0xbe, 0xae, 0xb9, 0xe0, 0x24, 0xcb, 0xfc, 0x5d, + 0x01, 0xae, 0x50, 0xd9, 0x74, 0xeb, 0xe5, 0x00, 0xdb, 0x4f, 0xb0, 0xea, 0x24, 0x0a, 0xaf, 0x6f, + 0xc0, 0x0c, 0x83, 0xc9, 0xb4, 0x7f, 0x4e, 0x97, 0xf3, 0xc4, 0xcd, 0x68, 0xb8, 0x96, 0x4d, 0xdc, + 0x0c, 0x9e, 0x24, 0xa9, 0xb0, 0x1c, 0x57, 0x8a, 0x24, 0x6b, 0xfa, 0x77, 0x04, 0x58, 0xe0, 0x1e, + 0x1e, 0xe9, 0xca, 0x95, 0x43, 0xe2, 0xe0, 0xa0, 0x2a, 0xe4, 0x35, 0xfa, 0x4b, 0x71, 0xfb, 0x5d, + 0x4c, 0xe5, 0x17, 0xc6, 0x39, 0x87, 0x8c, 0xad, 0xd9, 0xef, 0x62, 0xe2, 0x61, 0x7a, 0xbf, 0x89, + 0xa2, 0x42, 0x95, 0x1c, 0xeb, 0x5e, 0xd2, 0x71, 0x44, 0xf3, 0x7a, 0x7e, 0x1a, 0xd7, 0xc1, 0xef, + 0xa5, 0xb9, 0x12, 0xd8, 0x3b, 0x78, 0xf6, 0x44, 0x1d, 0x8a, 0xcf, 0xe0, 0x52, 0x68, 0xe9, 0x3c, + 0x5c, 0xf1, 0xd4, 0x39, 0x2a, 0x1e, 0x5a, 0x7e, 0x0f, 0xa8, 0xe8, 0x53, 0x08, 0x2d, 0xb0, 0x2b, + 0xac, 0x4e, 0x1e, 0x54, 0x39, 0x8f, 0x3a, 0x16, 0x02, 0x29, 0x8c, 0xee, 0xa0, 0x0a, 0x64, 0xf1, + 0x49, 0x57, 0xd1, 0xb1, 0xa3, 0x71, 0xc3, 0x25, 0xc5, 0x09, 0x24, 0x45, 0x19, 0x72, 0xde, 0x67, + 0xf1, 0x49, 0x97, 0x10, 0xd1, 0x1e, 0x99, 0x37, 0xbd, 0x79, 0x9d, 0x16, 0xdb, 0x39, 0x1b, 0x0b, + 0x04, 0x3d, 0x85, 0x8b, 0x2b, 0xfa, 0x53, 0x3a, 0x13, 0x21, 0xfd, 0x50, 0x80, 0xab, 0xb1, 0xad, + 0x96, 0xe4, 0x44, 0xf6, 0x31, 0x64, 0x68, 0xe5, 0x53, 0xe7, 0xac, 0x3c, 0xe5, 0x92, 0xbe, 0x97, + 0xe2, 0x63, 0x5c, 0xc6, 0x6d, 0x8b, 0x28, 0x36, 0xf1, 0x25, 0xb4, 0xa7, 0x30, 0x7f, 0x6c, 0xb9, + 0xd8, 0xf6, 0x9b, 0x3d, 0x75, 0xee, 0x66, 0x9f, 0xa3, 0x02, 0xbc, 0x16, 0x7f, 0x0e, 0x0b, 0xa6, + 0x65, 0x2a, 0x51, 0xa1, 0xe7, 0xef, 0x4b, 0x45, 0xd3, 0x32, 0x9f, 0x87, 0xe4, 0xfa, 0x76, 0x66, + 0x40, 0x13, 0x49, 0xda, 0x99, 0xef, 0x0b, 0xb0, 0xe8, 0x7b, 0x3a, 0x09, 0xbb, 0xbb, 0xdf, 0x82, + 0xb4, 0x69, 0xbd, 0x3a, 0xcf, 0x12, 0x25, 0xc9, 0x4f, 0x66, 0xbd, 0x68, 0x89, 0x92, 0xac, 0xef, + 0xbf, 0x4a, 0x41, 0xee, 0x71, 0x25, 0xc9, 0x5a, 0x7e, 0xcc, 0x97, 0xbf, 0x59, 0x7b, 0xc7, 0xf5, + 0x76, 0xff, 0x7d, 0xa5, 0xc7, 0x95, 0x2d, 0xdc, 0xf7, 0x7a, 0x3b, 0xe1, 0x42, 0xeb, 0x90, 0x8b, + 0x2e, 0x94, 0x4e, 0xa8, 0xa9, 0x80, 0x6b, 0x19, 0xc3, 0x34, 0x95, 0xeb, 0x85, 0x5a, 0x08, 0x31, + 0xa1, 0x16, 0xe4, 0x35, 0xbe, 0xa7, 0x98, 0x3a, 0xcf, 0x6b, 0x42, 0x2e, 0xe2, 0xb4, 0x38, 0x23, + 0x3d, 0x03, 0x20, 0xd5, 0x49, 0xb2, 0x49, 0x7e, 0x23, 0x0d, 0x85, 0xdd, 0x9e, 0x73, 0x98, 0x70, + 0xef, 0xab, 0x00, 0x74, 0x7b, 0xce, 0x21, 0x19, 0x91, 0x27, 0x26, 0xaf, 0xf3, 0x19, 0x51, 0x1c, + 0x5e, 0xa5, 0x19, 0x5f, 0xf3, 0xc4, 0x44, 0x35, 0x2e, 0x04, 0x2b, 0x41, 0x28, 0xc8, 0x8d, 0x71, + 0xc8, 0xb2, 0x79, 0x62, 0x6e, 0x63, 0x1f, 0x52, 0x32, 0x49, 0x98, 0x48, 0xfa, 0x18, 0x66, 0xc9, + 0x83, 0xe2, 0x5a, 0xe7, 0x69, 0xe6, 0x19, 0xc2, 0xd3, 0xb4, 0xd0, 0x47, 0x90, 0x63, 0xdc, 0x64, + 0xf6, 0x9b, 0xa1, 0xb3, 0x5f, 0x5c, 0x5d, 0xb8, 0x1a, 0xe9, 0xbc, 0x97, 0xa5, 0xac, 0x64, 0xae, + 0xbb, 0x00, 0xd3, 0x07, 0x96, 0xad, 0x79, 0x9b, 0xb9, 0xec, 0x81, 0xb5, 0x27, 0x83, 0x34, 0x9b, + 0x99, 0x6c, 0x4e, 0x04, 0xe9, 0xb7, 0x04, 0x28, 0xfa, 0x0d, 0x91, 0xe4, 0x84, 0x50, 0x89, 0x68, + 0xf1, 0xfc, 0x4d, 0x41, 0x14, 0x28, 0xfd, 0x5b, 0xea, 0x11, 0x69, 0xd6, 0x31, 0x6d, 0x99, 0x24, + 0x7b, 0xca, 0x47, 0x2c, 0xd0, 0x27, 0x75, 0xde, 0xd6, 0xa5, 0x31, 0x3f, 0xf7, 0xe1, 0x82, 0xd1, + 0x21, 0xf6, 0xdc, 0x70, 0xdb, 0x7d, 0x0e, 0xdb, 0x5c, 0xec, 0xed, 0x1a, 0x2f, 0x06, 0x69, 0x15, + 0x2f, 0x49, 0xfa, 0x5d, 0xba, 0x5a, 0x1d, 0xd4, 0x24, 0x49, 0x55, 0xd7, 0x61, 0xde, 0x66, 0xa2, + 0x89, 0x5b, 0x73, 0x4e, 0x6d, 0xcf, 0xf9, 0xac, 0x44, 0xe1, 0xbf, 0x9d, 0x82, 0xe2, 0xb3, 0x1e, + 0xb6, 0xfb, 0x5f, 0x27, 0x75, 0xdf, 0x82, 0xe2, 0x2b, 0xd5, 0x70, 0x95, 0x03, 0xcb, 0x56, 0x7a, + 0x5d, 0x5d, 0x75, 0xbd, 0x68, 0x93, 0x79, 0x42, 0x7e, 0x64, 0xd9, 0x7b, 0x94, 0x88, 0x30, 0xa0, + 0x23, 0xd3, 0x7a, 0x65, 0x2a, 0x84, 0x4c, 0x81, 0xf2, 0x89, 0xc9, 0x97, 0x90, 0xcb, 0xef, 0xff, + 0xc7, 0xd3, 0xd5, 0x87, 0x13, 0xc5, 0x90, 0xd1, 0x80, 0xba, 0x5e, 0xcf, 0xd0, 0x4b, 0x7b, 0x7b, + 0xf5, 0x0d, 0x59, 0xa4, 0x22, 0x5f, 0x30, 0x89, 0xcd, 0x13, 0xd3, 0x91, 0xfe, 0x5e, 0x0a, 0xc4, + 0x40, 0x47, 0x49, 0x36, 0x64, 0x15, 0xf2, 0x2f, 0x7b, 0xd8, 0x36, 0xde, 0xa0, 0x19, 0x81, 0x33, + 0x12, 0xb3, 0x73, 0x0f, 0x16, 0xdc, 0x13, 0x53, 0x61, 0x21, 0x80, 0x2c, 0xf0, 0xc3, 0x0b, 0x58, + 0x28, 0xba, 0xa4, 0xcc, 0x84, 0x4e, 0x83, 0x3e, 0x1c, 0xf4, 0x19, 0xcc, 0x45, 0xb4, 0x95, 0xfe, + 0x6a, 0xda, 0xca, 0xbf, 0x0a, 0x29, 0xea, 0xf7, 0x05, 0x40, 0x54, 0x51, 0x75, 0xb6, 0xc6, 0xff, + 0x75, 0xe9, 0x4f, 0x77, 0x40, 0xa4, 0x01, 0x9b, 0x8a, 0x71, 0xa0, 0x74, 0x0c, 0xc7, 0x31, 0xcc, + 0x16, 0xef, 0x50, 0x05, 0x4a, 0xaf, 0x1f, 0x6c, 0x33, 0xaa, 0xf4, 0x97, 0x61, 0x31, 0x52, 0x81, + 0x24, 0x1b, 0xfb, 0x3a, 0xcc, 0x1d, 0xb0, 0x2d, 0x58, 0x2a, 0x9c, 0x2f, 0x0f, 0xe6, 0x29, 0x8d, + 0xbd, 0x4f, 0xfa, 0x93, 0x14, 0x5c, 0x90, 0xb1, 0x63, 0xb5, 0x8f, 0x71, 0xf2, 0x2a, 0xac, 0x01, + 0xdf, 0x7b, 0x51, 0xde, 0x48, 0x93, 0x39, 0xc6, 0xcc, 0xa6, 0xb9, 0xe8, 0x1a, 0xfb, 0x3b, 0xe3, + 0x7b, 0xec, 0xf0, 0xaa, 0x3a, 0x5f, 0xa9, 0xcb, 0x44, 0x56, 0xea, 0x2c, 0x28, 0xb2, 0xdd, 0x63, + 0x5d, 0x71, 0xf0, 0x4b, 0xb3, 0xd7, 0xf1, 0xc0, 0x50, 0x69, 0x5c, 0x21, 0xeb, 0x8c, 0xa5, 0x81, + 0x5f, 0xee, 0xf4, 0x3a, 0xd4, 0x77, 0x2e, 0x5f, 0x22, 0xe5, 0x7d, 0x7d, 0xba, 0x5a, 0x88, 0xa4, + 0x39, 0x72, 0xc1, 0xf0, 0x9f, 0x89, 0x74, 0xe9, 0xdb, 0x70, 0x71, 0x40, 0xd9, 0x49, 0x7a, 0x3c, + 0xff, 0x22, 0x0d, 0x57, 0xa2, 0xe2, 0x93, 0x86, 0x38, 0x5f, 0xf7, 0x06, 0xad, 0xc1, 0x7c, 0xc7, + 0x30, 0xdf, 0x6c, 0xf5, 0x72, 0xae, 0x63, 0x98, 0x3e, 0x2d, 0xae, 0x6b, 0xcc, 0xfc, 0x5c, 0xbb, + 0x86, 0x0a, 0xcb, 0x71, 0x6d, 0x97, 0x64, 0xff, 0xf8, 0x9e, 0x00, 0x73, 0x49, 0x2f, 0xcb, 0xbd, + 0x59, 0x14, 0x9c, 0xd4, 0x84, 0xf9, 0x9f, 0xc3, 0x3a, 0xde, 0x6f, 0x0b, 0x80, 0x9a, 0x76, 0xcf, + 0x24, 0xa0, 0xf6, 0x89, 0xd5, 0x4a, 0xb2, 0x9a, 0x17, 0x60, 0xda, 0x30, 0x75, 0x7c, 0x42, 0xab, + 0x99, 0x91, 0xd9, 0x43, 0x64, 0x2b, 0x31, 0x3d, 0xd1, 0x56, 0xa2, 0xf4, 0x19, 0x2c, 0x46, 0x8a, + 0x98, 0x64, 0xfd, 0xff, 0x38, 0x05, 0x8b, 0xbc, 0x22, 0x89, 0xaf, 0x60, 0x7e, 0x13, 0xa6, 0xdb, + 0x44, 0xe6, 0x98, 0x76, 0xa6, 0xef, 0xf4, 0xda, 0x99, 0x66, 0x46, 0xbf, 0x04, 0xd0, 0xb5, 0xf1, + 0xb1, 0xc2, 0x58, 0xd3, 0x13, 0xb1, 0xe6, 0x08, 0x07, 0x25, 0xa0, 0x2f, 0x04, 0x28, 0x92, 0x01, + 0xdd, 0xb5, 0xad, 0xae, 0xe5, 0x10, 0x9f, 0xc5, 0x99, 0x0c, 0xe6, 0x3c, 0x7b, 0x7d, 0xba, 0x3a, + 0xbf, 0x6d, 0x98, 0xbb, 0x9c, 0xb1, 0xd9, 0x98, 0x38, 0xc0, 0xdf, 0x3b, 0x07, 0x51, 0xaa, 0xb4, + 0x2d, 0xed, 0x28, 0xd8, 0x1c, 0x23, 0x96, 0xc5, 0x17, 0xe7, 0x48, 0x3f, 0x11, 0xe0, 0xc2, 0xcf, + 0x6d, 0xb9, 0xf8, 0xff, 0x87, 0xb2, 0xa5, 0xe7, 0x20, 0xd2, 0x1f, 0x75, 0xf3, 0xc0, 0x4a, 0x72, + 0xe1, 0xfe, 0x7f, 0x0b, 0xb0, 0x10, 0x12, 0x9c, 0xa4, 0x83, 0xf3, 0xa6, 0x7a, 0x9a, 0x67, 0xe1, + 0x30, 0xee, 0x64, 0xaa, 0x92, 0xe7, 0x78, 0x76, 0xd6, 0x29, 0x4b, 0x30, 0x87, 0x89, 0x15, 0xa3, + 0x4b, 0xbc, 0xfb, 0xec, 0x90, 0xc9, 0xc0, 0x8a, 0x7e, 0xde, 0xcf, 0x50, 0xee, 0x4b, 0xbf, 0x4a, + 0x3c, 0xac, 0xf0, 0xa0, 0x4c, 0x72, 0xc8, 0xff, 0xb3, 0x14, 0x5c, 0xaa, 0xb0, 0x2d, 0x70, 0x2f, + 0x26, 0x24, 0xc9, 0x8e, 0xb8, 0x04, 0xb3, 0xc7, 0xd8, 0x76, 0x0c, 0x8b, 0xcd, 0xf6, 0xf3, 0xb2, + 0xf7, 0x88, 0x96, 0x21, 0xeb, 0x98, 0x6a, 0xd7, 0x39, 0xb4, 0xbc, 0xed, 0x44, 0xff, 0xd9, 0x8f, + 0x5f, 0x99, 0x7e, 0xf3, 0xf8, 0x95, 0x99, 0xf1, 0xf1, 0x2b, 0xb3, 0x5f, 0x21, 0x7e, 0x85, 0xef, + 0xdd, 0xfd, 0x3b, 0x01, 0x2e, 0x0f, 0x69, 0x2e, 0xc9, 0xce, 0xf9, 0x1d, 0xc8, 0x6b, 0x5c, 0x30, + 0x99, 0x1f, 0xd8, 0xc6, 0x64, 0x9d, 0x64, 0x7b, 0x43, 0xe8, 0xf3, 0xfa, 0x74, 0x15, 0xbc, 0xa2, + 0xd6, 0x37, 0xb8, 0x72, 0xc8, 0x6f, 0x5d, 0xfa, 0xef, 0x00, 0xc5, 0xea, 0x09, 0x5b, 0x94, 0x6f, + 0x30, 0xaf, 0x04, 0x3d, 0x82, 0x6c, 0xd7, 0xb6, 0x8e, 0x0d, 0xaf, 0x1a, 0x85, 0x48, 0xf0, 0x82, + 0x57, 0x8d, 0x01, 0xae, 0x5d, 0xce, 0x21, 0xfb, 0xbc, 0xa8, 0x09, 0xb9, 0x27, 0x96, 0xa6, 0xb6, + 0x1f, 0x19, 0x6d, 0x6f, 0xa0, 0xbd, 0x77, 0xb6, 0xa0, 0x92, 0xcf, 0xb3, 0xab, 0xba, 0x87, 0x5e, + 0x23, 0xf8, 0x44, 0x54, 0x87, 0x6c, 0xcd, 0x75, 0xbb, 0x24, 0x91, 0x8f, 0xbf, 0xdb, 0x13, 0x08, + 0x25, 0x2c, 0x5e, 0xc4, 0xad, 0xc7, 0x8e, 0x9a, 0xb0, 0xf0, 0x98, 0x1e, 0x20, 0xab, 0xb4, 0xad, + 0x9e, 0x5e, 0xb1, 0xcc, 0x03, 0xa3, 0xc5, 0xa7, 0x89, 0x5b, 0x13, 0xc8, 0x7c, 0x5c, 0x69, 0xc8, + 0xc3, 0x02, 0xd0, 0x3a, 0x64, 0x1b, 0x0f, 0xb9, 0x30, 0xe6, 0x46, 0xde, 0x9c, 0x40, 0x58, 0xe3, + 0xa1, 0xec, 0xb3, 0xa1, 0x4d, 0xc8, 0xaf, 0x7f, 0xde, 0xb3, 0x31, 0x97, 0x32, 0x33, 0x32, 0x72, + 0x62, 0x50, 0x0a, 0xe5, 0x92, 0xc3, 0xcc, 0xe8, 0xdb, 0x50, 0x24, 0x7a, 0x6b, 0xaa, 0xfb, 0x6d, + 0x4f, 0x5e, 0x96, 0xca, 0xfb, 0xc6, 0x04, 0xf2, 0x7c, 0x4e, 0x6f, 0x4b, 0x60, 0x40, 0xd4, 0xb2, + 0x0c, 0xf3, 0x91, 0xf6, 0x42, 0x08, 0x32, 0x5d, 0xd2, 0x34, 0x02, 0x0d, 0x43, 0xa2, 0xbf, 0xd1, + 0xbb, 0x30, 0x6b, 0x5a, 0x3a, 0xf6, 0x3a, 0xf3, 0x7c, 0xf9, 0xc2, 0xeb, 0xd3, 0xd5, 0x99, 0x1d, + 0x4b, 0x67, 0xbe, 0x0e, 0xff, 0x25, 0xcf, 0x90, 0x4c, 0x75, 0x7d, 0xf9, 0x1a, 0x64, 0x48, 0x13, + 0x11, 0x1b, 0xb2, 0xaf, 0x3a, 0x78, 0xcf, 0x36, 0xb8, 0x34, 0xef, 0x71, 0xf9, 0x1f, 0xa6, 0x20, + 0xd5, 0x78, 0x48, 0xbc, 0xf9, 0xfd, 0x9e, 0x76, 0x84, 0x5d, 0x9e, 0xce, 0x9f, 0xa8, 0x97, 0x6f, + 0xe3, 0x03, 0x83, 0x39, 0x5d, 0x39, 0x99, 0x3f, 0xa1, 0xb7, 0x01, 0x54, 0x4d, 0xc3, 0x8e, 0xa3, + 0x78, 0x47, 0x00, 0x73, 0x72, 0x8e, 0x51, 0xb6, 0x70, 0x9f, 0xb0, 0x39, 0x58, 0xb3, 0xb1, 0xeb, + 0xc5, 0x50, 0xb1, 0x27, 0xc2, 0xe6, 0xe2, 0x4e, 0x57, 0x71, 0xad, 0x23, 0x6c, 0xd2, 0x26, 0xcd, + 0x11, 0xab, 0xd0, 0xe9, 0x36, 0x09, 0x81, 0x18, 0x34, 0x6c, 0xea, 0x81, 0xf5, 0xc9, 0xc9, 0xfe, + 0x33, 0x11, 0x69, 0xe3, 0x96, 0xc1, 0x0f, 0xd0, 0xe5, 0x64, 0xfe, 0x44, 0xb4, 0xa4, 0xf6, 0xdc, + 0x43, 0xda, 0x12, 0x39, 0x99, 0xfe, 0x46, 0xb7, 0xa0, 0xc8, 0xc2, 0x2e, 0x15, 0x6c, 0x6a, 0x0a, + 0xb5, 0x83, 0x39, 0x9a, 0x3c, 0xcf, 0xc8, 0x55, 0x53, 0x23, 0x56, 0x0f, 0x3d, 0x04, 0x4e, 0x50, + 0x8e, 0x3a, 0x0e, 0xd1, 0x29, 0x90, 0x5c, 0xe5, 0xe2, 0xeb, 0xd3, 0xd5, 0x7c, 0x83, 0x26, 0x6c, + 0x6d, 0x37, 0xc8, 0x5c, 0xc2, 0x72, 0x6d, 0x75, 0x9c, 0xba, 0xbe, 0xfc, 0xb7, 0x04, 0x48, 0x3f, + 0xae, 0x34, 0xce, 0xad, 0x32, 0xaf, 0xa0, 0xe9, 0x50, 0x41, 0x6f, 0x43, 0x71, 0xdf, 0x68, 0xb7, + 0x0d, 0xb3, 0x45, 0xfc, 0xab, 0xef, 0x60, 0xcd, 0x53, 0x58, 0x81, 0x93, 0x77, 0x19, 0x15, 0x5d, + 0x83, 0xbc, 0x66, 0x63, 0x1d, 0x9b, 0xae, 0xa1, 0xb6, 0x1d, 0xae, 0xb9, 0x30, 0x69, 0xf9, 0xaf, + 0x08, 0x30, 0x4d, 0x3b, 0x2b, 0x7a, 0x0b, 0x72, 0x9a, 0x65, 0xba, 0xaa, 0x61, 0x72, 0xab, 0x93, + 0x93, 0x03, 0xc2, 0xc8, 0xe2, 0x5d, 0x87, 0x39, 0x55, 0xd3, 0xac, 0x9e, 0xe9, 0x2a, 0xa6, 0xda, + 0xc1, 0xbc, 0x98, 0x79, 0x4e, 0xdb, 0x51, 0x3b, 0x18, 0xad, 0x82, 0xf7, 0xe8, 0x9f, 0xec, 0xcc, + 0xc9, 0xc0, 0x49, 0x5b, 0xb8, 0xbf, 0x8c, 0x21, 0xe7, 0xf7, 0x6a, 0x52, 0xdf, 0x9e, 0xe3, 0x97, + 0x80, 0xfe, 0x46, 0xef, 0xc1, 0x85, 0x97, 0x3d, 0xb5, 0x6d, 0x1c, 0xd0, 0xc5, 0x2f, 0x1a, 0xa5, + 0x4e, 0x5f, 0xc6, 0x8a, 0x82, 0xfc, 0x34, 0x2a, 0x81, 0xbe, 0xd3, 0x1b, 0x04, 0xe9, 0x60, 0x10, + 0xb0, 0x90, 0x1d, 0xa9, 0x0f, 0x0b, 0x32, 0x76, 0xed, 0x7e, 0x93, 0x9d, 0x86, 0xad, 0x1e, 0x63, + 0xd3, 0x25, 0x75, 0xb7, 0xba, 0x98, 0x05, 0x89, 0x78, 0x75, 0xf7, 0x09, 0xe8, 0x26, 0x14, 0x54, + 0x97, 0x74, 0x37, 0x57, 0x31, 0x7b, 0x9d, 0x7d, 0x6c, 0xb3, 0x50, 0x00, 0x79, 0x9e, 0x53, 0x77, + 0x28, 0x91, 0x9f, 0xc8, 0xb0, 0xfb, 0x0a, 0x5d, 0x27, 0xe2, 0xaf, 0x06, 0x4a, 0xaa, 0x12, 0x8a, + 0x74, 0x17, 0x2e, 0x92, 0x7a, 0x56, 0x4d, 0xcd, 0xee, 0x77, 0x89, 0xe4, 0xa7, 0xf4, 0xaf, 0x83, + 0xc4, 0xd0, 0x3e, 0x0d, 0xdd, 0x9e, 0x91, 0x7e, 0x3c, 0x03, 0xf3, 0xd5, 0x93, 0xae, 0x65, 0x27, + 0xba, 0xaa, 0x53, 0x86, 0x59, 0x0e, 0x7c, 0xc7, 0x6c, 0xc5, 0x0e, 0x58, 0x20, 0x6f, 0x1f, 0x9a, + 0x33, 0xa2, 0x32, 0x00, 0x0b, 0xa8, 0xa4, 0x71, 0x38, 0xe9, 0x73, 0xec, 0x1c, 0x51, 0x36, 0x7a, + 0xd8, 0x60, 0x07, 0xf2, 0x9d, 0x63, 0x4d, 0x53, 0x0e, 0x8c, 0xb6, 0xcb, 0xe3, 0xd2, 0xe2, 0x43, + 0xa8, 0xb7, 0x9f, 0x57, 0x2a, 0x8f, 0x68, 0x26, 0x16, 0xcf, 0x15, 0x3c, 0xcb, 0x40, 0x24, 0xb0, + 0xdf, 0xe8, 0x1b, 0xc0, 0x0f, 0xbe, 0x28, 0x8e, 0x77, 0x8c, 0xad, 0x3c, 0xff, 0xfa, 0x74, 0x35, + 0x27, 0x53, 0x6a, 0xa3, 0xd1, 0x94, 0x73, 0x2c, 0x43, 0xc3, 0x71, 0xcf, 0x73, 0xd4, 0x61, 0x76, + 0xf2, 0xa3, 0x0e, 0x7f, 0x5d, 0x80, 0x4b, 0x5c, 0x47, 0xca, 0x3e, 0x0d, 0xef, 0x56, 0xdb, 0x86, + 0xdb, 0x57, 0x8e, 0x8e, 0x97, 0xb2, 0xd4, 0xe5, 0xf9, 0xc5, 0x58, 0x5d, 0x87, 0x9a, 0xb8, 0xe4, + 0x69, 0xbc, 0xff, 0x84, 0x33, 0x6f, 0x1d, 0x57, 0x4d, 0xd7, 0xee, 0x97, 0x2f, 0xbf, 0x3e, 0x5d, + 0x5d, 0x1c, 0x4e, 0x7d, 0x2e, 0x2f, 0x3a, 0xc3, 0x2c, 0xa8, 0x06, 0x80, 0xfd, 0x2e, 0x46, 0x2d, + 0x58, 0xfc, 0xd4, 0x15, 0xdb, 0x17, 0xe5, 0x10, 0x2f, 0xba, 0x03, 0x22, 0x3f, 0x5a, 0x72, 0x60, + 0xb4, 0xb1, 0xe2, 0x18, 0x9f, 0x63, 0x6a, 0xeb, 0xd2, 0x72, 0x81, 0xd1, 0x89, 0x88, 0x86, 0xf1, + 0x39, 0x46, 0xf7, 0xe1, 0x62, 0xd0, 0x02, 0xca, 0x3e, 0x6e, 0x5b, 0xaf, 0x58, 0xf6, 0x3c, 0xcd, + 0x8e, 0x7c, 0xed, 0x97, 0x49, 0x12, 0x61, 0x59, 0xfe, 0x0e, 0x2c, 0x8d, 0xaa, 0x70, 0x78, 0x40, + 0xe4, 0xd8, 0x7e, 0xe5, 0x07, 0xd1, 0xc5, 0x8a, 0x09, 0x3a, 0x2e, 0x5f, 0xb0, 0xf8, 0x30, 0xf5, + 0x81, 0x20, 0xfd, 0x83, 0x14, 0xcc, 0x97, 0x7b, 0xed, 0xa3, 0xa7, 0xdd, 0x06, 0x3b, 0xb7, 0x8f, + 0xae, 0x42, 0x4e, 0x57, 0x5d, 0x95, 0x15, 0x52, 0x60, 0x47, 0xcc, 0x08, 0x81, 0xd6, 0xe6, 0x36, + 0x14, 0x43, 0xb1, 0x20, 0x3c, 0xe2, 0x9d, 0x56, 0x3b, 0x20, 0xd3, 0xa0, 0xf4, 0x0f, 0x60, 0x29, + 0x94, 0x91, 0xae, 0x2c, 0x28, 0xd8, 0x74, 0x6d, 0x03, 0xb3, 0xd5, 0xb1, 0xb4, 0x1c, 0x0a, 0x58, + 0xa9, 0x93, 0xe4, 0x2a, 0x4b, 0x45, 0x4d, 0x98, 0x23, 0x19, 0xfb, 0x0a, 0xb5, 0x82, 0xde, 0xea, + 0xe5, 0xfd, 0x98, 0x6a, 0x45, 0xca, 0x5d, 0xa2, 0xfa, 0xa9, 0x50, 0x1e, 0xfa, 0x53, 0xce, 0xe3, + 0x80, 0xb2, 0xfc, 0x09, 0x88, 0x83, 0x19, 0xc2, 0xba, 0xcc, 0x30, 0x5d, 0x5e, 0x08, 0xeb, 0x32, + 0x1d, 0xd2, 0xd3, 0x66, 0x26, 0x9b, 0x11, 0xa7, 0xa5, 0x9f, 0xa4, 0xa1, 0xe0, 0xf5, 0xcc, 0x24, + 0xdd, 0xea, 0x32, 0x4c, 0x93, 0x7e, 0xe4, 0x85, 0x57, 0xdc, 0x1a, 0x33, 0x20, 0x78, 0x8c, 0x35, + 0xe9, 0x5f, 0x1e, 0x02, 0xa4, 0xac, 0x49, 0x98, 0x9f, 0xe5, 0x3f, 0x15, 0x20, 0x43, 0x3d, 0xd9, + 0xfb, 0x90, 0xa1, 0xe7, 0xf2, 0x85, 0xb1, 0xe7, 0xf2, 0xbd, 0xed, 0x79, 0x92, 0xd5, 0x9f, 0x58, + 0x52, 0x21, 0xef, 0xaa, 0x4c, 0xe3, 0x7b, 0x2c, 0xdb, 0xc5, 0x3a, 0xf7, 0x14, 0xaf, 0x9d, 0xd5, + 0x8e, 0x9e, 0x27, 0xec, 0xf1, 0xa1, 0x2b, 0x90, 0x26, 0xb6, 0x6b, 0x96, 0x6d, 0xd5, 0xbf, 0x3e, + 0x5d, 0x4d, 0x13, 0xab, 0x45, 0x68, 0x68, 0x0d, 0xf2, 0x51, 0x6b, 0x42, 0x9c, 0x0d, 0x6a, 0x0e, + 0x43, 0x96, 0x00, 0xda, 0xfe, 0x10, 0x62, 0x28, 0x89, 0xb5, 0x25, 0xdf, 0xa4, 0xff, 0xae, 0xc0, + 0x63, 0x12, 0x1b, 0x1a, 0x99, 0xb3, 0xec, 0x24, 0x27, 0x95, 0xbb, 0x20, 0xda, 0xaa, 0xa9, 0x5b, + 0x1d, 0xe3, 0x73, 0xcc, 0x50, 0xb9, 0xc3, 0xb7, 0x2b, 0x8a, 0x3e, 0x9d, 0xc2, 0x67, 0x47, 0xfa, + 0x6f, 0x02, 0x8f, 0x5f, 0xf4, 0x8b, 0x91, 0xec, 0xa6, 0x72, 0x9e, 0x2f, 0xe9, 0x99, 0x07, 0x96, + 0x17, 0x7e, 0xf1, 0xd6, 0xa8, 0x60, 0xa3, 0xba, 0x79, 0x60, 0x79, 0xdb, 0x63, 0xb6, 0x47, 0x70, + 0x96, 0x7f, 0x05, 0xa6, 0x69, 0xf2, 0x1b, 0xf4, 0x0d, 0x3f, 0x66, 0x36, 0x25, 0xa6, 0xa5, 0x3f, + 0x4a, 0xc1, 0x3b, 0xb4, 0xaa, 0xcf, 0xb1, 0x6d, 0x1c, 0xf4, 0x77, 0x6d, 0xcb, 0xc5, 0x9a, 0x8b, + 0xf5, 0x60, 0x55, 0x2a, 0xc1, 0x26, 0xd0, 0x21, 0xc7, 0xf7, 0xf3, 0x0c, 0x9d, 0xdf, 0x9c, 0xf1, + 0xf8, 0xab, 0xa1, 0xd5, 0x2c, 0xdb, 0x07, 0xac, 0x6f, 0xc8, 0x59, 0x26, 0xb9, 0xae, 0xa3, 0x75, + 0xc8, 0x75, 0xbd, 0x6a, 0x9c, 0x2b, 0x64, 0xc4, 0xe7, 0x42, 0x5b, 0x50, 0xe4, 0x05, 0x55, 0xdb, + 0xc6, 0x31, 0x56, 0x54, 0xf7, 0x3c, 0x43, 0x78, 0x9e, 0xf1, 0xae, 0x13, 0xd6, 0x75, 0x57, 0xfa, + 0x9b, 0x19, 0xb8, 0x79, 0x86, 0x8a, 0x93, 0xec, 0x5e, 0xcb, 0x90, 0x3d, 0x26, 0x2f, 0x32, 0x78, + 0xed, 0xb3, 0xb2, 0xff, 0x8c, 0xf6, 0x23, 0xf3, 0xc0, 0x81, 0x6a, 0xb4, 0xc9, 0xbc, 0xc1, 0x82, + 0xf4, 0x46, 0x87, 0x01, 0xc5, 0x07, 0xbd, 0x85, 0x66, 0x8c, 0x47, 0x54, 0x10, 0xcd, 0xe6, 0xa0, + 0xef, 0x09, 0xb0, 0xcc, 0x5e, 0xc8, 0x22, 0xc5, 0x06, 0x5e, 0x93, 0xa1, 0xaf, 0xd9, 0x88, 0x79, + 0xcd, 0x44, 0x3a, 0x2a, 0x85, 0xde, 0xc5, 0x0b, 0xb2, 0x14, 0x7e, 0x5b, 0xb8, 0x28, 0xcb, 0xbf, + 0x29, 0x40, 0x3e, 0x44, 0x40, 0xb7, 0x86, 0xce, 0xe5, 0xe4, 0x5f, 0xc7, 0x1d, 0xc6, 0xb9, 0x39, + 0x74, 0x18, 0xa7, 0x9c, 0xfd, 0xf2, 0x74, 0x35, 0x23, 0xb3, 0x78, 0x6f, 0xef, 0x58, 0xce, 0xf5, + 0xe0, 0x1a, 0x98, 0xf4, 0x40, 0x26, 0xef, 0x1e, 0x18, 0x0a, 0xeb, 0x54, 0x6f, 0x1b, 0x89, 0xc2, + 0x3a, 0xf2, 0x24, 0xfd, 0x20, 0x05, 0x0b, 0xeb, 0xba, 0xde, 0x68, 0x50, 0x28, 0x90, 0xe4, 0x18, + 0x43, 0x90, 0x21, 0xfe, 0x01, 0x3f, 0x43, 0x44, 0x7f, 0xa3, 0x77, 0x01, 0xe9, 0x86, 0xc3, 0xae, + 0x53, 0x70, 0x0e, 0x55, 0xdd, 0x7a, 0x15, 0xec, 0x16, 0x2f, 0x78, 0x29, 0x0d, 0x2f, 0x01, 0x35, + 0x80, 0x3a, 0xad, 0x8a, 0xe3, 0xaa, 0xfe, 0x6a, 0xf8, 0xcd, 0x89, 0x4e, 0xa5, 0x30, 0x6f, 0xd6, + 0x7f, 0x94, 0x73, 0x44, 0x0e, 0xfd, 0x49, 0x7c, 0x34, 0x83, 0x34, 0x8a, 0xab, 0xa8, 0x8e, 0x77, + 0x9e, 0x82, 0x5d, 0xe4, 0x50, 0x60, 0xf4, 0x75, 0x87, 0x1d, 0x93, 0x60, 0x61, 0xd8, 0x81, 0x6a, + 0x92, 0x5c, 0xcb, 0xfc, 0xbb, 0x02, 0x14, 0x64, 0x7c, 0x60, 0x63, 0xe7, 0x30, 0x49, 0x9d, 0x3f, + 0x82, 0x39, 0x9b, 0x49, 0x55, 0x0e, 0x6c, 0xab, 0x73, 0x1e, 0x5b, 0x91, 0xe7, 0x8c, 0x8f, 0x6c, + 0xab, 0xc3, 0x4d, 0xf2, 0x73, 0x28, 0xfa, 0x65, 0x4c, 0xb2, 0xf2, 0x7f, 0x9f, 0x9e, 0xb8, 0x64, + 0x82, 0x93, 0xde, 0xb6, 0x4d, 0x56, 0x03, 0x74, 0x3d, 0x3b, 0x5c, 0xd0, 0x24, 0xd5, 0xf0, 0x5f, + 0x05, 0x28, 0x34, 0x7a, 0xfb, 0xec, 0x9a, 0xa0, 0xe4, 0x34, 0x50, 0x85, 0x5c, 0x1b, 0x1f, 0xb8, + 0xca, 0x1b, 0x05, 0x10, 0x67, 0x09, 0x2b, 0x0d, 0x9f, 0x7e, 0x0c, 0x60, 0xd3, 0x23, 0x47, 0x54, + 0x4e, 0xfa, 0x9c, 0x72, 0x72, 0x94, 0x97, 0x90, 0xc9, 0xac, 0x53, 0xf4, 0xab, 0x99, 0xe4, 0xfc, + 0xf2, 0x22, 0x62, 0x1d, 0xd2, 0xe7, 0xb1, 0x0e, 0x0b, 0x7c, 0xa7, 0x3a, 0xde, 0x42, 0x94, 0x60, + 0x91, 0xba, 0x65, 0x8a, 0xda, 0xed, 0xb6, 0x0d, 0x0f, 0xa7, 0x50, 0xfb, 0x93, 0x91, 0x17, 0x68, + 0xd2, 0x3a, 0x4b, 0xa1, 0x08, 0x05, 0xfd, 0x86, 0x00, 0x73, 0x07, 0x36, 0xc6, 0x9f, 0x63, 0x85, + 0x9a, 0xe4, 0xc9, 0xb6, 0xe2, 0x37, 0x48, 0x19, 0xbe, 0xf2, 0x56, 0x5d, 0x9e, 0xbd, 0xb8, 0x41, + 0xde, 0x8b, 0x76, 0x40, 0xd4, 0xda, 0x6c, 0xf3, 0xd0, 0x0f, 0x0b, 0x98, 0x99, 0x7c, 0x00, 0x14, + 0x19, 0x73, 0x10, 0x19, 0xf0, 0x8c, 0x0c, 0x26, 0x55, 0x57, 0xf8, 0xdd, 0x6d, 0xd4, 0xd9, 0x8e, + 0x86, 0x05, 0x84, 0x8f, 0x5e, 0x87, 0xae, 0x7c, 0x2b, 0xc9, 0x58, 0xd5, 0xb9, 0xe7, 0x4e, 0xc6, + 0x95, 0xff, 0xc0, 0xc7, 0xd5, 0x0b, 0x58, 0xa0, 0xfd, 0x26, 0xe9, 0x13, 0x94, 0xd2, 0x3f, 0x4e, + 0x03, 0x0a, 0x4b, 0xfe, 0xf9, 0xf5, 0xb7, 0x54, 0x72, 0xfd, 0x6d, 0x13, 0xa4, 0x90, 0x33, 0xd4, + 0x56, 0x1d, 0x57, 0x61, 0xf1, 0x67, 0x8e, 0xd2, 0xc5, 0xb6, 0xe2, 0x60, 0xcd, 0xe2, 0x97, 0xe8, + 0x08, 0xf2, 0x4a, 0x90, 0xf3, 0x89, 0xea, 0xb8, 0xcf, 0x58, 0xbe, 0x5d, 0x6c, 0x37, 0x68, 0x2e, + 0xf4, 0x10, 0x2e, 0x75, 0xd4, 0x93, 0x38, 0xfe, 0x69, 0xca, 0xbf, 0xd8, 0x51, 0x4f, 0x86, 0x98, + 0x3e, 0x84, 0xe5, 0x78, 0x26, 0xc5, 0xc1, 0xde, 0xfe, 0xd4, 0xa5, 0x18, 0xc6, 0x06, 0x76, 0xd1, + 0x3a, 0x40, 0x00, 0x22, 0xf8, 0x1c, 0x3d, 0x09, 0x86, 0xc8, 0xf9, 0x18, 0x42, 0xfa, 0xbe, 0x00, + 0x85, 0x6d, 0xa3, 0x65, 0xab, 0x89, 0x5e, 0x51, 0x83, 0x3e, 0x8c, 0x6e, 0xe8, 0xe5, 0x1f, 0x2c, + 0xc7, 0x05, 0x6c, 0xb0, 0x1c, 0xde, 0xa2, 0x1d, 0x67, 0x20, 0x53, 0x9f, 0x5f, 0xa2, 0x24, 0x6d, + 0xfe, 0x7f, 0xb8, 0x02, 0x73, 0xbc, 0xdc, 0x7b, 0xa6, 0x61, 0x99, 0xe8, 0x3e, 0xa4, 0x5b, 0x7c, + 0x69, 0x3b, 0x1f, 0xbb, 0xa2, 0x17, 0x5c, 0x00, 0x57, 0x9b, 0x92, 0x49, 0x5e, 0xc2, 0xd2, 0xed, + 0xb9, 0x31, 0x80, 0x22, 0x88, 0x61, 0x0e, 0xb3, 0x74, 0x7b, 0x2e, 0x6a, 0x40, 0x51, 0x0b, 0x6e, + 0x9d, 0x52, 0x08, 0x7b, 0x7a, 0xe4, 0x32, 0x57, 0xec, 0xfd, 0x5f, 0xb5, 0x29, 0xb9, 0xa0, 0x45, + 0x12, 0x50, 0x25, 0x7c, 0xd9, 0x51, 0x66, 0x28, 0x40, 0x2a, 0x38, 0x2a, 0x1b, 0xbd, 0x68, 0xa9, + 0x36, 0x15, 0xba, 0x13, 0x09, 0x7d, 0x08, 0x33, 0x3a, 0xbd, 0x56, 0x87, 0x1b, 0xcd, 0xb8, 0x86, + 0x8e, 0xdc, 0x5e, 0x54, 0x9b, 0x92, 0x39, 0x07, 0xda, 0x84, 0x39, 0xf6, 0x8b, 0xb9, 0xf4, 0xdc, + 0xd4, 0xdd, 0x1c, 0x2d, 0x21, 0xe4, 0x6c, 0xd4, 0xa6, 0xe4, 0xbc, 0x1e, 0x50, 0xd1, 0x63, 0xc8, + 0x6b, 0x6d, 0xac, 0xda, 0x5c, 0xd4, 0xad, 0x91, 0xa7, 0xba, 0x86, 0xae, 0xe2, 0xa9, 0x4d, 0xc9, + 0xa0, 0xf9, 0x44, 0x52, 0x28, 0x9b, 0xde, 0xc8, 0xc2, 0x25, 0xbd, 0x37, 0xb2, 0x50, 0xc3, 0xd7, + 0xdb, 0xd4, 0xa8, 0x13, 0xe2, 0x53, 0xd1, 0x37, 0x21, 0xe3, 0x68, 0xaa, 0xc9, 0xed, 0xee, 0xca, + 0x88, 0x2b, 0x33, 0x02, 0x66, 0x9a, 0x1b, 0x7d, 0xc4, 0xd0, 0x80, 0x7b, 0xe2, 0xad, 0x65, 0xc6, + 0xe9, 0x34, 0x72, 0x34, 0x9b, 0xe8, 0x14, 0x53, 0x02, 0xd1, 0x83, 0x4a, 0xe0, 0x8f, 0x42, 0xcf, + 0x4b, 0xd2, 0xc5, 0xcb, 0x78, 0x3d, 0x0c, 0x9d, 0x6f, 0xad, 0xd1, 0xf3, 0xdf, 0x1e, 0x11, 0x6d, + 0xc3, 0x3c, 0x13, 0xd4, 0x63, 0x47, 0x2f, 0x97, 0xd6, 0x46, 0xee, 0x52, 0xc6, 0x1c, 0xfe, 0xac, + 0x4d, 0xc9, 0x73, 0x6a, 0x88, 0x1c, 0x94, 0xab, 0x83, 0xed, 0x16, 0x5b, 0x25, 0x1d, 0x53, 0xae, + 0x70, 0xe8, 0x97, 0x5f, 0x2e, 0x4a, 0x44, 0xbf, 0x0e, 0x17, 0x98, 0x20, 0x97, 0x47, 0xb4, 0xf0, + 0xc0, 0x88, 0xb7, 0x47, 0xee, 0x30, 0x8e, 0x3c, 0x2e, 0x59, 0x9b, 0x92, 0x91, 0x3a, 0x94, 0x88, + 0x34, 0xb8, 0xc8, 0xde, 0xc0, 0xcf, 0xdb, 0xd9, 0xfc, 0x88, 0xd8, 0xd2, 0x0d, 0xfa, 0x8a, 0x77, + 0x47, 0xbd, 0x22, 0xf6, 0x18, 0x60, 0x6d, 0x4a, 0x5e, 0x54, 0x87, 0x53, 0x83, 0x6a, 0xd8, 0xfc, + 0x64, 0x13, 0xef, 0x6e, 0xef, 0x8e, 0xaf, 0x46, 0xdc, 0x89, 0x30, 0xbf, 0x1a, 0x91, 0x44, 0xd2, + 0x80, 0xfe, 0xb9, 0x6e, 0xda, 0x99, 0xe6, 0x46, 0x36, 0x60, 0xcc, 0xf1, 0x27, 0xd2, 0x80, 0x87, + 0x21, 0x32, 0x2a, 0x41, 0xaa, 0xa5, 0x2d, 0xcd, 0x8f, 0x9c, 0x1f, 0xfc, 0x23, 0x3e, 0xb5, 0x29, + 0x39, 0xd5, 0xd2, 0xd0, 0x27, 0x90, 0x65, 0xe7, 0x35, 0x4e, 0xcc, 0xa5, 0xc2, 0x48, 0x83, 0x1b, + 0x3d, 0xf5, 0x52, 0x9b, 0x92, 0xe9, 0x11, 0x11, 0xde, 0x91, 0x79, 0x2c, 0x3e, 0x15, 0x51, 0x1a, + 0x73, 0x4c, 0x73, 0xe0, 0x44, 0x04, 0xe9, 0x30, 0xb6, 0x4f, 0x44, 0xbb, 0x50, 0xb0, 0x59, 0xb4, + 0xa2, 0x17, 0x5b, 0x2c, 0x8e, 0xdc, 0xc3, 0x8f, 0x0b, 0x2f, 0xae, 0xd1, 0x75, 0x98, 0x10, 0x9d, + 0xb4, 0x5d, 0x54, 0x22, 0x6f, 0xbb, 0x85, 0x91, 0x6d, 0x37, 0x32, 0xd4, 0x95, 0xb4, 0x9d, 0x3d, + 0x94, 0x88, 0xde, 0x87, 0x69, 0x36, 0x4e, 0x10, 0x15, 0x19, 0x17, 0x96, 0x32, 0x30, 0x44, 0x58, + 0x7e, 0x62, 0xbd, 0x5c, 0x1e, 0xb2, 0xa7, 0xb4, 0xad, 0xd6, 0xd2, 0xe2, 0x48, 0xeb, 0x35, 0x1c, + 0x7c, 0x48, 0xac, 0x97, 0x1b, 0x50, 0x49, 0x07, 0xb2, 0x59, 0x0a, 0x1f, 0x62, 0x17, 0x46, 0x76, + 0xa0, 0x98, 0x48, 0xbe, 0x1a, 0x3d, 0x4c, 0x11, 0x90, 0x7d, 0xc3, 0xea, 0x60, 0x85, 0x1a, 0xc5, + 0x8b, 0xe3, 0x0d, 0x6b, 0xe4, 0x1e, 0x23, 0xdf, 0xb0, 0x32, 0x2a, 0x7a, 0x0e, 0x22, 0xbf, 0x4c, + 0x43, 0xf1, 0x22, 0x4b, 0x96, 0x2e, 0x51, 0x79, 0x77, 0x63, 0x27, 0xc4, 0xb8, 0xa0, 0xa3, 0x1a, + 0x71, 0x98, 0xa3, 0x29, 0xe8, 0x53, 0x58, 0xa0, 0xf2, 0x14, 0x2d, 0xb8, 0xff, 0x64, 0x69, 0x69, + 0xe8, 0x36, 0x8d, 0xd1, 0x57, 0xa5, 0x78, 0x92, 0x45, 0x6d, 0x20, 0x89, 0x8c, 0x07, 0xc3, 0x34, + 0x5c, 0x3a, 0x77, 0x2f, 0x8f, 0x1c, 0x0f, 0xd1, 0xbb, 0x1f, 0xc9, 0x78, 0x30, 0x18, 0x85, 0x74, + 0xe3, 0x01, 0x8b, 0xf7, 0xd6, 0xc8, 0x6e, 0x3c, 0xc2, 0xd8, 0xcd, 0xbb, 0x11, 0x3b, 0xb7, 0x01, + 0xc0, 0x60, 0x12, 0xf5, 0xfc, 0x56, 0x46, 0x3a, 0x00, 0x83, 0x91, 0x76, 0xc4, 0x01, 0x68, 0x7b, + 0x34, 0xe2, 0x00, 0xb0, 0x35, 0xfd, 0xa5, 0x6b, 0xa3, 0x27, 0xab, 0xf0, 0xae, 0x1f, 0x9d, 0xac, + 0x28, 0x01, 0xad, 0x43, 0x8e, 0xf8, 0xac, 0x7d, 0x3a, 0xc2, 0xaf, 0x8f, 0x84, 0xa8, 0x03, 0x47, + 0x70, 0x6a, 0x53, 0x72, 0xf6, 0x25, 0x27, 0x91, 0x5e, 0xc5, 0x44, 0xf0, 0xb1, 0x7d, 0x6f, 0x64, + 0xaf, 0x1a, 0x3e, 0x7b, 0x41, 0x7a, 0xd5, 0xcb, 0x80, 0x1a, 0x4c, 0x79, 0x0e, 0x5b, 0xad, 0x5f, + 0x7a, 0x67, 0xfc, 0x94, 0x17, 0xdd, 0x5b, 0xf0, 0xa7, 0x3c, 0x4e, 0x66, 0x53, 0x9e, 0xae, 0x38, + 0x0e, 0xdd, 0xc0, 0x5f, 0xba, 0x39, 0x66, 0xca, 0x1b, 0x58, 0xbf, 0x63, 0x53, 0x9e, 0xde, 0x60, + 0x9c, 0xc4, 0xfb, 0xb3, 0xbd, 0xcb, 0x63, 0x38, 0x7a, 0xb9, 0x3d, 0xd2, 0xfb, 0x8b, 0xbd, 0xdd, + 0x86, 0x78, 0x7f, 0x76, 0x24, 0x01, 0xfd, 0x12, 0xcc, 0xf2, 0xf5, 0x92, 0xa5, 0x3b, 0x63, 0xfc, + 0xe1, 0xf0, 0x12, 0x17, 0xe9, 0x8e, 0x9c, 0x87, 0x19, 0x07, 0xb6, 0x4e, 0xc3, 0x8c, 0xdf, 0xdd, + 0x31, 0xc6, 0x61, 0x68, 0xa9, 0x88, 0x19, 0x87, 0x80, 0x4c, 0x4a, 0xe3, 0xb0, 0x35, 0x86, 0xa5, + 0x5f, 0x18, 0x59, 0x9a, 0xe8, 0x62, 0x0b, 0x29, 0x0d, 0xe7, 0xa1, 0x93, 0x05, 0x9d, 0xab, 0x99, + 0x76, 0xbe, 0x31, 0x7a, 0xb2, 0x18, 0x44, 0xad, 0x35, 0x6f, 0x37, 0x84, 0x69, 0xe5, 0xaf, 0x0a, + 0x70, 0x8d, 0xf5, 0x01, 0xba, 0x16, 0xdc, 0x57, 0xfc, 0xa5, 0xfc, 0x10, 0x24, 0xbf, 0x4f, 0xc5, + 0xbf, 0x7f, 0xfe, 0x95, 0x67, 0xef, 0x8d, 0x6f, 0xab, 0xe3, 0xf2, 0x11, 0x65, 0x74, 0x18, 0x78, + 0x59, 0x7a, 0x30, 0x52, 0x19, 0x51, 0xc0, 0x45, 0x94, 0xc1, 0x79, 0xca, 0xb3, 0x7c, 0xb7, 0xd3, + 0x3f, 0xd9, 0x58, 0x14, 0xc5, 0xcd, 0x4c, 0xf6, 0xb2, 0xb8, 0xb4, 0x99, 0xc9, 0x5e, 0x11, 0x97, + 0x37, 0x33, 0xd9, 0xab, 0xe2, 0x5b, 0x9b, 0x99, 0xec, 0xaa, 0x78, 0x6d, 0x33, 0x93, 0x95, 0xc4, + 0x1b, 0xd2, 0xef, 0x5d, 0x81, 0x79, 0x0f, 0xfb, 0x30, 0x5c, 0xf3, 0x20, 0x8c, 0x6b, 0x56, 0x46, + 0xe1, 0x1a, 0x8e, 0x96, 0x38, 0xb0, 0x79, 0x10, 0x06, 0x36, 0x2b, 0xa3, 0x80, 0x4d, 0xc0, 0x43, + 0x90, 0x4d, 0x73, 0x14, 0xb2, 0xb9, 0x3b, 0x01, 0xb2, 0xf1, 0x45, 0x0d, 0x42, 0x9b, 0x8d, 0x61, + 0x68, 0xf3, 0xce, 0x78, 0x68, 0xe3, 0x8b, 0x0a, 0x61, 0x9b, 0x8f, 0x06, 0xb0, 0xcd, 0xf5, 0x31, + 0xd8, 0xc6, 0xe7, 0xf7, 0xc0, 0xcd, 0x56, 0x2c, 0xb8, 0xb9, 0x75, 0x16, 0xb8, 0xf1, 0xe5, 0x44, + 0xd0, 0x4d, 0x2d, 0x0e, 0xdd, 0xdc, 0x3c, 0x03, 0xdd, 0xf8, 0xa2, 0xc2, 0xf0, 0x66, 0x2b, 0x16, + 0xde, 0xdc, 0x3a, 0x0b, 0xde, 0x04, 0xc5, 0x0a, 0xe3, 0x9b, 0x6f, 0x45, 0xf0, 0xcd, 0xea, 0x48, + 0x7c, 0xe3, 0x73, 0x33, 0x80, 0xf3, 0xf1, 0x20, 0xc0, 0xb9, 0x3e, 0x06, 0xe0, 0x04, 0x8a, 0xe5, + 0x08, 0xa7, 0x16, 0x87, 0x70, 0x6e, 0x9e, 0x81, 0x70, 0x02, 0x5d, 0x84, 0x20, 0xce, 0x4e, 0x3c, + 0xc4, 0xb9, 0x7d, 0x26, 0xc4, 0xf1, 0xa5, 0x45, 0x31, 0x4e, 0x2d, 0x0e, 0xe3, 0xdc, 0x3c, 0x03, + 0xe3, 0x0c, 0x94, 0x8c, 0x81, 0x1c, 0x75, 0x2c, 0xc8, 0x79, 0x77, 0x42, 0x90, 0xe3, 0x8b, 0x8e, + 0x43, 0x39, 0xfa, 0x78, 0x94, 0x53, 0x9a, 0x14, 0xe5, 0xf8, 0x2f, 0x89, 0x85, 0x39, 0xea, 0x58, + 0x98, 0xf3, 0xee, 0x84, 0x30, 0x67, 0xa0, 0x22, 0x51, 0x9c, 0xb3, 0x13, 0x8f, 0x73, 0x6e, 0x9f, + 0x89, 0x73, 0x82, 0x56, 0x8c, 0x00, 0x9d, 0xb5, 0x10, 0xd0, 0x79, 0x7b, 0x04, 0xd0, 0xf1, 0x59, + 0x09, 0xd2, 0xf9, 0xe5, 0x21, 0xa4, 0x23, 0x8d, 0x43, 0x3a, 0x3e, 0xaf, 0x0f, 0x75, 0x6a, 0x71, + 0x50, 0xe7, 0xe6, 0x19, 0x50, 0x27, 0xe8, 0x37, 0x21, 0xac, 0xf3, 0x6c, 0x04, 0xd6, 0xb9, 0x73, + 0x36, 0xd6, 0xf1, 0xe5, 0x0d, 0x80, 0x1d, 0x75, 0x2c, 0xd8, 0x79, 0x77, 0x42, 0xb0, 0x13, 0xb4, + 0x60, 0x0c, 0xda, 0xf9, 0x20, 0x8a, 0x76, 0xae, 0x8d, 0x46, 0x3b, 0xbe, 0x18, 0x0e, 0x77, 0xb6, + 0x62, 0xe1, 0xce, 0xad, 0xb3, 0xe0, 0x4e, 0x60, 0xcd, 0xc2, 0x78, 0x67, 0x27, 0x1e, 0xef, 0xdc, + 0x3e, 0x13, 0xef, 0x04, 0x1d, 0x29, 0x02, 0x78, 0xb6, 0x62, 0x01, 0xcf, 0xad, 0xb3, 0x00, 0xcf, + 0x80, 0xa9, 0xe5, 0x88, 0xe7, 0xc5, 0x48, 0xc4, 0x73, 0x6f, 0x12, 0xc4, 0xe3, 0x0b, 0x1d, 0x82, + 0x3c, 0x9f, 0x8d, 0x86, 0x3c, 0xbf, 0x70, 0x8e, 0xdb, 0x21, 0x63, 0x31, 0xcf, 0x2f, 0x0f, 0x61, + 0x1e, 0x69, 0x1c, 0xe6, 0x09, 0x46, 0x86, 0x07, 0x7a, 0xaa, 0x31, 0x10, 0xe5, 0x9d, 0xf1, 0x10, + 0x25, 0x98, 0xc8, 0x03, 0x8c, 0xf2, 0xd1, 0x00, 0x46, 0xb9, 0x7e, 0x66, 0x20, 0x56, 0x08, 0xa4, + 0x94, 0x87, 0x41, 0xca, 0x8d, 0xb1, 0x20, 0xc5, 0x97, 0x10, 0xa0, 0x94, 0xad, 0x58, 0x94, 0x72, + 0xeb, 0x2c, 0x94, 0x12, 0x74, 0x85, 0x30, 0x4c, 0xd9, 0x89, 0x87, 0x29, 0xb7, 0xcf, 0x84, 0x29, + 0x03, 0xd3, 0x96, 0x87, 0x53, 0x6a, 0x71, 0x38, 0xe5, 0xe6, 0x19, 0x38, 0x25, 0x3c, 0x6d, 0xf9, + 0x40, 0xa5, 0x39, 0x0a, 0xa8, 0xdc, 0x9d, 0x00, 0xa8, 0x04, 0xce, 0xdc, 0x00, 0x52, 0xf9, 0x64, + 0x10, 0xa9, 0x48, 0xe3, 0x90, 0x4a, 0xd0, 0x89, 0x3c, 0xa8, 0xb2, 0x13, 0x0f, 0x55, 0x6e, 0x9f, + 0x09, 0x55, 0xc2, 0xe3, 0x3a, 0x84, 0x55, 0x3e, 0x19, 0xc4, 0x2a, 0xd2, 0x38, 0xac, 0x12, 0x94, + 0xc7, 0x03, 0x2b, 0xb5, 0x38, 0xb0, 0x72, 0xf3, 0x0c, 0xb0, 0x12, 0x32, 0xf7, 0x01, 0x5a, 0xf9, + 0x6b, 0x93, 0xa3, 0x95, 0x0f, 0xde, 0x34, 0x4e, 0xe6, 0x6c, 0xb8, 0xf2, 0xc9, 0x20, 0x5c, 0x91, + 0xc6, 0xc1, 0x95, 0x40, 0x1f, 0xe7, 0xc6, 0x2b, 0x6f, 0x89, 0x6f, 0x47, 0x50, 0xcb, 0x9f, 0xcc, + 0xc0, 0x0c, 0xff, 0x52, 0x51, 0xe4, 0x76, 0x1f, 0xe1, 0x4d, 0x6e, 0xf7, 0x41, 0x1b, 0xa4, 0x9b, + 0x51, 0xb7, 0xe5, 0xec, 0x3b, 0xe1, 0x86, 0x6f, 0x2d, 0xe3, 0xac, 0x6f, 0x70, 0xcc, 0x16, 0x7d, + 0x0b, 0xe6, 0x7b, 0x0e, 0xb6, 0x95, 0xae, 0x6d, 0x58, 0xb6, 0xe1, 0xb2, 0x03, 0x03, 0x42, 0x59, + 0xfc, 0xf2, 0x74, 0x75, 0x6e, 0xcf, 0xc1, 0xf6, 0x2e, 0xa7, 0xcb, 0x73, 0xbd, 0xd0, 0x93, 0xf7, + 0x71, 0xa6, 0xe9, 0xc9, 0x3f, 0xce, 0xf4, 0x0c, 0x44, 0xba, 0x1d, 0x1c, 0xb6, 0xf4, 0xec, 0x26, + 0x9d, 0xf8, 0x49, 0x49, 0xd5, 0x43, 0xc6, 0x9c, 0xde, 0xa8, 0x53, 0xb4, 0xa3, 0x44, 0xd4, 0x00, + 0x7a, 0xc7, 0x85, 0xd2, 0xb5, 0xda, 0x86, 0xd6, 0xa7, 0x13, 0x78, 0xf4, 0x56, 0xe1, 0xb1, 0x77, + 0x7b, 0xbf, 0x50, 0x0d, 0x77, 0x97, 0x72, 0xca, 0xf0, 0xca, 0xff, 0x8d, 0xee, 0xc3, 0xc5, 0x8e, + 0x7a, 0x42, 0xaf, 0x5b, 0x55, 0xbc, 0x19, 0x99, 0x5e, 0x30, 0xc5, 0x3e, 0xd3, 0x84, 0x3a, 0xea, + 0x09, 0xfd, 0x7c, 0x14, 0x4b, 0xa2, 0xdf, 0x7e, 0xb8, 0x0e, 0x73, 0x3c, 0x70, 0x9b, 0x7d, 0x1a, + 0xa6, 0x48, 0x73, 0xf2, 0xef, 0x04, 0xb0, 0xaf, 0xc3, 0xdc, 0x84, 0x82, 0x6e, 0x38, 0xae, 0x61, + 0x6a, 0x2e, 0xbf, 0xc9, 0x95, 0xdd, 0x85, 0x3a, 0xef, 0x51, 0xd9, 0x75, 0xad, 0x4d, 0x58, 0xd0, + 0xda, 0x86, 0xef, 0xe7, 0xb0, 0x99, 0x67, 0x61, 0x64, 0xbf, 0xae, 0xd0, 0xbc, 0x83, 0x9b, 0xa3, + 0x45, 0x2d, 0x4a, 0x46, 0x15, 0x28, 0xb6, 0x54, 0x17, 0xbf, 0x52, 0xfb, 0x8a, 0x77, 0x2e, 0x29, + 0x4f, 0xcf, 0x62, 0x5e, 0x7d, 0x7d, 0xba, 0x3a, 0xff, 0x98, 0x25, 0x0d, 0x1d, 0x4f, 0x9a, 0x6f, + 0x85, 0x12, 0x74, 0x74, 0x1b, 0x8a, 0xaa, 0xd3, 0x37, 0x35, 0xda, 0x80, 0xd8, 0x74, 0x7a, 0x0e, + 0x75, 0x53, 0xb3, 0x72, 0x81, 0x92, 0x2b, 0x1e, 0x15, 0x7d, 0x04, 0xcb, 0xfc, 0xc2, 0xf6, 0x57, + 0xaa, 0xad, 0x2b, 0xb4, 0xd1, 0x83, 0xe1, 0x21, 0x52, 0x9e, 0xcb, 0xec, 0x82, 0x76, 0x92, 0x81, + 0xb4, 0x74, 0xf8, 0x22, 0x54, 0x76, 0xd1, 0x2b, 0x88, 0xf9, 0xcd, 0x4c, 0x76, 0x4e, 0x9c, 0xdf, + 0xcc, 0x64, 0x0b, 0x62, 0x51, 0xfa, 0x37, 0x02, 0x14, 0x89, 0xc5, 0x70, 0x1c, 0xc3, 0x32, 0x6b, + 0x7e, 0x88, 0xa0, 0xdf, 0x6b, 0x05, 0x7a, 0x44, 0xc4, 0x7f, 0x46, 0xab, 0xf4, 0x28, 0x0e, 0xf1, + 0xcc, 0xfc, 0xcf, 0x34, 0xa4, 0x65, 0x60, 0x24, 0x7a, 0x28, 0x62, 0x1d, 0x66, 0x1c, 0xab, 0x67, + 0x6b, 0xde, 0xe5, 0xe1, 0x77, 0x47, 0x98, 0xa8, 0xd0, 0x0b, 0x4b, 0x0d, 0xca, 0x20, 0x73, 0x46, + 0xa9, 0x04, 0x33, 0x8c, 0x82, 0x72, 0x30, 0xfd, 0xb4, 0x59, 0xab, 0xca, 0xe2, 0x14, 0x9a, 0x83, + 0xec, 0x23, 0xf9, 0xe9, 0xb6, 0xd2, 0x78, 0xf6, 0x44, 0x14, 0x50, 0x1e, 0x66, 0xe5, 0xa7, 0x4f, + 0x9b, 0xca, 0xd6, 0x73, 0x31, 0x25, 0xfd, 0xb1, 0x00, 0x73, 0x65, 0x76, 0x7b, 0x3a, 0xdb, 0xa7, + 0xfe, 0x68, 0x60, 0x53, 0xf8, 0x4a, 0x3c, 0x6a, 0x88, 0xdf, 0xa0, 0x5e, 0x87, 0x2c, 0xef, 0x9e, + 0x5e, 0x84, 0xf7, 0xea, 0x68, 0x5f, 0x91, 0x2e, 0xab, 0x78, 0x51, 0x3a, 0x1e, 0x1b, 0x6a, 0x80, + 0xa8, 0x7a, 0x55, 0x54, 0x78, 0x49, 0x46, 0xc7, 0xea, 0x0c, 0x68, 0xc3, 0xeb, 0x6c, 0x6a, 0x94, + 0xfc, 0x61, 0xe6, 0x8b, 0x1f, 0xae, 0x4e, 0x49, 0x7f, 0x96, 0x81, 0xf9, 0x72, 0xf8, 0xa6, 0x78, + 0x54, 0x1f, 0xa8, 0x6c, 0xdc, 0x0c, 0x18, 0xe1, 0x28, 0x8d, 0xf9, 0x06, 0x47, 0x2e, 0xb8, 0x96, + 0x9e, 0xd5, 0xfd, 0xda, 0x98, 0xfd, 0xf4, 0x70, 0xe5, 0x03, 0xc6, 0xe5, 0x7f, 0x9f, 0xf6, 0x0d, + 0x78, 0x09, 0xa6, 0xd9, 0x29, 0x22, 0x61, 0xe8, 0x80, 0x33, 0x35, 0x21, 0xc4, 0x43, 0x23, 0xe9, + 0x32, 0xcb, 0x46, 0x0c, 0x7e, 0xf3, 0x8d, 0xae, 0x73, 0x0b, 0xe6, 0xad, 0xf3, 0x7f, 0xdd, 0xae, + 0xc7, 0xae, 0xf3, 0xfb, 0x7f, 0x18, 0x1e, 0x44, 0xde, 0x87, 0x7e, 0x0d, 0x8a, 0x9a, 0xd5, 0x6e, + 0xb3, 0x89, 0x9d, 0x99, 0xae, 0xe1, 0x0b, 0x3e, 0x68, 0x11, 0xf8, 0x17, 0x0f, 0x4b, 0xfe, 0x97, + 0x0f, 0x4b, 0x32, 0xff, 0xf2, 0x61, 0x28, 0x76, 0xbb, 0xe0, 0x0b, 0x63, 0x16, 0x6f, 0x20, 0x8c, + 0x7c, 0xf6, 0x4d, 0xc2, 0xc8, 0x59, 0xf0, 0x3d, 0xef, 0x79, 0x7f, 0x20, 0xf0, 0x20, 0x9e, 0x27, + 0x96, 0x75, 0xd4, 0xf3, 0x03, 0xbf, 0x97, 0xc3, 0x97, 0xf3, 0x05, 0x11, 0xae, 0xf4, 0x84, 0x46, + 0xdc, 0xd4, 0x94, 0xfa, 0x6a, 0x53, 0xd3, 0x75, 0x98, 0xeb, 0xda, 0xf8, 0x00, 0xbb, 0xda, 0xa1, + 0x62, 0xf6, 0x3a, 0xfc, 0x78, 0x4a, 0xde, 0xa3, 0xed, 0xf4, 0x3a, 0xe8, 0x2e, 0x88, 0x7e, 0x16, + 0x0e, 0xb6, 0xbc, 0x9b, 0xa1, 0x3c, 0x3a, 0x87, 0x66, 0xd2, 0xff, 0x14, 0x60, 0x31, 0x52, 0x27, + 0x3e, 0xa6, 0x36, 0x21, 0xaf, 0xfb, 0xce, 0x80, 0xb3, 0x24, 0x9c, 0x33, 0xf6, 0x39, 0xcc, 0x8c, + 0x14, 0xb8, 0xe4, 0xbd, 0x96, 0x5e, 0xe5, 0x1e, 0x88, 0x4d, 0x9d, 0x53, 0xec, 0xc5, 0x40, 0xce, + 0x46, 0xe8, 0x05, 0xfe, 0x20, 0x4b, 0x4f, 0x34, 0xc8, 0xa4, 0xff, 0x25, 0x80, 0x48, 0x5f, 0xf0, + 0x08, 0x63, 0x3d, 0x11, 0x93, 0xe9, 0x1d, 0x32, 0x48, 0x4d, 0x7e, 0x00, 0x25, 0xf2, 0xf9, 0x89, + 0xf4, 0xc0, 0xe7, 0x27, 0xe2, 0xec, 0x67, 0xe6, 0x2b, 0xda, 0x4f, 0xe9, 0x87, 0x02, 0x14, 0xfc, + 0x6a, 0xb3, 0xef, 0xce, 0x8d, 0xb9, 0x58, 0xf2, 0xcd, 0xbe, 0xad, 0xe6, 0x5d, 0x80, 0x31, 0xd1, + 0xa7, 0xf0, 0xc2, 0x17, 0x60, 0xb0, 0x6f, 0x82, 0xfd, 0x6d, 0xaf, 0x3b, 0x92, 0x22, 0x56, 0x82, + 0x9b, 0x07, 0xde, 0xe0, 0x80, 0x8f, 0x4c, 0x3f, 0xd9, 0x69, 0xb5, 0x8f, 0xd9, 0x9d, 0x25, 0x13, + 0xd9, 0x52, 0xc4, 0xe3, 0xe1, 0x80, 0xaf, 0xf5, 0xe8, 0xcd, 0x06, 0xfd, 0x98, 0x27, 0xfb, 0xed, + 0x48, 0x8f, 0x42, 0x0a, 0xa4, 0x3d, 0x8a, 0x68, 0x69, 0x22, 0xfb, 0xee, 0x69, 0x89, 0x75, 0xc0, + 0x1f, 0x87, 0x5b, 0x82, 0x9d, 0x5c, 0x7d, 0x08, 0xe9, 0x63, 0xb5, 0x3d, 0x2e, 0x86, 0x2b, 0xd2, + 0x72, 0x32, 0xc9, 0x8d, 0x1e, 0x45, 0x2e, 0x6c, 0x48, 0x8d, 0x5e, 0x88, 0x19, 0x56, 0x69, 0xe4, + 0x62, 0x87, 0xf7, 0xa3, 0x03, 0x68, 0xec, 0xeb, 0xc3, 0x23, 0xe9, 0xc3, 0xcc, 0x8f, 0x7e, 0xb8, + 0x2a, 0x48, 0x1f, 0x03, 0x92, 0xb1, 0x83, 0xdd, 0x67, 0x3d, 0xcb, 0x0e, 0x2e, 0xbf, 0x18, 0x3c, + 0x4c, 0x30, 0x1d, 0x7f, 0x98, 0x40, 0xba, 0x08, 0x8b, 0x11, 0x6e, 0x66, 0x81, 0xa4, 0xf7, 0xe1, + 0xca, 0x63, 0xcb, 0x71, 0x8c, 0x2e, 0x81, 0x9c, 0x74, 0xa8, 0x93, 0xf9, 0xca, 0xb7, 0xb9, 0xd9, + 0x2e, 0x45, 0xf9, 0x26, 0xb3, 0x4d, 0x39, 0xd9, 0x7f, 0x96, 0xfe, 0xb5, 0x00, 0x97, 0x87, 0x39, + 0x99, 0x96, 0xe3, 0xce, 0x23, 0xce, 0x6a, 0x56, 0x70, 0x37, 0xdb, 0xd9, 0xbd, 0xd5, 0xcb, 0x4e, + 0xdc, 0x56, 0xfe, 0x4e, 0xa5, 0xa3, 0x52, 0x9b, 0xc4, 0x8f, 0x0a, 0x17, 0x38, 0x79, 0x9b, 0x51, + 0x03, 0xf3, 0x94, 0x99, 0xcc, 0x3c, 0x7d, 0x37, 0x0d, 0x88, 0x1e, 0x88, 0x2f, 0xd3, 0x13, 0xe5, + 0x5e, 0x9d, 0xff, 0x12, 0xac, 0x90, 0x69, 0xa4, 0xd7, 0xa1, 0xf5, 0x51, 0x1c, 0xc3, 0xd4, 0x30, + 0x8b, 0xca, 0xe4, 0x6e, 0x17, 0xef, 0x3c, 0x71, 0x67, 0x0f, 0x87, 0xc5, 0x95, 0x2a, 0x81, 0x2c, + 0x5e, 0xb3, 0xab, 0x21, 0xf1, 0x0d, 0x22, 0xfd, 0x89, 0xea, 0x78, 0xd9, 0x97, 0xff, 0x54, 0x80, + 0x7c, 0x88, 0x05, 0x15, 0x21, 0x6d, 0x2b, 0x3d, 0xfa, 0x4a, 0x41, 0x4e, 0xd9, 0x7b, 0xe8, 0x06, + 0xcc, 0xd3, 0xa9, 0x2e, 0xe4, 0x3a, 0x0a, 0x77, 0x32, 0x32, 0x8d, 0xd4, 0x95, 0x3d, 0xbf, 0xf0, + 0x6d, 0x00, 0x9a, 0x89, 0xa1, 0x99, 0x34, 0xcd, 0x91, 0x23, 0x14, 0x1f, 0xcb, 0xd0, 0x93, 0x0f, + 0x81, 0x10, 0x16, 0xdc, 0x3c, 0x4f, 0xa9, 0xbe, 0x94, 0x55, 0xc8, 0xb3, 0x6c, 0x4c, 0xcc, 0x34, + 0xcd, 0x03, 0x94, 0xc4, 0xe4, 0x54, 0x60, 0xd1, 0x79, 0xd9, 0x56, 0xba, 0x96, 0xae, 0x68, 0xdd, + 0x1e, 0x0f, 0x1a, 0x65, 0x1f, 0xd6, 0x14, 0xe8, 0x95, 0x09, 0x62, 0xe3, 0xd9, 0x93, 0x5d, 0x4b, + 0xaf, 0xec, 0xee, 0xb1, 0x88, 0x51, 0x47, 0x16, 0x9d, 0x97, 0x6d, 0x42, 0xe9, 0xf6, 0x38, 0x85, + 0xf4, 0xcb, 0x88, 0xda, 0x78, 0xbf, 0x6c, 0x42, 0x71, 0xd3, 0x32, 0x4c, 0x82, 0x5d, 0xbc, 0x96, + 0x59, 0x87, 0xc2, 0xbe, 0x61, 0xaa, 0x76, 0x5f, 0xf1, 0x02, 0x3b, 0x85, 0xb3, 0x02, 0x3b, 0xe5, + 0x79, 0xc6, 0xc1, 0x1f, 0xa5, 0x9f, 0x0a, 0x20, 0x06, 0x62, 0xf9, 0x24, 0xfc, 0x0d, 0x00, 0xad, + 0xdd, 0x73, 0x5c, 0x6c, 0x7b, 0x63, 0x68, 0x8e, 0x1d, 0x20, 0xa9, 0x30, 0x6a, 0x7d, 0x43, 0xce, + 0xf1, 0x0c, 0x75, 0x1d, 0xdd, 0x88, 0xde, 0x0d, 0x31, 0x5d, 0x86, 0xd7, 0x43, 0x37, 0x42, 0x90, + 0x41, 0xe9, 0xb8, 0x96, 0xed, 0xe3, 0x78, 0x3e, 0x28, 0xbd, 0x5b, 0x73, 0xe8, 0xe9, 0x70, 0x4c, + 0xcf, 0x88, 0x15, 0x88, 0x87, 0x78, 0x8c, 0xfd, 0x2a, 0x65, 0xce, 0xae, 0x12, 0xe3, 0xf0, 0xaa, + 0xf4, 0xcf, 0x05, 0x28, 0x56, 0xd8, 0x58, 0xf1, 0xc7, 0xdf, 0x98, 0xf9, 0x66, 0x03, 0xb2, 0xee, + 0x89, 0xa9, 0x74, 0xb0, 0xff, 0xa1, 0x97, 0x73, 0x5c, 0x6b, 0x37, 0xeb, 0xb2, 0x47, 0xfa, 0xed, + 0x40, 0xfe, 0x65, 0x6b, 0x6e, 0xcc, 0xae, 0x94, 0xd8, 0xa7, 0xad, 0x4b, 0xde, 0xa7, 0xad, 0x4b, + 0x1b, 0x3c, 0x03, 0x9b, 0xc7, 0xbf, 0xf8, 0xcf, 0xab, 0x82, 0xec, 0x33, 0x31, 0x57, 0xef, 0x5e, + 0x83, 0xd8, 0xa4, 0x21, 0x67, 0x0c, 0x15, 0x00, 0x42, 0x5f, 0xf0, 0xe1, 0xdf, 0x4a, 0x5e, 0xdf, + 0x50, 0xf6, 0x76, 0x2a, 0x4f, 0xb7, 0xb7, 0xeb, 0xcd, 0x66, 0x75, 0x43, 0x14, 0x90, 0x08, 0x73, + 0x91, 0xef, 0xff, 0xa4, 0xd8, 0xd7, 0x93, 0xef, 0xfd, 0x05, 0x80, 0xe0, 0x53, 0x62, 0x44, 0xd6, + 0x56, 0xf5, 0x53, 0xe5, 0xf9, 0xfa, 0x93, 0xbd, 0x6a, 0x43, 0x9c, 0x42, 0x08, 0x0a, 0xe5, 0xf5, + 0x66, 0xa5, 0xa6, 0xc8, 0xd5, 0xc6, 0xee, 0xd3, 0x9d, 0x46, 0xd5, 0xfb, 0xea, 0xf2, 0xbd, 0x0d, + 0x98, 0x0b, 0x5f, 0xd6, 0x83, 0x16, 0xa1, 0x58, 0xa9, 0x55, 0x2b, 0x5b, 0xca, 0xf3, 0xfa, 0xba, + 0xf2, 0x6c, 0xaf, 0xba, 0x57, 0x15, 0xa7, 0x68, 0xd1, 0x28, 0xf1, 0xd1, 0xde, 0x13, 0x82, 0x0f, + 0x8b, 0x90, 0x67, 0xcf, 0xf4, 0x5b, 0x41, 0x62, 0xea, 0xde, 0x36, 0xe4, 0x43, 0x97, 0x08, 0x93, + 0xd7, 0xed, 0xee, 0x35, 0x6a, 0x4a, 0xb3, 0xbe, 0x5d, 0x6d, 0x34, 0xd7, 0xb7, 0x77, 0x99, 0x0c, + 0x4a, 0x5b, 0x2f, 0x3f, 0x95, 0x9b, 0xa2, 0xe0, 0x3f, 0x37, 0x9f, 0xee, 0x55, 0x6a, 0x5e, 0x35, + 0xa4, 0x4c, 0x36, 0x2d, 0xa6, 0xef, 0x9d, 0xc0, 0xe5, 0x11, 0xf7, 0xd6, 0x10, 0x68, 0xba, 0x67, + 0xd2, 0x0b, 0x55, 0xc5, 0x29, 0x34, 0x0f, 0x39, 0xd2, 0xf5, 0xe8, 0xa9, 0x56, 0x51, 0x40, 0x59, + 0xc8, 0x1c, 0xba, 0x6e, 0x57, 0x4c, 0xa1, 0x19, 0x48, 0x39, 0x0f, 0xc5, 0x34, 0xf9, 0xdf, 0x72, + 0xc4, 0x0c, 0x41, 0xba, 0xea, 0xe7, 0x3d, 0x1b, 0x8b, 0xd3, 0x04, 0xe9, 0xf6, 0x1c, 0x6c, 0x1f, + 0x18, 0x6d, 0x2c, 0xce, 0x12, 0x16, 0xb3, 0xd7, 0x6e, 0x8b, 0x59, 0x29, 0x93, 0x9d, 0x11, 0x67, + 0xee, 0x5d, 0x87, 0xd0, 0xf5, 0x01, 0x08, 0x60, 0xe6, 0x89, 0xea, 0x62, 0xc7, 0x15, 0xa7, 0xd0, + 0x2c, 0xa4, 0xd7, 0xdb, 0x6d, 0x51, 0x78, 0xf0, 0xc5, 0x34, 0x64, 0xbd, 0x4f, 0xe1, 0xa0, 0x27, + 0x30, 0x4d, 0xd1, 0x1f, 0x5a, 0x1d, 0x8d, 0x0b, 0x99, 0x8d, 0xbb, 0x76, 0x16, 0x70, 0x94, 0xa6, + 0xd0, 0x5f, 0x84, 0x7c, 0xc8, 0x5f, 0x46, 0x23, 0xd7, 0x37, 0x23, 0x18, 0x61, 0xf9, 0xd6, 0x59, + 0xd9, 0x7c, 0xf9, 0x2f, 0x20, 0xe7, 0x4f, 0xb5, 0xe8, 0xc6, 0xb8, 0x89, 0xd8, 0x93, 0x3d, 0x7e, + 0xb6, 0x26, 0xc3, 0x4e, 0x9a, 0x7a, 0x4f, 0x40, 0x36, 0xa0, 0xe1, 0x59, 0x11, 0xc5, 0x45, 0xf5, + 0x8d, 0x9c, 0x76, 0x97, 0xef, 0x4d, 0x94, 0x3b, 0x78, 0x27, 0x51, 0x56, 0x30, 0xb5, 0xc7, 0x2b, + 0x6b, 0xc8, 0x71, 0x88, 0x57, 0x56, 0x8c, 0x87, 0x40, 0x1b, 0x23, 0x64, 0xa2, 0x63, 0xe5, 0x0f, + 0xcf, 0x7c, 0xb1, 0xf2, 0xe3, 0x2c, 0xfd, 0x14, 0x7a, 0x06, 0x19, 0x62, 0x94, 0x51, 0x9c, 0xd3, + 0x3d, 0x30, 0x09, 0x2c, 0xdf, 0x18, 0x9b, 0xc7, 0x13, 0x59, 0xbe, 0xfb, 0xa3, 0xff, 0xb2, 0x32, + 0xf5, 0xa3, 0xd7, 0x2b, 0xc2, 0x4f, 0x5f, 0xaf, 0x08, 0x7f, 0xf8, 0x7a, 0x45, 0xf8, 0xa3, 0xd7, + 0x2b, 0xc2, 0xf7, 0x7f, 0xb6, 0x32, 0xf5, 0xd3, 0x9f, 0xad, 0x4c, 0xfd, 0xe1, 0xcf, 0x56, 0xa6, + 0x3e, 0x9b, 0xe5, 0xdc, 0xfb, 0x33, 0xd4, 0x62, 0x3d, 0xfc, 0xbf, 0x01, 0x00, 0x00, 0xff, 0xff, + 0x72, 0xa5, 0xc9, 0x41, 0x13, 0x81, 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. @@ -7662,6 +7781,9 @@ type InternalClient interface { RangeFeed(ctx context.Context, in *RangeFeedRequest, opts ...grpc.CallOption) (Internal_RangeFeedClient, error) GossipSubscription(ctx context.Context, in *GossipSubscriptionRequest, opts ...grpc.CallOption) (Internal_GossipSubscriptionClient, error) ResetQuorum(ctx context.Context, in *ResetQuorumRequest, opts ...grpc.CallOption) (*ResetQuorumResponse, error) + // TokenBucket is used by tenants to obtain Request Units and report + // consumption. + TokenBucket(ctx context.Context, in *TokenBucketRequest, opts ...grpc.CallOption) (*TokenBucketResponse, error) // Join a bootstrapped cluster. If the target node is itself not part of a // bootstrapped cluster, an appropriate error is returned. Join(ctx context.Context, in *JoinNodeRequest, opts ...grpc.CallOption) (*JoinNodeResponse, error) @@ -7766,6 +7888,15 @@ func (c *internalClient) ResetQuorum(ctx context.Context, in *ResetQuorumRequest return out, nil } +func (c *internalClient) TokenBucket(ctx context.Context, in *TokenBucketRequest, opts ...grpc.CallOption) (*TokenBucketResponse, error) { + out := new(TokenBucketResponse) + err := c.cc.Invoke(ctx, "/cockroach.roachpb.Internal/TokenBucket", in, out, opts...) + if err != nil { + return nil, err + } + return out, nil +} + func (c *internalClient) Join(ctx context.Context, in *JoinNodeRequest, opts ...grpc.CallOption) (*JoinNodeResponse, error) { out := new(JoinNodeResponse) err := c.cc.Invoke(ctx, "/cockroach.roachpb.Internal/Join", in, out, opts...) @@ -7782,6 +7913,9 @@ type InternalServer interface { RangeFeed(*RangeFeedRequest, Internal_RangeFeedServer) error GossipSubscription(*GossipSubscriptionRequest, Internal_GossipSubscriptionServer) error ResetQuorum(context.Context, *ResetQuorumRequest) (*ResetQuorumResponse, error) + // TokenBucket is used by tenants to obtain Request Units and report + // consumption. + TokenBucket(context.Context, *TokenBucketRequest) (*TokenBucketResponse, error) // Join a bootstrapped cluster. If the target node is itself not part of a // bootstrapped cluster, an appropriate error is returned. Join(context.Context, *JoinNodeRequest) (*JoinNodeResponse, error) @@ -7806,6 +7940,9 @@ func (*UnimplementedInternalServer) GossipSubscription(req *GossipSubscriptionRe func (*UnimplementedInternalServer) ResetQuorum(ctx context.Context, req *ResetQuorumRequest) (*ResetQuorumResponse, error) { return nil, status.Errorf(codes.Unimplemented, "method ResetQuorum not implemented") } +func (*UnimplementedInternalServer) TokenBucket(ctx context.Context, req *TokenBucketRequest) (*TokenBucketResponse, error) { + return nil, status.Errorf(codes.Unimplemented, "method TokenBucket not implemented") +} func (*UnimplementedInternalServer) Join(ctx context.Context, req *JoinNodeRequest) (*JoinNodeResponse, error) { return nil, status.Errorf(codes.Unimplemented, "method Join not implemented") } @@ -7910,6 +8047,24 @@ func _Internal_ResetQuorum_Handler(srv interface{}, ctx context.Context, dec fun return interceptor(ctx, in, info, handler) } +func _Internal_TokenBucket_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) { + in := new(TokenBucketRequest) + if err := dec(in); err != nil { + return nil, err + } + if interceptor == nil { + return srv.(InternalServer).TokenBucket(ctx, in) + } + info := &grpc.UnaryServerInfo{ + Server: srv, + FullMethod: "/cockroach.roachpb.Internal/TokenBucket", + } + handler := func(ctx context.Context, req interface{}) (interface{}, error) { + return srv.(InternalServer).TokenBucket(ctx, req.(*TokenBucketRequest)) + } + return interceptor(ctx, in, info, handler) +} + func _Internal_Join_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) { in := new(JoinNodeRequest) if err := dec(in); err != nil { @@ -7944,6 +8099,10 @@ var _Internal_serviceDesc = grpc.ServiceDesc{ MethodName: "ResetQuorum", Handler: _Internal_ResetQuorum_Handler, }, + { + MethodName: "TokenBucket", + Handler: _Internal_TokenBucket_Handler, + }, { MethodName: "Join", Handler: _Internal_Join_Handler, @@ -15984,6 +16143,117 @@ func (m *GossipSubscriptionEvent) MarshalToSizedBuffer(dAtA []byte) (int, error) return len(dAtA) - i, nil } +func (m *TokenBucketRequest) 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 *TokenBucketRequest) MarshalTo(dAtA []byte) (int, error) { + size := m.Size() + return m.MarshalToSizedBuffer(dAtA[:size]) +} + +func (m *TokenBucketRequest) MarshalToSizedBuffer(dAtA []byte) (int, error) { + i := len(dAtA) + _ = i + var l int + _ = l + { + size, err := m.ConsumptionSinceLastRequest.MarshalToSizedBuffer(dAtA[:i]) + if err != nil { + return 0, err + } + i -= size + i = encodeVarintApi(dAtA, i, uint64(size)) + } + i-- + dAtA[i] = 0xa + return len(dAtA) - i, nil +} + +func (m *TokenBucketRequest_Consumption) 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 *TokenBucketRequest_Consumption) MarshalTo(dAtA []byte) (int, error) { + size := m.Size() + return m.MarshalToSizedBuffer(dAtA[:size]) +} + +func (m *TokenBucketRequest_Consumption) MarshalToSizedBuffer(dAtA []byte) (int, error) { + i := len(dAtA) + _ = i + var l int + _ = l + if m.SQLPodCPUSeconds != 0 { + i -= 8 + encoding_binary.LittleEndian.PutUint64(dAtA[i:], uint64(math.Float64bits(float64(m.SQLPodCPUSeconds)))) + i-- + dAtA[i] = 0x31 + } + if m.WriteBytes != 0 { + i = encodeVarintApi(dAtA, i, uint64(m.WriteBytes)) + i-- + dAtA[i] = 0x28 + } + if m.WriteRequests != 0 { + i = encodeVarintApi(dAtA, i, uint64(m.WriteRequests)) + i-- + dAtA[i] = 0x20 + } + if m.ReadBytes != 0 { + i = encodeVarintApi(dAtA, i, uint64(m.ReadBytes)) + i-- + dAtA[i] = 0x18 + } + if m.ReadRequests != 0 { + i = encodeVarintApi(dAtA, i, uint64(m.ReadRequests)) + i-- + dAtA[i] = 0x10 + } + if m.RU != 0 { + i -= 8 + encoding_binary.LittleEndian.PutUint64(dAtA[i:], uint64(math.Float64bits(float64(m.RU)))) + i-- + dAtA[i] = 0x9 + } + return len(dAtA) - i, nil +} + +func (m *TokenBucketResponse) 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 *TokenBucketResponse) MarshalTo(dAtA []byte) (int, error) { + size := m.Size() + return m.MarshalToSizedBuffer(dAtA[:size]) +} + +func (m *TokenBucketResponse) MarshalToSizedBuffer(dAtA []byte) (int, error) { + i := len(dAtA) + _ = i + var l int + _ = l + return len(dAtA) - i, nil +} + func (m *JoinNodeRequest) Marshal() (dAtA []byte, err error) { size := m.Size() dAtA = make([]byte, size) @@ -16091,12 +16361,12 @@ func (m *ContentionEvent) MarshalToSizedBuffer(dAtA []byte) (int, error) { _ = i var l int _ = l - n267, err267 := github_com_gogo_protobuf_types.StdDurationMarshalTo(m.Duration, dAtA[i-github_com_gogo_protobuf_types.SizeOfStdDuration(m.Duration):]) - if err267 != nil { - return 0, err267 + n268, err268 := github_com_gogo_protobuf_types.StdDurationMarshalTo(m.Duration, dAtA[i-github_com_gogo_protobuf_types.SizeOfStdDuration(m.Duration):]) + if err268 != nil { + return 0, err268 } - i -= n267 - i = encodeVarintApi(dAtA, i, uint64(n267)) + i -= n268 + i = encodeVarintApi(dAtA, i, uint64(n268)) i-- dAtA[i] = 0x1a { @@ -19320,6 +19590,53 @@ func (m *GossipSubscriptionEvent) Size() (n int) { return n } +func (m *TokenBucketRequest) Size() (n int) { + if m == nil { + return 0 + } + var l int + _ = l + l = m.ConsumptionSinceLastRequest.Size() + n += 1 + l + sovApi(uint64(l)) + return n +} + +func (m *TokenBucketRequest_Consumption) Size() (n int) { + if m == nil { + return 0 + } + var l int + _ = l + if m.RU != 0 { + n += 9 + } + if m.ReadRequests != 0 { + n += 1 + sovApi(uint64(m.ReadRequests)) + } + if m.ReadBytes != 0 { + n += 1 + sovApi(uint64(m.ReadBytes)) + } + if m.WriteRequests != 0 { + n += 1 + sovApi(uint64(m.WriteRequests)) + } + if m.WriteBytes != 0 { + n += 1 + sovApi(uint64(m.WriteBytes)) + } + if m.SQLPodCPUSeconds != 0 { + n += 9 + } + return n +} + +func (m *TokenBucketResponse) Size() (n int) { + if m == nil { + return 0 + } + var l int + _ = l + return n +} + func (m *JoinNodeRequest) Size() (n int) { if m == nil { return 0 @@ -38980,6 +39297,287 @@ func (m *GossipSubscriptionEvent) Unmarshal(dAtA []byte) error { } return nil } +func (m *TokenBucketRequest) 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 ErrIntOverflowApi + } + 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: TokenBucketRequest: wiretype end group for non-group") + } + if fieldNum <= 0 { + return fmt.Errorf("proto: TokenBucketRequest: illegal tag %d (wire type %d)", fieldNum, wire) + } + switch fieldNum { + case 1: + if wireType != 2 { + return fmt.Errorf("proto: wrong wireType = %d for field ConsumptionSinceLastRequest", wireType) + } + var msglen int + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowApi + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + msglen |= int(b&0x7F) << shift + if b < 0x80 { + break + } + } + if msglen < 0 { + return ErrInvalidLengthApi + } + postIndex := iNdEx + msglen + if postIndex < 0 { + return ErrInvalidLengthApi + } + if postIndex > l { + return io.ErrUnexpectedEOF + } + if err := m.ConsumptionSinceLastRequest.Unmarshal(dAtA[iNdEx:postIndex]); err != nil { + return err + } + iNdEx = postIndex + default: + iNdEx = preIndex + skippy, err := skipApi(dAtA[iNdEx:]) + if err != nil { + return err + } + if (skippy < 0) || (iNdEx+skippy) < 0 { + return ErrInvalidLengthApi + } + if (iNdEx + skippy) > l { + return io.ErrUnexpectedEOF + } + iNdEx += skippy + } + } + + if iNdEx > l { + return io.ErrUnexpectedEOF + } + return nil +} +func (m *TokenBucketRequest_Consumption) 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 ErrIntOverflowApi + } + 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: Consumption: wiretype end group for non-group") + } + if fieldNum <= 0 { + return fmt.Errorf("proto: Consumption: illegal tag %d (wire type %d)", fieldNum, wire) + } + switch fieldNum { + case 1: + if wireType != 1 { + return fmt.Errorf("proto: wrong wireType = %d for field RU", wireType) + } + var v uint64 + if (iNdEx + 8) > l { + return io.ErrUnexpectedEOF + } + v = uint64(encoding_binary.LittleEndian.Uint64(dAtA[iNdEx:])) + iNdEx += 8 + m.RU = float64(math.Float64frombits(v)) + case 2: + if wireType != 0 { + return fmt.Errorf("proto: wrong wireType = %d for field ReadRequests", wireType) + } + m.ReadRequests = 0 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowApi + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + m.ReadRequests |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + case 3: + if wireType != 0 { + return fmt.Errorf("proto: wrong wireType = %d for field ReadBytes", wireType) + } + m.ReadBytes = 0 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowApi + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + m.ReadBytes |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + case 4: + if wireType != 0 { + return fmt.Errorf("proto: wrong wireType = %d for field WriteRequests", wireType) + } + m.WriteRequests = 0 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowApi + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + m.WriteRequests |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + case 5: + if wireType != 0 { + return fmt.Errorf("proto: wrong wireType = %d for field WriteBytes", wireType) + } + m.WriteBytes = 0 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowApi + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + m.WriteBytes |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } + case 6: + if wireType != 1 { + return fmt.Errorf("proto: wrong wireType = %d for field SQLPodCPUSeconds", wireType) + } + var v uint64 + if (iNdEx + 8) > l { + return io.ErrUnexpectedEOF + } + v = uint64(encoding_binary.LittleEndian.Uint64(dAtA[iNdEx:])) + iNdEx += 8 + m.SQLPodCPUSeconds = float64(math.Float64frombits(v)) + default: + iNdEx = preIndex + skippy, err := skipApi(dAtA[iNdEx:]) + if err != nil { + return err + } + if (skippy < 0) || (iNdEx+skippy) < 0 { + return ErrInvalidLengthApi + } + if (iNdEx + skippy) > l { + return io.ErrUnexpectedEOF + } + iNdEx += skippy + } + } + + if iNdEx > l { + return io.ErrUnexpectedEOF + } + return nil +} +func (m *TokenBucketResponse) 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 ErrIntOverflowApi + } + 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: TokenBucketResponse: wiretype end group for non-group") + } + if fieldNum <= 0 { + return fmt.Errorf("proto: TokenBucketResponse: illegal tag %d (wire type %d)", fieldNum, wire) + } + switch fieldNum { + default: + iNdEx = preIndex + skippy, err := skipApi(dAtA[iNdEx:]) + if err != nil { + return err + } + if (skippy < 0) || (iNdEx+skippy) < 0 { + return ErrInvalidLengthApi + } + if (iNdEx + skippy) > l { + return io.ErrUnexpectedEOF + } + iNdEx += skippy + } + } + + if iNdEx > l { + return io.ErrUnexpectedEOF + } + return nil +} func (m *JoinNodeRequest) Unmarshal(dAtA []byte) error { l := len(dAtA) iNdEx := 0 diff --git a/pkg/roachpb/api.proto b/pkg/roachpb/api.proto index 5ebe6346c4d5..bc4c9e5fd546 100644 --- a/pkg/roachpb/api.proto +++ b/pkg/roachpb/api.proto @@ -23,6 +23,7 @@ import "util/hlc/timestamp.proto"; import "util/tracing/tracingpb/recorded_span.proto"; import "gogoproto/gogo.proto"; import "google/protobuf/duration.proto"; +import "google/protobuf/timestamp.proto"; // ReadConsistencyType specifies what type of consistency is observed // during read operations. @@ -2201,6 +2202,27 @@ message GossipSubscriptionEvent { kv.kvpb.Error error = 4; } +message TokenBucketRequest { + message Consumption { + double r_u = 1; + uint64 read_requests = 2; + uint64 read_bytes = 3; + uint64 write_requests = 4; + uint64 write_bytes = 5; + double sql_pod_cpu_seconds = 6 [(gogoproto.customname) = "SQLPodCPUSeconds"]; + } + + // Consumption that occurred since this node's last request. + Consumption consumption_since_last_request = 1 [(gogoproto.nullable) = false]; + + // TODO(radu): add remaining fields. +} + +message TokenBucketResponse { + // TODO(radu): add fields. +} + + // JoinNodeRequest is used to specify to the server node what the client's // binary version is. If it's not compatible with the rest of the cluster, the // join attempt is refused. @@ -2226,6 +2248,10 @@ service Internal { rpc GossipSubscription (GossipSubscriptionRequest) returns (stream GossipSubscriptionEvent) {} rpc ResetQuorum (ResetQuorumRequest) returns (ResetQuorumResponse) {} + // TokenBucket is used by tenants to obtain Request Units and report + // consumption. + rpc TokenBucket (TokenBucketRequest) returns (TokenBucketResponse) {} + // Join a bootstrapped cluster. If the target node is itself not part of a // bootstrapped cluster, an appropriate error is returned. rpc Join(JoinNodeRequest) returns (JoinNodeResponse) { } diff --git a/pkg/roachpb/mocks_generated.go b/pkg/roachpb/mocks_generated.go index d9dea81cb6a6..3fc8d811d546 100644 --- a/pkg/roachpb/mocks_generated.go +++ b/pkg/roachpb/mocks_generated.go @@ -156,6 +156,26 @@ func (mr *MockInternalClientMockRecorder) ResetQuorum(arg0, arg1 interface{}, ar return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ResetQuorum", reflect.TypeOf((*MockInternalClient)(nil).ResetQuorum), varargs...) } +// TokenBucket mocks base method. +func (m *MockInternalClient) TokenBucket(arg0 context.Context, arg1 *TokenBucketRequest, arg2 ...grpc.CallOption) (*TokenBucketResponse, error) { + m.ctrl.T.Helper() + varargs := []interface{}{arg0, arg1} + for _, a := range arg2 { + varargs = append(varargs, a) + } + ret := m.ctrl.Call(m, "TokenBucket", varargs...) + ret0, _ := ret[0].(*TokenBucketResponse) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// TokenBucket indicates an expected call of TokenBucket. +func (mr *MockInternalClientMockRecorder) TokenBucket(arg0, arg1 interface{}, arg2 ...interface{}) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]interface{}{arg0, arg1}, arg2...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "TokenBucket", reflect.TypeOf((*MockInternalClient)(nil).TokenBucket), varargs...) +} + // MockInternal_RangeFeedClient is a mock of Internal_RangeFeedClient interface. type MockInternal_RangeFeedClient struct { ctrl *gomock.Controller diff --git a/pkg/rpc/auth_tenant.go b/pkg/rpc/auth_tenant.go index ba7ecce721f9..ae2a45f0b053 100644 --- a/pkg/rpc/auth_tenant.go +++ b/pkg/rpc/auth_tenant.go @@ -52,6 +52,11 @@ func (a tenantAuthorizer) authorize( case "/cockroach.roachpb.Internal/GossipSubscription": return a.authGossipSubscription(tenID, req.(*roachpb.GossipSubscriptionRequest)) + case "/cockroach.roachpb.Internal/TokenBucket": + // No authorization required for TokenBucket; the request is inherently + // scoped to a single tenant. + return nil + case "/cockroach.rpc.Heartbeat/Ping": return nil // no authorization diff --git a/pkg/rpc/context.go b/pkg/rpc/context.go index f2c38589375e..ab1b293f5f4c 100644 --- a/pkg/rpc/context.go +++ b/pkg/rpc/context.go @@ -452,34 +452,42 @@ func (ctx *Context) GetLocalInternalClientForAddr( } type internalClientAdapter struct { - roachpb.InternalServer + server roachpb.InternalServer } // Batch implements the roachpb.InternalClient interface. func (a internalClientAdapter) Batch( ctx context.Context, ba *roachpb.BatchRequest, _ ...grpc.CallOption, ) (*roachpb.BatchResponse, error) { - return a.InternalServer.Batch(ctx, ba) + return a.server.Batch(ctx, ba) } // RangeLookup implements the roachpb.InternalClient interface. func (a internalClientAdapter) RangeLookup( ctx context.Context, rl *roachpb.RangeLookupRequest, _ ...grpc.CallOption, ) (*roachpb.RangeLookupResponse, error) { - return a.InternalServer.RangeLookup(ctx, rl) + return a.server.RangeLookup(ctx, rl) } // Join implements the roachpb.InternalClient interface. func (a internalClientAdapter) Join( ctx context.Context, req *roachpb.JoinNodeRequest, _ ...grpc.CallOption, ) (*roachpb.JoinNodeResponse, error) { - return a.InternalServer.Join(ctx, req) + return a.server.Join(ctx, req) } +// ResetQuorum is part of the roachpb.InternalClient interface. func (a internalClientAdapter) ResetQuorum( ctx context.Context, req *roachpb.ResetQuorumRequest, _ ...grpc.CallOption, ) (*roachpb.ResetQuorumResponse, error) { - return a.InternalServer.ResetQuorum(ctx, req) + return a.server.ResetQuorum(ctx, req) +} + +// TokenBucket is part of the roachpb.InternalClient interface. +func (a internalClientAdapter) TokenBucket( + ctx context.Context, in *roachpb.TokenBucketRequest, opts ...grpc.CallOption, +) (*roachpb.TokenBucketResponse, error) { + return a.server.TokenBucket(ctx, in) } type respStreamClientAdapter struct { @@ -570,7 +578,7 @@ func (a internalClientAdapter) RangeFeed( go func() { defer cancel() - err := a.InternalServer.RangeFeed(args, rfAdapter) + err := a.server.RangeFeed(args, rfAdapter) if err == nil { err = io.EOF } @@ -601,7 +609,7 @@ func (a gossipSubscriptionClientAdapter) Send(e *roachpb.GossipSubscriptionEvent var _ roachpb.Internal_GossipSubscriptionClient = gossipSubscriptionClientAdapter{} var _ roachpb.Internal_GossipSubscriptionServer = gossipSubscriptionClientAdapter{} -// GossipSubscription implements the roachpb.InternalClient interface. +// GossipSubscription is part of the roachpb.InternalClient interface. func (a internalClientAdapter) GossipSubscription( ctx context.Context, args *roachpb.GossipSubscriptionRequest, _ ...grpc.CallOption, ) (roachpb.Internal_GossipSubscriptionClient, error) { @@ -612,7 +620,7 @@ func (a internalClientAdapter) GossipSubscription( go func() { defer cancel() - err := a.InternalServer.GossipSubscription(args, gsAdapter) + err := a.server.GossipSubscription(args, gsAdapter) if err == nil { err = io.EOF } diff --git a/pkg/rpc/context_test.go b/pkg/rpc/context_test.go index 504daa265608..702fa6a19d55 100644 --- a/pkg/rpc/context_test.go +++ b/pkg/rpc/context_test.go @@ -256,6 +256,12 @@ func (*internalServer) Join( panic("unimplemented") } +func (*internalServer) TokenBucket( + ctx context.Context, in *roachpb.TokenBucketRequest, +) (*roachpb.TokenBucketResponse, error) { + panic("unimplemented") +} + // TestInternalServerAddress verifies that RPCContext uses AdvertiseAddr, not Addr, to // determine whether to apply the local server optimization. // diff --git a/pkg/server/BUILD.bazel b/pkg/server/BUILD.bazel index d002c83b3d29..64054c0fa036 100644 --- a/pkg/server/BUILD.bazel +++ b/pkg/server/BUILD.bazel @@ -89,6 +89,7 @@ go_library( "//pkg/migration", "//pkg/migration/migrationcluster", "//pkg/migration/migrationmanager", + "//pkg/multitenant", "//pkg/roachpb:with-mocks", "//pkg/rpc", "//pkg/rpc/nodedialer", diff --git a/pkg/server/node.go b/pkg/server/node.go index 0032e71e1850..0c5a99bacf6f 100644 --- a/pkg/server/node.go +++ b/pkg/server/node.go @@ -30,6 +30,7 @@ import ( "github.com/cockroachdb/cockroach/pkg/kv/kvclient/kvcoord" "github.com/cockroachdb/cockroach/pkg/kv/kvclient/kvtenant" "github.com/cockroachdb/cockroach/pkg/kv/kvserver" + "github.com/cockroachdb/cockroach/pkg/multitenant" "github.com/cockroachdb/cockroach/pkg/roachpb" "github.com/cockroachdb/cockroach/pkg/rpc" "github.com/cockroachdb/cockroach/pkg/server/status" @@ -174,6 +175,8 @@ type Node struct { perReplicaServer kvserver.Server admissionQ *admission.WorkQueue + + tenantUsage multitenant.TenantUsageServer } var _ roachpb.InternalServer = &Node{} @@ -294,20 +297,24 @@ func NewNode( stores *kvserver.Stores, execCfg *sql.ExecutorConfig, clusterID *base.ClusterIDContainer, + admissionQ *admission.WorkQueue, + tenantUsage multitenant.TenantUsageServer, ) *Node { var sqlExec *sql.InternalExecutor if execCfg != nil { sqlExec = execCfg.InternalExecutor } n := &Node{ - storeCfg: cfg, - stopper: stopper, - recorder: recorder, - metrics: makeNodeMetrics(reg, cfg.HistogramWindowInterval), - stores: stores, - txnMetrics: txnMetrics, - sqlExec: sqlExec, - clusterID: clusterID, + storeCfg: cfg, + stopper: stopper, + recorder: recorder, + metrics: makeNodeMetrics(reg, cfg.HistogramWindowInterval), + stores: stores, + txnMetrics: txnMetrics, + sqlExec: sqlExec, + clusterID: clusterID, + admissionQ: admissionQ, + tenantUsage: tenantUsage, } n.perReplicaServer = kvserver.MakeServer(&n.Descriptor, n.stores) return n @@ -1325,3 +1332,31 @@ func (n *Node) Join( ActiveVersion: &activeVersion.Version, }, nil } + +// TokenBucket is part of the roachpb.InternalServer service. +func (n *Node) TokenBucket( + ctx context.Context, in *roachpb.TokenBucketRequest, +) (*roachpb.TokenBucketResponse, error) { + tenantID, ok := roachpb.TenantFromContext(ctx) + if !ok { + return nil, errors.New("token bucket request with no tenant") + } + return n.tenantUsage.TokenBucketRequest(ctx, tenantID, in) +} + +// NewTenantUsageServer is a hook for CCL code which implements the tenant usage +// server. +var NewTenantUsageServer = func(db *kv.DB, executor *sql.InternalExecutor) multitenant.TenantUsageServer { + return dummyTenantUsageServer{} +} + +// dummyTenantUsageServer is a stub implementation of TenantUsageServer that +// errors out on all APIs. +type dummyTenantUsageServer struct{} + +// TokenBucketRequest is defined in the TenantUsageServer interface. +func (dummyTenantUsageServer) TokenBucketRequest( + ctx context.Context, tenantID roachpb.TenantID, in *roachpb.TokenBucketRequest, +) (*roachpb.TokenBucketResponse, error) { + return nil, errors.Errorf("tenant usage requires a CCL binary") +} diff --git a/pkg/server/server.go b/pkg/server/server.go index 312400bd0436..9b689ac35c69 100644 --- a/pkg/server/server.go +++ b/pkg/server/server.go @@ -525,7 +525,7 @@ func NewServer(cfg Config, stopper *stop.Stopper) (*Server, error) { // The InternalExecutor will be further initialized later, as we create more // of the server's components. There's a circular dependency - many things - // need an InternalExecutor, but the InternalExecutor needs an ExecutorConfig, + // need an InternalExecutor, but the InternalExecutor needs an xecutorConfig, // which in turn needs many things. That's why everybody that needs an // InternalExecutor uses this one instance. internalExecutor := &sql.InternalExecutor{} @@ -629,9 +629,13 @@ func NewServer(cfg Config, stopper *stop.Stopper) (*Server, error) { updates.TestingKnobs = &cfg.TestingKnobs.Server.(*TestingKnobs).DiagnosticsTestingKnobs } + tenantUsage := NewTenantUsageServer(db, internalExecutor) node := NewNode( storeCfg, recorder, registry, stopper, - txnMetrics, stores, nil /* execCfg */, &rpcContext.ClusterID) + txnMetrics, stores, nil /* execCfg */, &rpcContext.ClusterID, + gcoord.GetWorkQueue(admission.KVWork), + tenantUsage, + ) node.admissionQ = gcoord.GetWorkQueue(admission.KVWork) lateBoundNode = node roachpb.RegisterInternalServer(grpcServer.Server, node) @@ -739,6 +743,7 @@ func NewServer(cfg Config, stopper *stop.Stopper) (*Server, error) { rangeFeedFactory: rangeFeedFactory, sqlStatusServer: sStatus, regionsServer: sStatus, + tenantUsageServer: tenantUsage, }) if err != nil { return nil, err diff --git a/pkg/server/server_sql.go b/pkg/server/server_sql.go index 4ba1a0dc569d..fd1908a23e3b 100644 --- a/pkg/server/server_sql.go +++ b/pkg/server/server_sql.go @@ -37,6 +37,7 @@ import ( "github.com/cockroachdb/cockroach/pkg/migration" "github.com/cockroachdb/cockroach/pkg/migration/migrationcluster" "github.com/cockroachdb/cockroach/pkg/migration/migrationmanager" + "github.com/cockroachdb/cockroach/pkg/multitenant" "github.com/cockroachdb/cockroach/pkg/roachpb" "github.com/cockroachdb/cockroach/pkg/rpc" "github.com/cockroachdb/cockroach/pkg/rpc/nodedialer" @@ -257,6 +258,9 @@ type sqlServerArgs struct { // Used to query valid regions on the server. regionsServer serverpb.RegionsServer + + // Used for multi-tenant cost control. + tenantUsageServer multitenant.TenantUsageServer } func newSQLServer(ctx context.Context, cfg sqlServerArgs) (*SQLServer, error) { @@ -563,6 +567,7 @@ func newSQLServer(ctx context.Context, cfg sqlServerArgs) (*SQLServer, error) { TestingKnobs: sqlExecutorTestingKnobs, CompactEngineSpanFunc: compactEngineSpanFunc, TraceCollector: traceCollector, + TenantUsageServer: cfg.tenantUsageServer, DistSQLPlanner: sql.NewDistSQLPlanner( ctx, diff --git a/pkg/server/tenant.go b/pkg/server/tenant.go index 604c840ea326..7e0a1ca46165 100644 --- a/pkg/server/tenant.go +++ b/pkg/server/tenant.go @@ -25,6 +25,7 @@ import ( "github.com/cockroachdb/cockroach/pkg/kv/kvclient/rangefeed" "github.com/cockroachdb/cockroach/pkg/kv/kvserver/protectedts" "github.com/cockroachdb/cockroach/pkg/kv/kvserver/protectedts/ptprovider" + "github.com/cockroachdb/cockroach/pkg/multitenant" "github.com/cockroachdb/cockroach/pkg/roachpb" "github.com/cockroachdb/cockroach/pkg/rpc" "github.com/cockroachdb/cockroach/pkg/rpc/nodedialer" @@ -191,6 +192,16 @@ func StartTenant( log.SetNodeIDs(clusterID, 0 /* nodeID is not known for a SQL-only server. */) log.SetTenantIDs(args.TenantID.String(), int32(s.SQLInstanceID())) + provider := args.tenantConnect + // TODO(radu): allow injecting a different provider through testing knobs. + costController, err := NewTenantSideCostController(ctx, args.TenantID, provider) + if err != nil { + return nil, "", "", err + } + if err := costController.Start(ctx, args.stopper); err != nil { + return nil, "", "", err + } + if err := s.startServeSQL(ctx, args.stopper, s.connManager, @@ -377,3 +388,20 @@ func makeTenantSQLServerArgs( regionsServer: tenantConnect, }, nil } + +// NewTenantSideCostController is a hook for CCL code which implements the +// controller. +var NewTenantSideCostController = func( + ctx context.Context, tenantID roachpb.TenantID, provider kvtenant.TokenBucketProvider, +) (multitenant.TenantSideCostController, error) { + // Return a no-op implementation. + return noopTenantSideCostController{}, nil +} + +// noopTenantSideCostController is a no-op implementation of +// TenantSideCostController. +type noopTenantSideCostController struct{} + +func (noopTenantSideCostController) Start(ctx context.Context, stopper *stop.Stopper) error { + return nil +} diff --git a/pkg/sql/BUILD.bazel b/pkg/sql/BUILD.bazel index 068ece354e48..933a946793ed 100644 --- a/pkg/sql/BUILD.bazel +++ b/pkg/sql/BUILD.bazel @@ -258,6 +258,7 @@ go_library( "//pkg/kv/kvserver/liveness/livenesspb", "//pkg/kv/kvserver/protectedts", "//pkg/migration", + "//pkg/multitenant", "//pkg/roachpb:with-mocks", "//pkg/rpc", "//pkg/rpc/nodedialer", diff --git a/pkg/sql/exec_util.go b/pkg/sql/exec_util.go index ccbe76cfb86b..9e368b720103 100644 --- a/pkg/sql/exec_util.go +++ b/pkg/sql/exec_util.go @@ -42,6 +42,7 @@ import ( "github.com/cockroachdb/cockroach/pkg/kv/kvclient/rangefeed" "github.com/cockroachdb/cockroach/pkg/kv/kvserver/protectedts" "github.com/cockroachdb/cockroach/pkg/migration" + "github.com/cockroachdb/cockroach/pkg/multitenant" "github.com/cockroachdb/cockroach/pkg/roachpb" "github.com/cockroachdb/cockroach/pkg/rpc" "github.com/cockroachdb/cockroach/pkg/security" @@ -955,6 +956,10 @@ type ExecutorConfig struct { // TraceCollector is used to contact all live nodes in the cluster, and // collect trace spans from their inflight node registries. TraceCollector *collector.TraceCollector + + // TenantUsageServer is used to implement configuration APIs for tenant cost + // control. + TenantUsageServer multitenant.TenantUsageServer } // VersionUpgradeHook is used to run migrations starting in v21.1.