diff --git a/c-deps/libroach/protos/roachpb/data.pb.cc b/c-deps/libroach/protos/roachpb/data.pb.cc index 1f9c9a5aafae..317baf695172 100644 --- a/c-deps/libroach/protos/roachpb/data.pb.cc +++ b/c-deps/libroach/protos/roachpb/data.pb.cc @@ -3735,6 +3735,7 @@ const int Transaction::kWriteTooOldFieldNumber; const int Transaction::kRetryOnPushFieldNumber; const int Transaction::kIntentsFieldNumber; const int Transaction::kEpochZeroTimestampFieldNumber; +const int Transaction::kOrigTimestampWasObservedFieldNumber; #endif // !defined(_MSC_VER) || _MSC_VER >= 1900 Transaction::Transaction() @@ -3787,16 +3788,16 @@ Transaction::Transaction(const Transaction& from) refreshed_timestamp_ = NULL; } ::memcpy(&status_, &from.status_, - static_cast(reinterpret_cast(&retry_on_push_) - - reinterpret_cast(&status_)) + sizeof(retry_on_push_)); + static_cast(reinterpret_cast(&orig_timestamp_was_observed_) - + reinterpret_cast(&status_)) + sizeof(orig_timestamp_was_observed_)); // @@protoc_insertion_point(copy_constructor:cockroach.roachpb.Transaction) } void Transaction::SharedCtor() { name_.UnsafeSetDefault(&::google::protobuf::internal::GetEmptyStringAlreadyInited()); ::memset(&meta_, 0, static_cast( - reinterpret_cast(&retry_on_push_) - - reinterpret_cast(&meta_)) + sizeof(retry_on_push_)); + reinterpret_cast(&orig_timestamp_was_observed_) - + reinterpret_cast(&meta_)) + sizeof(orig_timestamp_was_observed_)); _cached_size_ = 0; } @@ -3867,8 +3868,8 @@ void Transaction::Clear() { } refreshed_timestamp_ = NULL; ::memset(&status_, 0, static_cast( - reinterpret_cast(&retry_on_push_) - - reinterpret_cast(&status_)) + sizeof(retry_on_push_)); + reinterpret_cast(&orig_timestamp_was_observed_) - + reinterpret_cast(&status_)) + sizeof(orig_timestamp_was_observed_)); _internal_metadata_.Clear(); } @@ -3884,7 +3885,7 @@ bool Transaction::MergePartialFromCodedStream( &unknown_fields_string, false); // @@protoc_insertion_point(parse_start:cockroach.roachpb.Transaction) for (;;) { - ::std::pair< ::google::protobuf::uint32, bool> p = input->ReadTagWithCutoffNoLastTag(127u); + ::std::pair< ::google::protobuf::uint32, bool> p = input->ReadTagWithCutoffNoLastTag(16383u); tag = p.first; if (!p.second) goto handle_unusual; switch (::google::protobuf::internal::WireFormatLite::GetTagFieldNumber(tag)) { @@ -4049,6 +4050,20 @@ bool Transaction::MergePartialFromCodedStream( break; } + // bool orig_timestamp_was_observed = 16; + case 16: { + if (static_cast< ::google::protobuf::uint8>(tag) == + static_cast< ::google::protobuf::uint8>(128u /* 128 & 0xFF */)) { + + DO_((::google::protobuf::internal::WireFormatLite::ReadPrimitive< + bool, ::google::protobuf::internal::WireFormatLite::TYPE_BOOL>( + input, &orig_timestamp_was_observed_))); + } else { + goto handle_unusual; + } + break; + } + default: { handle_unusual: if (tag == 0) { @@ -4148,6 +4163,11 @@ void Transaction::SerializeWithCachedSizes( 15, *this->refreshed_timestamp_, output); } + // bool orig_timestamp_was_observed = 16; + if (this->orig_timestamp_was_observed() != 0) { + ::google::protobuf::internal::WireFormatLite::WriteBool(16, this->orig_timestamp_was_observed(), output); + } + output->WriteRaw((::google::protobuf::internal::GetProto3PreserveUnknownsDefault() ? _internal_metadata_.unknown_fields() : _internal_metadata_.default_instance()).data(), static_cast((::google::protobuf::internal::GetProto3PreserveUnknownsDefault() ? _internal_metadata_.unknown_fields() : _internal_metadata_.default_instance()).size())); // @@protoc_insertion_point(serialize_end:cockroach.roachpb.Transaction) @@ -4243,6 +4263,11 @@ size_t Transaction::ByteSizeLong() const { total_size += 1 + 1; } + // bool orig_timestamp_was_observed = 16; + if (this->orig_timestamp_was_observed() != 0) { + total_size += 2 + 1; + } + int cached_size = ::google::protobuf::internal::ToCachedSize(total_size); GOOGLE_SAFE_CONCURRENT_WRITES_BEGIN(); _cached_size_ = cached_size; @@ -4298,6 +4323,9 @@ void Transaction::MergeFrom(const Transaction& from) { if (from.retry_on_push() != 0) { set_retry_on_push(from.retry_on_push()); } + if (from.orig_timestamp_was_observed() != 0) { + set_orig_timestamp_was_observed(from.orig_timestamp_was_observed()); + } } void Transaction::CopyFrom(const Transaction& from) { @@ -4330,6 +4358,7 @@ void Transaction::InternalSwap(Transaction* other) { swap(writing_, other->writing_); swap(write_too_old_, other->write_too_old_); swap(retry_on_push_, other->retry_on_push_); + swap(orig_timestamp_was_observed_, other->orig_timestamp_was_observed_); _internal_metadata_.Swap(&other->_internal_metadata_); swap(_cached_size_, other->_cached_size_); } @@ -4742,6 +4771,20 @@ void Transaction::set_allocated_epoch_zero_timestamp(::cockroach::util::hlc::Tim // @@protoc_insertion_point(field_set_allocated:cockroach.roachpb.Transaction.epoch_zero_timestamp) } +// bool orig_timestamp_was_observed = 16; +void Transaction::clear_orig_timestamp_was_observed() { + orig_timestamp_was_observed_ = false; +} +bool Transaction::orig_timestamp_was_observed() const { + // @@protoc_insertion_point(field_get:cockroach.roachpb.Transaction.orig_timestamp_was_observed) + return orig_timestamp_was_observed_; +} +void Transaction::set_orig_timestamp_was_observed(bool value) { + + orig_timestamp_was_observed_ = value; + // @@protoc_insertion_point(field_set:cockroach.roachpb.Transaction.orig_timestamp_was_observed) +} + #endif // PROTOBUF_INLINE_NOT_IN_HEADERS // =================================================================== diff --git a/c-deps/libroach/protos/roachpb/data.pb.h b/c-deps/libroach/protos/roachpb/data.pb.h index 41e4be39f861..2315c98b9433 100644 --- a/c-deps/libroach/protos/roachpb/data.pb.h +++ b/c-deps/libroach/protos/roachpb/data.pb.h @@ -1457,6 +1457,12 @@ class Transaction : public ::google::protobuf::MessageLite /* @@protoc_insertion bool retry_on_push() const; void set_retry_on_push(bool value); + // bool orig_timestamp_was_observed = 16; + void clear_orig_timestamp_was_observed(); + static const int kOrigTimestampWasObservedFieldNumber = 16; + bool orig_timestamp_was_observed() const; + void set_orig_timestamp_was_observed(bool value); + // @@protoc_insertion_point(class_scope:cockroach.roachpb.Transaction) private: @@ -1474,6 +1480,7 @@ class Transaction : public ::google::protobuf::MessageLite /* @@protoc_insertion bool writing_; bool write_too_old_; bool retry_on_push_; + bool orig_timestamp_was_observed_; mutable int _cached_size_; friend struct protobuf_roachpb_2fdata_2eproto::TableStruct; }; @@ -3336,6 +3343,20 @@ inline void Transaction::set_allocated_epoch_zero_timestamp(::cockroach::util::h // @@protoc_insertion_point(field_set_allocated:cockroach.roachpb.Transaction.epoch_zero_timestamp) } +// bool orig_timestamp_was_observed = 16; +inline void Transaction::clear_orig_timestamp_was_observed() { + orig_timestamp_was_observed_ = false; +} +inline bool Transaction::orig_timestamp_was_observed() const { + // @@protoc_insertion_point(field_get:cockroach.roachpb.Transaction.orig_timestamp_was_observed) + return orig_timestamp_was_observed_; +} +inline void Transaction::set_orig_timestamp_was_observed(bool value) { + + orig_timestamp_was_observed_ = value; + // @@protoc_insertion_point(field_set:cockroach.roachpb.Transaction.orig_timestamp_was_observed) +} + // ------------------------------------------------------------------- // Intent diff --git a/pkg/internal/client/txn.go b/pkg/internal/client/txn.go index 3116741fd51d..5cb731ab117c 100644 --- a/pkg/internal/client/txn.go +++ b/pkg/internal/client/txn.go @@ -267,6 +267,15 @@ func (txn *Txn) Isolation() enginepb.IsolationType { return txn.mu.Proto.Isolation } +// OrigTimestampWasObserved when called indicates that +// the value of OrigTimestamp was observed and matters +// for transaction ordering (i.e. don't bump) +func (txn *Txn) OrigTimestampWasObserved() { + txn.mu.Lock() + defer txn.mu.Unlock() + txn.mu.Proto.OrigTimestampWasObserved = true +} + // OrigTimestamp returns the transaction's starting timestamp. func (txn *Txn) OrigTimestamp() hlc.Timestamp { txn.mu.Lock() diff --git a/pkg/kv/dist_sender.go b/pkg/kv/dist_sender.go index 1e1ed11c3101..5e679f20e92f 100644 --- a/pkg/kv/dist_sender.go +++ b/pkg/kv/dist_sender.go @@ -573,6 +573,40 @@ func (ds *DistSender) initAndVerifyBatch( // request. var errNo1PCTxn = roachpb.NewErrorf("cannot send 1PC txn to multiple ranges") +// splitBatchAndCheckForRefreshSpans splits the batch according to the +// canSplitET parmeter and checks whether the final request is an +// EndTransaction. If so, the EndTransactionRequest.NoRefreshSpans +// flag is reset to indicate whether earlier parts of the split may +// result in refresh spans. +func splitBatchAndCheckForRefreshSpans( + ba roachpb.BatchRequest, canSplitET bool, +) [][]roachpb.RequestUnion { + parts := ba.Split(canSplitET) + // If the final part contains an EndTransaction, we need to check + // whether earlier split parts contain any refresh spans and properly + // set the NoRefreshSpans flag on the end transaction. + lastPart := parts[len(parts)-1] + lastReq := lastPart[len(lastPart)-1].GetInner() + if et, ok := lastReq.(*roachpb.EndTransactionRequest); ok && et.NoRefreshSpans { + hasRefreshSpans := false + for _, part := range parts[:len(parts)-1] { + for _, req := range part { + if roachpb.NeedsRefresh(req.GetInner()) { + hasRefreshSpans = true + } + } + } + if hasRefreshSpans { + etCopy := *et + etCopy.NoRefreshSpans = false + lastPart = append([]roachpb.RequestUnion(nil), lastPart...) + lastPart[len(lastPart)-1].MustSetInner(&etCopy) + parts[len(parts)-1] = lastPart + } + } + return parts +} + // Send implements the batch.Sender interface. It subdivides the Batch // into batches admissible for sending (preventing certain illegal // mixtures of requests), executes each individual part (which may @@ -615,7 +649,7 @@ func (ds *DistSender) Send( if ba.Txn != nil && ba.Txn.Epoch > 0 { splitET = true } - parts := ba.Split(splitET) + parts := splitBatchAndCheckForRefreshSpans(ba, splitET) if len(parts) > 1 && ba.MaxSpanRequestKeys != 0 { // We already verified above that the batch contains only scan requests of the same type. // Such a batch should never need splitting. @@ -646,7 +680,7 @@ func (ds *DistSender) Send( if len(parts) != 1 { panic("EndTransaction not in last chunk of batch") } - parts = ba.Split(true /* split ET */) + parts = splitBatchAndCheckForRefreshSpans(ba, true /* split ET */) if len(parts) != 2 { panic("split of final EndTransaction chunk resulted in != 2 parts") } diff --git a/pkg/kv/dist_sender_server_test.go b/pkg/kv/dist_sender_server_test.go index 7a9d638d0d2d..09c6022ea787 100644 --- a/pkg/kv/dist_sender_server_test.go +++ b/pkg/kv/dist_sender_server_test.go @@ -1852,6 +1852,7 @@ func TestTxnCoordSenderRetries(t *testing.T) { afterTxnStart func(context.Context, *client.DB) error // called after the txn chooses a timestamp retryable func(context.Context, *client.Txn) error // called during the txn; may be retried filter func(storagebase.FilterArgs) *roachpb.Error + tsLeaked bool // If both of these are false, no retries. txnCoordRetry bool clientRetry bool @@ -1866,7 +1867,18 @@ func TestTxnCoordSenderRetries(t *testing.T) { retryable: func(ctx context.Context, txn *client.Txn) error { return txn.Put(ctx, "a", "put") // put to advance txn ts }, - txnCoordRetry: true, + }, + { + name: "forwarded timestamp with get and put timestamp leaked", + afterTxnStart: func(ctx context.Context, db *client.DB) error { + _, err := db.Get(ctx, "a") // read key to set ts cache + return err + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + return txn.Put(ctx, "a", "put") // put to advance txn ts + }, + tsLeaked: true, + clientRetry: true, }, { name: "forwarded timestamp with get and initput", @@ -1877,7 +1889,6 @@ func TestTxnCoordSenderRetries(t *testing.T) { retryable: func(ctx context.Context, txn *client.Txn) error { return txn.InitPut(ctx, "a", "put", false) // put to advance txn ts }, - txnCoordRetry: true, }, { name: "forwarded timestamp with get and initput value exists", @@ -1889,7 +1900,7 @@ func TestTxnCoordSenderRetries(t *testing.T) { return err }, retryable: func(ctx context.Context, txn *client.Txn) error { - err := txn.InitPut(ctx, "a", "init-put", false) // put to advance txn ts + err := txn.InitPut(ctx, "a", "init-put", false) // init-put to advance txn ts // Swallow expected condition failed error. if _, ok := err.(*roachpb.ConditionFailedError); !ok { if err != nil { @@ -1897,9 +1908,10 @@ func TestTxnCoordSenderRetries(t *testing.T) { } return err } + log.Infof(ctx, "Swallowed error") return nil }, - clientRetry: true, + // No retries, this is a straight failure. }, { name: "forwarded timestamp with get and cput", @@ -1910,7 +1922,21 @@ func TestTxnCoordSenderRetries(t *testing.T) { retryable: func(ctx context.Context, txn *client.Txn) error { return txn.CPut(ctx, "a", "cput", "put") // cput to advance txn ts, set update span }, - txnCoordRetry: true, + }, + { + name: "forwarded timestamp with get and cput timestamp leaked", + beforeTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "a", "put") + }, + afterTxnStart: func(ctx context.Context, db *client.DB) error { + _, err := db.Get(ctx, "a") // read key to set ts cache + return err + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + return txn.CPut(ctx, "a", "cput", "put") // cput to advance txn ts, set update span + }, + tsLeaked: true, + clientRetry: true, }, { name: "forwarded timestamp with scan and cput", @@ -1921,7 +1947,6 @@ func TestTxnCoordSenderRetries(t *testing.T) { retryable: func(ctx context.Context, txn *client.Txn) error { return txn.CPut(ctx, "ab", "cput", nil) // cput advances, sets update span }, - txnCoordRetry: true, }, { name: "forwarded timestamp with put in batch commit", @@ -1960,6 +1985,43 @@ func TestTxnCoordSenderRetries(t *testing.T) { retryable: func(ctx context.Context, txn *client.Txn) error { return txn.Put(ctx, "a", "put") }, + // This trivially succeeds as there are no refresh spans. + }, + { + name: "write too old with put timestamp leaked", + afterTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "a", "put") + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + return txn.Put(ctx, "a", "put") + }, + tsLeaked: true, + clientRetry: true, + }, + { + name: "write too old with get in the clear", + afterTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "a", "put") + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + if _, err := txn.Get(ctx, "b"); err != nil { + return nil + } + return txn.Put(ctx, "a", "put") + }, + txnCoordRetry: true, + }, + { + name: "write too old with get conflict", + afterTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "a", "put") + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + if _, err := txn.Get(ctx, "a"); err != nil { + return nil + } + return txn.Put(ctx, "a", "put") + }, clientRetry: true, }, { @@ -2062,9 +2124,8 @@ func TestTxnCoordSenderRetries(t *testing.T) { b := txn.NewBatch() b.Put("a", "put") b.Put("c", "put") - return txn.CommitInBatch(ctx, b) // both puts will succeed, et will retry + return txn.CommitInBatch(ctx, b) // both puts will succeed, no retry }, - txnCoordRetry: true, }, { name: "multi-range batch with forwarded timestamp and cput", @@ -2079,6 +2140,42 @@ func TestTxnCoordSenderRetries(t *testing.T) { b := txn.NewBatch() b.CPut("a", "cput", "value") b.Put("c", "put") + return txn.CommitInBatch(ctx, b) // both puts will succeed, no retry + }, + }, + { + name: "multi-range batch with forwarded timestamp and cput and get", + beforeTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "a", "value") + }, + afterTxnStart: func(ctx context.Context, db *client.DB) error { + _, err := db.Get(ctx, "a") // set ts cache + return err + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + if _, err := txn.Get(ctx, "b"); err != nil { // Get triggers txn coord retry + return err + } + b := txn.NewBatch() + b.CPut("a", "cput", "value") + b.Put("c", "put") + return txn.CommitInBatch(ctx, b) // both puts will succeed, et will retry from get + }, + txnCoordRetry: true, + }, + { + name: "multi-range batch with forwarded timestamp and cput and delRange", + beforeTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "c", "value") + }, + afterTxnStart: func(ctx context.Context, db *client.DB) error { + _, err := db.Get(ctx, "a") // set ts cache + return err + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + b := txn.NewBatch() + b.DelRange("a", "b", false) + b.CPut("c", "cput", "value") return txn.CommitInBatch(ctx, b) // both puts will succeed, et will retry }, txnCoordRetry: true, @@ -2092,12 +2189,11 @@ func TestTxnCoordSenderRetries(t *testing.T) { b := txn.NewBatch() b.Put("a", "put") b.Put("c", "put") - return txn.CommitInBatch(ctx, b) // both puts will succeed, et will retry + return txn.CommitInBatch(ctx, b) // both puts will succeed, no retry }, - txnCoordRetry: true, }, { - name: "multi-range batch with write too old and cput", + name: "multi-range batch with write too old and failed cput", beforeTxnStart: func(ctx context.Context, db *client.DB) error { return db.Put(ctx, "a", "orig") }, @@ -2112,6 +2208,22 @@ func TestTxnCoordSenderRetries(t *testing.T) { }, clientRetry: true, // cput with write too old requires restart }, + { + name: "multi-range batch with write too old and successful cput", + beforeTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "a", "orig") + }, + afterTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "a", "orig") + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + b := txn.NewBatch() + b.CPut("a", "cput", "orig") + b.Put("c", "put") + return txn.CommitInBatch(ctx, b) + }, + clientRetry: true, // successful cput will still retry because of mixed success + }, { name: "cput within uncertainty interval", beforeTxnStart: func(ctx context.Context, db *client.DB) error { @@ -2123,6 +2235,18 @@ func TestTxnCoordSenderRetries(t *testing.T) { filter: newUncertaintyFilter(roachpb.Key([]byte("a"))), txnCoordRetry: true, }, + { + name: "cput within uncertainty interval timestamp leaked", + beforeTxnStart: func(ctx context.Context, db *client.DB) error { + return db.Put(ctx, "a", "value") + }, + retryable: func(ctx context.Context, txn *client.Txn) error { + return txn.CPut(ctx, "a", "cput", "value") + }, + filter: newUncertaintyFilter(roachpb.Key([]byte("a"))), + clientRetry: true, + tsLeaked: true, + }, { name: "reads within uncertainty interval", beforeTxnStart: func(ctx context.Context, db *client.DB) error { @@ -2183,23 +2307,26 @@ func TestTxnCoordSenderRetries(t *testing.T) { txnCoordRetry: true, // will succeed because no mixed success }, { - name: "multi range batch with uncertainty interval error and violating put", + name: "multi range batch with uncertainty interval error and get conflict", beforeTxnStart: func(ctx context.Context, db *client.DB) error { - return db.Put(ctx, "c", "value") + return db.Put(ctx, "a", "init") }, afterTxnStart: func(ctx context.Context, db *client.DB) error { - return db.Put(ctx, "d", "value2") + if err := db.Put(ctx, "b", "value"); err != nil { + return err + } + return db.Put(ctx, "a", "value") }, retryable: func(ctx context.Context, txn *client.Txn) error { - if err := txn.Put(ctx, "a", "put"); err != nil { + if _, err := txn.Get(ctx, "b"); err != nil { return err } b := txn.NewBatch() - b.CPut("c", "cput", "value") + b.CPut("a", "cput", "value") return txn.CommitInBatch(ctx, b) }, - filter: newUncertaintyFilter(roachpb.Key([]byte("c"))), - clientRetry: true, // will fail because of write too old on cput + filter: newUncertaintyFilter(roachpb.Key([]byte("a"))), + clientRetry: true, // will fail because of conflict on refresh span for the Get }, { name: "multi range batch with uncertainty interval error and mixed success", @@ -2249,12 +2376,17 @@ func TestTxnCoordSenderRetries(t *testing.T) { var metrics kv.TxnMetrics var lastAutoRetries int64 + var hadClientRetry bool epoch := 0 if err := db.Txn(ctx, func(ctx context.Context, txn *client.Txn) error { + if tc.tsLeaked { + txn.OrigTimestampWasObserved() + } if epoch > 0 { if !tc.clientRetry { t.Fatal("expected txn coord sender to retry, but got client-side retry") } + hadClientRetry = true // We expected a new epoch and got it; return success. return nil } @@ -2281,7 +2413,10 @@ func TestTxnCoordSenderRetries(t *testing.T) { // can only check here that it's >= 1. autoRetries := metrics.AutoRetries.Count() - lastAutoRetries if tc.txnCoordRetry && autoRetries == 0 { - t.Errorf("expected [at least] one auto retry; got %d", autoRetries) + t.Errorf("expected [at least] one txn coord sender auto retry; got %d", autoRetries) + } + if tc.clientRetry && !hadClientRetry { + t.Errorf("expected but did not experience client retry") } }) } diff --git a/pkg/kv/txn_coord_sender.go b/pkg/kv/txn_coord_sender.go index d0b3f359b0f8..555fe082c6ca 100644 --- a/pkg/kv/txn_coord_sender.go +++ b/pkg/kv/txn_coord_sender.go @@ -672,7 +672,7 @@ func (tc *TxnCoordSender) appendRefreshSpansLocked( return false } ba.RefreshSpanIterate(br, func(span roachpb.Span, write bool) { - log.VEventf(ctx, 2, "refresh: %s write=%t", span, write) + log.VEventf(ctx, 3, "refresh: %s write=%t", span, write) if write { tc.mu.meta.RefreshWrites = append(tc.mu.meta.RefreshWrites, span) } else { diff --git a/pkg/roachpb/api.go b/pkg/roachpb/api.go index 3a58fc94a663..c1652d7c8726 100644 --- a/pkg/roachpb/api.go +++ b/pkg/roachpb/api.go @@ -84,6 +84,7 @@ const ( updatesReadTSCache // commands which update the read timestamp cache updatesWriteTSCache // commands which update the write timestamp cache updatesTSCacheOnError // commands which make read data available on errors + needsRefresh // commands which require refreshes to avoid serializable retries ) // IsReadOnly returns true iff the request is read-only. @@ -133,6 +134,12 @@ func UpdatesTimestampCacheOnError(args Request) bool { return (args.flags() & updatesTSCacheOnError) != 0 } +// NeedsRefresh returns whether the command must be refreshed in +// order to avoid client-side retries on serializable transactions. +func NeedsRefresh(args Request) bool { + return (args.flags() & needsRefresh) != 0 +} + // Request is an interface for RPC requests. type Request interface { protoutil.Message @@ -910,18 +917,15 @@ func NewReverseScan(key, endKey Key) Request { } } -func (*GetRequest) flags() int { return isRead | isTxn | updatesReadTSCache } +func (*GetRequest) flags() int { return isRead | isTxn | updatesReadTSCache | needsRefresh } func (*PutRequest) flags() int { return isWrite | isTxn | isTxnWrite | consultsTSCache } // ConditionalPut effectively reads and may not write, so must update // the timestamp cache. Note that on ConditionFailedErrors // ConditionalPut returns the read data and must update the timestamp -// cache. The timestamp cache must always be updated, even though -// conditional put leaves an intent because on a commit with a -// write-too-old error, conditional puts must be retried if they were -// the cause. This is true because a CPut operates on the original -// timestamp, and will not be valid until retried using the most -// recently written value. +// cache. ConditionalPuts do not require a refresh because on write-too-old +// errors, they return an error immediately instead of continuing a +// serializable transaction to be retried at end transaction. func (*ConditionalPutRequest) flags() int { return isRead | isWrite | isTxn | isTxnWrite | updatesReadTSCache | updatesTSCacheOnError | consultsTSCache } @@ -936,12 +940,12 @@ func (*InitPutRequest) flags() int { } // Increment reads the existing value, but always leaves an intent so -// it could get away with not updating the timestamp cache. However, -// an increment op must have its key refreshed to avoid client-side -// serializable restarts in the case of a write-too-old error, so we -// specify the updatesReadTSCache flag. +// it does not need to update the timestamp cache. It also does not +// require refresh because on write-too-old errors experienced during +// serializable transactions, increment returns the error instead of +// continuing the transaction. func (*IncrementRequest) flags() int { - return isRead | isWrite | isTxn | isTxnWrite | updatesReadTSCache | consultsTSCache + return isRead | isWrite | isTxn | isTxnWrite | consultsTSCache } func (*DeleteRequest) flags() int { return isWrite | isTxn | isTxnWrite | consultsTSCache } @@ -967,15 +971,15 @@ func (drr *DeleteRangeRequest) flags() int { // intents or tombstones for keys which don't yet exist. By updating // the write timestamp cache, it forces subsequent writes to get a // write-too-old error and avoids the phantom delete anomaly. - return isWrite | isTxn | isTxnWrite | isRange | updatesWriteTSCache | consultsTSCache + return isWrite | isTxn | isTxnWrite | isRange | updatesWriteTSCache | needsRefresh | consultsTSCache } // Note that ClearRange commands cannot be part of a transaction as // they clear all MVCC versions. func (*ClearRangeRequest) flags() int { return isWrite | isRange | isAlone } -func (*ScanRequest) flags() int { return isRead | isRange | isTxn | updatesReadTSCache } +func (*ScanRequest) flags() int { return isRead | isRange | isTxn | updatesReadTSCache | needsRefresh } func (*ReverseScanRequest) flags() int { - return isRead | isRange | isReverse | isTxn | updatesReadTSCache + return isRead | isRange | isReverse | isTxn | updatesReadTSCache | needsRefresh } func (*BeginTransactionRequest) flags() int { return isWrite | isTxn | consultsTSCache } diff --git a/pkg/roachpb/api.pb.go b/pkg/roachpb/api.pb.go index ff7ee923839b..a165b6417c0a 100644 --- a/pkg/roachpb/api.pb.go +++ b/pkg/roachpb/api.pb.go @@ -865,7 +865,7 @@ type EndTransactionRequest struct { // Set to true if this transaction is serializable isolation but has // accummulated no refresh spans. This allows the executing server // to retry it locally on the fast path. - NoRefreshSpans bool `protobuf:"varint,7,opt,name=no_refresh_spans,json=noRefreshSpans,proto3" json:"no_refresh_spans,omitempty"` + NoRefreshSpans bool `protobuf:"varint,8,opt,name=no_refresh_spans,json=noRefreshSpans,proto3" json:"no_refresh_spans,omitempty"` } func (m *EndTransactionRequest) Reset() { *m = EndTransactionRequest{} } @@ -4809,7 +4809,7 @@ func (m *EndTransactionRequest) MarshalTo(dAtA []byte) (int, error) { i++ } if m.NoRefreshSpans { - dAtA[i] = 0x38 + dAtA[i] = 0x40 i++ if m.NoRefreshSpans { dAtA[i] = 1 @@ -13593,7 +13593,7 @@ func (m *EndTransactionRequest) Unmarshal(dAtA []byte) error { } } m.Require1PC = bool(v != 0) - case 7: + case 8: if wireType != 0 { return fmt.Errorf("proto: wrong wireType = %d for field NoRefreshSpans", wireType) } @@ -24576,337 +24576,338 @@ var ( func init() { proto.RegisterFile("roachpb/api.proto", fileDescriptorApi) } var fileDescriptorApi = []byte{ - // 5309 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xdc, 0x7c, 0x4d, 0x8c, 0x23, 0x49, - 0x56, 0x7f, 0x67, 0xd9, 0x2e, 0xdb, 0xcf, 0x1f, 0xed, 0x8a, 0xfe, 0x72, 0x57, 0x7f, 0xb8, 0xda, - 0xfd, 0xdd, 0xbb, 0x53, 0x3d, 0xdd, 0xf5, 0xef, 0x3f, 0xf3, 0xc9, 0x4e, 0xd9, 0x55, 0xdd, 0xed, - 0xe9, 0xea, 0xaa, 0x9e, 0xb0, 0x6b, 0xbe, 0x16, 0x36, 0xc9, 0xca, 0x8c, 0xb2, 0x93, 0xb6, 0x33, - 0xdd, 0x99, 0xe9, 0xae, 0xaa, 0xe1, 0x80, 0x16, 0x09, 0xc1, 0x61, 0x41, 0x48, 0xcc, 0x01, 0x09, - 0x09, 0x56, 0x02, 0x24, 0x04, 0x27, 0x0e, 0x1c, 0x38, 0x71, 0xe1, 0x30, 0x68, 0x17, 0x34, 0x07, - 0x90, 0x10, 0x48, 0x25, 0x28, 0x2e, 0xab, 0x15, 0x9c, 0xb8, 0x0d, 0x12, 0x42, 0xf1, 0x65, 0xa7, - 0xed, 0x4c, 0xdb, 0xd5, 0x93, 0x68, 0x04, 0x27, 0x3b, 0x5f, 0xc6, 0x7b, 0x11, 0xf1, 0xe2, 0xc5, - 0x8b, 0x5f, 0xc4, 0x7b, 0x91, 0xb0, 0xe0, 0xd8, 0x9a, 0xde, 0xea, 0xee, 0xdc, 0xd5, 0xba, 0xe6, - 0x72, 0xd7, 0xb1, 0x3d, 0x1b, 0x2d, 0xe8, 0xb6, 0xfe, 0x9c, 0x91, 0x97, 0xc5, 0xcb, 0x45, 0x24, - 0x4b, 0x19, 0x9a, 0xa7, 0xf1, 0x62, 0x8b, 0xa7, 0x25, 0x8d, 0x38, 0x8e, 0xed, 0xb8, 0x82, 0x7a, - 0x56, 0x52, 0x3b, 0xc4, 0xd3, 0x7c, 0xa5, 0xaf, 0xba, 0x9e, 0xed, 0x68, 0x4d, 0x72, 0x97, 0x58, - 0x4d, 0xd3, 0x92, 0x3f, 0xb4, 0xdc, 0x4b, 0x5d, 0x5f, 0x11, 0x85, 0x8a, 0x3d, 0xcf, 0x6c, 0xdf, - 0x6d, 0xb5, 0xf5, 0xbb, 0x9e, 0xd9, 0x21, 0xae, 0xa7, 0x75, 0xba, 0xe2, 0xcd, 0x12, 0x7b, 0xe3, - 0x39, 0x9a, 0x6e, 0x5a, 0xcd, 0xbb, 0x0e, 0xd1, 0x6d, 0xc7, 0x20, 0x86, 0xea, 0x76, 0x35, 0x4b, - 0x36, 0xa7, 0x69, 0x37, 0x6d, 0xf6, 0xf7, 0x2e, 0xfd, 0xc7, 0xa9, 0xe5, 0x5f, 0x86, 0x34, 0xd6, - 0xac, 0x26, 0xa9, 0x59, 0xbb, 0x36, 0x7a, 0x07, 0xe2, 0x06, 0x71, 0xf5, 0xa2, 0xb2, 0xa4, 0xdc, - 0xca, 0xdc, 0x2f, 0x2f, 0x8f, 0xf5, 0x73, 0x99, 0x95, 0x5d, 0x23, 0xae, 0xee, 0x98, 0x5d, 0xcf, - 0x76, 0x2a, 0xf1, 0x2f, 0x0e, 0x4b, 0x27, 0x30, 0xe3, 0x42, 0xff, 0x0f, 0x12, 0x6d, 0xa2, 0xb9, - 0xa4, 0x38, 0xc7, 0xd8, 0x8b, 0x01, 0xec, 0x1b, 0xf4, 0xbd, 0x60, 0xe2, 0x85, 0xcb, 0x3f, 0x88, - 0x41, 0x1e, 0x13, 0xb7, 0x6b, 0x5b, 0x2e, 0x79, 0x4c, 0x34, 0x83, 0x38, 0xe8, 0x75, 0x88, 0x79, - 0xfb, 0x56, 0x31, 0xc6, 0xc4, 0x5c, 0x0e, 0x10, 0xd3, 0x70, 0x34, 0xcb, 0xd5, 0x74, 0xcf, 0xb4, - 0x2d, 0x4c, 0x8b, 0xa2, 0x37, 0x20, 0xe3, 0x10, 0xb7, 0xd7, 0x21, 0xac, 0xc3, 0xc5, 0x38, 0xe3, - 0x3c, 0x17, 0xc0, 0x59, 0xef, 0x6a, 0x16, 0x06, 0x5e, 0x96, 0xfe, 0x47, 0xe7, 0x21, 0x65, 0xf5, - 0x3a, 0xea, 0x73, 0x72, 0xe0, 0x16, 0x13, 0x4b, 0xca, 0xad, 0x18, 0x4e, 0x5a, 0xbd, 0xce, 0x13, - 0x72, 0xe0, 0xa2, 0x2a, 0x64, 0x1c, 0xda, 0x5d, 0xd5, 0xb4, 0x76, 0x6d, 0xb7, 0x38, 0xbf, 0x14, - 0xbb, 0x95, 0xb9, 0x7f, 0x31, 0x4c, 0x29, 0x54, 0x81, 0xa2, 0x67, 0xe0, 0x48, 0x82, 0x8b, 0xea, - 0x90, 0x13, 0x2d, 0x73, 0x88, 0xe6, 0xda, 0x56, 0x31, 0xb9, 0xa4, 0xdc, 0xca, 0xdf, 0x5f, 0x0e, - 0x12, 0x33, 0xa4, 0x05, 0xfa, 0xd8, 0xeb, 0x10, 0xcc, 0xb8, 0x70, 0xd6, 0xf1, 0x3d, 0x95, 0x3f, - 0x81, 0xac, 0xff, 0x2d, 0x42, 0x90, 0xc7, 0xeb, 0xf5, 0xed, 0xa7, 0xeb, 0xea, 0xf6, 0xe6, 0x93, - 0xcd, 0xad, 0x8f, 0x36, 0x0b, 0x27, 0xd0, 0x69, 0x28, 0x08, 0xda, 0x93, 0xf5, 0x4f, 0xd4, 0x8d, - 0xda, 0xd3, 0x5a, 0xa3, 0xa0, 0xa0, 0xf3, 0x70, 0x46, 0x50, 0xf1, 0xea, 0xe6, 0xa3, 0x75, 0xb5, - 0xb2, 0xb5, 0xbd, 0xb9, 0xb6, 0x8a, 0x3f, 0x29, 0xcc, 0x2d, 0xc6, 0x7f, 0xfd, 0x0f, 0x2e, 0x9f, - 0x28, 0x3f, 0x05, 0x78, 0x44, 0x3c, 0x4c, 0x5e, 0xf4, 0x88, 0xeb, 0xa1, 0x37, 0x61, 0xbe, 0xc5, - 0x5a, 0x23, 0x4c, 0x22, 0x4c, 0xa5, 0x95, 0x14, 0xed, 0xf8, 0x97, 0x87, 0x25, 0x05, 0x0b, 0x86, - 0xb7, 0xe2, 0x3f, 0xf9, 0x61, 0x49, 0x29, 0xff, 0x8a, 0x02, 0x19, 0x26, 0x8f, 0x77, 0x0d, 0x55, - 0x47, 0x04, 0x5e, 0x99, 0xaa, 0x87, 0x71, 0xd1, 0x68, 0x19, 0x12, 0x2f, 0xb5, 0x76, 0x6f, 0x92, - 0xa1, 0x7d, 0x48, 0xdf, 0x63, 0x5e, 0xac, 0xfc, 0x67, 0x0a, 0xc0, 0xb3, 0x5e, 0x04, 0x9d, 0xa2, - 0x26, 0x3e, 0x53, 0xcd, 0xd2, 0xc4, 0x59, 0x61, 0x74, 0x16, 0xe6, 0x4d, 0xab, 0x6d, 0x5a, 0x84, - 0x99, 0x74, 0x0a, 0x8b, 0x27, 0x74, 0x1a, 0x12, 0x3b, 0x6d, 0xd3, 0x32, 0x98, 0xbd, 0xa6, 0x30, - 0x7f, 0x10, 0x8a, 0xc3, 0x90, 0x61, 0x4d, 0x8e, 0x50, 0x6f, 0xe5, 0x7f, 0x52, 0xe0, 0x4c, 0xd5, - 0xb6, 0x0c, 0x93, 0x4e, 0x1c, 0xad, 0xfd, 0x4d, 0xaa, 0xe4, 0x01, 0xa4, 0xc9, 0x7e, 0x57, 0xe5, - 0x9c, 0xb1, 0x29, 0xc3, 0x98, 0x22, 0xfb, 0x5d, 0xf6, 0x6f, 0xa2, 0xc6, 0x7e, 0x1e, 0xce, 0x8e, - 0x76, 0x2e, 0x4a, 0xe5, 0xfd, 0xb5, 0x02, 0xf9, 0x9a, 0x65, 0x7a, 0xdf, 0xa4, 0xd6, 0xfa, 0xdd, - 0x8f, 0xf9, 0xba, 0x8f, 0xee, 0x40, 0x61, 0x57, 0x33, 0xdb, 0x5b, 0x56, 0xc3, 0xee, 0xec, 0xb8, - 0x9e, 0x6d, 0x11, 0x57, 0xe8, 0x67, 0x8c, 0x2e, 0x54, 0xf5, 0x21, 0x9c, 0xec, 0x77, 0x25, 0x4a, - 0x1d, 0xbd, 0x80, 0x42, 0xcd, 0xd2, 0x1d, 0xd2, 0x21, 0x56, 0x14, 0x4a, 0xba, 0x08, 0x69, 0x53, - 0x8a, 0x63, 0x8a, 0x8a, 0xe1, 0x01, 0x41, 0x74, 0xa5, 0x07, 0x0b, 0xbe, 0x2a, 0xa3, 0xf4, 0x32, - 0x17, 0x20, 0x6d, 0x91, 0x3d, 0x75, 0x30, 0x4c, 0x31, 0x9c, 0xb2, 0xc8, 0x1e, 0x1b, 0x96, 0xf2, - 0x33, 0xc8, 0xad, 0x91, 0x36, 0xf1, 0x48, 0x64, 0x9e, 0x72, 0x1b, 0xf2, 0x52, 0x62, 0x94, 0x43, - 0xf2, 0xb9, 0x02, 0x48, 0xc8, 0xa5, 0x8b, 0x52, 0x04, 0xa3, 0x52, 0xa2, 0x6b, 0xad, 0xd7, 0x73, - 0x2c, 0xbe, 0x68, 0x72, 0x53, 0x04, 0x4e, 0x62, 0xeb, 0xe6, 0xc0, 0xdd, 0xc5, 0xfd, 0xee, 0x8e, - 0xf7, 0xf3, 0xfd, 0x78, 0x6a, 0xae, 0x10, 0x2b, 0xef, 0xc1, 0xa9, 0xa1, 0x56, 0x45, 0x3b, 0x70, - 0x71, 0xd6, 0xb2, 0xb9, 0xa5, 0xd8, 0xad, 0x6c, 0x25, 0xf9, 0xd5, 0x61, 0x29, 0xf6, 0x84, 0x1c, - 0x60, 0x46, 0x2c, 0x37, 0x60, 0xa1, 0xda, 0x26, 0x9a, 0x13, 0x91, 0x36, 0xc4, 0xe0, 0x7d, 0x02, - 0xc8, 0x2f, 0x35, 0xca, 0x01, 0x34, 0x21, 0x53, 0xd7, 0x35, 0x6b, 0xab, 0x4b, 0xfd, 0x9a, 0x8b, - 0x56, 0xe0, 0xac, 0xeb, 0xd9, 0x5d, 0x55, 0xf3, 0x54, 0x0e, 0x4e, 0x76, 0xec, 0x9e, 0x65, 0x68, - 0xce, 0x01, 0xab, 0x23, 0x85, 0x4f, 0xd1, 0xb7, 0xab, 0x1e, 0x6b, 0x48, 0x45, 0xbc, 0xa2, 0x43, - 0xd6, 0x31, 0x2d, 0x95, 0x62, 0x88, 0xb6, 0xe7, 0x0a, 0x63, 0x86, 0x8e, 0x69, 0x61, 0x4e, 0x11, - 0xbd, 0xf8, 0x25, 0x5e, 0x55, 0x04, 0x36, 0x72, 0x1d, 0xf2, 0xc2, 0x46, 0x4c, 0xcb, 0x23, 0x96, - 0x27, 0xcd, 0x24, 0xc7, 0xa9, 0x35, 0x4e, 0x1c, 0xb2, 0x88, 0xbf, 0x55, 0x20, 0xcb, 0x6b, 0x8f, - 0xd2, 0x16, 0x1e, 0x40, 0xdc, 0xb1, 0xf7, 0xb8, 0x2d, 0x64, 0xee, 0x5f, 0x08, 0x10, 0xf1, 0x84, - 0x1c, 0xf8, 0x3d, 0x2d, 0x2b, 0x8e, 0x2a, 0x90, 0xe1, 0x0d, 0x57, 0x19, 0x77, 0x6c, 0x56, 0x6e, - 0xe0, 0x5c, 0xd8, 0xde, 0x73, 0x29, 0xf4, 0x41, 0x98, 0xbc, 0x24, 0x8e, 0x4b, 0xbe, 0x39, 0xad, - 0xfe, 0xbd, 0x02, 0xa7, 0x86, 0x1a, 0xf1, 0x7f, 0x44, 0xb9, 0x7b, 0x70, 0xae, 0xda, 0x22, 0xfa, - 0xf3, 0xaa, 0x6d, 0xb9, 0xa6, 0xeb, 0x11, 0x4b, 0x3f, 0x88, 0x40, 0xc1, 0x17, 0x20, 0xbd, 0x67, - 0x7a, 0x2d, 0xd5, 0x30, 0x77, 0x77, 0xd9, 0x2c, 0x49, 0xe1, 0x14, 0x25, 0xac, 0x99, 0xbb, 0xbb, - 0x62, 0x8e, 0xa8, 0x50, 0x1c, 0xaf, 0x38, 0xda, 0x35, 0xf4, 0x0c, 0x26, 0xba, 0xdd, 0xe9, 0xf6, - 0x3c, 0x52, 0xf7, 0x34, 0xcf, 0x8d, 0xa0, 0x5f, 0xe7, 0x20, 0x69, 0x38, 0x07, 0xaa, 0xd3, 0xb3, - 0x44, 0xaf, 0xe6, 0x0d, 0xe7, 0x00, 0xf7, 0x2c, 0xd1, 0xa7, 0xbf, 0x50, 0xe0, 0xec, 0x68, 0x9d, - 0x51, 0xda, 0xc9, 0xa7, 0x90, 0xd1, 0x0c, 0xba, 0x1b, 0x35, 0x48, 0xdb, 0xd3, 0x04, 0xe4, 0x59, - 0xf1, 0x49, 0x12, 0x5b, 0xdf, 0x65, 0xbe, 0xe7, 0x5d, 0x96, 0x5b, 0xdf, 0xe5, 0xa7, 0x1f, 0x56, - 0xab, 0x9b, 0xc4, 0xdb, 0xb3, 0x9d, 0xe7, 0xac, 0x59, 0xd2, 0x10, 0x98, 0xb4, 0x35, 0x2a, 0xac, - 0xfc, 0x29, 0x9c, 0xab, 0x90, 0xa6, 0x69, 0xf9, 0xb7, 0x84, 0x51, 0x79, 0x75, 0x15, 0x8a, 0xe3, - 0xb2, 0xa3, 0x1c, 0xeb, 0x3f, 0x89, 0xc1, 0x99, 0x75, 0xcb, 0x88, 0xb4, 0xed, 0x74, 0xf9, 0xd5, - 0xed, 0x4e, 0xc7, 0xf4, 0xe4, 0x58, 0xf3, 0x27, 0xf4, 0x26, 0xa4, 0x0c, 0xa2, 0x19, 0xfd, 0x7d, - 0x48, 0xe6, 0xfe, 0x25, 0x9f, 0xd0, 0x9e, 0x67, 0xb6, 0x97, 0x5b, 0x6d, 0x7d, 0xb9, 0x21, 0x0f, - 0x16, 0x70, 0xbf, 0x38, 0xfa, 0x05, 0x38, 0x47, 0xe7, 0x9e, 0x63, 0x69, 0x6d, 0x95, 0x4b, 0x53, - 0x3d, 0xc7, 0x6c, 0x36, 0x89, 0x23, 0xb6, 0xda, 0xb7, 0x02, 0x9a, 0x57, 0x13, 0x1c, 0x55, 0xc6, - 0xd0, 0xe0, 0xe5, 0xf1, 0x19, 0x33, 0x88, 0x8c, 0xde, 0x83, 0xac, 0xf0, 0x09, 0x74, 0x03, 0x4f, - 0xb7, 0xe2, 0xb1, 0x49, 0xbd, 0xe6, 0x76, 0x20, 0xdc, 0x08, 0xa5, 0xb8, 0xe8, 0x2e, 0x85, 0x25, - 0x2f, 0x7a, 0xa6, 0x43, 0xd4, 0x7b, 0x5d, 0xbd, 0x38, 0x4f, 0xfb, 0x5e, 0xc9, 0x1f, 0x1d, 0x96, - 0x00, 0x73, 0xf2, 0xbd, 0x67, 0x55, 0x0a, 0x53, 0xf8, 0xff, 0xae, 0x8e, 0x6e, 0x41, 0xc1, 0xb2, - 0x55, 0x87, 0xec, 0x3a, 0xc4, 0x6d, 0x89, 0x6a, 0x93, 0x4c, 0x63, 0x79, 0xcb, 0xc6, 0x9c, 0xcc, - 0x44, 0x0b, 0x6b, 0xf8, 0x6d, 0x05, 0xce, 0x8e, 0x0e, 0x56, 0x94, 0xb3, 0xe4, 0x16, 0x14, 0x6c, - 0x8b, 0xa8, 0xdd, 0x96, 0xe6, 0x12, 0xa1, 0x65, 0x01, 0xa0, 0xf2, 0xb6, 0x45, 0x9e, 0x51, 0x32, - 0xd7, 0x19, 0x77, 0xed, 0xef, 0xc7, 0x53, 0xb1, 0x42, 0xbc, 0xfc, 0x19, 0x2c, 0xac, 0x1a, 0x1d, - 0xd3, 0xaa, 0x77, 0xdb, 0x66, 0x14, 0x98, 0xfb, 0x1a, 0xa4, 0x5d, 0x2a, 0x8a, 0x82, 0x3b, 0x66, - 0x40, 0x3e, 0x04, 0x95, 0x62, 0x6f, 0x9e, 0x90, 0x83, 0x01, 0xea, 0xf1, 0xd7, 0x1d, 0xe5, 0xcc, - 0x68, 0x88, 0x6e, 0x3d, 0x25, 0x4e, 0xb4, 0x30, 0xcd, 0x2f, 0x35, 0xca, 0x06, 0x7f, 0x5f, 0x81, - 0xf3, 0x4c, 0x36, 0xb3, 0x8f, 0x5d, 0xe2, 0xb0, 0xa3, 0xae, 0x08, 0x06, 0xe4, 0x2a, 0xcc, 0x7b, - 0x9a, 0xd3, 0x24, 0x7c, 0x3a, 0x27, 0x2a, 0x99, 0xaf, 0x0e, 0x4b, 0xc9, 0xba, 0x67, 0x3b, 0xa4, - 0xb6, 0x86, 0xc5, 0x2b, 0xd1, 0x3d, 0x0d, 0x16, 0x83, 0x9a, 0x10, 0x65, 0x37, 0x7f, 0xaa, 0x88, - 0x3a, 0xaa, 0x2d, 0x0e, 0x75, 0xbb, 0x6d, 0x53, 0xd7, 0xa2, 0x58, 0xa3, 0xd6, 0x21, 0xa3, 0x33, - 0x99, 0xaa, 0x77, 0xd0, 0xe5, 0x1b, 0xae, 0xfc, 0xfd, 0x6b, 0x81, 0x6d, 0x64, 0x75, 0xf2, 0x06, - 0x34, 0x0e, 0xba, 0x04, 0x83, 0xde, 0xff, 0x8f, 0xd6, 0x20, 0xc9, 0x75, 0x22, 0x81, 0xc5, 0x04, - 0x11, 0x74, 0x0e, 0x37, 0x58, 0x61, 0xe1, 0x50, 0x24, 0xab, 0xd0, 0xe7, 0x0e, 0x5c, 0x08, 0xec, - 0x6b, 0xd4, 0xfb, 0x33, 0x06, 0xd6, 0x37, 0x6c, 0xfb, 0x79, 0xaf, 0x1b, 0x81, 0x22, 0x2f, 0x01, - 0x74, 0xb4, 0x7d, 0xbe, 0x3b, 0xe0, 0x58, 0x3f, 0x81, 0xd3, 0x1d, 0x6d, 0x9f, 0xd5, 0xe2, 0xa2, - 0x22, 0x24, 0x1d, 0x0e, 0x08, 0x85, 0x77, 0x91, 0x8f, 0x7d, 0xdc, 0x48, 0xdd, 0xca, 0x7f, 0x50, - 0xdc, 0xe8, 0x6f, 0x56, 0x94, 0x9e, 0xee, 0x3d, 0x98, 0xef, 0xb7, 0x2e, 0x76, 0xac, 0x83, 0x66, - 0xc1, 0x87, 0xb6, 0x61, 0xa1, 0xeb, 0x90, 0x5d, 0xe2, 0xe9, 0x2d, 0x62, 0xc8, 0xae, 0xc6, 0x8e, - 0x29, 0xac, 0x30, 0x10, 0xc1, 0x75, 0x53, 0xfe, 0x0d, 0x05, 0x4e, 0x3d, 0x26, 0x9a, 0xe3, 0xed, - 0x10, 0xcd, 0x6b, 0xec, 0x47, 0xb1, 0x1a, 0x3f, 0x80, 0x98, 0x65, 0xef, 0x09, 0xcc, 0x33, 0x79, - 0xc1, 0x15, 0xcd, 0xa2, 0xe5, 0x85, 0x01, 0x7e, 0x17, 0x4e, 0x0f, 0x37, 0x27, 0x4a, 0xcb, 0xfb, - 0xe3, 0x18, 0xa4, 0x1f, 0x55, 0x23, 0xe8, 0xe2, 0x3b, 0x62, 0xbf, 0x1d, 0xae, 0xff, 0x7e, 0x35, - 0xcb, 0x8f, 0xaa, 0x4f, 0xc8, 0x81, 0xdc, 0x0d, 0x50, 0x2e, 0xb4, 0x0a, 0x69, 0xaf, 0x45, 0xd7, - 0x5a, 0xbb, 0x6d, 0x08, 0x34, 0x31, 0x93, 0x9a, 0x06, 0x5c, 0xa8, 0x0d, 0x67, 0xbc, 0x7d, 0x8b, - 0x2d, 0xe1, 0x6a, 0x53, 0x57, 0x07, 0xe2, 0x12, 0xb3, 0x88, 0x5b, 0xa4, 0xe2, 0x8e, 0x0e, 0x4b, - 0xa8, 0xb1, 0x6f, 0xd1, 0x1e, 0x3e, 0xaa, 0x36, 0xa4, 0x00, 0x8c, 0x3c, 0x41, 0xd3, 0xfb, 0xb4, - 0xc5, 0xe7, 0x90, 0x60, 0xbd, 0x40, 0xe7, 0x21, 0x46, 0x17, 0x49, 0x65, 0x78, 0x91, 0xa4, 0x34, - 0xd6, 0x29, 0x59, 0xc1, 0x71, 0xc6, 0x7e, 0xc0, 0xc5, 0x2d, 0x40, 0xd8, 0xc1, 0x07, 0x00, 0x54, - 0x85, 0x51, 0x8e, 0xfe, 0x9f, 0xc7, 0x20, 0xff, 0xac, 0xe7, 0xb6, 0xa2, 0xb1, 0xf2, 0x2a, 0x40, - 0xb7, 0xe7, 0xb6, 0x88, 0xa3, 0x7a, 0xfb, 0x96, 0xe8, 0xf0, 0x94, 0xc0, 0x8d, 0xec, 0x31, 0xe7, - 0x6b, 0xec, 0x5b, 0x68, 0x4b, 0x08, 0x21, 0xea, 0x20, 0xfa, 0x73, 0x67, 0x86, 0x5d, 0x42, 0x63, - 0xdf, 0x7a, 0x4a, 0x3c, 0x6d, 0x48, 0x20, 0xa1, 0x02, 0xdf, 0x81, 0x24, 0x7d, 0x50, 0x3d, 0xfb, - 0x38, 0x86, 0x35, 0x4f, 0x79, 0x1a, 0xb6, 0x9c, 0xb9, 0x89, 0xe3, 0xcd, 0x5c, 0xf4, 0x36, 0xa4, - 0x79, 0xa5, 0x74, 0x15, 0x9b, 0x67, 0xab, 0x58, 0x90, 0x26, 0x84, 0xee, 0xd9, 0xfa, 0x95, 0x62, - 0x35, 0xd2, 0xd5, 0xeb, 0x34, 0x24, 0x76, 0x6d, 0x47, 0x27, 0x02, 0x88, 0xf2, 0x87, 0xbe, 0x63, - 0x4e, 0x15, 0xd2, 0xe5, 0xdf, 0x55, 0xe0, 0x64, 0x7f, 0xdc, 0xa2, 0x74, 0xca, 0xd5, 0x21, 0xed, - 0x1f, 0x7f, 0x08, 0xa9, 0xc6, 0xcb, 0x7f, 0x34, 0x07, 0x27, 0x3f, 0xe8, 0x11, 0xe7, 0x20, 0x1a, - 0xb3, 0xaa, 0xf0, 0x40, 0xe0, 0xdc, 0x2b, 0x9a, 0x02, 0x0b, 0x0d, 0xde, 0x80, 0x93, 0x7b, 0x9a, - 0xe9, 0xa9, 0xbb, 0xb6, 0xa3, 0xf6, 0xba, 0x86, 0xe6, 0xc9, 0x28, 0x4c, 0x8e, 0x92, 0x1f, 0xda, - 0xce, 0x36, 0x23, 0x22, 0x02, 0xe8, 0xb9, 0x65, 0xef, 0x59, 0x2a, 0x25, 0x9b, 0x56, 0x93, 0xaa, - 0xc1, 0x2d, 0xc6, 0xd9, 0x19, 0xe2, 0xcf, 0xfc, 0xe3, 0x61, 0x69, 0xa5, 0x69, 0x7a, 0xad, 0xde, - 0xce, 0xb2, 0x6e, 0x77, 0xee, 0xf6, 0x1b, 0x62, 0xec, 0x0c, 0xfe, 0xdf, 0xed, 0x3e, 0x6f, 0xde, - 0x65, 0x51, 0xd8, 0x5e, 0xcf, 0x34, 0x96, 0xb7, 0xb7, 0x6b, 0x6b, 0xb8, 0xc0, 0x44, 0x7e, 0xc4, - 0x25, 0x36, 0xf6, 0xfb, 0x7b, 0x89, 0xaf, 0x14, 0x28, 0x0c, 0xf4, 0x14, 0xe5, 0x30, 0xae, 0x43, - 0xe6, 0x45, 0x8f, 0x38, 0x26, 0x31, 0x8e, 0x3d, 0x8e, 0x20, 0x18, 0xe9, 0xd4, 0xf9, 0x14, 0xb2, - 0x43, 0x7a, 0x88, 0x7d, 0x3d, 0x3d, 0x64, 0xf6, 0x06, 0x2a, 0x28, 0xff, 0x97, 0x02, 0xa7, 0x31, - 0x71, 0xed, 0xf6, 0x4b, 0xc2, 0x8f, 0xac, 0x22, 0xb0, 0x94, 0x2d, 0x10, 0xa7, 0x43, 0xea, 0xd7, - 0x31, 0x98, 0x34, 0x97, 0xc1, 0x7d, 0xc7, 0xbc, 0xeb, 0x69, 0x5e, 0x8f, 0x9f, 0xb1, 0x05, 0x23, - 0x51, 0x9f, 0x0a, 0xeb, 0xac, 0x2c, 0x16, 0x3c, 0x74, 0x0f, 0xde, 0xb5, 0x4d, 0xd7, 0xb6, 0xe4, - 0x11, 0x38, 0x7f, 0x12, 0xa3, 0xff, 0x73, 0x70, 0x66, 0xa4, 0xff, 0x51, 0x7a, 0xf6, 0xbf, 0x99, - 0x83, 0xf3, 0xc3, 0xe2, 0x23, 0x3a, 0xf8, 0xff, 0xdf, 0xa1, 0x63, 0xf4, 0x18, 0x72, 0x1d, 0xd3, - 0x52, 0x07, 0xeb, 0xef, 0x31, 0x3c, 0x78, 0x96, 0xee, 0x9e, 0x86, 0x97, 0xe0, 0x72, 0x1e, 0xb2, - 0x9b, 0xb6, 0xdd, 0x87, 0xc0, 0xe5, 0x1c, 0x64, 0xf8, 0x33, 0x53, 0x28, 0xdd, 0x74, 0x05, 0x69, - 0x3b, 0xca, 0x11, 0xfd, 0x55, 0x05, 0xb2, 0x11, 0x6d, 0x84, 0x5f, 0x2d, 0xf0, 0x28, 0x34, 0xd1, - 0x80, 0xdc, 0xff, 0xc0, 0xce, 0xf9, 0xf7, 0x14, 0x40, 0x0d, 0xa7, 0x67, 0xe9, 0x9a, 0x47, 0x36, - 0xec, 0x66, 0x04, 0x7d, 0x3c, 0x0d, 0x09, 0xd3, 0x32, 0xc8, 0x3e, 0xeb, 0x63, 0x1c, 0xf3, 0x07, - 0x74, 0x0f, 0x52, 0x22, 0x9d, 0x83, 0xc7, 0x4f, 0x63, 0x95, 0xb3, 0x47, 0x87, 0xa5, 0x24, 0x4f, - 0xde, 0x58, 0xfb, 0x6a, 0xf0, 0x17, 0x27, 0x79, 0xfe, 0x86, 0x0c, 0x2c, 0x7f, 0x0a, 0xa7, 0x86, - 0xda, 0x17, 0x65, 0xe7, 0x7f, 0xc4, 0xce, 0xe7, 0x59, 0x8f, 0xa3, 0x3a, 0x30, 0x78, 0xa5, 0x34, - 0x1c, 0xf4, 0x2e, 0x40, 0xd7, 0x21, 0x2f, 0x55, 0xce, 0x1a, 0x9b, 0x89, 0x35, 0x4d, 0x39, 0x18, - 0x41, 0x68, 0xea, 0xc7, 0x0a, 0x9c, 0x8e, 0xfa, 0xfc, 0xe3, 0x1b, 0xec, 0x4e, 0x1d, 0x0a, 0xec, - 0xb1, 0x66, 0xed, 0xda, 0x91, 0x9d, 0x41, 0xfd, 0xa6, 0x02, 0x0b, 0x3e, 0xa9, 0x51, 0xae, 0xfd, - 0xaf, 0x96, 0x80, 0xf5, 0x5d, 0xba, 0x1a, 0xfb, 0x2d, 0x30, 0x4a, 0xfb, 0xfe, 0x4f, 0x05, 0xce, - 0x56, 0x79, 0x60, 0x81, 0x85, 0x4d, 0xdc, 0x5e, 0x27, 0x02, 0x9b, 0x28, 0x42, 0xf2, 0x25, 0x71, - 0x5c, 0xd3, 0xe6, 0xcb, 0x50, 0x0e, 0xcb, 0x47, 0xf4, 0x8b, 0x90, 0xd1, 0x45, 0x3d, 0x72, 0x9e, - 0x67, 0x2b, 0x35, 0x2a, 0xe0, 0x15, 0xa1, 0xcb, 0xd1, 0x61, 0x09, 0x64, 0xcb, 0x6b, 0x6b, 0x18, - 0xa4, 0xf4, 0x9a, 0x81, 0x16, 0x21, 0xe5, 0x5a, 0x5a, 0xd7, 0x6d, 0xd9, 0xf2, 0xa0, 0xb6, 0xff, - 0x2c, 0xc6, 0xfa, 0x7b, 0x70, 0x6e, 0xac, 0xf3, 0x51, 0x6a, 0x77, 0x07, 0x4a, 0x6b, 0xa4, 0xeb, - 0x10, 0xea, 0x9a, 0x8c, 0x0f, 0x89, 0x63, 0xee, 0x1e, 0x44, 0xa7, 0x65, 0xd1, 0x87, 0x26, 0x2c, - 0x85, 0xd7, 0x11, 0x65, 0x67, 0x7e, 0x9c, 0x84, 0xdc, 0xfa, 0x7e, 0xd7, 0x76, 0xbc, 0x3a, 0x07, - 0x12, 0x68, 0x0d, 0x52, 0x5d, 0xc7, 0x7e, 0x69, 0x4a, 0xc1, 0xf9, 0xc0, 0x38, 0xc3, 0x10, 0xcf, - 0x33, 0x51, 0x1e, 0xf7, 0x39, 0x11, 0x86, 0xf4, 0x86, 0xad, 0x6b, 0xed, 0x87, 0x66, 0x5b, 0xce, - 0x8c, 0xe5, 0x69, 0x62, 0x96, 0xfb, 0x1c, 0xcf, 0x34, 0xaf, 0x25, 0xfd, 0x43, 0x9f, 0x88, 0x1e, - 0x41, 0xea, 0xb1, 0xe7, 0x75, 0xe9, 0x4b, 0xe1, 0x5c, 0xae, 0x4f, 0x15, 0x49, 0x19, 0x84, 0xa4, - 0x3e, 0x33, 0xc2, 0xb0, 0xf0, 0xc8, 0xb6, 0x9b, 0x6d, 0x52, 0x6d, 0xdb, 0x3d, 0xa3, 0x6a, 0x5b, - 0xbb, 0x66, 0x53, 0x6c, 0x56, 0xaf, 0x4d, 0x95, 0xf8, 0xa8, 0x5a, 0xc7, 0xe3, 0xec, 0xe8, 0x3b, - 0x90, 0xaa, 0xaf, 0x08, 0x51, 0x1c, 0xfb, 0x5c, 0x9d, 0x2a, 0xaa, 0xbe, 0x82, 0xfb, 0x4c, 0xe8, - 0x31, 0x64, 0x56, 0x3f, 0xeb, 0x39, 0x44, 0xc8, 0x98, 0x67, 0x32, 0x6e, 0x4c, 0x95, 0xc1, 0x78, - 0xb0, 0x9f, 0x75, 0xf1, 0x36, 0xe4, 0x86, 0x34, 0x89, 0x10, 0xc4, 0xbb, 0x54, 0x69, 0x74, 0x38, - 0xd3, 0x98, 0xfd, 0xe7, 0x76, 0xb6, 0x78, 0x03, 0xe2, 0x54, 0x2b, 0x74, 0x6e, 0xef, 0x68, 0x2e, - 0xd9, 0x76, 0x4c, 0x51, 0x48, 0x3e, 0x8a, 0x72, 0x7f, 0xa5, 0xc0, 0x5c, 0x7d, 0x85, 0xa2, 0xbf, - 0x9d, 0x9e, 0xfe, 0x9c, 0x78, 0xa2, 0x94, 0x78, 0x62, 0xa8, 0xd0, 0x21, 0xbb, 0x26, 0x5f, 0xfc, - 0xd3, 0x58, 0x3c, 0xa1, 0x4b, 0x00, 0x9a, 0xae, 0x13, 0xd7, 0x65, 0x81, 0x8d, 0x18, 0x7b, 0x97, - 0xe6, 0x94, 0x27, 0xe4, 0x80, 0xb2, 0xb9, 0x44, 0x77, 0x08, 0x9f, 0xc9, 0x69, 0x2c, 0x9e, 0x28, - 0x9b, 0x47, 0x3a, 0x5d, 0xd5, 0xb3, 0x9f, 0x13, 0x8b, 0x69, 0x33, 0x8d, 0xd3, 0x94, 0xd2, 0xa0, - 0x04, 0xea, 0x02, 0x88, 0x65, 0x74, 0x6d, 0xd3, 0xf2, 0x98, 0x9a, 0xd2, 0xb8, 0xff, 0x4c, 0x45, - 0x3a, 0xa4, 0x69, 0x8a, 0x94, 0xcf, 0x34, 0x16, 0x4f, 0xa2, 0x1b, 0x5b, 0x10, 0x7b, 0x54, 0xad, - 0x1f, 0xbb, 0x1b, 0x08, 0xe2, 0x5a, 0x4f, 0x18, 0x5d, 0x1a, 0xb3, 0xff, 0x42, 0xe0, 0xaf, 0x29, - 0x90, 0x60, 0xaa, 0x47, 0x17, 0x21, 0xad, 0xdb, 0x96, 0xa7, 0x99, 0x96, 0x98, 0x37, 0x69, 0x3c, - 0x20, 0x84, 0x4a, 0xbe, 0x02, 0x59, 0x4d, 0xd7, 0xed, 0x9e, 0xe5, 0xa9, 0x96, 0xd6, 0x21, 0xa2, - 0x86, 0x8c, 0xa0, 0x6d, 0x6a, 0x1d, 0x82, 0x4a, 0x20, 0x1f, 0x99, 0x12, 0xb9, 0xa6, 0x40, 0x90, - 0xfa, 0x61, 0x21, 0xe1, 0x37, 0xfe, 0x50, 0x81, 0x85, 0x8f, 0x1c, 0xd3, 0x23, 0x15, 0xcd, 0xd3, - 0x5b, 0x11, 0x38, 0xfd, 0xb7, 0x20, 0x6d, 0x68, 0x9e, 0xc6, 0x33, 0x7c, 0xe7, 0x26, 0x73, 0x8b, - 0x69, 0x46, 0xcb, 0xb3, 0x2c, 0x5f, 0x04, 0x71, 0xfa, 0x9f, 0xaf, 0x07, 0x98, 0xfd, 0x1f, 0x84, - 0x84, 0xfc, 0xad, 0x8c, 0xd2, 0xa1, 0xfd, 0xdd, 0x9c, 0x74, 0x68, 0x11, 0xf4, 0xfe, 0x3d, 0x48, - 0x8a, 0xfd, 0x95, 0xe8, 0xfb, 0xd2, 0xb4, 0xf9, 0x28, 0x63, 0x1a, 0x82, 0x0d, 0x55, 0x00, 0x5c, - 0x4f, 0x73, 0x3c, 0xb6, 0x33, 0x9a, 0x29, 0x02, 0x2c, 0xfd, 0x1e, 0x63, 0xa3, 0x54, 0xb4, 0x09, - 0x99, 0xce, 0x4b, 0x5d, 0x57, 0x77, 0xcd, 0xb6, 0x27, 0x82, 0xbf, 0xf9, 0x21, 0x21, 0xb2, 0x25, - 0x4f, 0x3f, 0xac, 0x56, 0x1f, 0xb2, 0x42, 0x3c, 0x06, 0x3b, 0x78, 0xc6, 0x40, 0x25, 0xf0, 0xff, - 0xe8, 0xdb, 0x20, 0x12, 0xc7, 0x54, 0xd7, 0xf5, 0xd8, 0xf4, 0x4a, 0x55, 0x72, 0x47, 0x87, 0xa5, - 0x34, 0x66, 0xd4, 0x7a, 0xbd, 0x81, 0xd3, 0xbc, 0x40, 0xdd, 0x95, 0x8b, 0xea, 0x0f, 0x14, 0xc8, - 0x55, 0x7a, 0xed, 0xe7, 0x5b, 0xdd, 0x7a, 0xaf, 0xd3, 0xd1, 0x9c, 0x03, 0x74, 0x41, 0x5a, 0x86, - 0xf9, 0x19, 0x61, 0x9a, 0x8d, 0x89, 0xa1, 0x37, 0x3f, 0x23, 0x74, 0xe8, 0x45, 0x92, 0x0a, 0xa5, - 0xf3, 0x0c, 0x94, 0xab, 0x90, 0x63, 0x7b, 0x02, 0x95, 0x58, 0x9e, 0x63, 0x12, 0xbe, 0xff, 0x8c, - 0xe1, 0x2c, 0x23, 0xae, 0x73, 0x1a, 0xba, 0x0e, 0x79, 0xf7, 0xc0, 0xf5, 0x48, 0x47, 0xe5, 0xd9, - 0xf4, 0x3c, 0xa9, 0x32, 0x86, 0x73, 0x9c, 0x8a, 0x39, 0xb1, 0xfc, 0x6f, 0x73, 0x90, 0x97, 0xa3, - 0x1c, 0x25, 0x98, 0xab, 0x40, 0x62, 0xd7, 0x6c, 0xf7, 0x63, 0x24, 0xe1, 0xee, 0x57, 0x4a, 0x5a, - 0xa6, 0x4e, 0x56, 0x42, 0x3b, 0xc6, 0xba, 0xf8, 0xa5, 0x02, 0x71, 0xb6, 0x5e, 0xdd, 0x83, 0x38, - 0x9b, 0x36, 0xca, 0x2c, 0xd3, 0x86, 0x15, 0xed, 0x7b, 0xea, 0xb9, 0x81, 0xa7, 0x66, 0x5e, 0xb2, - 0xa5, 0x3d, 0xb8, 0x77, 0x9f, 0x0d, 0x55, 0x16, 0x8b, 0x27, 0x54, 0x81, 0x14, 0x61, 0x6d, 0x21, - 0x86, 0x58, 0x2d, 0x82, 0xac, 0x73, 0x68, 0xd0, 0xe4, 0x14, 0x95, 0x7c, 0xe8, 0x3c, 0xc4, 0xa8, - 0x0d, 0x24, 0xf9, 0x69, 0xfa, 0xd1, 0x61, 0x29, 0x46, 0x47, 0x9f, 0xd2, 0x78, 0x48, 0xea, 0xfd, - 0x78, 0x2a, 0x5e, 0x48, 0x94, 0xff, 0x34, 0x0e, 0xb9, 0x5a, 0x27, 0xa2, 0x49, 0xb5, 0x3a, 0xac, - 0xe3, 0xa0, 0x35, 0x7c, 0xa8, 0xae, 0x71, 0x15, 0x0f, 0x7b, 0xa5, 0xd8, 0xf1, 0xbc, 0x52, 0x8d, - 0xae, 0x10, 0xe2, 0xe6, 0x01, 0xad, 0xff, 0x5b, 0x53, 0xeb, 0x6f, 0x68, 0x3b, 0x6d, 0x82, 0x29, - 0x4f, 0x3f, 0x20, 0xc6, 0x04, 0xa0, 0x9f, 0x65, 0x0b, 0x11, 0x9f, 0xda, 0xf3, 0xb3, 0x4f, 0xed, - 0x24, 0xb1, 0x0c, 0x4a, 0x5b, 0xdc, 0x17, 0x86, 0xf2, 0x06, 0xc4, 0x0c, 0x53, 0x6a, 0x72, 0x56, - 0x17, 0x43, 0x59, 0xa6, 0xd8, 0x4b, 0xdc, 0x6f, 0x2f, 0xfe, 0x48, 0xe3, 0xe2, 0x16, 0xc0, 0xa0, - 0x57, 0x68, 0x09, 0xe6, 0xed, 0xb6, 0x41, 0xa1, 0x3b, 0x6d, 0x42, 0xae, 0x92, 0x3e, 0x3a, 0x2c, - 0x25, 0xb6, 0xda, 0x46, 0x6d, 0x0d, 0x27, 0xec, 0xb6, 0x51, 0x33, 0xd8, 0x85, 0x0d, 0xb2, 0xa7, - 0xb2, 0x7b, 0x2a, 0x2c, 0x3f, 0x01, 0x27, 0x2d, 0xb2, 0xb7, 0x46, 0x5c, 0xdd, 0xbf, 0xfc, 0x08, - 0x6b, 0xf9, 0x7d, 0x05, 0xf2, 0x52, 0x83, 0xd1, 0x4e, 0xce, 0x94, 0xd9, 0x11, 0x06, 0x1f, 0x3b, - 0x9e, 0xc1, 0x4b, 0x3e, 0x91, 0xa0, 0xf7, 0x7d, 0x05, 0x4e, 0xf1, 0x24, 0x0a, 0x5d, 0xf3, 0xa8, - 0x7b, 0xfc, 0xfa, 0x56, 0x7d, 0x1b, 0x0a, 0x8e, 0x66, 0x19, 0x76, 0xc7, 0xfc, 0x8c, 0xf0, 0x0d, - 0xb0, 0x2b, 0x52, 0x81, 0x4e, 0xf6, 0xe9, 0x6c, 0xab, 0x27, 0x4f, 0xa3, 0x7f, 0xaa, 0xc0, 0xe9, - 0xe1, 0x36, 0x44, 0xa9, 0xab, 0x27, 0x23, 0xd1, 0xde, 0xd7, 0x02, 0x84, 0x04, 0xd5, 0xce, 0xa3, - 0xb6, 0xc3, 0x81, 0xdf, 0xc5, 0xf7, 0x20, 0xc1, 0xc8, 0xaf, 0xe0, 0xd1, 0x84, 0xc2, 0x5b, 0xb0, - 0xb0, 0x6a, 0x18, 0xf5, 0xba, 0x30, 0xba, 0xaf, 0xad, 0x6d, 0x09, 0x2d, 0xe6, 0x82, 0xa0, 0x85, - 0xbf, 0xa6, 0x28, 0xa1, 0x45, 0x13, 0xf2, 0x22, 0x43, 0x29, 0x9a, 0xe3, 0xb2, 0x3d, 0x0a, 0x81, - 0x84, 0x91, 0xf0, 0x87, 0xc1, 0x4d, 0x81, 0x7e, 0x45, 0x51, 0x76, 0xa0, 0x0d, 0xa7, 0xa4, 0xdc, - 0x88, 0x4e, 0xa7, 0x27, 0xf5, 0x82, 0x1d, 0x71, 0xf8, 0x6b, 0x8b, 0xb2, 0x2b, 0xff, 0x7e, 0x16, - 0xb2, 0xa2, 0xfd, 0xdb, 0x96, 0x69, 0x5b, 0xe8, 0x2e, 0xc4, 0x9a, 0x02, 0xd0, 0x67, 0x02, 0xc1, - 0xd1, 0xe0, 0x82, 0x15, 0xa6, 0x25, 0x29, 0x43, 0xb7, 0xe7, 0x05, 0xc4, 0x89, 0x07, 0xc1, 0xc2, - 0x01, 0x43, 0xb7, 0xe7, 0xa1, 0x0f, 0xe0, 0xa4, 0x3e, 0xb8, 0xea, 0xa2, 0x52, 0xe6, 0x58, 0x68, - 0x1e, 0x5e, 0xe0, 0x8d, 0x1f, 0x9c, 0xd7, 0x87, 0xc8, 0x68, 0xd5, 0x7f, 0xd7, 0x22, 0x1e, 0xba, - 0x6b, 0x1c, 0xbd, 0xde, 0xe1, 0xbb, 0x90, 0x81, 0xde, 0x80, 0x79, 0x83, 0xe5, 0xf4, 0x8b, 0x5d, - 0x67, 0x90, 0x4b, 0x1c, 0xba, 0x34, 0x81, 0x45, 0x79, 0xf4, 0x18, 0xb2, 0xfc, 0x1f, 0x4f, 0xe5, - 0x10, 0x2b, 0xd8, 0xf5, 0x70, 0x7e, 0x9f, 0xcd, 0xe0, 0x8c, 0x31, 0xa0, 0xa1, 0xfb, 0x10, 0x77, - 0x75, 0x8d, 0x6f, 0xb9, 0x82, 0xe3, 0x5e, 0xbe, 0x5c, 0x6c, 0xcc, 0xca, 0xa2, 0x8f, 0x60, 0x61, - 0x87, 0x34, 0x4d, 0x4b, 0xf5, 0x06, 0xb1, 0x86, 0x62, 0x6a, 0x2c, 0xbc, 0xd1, 0xf7, 0xea, 0xc1, - 0xe9, 0xa6, 0xb8, 0xb0, 0x33, 0xf2, 0x82, 0x0e, 0x13, 0x5b, 0x94, 0x7d, 0x62, 0xd3, 0xa1, 0xc3, - 0x14, 0x98, 0x07, 0x8a, 0xf3, 0x64, 0x88, 0x8c, 0xd6, 0x21, 0xa3, 0x51, 0x5f, 0xa9, 0xb2, 0x54, - 0xbc, 0x22, 0x84, 0x9e, 0x14, 0x8c, 0x25, 0x05, 0x62, 0xd0, 0xfa, 0xa4, 0x81, 0x98, 0x0e, 0x71, - 0x9a, 0xa4, 0x98, 0x99, 0x2c, 0xc6, 0x1f, 0x7b, 0x10, 0x62, 0x18, 0x09, 0x3d, 0x81, 0x5c, 0x4b, - 0xe6, 0xa7, 0xb0, 0xa0, 0x50, 0x36, 0xf4, 0xa8, 0x20, 0x20, 0xad, 0x06, 0x67, 0x5b, 0x3e, 0x22, - 0xfa, 0x36, 0xcc, 0x35, 0xf5, 0x62, 0x8e, 0x49, 0xb8, 0x38, 0x29, 0x89, 0x04, 0xcf, 0x35, 0x75, - 0xf4, 0x0e, 0xa4, 0x78, 0x98, 0x7d, 0xdf, 0x2a, 0xe6, 0x43, 0x27, 0xef, 0x70, 0x86, 0x03, 0x66, - 0xe9, 0x00, 0xb4, 0xae, 0xc7, 0x90, 0xe5, 0xb1, 0x80, 0x36, 0x4b, 0x6f, 0x2a, 0x9e, 0x0c, 0x35, - 0xb8, 0xf1, 0xdc, 0x2c, 0xcc, 0x6f, 0x85, 0x72, 0x1a, 0xda, 0x84, 0xbc, 0xc3, 0xc3, 0x3f, 0x22, - 0x29, 0xbf, 0x58, 0x60, 0xb2, 0x6e, 0x06, 0xbb, 0x92, 0xb1, 0xa0, 0x27, 0xce, 0x39, 0x7e, 0x2a, - 0xfa, 0x1e, 0x9c, 0x1e, 0x96, 0x27, 0xa6, 0xc4, 0x02, 0x93, 0xfa, 0xed, 0xa9, 0x52, 0xfd, 0x33, - 0x03, 0x39, 0x63, 0xaf, 0xd0, 0x03, 0x48, 0xf0, 0x31, 0x47, 0x4c, 0x60, 0x29, 0x68, 0xef, 0xe6, - 0x1f, 0x6e, 0x5e, 0x9a, 0x2a, 0xcc, 0x13, 0x31, 0x10, 0xb5, 0x6d, 0x37, 0x8b, 0xa7, 0x42, 0x15, - 0x36, 0x1e, 0xca, 0xc1, 0x19, 0x6f, 0x40, 0xa3, 0x36, 0xe3, 0x70, 0xba, 0x38, 0x9c, 0x3f, 0x1d, - 0x6a, 0x33, 0x01, 0x81, 0x11, 0x9c, 0x75, 0x7c, 0x44, 0x36, 0x8e, 0x3c, 0x7b, 0x4d, 0x65, 0xd3, - 0xfe, 0x4c, 0xf8, 0x38, 0x8e, 0xdd, 0xc4, 0xc0, 0x19, 0x67, 0x40, 0x43, 0x0d, 0x28, 0x88, 0x04, - 0x78, 0x55, 0x1e, 0xf1, 0x16, 0xcf, 0x32, 0x69, 0xb7, 0x03, 0x7d, 0x6a, 0xd0, 0x91, 0x36, 0x3e, - 0xa9, 0x0f, 0xd3, 0x51, 0x17, 0x16, 0x8d, 0xfe, 0xe1, 0xa9, 0xfa, 0x92, 0x9d, 0x9e, 0x0e, 0xe4, - 0x9f, 0x63, 0xf2, 0xef, 0x07, 0xba, 0xb9, 0x89, 0xa7, 0xba, 0xb8, 0x68, 0x84, 0x14, 0xa0, 0xce, - 0x8c, 0xc9, 0x57, 0xf5, 0xc1, 0x05, 0x85, 0x62, 0x31, 0xd4, 0x99, 0x85, 0x5c, 0xa2, 0xc0, 0x05, - 0x7d, 0xe4, 0x05, 0xf5, 0xac, 0x96, 0x6d, 0x77, 0x8b, 0xe7, 0x43, 0x3d, 0xab, 0x2f, 0x2a, 0x8a, - 0x59, 0x59, 0x3a, 0x49, 0x4d, 0xcb, 0xf4, 0xd8, 0x02, 0xb5, 0x18, 0x3a, 0x49, 0x87, 0x6f, 0x55, - 0xe2, 0xa4, 0xc9, 0x9f, 0xe9, 0xd4, 0xf2, 0x44, 0x30, 0x49, 0x98, 0xca, 0xc5, 0xd0, 0xa9, 0x15, - 0x14, 0x75, 0xc2, 0x39, 0xcf, 0x4f, 0xa5, 0x53, 0x8b, 0x3b, 0xbd, 0x11, 0xa9, 0x97, 0x42, 0xa7, - 0x56, 0x68, 0x42, 0x2f, 0x46, 0xda, 0xd8, 0x2b, 0x54, 0x01, 0x60, 0x02, 0xd9, 0x7d, 0xf1, 0xe2, - 0xe5, 0xd0, 0x35, 0x74, 0x34, 0xa6, 0x84, 0xd3, 0x6d, 0x49, 0xa1, 0x8e, 0x99, 0x01, 0x17, 0x75, - 0x47, 0xf3, 0xf4, 0x56, 0xb1, 0x14, 0xea, 0x98, 0xc7, 0x8e, 0xd6, 0x30, 0xec, 0xf5, 0x49, 0x74, - 0x29, 0xe6, 0x1b, 0xeb, 0xe2, 0xd2, 0x94, 0x9d, 0x5c, 0x7f, 0x29, 0xe6, 0xe5, 0xd1, 0x77, 0x20, - 0xfd, 0xa2, 0x47, 0x9c, 0x03, 0xe6, 0x58, 0xaf, 0x84, 0x7e, 0x07, 0x60, 0x24, 0xc9, 0x07, 0xa7, - 0x5e, 0x08, 0x02, 0xad, 0x9a, 0x6f, 0x71, 0x8a, 0xe5, 0xd0, 0xaa, 0x87, 0x36, 0xb5, 0x58, 0x94, - 0x47, 0x1a, 0x9c, 0xe1, 0xe3, 0x23, 0xf2, 0x80, 0x1d, 0x91, 0x70, 0x5b, 0xbc, 0xca, 0x04, 0x85, - 0xee, 0x1b, 0x02, 0x53, 0x91, 0xf1, 0x29, 0x6d, 0xfc, 0x1d, 0x75, 0x3e, 0x62, 0xf9, 0xe4, 0x7b, - 0x8d, 0xe2, 0xb5, 0x50, 0xe7, 0x13, 0xb0, 0x29, 0xc3, 0x59, 0xcd, 0x47, 0xe4, 0x8b, 0xa8, 0xa1, - 0xba, 0xae, 0x47, 0x01, 0x7e, 0xf1, 0xfa, 0x84, 0x45, 0x74, 0x64, 0xbf, 0xc1, 0x6e, 0xb0, 0xd4, - 0x39, 0x1f, 0x4b, 0x7c, 0x6e, 0x13, 0xcd, 0x11, 0x8e, 0xfe, 0x46, 0xa8, 0x98, 0xb1, 0x7b, 0x8b, - 0x18, 0xf4, 0x3e, 0x89, 0x82, 0x0d, 0x47, 0xde, 0xe1, 0x51, 0x5d, 0x4f, 0xf3, 0xdc, 0xe2, 0xcd, - 0x50, 0xb0, 0x11, 0x78, 0xc3, 0x08, 0xe7, 0x9d, 0x21, 0x32, 0x7a, 0x1b, 0x92, 0xe2, 0x7a, 0x44, - 0xf1, 0xd6, 0x04, 0x7c, 0xec, 0xdf, 0x87, 0x60, 0xc9, 0xc1, 0xfd, 0x3c, 0xbf, 0x5b, 0xc1, 0x3b, - 0x76, 0x7b, 0x82, 0x9f, 0x1f, 0xdb, 0x09, 0x50, 0x3f, 0x3f, 0x20, 0xbe, 0x15, 0xff, 0x82, 0xef, - 0xe9, 0x2f, 0x14, 0x2e, 0x96, 0x7f, 0x74, 0x16, 0x72, 0x12, 0x94, 0x73, 0xc0, 0xfd, 0xba, 0x1f, - 0x70, 0x5f, 0x0e, 0x03, 0xdc, 0x9c, 0x83, 0x23, 0xee, 0xd7, 0xfd, 0x88, 0xfb, 0x72, 0x18, 0xe2, - 0x96, 0x1c, 0x14, 0x72, 0xe3, 0x30, 0xc8, 0x7d, 0x7b, 0x06, 0xc8, 0x2d, 0x04, 0x8d, 0x62, 0xee, - 0xca, 0x38, 0xe6, 0xbe, 0x36, 0x19, 0x73, 0x0b, 0x41, 0x3e, 0xd0, 0xfd, 0xe6, 0x08, 0xe8, 0xbe, - 0x32, 0x01, 0x74, 0x0b, 0x6e, 0x89, 0xba, 0x6b, 0x81, 0xa8, 0xfb, 0xc6, 0x34, 0xd4, 0x2d, 0xa4, - 0x0c, 0xc1, 0xee, 0x95, 0x21, 0xd8, 0x5d, 0x0a, 0x85, 0xdd, 0x82, 0x97, 0xe3, 0xee, 0x8f, 0xc3, - 0x71, 0xf7, 0xb7, 0x66, 0xc2, 0xdd, 0x42, 0xda, 0x38, 0xf0, 0xc6, 0x61, 0xc0, 0xfb, 0xf6, 0x0c, - 0xc0, 0x5b, 0x0e, 0xd6, 0x08, 0xf2, 0x7e, 0x18, 0x84, 0xbc, 0xaf, 0x4f, 0x41, 0xde, 0x42, 0x96, - 0x1f, 0x7a, 0x3f, 0x0c, 0x82, 0xde, 0xd7, 0xa7, 0x40, 0xef, 0x21, 0x39, 0x1c, 0x7b, 0x6f, 0x04, - 0x63, 0xef, 0x9b, 0x53, 0xb1, 0xb7, 0x90, 0x35, 0x0c, 0xbe, 0x5f, 0xf3, 0x81, 0xef, 0x4b, 0x21, - 0xe0, 0x5b, 0x30, 0x52, 0xf4, 0xfd, 0xee, 0x18, 0xfa, 0x2e, 0x4f, 0x42, 0xdf, 0x82, 0xb3, 0x0f, - 0xbf, 0x6b, 0x81, 0xf0, 0xfb, 0xc6, 0x34, 0xf8, 0x2d, 0x2d, 0xcf, 0x8f, 0xbf, 0xb7, 0x42, 0xf0, - 0xf7, 0xad, 0xe9, 0xf8, 0x5b, 0x88, 0x1b, 0x01, 0xe0, 0xea, 0x44, 0x00, 0xfe, 0xda, 0x8c, 0x00, - 0x5c, 0xc8, 0x0e, 0x42, 0xe0, 0xff, 0x7f, 0x18, 0x81, 0x2f, 0x85, 0x23, 0x70, 0x21, 0x44, 0x40, - 0xf0, 0x5a, 0x20, 0x04, 0xbf, 0x31, 0x0d, 0x82, 0x4b, 0xa5, 0xf9, 0x31, 0xf8, 0x46, 0x30, 0x06, - 0xbf, 0x39, 0x15, 0x83, 0x4b, 0xdb, 0x19, 0x02, 0xe1, 0xb5, 0x40, 0x10, 0x7e, 0x63, 0x1a, 0x08, - 0xef, 0x8f, 0xa6, 0x0f, 0x85, 0x6f, 0x87, 0xa2, 0xf0, 0x3b, 0xb3, 0xa0, 0x70, 0x21, 0x72, 0x0c, - 0x86, 0xbf, 0x98, 0x01, 0x86, 0xaf, 0x1c, 0x0b, 0x86, 0x8b, 0x9a, 0xc2, 0x71, 0xf8, 0xc7, 0xe1, - 0x38, 0xfc, 0x5b, 0x33, 0xe1, 0x70, 0xe9, 0xdc, 0xc6, 0x80, 0xf8, 0xca, 0x10, 0x10, 0x2f, 0x85, - 0x02, 0x71, 0xe9, 0x6b, 0x19, 0x12, 0x7f, 0x77, 0x0c, 0x89, 0x97, 0x27, 0x21, 0x71, 0x39, 0x61, - 0x25, 0x14, 0x57, 0x27, 0x42, 0xe7, 0xd7, 0x66, 0x84, 0xce, 0x72, 0x52, 0x04, 0x60, 0xe7, 0x6a, - 0x00, 0x76, 0xbe, 0x36, 0x19, 0x3b, 0xcb, 0xb5, 0x70, 0x00, 0x9e, 0x1f, 0x06, 0x81, 0xe7, 0xeb, - 0x53, 0xc0, 0xb3, 0x74, 0xad, 0x3e, 0xf4, 0xfc, 0xe6, 0x08, 0x7a, 0xbe, 0x32, 0x35, 0xf6, 0xd6, - 0x87, 0xcf, 0xef, 0x8d, 0xc3, 0xe7, 0xab, 0x13, 0xe1, 0xb3, 0xe0, 0x1f, 0xe0, 0xe7, 0x37, 0x47, - 0xf0, 0xf3, 0x95, 0x09, 0xf8, 0x59, 0x56, 0x2e, 0x00, 0xf4, 0xce, 0x64, 0x00, 0xbd, 0x3c, 0x2b, - 0x80, 0x16, 0x62, 0x03, 0x11, 0xf4, 0x46, 0x30, 0x82, 0xbe, 0x39, 0xe3, 0xa1, 0xfe, 0x08, 0x84, - 0x7e, 0x18, 0x04, 0xa1, 0xaf, 0x4f, 0x81, 0xd0, 0x83, 0xc5, 0xb0, 0x8f, 0xa1, 0x1f, 0x06, 0x61, - 0xe8, 0xeb, 0x53, 0x30, 0xb4, 0x94, 0xe3, 0x03, 0xd1, 0x38, 0x0c, 0x44, 0xdf, 0x9e, 0x01, 0x44, - 0x4b, 0xe0, 0x30, 0x82, 0xa2, 0xdf, 0x19, 0x45, 0xd1, 0xe5, 0x49, 0x28, 0x5a, 0xce, 0x3c, 0x09, - 0xa3, 0x37, 0x82, 0x61, 0xf4, 0xcd, 0xa9, 0x30, 0x7a, 0xe0, 0xaa, 0x83, 0x71, 0xf4, 0xfb, 0xf1, - 0xd4, 0xc5, 0xc2, 0xa5, 0xf2, 0xe7, 0x09, 0x98, 0x7f, 0x2c, 0xa3, 0xa1, 0xbe, 0x4b, 0x4b, 0xca, - 0xab, 0x5c, 0x5a, 0x42, 0x6b, 0xb4, 0xaf, 0xcc, 0x52, 0x04, 0xb6, 0x9e, 0x70, 0xfb, 0x72, 0xec, - 0x3e, 0x9e, 0x64, 0x7d, 0x85, 0x4c, 0x5d, 0xf4, 0x00, 0x72, 0x3d, 0x97, 0x38, 0x6a, 0xd7, 0x31, - 0x6d, 0xc7, 0xf4, 0x78, 0x72, 0x8a, 0x52, 0x29, 0x7c, 0x75, 0x58, 0xca, 0x6e, 0xbb, 0xc4, 0x79, - 0x26, 0xe8, 0x38, 0xdb, 0xf3, 0x3d, 0xc9, 0x2f, 0xcd, 0x25, 0x66, 0xff, 0xd2, 0xdc, 0x07, 0x50, - 0x70, 0x88, 0x66, 0x0c, 0xb9, 0x75, 0x7e, 0xcb, 0x27, 0x78, 0xc1, 0xd3, 0x0c, 0x9f, 0xef, 0x66, - 0xb7, 0x7d, 0x4e, 0x3a, 0xc3, 0x44, 0x74, 0x0f, 0xce, 0x74, 0xb4, 0x7d, 0x7e, 0x7d, 0x4d, 0x2e, - 0xcb, 0x2c, 0x2a, 0x9c, 0x62, 0xf9, 0x06, 0xa8, 0xa3, 0xed, 0xb3, 0xcf, 0xd6, 0xf1, 0x57, 0xec, - 0x13, 0x3b, 0xd7, 0x21, 0x6f, 0x98, 0xae, 0x67, 0x5a, 0xba, 0xbc, 0x30, 0x9f, 0xe6, 0x77, 0x5a, - 0x24, 0x95, 0xdf, 0x89, 0xbf, 0x03, 0x0b, 0x22, 0xbd, 0x62, 0xf0, 0x21, 0x3b, 0x86, 0x5c, 0x53, - 0xb4, 0x15, 0xf4, 0xc5, 0xe0, 0xdb, 0x7f, 0x55, 0x38, 0xd9, 0xd4, 0x3c, 0xb2, 0xa7, 0x1d, 0xa8, - 0x96, 0x6d, 0x30, 0xdd, 0x67, 0xd8, 0x85, 0xe3, 0x0b, 0x47, 0x87, 0xa5, 0xdc, 0x23, 0xfe, 0x6a, - 0xd3, 0x36, 0xf8, 0x08, 0xcc, 0xf3, 0x7f, 0x38, 0xd7, 0xf4, 0xbd, 0x30, 0xd0, 0x2a, 0x64, 0x29, - 0x04, 0x50, 0x6d, 0xfe, 0xb5, 0x1a, 0x81, 0x49, 0xc3, 0x8e, 0xe1, 0xc5, 0x37, 0x6d, 0x70, 0xc6, - 0x1d, 0x3c, 0xbc, 0x1f, 0x4f, 0x25, 0x0b, 0xa9, 0xf2, 0xe7, 0x0a, 0x64, 0x87, 0x12, 0x87, 0xde, - 0x1e, 0x09, 0xd5, 0x9c, 0x0f, 0xc6, 0xb9, 0xc1, 0x21, 0xc8, 0x55, 0x48, 0x09, 0xc5, 0xca, 0x20, - 0x64, 0x29, 0x1c, 0xea, 0xb0, 0x3d, 0xa5, 0x8c, 0xd6, 0x4a, 0xb6, 0xb7, 0xe2, 0xbf, 0xf3, 0xc3, - 0xd2, 0x89, 0xf2, 0x4f, 0x62, 0x90, 0x1b, 0xce, 0x14, 0xaa, 0x8d, 0xb4, 0x2b, 0x68, 0x62, 0x0e, - 0x71, 0x84, 0xb7, 0x72, 0x0d, 0xd2, 0x8e, 0x28, 0x24, 0x9b, 0xb9, 0x34, 0x21, 0x20, 0xe5, 0x6f, - 0xe7, 0x80, 0x71, 0xf1, 0x2f, 0xe7, 0xfa, 0x13, 0x7a, 0x19, 0x12, 0xec, 0xd3, 0x93, 0xa2, 0x69, - 0x41, 0xf9, 0xc0, 0xeb, 0xf4, 0x3d, 0xe6, 0xc5, 0xa8, 0x03, 0x68, 0xbc, 0xd2, 0xad, 0xc5, 0x3e, - 0xe1, 0x15, 0x3e, 0xdd, 0xf8, 0x8a, 0xd7, 0xec, 0xea, 0x74, 0x3f, 0xde, 0x6e, 0x13, 0xdd, 0x13, - 0x5f, 0xb9, 0x94, 0x1f, 0x68, 0xbc, 0x36, 0x2a, 0x42, 0x7c, 0x13, 0x73, 0x19, 0x8b, 0x6f, 0x62, - 0xfa, 0xe2, 0xc2, 0xf9, 0xbe, 0x08, 0x36, 0x5f, 0x78, 0xd2, 0x00, 0x1f, 0xea, 0x3b, 0x1b, 0x70, - 0x2a, 0x60, 0xf6, 0xa2, 0x3c, 0x40, 0x75, 0x6b, 0xb3, 0x5e, 0xab, 0x37, 0xd6, 0x37, 0x1b, 0x85, - 0x13, 0x28, 0x07, 0x69, 0xfa, 0xbc, 0xbe, 0x59, 0xdf, 0xae, 0x17, 0x14, 0x54, 0x80, 0x6c, 0x6d, - 0xd3, 0x57, 0x40, 0x7c, 0x56, 0xf1, 0xce, 0x47, 0x90, 0xf1, 0xdd, 0xf8, 0x43, 0x08, 0xf2, 0xcf, - 0xb6, 0xeb, 0x8f, 0xd5, 0x46, 0xed, 0xe9, 0x7a, 0xbd, 0xb1, 0xfa, 0xf4, 0x59, 0xe1, 0x04, 0x95, - 0xcc, 0x68, 0xab, 0x95, 0x2d, 0xdc, 0x28, 0x28, 0xfd, 0xe7, 0xc6, 0xd6, 0x76, 0xf5, 0x71, 0x61, - 0xae, 0xff, 0xfc, 0xc1, 0xf6, 0x3a, 0xfe, 0xa4, 0x10, 0x13, 0x82, 0x35, 0x38, 0x13, 0x98, 0x00, - 0x8b, 0x32, 0x90, 0xdc, 0xb6, 0xd8, 0xf5, 0x33, 0xde, 0xca, 0x7e, 0x1e, 0x66, 0x41, 0x41, 0x29, - 0x9e, 0x6b, 0x59, 0x98, 0x43, 0xf3, 0x30, 0x57, 0x5f, 0x29, 0xc4, 0xd0, 0x49, 0xc8, 0xf8, 0x12, - 0x49, 0x0b, 0x71, 0x94, 0x16, 0xd9, 0x84, 0x85, 0xc4, 0x9d, 0x2b, 0xe0, 0x4b, 0xdf, 0x42, 0x00, - 0xf3, 0x1b, 0x9a, 0x47, 0x5c, 0xaf, 0x70, 0x02, 0x25, 0x21, 0xb6, 0xda, 0x6e, 0x17, 0x94, 0xfb, - 0x1f, 0x43, 0x4a, 0x7e, 0xee, 0x03, 0x6d, 0x40, 0x82, 0xc3, 0xa8, 0x52, 0xf8, 0x54, 0x60, 0x93, - 0x6a, 0x71, 0x69, 0xda, 0x5c, 0x29, 0x9f, 0xa8, 0x5c, 0xf9, 0xe2, 0x5f, 0x2e, 0x9f, 0xf8, 0xe2, - 0xe8, 0xb2, 0xf2, 0xe5, 0xd1, 0x65, 0xe5, 0x1f, 0x8e, 0x2e, 0x2b, 0xff, 0x7c, 0x74, 0x59, 0xf9, - 0xad, 0x7f, 0xbd, 0x7c, 0xe2, 0xd3, 0xa4, 0x60, 0xd9, 0x99, 0x67, 0x5f, 0x32, 0x5d, 0xf9, 0xef, - 0x00, 0x00, 0x00, 0xff, 0xff, 0xef, 0x48, 0xf0, 0xce, 0xaa, 0x55, 0x00, 0x00, + // 5313 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xdc, 0x7c, 0x4d, 0x6c, 0x23, 0xcb, + 0x56, 0xff, 0x74, 0xec, 0x24, 0xf6, 0xf1, 0xc7, 0x38, 0x35, 0x5f, 0x9e, 0xcc, 0x87, 0x33, 0x9e, + 0xef, 0x79, 0xef, 0x66, 0xee, 0x4c, 0xfe, 0xf3, 0xe7, 0x7e, 0xf2, 0x6e, 0xec, 0x64, 0x66, 0x7c, + 0x27, 0x93, 0xcc, 0x2d, 0x3b, 0xf7, 0xeb, 0xc1, 0x6b, 0x3a, 0xdd, 0x15, 0xa7, 0x19, 0xbb, 0xdb, + 0xd3, 0x5d, 0x9e, 0x24, 0x97, 0x05, 0x7a, 0x48, 0x08, 0x16, 0x0f, 0x84, 0xc4, 0x5d, 0x20, 0x21, + 0xc1, 0x93, 0x00, 0x09, 0x89, 0x0d, 0x2c, 0x58, 0xb0, 0x62, 0xc3, 0xe2, 0xa2, 0xf7, 0x40, 0x77, + 0x01, 0x12, 0x02, 0x29, 0x82, 0xb0, 0x79, 0x7a, 0x82, 0x15, 0xbb, 0x8b, 0x84, 0x50, 0x7d, 0xd9, + 0x6d, 0xbb, 0xdb, 0x4e, 0xe6, 0x36, 0xba, 0x82, 0x95, 0xdd, 0xa7, 0xeb, 0x9c, 0xaa, 0x3a, 0x75, + 0xea, 0xd4, 0xaf, 0xea, 0x9c, 0x6a, 0x98, 0xf3, 0x5c, 0xc3, 0xdc, 0xe9, 0x6c, 0xdd, 0x35, 0x3a, + 0xf6, 0x62, 0xc7, 0x73, 0xa9, 0x8b, 0xe6, 0x4c, 0xd7, 0x7c, 0xce, 0xc9, 0x8b, 0xf2, 0xe5, 0x3c, + 0x52, 0xa5, 0x2c, 0x83, 0x1a, 0xa2, 0xd8, 0xfc, 0x69, 0x45, 0x23, 0x9e, 0xe7, 0x7a, 0xbe, 0xa4, + 0x9e, 0x55, 0xd4, 0x36, 0xa1, 0x46, 0xa0, 0xf4, 0x55, 0x9f, 0xba, 0x9e, 0xd1, 0x24, 0x77, 0x89, + 0xd3, 0xb4, 0x1d, 0xf5, 0xc3, 0xca, 0xbd, 0x34, 0xcd, 0x25, 0x59, 0xa8, 0xd8, 0xa5, 0x76, 0xeb, + 0xee, 0x4e, 0xcb, 0xbc, 0x4b, 0xed, 0x36, 0xf1, 0xa9, 0xd1, 0xee, 0xc8, 0x37, 0x0b, 0xfc, 0x0d, + 0xf5, 0x0c, 0xd3, 0x76, 0x9a, 0x77, 0x3d, 0x62, 0xba, 0x9e, 0x45, 0x2c, 0xdd, 0xef, 0x18, 0x8e, + 0x6a, 0x4e, 0xd3, 0x6d, 0xba, 0xfc, 0xef, 0x5d, 0xf6, 0x4f, 0x50, 0xcb, 0xbf, 0x0c, 0x69, 0x6c, + 0x38, 0x4d, 0x52, 0x73, 0xb6, 0x5d, 0xf4, 0x0e, 0x24, 0x2d, 0xe2, 0x9b, 0x45, 0x6d, 0x41, 0xbb, + 0x95, 0xb9, 0x5f, 0x5e, 0x1c, 0xe9, 0xe7, 0x22, 0x2f, 0xbb, 0x42, 0x7c, 0xd3, 0xb3, 0x3b, 0xd4, + 0xf5, 0x2a, 0xc9, 0x2f, 0x0e, 0x4a, 0x27, 0x30, 0xe7, 0x42, 0xff, 0x0f, 0xa6, 0x5b, 0xc4, 0xf0, + 0x49, 0x71, 0x8a, 0xb3, 0x17, 0x43, 0xd8, 0xd7, 0xd8, 0x7b, 0xc9, 0x24, 0x0a, 0x97, 0x7f, 0x90, + 0x80, 0x3c, 0x26, 0x7e, 0xc7, 0x75, 0x7c, 0xf2, 0x98, 0x18, 0x16, 0xf1, 0xd0, 0xeb, 0x90, 0xa0, + 0x7b, 0x4e, 0x31, 0xc1, 0xc5, 0x5c, 0x0e, 0x11, 0xd3, 0xf0, 0x0c, 0xc7, 0x37, 0x4c, 0x6a, 0xbb, + 0x0e, 0x66, 0x45, 0xd1, 0x1b, 0x90, 0xf1, 0x88, 0xdf, 0x6d, 0x13, 0xde, 0xe1, 0x62, 0x92, 0x73, + 0x9e, 0x0b, 0xe1, 0xac, 0x77, 0x0c, 0x07, 0x83, 0x28, 0xcb, 0xfe, 0xa3, 0xf3, 0x90, 0x72, 0xba, + 0x6d, 0xfd, 0x39, 0xd9, 0xf7, 0x8b, 0xd3, 0x0b, 0xda, 0xad, 0x04, 0x9e, 0x75, 0xba, 0xed, 0x27, + 0x64, 0xdf, 0x47, 0x55, 0xc8, 0x78, 0xac, 0xbb, 0xba, 0xed, 0x6c, 0xbb, 0x7e, 0x71, 0x66, 0x21, + 0x71, 0x2b, 0x73, 0xff, 0x62, 0x94, 0x52, 0x98, 0x02, 0x65, 0xcf, 0xc0, 0x53, 0x04, 0x1f, 0xd5, + 0x21, 0x27, 0x5b, 0xe6, 0x11, 0xc3, 0x77, 0x9d, 0xe2, 0xec, 0x82, 0x76, 0x2b, 0x7f, 0x7f, 0x31, + 0x4c, 0xcc, 0x80, 0x16, 0xd8, 0x63, 0xb7, 0x4d, 0x30, 0xe7, 0xc2, 0x59, 0x2f, 0xf0, 0x54, 0xfe, + 0x04, 0xb2, 0xc1, 0xb7, 0x08, 0x41, 0x1e, 0xaf, 0xd6, 0x37, 0x9f, 0xae, 0xea, 0x9b, 0xeb, 0x4f, + 0xd6, 0x37, 0x3e, 0x5a, 0x2f, 0x9c, 0x40, 0xa7, 0xa1, 0x20, 0x69, 0x4f, 0x56, 0x3f, 0xd1, 0xd7, + 0x6a, 0x4f, 0x6b, 0x8d, 0x82, 0x86, 0xce, 0xc3, 0x19, 0x49, 0xc5, 0xcb, 0xeb, 0x8f, 0x56, 0xf5, + 0xca, 0xc6, 0xe6, 0xfa, 0xca, 0x32, 0xfe, 0xa4, 0x30, 0x35, 0x9f, 0xfc, 0xf5, 0x3f, 0xb8, 0x7c, + 0xa2, 0xfc, 0x14, 0xe0, 0x11, 0xa1, 0x98, 0xbc, 0xe8, 0x12, 0x9f, 0xa2, 0x37, 0x61, 0x66, 0x87, + 0xb7, 0x46, 0x9a, 0x44, 0x94, 0x4a, 0x2b, 0x29, 0xd6, 0xf1, 0x2f, 0x0f, 0x4a, 0x1a, 0x96, 0x0c, + 0x6f, 0x25, 0x7f, 0xf2, 0xc3, 0x92, 0x56, 0xfe, 0x15, 0x0d, 0x32, 0x5c, 0x9e, 0xe8, 0x1a, 0xaa, + 0x0e, 0x09, 0xbc, 0x32, 0x51, 0x0f, 0xa3, 0xa2, 0xd1, 0x22, 0x4c, 0xbf, 0x34, 0x5a, 0xdd, 0x71, + 0x86, 0xf6, 0x21, 0x7b, 0x8f, 0x45, 0xb1, 0xf2, 0x9f, 0x69, 0x00, 0xcf, 0xba, 0x31, 0x74, 0x8a, + 0x99, 0xf8, 0x91, 0x6a, 0x56, 0x26, 0xce, 0x0b, 0xa3, 0xb3, 0x30, 0x63, 0x3b, 0x2d, 0xdb, 0x21, + 0xdc, 0xa4, 0x53, 0x58, 0x3e, 0xa1, 0xd3, 0x30, 0xbd, 0xd5, 0xb2, 0x1d, 0x8b, 0xdb, 0x6b, 0x0a, + 0x8b, 0x07, 0xa9, 0x38, 0x0c, 0x19, 0xde, 0xe4, 0x18, 0xf5, 0x56, 0xfe, 0x27, 0x0d, 0xce, 0x54, + 0x5d, 0xc7, 0xb2, 0xd9, 0xc4, 0x31, 0x5a, 0xdf, 0xa4, 0x4a, 0x1e, 0x40, 0x9a, 0xec, 0x75, 0x74, + 0xc1, 0x99, 0x98, 0x30, 0x8c, 0x29, 0xb2, 0xd7, 0xe1, 0xff, 0xc6, 0x6a, 0xec, 0xe7, 0xe1, 0xec, + 0x70, 0xe7, 0xe2, 0x54, 0xde, 0x5f, 0x6b, 0x90, 0xaf, 0x39, 0x36, 0xfd, 0x26, 0xb5, 0xd6, 0xeb, + 0x7e, 0x22, 0xd0, 0x7d, 0x74, 0x07, 0x0a, 0xdb, 0x86, 0xdd, 0xda, 0x70, 0x1a, 0x6e, 0x7b, 0xcb, + 0xa7, 0xae, 0x43, 0x7c, 0xa9, 0x9f, 0x11, 0xba, 0x54, 0xd5, 0x87, 0x70, 0xb2, 0xd7, 0x95, 0x38, + 0x75, 0xf4, 0x02, 0x0a, 0x35, 0xc7, 0xf4, 0x48, 0x9b, 0x38, 0x71, 0x28, 0xe9, 0x22, 0xa4, 0x6d, + 0x25, 0x8e, 0x2b, 0x2a, 0x81, 0xfb, 0x04, 0xd9, 0x95, 0x2e, 0xcc, 0x05, 0xaa, 0x8c, 0xd3, 0xcb, + 0x5c, 0x80, 0xb4, 0x43, 0x76, 0xf5, 0xfe, 0x30, 0x25, 0x70, 0xca, 0x21, 0xbb, 0x7c, 0x58, 0xca, + 0xcf, 0x20, 0xb7, 0x42, 0x5a, 0x84, 0x92, 0xd8, 0x3c, 0xe5, 0x26, 0xe4, 0x95, 0xc4, 0x38, 0x87, + 0xe4, 0x73, 0x0d, 0x90, 0x94, 0xcb, 0x16, 0xa5, 0x18, 0x46, 0xa5, 0xc4, 0xd6, 0x5a, 0xda, 0xf5, + 0x1c, 0xb1, 0x68, 0x0a, 0x53, 0x04, 0x41, 0xe2, 0xeb, 0x66, 0xdf, 0xdd, 0x25, 0x83, 0xee, 0x4e, + 0xf4, 0xf3, 0xfd, 0x64, 0x6a, 0xaa, 0x90, 0x28, 0xef, 0xc2, 0xa9, 0x81, 0x56, 0xc5, 0x3b, 0x70, + 0x49, 0xde, 0xb2, 0xa9, 0x85, 0xc4, 0xad, 0x6c, 0x65, 0xf6, 0xab, 0x83, 0x52, 0xe2, 0x09, 0xd9, + 0xc7, 0x9c, 0x58, 0x6e, 0xc0, 0x5c, 0xb5, 0x45, 0x0c, 0x2f, 0x26, 0x6d, 0xc8, 0xc1, 0xfb, 0x04, + 0x50, 0x50, 0x6a, 0x9c, 0x03, 0x68, 0x43, 0xa6, 0x6e, 0x1a, 0xce, 0x46, 0x87, 0xf9, 0x35, 0x1f, + 0x2d, 0xc1, 0x59, 0x9f, 0xba, 0x1d, 0xdd, 0xa0, 0xba, 0x00, 0x27, 0x5b, 0x6e, 0xd7, 0xb1, 0x0c, + 0x6f, 0x9f, 0xd7, 0x91, 0xc2, 0xa7, 0xd8, 0xdb, 0x65, 0xca, 0x1b, 0x52, 0x91, 0xaf, 0xd8, 0x90, + 0xb5, 0x6d, 0x47, 0x67, 0x18, 0xa2, 0x45, 0x7d, 0x69, 0xcc, 0xd0, 0xb6, 0x1d, 0x2c, 0x28, 0xb2, + 0x17, 0xbf, 0x24, 0xaa, 0x8a, 0xc1, 0x46, 0xae, 0x43, 0x5e, 0xda, 0x88, 0xed, 0x50, 0xe2, 0x50, + 0x65, 0x26, 0x39, 0x41, 0xad, 0x09, 0xe2, 0x80, 0x45, 0xfc, 0xad, 0x06, 0x59, 0x51, 0x7b, 0x9c, + 0xb6, 0xf0, 0x00, 0x92, 0x9e, 0xbb, 0x2b, 0x6c, 0x21, 0x73, 0xff, 0x42, 0x88, 0x88, 0x27, 0x64, + 0x3f, 0xe8, 0x69, 0x79, 0x71, 0x54, 0x81, 0x8c, 0x68, 0xb8, 0xce, 0xb9, 0x13, 0x47, 0xe5, 0x06, + 0xc1, 0x85, 0xdd, 0x5d, 0x9f, 0x41, 0x1f, 0x84, 0xc9, 0x4b, 0xe2, 0xf9, 0xe4, 0x9b, 0xd3, 0xea, + 0xdf, 0x6b, 0x70, 0x6a, 0xa0, 0x11, 0xff, 0x47, 0x94, 0xbb, 0x0b, 0xe7, 0xaa, 0x3b, 0xc4, 0x7c, + 0x5e, 0x75, 0x1d, 0xdf, 0xf6, 0x29, 0x71, 0xcc, 0xfd, 0x18, 0x14, 0x7c, 0x01, 0xd2, 0xbb, 0x36, + 0xdd, 0xd1, 0x2d, 0x7b, 0x7b, 0x9b, 0xcf, 0x92, 0x14, 0x4e, 0x31, 0xc2, 0x8a, 0xbd, 0xbd, 0x2d, + 0xe7, 0x88, 0x0e, 0xc5, 0xd1, 0x8a, 0xe3, 0x5d, 0x43, 0xcf, 0x60, 0x62, 0xba, 0xed, 0x4e, 0x97, + 0x92, 0x3a, 0x35, 0xa8, 0x1f, 0x43, 0xbf, 0xce, 0xc1, 0xac, 0xe5, 0xed, 0xeb, 0x5e, 0xd7, 0x91, + 0xbd, 0x9a, 0xb1, 0xbc, 0x7d, 0xdc, 0x75, 0x64, 0x9f, 0xfe, 0x42, 0x83, 0xb3, 0xc3, 0x75, 0xc6, + 0x69, 0x27, 0x9f, 0x42, 0xc6, 0xb0, 0xd8, 0x6e, 0xd4, 0x22, 0x2d, 0x6a, 0x48, 0xc8, 0xb3, 0x14, + 0x90, 0x24, 0xb7, 0xbe, 0x8b, 0x62, 0xcf, 0xbb, 0xa8, 0xb6, 0xbe, 0x8b, 0x4f, 0x3f, 0xac, 0x56, + 0xd7, 0x09, 0xdd, 0x75, 0xbd, 0xe7, 0xbc, 0x59, 0xca, 0x10, 0xb8, 0xb4, 0x15, 0x26, 0xac, 0xfc, + 0x29, 0x9c, 0xab, 0x90, 0xa6, 0xed, 0x04, 0xb7, 0x84, 0x71, 0x79, 0x75, 0x1d, 0x8a, 0xa3, 0xb2, + 0xe3, 0x1c, 0xeb, 0x3f, 0x4d, 0xc0, 0x99, 0x55, 0xc7, 0x8a, 0xb5, 0xed, 0x6c, 0xf9, 0x35, 0xdd, + 0x76, 0xdb, 0xa6, 0x6a, 0xac, 0xc5, 0x13, 0x7a, 0x13, 0x52, 0x16, 0x31, 0xac, 0xde, 0x3e, 0x24, + 0x73, 0xff, 0x52, 0x40, 0x68, 0x97, 0xda, 0xad, 0xc5, 0x9d, 0x96, 0xb9, 0xd8, 0x50, 0x07, 0x0b, + 0xb8, 0x57, 0x1c, 0xfd, 0x02, 0x9c, 0x63, 0x73, 0xcf, 0x73, 0x8c, 0x96, 0x2e, 0xa4, 0xe9, 0xd4, + 0xb3, 0x9b, 0x4d, 0xe2, 0xc9, 0xad, 0xf6, 0xad, 0x90, 0xe6, 0xd5, 0x24, 0x47, 0x95, 0x33, 0x34, + 0x44, 0x79, 0x7c, 0xc6, 0x0e, 0x23, 0xa3, 0xf7, 0x20, 0x2b, 0x7d, 0x02, 0xdb, 0xc0, 0xb3, 0xad, + 0x78, 0x62, 0x5c, 0xaf, 0x85, 0x1d, 0x48, 0x37, 0xc2, 0x28, 0x3e, 0xba, 0xcb, 0x60, 0xc9, 0x8b, + 0xae, 0xed, 0x11, 0xfd, 0x5e, 0xc7, 0x2c, 0xce, 0xb0, 0xbe, 0x57, 0xf2, 0x87, 0x07, 0x25, 0xc0, + 0x82, 0x7c, 0xef, 0x59, 0x95, 0xc1, 0x14, 0xf1, 0xbf, 0x63, 0xa2, 0x5b, 0x50, 0x70, 0x5c, 0xdd, + 0x23, 0xdb, 0x1e, 0xf1, 0x77, 0x64, 0xb5, 0x29, 0xae, 0xb1, 0xbc, 0xe3, 0x62, 0x41, 0xe6, 0xa2, + 0x7b, 0x0e, 0x75, 0xb6, 0x90, 0x2a, 0xff, 0xb6, 0x06, 0x67, 0x87, 0x87, 0x2c, 0xce, 0xb9, 0x72, + 0x0b, 0x0a, 0xae, 0x43, 0xf4, 0xce, 0x8e, 0xe1, 0x13, 0xa9, 0x6b, 0x09, 0xa3, 0xf2, 0xae, 0x43, + 0x9e, 0x31, 0xb2, 0xd0, 0x9c, 0x70, 0xf0, 0xef, 0x27, 0x53, 0x89, 0x42, 0xb2, 0xfc, 0x19, 0xcc, + 0x2d, 0x5b, 0x6d, 0xdb, 0xa9, 0x77, 0x5a, 0x76, 0x1c, 0xc8, 0xfb, 0x1a, 0xa4, 0x7d, 0x26, 0x8a, + 0x41, 0x3c, 0x6e, 0x46, 0x01, 0x1c, 0x95, 0xe2, 0x6f, 0x9e, 0x90, 0xfd, 0x3e, 0xf6, 0x09, 0xd6, + 0x1d, 0xe7, 0xfc, 0x68, 0xc8, 0x6e, 0x3d, 0x25, 0x5e, 0xbc, 0x60, 0x2d, 0x28, 0x35, 0xce, 0x06, + 0x7f, 0x5f, 0x83, 0xf3, 0x5c, 0x36, 0xb7, 0x8f, 0x6d, 0xe2, 0xf1, 0x03, 0xaf, 0x18, 0x06, 0xe4, + 0x2a, 0xcc, 0x50, 0xc3, 0x6b, 0x12, 0x31, 0xa9, 0xa7, 0x2b, 0x99, 0xaf, 0x0e, 0x4a, 0xb3, 0x75, + 0xea, 0x7a, 0xa4, 0xb6, 0x82, 0xe5, 0x2b, 0xd9, 0x3d, 0x03, 0xe6, 0xc3, 0x9a, 0x10, 0x67, 0x37, + 0x7f, 0xaa, 0xc9, 0x3a, 0xaa, 0x3b, 0x02, 0xf0, 0x76, 0x5a, 0xb6, 0x69, 0xc4, 0xb1, 0x52, 0xad, + 0x42, 0xc6, 0xe4, 0x32, 0x75, 0xba, 0xdf, 0x11, 0xdb, 0xae, 0xfc, 0xfd, 0x6b, 0xa1, 0x6d, 0xe4, + 0x75, 0x8a, 0x06, 0x34, 0xf6, 0x3b, 0x04, 0x83, 0xd9, 0xfb, 0x8f, 0x56, 0x60, 0x56, 0xe8, 0x44, + 0xc1, 0x8b, 0x31, 0x22, 0xd8, 0x1c, 0x6e, 0xf0, 0xc2, 0xd2, 0xad, 0x28, 0x56, 0xa9, 0xcf, 0x2d, + 0xb8, 0x10, 0xda, 0xd7, 0xb8, 0x77, 0x69, 0x1c, 0xb2, 0xaf, 0xb9, 0xee, 0xf3, 0x6e, 0x27, 0x06, + 0x45, 0x5e, 0x02, 0x68, 0x1b, 0x7b, 0x62, 0x8f, 0x20, 0x10, 0xff, 0x34, 0x4e, 0xb7, 0x8d, 0x3d, + 0x5e, 0x8b, 0x8f, 0x8a, 0x30, 0xeb, 0x09, 0x58, 0x28, 0xbd, 0x8b, 0x7a, 0xec, 0x39, 0x3b, 0xe6, + 0x56, 0xfe, 0x83, 0xa1, 0xc7, 0x60, 0xb3, 0xe2, 0xf4, 0x74, 0xef, 0xc1, 0x4c, 0xaf, 0x75, 0x89, + 0x63, 0x1d, 0x37, 0x4b, 0x3e, 0xb4, 0x09, 0x73, 0x1d, 0x8f, 0x6c, 0x13, 0x6a, 0xee, 0x10, 0x4b, + 0x75, 0x35, 0x71, 0x4c, 0x61, 0x85, 0xbe, 0x08, 0xa1, 0x9b, 0xf2, 0x6f, 0x68, 0x70, 0xea, 0x31, + 0x31, 0x3c, 0xba, 0x45, 0x0c, 0xda, 0xd8, 0x8b, 0x63, 0x4d, 0x7e, 0x00, 0x09, 0xc7, 0xdd, 0x95, + 0xc8, 0x67, 0xfc, 0xb2, 0x2b, 0x9b, 0xc5, 0xca, 0x4b, 0x03, 0xfc, 0x2e, 0x9c, 0x1e, 0x6c, 0x4e, + 0x9c, 0x96, 0xf7, 0xc7, 0x09, 0x48, 0x3f, 0xaa, 0xc6, 0xd0, 0xc5, 0x77, 0xe4, 0xae, 0x3b, 0x5a, + 0xff, 0xbd, 0x6a, 0x16, 0x1f, 0x55, 0x9f, 0x90, 0x7d, 0xb5, 0x27, 0x60, 0x5c, 0x68, 0x19, 0xd2, + 0x74, 0x87, 0xad, 0xb8, 0x6e, 0xcb, 0x92, 0x98, 0xe2, 0x48, 0x6a, 0xea, 0x73, 0xa1, 0x16, 0x9c, + 0xa1, 0x7b, 0x0e, 0x5f, 0xc8, 0xf5, 0xa6, 0xa9, 0xf7, 0xc5, 0x4d, 0x1f, 0x45, 0xdc, 0x3c, 0x13, + 0x77, 0x78, 0x50, 0x42, 0x8d, 0x3d, 0x87, 0xf5, 0xf0, 0x51, 0xb5, 0xa1, 0x04, 0x60, 0x44, 0x25, + 0xcd, 0xec, 0xd1, 0xe6, 0x9f, 0xc3, 0x34, 0xef, 0x05, 0x3a, 0x0f, 0x09, 0xb6, 0x48, 0x6a, 0x83, + 0x8b, 0x24, 0xa3, 0xf1, 0x4e, 0xa9, 0x0a, 0x8e, 0x33, 0xf6, 0x7d, 0x2e, 0x61, 0x01, 0xd2, 0x0e, + 0x3e, 0x00, 0x60, 0x2a, 0x8c, 0x73, 0xf4, 0xff, 0x3c, 0x01, 0xf9, 0x67, 0x5d, 0x7f, 0x27, 0x1e, + 0x2b, 0xaf, 0x02, 0x74, 0xba, 0xfe, 0x0e, 0xf1, 0x74, 0xba, 0xe7, 0xc8, 0x0e, 0x4f, 0x08, 0xdf, + 0xa8, 0x1e, 0x0b, 0xbe, 0xc6, 0x9e, 0x83, 0x36, 0xa4, 0x10, 0xa2, 0xf7, 0x63, 0x40, 0x77, 0x8e, + 0xb0, 0x57, 0x68, 0xec, 0x39, 0x4f, 0x09, 0x35, 0x06, 0x04, 0x12, 0x26, 0xf0, 0x1d, 0x98, 0x65, + 0x0f, 0x3a, 0x75, 0x8f, 0x63, 0x58, 0x33, 0x8c, 0xa7, 0xe1, 0xaa, 0x99, 0x3b, 0x7d, 0xbc, 0x99, + 0x8b, 0xde, 0x86, 0xb4, 0xa8, 0x94, 0xad, 0x62, 0x33, 0x7c, 0x15, 0x0b, 0xd3, 0x84, 0xd4, 0x3d, + 0x5f, 0xbf, 0x52, 0xbc, 0x46, 0xb6, 0x7a, 0x9d, 0x86, 0xe9, 0x6d, 0xd7, 0x33, 0x09, 0x8f, 0x15, + 0xa5, 0xb0, 0x78, 0xe8, 0x39, 0xe6, 0x54, 0x21, 0x5d, 0xfe, 0x5d, 0x0d, 0x4e, 0xf6, 0xc6, 0x2d, + 0x4e, 0xa7, 0x5c, 0x1d, 0xd0, 0xfe, 0xf1, 0x87, 0x90, 0x69, 0xbc, 0xfc, 0x47, 0x53, 0x70, 0xf2, + 0x83, 0x2e, 0xf1, 0xf6, 0xe3, 0x31, 0xab, 0x8a, 0x08, 0x07, 0x4e, 0xbd, 0xa2, 0x29, 0xf0, 0x00, + 0xe1, 0x0d, 0x38, 0xb9, 0x6b, 0xd8, 0x54, 0xdf, 0x76, 0x3d, 0xbd, 0xdb, 0xb1, 0x0c, 0xaa, 0x62, + 0x31, 0x39, 0x46, 0x7e, 0xe8, 0x7a, 0x9b, 0x9c, 0x88, 0x08, 0xa0, 0xe7, 0x8e, 0xbb, 0xeb, 0xe8, + 0x8c, 0x6c, 0x3b, 0x4d, 0xa6, 0x06, 0xbf, 0x98, 0xe4, 0x27, 0x89, 0x3f, 0xf3, 0x8f, 0x07, 0xa5, + 0xa5, 0xa6, 0x4d, 0x77, 0xba, 0x5b, 0x8b, 0xa6, 0xdb, 0xbe, 0xdb, 0x6b, 0x88, 0xb5, 0xd5, 0xff, + 0x7f, 0xb7, 0xf3, 0xbc, 0x79, 0x97, 0xc7, 0x62, 0xbb, 0x5d, 0xdb, 0x5a, 0xdc, 0xdc, 0xac, 0xad, + 0xe0, 0x02, 0x17, 0xf9, 0x91, 0x90, 0xd8, 0xd8, 0x53, 0x3b, 0x8a, 0xf2, 0x57, 0x1a, 0x14, 0xfa, + 0x7a, 0x8a, 0x73, 0x18, 0x57, 0x21, 0xf3, 0xa2, 0x4b, 0x3c, 0x9b, 0x58, 0xc7, 0x1e, 0x47, 0x90, + 0x8c, 0x6c, 0xea, 0x7c, 0x0a, 0xd9, 0x01, 0x3d, 0x24, 0xbe, 0x9e, 0x1e, 0x32, 0xbb, 0x7d, 0x15, + 0x94, 0xff, 0x4b, 0x83, 0xd3, 0x98, 0xf8, 0x6e, 0xeb, 0x25, 0x11, 0x07, 0x57, 0x31, 0x58, 0xca, + 0x06, 0xc8, 0x33, 0x22, 0xfd, 0xeb, 0x18, 0x4c, 0x5a, 0xc8, 0x10, 0xbe, 0x63, 0xc6, 0xa7, 0x06, + 0xed, 0x8a, 0x93, 0xb6, 0x70, 0x24, 0x1a, 0x50, 0x61, 0x9d, 0x97, 0xc5, 0x92, 0x87, 0xed, 0xc4, + 0x3b, 0xae, 0xed, 0xbb, 0x8e, 0x3a, 0x08, 0x17, 0x4f, 0x72, 0xf4, 0x7f, 0x0e, 0xce, 0x0c, 0xf5, + 0x3f, 0x4e, 0xcf, 0xfe, 0x37, 0x53, 0x70, 0x7e, 0x50, 0x7c, 0x4c, 0xc7, 0xff, 0xff, 0x3b, 0x74, + 0x8c, 0x1e, 0x43, 0xae, 0x6d, 0x3b, 0x7a, 0x7f, 0xfd, 0x3d, 0x86, 0x07, 0xcf, 0xb2, 0xdd, 0xd3, + 0xe0, 0x12, 0x5c, 0xce, 0x43, 0x76, 0xdd, 0x75, 0x7b, 0x10, 0xb8, 0x9c, 0x83, 0x8c, 0x78, 0xe6, + 0x0a, 0x65, 0x9b, 0xae, 0x30, 0x6d, 0xc7, 0x39, 0xa2, 0xbf, 0xaa, 0x41, 0x36, 0xa6, 0x8d, 0xf0, + 0xab, 0x85, 0x1f, 0xa5, 0x26, 0x1a, 0x90, 0xfb, 0x1f, 0xd8, 0x39, 0xff, 0x9e, 0x06, 0xa8, 0xe1, + 0x75, 0x1d, 0xd3, 0xa0, 0x64, 0xcd, 0x6d, 0xc6, 0xd0, 0xc7, 0xd3, 0x30, 0x6d, 0x3b, 0x16, 0xd9, + 0xe3, 0x7d, 0x4c, 0x62, 0xf1, 0x80, 0xee, 0x41, 0x4a, 0x26, 0x75, 0x88, 0x28, 0x6a, 0xa2, 0x72, + 0xf6, 0xf0, 0xa0, 0x34, 0x2b, 0x52, 0x38, 0x56, 0xbe, 0xea, 0xff, 0xc5, 0xb3, 0x22, 0x8b, 0x43, + 0x85, 0x97, 0x3f, 0x85, 0x53, 0x03, 0xed, 0x8b, 0xb3, 0xf3, 0x3f, 0xe2, 0xa7, 0xf4, 0xbc, 0xc7, + 0x71, 0x1d, 0x18, 0xbc, 0x52, 0x32, 0x0e, 0x7a, 0x17, 0xa0, 0xe3, 0x91, 0x97, 0xba, 0x60, 0x4d, + 0x1c, 0x89, 0x35, 0xcd, 0x38, 0x38, 0x41, 0x6a, 0xea, 0xc7, 0x1a, 0x9c, 0x8e, 0xfb, 0xfc, 0xe3, + 0x1b, 0xec, 0x4e, 0x1d, 0x0a, 0xfc, 0xb1, 0xe6, 0x6c, 0xbb, 0xb1, 0x9d, 0x41, 0xfd, 0xa6, 0x06, + 0x73, 0x01, 0xa9, 0x71, 0xae, 0xfd, 0xaf, 0x96, 0x86, 0xf5, 0x5d, 0xb6, 0x1a, 0x07, 0x2d, 0x30, + 0x4e, 0xfb, 0xfe, 0x4f, 0x0d, 0xce, 0x56, 0x45, 0x78, 0x81, 0x07, 0x4f, 0xfc, 0x6e, 0x3b, 0x06, + 0x9b, 0x28, 0xc2, 0xec, 0x4b, 0xe2, 0xf9, 0xb6, 0x2b, 0x96, 0xa1, 0x1c, 0x56, 0x8f, 0xe8, 0x17, + 0x21, 0x63, 0xca, 0x7a, 0xd4, 0x3c, 0xcf, 0x56, 0x6a, 0x4c, 0xc0, 0x2b, 0x42, 0x97, 0xc3, 0x83, + 0x12, 0xa8, 0x96, 0xd7, 0x56, 0x30, 0x28, 0xe9, 0x35, 0x0b, 0xcd, 0x43, 0xca, 0x77, 0x8c, 0x8e, + 0xbf, 0xe3, 0xaa, 0x83, 0xda, 0xde, 0xb3, 0x1c, 0xeb, 0xef, 0xc1, 0xb9, 0x91, 0xce, 0xc7, 0xa9, + 0xdd, 0x2d, 0x28, 0xad, 0x90, 0x8e, 0x47, 0x98, 0x6b, 0xb2, 0x3e, 0x24, 0x9e, 0xbd, 0xbd, 0x1f, + 0x9f, 0x96, 0x65, 0x1f, 0x9a, 0xb0, 0x10, 0x5d, 0x47, 0x9c, 0x9d, 0xf9, 0xf1, 0x2c, 0xe4, 0x56, + 0xf7, 0x3a, 0xae, 0x47, 0xeb, 0x02, 0x48, 0xa0, 0x15, 0x48, 0x75, 0x3c, 0xf7, 0xa5, 0xad, 0x04, + 0xe7, 0x43, 0xa3, 0x0d, 0x03, 0x3c, 0xcf, 0x64, 0x79, 0xdc, 0xe3, 0x44, 0x18, 0xd2, 0x6b, 0xae, + 0x69, 0xb4, 0x1e, 0xda, 0x2d, 0x35, 0x33, 0x16, 0x27, 0x89, 0x59, 0xec, 0x71, 0x3c, 0x33, 0xe8, + 0x8e, 0xf2, 0x0f, 0x3d, 0x22, 0x7a, 0x04, 0xa9, 0xc7, 0x94, 0x76, 0xd8, 0x4b, 0xe9, 0x5c, 0xae, + 0x4f, 0x14, 0xc9, 0x18, 0xa4, 0xa4, 0x1e, 0x33, 0xc2, 0x30, 0xf7, 0xc8, 0x75, 0x9b, 0x2d, 0x52, + 0x6d, 0xb9, 0x5d, 0xab, 0xea, 0x3a, 0xdb, 0x76, 0x53, 0x6e, 0x56, 0xaf, 0x4d, 0x94, 0xf8, 0xa8, + 0x5a, 0xc7, 0xa3, 0xec, 0xe8, 0x3b, 0x90, 0xaa, 0x2f, 0x49, 0x51, 0x02, 0xfb, 0x5c, 0x9d, 0x28, + 0xaa, 0xbe, 0x84, 0x7b, 0x4c, 0xe8, 0x31, 0x64, 0x96, 0x3f, 0xeb, 0x7a, 0x44, 0xca, 0x98, 0xe1, + 0x32, 0x6e, 0x4c, 0x94, 0xc1, 0x79, 0x70, 0x90, 0x75, 0xfe, 0x36, 0xe4, 0x06, 0x34, 0x89, 0x10, + 0x24, 0x3b, 0x4c, 0x69, 0x6c, 0x38, 0xd3, 0x98, 0xff, 0x17, 0x76, 0x36, 0x7f, 0x03, 0x92, 0x4c, + 0x2b, 0x6c, 0x6e, 0x6f, 0x19, 0x3e, 0xd9, 0xf4, 0x6c, 0x59, 0x48, 0x3d, 0xca, 0x72, 0x7f, 0xa5, + 0xc1, 0x54, 0x7d, 0x89, 0xa1, 0xbf, 0xad, 0xae, 0xf9, 0x9c, 0x50, 0x59, 0x4a, 0x3e, 0x71, 0x54, + 0xe8, 0x91, 0x6d, 0x5b, 0x2c, 0xfe, 0x69, 0x2c, 0x9f, 0xd0, 0x25, 0x00, 0xc3, 0x34, 0x89, 0xef, + 0xf3, 0xc0, 0x46, 0x82, 0xbf, 0x4b, 0x0b, 0xca, 0x13, 0xb2, 0xcf, 0xd8, 0x7c, 0x62, 0x7a, 0x44, + 0xcc, 0xe4, 0x34, 0x96, 0x4f, 0x8c, 0x8d, 0x92, 0x76, 0x47, 0xa7, 0xee, 0x73, 0xe2, 0x70, 0x6d, + 0xa6, 0x71, 0x9a, 0x51, 0x1a, 0x8c, 0xc0, 0x5c, 0x00, 0x71, 0xac, 0x8e, 0x6b, 0x3b, 0x94, 0xab, + 0x29, 0x8d, 0x7b, 0xcf, 0x4c, 0xa4, 0x47, 0x9a, 0xb6, 0x4c, 0xfc, 0x4c, 0x63, 0xf9, 0x24, 0xbb, + 0xb1, 0x01, 0x89, 0x47, 0xd5, 0xfa, 0xb1, 0xbb, 0x81, 0x20, 0x69, 0x74, 0xa5, 0xd1, 0xa5, 0x31, + 0xff, 0x2f, 0x05, 0xfe, 0x9a, 0x06, 0xd3, 0x5c, 0xf5, 0xe8, 0x22, 0xa4, 0x4d, 0xd7, 0xa1, 0x86, + 0xed, 0xc8, 0x79, 0x93, 0xc6, 0x7d, 0x42, 0xa4, 0xe4, 0x2b, 0x90, 0x35, 0x4c, 0xd3, 0xed, 0x3a, + 0x54, 0x77, 0x8c, 0x36, 0x91, 0x35, 0x64, 0x24, 0x6d, 0xdd, 0x68, 0x13, 0x54, 0x02, 0xf5, 0xc8, + 0x95, 0x28, 0x34, 0x05, 0x92, 0xd4, 0x0b, 0x0b, 0x49, 0xbf, 0xf1, 0x87, 0x1a, 0xcc, 0x7d, 0xe4, + 0xd9, 0x94, 0x54, 0x0c, 0x6a, 0xee, 0xc4, 0xe0, 0xf4, 0xdf, 0x82, 0xb4, 0x65, 0x50, 0x43, 0xe4, + 0xf9, 0x4e, 0x8d, 0xe7, 0x96, 0xd3, 0x8c, 0x95, 0xe7, 0xb9, 0xbe, 0x08, 0x92, 0xec, 0xbf, 0x58, + 0x0f, 0x30, 0xff, 0xdf, 0x0f, 0x09, 0x05, 0x5b, 0x19, 0xa7, 0x43, 0xfb, 0xbb, 0x29, 0xe5, 0xd0, + 0x62, 0xe8, 0xfd, 0x7b, 0x30, 0x2b, 0xf7, 0x57, 0xb2, 0xef, 0x0b, 0x93, 0xe6, 0xa3, 0x8a, 0x69, + 0x48, 0x36, 0x54, 0x01, 0xf0, 0xa9, 0xe1, 0x51, 0xbe, 0x33, 0x3a, 0x52, 0x1c, 0x58, 0xf9, 0x3d, + 0xce, 0xc6, 0xa8, 0x68, 0x1d, 0x32, 0xed, 0x97, 0xa6, 0xa9, 0x6f, 0xdb, 0x2d, 0x2a, 0x43, 0xc0, + 0xf9, 0x01, 0x21, 0xaa, 0x25, 0x4f, 0x3f, 0xac, 0x56, 0x1f, 0xf2, 0x42, 0x22, 0x12, 0xdb, 0x7f, + 0xc6, 0xc0, 0x24, 0x88, 0xff, 0xe8, 0xdb, 0x20, 0xd3, 0xc7, 0x74, 0xdf, 0xa7, 0x7c, 0x7a, 0xa5, + 0x2a, 0xb9, 0xc3, 0x83, 0x52, 0x1a, 0x73, 0x6a, 0xbd, 0xde, 0xc0, 0x69, 0x51, 0xa0, 0xee, 0xab, + 0x45, 0xf5, 0x07, 0x1a, 0xe4, 0x2a, 0xdd, 0xd6, 0xf3, 0x8d, 0x4e, 0xbd, 0xdb, 0x6e, 0x1b, 0xde, + 0x3e, 0xba, 0xa0, 0x2c, 0xc3, 0xfe, 0x8c, 0x70, 0xcd, 0x26, 0xe4, 0xd0, 0xdb, 0x9f, 0x11, 0x36, + 0xf4, 0x32, 0x55, 0x85, 0xd1, 0x45, 0x1e, 0xca, 0x55, 0xc8, 0xf1, 0x3d, 0x81, 0x4e, 0x1c, 0xea, + 0xd9, 0x44, 0xec, 0x3f, 0x13, 0x38, 0xcb, 0x89, 0xab, 0x82, 0x86, 0xae, 0x43, 0xde, 0xdf, 0xf7, + 0x29, 0x69, 0xeb, 0x22, 0xa7, 0x5e, 0xa4, 0x56, 0x26, 0x70, 0x4e, 0x50, 0xb1, 0x20, 0x96, 0xff, + 0x6d, 0x0a, 0xf2, 0x6a, 0x94, 0xe3, 0x04, 0x73, 0x15, 0x98, 0xde, 0xb6, 0x5b, 0xbd, 0x18, 0x49, + 0xb4, 0xfb, 0x55, 0x92, 0x16, 0x99, 0x93, 0x55, 0xd0, 0x8e, 0xb3, 0xce, 0x7f, 0xa9, 0x41, 0x92, + 0xaf, 0x57, 0xf7, 0x20, 0xc9, 0xa7, 0x8d, 0x76, 0x94, 0x69, 0xc3, 0x8b, 0xf6, 0x3c, 0xf5, 0x54, + 0xdf, 0x53, 0x73, 0x2f, 0xb9, 0x63, 0x3c, 0xb8, 0x77, 0x9f, 0x0f, 0x55, 0x16, 0xcb, 0x27, 0x54, + 0x81, 0x14, 0xe1, 0x6d, 0x21, 0x96, 0x5c, 0x2d, 0xc2, 0xac, 0x73, 0x60, 0xd0, 0xd4, 0x14, 0x55, + 0x7c, 0xe8, 0x3c, 0x24, 0x98, 0x0d, 0xcc, 0x8a, 0xd3, 0xf4, 0xc3, 0x83, 0x52, 0x82, 0x8d, 0x3e, + 0xa3, 0x89, 0x90, 0xd4, 0xfb, 0xc9, 0x54, 0xb2, 0x30, 0x5d, 0xfe, 0x93, 0x24, 0xe4, 0x6a, 0xed, + 0x98, 0x26, 0xd5, 0xf2, 0xa0, 0x8e, 0xc3, 0xd6, 0xf0, 0x81, 0xba, 0x46, 0x55, 0x3c, 0xe8, 0x95, + 0x12, 0xc7, 0xf3, 0x4a, 0x35, 0xb6, 0x42, 0xc8, 0xfb, 0x07, 0xac, 0xfe, 0x6f, 0x4d, 0xac, 0xbf, + 0x61, 0x6c, 0xb5, 0x08, 0x66, 0x3c, 0xbd, 0x80, 0x18, 0x17, 0x80, 0x7e, 0x96, 0x2f, 0x44, 0x62, + 0x6a, 0xcf, 0x1c, 0x7d, 0x6a, 0xcf, 0x12, 0xc7, 0x62, 0xb4, 0xf9, 0x3d, 0x69, 0x28, 0x6f, 0x40, + 0xc2, 0xb2, 0x95, 0x26, 0x8f, 0xea, 0x62, 0x18, 0xcb, 0x04, 0x7b, 0x49, 0x06, 0xed, 0x25, 0x18, + 0x69, 0x9c, 0xdf, 0x00, 0xe8, 0xf7, 0x0a, 0x2d, 0xc0, 0x8c, 0xdb, 0xb2, 0x18, 0x74, 0x67, 0x4d, + 0xc8, 0x55, 0xd2, 0x87, 0x07, 0xa5, 0xe9, 0x8d, 0x96, 0x55, 0x5b, 0xc1, 0xd3, 0x6e, 0xcb, 0xaa, + 0x59, 0xfc, 0xda, 0x06, 0xd9, 0xd5, 0xf9, 0x6d, 0x15, 0x9e, 0x9f, 0x80, 0x67, 0x1d, 0xb2, 0xbb, + 0x42, 0x7c, 0x33, 0xb8, 0xfc, 0x48, 0x6b, 0xf9, 0x7d, 0x0d, 0xf2, 0x4a, 0x83, 0xf1, 0x4e, 0xce, + 0x94, 0xdd, 0x96, 0x06, 0x9f, 0x38, 0x9e, 0xc1, 0x2b, 0x3e, 0x99, 0xa6, 0xf7, 0x7d, 0x0d, 0x4e, + 0x89, 0x24, 0x0a, 0xd3, 0xa0, 0xcc, 0x3d, 0x7e, 0x7d, 0xab, 0xbe, 0x0d, 0x05, 0xcf, 0x70, 0x2c, + 0xb7, 0x6d, 0x7f, 0x46, 0xc4, 0x06, 0xd8, 0x97, 0x09, 0x41, 0x27, 0x7b, 0x74, 0xbe, 0xd5, 0x53, + 0xa7, 0xd1, 0x3f, 0xd5, 0xe0, 0xf4, 0x60, 0x1b, 0xe2, 0xd4, 0xd5, 0x93, 0xa1, 0x68, 0xef, 0x6b, + 0x21, 0x42, 0xc2, 0x6a, 0x17, 0x51, 0xdb, 0xc1, 0xc0, 0xef, 0xfc, 0x7b, 0x30, 0xcd, 0xc9, 0xaf, + 0xe0, 0xd1, 0xa4, 0xc2, 0x77, 0x60, 0x6e, 0xd9, 0xb2, 0xea, 0x75, 0x69, 0x74, 0x5f, 0x5b, 0xdb, + 0x0a, 0x5a, 0x4c, 0x85, 0x41, 0x8b, 0x60, 0x4d, 0x71, 0x42, 0x8b, 0x26, 0xe4, 0x65, 0x9e, 0x52, + 0x3c, 0xc7, 0x65, 0xbb, 0x0c, 0x02, 0x49, 0x23, 0x11, 0x0f, 0xfd, 0xfb, 0x02, 0xbd, 0x8a, 0xe2, + 0xec, 0x40, 0x0b, 0x4e, 0x29, 0xb9, 0x31, 0x9d, 0x4e, 0x8f, 0xeb, 0x05, 0x3f, 0xe2, 0x08, 0xd6, + 0x16, 0x67, 0x57, 0xfe, 0xfd, 0x2c, 0x64, 0x65, 0xfb, 0x37, 0x1d, 0xdb, 0x75, 0xd0, 0x5d, 0x48, + 0x34, 0x25, 0xa0, 0xcf, 0x84, 0x82, 0xa3, 0xfe, 0x35, 0x2b, 0xcc, 0x4a, 0x32, 0x86, 0x4e, 0x97, + 0x86, 0xc4, 0x89, 0xfb, 0xc1, 0xc2, 0x3e, 0x43, 0xa7, 0x4b, 0xd1, 0x07, 0x70, 0xd2, 0xec, 0x5f, + 0x78, 0xd1, 0x19, 0x73, 0x22, 0x32, 0x1b, 0x2f, 0xf4, 0xde, 0x0f, 0xce, 0x9b, 0x03, 0x64, 0xb4, + 0x1c, 0xbc, 0x71, 0x91, 0x8c, 0xdc, 0x35, 0x0e, 0x5f, 0xf2, 0x08, 0x5c, 0xcb, 0x40, 0x6f, 0xc0, + 0x8c, 0xc5, 0x33, 0xfb, 0xe5, 0xae, 0x33, 0xcc, 0x25, 0x0e, 0x5c, 0x9d, 0xc0, 0xb2, 0x3c, 0x7a, + 0x0c, 0x59, 0xf1, 0x4f, 0xa4, 0x72, 0xc8, 0x15, 0xec, 0x7a, 0x34, 0x7f, 0xc0, 0x66, 0x70, 0xc6, + 0xea, 0xd3, 0xd0, 0x7d, 0x48, 0xfa, 0xa6, 0x21, 0xb6, 0x5c, 0xe1, 0x71, 0xaf, 0x40, 0x46, 0x36, + 0xe6, 0x65, 0xd1, 0x47, 0x30, 0xb7, 0x45, 0x9a, 0xb6, 0xa3, 0xd3, 0x7e, 0xac, 0x81, 0xe7, 0x03, + 0x0e, 0x86, 0x37, 0x7a, 0x5e, 0x3d, 0x3c, 0xe9, 0x14, 0x17, 0xb6, 0x86, 0x5e, 0xb0, 0x61, 0xe2, + 0x8b, 0x72, 0x40, 0x6c, 0x3a, 0x72, 0x98, 0x42, 0xb3, 0x41, 0x71, 0x9e, 0x0c, 0x90, 0xd1, 0x2a, + 0x64, 0x0c, 0xe6, 0x2b, 0x75, 0x9e, 0x8a, 0x57, 0x84, 0xc8, 0x93, 0x82, 0x91, 0xa4, 0x40, 0x0c, + 0x46, 0x8f, 0xd4, 0x17, 0xd3, 0x26, 0x5e, 0x93, 0x14, 0x33, 0xe3, 0xc5, 0x04, 0x63, 0x0f, 0x52, + 0x0c, 0x27, 0xa1, 0x27, 0x90, 0xdb, 0x51, 0xf9, 0x29, 0x3c, 0x28, 0x94, 0x8d, 0x3c, 0x2a, 0x08, + 0x49, 0xab, 0xc1, 0xd9, 0x9d, 0x00, 0x11, 0x7d, 0x1b, 0xa6, 0x9a, 0x66, 0x31, 0xc7, 0x25, 0x5c, + 0x1c, 0x97, 0x44, 0x82, 0xa7, 0x9a, 0x26, 0x7a, 0x07, 0x52, 0x22, 0xcc, 0xbe, 0xe7, 0x14, 0xf3, + 0x91, 0x93, 0x77, 0x30, 0xc3, 0x01, 0xf3, 0x74, 0x00, 0x56, 0xd7, 0x63, 0xc8, 0x8a, 0x58, 0x40, + 0x8b, 0xa7, 0x37, 0x15, 0x4f, 0x46, 0x1a, 0xdc, 0x68, 0x6e, 0x16, 0x16, 0x77, 0x43, 0x05, 0x0d, + 0xad, 0x43, 0xde, 0x13, 0xe1, 0x1f, 0x99, 0x9a, 0x5f, 0x2c, 0x70, 0x59, 0x37, 0xc3, 0x5d, 0xc9, + 0x48, 0xd0, 0x13, 0xe7, 0xbc, 0x20, 0x15, 0x7d, 0x0f, 0x4e, 0x0f, 0xca, 0x93, 0x53, 0x62, 0x8e, + 0x4b, 0xfd, 0xf6, 0x44, 0xa9, 0xc1, 0x99, 0x81, 0xbc, 0x91, 0x57, 0xe8, 0x01, 0x4c, 0x8b, 0x31, + 0x47, 0x5c, 0x60, 0x29, 0x6c, 0xef, 0x16, 0x1c, 0x6e, 0x51, 0x9a, 0x29, 0x8c, 0xca, 0x18, 0x88, + 0xde, 0x72, 0x9b, 0xc5, 0x53, 0x91, 0x0a, 0x1b, 0x0d, 0xe5, 0xe0, 0x0c, 0xed, 0xd3, 0x98, 0xcd, + 0x78, 0x82, 0x2e, 0x0f, 0xe7, 0x4f, 0x47, 0xda, 0x4c, 0x48, 0x60, 0x04, 0x67, 0xbd, 0x00, 0x91, + 0x8f, 0xa3, 0xc8, 0x5e, 0xd3, 0xf9, 0xb4, 0x3f, 0x13, 0x3d, 0x8e, 0x23, 0xf7, 0x31, 0x70, 0xc6, + 0xeb, 0xd3, 0x50, 0x03, 0x0a, 0x32, 0x0d, 0x5e, 0x57, 0x47, 0xbc, 0xc5, 0xb3, 0x5c, 0xda, 0xed, + 0x50, 0x9f, 0x1a, 0x76, 0xa4, 0x8d, 0x4f, 0x9a, 0x83, 0x74, 0xd4, 0x81, 0x79, 0xab, 0x77, 0x78, + 0xaa, 0xbf, 0xe4, 0xa7, 0xa7, 0x7d, 0xf9, 0xe7, 0xb8, 0xfc, 0xfb, 0xa1, 0x6e, 0x6e, 0xec, 0xa9, + 0x2e, 0x2e, 0x5a, 0x11, 0x05, 0x98, 0x33, 0xe3, 0xf2, 0x75, 0xb3, 0x7f, 0x4d, 0xa1, 0x58, 0x8c, + 0x74, 0x66, 0x11, 0x57, 0x29, 0x70, 0xc1, 0x1c, 0x7a, 0xc1, 0x3c, 0xab, 0xe3, 0xba, 0x9d, 0xe2, + 0xf9, 0x48, 0xcf, 0x1a, 0x88, 0x8a, 0x62, 0x5e, 0x96, 0x4d, 0x52, 0xdb, 0xb1, 0x29, 0x5f, 0xa0, + 0xe6, 0x23, 0x27, 0xe9, 0xe0, 0xdd, 0x4a, 0x3c, 0x6b, 0x8b, 0x67, 0x36, 0xb5, 0xa8, 0x0c, 0x26, + 0x49, 0x53, 0xb9, 0x18, 0x39, 0xb5, 0xc2, 0xa2, 0x4e, 0x38, 0x47, 0x83, 0x54, 0x36, 0xb5, 0x84, + 0xd3, 0x1b, 0x92, 0x7a, 0x29, 0x72, 0x6a, 0x45, 0x26, 0xf4, 0x62, 0x64, 0x8c, 0xbc, 0x42, 0x15, + 0x00, 0x2e, 0x90, 0xdf, 0x1a, 0x2f, 0x5e, 0x8e, 0x5c, 0x43, 0x87, 0x63, 0x4a, 0x38, 0xdd, 0x52, + 0x14, 0xe6, 0x98, 0x39, 0x70, 0xd1, 0xb7, 0x0c, 0x6a, 0xee, 0x14, 0x4b, 0x91, 0x8e, 0x79, 0xe4, + 0x68, 0x0d, 0xc3, 0x6e, 0x8f, 0xc4, 0x96, 0x62, 0xb1, 0xb1, 0x2e, 0x2e, 0x4c, 0xd8, 0xc9, 0xf5, + 0x96, 0x62, 0x51, 0x1e, 0x7d, 0x07, 0xd2, 0x2f, 0xba, 0xc4, 0xdb, 0xe7, 0x8e, 0xf5, 0x4a, 0xe4, + 0xd7, 0x00, 0x86, 0x92, 0x7c, 0x70, 0xea, 0x85, 0x24, 0xb0, 0xaa, 0xc5, 0x16, 0xa7, 0x58, 0x8e, + 0xac, 0x7a, 0x60, 0x53, 0x8b, 0x65, 0x79, 0x64, 0xc0, 0x19, 0x31, 0x3e, 0x32, 0x0f, 0xd8, 0x93, + 0x09, 0xb7, 0xc5, 0xab, 0x5c, 0x50, 0xe4, 0xbe, 0x21, 0x34, 0x15, 0x19, 0x9f, 0x32, 0x46, 0xdf, + 0x31, 0xe7, 0x23, 0x97, 0x4f, 0xb1, 0xd7, 0x28, 0x5e, 0x8b, 0x74, 0x3e, 0x21, 0x9b, 0x32, 0x9c, + 0x35, 0x02, 0x44, 0xb1, 0x88, 0x5a, 0xba, 0xef, 0x53, 0x06, 0xf0, 0x8b, 0xd7, 0xc7, 0x2c, 0xa2, + 0x43, 0xfb, 0x0d, 0x7e, 0x8f, 0xa5, 0x2e, 0xf8, 0x78, 0xe2, 0x73, 0x8b, 0x18, 0x9e, 0x74, 0xf4, + 0x37, 0x22, 0xc5, 0x8c, 0xdc, 0x5e, 0xc4, 0x60, 0xf6, 0x48, 0x0c, 0x6c, 0x78, 0xea, 0x26, 0x8f, + 0xee, 0x53, 0x83, 0xfa, 0xc5, 0x9b, 0x91, 0x60, 0x23, 0xf4, 0x9e, 0x11, 0xce, 0x7b, 0x03, 0x64, + 0xf4, 0x36, 0xcc, 0xca, 0x4b, 0x12, 0xc5, 0x5b, 0x63, 0xf0, 0x71, 0x70, 0x1f, 0x82, 0x15, 0x87, + 0xf0, 0xf3, 0xe2, 0x86, 0x85, 0xe8, 0xd8, 0xed, 0x31, 0x7e, 0x7e, 0x64, 0x27, 0xc0, 0xfc, 0x7c, + 0x9f, 0xf8, 0x56, 0xf2, 0x0b, 0xb1, 0xa7, 0xbf, 0x50, 0xb8, 0x58, 0xfe, 0xd1, 0x59, 0xc8, 0x29, + 0x50, 0x2e, 0x00, 0xf7, 0xeb, 0x41, 0xc0, 0x7d, 0x39, 0x0a, 0x70, 0x0b, 0x0e, 0x81, 0xb8, 0x5f, + 0x0f, 0x22, 0xee, 0xcb, 0x51, 0x88, 0x5b, 0x71, 0x30, 0xc8, 0x8d, 0xa3, 0x20, 0xf7, 0xed, 0x23, + 0x40, 0x6e, 0x29, 0x68, 0x18, 0x73, 0x57, 0x46, 0x31, 0xf7, 0xb5, 0xf1, 0x98, 0x5b, 0x0a, 0x0a, + 0x80, 0xee, 0x37, 0x87, 0x40, 0xf7, 0x95, 0x31, 0xa0, 0x5b, 0x72, 0x2b, 0xd4, 0x5d, 0x0b, 0x45, + 0xdd, 0x37, 0x26, 0xa1, 0x6e, 0x29, 0x65, 0x00, 0x76, 0x2f, 0x0d, 0xc0, 0xee, 0x52, 0x24, 0xec, + 0x96, 0xbc, 0x02, 0x77, 0x7f, 0x1c, 0x8d, 0xbb, 0xbf, 0x75, 0x24, 0xdc, 0x2d, 0xa5, 0x8d, 0x02, + 0x6f, 0x1c, 0x05, 0xbc, 0x6f, 0x1f, 0x01, 0x78, 0xab, 0xc1, 0x1a, 0x42, 0xde, 0x0f, 0xc3, 0x90, + 0xf7, 0xf5, 0x09, 0xc8, 0x5b, 0xca, 0x0a, 0x42, 0xef, 0x87, 0x61, 0xd0, 0xfb, 0xfa, 0x04, 0xe8, + 0x3d, 0x20, 0x47, 0x60, 0xef, 0xb5, 0x70, 0xec, 0x7d, 0x73, 0x22, 0xf6, 0x96, 0xb2, 0x06, 0xc1, + 0xf7, 0x6b, 0x01, 0xf0, 0x7d, 0x29, 0x02, 0x7c, 0x4b, 0x46, 0x86, 0xbe, 0xdf, 0x1d, 0x41, 0xdf, + 0xe5, 0x71, 0xe8, 0x5b, 0x72, 0xf6, 0xe0, 0x77, 0x2d, 0x14, 0x7e, 0xdf, 0x98, 0x04, 0xbf, 0x95, + 0xe5, 0x05, 0xf1, 0xf7, 0x46, 0x04, 0xfe, 0xbe, 0x35, 0x19, 0x7f, 0x4b, 0x71, 0x43, 0x00, 0x5c, + 0x1f, 0x0b, 0xc0, 0x5f, 0x3b, 0x22, 0x00, 0x97, 0xb2, 0xc3, 0x10, 0xf8, 0xff, 0x1f, 0x44, 0xe0, + 0x0b, 0xd1, 0x08, 0x5c, 0x0a, 0x91, 0x10, 0xbc, 0x16, 0x0a, 0xc1, 0x6f, 0x4c, 0x82, 0xe0, 0x4a, + 0x69, 0x41, 0x0c, 0xbe, 0x16, 0x8e, 0xc1, 0x6f, 0x4e, 0xc4, 0xe0, 0xca, 0x76, 0x06, 0x40, 0x78, + 0x2d, 0x14, 0x84, 0xdf, 0x98, 0x04, 0xc2, 0x7b, 0xa3, 0x19, 0x40, 0xe1, 0x9b, 0x91, 0x28, 0xfc, + 0xce, 0x51, 0x50, 0xb8, 0x14, 0x39, 0x02, 0xc3, 0x5f, 0x1c, 0x01, 0x86, 0x2f, 0x1d, 0x0b, 0x86, + 0xcb, 0x9a, 0xa2, 0x71, 0xf8, 0xc7, 0xd1, 0x38, 0xfc, 0x5b, 0x47, 0xc2, 0xe1, 0xca, 0xb9, 0x8d, + 0x00, 0xf1, 0xa5, 0x01, 0x20, 0x5e, 0x8a, 0x04, 0xe2, 0xca, 0xd7, 0x72, 0x24, 0xfe, 0xee, 0x08, + 0x12, 0x2f, 0x8f, 0x43, 0xe2, 0x6a, 0xc2, 0x2a, 0x28, 0xae, 0x8f, 0x85, 0xce, 0xaf, 0x1d, 0x11, + 0x3a, 0xab, 0x49, 0x11, 0x82, 0x9d, 0xab, 0x21, 0xd8, 0xf9, 0xda, 0x78, 0xec, 0xac, 0xd6, 0xc2, + 0x3e, 0x78, 0x7e, 0x18, 0x06, 0x9e, 0xaf, 0x4f, 0x00, 0xcf, 0xca, 0xb5, 0x06, 0xd0, 0xf3, 0x9b, + 0x43, 0xe8, 0xf9, 0xca, 0xc4, 0xd8, 0x5b, 0x0f, 0x3e, 0xbf, 0x37, 0x0a, 0x9f, 0xaf, 0x8e, 0x85, + 0xcf, 0x92, 0xbf, 0x8f, 0x9f, 0xdf, 0x1c, 0xc2, 0xcf, 0x57, 0xc6, 0xe0, 0x67, 0x55, 0xb9, 0x04, + 0xd0, 0x5b, 0xe3, 0x01, 0xf4, 0xe2, 0x51, 0x01, 0xb4, 0x14, 0x1b, 0x8a, 0xa0, 0xd7, 0xc2, 0x11, + 0xf4, 0xcd, 0x23, 0x1e, 0xea, 0x0f, 0x41, 0xe8, 0x87, 0x61, 0x10, 0xfa, 0xfa, 0x04, 0x08, 0xdd, + 0x5f, 0x0c, 0x7b, 0x18, 0xfa, 0x61, 0x18, 0x86, 0xbe, 0x3e, 0x01, 0x43, 0x2b, 0x39, 0x01, 0x10, + 0x8d, 0xa3, 0x40, 0xf4, 0xed, 0x23, 0x80, 0x68, 0x05, 0x1c, 0x86, 0x50, 0xf4, 0x3b, 0xc3, 0x28, + 0xba, 0x3c, 0x0e, 0x45, 0xab, 0x99, 0xa7, 0x60, 0xf4, 0x5a, 0x38, 0x8c, 0xbe, 0x39, 0x11, 0x46, + 0xf7, 0x5d, 0x75, 0x38, 0x8e, 0x7e, 0x3f, 0x99, 0xba, 0x58, 0xb8, 0x54, 0xfe, 0x7c, 0x1a, 0x66, + 0x1e, 0xab, 0x68, 0x68, 0xe0, 0xd2, 0x92, 0xf6, 0x2a, 0x97, 0x96, 0xd0, 0x0a, 0xeb, 0x2b, 0xb7, + 0x14, 0x89, 0xad, 0xc7, 0xdc, 0xbe, 0x1c, 0xb9, 0x8f, 0xa7, 0x58, 0x5f, 0x21, 0x53, 0x17, 0x3d, + 0x80, 0x5c, 0xd7, 0x27, 0x9e, 0xde, 0xf1, 0x6c, 0xd7, 0xb3, 0xa9, 0x48, 0x4e, 0xd1, 0x2a, 0x85, + 0xaf, 0x0e, 0x4a, 0xd9, 0x4d, 0x9f, 0x78, 0xcf, 0x24, 0x1d, 0x67, 0xbb, 0x81, 0x27, 0xf5, 0xbd, + 0xb9, 0xe9, 0xa3, 0x7f, 0x6f, 0xee, 0x03, 0x28, 0x78, 0xc4, 0xb0, 0x06, 0xdc, 0xba, 0xb8, 0xe5, + 0x13, 0xbe, 0xe0, 0x19, 0x56, 0xc0, 0x77, 0xf3, 0xdb, 0x3e, 0x27, 0xbd, 0x41, 0x22, 0xba, 0x07, + 0x67, 0xda, 0xc6, 0x9e, 0xb8, 0xbe, 0xa6, 0x96, 0x65, 0x1e, 0x15, 0x4e, 0xf1, 0x7c, 0x03, 0xd4, + 0x36, 0xf6, 0xf8, 0xc7, 0xeb, 0xc4, 0x2b, 0xfe, 0xa1, 0x9d, 0xeb, 0x90, 0xb7, 0x6c, 0x9f, 0xda, + 0x8e, 0xa9, 0xae, 0xcd, 0xa7, 0xc5, 0x9d, 0x16, 0x45, 0x15, 0x37, 0xe3, 0xef, 0xc0, 0x9c, 0x4c, + 0xaf, 0xe8, 0x7f, 0xce, 0x8e, 0x23, 0xd7, 0x14, 0x6b, 0x05, 0x7b, 0xd1, 0xff, 0x02, 0x60, 0x15, + 0x4e, 0x36, 0x0d, 0x4a, 0x76, 0x8d, 0x7d, 0xdd, 0x71, 0x2d, 0xae, 0xfb, 0x0c, 0xbf, 0x70, 0x7c, + 0xe1, 0xf0, 0xa0, 0x94, 0x7b, 0x24, 0x5e, 0xad, 0xbb, 0x96, 0x18, 0x81, 0x19, 0xf1, 0x0f, 0xe7, + 0x9a, 0x81, 0x17, 0x16, 0x5a, 0x86, 0x2c, 0x83, 0x00, 0xba, 0x2b, 0xbe, 0x59, 0x23, 0x31, 0x69, + 0xd4, 0x31, 0xbc, 0xfc, 0xb2, 0x0d, 0xce, 0xf8, 0xfd, 0x07, 0x79, 0xd9, 0xfe, 0x73, 0x0d, 0xb2, + 0x03, 0x89, 0x43, 0x6f, 0x0f, 0x85, 0x6a, 0xce, 0x87, 0xe3, 0xdc, 0xf0, 0x10, 0xe4, 0x32, 0xa4, + 0xa4, 0x62, 0x55, 0x10, 0xb2, 0x14, 0x0d, 0x75, 0xf8, 0x9e, 0x52, 0x45, 0x6b, 0x15, 0xdb, 0x5b, + 0xc9, 0xdf, 0xf9, 0x61, 0xe9, 0x44, 0xf9, 0x27, 0x09, 0xc8, 0x0d, 0x66, 0x0a, 0xd5, 0x86, 0xda, + 0x15, 0x36, 0x31, 0x07, 0x38, 0xa2, 0x5b, 0xb9, 0x02, 0x69, 0x4f, 0x16, 0x52, 0xcd, 0x5c, 0x18, + 0x13, 0x90, 0x0a, 0xb6, 0xb3, 0xcf, 0x38, 0xff, 0x97, 0x53, 0xbd, 0x09, 0xbd, 0x08, 0xd3, 0xfc, + 0x03, 0x94, 0xb2, 0x69, 0x61, 0xf9, 0xc0, 0xab, 0xec, 0x3d, 0x16, 0xc5, 0x98, 0x03, 0x68, 0xbc, + 0xd2, 0xad, 0xc5, 0x1e, 0xe1, 0x15, 0x3e, 0xe0, 0xf8, 0x8a, 0xd7, 0xec, 0xea, 0x6c, 0x3f, 0xde, + 0x6a, 0x11, 0x93, 0xca, 0x6f, 0x5d, 0xaa, 0xcf, 0x34, 0x5e, 0x1b, 0x16, 0x21, 0xbf, 0x8c, 0xb9, + 0x88, 0xe5, 0x97, 0x31, 0x03, 0x71, 0xe1, 0x7c, 0x4f, 0x04, 0x9f, 0x2f, 0x22, 0x69, 0x40, 0x0c, + 0xf5, 0x9d, 0x35, 0x38, 0x15, 0x32, 0x7b, 0x51, 0x1e, 0xa0, 0xba, 0xb1, 0x5e, 0xaf, 0xd5, 0x1b, + 0xab, 0xeb, 0x8d, 0xc2, 0x09, 0x94, 0x83, 0x34, 0x7b, 0x5e, 0x5d, 0xaf, 0x6f, 0xd6, 0x0b, 0x1a, + 0x2a, 0x40, 0xb6, 0xb6, 0x1e, 0x28, 0x20, 0x3f, 0xae, 0x78, 0xe7, 0x23, 0xc8, 0x04, 0x6e, 0xfc, + 0x21, 0x04, 0xf9, 0x67, 0x9b, 0xf5, 0xc7, 0x7a, 0xa3, 0xf6, 0x74, 0xb5, 0xde, 0x58, 0x7e, 0xfa, + 0xac, 0x70, 0x82, 0x49, 0xe6, 0xb4, 0xe5, 0xca, 0x06, 0x6e, 0x14, 0xb4, 0xde, 0x73, 0x63, 0x63, + 0xb3, 0xfa, 0xb8, 0x30, 0xd5, 0x7b, 0xfe, 0x60, 0x73, 0x15, 0x7f, 0x52, 0x48, 0x48, 0xc1, 0x06, + 0x9c, 0x09, 0x4d, 0x80, 0x45, 0x19, 0x98, 0xdd, 0x74, 0xf8, 0xf5, 0x33, 0xd1, 0xca, 0x5e, 0x1e, + 0x66, 0x41, 0x43, 0x29, 0x91, 0x6b, 0x59, 0x98, 0x42, 0x33, 0x30, 0x55, 0x5f, 0x2a, 0x24, 0xd0, + 0x49, 0xc8, 0x04, 0x12, 0x49, 0x0b, 0x49, 0x94, 0x96, 0xd9, 0x84, 0x85, 0xe9, 0x3b, 0x57, 0x20, + 0x90, 0xbe, 0x85, 0x00, 0x66, 0xd6, 0x0c, 0x4a, 0x7c, 0x5a, 0x38, 0x81, 0x66, 0x21, 0xb1, 0xdc, + 0x6a, 0x15, 0xb4, 0xfb, 0x1f, 0x43, 0x4a, 0x7d, 0xf4, 0x03, 0xad, 0xc1, 0xb4, 0x80, 0x51, 0xa5, + 0xe8, 0xa9, 0xc0, 0x27, 0xd5, 0xfc, 0xc2, 0xa4, 0xb9, 0x52, 0x3e, 0x51, 0xb9, 0xf2, 0xc5, 0xbf, + 0x5c, 0x3e, 0xf1, 0xc5, 0xe1, 0x65, 0xed, 0xcb, 0xc3, 0xcb, 0xda, 0x3f, 0x1c, 0x5e, 0xd6, 0xfe, + 0xf9, 0xf0, 0xb2, 0xf6, 0x5b, 0xff, 0x7a, 0xf9, 0xc4, 0xa7, 0xb3, 0x92, 0x65, 0x6b, 0x86, 0x7f, + 0xcf, 0x74, 0xe9, 0xbf, 0x03, 0x00, 0x00, 0xff, 0xff, 0x8f, 0x2f, 0xa4, 0x73, 0xb0, 0x55, 0x00, + 0x00, } diff --git a/pkg/roachpb/api.proto b/pkg/roachpb/api.proto index f0ffed6c28ca..7ff3c56aab5d 100644 --- a/pkg/roachpb/api.proto +++ b/pkg/roachpb/api.proto @@ -458,7 +458,8 @@ message EndTransactionRequest { // Set to true if this transaction is serializable isolation but has // accummulated no refresh spans. This allows the executing server // to retry it locally on the fast path. - bool no_refresh_spans = 7; + bool no_refresh_spans = 8; + reserved 7; } // An EndTransactionResponse is the return value from the diff --git a/pkg/roachpb/batch.go b/pkg/roachpb/batch.go index 1ff85b2d687d..a5021dd660ae 100644 --- a/pkg/roachpb/batch.go +++ b/pkg/roachpb/batch.go @@ -228,20 +228,19 @@ func (ba *BatchRequest) IntentSpanIterate(br *BatchResponse, fn func(Span)) { } } -// RefreshSpanIterate calls the passed method with the key spans of -// requests in the batch which have the isRefreshRead or -// isRefreshWrite flags set, meaning they cover a key or span of keys -// which must be checked via Refresh/RefreshRange to avoid having to -// restart a SERIALIZABLE transaction. Usually the key spans contained -// in the requests are used, but when a response contains a ResumeSpan -// the ResumeSpan is subtracted from the request span to provide a -// more minimal span of keys affected by the request. The supplied -// function is called with each span and a bool indicating whether the -// span updates the write timestamp cache. +// RefreshSpanIterate calls the passed function with the key spans of +// requests in the batch which need to be refreshed. These requests +// must be checked via Refresh/RefreshRange to avoid having to restart +// a SERIALIZABLE transaction. Usually the key spans contained in the +// requests are used, but when a response contains a ResumeSpan the +// ResumeSpan is subtracted from the request span to provide a more +// minimal span of keys affected by the request. The supplied function +// is called with each span and a bool indicating whether the span +// updates the write timestamp cache. func (ba *BatchRequest) RefreshSpanIterate(br *BatchResponse, fn func(Span, bool)) { for i, arg := range ba.Requests { req := arg.GetInner() - if !UpdatesTimestampCache(req) { + if !NeedsRefresh(req) { continue } var resp Response diff --git a/pkg/roachpb/batch_test.go b/pkg/roachpb/batch_test.go index 11cc48103672..edaa025d8f48 100644 --- a/pkg/roachpb/batch_test.go +++ b/pkg/roachpb/batch_test.go @@ -223,6 +223,12 @@ func TestRefreshSpanIterate(t *testing.T) { }{ {&ConditionalPutRequest{}, &ConditionalPutResponse{}, Span{Key: Key("a")}, nil}, + {&PutRequest{}, &PutResponse{}, + Span{Key: Key("a-put")}, nil}, + {&InitPutRequest{}, &InitPutResponse{}, + Span{Key: Key("a-initput")}, nil}, + {&IncrementRequest{}, &IncrementResponse{}, + Span{Key: Key("a-inc")}, nil}, {&ScanRequest{}, &ScanResponse{}, Span{Key("a"), Key("c")}, &Span{Key("b"), Key("c")}}, {&GetRequest{}, &GetResponse{}, @@ -253,8 +259,8 @@ func TestRefreshSpanIterate(t *testing.T) { } ba.RefreshSpanIterate(&br, fn) // Only the conditional put isn't considered a read span. - expReadSpans := []Span{testCases[0].span, testCases[1].span, testCases[2].span, testCases[3].span} - expWriteSpans := []Span{testCases[4].span} + expReadSpans := []Span{testCases[4].span, testCases[5].span, testCases[6].span} + expWriteSpans := []Span{testCases[7].span} if !reflect.DeepEqual(expReadSpans, readSpans) { t.Fatalf("unexpected read spans: expected %+v, found = %+v", expReadSpans, readSpans) } @@ -278,7 +284,6 @@ func TestRefreshSpanIterate(t *testing.T) { writeSpans = []Span{} ba.RefreshSpanIterate(&br, fn) expReadSpans = []Span{ - {Key: Key("a")}, {Key("a"), Key("b")}, {Key: Key("b")}, {Key("e"), Key("f")}, diff --git a/pkg/roachpb/data.go b/pkg/roachpb/data.go index 9ffd019b6950..fda70eeb8448 100644 --- a/pkg/roachpb/data.go +++ b/pkg/roachpb/data.go @@ -912,9 +912,11 @@ func (t *Transaction) Update(o *Transaction) { if t.Epoch < o.Epoch || t.RefreshedTimestamp.Less(o.RefreshedTimestamp) { t.WriteTooOld = o.WriteTooOld t.RetryOnPush = o.RetryOnPush + t.OrigTimestampWasObserved = o.OrigTimestampWasObserved } else { t.WriteTooOld = t.WriteTooOld || o.WriteTooOld t.RetryOnPush = t.RetryOnPush || o.RetryOnPush + t.OrigTimestampWasObserved = t.OrigTimestampWasObserved || o.OrigTimestampWasObserved } if t.Epoch < o.Epoch { @@ -1107,7 +1109,7 @@ func CanTransactionRetryAtRefreshedTimestamp( ctx context.Context, pErr *Error, ) (bool, *Transaction) { txn := pErr.GetTxn() - if !txn.IsSerializable() { + if !txn.IsSerializable() || txn.OrigTimestampWasObserved { return false, nil } timestamp := txn.Timestamp diff --git a/pkg/roachpb/data.pb.go b/pkg/roachpb/data.pb.go index 6cc1d2dd7d18..d320988c9790 100644 --- a/pkg/roachpb/data.pb.go +++ b/pkg/roachpb/data.pb.go @@ -459,6 +459,12 @@ type Transaction struct { // transaction is restarted and the epoch is bumped. It is used during // intent resolution to more efficiently scan for intents. EpochZeroTimestamp cockroach_util_hlc.Timestamp `protobuf:"bytes,14,opt,name=epoch_zero_timestamp,json=epochZeroTimestamp" json:"epoch_zero_timestamp"` + // This flag is set if the transaction's original timestamp was + // "leaked" beyond the transaction (i.e. if returned via NOW() or + // transaction_timestamp()). If true, this prevents optimizations + // which commit at a higher timestamp without resorting to a + // client-side retry. + OrigTimestampWasObserved bool `protobuf:"varint,16,opt,name=orig_timestamp_was_observed,json=origTimestampWasObserved,proto3" json:"orig_timestamp_was_observed,omitempty"` } func (m *Transaction) Reset() { *m = Transaction{} } @@ -899,6 +905,9 @@ func (this *Transaction) Equal(that interface{}) bool { if !this.EpochZeroTimestamp.Equal(&that1.EpochZeroTimestamp) { return false } + if this.OrigTimestampWasObserved != that1.OrigTimestampWasObserved { + return false + } return true } func (this *Intent) Equal(that interface{}) bool { @@ -1432,6 +1441,18 @@ func (m *Transaction) MarshalTo(dAtA []byte) (int, error) { return 0, err } i += n20 + if m.OrigTimestampWasObserved { + dAtA[i] = 0x80 + i++ + dAtA[i] = 0x1 + i++ + if m.OrigTimestampWasObserved { + dAtA[i] = 1 + } else { + dAtA[i] = 0 + } + i++ + } return i, nil } @@ -1736,6 +1757,7 @@ func NewPopulatedTransaction(r randyData, easy bool) *Transaction { this.EpochZeroTimestamp = *v12 v13 := cockroach_util_hlc.NewPopulatedTimestamp(r, easy) this.RefreshedTimestamp = *v13 + this.OrigTimestampWasObserved = bool(bool(r.Intn(2) == 0)) if !easy && r.Intn(10) != 0 { } return this @@ -2040,6 +2062,9 @@ func (m *Transaction) Size() (n int) { n += 1 + l + sovData(uint64(l)) l = m.RefreshedTimestamp.Size() n += 1 + l + sovData(uint64(l)) + if m.OrigTimestampWasObserved { + n += 3 + } return n } @@ -3728,6 +3753,26 @@ func (m *Transaction) Unmarshal(dAtA []byte) error { return err } iNdEx = postIndex + case 16: + if wireType != 0 { + return fmt.Errorf("proto: wrong wireType = %d for field OrigTimestampWasObserved", wireType) + } + var v int + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowData + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + v |= (int(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + m.OrigTimestampWasObserved = bool(v != 0) default: iNdEx = preIndex skippy, err := skipData(dAtA[iNdEx:]) @@ -4575,113 +4620,114 @@ var ( func init() { proto.RegisterFile("roachpb/data.proto", fileDescriptorData) } var fileDescriptorData = []byte{ - // 1717 bytes of a gzipped FileDescriptorProto + // 1741 bytes of a gzipped FileDescriptorProto 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xcc, 0x58, 0xcd, 0x8f, 0x1b, 0x49, - 0x15, 0x9f, 0x1e, 0x7f, 0x3f, 0xdb, 0x33, 0x9e, 0x9a, 0xcc, 0xc6, 0x0c, 0xc2, 0x0e, 0x5e, 0x84, - 0xa2, 0x88, 0xf5, 0x88, 0x84, 0x0f, 0x31, 0x42, 0x48, 0xe3, 0x8f, 0xdd, 0xf4, 0xc6, 0x1f, 0x43, - 0xbb, 0x27, 0x2b, 0xb2, 0x42, 0x4d, 0xbb, 0xbb, 0x62, 0xb7, 0x62, 0x77, 0x35, 0x55, 0xe5, 0xc9, - 0x98, 0xbf, 0x60, 0x6f, 0xec, 0x91, 0x63, 0x24, 0x38, 0x21, 0x71, 0xdf, 0x13, 0x57, 0x72, 0x41, - 0x5a, 0x89, 0x03, 0x88, 0x83, 0x05, 0xe6, 0x82, 0xc4, 0x8d, 0x63, 0x24, 0x24, 0x54, 0xd5, 0xd5, - 0x76, 0xb3, 0xe3, 0x44, 0x1e, 0xc2, 0x81, 0xcb, 0x4c, 0xd5, 0xab, 0xf7, 0x7e, 0xef, 0xd5, 0xab, - 0xf7, 0x7e, 0x55, 0x6d, 0x40, 0x94, 0xd8, 0xce, 0x38, 0x18, 0x9e, 0xb8, 0x36, 0xb7, 0xeb, 0x01, - 0x25, 0x9c, 0xa0, 0x03, 0x87, 0x38, 0xcf, 0xa4, 0xbc, 0xae, 0x56, 0x8f, 0xdf, 0x89, 0xd4, 0xa6, - 0x98, 0xdb, 0x6b, 0xd5, 0xe3, 0x77, 0x19, 0x27, 0xd4, 0x1e, 0xe1, 0x13, 0xec, 0x8f, 0x3c, 0x3f, - 0xfa, 0x27, 0xf4, 0x2e, 0x1d, 0xe7, 0x81, 0x52, 0x2a, 0xcf, 0xb8, 0x37, 0x39, 0x19, 0x4f, 0x9c, - 0x13, 0xee, 0x4d, 0x31, 0xe3, 0xf6, 0x34, 0x50, 0x2b, 0xb7, 0x46, 0x64, 0x44, 0xe4, 0xf0, 0x44, - 0x8c, 0x42, 0x69, 0xed, 0x87, 0x90, 0x1c, 0x04, 0xb6, 0x8f, 0xbe, 0x04, 0x89, 0x67, 0x78, 0x5e, - 0x4e, 0xdc, 0xd1, 0xee, 0x16, 0x1a, 0x99, 0x57, 0x8b, 0x6a, 0xe2, 0x11, 0x9e, 0x1b, 0x42, 0x86, - 0xee, 0x40, 0x06, 0xfb, 0xae, 0x25, 0x96, 0x93, 0xff, 0xb9, 0x9c, 0xc6, 0xbe, 0xfb, 0x08, 0xcf, - 0x4f, 0x0b, 0xbf, 0x78, 0x51, 0xdd, 0xf9, 0xec, 0x45, 0x55, 0xfb, 0xfb, 0x8b, 0xaa, 0x56, 0x9b, - 0x42, 0xea, 0xb1, 0x3d, 0x99, 0x61, 0xf4, 0x65, 0xc8, 0x51, 0xfb, 0xb9, 0x35, 0x9c, 0x73, 0xcc, - 0xca, 0x9a, 0x30, 0x35, 0xb2, 0xd4, 0x7e, 0xde, 0x10, 0x73, 0x74, 0x06, 0xb9, 0x55, 0x84, 0xe5, - 0xdd, 0x3b, 0xda, 0xdd, 0xfc, 0xfd, 0xaf, 0xd4, 0xd7, 0xc9, 0x10, 0xdb, 0xa8, 0x8f, 0x27, 0x4e, - 0xdd, 0x8c, 0x94, 0x1a, 0xc9, 0x97, 0x8b, 0xea, 0x8e, 0xb1, 0xb6, 0x3a, 0x4d, 0x4a, 0x77, 0x1f, - 0x43, 0xf6, 0x11, 0x9e, 0x87, 0x1e, 0xd5, 0x2e, 0xb4, 0x0d, 0xbb, 0xf8, 0x16, 0xa4, 0x2e, 0x85, - 0x8e, 0xf2, 0x55, 0xae, 0x5f, 0x4b, 0x7c, 0x5d, 0x62, 0x28, 0x37, 0xa1, 0x72, 0xed, 0x8f, 0x1a, - 0xc0, 0x80, 0x13, 0x8a, 0x75, 0x17, 0xfb, 0x1c, 0x8d, 0x00, 0x9c, 0xc9, 0x8c, 0x71, 0x4c, 0x2d, - 0xcf, 0x55, 0x6e, 0x1e, 0x0a, 0xfd, 0x3f, 0x2f, 0xaa, 0x0f, 0x46, 0x1e, 0x1f, 0xcf, 0x86, 0x75, - 0x87, 0x4c, 0x4f, 0x56, 0xd8, 0xee, 0x70, 0x3d, 0x3e, 0x09, 0x9e, 0x8d, 0x4e, 0xe4, 0xf1, 0xcc, - 0x66, 0x9e, 0x5b, 0xbf, 0xb8, 0xd0, 0x5b, 0xcb, 0x45, 0x35, 0xd7, 0x0c, 0x01, 0xf5, 0x96, 0x91, - 0x53, 0xd8, 0xba, 0x8b, 0xde, 0x83, 0x8c, 0x4f, 0x5c, 0x2c, 0xbc, 0x88, 0x78, 0x53, 0x8d, 0x5b, - 0xcb, 0x45, 0x35, 0xdd, 0x23, 0x2e, 0xd6, 0x5b, 0xaf, 0x56, 0x23, 0x23, 0x2d, 0x94, 0x74, 0x17, - 0x7d, 0x13, 0xb2, 0xa2, 0x38, 0xa4, 0x7e, 0x42, 0xea, 0xbf, 0xb3, 0x5c, 0x54, 0x33, 0x61, 0xe4, - 0xc2, 0x20, 0x1a, 0x1a, 0x19, 0x16, 0xee, 0xa6, 0xf6, 0x6b, 0x0d, 0x0a, 0x83, 0x60, 0xe2, 0x71, - 0x93, 0x7a, 0xa3, 0x11, 0xa6, 0xa8, 0x0d, 0xb9, 0x09, 0x7e, 0xca, 0x2d, 0x17, 0x33, 0x47, 0x6e, - 0x2d, 0x7f, 0xbf, 0xb6, 0x21, 0x49, 0x86, 0xed, 0x8f, 0x70, 0x0b, 0x33, 0x87, 0x7a, 0x01, 0x27, - 0x54, 0xa5, 0x2b, 0x2b, 0x4c, 0x85, 0x14, 0x7d, 0x00, 0x40, 0xbd, 0xd1, 0x58, 0xe1, 0xec, 0xde, - 0x10, 0x27, 0x27, 0x6d, 0x85, 0x38, 0x3c, 0xdd, 0x0f, 0x93, 0xd9, 0x44, 0x29, 0x59, 0xfb, 0x95, - 0x06, 0x85, 0x2e, 0xa6, 0x23, 0xfc, 0x7f, 0x1d, 0x6c, 0xed, 0xf7, 0xbb, 0x70, 0xd4, 0x1c, 0x0b, - 0x5d, 0x03, 0x07, 0x13, 0xcf, 0xb1, 0xd9, 0x3a, 0xde, 0xbc, 0x23, 0x17, 0x2c, 0x3e, 0x0f, 0xb0, - 0x8c, 0x78, 0xef, 0xfe, 0xd7, 0x36, 0x79, 0x0a, 0x0d, 0x43, 0x14, 0x73, 0x1e, 0x60, 0x03, 0x9c, - 0xd5, 0x18, 0xb5, 0x20, 0x43, 0x43, 0x05, 0x15, 0xec, 0x1b, 0x20, 0xae, 0x85, 0x1b, 0x99, 0xa2, - 0x0b, 0x28, 0xcd, 0x02, 0xd7, 0xe6, 0xd8, 0xb5, 0x94, 0x88, 0x95, 0x13, 0x77, 0x12, 0x37, 0x84, - 0xdb, 0x57, 0x18, 0xd1, 0x56, 0xd1, 0xfb, 0xb0, 0xef, 0xe3, 0x2b, 0x1e, 0x61, 0x8a, 0x5a, 0x4c, - 0xca, 0x5a, 0xac, 0x2c, 0x17, 0xd5, 0x62, 0x0f, 0x5f, 0x71, 0xa5, 0x2a, 0x2b, 0x32, 0xb7, 0x9a, - 0x18, 0x45, 0x3f, 0xb6, 0xe6, 0x9e, 0x66, 0x05, 0x9b, 0xc8, 0x7c, 0x7e, 0xaa, 0xc1, 0x61, 0x97, - 0xb8, 0xde, 0x53, 0x0f, 0xbb, 0x82, 0xa5, 0xa2, 0x6c, 0x7e, 0x03, 0x10, 0x9b, 0x33, 0x8e, 0xa7, - 0x96, 0x43, 0xfc, 0xa7, 0xde, 0xc8, 0x62, 0x81, 0xed, 0xcb, 0xa4, 0x66, 0x8d, 0x52, 0xb8, 0xd2, - 0x94, 0x0b, 0x92, 0xda, 0xda, 0x80, 0x64, 0x2f, 0x4d, 0xbc, 0x4b, 0xec, 0x63, 0xc6, 0x42, 0xed, - 0x30, 0x7f, 0xb7, 0x37, 0x6c, 0x58, 0x18, 0x19, 0x25, 0x61, 0xd2, 0x51, 0x16, 0x42, 0xa2, 0x8e, - 0xf8, 0x1f, 0xbb, 0x70, 0xa4, 0xfb, 0x1c, 0x53, 0xdf, 0x9e, 0x34, 0xc9, 0x74, 0xba, 0xee, 0x9f, - 0x16, 0x14, 0x99, 0xe8, 0x27, 0x8b, 0x87, 0x02, 0x55, 0x96, 0xd5, 0x8d, 0x1e, 0xd6, 0x7d, 0x67, - 0x14, 0x58, 0xbc, 0x0b, 0x5b, 0x50, 0x9c, 0x8a, 0x42, 0x5f, 0xa1, 0xec, 0xbe, 0x16, 0x25, 0xde, - 0x10, 0x46, 0x61, 0x1a, 0x6f, 0x8f, 0x9f, 0xc0, 0x6d, 0x55, 0x6e, 0xd1, 0x01, 0xaf, 0xf0, 0x12, - 0x12, 0xef, 0xee, 0x06, 0xbc, 0x8d, 0x95, 0x6b, 0x1c, 0x39, 0x1b, 0x0b, 0xfa, 0x09, 0x1c, 0x4d, - 0xd5, 0xc9, 0xc8, 0x7c, 0xae, 0xf0, 0x93, 0x12, 0xff, 0xeb, 0x9b, 0xe2, 0xbd, 0x7e, 0x92, 0xc6, - 0xe1, 0xf4, 0xba, 0xf0, 0x34, 0xfb, 0x49, 0x74, 0x95, 0xfc, 0x5c, 0x83, 0x83, 0xfe, 0x90, 0x61, - 0x7a, 0x89, 0xdd, 0xd5, 0x45, 0x10, 0x27, 0x47, 0x6d, 0x0b, 0x72, 0xfc, 0x1f, 0xdc, 0x34, 0xd9, - 0xd5, 0xe5, 0xf6, 0xdb, 0x34, 0xe4, 0x4d, 0x6a, 0xfb, 0xcc, 0x76, 0xb8, 0x47, 0x7c, 0xf4, 0x10, - 0x92, 0xe2, 0x9a, 0x56, 0x87, 0x7d, 0x2f, 0x86, 0xab, 0x6e, 0xeb, 0x7a, 0x78, 0x4d, 0xd7, 0xa3, - 0xdb, 0xba, 0x6e, 0x5e, 0xf9, 0x5d, 0xcc, 0xed, 0x46, 0x56, 0x38, 0xf9, 0x7c, 0x51, 0xd5, 0x0c, - 0x89, 0x80, 0x10, 0x24, 0x7d, 0x7b, 0x1a, 0xde, 0x4f, 0x39, 0x43, 0x8e, 0xd1, 0xf7, 0x21, 0xcd, - 0xb8, 0xcd, 0x67, 0x4c, 0xa6, 0x75, 0x33, 0x63, 0xc4, 0xa2, 0x19, 0x48, 0x5d, 0x43, 0xd9, 0xa0, - 0x0f, 0x61, 0x6f, 0x62, 0x33, 0x6e, 0x8d, 0xb1, 0x4d, 0xf9, 0x10, 0xdb, 0xbc, 0x9c, 0xda, 0x7e, - 0xf7, 0x45, 0x61, 0xfa, 0x30, 0xb2, 0x14, 0x58, 0x84, 0x7a, 0x23, 0x6b, 0x9d, 0xc9, 0xf4, 0x0d, - 0xb0, 0x84, 0xe9, 0xfa, 0xfc, 0x1e, 0x42, 0x71, 0x6a, 0x5f, 0xc5, 0xa0, 0x32, 0xdb, 0x43, 0x15, - 0xa6, 0xf6, 0xd5, 0x1a, 0xe9, 0x63, 0x38, 0x24, 0xaa, 0x3c, 0xd6, 0x70, 0xac, 0x9c, 0x7d, 0x2d, - 0x99, 0x5d, 0x2b, 0x26, 0x05, 0x8b, 0xc8, 0x17, 0x17, 0x18, 0x2a, 0x43, 0xe6, 0x39, 0xf5, 0xb8, - 0xe7, 0x8f, 0xca, 0x39, 0x49, 0x2d, 0xd1, 0x14, 0x7d, 0x17, 0x32, 0x9e, 0xcf, 0xb1, 0xcf, 0x59, - 0x39, 0x2f, 0x5d, 0xbd, 0x8e, 0x46, 0x22, 0xe6, 0x55, 0xda, 0xa8, 0x06, 0x45, 0x81, 0x81, 0x2d, - 0x4e, 0x88, 0x45, 0x26, 0x6e, 0xb9, 0x20, 0x81, 0xf3, 0x52, 0x68, 0x12, 0xd2, 0x9f, 0xb8, 0x42, - 0x87, 0x62, 0x4e, 0xe7, 0x16, 0xf1, 0xad, 0x60, 0xc6, 0xc6, 0xe5, 0x62, 0xa8, 0x23, 0x85, 0x7d, - 0xff, 0x7c, 0xc6, 0xc6, 0xe8, 0x02, 0x6e, 0xe1, 0x80, 0x38, 0x63, 0xeb, 0x67, 0x98, 0x92, 0x58, - 0x22, 0xf7, 0xb6, 0x4f, 0x24, 0x92, 0x00, 0x4f, 0x30, 0x25, 0xeb, 0x74, 0x9a, 0x70, 0x48, 0xf1, - 0x53, 0x8a, 0xd9, 0x38, 0x9e, 0xcf, 0xf2, 0xfe, 0x0d, 0x50, 0x57, 0xf6, 0xab, 0x95, 0x2f, 0xbc, - 0x0e, 0x7f, 0xa7, 0x41, 0x5a, 0x97, 0xe9, 0x40, 0xdf, 0x86, 0xe4, 0x8a, 0xb8, 0xdf, 0x90, 0xc3, - 0x58, 0xa3, 0x08, 0x75, 0xd4, 0x80, 0x04, 0xbf, 0x8a, 0x08, 0xfc, 0x26, 0x1d, 0x17, 0x86, 0x28, - 0x8c, 0x63, 0x8d, 0x95, 0xb8, 0x79, 0x63, 0xa9, 0xab, 0xe0, 0x5f, 0x09, 0x48, 0x75, 0xb0, 0xcd, - 0x30, 0xfa, 0x1e, 0xa4, 0x18, 0xb7, 0x29, 0x57, 0x3b, 0xd9, 0x2a, 0x53, 0xa1, 0x05, 0xfa, 0x31, - 0x00, 0xbe, 0x0a, 0x3c, 0x6a, 0x0b, 0x37, 0xdb, 0xb1, 0x53, 0xe5, 0x9f, 0x8b, 0xea, 0x71, 0xec, - 0x85, 0x79, 0x5a, 0xa3, 0xb6, 0xef, 0xfa, 0xb3, 0xc9, 0xc4, 0x1e, 0x4e, 0x70, 0xcd, 0x88, 0x01, - 0xc6, 0x1f, 0x0c, 0x89, 0xff, 0xfe, 0xc1, 0x30, 0x83, 0xdb, 0x2e, 0x0e, 0x28, 0x76, 0xe4, 0x9b, - 0x41, 0x06, 0x2e, 0xfe, 0x32, 0x8f, 0x29, 0xba, 0x7f, 0xcb, 0x88, 0x8f, 0xd6, 0xe8, 0x03, 0x01, - 0x3e, 0x90, 0xd8, 0xa8, 0x07, 0xf9, 0x80, 0x92, 0x80, 0x30, 0x51, 0x8d, 0x6c, 0x3b, 0xf2, 0xda, - 0x5b, 0x2e, 0xaa, 0x70, 0xae, 0xac, 0xcc, 0x81, 0x01, 0x11, 0x82, 0xc9, 0xd0, 0x2d, 0x48, 0xc9, - 0xa2, 0x97, 0xd4, 0x95, 0x30, 0xc2, 0x09, 0x7a, 0x0f, 0xb2, 0x0c, 0xff, 0x74, 0x86, 0x7d, 0x07, - 0x4b, 0x22, 0x4a, 0x34, 0x0e, 0x5e, 0x2d, 0xaa, 0x45, 0x79, 0xb2, 0x03, 0xb5, 0x60, 0xac, 0x54, - 0xc2, 0xd7, 0xc9, 0x67, 0xea, 0x75, 0xb2, 0x77, 0x36, 0x24, 0x94, 0x8b, 0x2a, 0x6d, 0xfb, 0x9c, - 0xce, 0xdf, 0xf4, 0xfd, 0xf1, 0xf6, 0xb7, 0x10, 0x3a, 0x86, 0x6c, 0x40, 0x3d, 0x42, 0x3d, 0x1e, - 0x7e, 0xa8, 0xa5, 0x8c, 0xd5, 0xfc, 0x34, 0x29, 0x43, 0xfa, 0xc3, 0x2e, 0x14, 0xcc, 0x2b, 0xbf, - 0x49, 0x08, 0x75, 0x45, 0xc9, 0xa3, 0xef, 0x84, 0xbd, 0x12, 0xd6, 0x65, 0xe5, 0xcd, 0x45, 0x1e, - 0xef, 0x8f, 0x18, 0xc3, 0xed, 0xde, 0x88, 0xe1, 0xde, 0x85, 0xa2, 0x43, 0xa6, 0x53, 0xdb, 0x77, - 0x2d, 0x87, 0xcc, 0x7c, 0xae, 0x02, 0x2d, 0x28, 0x61, 0x53, 0xc8, 0x50, 0x43, 0x50, 0x9c, 0xe4, - 0x09, 0x8b, 0x62, 0xdb, 0x15, 0x55, 0xb4, 0x85, 0x8f, 0x82, 0xb2, 0x31, 0x84, 0x09, 0x6a, 0xc1, - 0x5e, 0x84, 0x21, 0xd9, 0x53, 0xd4, 0xc7, 0x16, 0x20, 0x91, 0xe3, 0x8f, 0xa4, 0x8d, 0x08, 0x37, - 0x42, 0xb9, 0xb4, 0x27, 0x9e, 0x2b, 0x4b, 0x23, 0xbb, 0x72, 0xf5, 0x58, 0xc8, 0xee, 0xfd, 0x46, - 0x83, 0x9c, 0xfc, 0x36, 0x94, 0x6f, 0xf0, 0x3c, 0x64, 0x2e, 0x7a, 0x8f, 0x7a, 0xfd, 0x8f, 0x7a, - 0xa5, 0x1d, 0x94, 0x85, 0x64, 0xef, 0xa2, 0xd3, 0x29, 0x65, 0x50, 0x06, 0x12, 0x7a, 0xcf, 0x2c, - 0x69, 0x28, 0x07, 0xa9, 0xf7, 0x3b, 0xfd, 0x33, 0xb3, 0xb4, 0x2b, 0x86, 0x8d, 0x1f, 0x99, 0xed, - 0x41, 0x29, 0x81, 0x0e, 0x61, 0xbf, 0xd5, 0xee, 0xe8, 0x5d, 0xdd, 0x6c, 0xb7, 0xac, 0x50, 0x98, - 0x15, 0xd6, 0xa6, 0xde, 0x6d, 0x97, 0x92, 0x02, 0xb4, 0xd5, 0x6e, 0xea, 0xdd, 0xb3, 0x4e, 0x29, - 0x85, 0x8e, 0xe0, 0x60, 0xad, 0x1b, 0x89, 0x73, 0xa8, 0x00, 0xd9, 0xd6, 0x85, 0x71, 0x66, 0xea, - 0xfd, 0x5e, 0x29, 0x2d, 0xb0, 0xcd, 0x8b, 0xf3, 0x4e, 0xbb, 0x04, 0x68, 0x0f, 0x40, 0xc0, 0x0c, - 0xda, 0x86, 0xde, 0x1e, 0x94, 0xdc, 0x7b, 0x3f, 0x80, 0x83, 0x6b, 0x9f, 0x11, 0x68, 0x1f, 0xf2, - 0x67, 0xad, 0x96, 0x65, 0xb4, 0xcf, 0x3b, 0x7a, 0xf3, 0xac, 0xb4, 0x83, 0x10, 0xec, 0x19, 0xed, - 0x6e, 0xff, 0x71, 0x7b, 0x25, 0xd3, 0x8e, 0x93, 0x9f, 0xfc, 0xb2, 0xb2, 0x73, 0xaf, 0x01, 0x07, - 0xd7, 0xb8, 0x4f, 0x44, 0x78, 0xde, 0xee, 0xb5, 0xf4, 0xde, 0x07, 0xa5, 0x1d, 0x54, 0x84, 0x5c, - 0xb3, 0xdf, 0xed, 0xea, 0xa6, 0xd9, 0x6e, 0x95, 0x34, 0xb1, 0x76, 0xd6, 0xe8, 0x1b, 0x62, 0xb2, - 0x1b, 0x62, 0x34, 0xbe, 0xfa, 0xf2, 0xaf, 0x95, 0x9d, 0x97, 0xcb, 0x8a, 0xf6, 0xf9, 0xb2, 0xa2, - 0xfd, 0x69, 0x59, 0xd1, 0xfe, 0xb2, 0xac, 0x68, 0x9f, 0xfe, 0xad, 0xb2, 0xf3, 0x24, 0xa3, 0x4e, - 0x65, 0x98, 0x96, 0xbf, 0x40, 0x3c, 0xf8, 0x77, 0x00, 0x00, 0x00, 0xff, 0xff, 0xc6, 0x38, 0xca, - 0x39, 0x17, 0x11, 0x00, 0x00, + 0x15, 0x9f, 0x1e, 0xdb, 0x63, 0xfb, 0xd9, 0x9e, 0xe9, 0xa9, 0xc9, 0x6c, 0xcc, 0xac, 0xb0, 0x83, + 0x17, 0xa1, 0x28, 0x62, 0x3d, 0x22, 0xe1, 0x43, 0x8c, 0x00, 0x69, 0xfc, 0xb1, 0x9b, 0xde, 0xf8, + 0x63, 0x68, 0xf7, 0x24, 0x22, 0x2b, 0xd4, 0xb4, 0xbb, 0x2b, 0x76, 0x2b, 0x76, 0x57, 0x53, 0x55, + 0x9e, 0x8c, 0xf9, 0x0b, 0xf6, 0xc6, 0x1e, 0x39, 0x46, 0x82, 0x13, 0x12, 0xf7, 0xfd, 0x0f, 0xc8, + 0x05, 0x69, 0x25, 0x0e, 0x20, 0x0e, 0x16, 0x98, 0x0b, 0x12, 0x37, 0x8e, 0x91, 0x56, 0x42, 0x55, + 0x5d, 0x6d, 0x3b, 0x3b, 0x4e, 0xe4, 0x21, 0x1c, 0xf6, 0x32, 0x53, 0xf5, 0xea, 0xbd, 0xdf, 0x7b, + 0xf5, 0x3e, 0xab, 0x0d, 0x88, 0x12, 0xc7, 0x1d, 0x86, 0xfd, 0x63, 0xcf, 0xe1, 0x4e, 0x35, 0xa4, + 0x84, 0x13, 0xb4, 0xef, 0x12, 0xf7, 0xa9, 0xa4, 0x57, 0xd5, 0xe9, 0xd1, 0x3b, 0x31, 0xdb, 0x18, + 0x73, 0x67, 0xc9, 0x7a, 0xf4, 0x1e, 0xe3, 0x84, 0x3a, 0x03, 0x7c, 0x8c, 0x83, 0x81, 0x1f, 0xc4, + 0xff, 0x04, 0xdf, 0x85, 0xeb, 0xde, 0x53, 0x4c, 0xc5, 0x09, 0xf7, 0x47, 0xc7, 0xc3, 0x91, 0x7b, + 0xcc, 0xfd, 0x31, 0x66, 0xdc, 0x19, 0x87, 0xea, 0xe4, 0xc6, 0x80, 0x0c, 0x88, 0x5c, 0x1e, 0x8b, + 0x55, 0x44, 0xad, 0xfc, 0x14, 0x92, 0xbd, 0xd0, 0x09, 0xd0, 0xd7, 0x20, 0xf1, 0x14, 0x4f, 0x8b, + 0x89, 0x5b, 0xda, 0xed, 0x7c, 0x2d, 0xfd, 0x72, 0x56, 0x4e, 0x3c, 0xc0, 0x53, 0x53, 0xd0, 0xd0, + 0x2d, 0x48, 0xe3, 0xc0, 0xb3, 0xc5, 0x71, 0xf2, 0xd5, 0xe3, 0x1d, 0x1c, 0x78, 0x0f, 0xf0, 0xf4, + 0x24, 0xff, 0x9b, 0xe7, 0xe5, 0xad, 0xcf, 0x9e, 0x97, 0xb5, 0x7f, 0x3d, 0x2f, 0x6b, 0x95, 0x31, + 0xa4, 0x1e, 0x3a, 0xa3, 0x09, 0x46, 0xef, 0x42, 0x96, 0x3a, 0xcf, 0xec, 0xfe, 0x94, 0x63, 0x56, + 0xd4, 0x84, 0xa8, 0x99, 0xa1, 0xce, 0xb3, 0x9a, 0xd8, 0xa3, 0x53, 0xc8, 0x2e, 0x2c, 0x2c, 0x6e, + 0xdf, 0xd2, 0x6e, 0xe7, 0xee, 0x7e, 0xbd, 0xba, 0x74, 0x86, 0xb8, 0x46, 0x75, 0x38, 0x72, 0xab, + 0x56, 0xcc, 0x54, 0x4b, 0xbe, 0x98, 0x95, 0xb7, 0xcc, 0xa5, 0xd4, 0x49, 0x52, 0xaa, 0xfb, 0x18, + 0x32, 0x0f, 0xf0, 0x34, 0xd2, 0xa8, 0x6e, 0xa1, 0xad, 0xb9, 0xc5, 0x77, 0x21, 0x75, 0x21, 0x78, + 0x94, 0xae, 0x62, 0xf5, 0x8a, 0xe3, 0xab, 0x12, 0x43, 0xa9, 0x89, 0x98, 0x2b, 0x7f, 0xd1, 0x00, + 0x7a, 0x9c, 0x50, 0x6c, 0x78, 0x38, 0xe0, 0x68, 0x00, 0xe0, 0x8e, 0x26, 0x8c, 0x63, 0x6a, 0xfb, + 0x9e, 0x52, 0x73, 0x5f, 0xf0, 0xff, 0x6d, 0x56, 0xbe, 0x37, 0xf0, 0xf9, 0x70, 0xd2, 0xaf, 0xba, + 0x64, 0x7c, 0xbc, 0xc0, 0xf6, 0xfa, 0xcb, 0xf5, 0x71, 0xf8, 0x74, 0x70, 0x2c, 0xc3, 0x33, 0x99, + 0xf8, 0x5e, 0xf5, 0xfc, 0xdc, 0x68, 0xcc, 0x67, 0xe5, 0x6c, 0x3d, 0x02, 0x34, 0x1a, 0x66, 0x56, + 0x61, 0x1b, 0x1e, 0x7a, 0x1f, 0xd2, 0x01, 0xf1, 0xb0, 0xd0, 0x22, 0xec, 0x4d, 0xd5, 0x6e, 0xcc, + 0x67, 0xe5, 0x9d, 0x0e, 0xf1, 0xb0, 0xd1, 0x78, 0xb9, 0x58, 0x99, 0x3b, 0x82, 0xc9, 0xf0, 0xd0, + 0x77, 0x20, 0x23, 0x92, 0x43, 0xf2, 0x27, 0x24, 0xff, 0x3b, 0xf3, 0x59, 0x39, 0x1d, 0x59, 0x2e, + 0x04, 0xe2, 0xa5, 0x99, 0x66, 0xd1, 0x6d, 0x2a, 0xbf, 0xd7, 0x20, 0xdf, 0x0b, 0x47, 0x3e, 0xb7, + 0xa8, 0x3f, 0x18, 0x60, 0x8a, 0x9a, 0x90, 0x1d, 0xe1, 0x27, 0xdc, 0xf6, 0x30, 0x73, 0xe5, 0xd5, + 0x72, 0x77, 0x2b, 0x6b, 0x9c, 0x64, 0x3a, 0xc1, 0x00, 0x37, 0x30, 0x73, 0xa9, 0x1f, 0x72, 0x42, + 0x95, 0xbb, 0x32, 0x42, 0x54, 0x50, 0xd1, 0x87, 0x00, 0xd4, 0x1f, 0x0c, 0x15, 0xce, 0xf6, 0x35, + 0x71, 0xb2, 0x52, 0x56, 0x90, 0xa3, 0xe8, 0x7e, 0x94, 0xcc, 0x24, 0xf4, 0x64, 0xe5, 0x77, 0x1a, + 0xe4, 0xdb, 0x98, 0x0e, 0xf0, 0x57, 0xda, 0xd8, 0xca, 0x9f, 0xb6, 0xe1, 0xb0, 0x3e, 0x14, 0xbc, + 0x26, 0x0e, 0x47, 0xbe, 0xeb, 0xb0, 0xa5, 0xbd, 0x39, 0x57, 0x1e, 0xd8, 0x7c, 0x1a, 0x62, 0x69, + 0xf1, 0xee, 0xdd, 0x6f, 0xae, 0xd3, 0x14, 0x09, 0x46, 0x28, 0xd6, 0x34, 0xc4, 0x26, 0xb8, 0x8b, + 0x35, 0x6a, 0x40, 0x9a, 0x46, 0x0c, 0xca, 0xd8, 0x37, 0x40, 0x5c, 0x31, 0x37, 0x16, 0x45, 0xe7, + 0xa0, 0x4f, 0x42, 0xcf, 0xe1, 0xd8, 0xb3, 0x15, 0x89, 0x15, 0x13, 0xb7, 0x12, 0xd7, 0x84, 0xdb, + 0x53, 0x18, 0xf1, 0x55, 0xd1, 0x07, 0xb0, 0x17, 0xe0, 0x4b, 0x1e, 0x63, 0x8a, 0x5c, 0x4c, 0xca, + 0x5c, 0x2c, 0xcd, 0x67, 0xe5, 0x42, 0x07, 0x5f, 0x72, 0xc5, 0x2a, 0x33, 0x32, 0xbb, 0xd8, 0x98, + 0x85, 0x60, 0xe5, 0xcc, 0x3b, 0xc9, 0x88, 0x6e, 0x22, 0xfd, 0xf9, 0xa9, 0x06, 0x07, 0x6d, 0xe2, + 0xf9, 0x4f, 0x7c, 0xec, 0x89, 0x2e, 0x15, 0x7b, 0xf3, 0xdb, 0x80, 0xd8, 0x94, 0x71, 0x3c, 0xb6, + 0x5d, 0x12, 0x3c, 0xf1, 0x07, 0x36, 0x0b, 0x9d, 0x40, 0x3a, 0x35, 0x63, 0xea, 0xd1, 0x49, 0x5d, + 0x1e, 0xc8, 0xd6, 0xd6, 0x04, 0x24, 0x6b, 0x69, 0xe4, 0x5f, 0xe0, 0x00, 0x33, 0x16, 0x71, 0x47, + 0xfe, 0xbb, 0xb9, 0xe6, 0xc2, 0x42, 0xc8, 0xd4, 0x85, 0x48, 0x4b, 0x49, 0x08, 0x8a, 0x0a, 0xf1, + 0xbf, 0xb7, 0xe1, 0xd0, 0x08, 0x38, 0xa6, 0x81, 0x33, 0xaa, 0x93, 0xf1, 0x78, 0x59, 0x3f, 0x0d, + 0x28, 0x30, 0x51, 0x4f, 0x36, 0x8f, 0x08, 0x2a, 0x2d, 0xcb, 0x6b, 0x35, 0x2c, 0xeb, 0xce, 0xcc, + 0xb3, 0xd5, 0x2a, 0x6c, 0x40, 0x61, 0x2c, 0x12, 0x7d, 0x81, 0xb2, 0xfd, 0x5a, 0x94, 0xd5, 0x82, + 0x30, 0xf3, 0xe3, 0xd5, 0xf2, 0xf8, 0x05, 0xdc, 0x54, 0xe9, 0x16, 0x07, 0x78, 0x81, 0x97, 0x90, + 0x78, 0xb7, 0xd7, 0xe0, 0xad, 0xcd, 0x5c, 0xf3, 0xd0, 0x5d, 0x9b, 0xd0, 0x8f, 0xe1, 0x70, 0xac, + 0x22, 0x23, 0xfd, 0xb9, 0xc0, 0x4f, 0x4a, 0xfc, 0x6f, 0xad, 0xb3, 0xf7, 0x6a, 0x24, 0xcd, 0x83, + 0xf1, 0x55, 0xe2, 0x49, 0xe6, 0x93, 0x78, 0x94, 0xfc, 0x5a, 0x83, 0xfd, 0x6e, 0x9f, 0x61, 0x7a, + 0x81, 0xbd, 0xc5, 0x20, 0x58, 0x6d, 0x8e, 0xda, 0x06, 0xcd, 0xf1, 0xff, 0x30, 0x69, 0x32, 0x8b, + 0xe1, 0xf6, 0xc5, 0x0e, 0xe4, 0x2c, 0xea, 0x04, 0xcc, 0x71, 0xb9, 0x4f, 0x02, 0x74, 0x1f, 0x92, + 0x62, 0x4c, 0xab, 0x60, 0xdf, 0x59, 0xc1, 0x55, 0xd3, 0xba, 0x1a, 0x8d, 0xe9, 0x6a, 0x3c, 0xad, + 0xab, 0xd6, 0x65, 0xd0, 0xc6, 0xdc, 0xa9, 0x65, 0x84, 0x92, 0xcf, 0x67, 0x65, 0xcd, 0x94, 0x08, + 0x08, 0x41, 0x32, 0x70, 0xc6, 0xd1, 0x7c, 0xca, 0x9a, 0x72, 0x8d, 0x7e, 0x04, 0x3b, 0x8c, 0x3b, + 0x7c, 0xc2, 0xa4, 0x5b, 0xd7, 0x77, 0x8c, 0x15, 0x6b, 0x7a, 0x92, 0xd7, 0x54, 0x32, 0xe8, 0x23, + 0xd8, 0x1d, 0x39, 0x8c, 0xdb, 0x43, 0xec, 0x50, 0xde, 0xc7, 0x0e, 0x2f, 0xa6, 0x36, 0xbf, 0x7d, + 0x41, 0x88, 0xde, 0x8f, 0x25, 0x05, 0x16, 0xa1, 0xfe, 0xc0, 0x5e, 0x7a, 0x72, 0xe7, 0x1a, 0x58, + 0x42, 0x74, 0x19, 0xbf, 0xfb, 0x50, 0x18, 0x3b, 0x97, 0x2b, 0x50, 0xe9, 0xcd, 0xa1, 0xf2, 0x63, + 0xe7, 0x72, 0x89, 0xf4, 0x31, 0x1c, 0x10, 0x95, 0x1e, 0x4b, 0x38, 0x56, 0xcc, 0xbc, 0xb6, 0x99, + 0x5d, 0x49, 0x26, 0x05, 0x8b, 0xc8, 0x97, 0x0f, 0x18, 0x2a, 0x42, 0xfa, 0x19, 0xf5, 0xb9, 0x1f, + 0x0c, 0x8a, 0x59, 0xd9, 0x5a, 0xe2, 0x2d, 0xfa, 0x01, 0xa4, 0xfd, 0x80, 0xe3, 0x80, 0xb3, 0x62, + 0x4e, 0xaa, 0x7a, 0x5d, 0x1b, 0x89, 0x3b, 0xaf, 0xe2, 0x46, 0x15, 0x28, 0x08, 0x0c, 0x6c, 0x73, + 0x42, 0x6c, 0x32, 0xf2, 0x8a, 0x79, 0x09, 0x9c, 0x93, 0x44, 0x8b, 0x90, 0xee, 0xc8, 0x13, 0x3c, + 0x14, 0x73, 0x3a, 0xb5, 0x49, 0x60, 0x87, 0x13, 0x36, 0x2c, 0x16, 0x22, 0x1e, 0x49, 0xec, 0x06, + 0x67, 0x13, 0x36, 0x44, 0xe7, 0x70, 0x03, 0x87, 0xc4, 0x1d, 0xda, 0xbf, 0xc2, 0x94, 0xac, 0x38, + 0x72, 0x77, 0x73, 0x47, 0x22, 0x09, 0xf0, 0x18, 0x53, 0xb2, 0x74, 0xa7, 0x05, 0x07, 0x14, 0x3f, + 0xa1, 0x98, 0x0d, 0x57, 0xfd, 0x59, 0xdc, 0xbb, 0x06, 0xea, 0x42, 0x7e, 0x89, 0xfa, 0x63, 0x78, + 0xf7, 0xd5, 0xd4, 0xb1, 0x9f, 0x39, 0xcc, 0x8e, 0x1d, 0x5e, 0xd4, 0xe5, 0xf5, 0x8a, 0xaf, 0xa4, + 0xc8, 0x23, 0x87, 0xc5, 0x91, 0xfa, 0xd2, 0xe3, 0xf2, 0x8f, 0x1a, 0xec, 0x18, 0xd2, 0x9b, 0xe8, + 0x7b, 0x90, 0x5c, 0xf4, 0xfd, 0x37, 0x84, 0x60, 0xa5, 0xce, 0x04, 0x3b, 0xaa, 0x41, 0x82, 0x5f, + 0xc6, 0xfd, 0xff, 0x3a, 0x05, 0x1b, 0xdd, 0x50, 0x08, 0xaf, 0xd4, 0x65, 0xe2, 0xfa, 0x75, 0xa9, + 0x26, 0xc9, 0x17, 0x09, 0x48, 0xb5, 0xb0, 0xc3, 0x30, 0xfa, 0x21, 0xa4, 0x18, 0x77, 0x28, 0x57, + 0x37, 0xd9, 0xc8, 0xd1, 0x91, 0x04, 0xfa, 0x39, 0x00, 0xbe, 0x0c, 0x7d, 0xea, 0x08, 0x35, 0x9b, + 0x35, 0xb7, 0xd2, 0x7f, 0x66, 0xe5, 0xa3, 0x95, 0x07, 0xea, 0x49, 0x85, 0x3a, 0x81, 0x17, 0x4c, + 0x46, 0x23, 0xa7, 0x3f, 0xc2, 0x15, 0x73, 0x05, 0x70, 0xf5, 0xbd, 0x91, 0xf8, 0xdf, 0xdf, 0x1b, + 0x13, 0xb8, 0xe9, 0xe1, 0x90, 0x62, 0x57, 0x3e, 0x39, 0xa4, 0xe1, 0xe2, 0x2f, 0xf3, 0x99, 0x9a, + 0x16, 0x6f, 0x69, 0xf1, 0xe1, 0x12, 0xbd, 0x27, 0xc0, 0x7b, 0x12, 0x1b, 0x75, 0x20, 0x17, 0x52, + 0x12, 0x12, 0x26, 0x92, 0x99, 0x6d, 0xd6, 0xfb, 0x76, 0xe7, 0xb3, 0x32, 0x9c, 0x29, 0x29, 0xab, + 0x67, 0x42, 0x8c, 0x60, 0x31, 0x74, 0x03, 0x52, 0xb2, 0x66, 0x64, 0xe7, 0x4b, 0x98, 0xd1, 0x06, + 0xbd, 0x0f, 0x19, 0x86, 0x7f, 0x39, 0xc1, 0x81, 0x8b, 0x65, 0x1f, 0x4b, 0xd4, 0xf6, 0x5f, 0xce, + 0xca, 0x05, 0x19, 0xd9, 0x9e, 0x3a, 0x30, 0x17, 0x2c, 0xd1, 0xe3, 0xe6, 0x33, 0xf5, 0xb8, 0xd9, + 0x3d, 0xed, 0x13, 0xca, 0x45, 0x96, 0x36, 0x03, 0x4e, 0xa7, 0x6f, 0xfa, 0x7c, 0x79, 0xfb, 0x21, + 0x86, 0x8e, 0x20, 0x13, 0x52, 0x9f, 0x50, 0x9f, 0x47, 0xdf, 0x79, 0x29, 0x73, 0xb1, 0x3f, 0x49, + 0x4a, 0x93, 0xfe, 0xbc, 0x0d, 0x79, 0xeb, 0x32, 0xa8, 0x13, 0x42, 0x3d, 0x91, 0xf2, 0xe8, 0xfb, + 0x51, 0xad, 0x44, 0x79, 0x59, 0x7a, 0x73, 0x92, 0xaf, 0xd6, 0xc7, 0x4a, 0x83, 0xdc, 0xbe, 0x56, + 0x83, 0x7c, 0x0f, 0x0a, 0x2e, 0x19, 0x8f, 0x9d, 0xc0, 0xb3, 0x5d, 0x32, 0x09, 0xb8, 0x32, 0x34, + 0xaf, 0x88, 0x75, 0x41, 0x43, 0x35, 0xd1, 0x21, 0x65, 0x9b, 0xb1, 0x29, 0x76, 0x3c, 0x91, 0x45, + 0x1b, 0xe8, 0xc8, 0x2b, 0x19, 0x53, 0x88, 0xa0, 0x06, 0xec, 0xc6, 0x18, 0xb2, 0xf9, 0x8a, 0xfc, + 0xd8, 0x00, 0x24, 0x56, 0xfc, 0x48, 0xca, 0x08, 0x73, 0x63, 0x94, 0x0b, 0x67, 0xe4, 0x7b, 0x32, + 0x35, 0x32, 0x0b, 0x55, 0x0f, 0x05, 0xed, 0xce, 0x1f, 0x34, 0xc8, 0xca, 0x4f, 0x4b, 0xf9, 0x84, + 0xcf, 0x41, 0xfa, 0xbc, 0xf3, 0xa0, 0xd3, 0x7d, 0xd4, 0xd1, 0xb7, 0x50, 0x06, 0x92, 0x9d, 0xf3, + 0x56, 0x4b, 0x4f, 0xa3, 0x34, 0x24, 0x8c, 0x8e, 0xa5, 0x6b, 0x28, 0x0b, 0xa9, 0x0f, 0x5a, 0xdd, + 0x53, 0x4b, 0xdf, 0x16, 0xcb, 0xda, 0xcf, 0xac, 0x66, 0x4f, 0x4f, 0xa0, 0x03, 0xd8, 0x6b, 0x34, + 0x5b, 0x46, 0xdb, 0xb0, 0x9a, 0x0d, 0x3b, 0x22, 0x66, 0x84, 0xb4, 0x65, 0xb4, 0x9b, 0x7a, 0x52, + 0x80, 0x36, 0x9a, 0x75, 0xa3, 0x7d, 0xda, 0xd2, 0x53, 0xe8, 0x10, 0xf6, 0x97, 0xbc, 0x31, 0x39, + 0x8b, 0xf2, 0x90, 0x69, 0x9c, 0x9b, 0xa7, 0x96, 0xd1, 0xed, 0xe8, 0x3b, 0x02, 0xdb, 0x3a, 0x3f, + 0x6b, 0x35, 0x75, 0x40, 0xbb, 0x00, 0x02, 0xa6, 0xd7, 0x34, 0x8d, 0x66, 0x4f, 0xf7, 0xee, 0xfc, + 0x04, 0xf6, 0xaf, 0x7c, 0x85, 0xa0, 0x3d, 0xc8, 0x9d, 0x36, 0x1a, 0xb6, 0xd9, 0x3c, 0x6b, 0x19, + 0xf5, 0x53, 0x7d, 0x0b, 0x21, 0xd8, 0x35, 0x9b, 0xed, 0xee, 0xc3, 0xe6, 0x82, 0xa6, 0x1d, 0x25, + 0x3f, 0xf9, 0x6d, 0x69, 0xeb, 0x4e, 0x0d, 0xf6, 0xaf, 0xf4, 0x3e, 0x61, 0xe1, 0x59, 0xb3, 0xd3, + 0x30, 0x3a, 0x1f, 0xea, 0x5b, 0xa8, 0x00, 0xd9, 0x7a, 0xb7, 0xdd, 0x36, 0x2c, 0xab, 0xd9, 0xd0, + 0x35, 0x71, 0x76, 0x5a, 0xeb, 0x9a, 0x62, 0xb3, 0x1d, 0x61, 0xd4, 0xbe, 0xf1, 0xe2, 0x1f, 0xa5, + 0xad, 0x17, 0xf3, 0x92, 0xf6, 0xf9, 0xbc, 0xa4, 0xfd, 0x75, 0x5e, 0xd2, 0xfe, 0x3e, 0x2f, 0x69, + 0x9f, 0xfe, 0xb3, 0xb4, 0xf5, 0x38, 0xad, 0xa2, 0xd2, 0xdf, 0x91, 0x3f, 0x60, 0xdc, 0xfb, 0x6f, + 0x00, 0x00, 0x00, 0xff, 0xff, 0x44, 0xfa, 0x94, 0x4a, 0x56, 0x11, 0x00, 0x00, } diff --git a/pkg/roachpb/data.proto b/pkg/roachpb/data.proto index ed8ca30c6e0e..b12b1eb67b65 100644 --- a/pkg/roachpb/data.proto +++ b/pkg/roachpb/data.proto @@ -355,6 +355,12 @@ message Transaction { // transaction is restarted and the epoch is bumped. It is used during // intent resolution to more efficiently scan for intents. util.hlc.Timestamp epoch_zero_timestamp = 14 [(gogoproto.nullable) = false]; + // This flag is set if the transaction's original timestamp was + // "leaked" beyond the transaction (i.e. if returned via NOW() or + // transaction_timestamp()). If true, this prevents optimizations + // which commit at a higher timestamp without resorting to a + // client-side retry. + bool orig_timestamp_was_observed = 16; } // A Intent is a Span together with a Transaction metadata and its status. diff --git a/pkg/roachpb/data_test.go b/pkg/roachpb/data_test.go index d1da06336814..6656cdd4317e 100644 --- a/pkg/roachpb/data_test.go +++ b/pkg/roachpb/data_test.go @@ -419,18 +419,19 @@ var nonZeroTxn = Transaction{ Sequence: 123, BatchIndex: 1, }, - Name: "name", - Status: COMMITTED, - LastHeartbeat: makeTS(1, 2), - OrigTimestamp: makeTS(30, 31), - RefreshedTimestamp: makeTS(20, 22), - MaxTimestamp: makeTS(40, 41), - ObservedTimestamps: []ObservedTimestamp{{NodeID: 1, Timestamp: makeTS(1, 2)}}, - Writing: true, - WriteTooOld: true, - RetryOnPush: true, - Intents: []Span{{Key: []byte("a"), EndKey: []byte("b")}}, - EpochZeroTimestamp: makeTS(1, 1), + Name: "name", + Status: COMMITTED, + LastHeartbeat: makeTS(1, 2), + OrigTimestamp: makeTS(30, 31), + RefreshedTimestamp: makeTS(20, 22), + MaxTimestamp: makeTS(40, 41), + ObservedTimestamps: []ObservedTimestamp{{NodeID: 1, Timestamp: makeTS(1, 2)}}, + Writing: true, + WriteTooOld: true, + RetryOnPush: true, + Intents: []Span{{Key: []byte("a"), EndKey: []byte("b")}}, + EpochZeroTimestamp: makeTS(1, 1), + OrigTimestampWasObserved: true, } func TestTransactionUpdate(t *testing.T) { diff --git a/pkg/storage/replica.go b/pkg/storage/replica.go index c0a6333b0d2d..d9458bb8c558 100644 --- a/pkg/storage/replica.go +++ b/pkg/storage/replica.go @@ -5283,15 +5283,8 @@ func isOnePhaseCommit(ba roachpb.BatchRequest, knobs *StoreTestingKnobs) bool { if isEndTransactionExceedingDeadline(ba.Header.Timestamp, *etArg) { return false } - if retry, reason := isEndTransactionTriggeringRetryError(ba.Txn); retry { - // We can still attempt the one phase commit on serializable - // retries (caused by our timestamp getting pushed forward due to - // the timestamp cache) if the end transaction request specifies - // there are no refresh spans. - canIgnoreSerializableRetry := ba.Txn.IsSerializable() && etArg.NoRefreshSpans - if reason != roachpb.RETRY_SERIALIZABLE || !canIgnoreSerializableRetry { - return false - } + if retry, _ := isEndTransactionTriggeringRetryError(ba.Txn, *etArg); retry { + return false } return !knobs.DisableOptional1PC || etArg.Require1PC } @@ -5569,6 +5562,14 @@ func evaluateBatch( if ba.Txn != nil { // If transactional, send out the final transaction entry with the reply. br.Txn = ba.Txn + // If a serializable transaction committed, forward the response + // timestamp to the commit timestamp in case we were able to + // optimize and commit at a higher timestamp without higher-level + // retry (i.e. there were no refresh spans and the commit timestamp + // wasn't leaked). + if ba.Txn.IsSerializable() && ba.Txn.Status == roachpb.COMMITTED { + br.Timestamp.Forward(ba.Txn.Timestamp) + } } // Always update the batch response timestamp field to the timestamp at // which the batch executed. diff --git a/pkg/storage/replica_command.go b/pkg/storage/replica_command.go index ab8d1aed1932..bea905498448 100644 --- a/pkg/storage/replica_command.go +++ b/pkg/storage/replica_command.go @@ -343,7 +343,7 @@ func evalEndTransaction( // Set transaction status to COMMITTED or ABORTED as per the // args.Commit parameter. if args.Commit { - if retry, reason := isEndTransactionTriggeringRetryError(reply.Txn); retry { + if retry, reason := isEndTransactionTriggeringRetryError(reply.Txn, *args); retry { return result.Result{}, roachpb.NewTransactionRetryError(reason) } @@ -422,31 +422,46 @@ func isEndTransactionExceedingDeadline(t hlc.Timestamp, args roachpb.EndTransact // EndTransactionRequest cannot be committed and needs to return a // TransactionRetryError. func isEndTransactionTriggeringRetryError( - txn *roachpb.Transaction, -) (bool, roachpb.TransactionRetryReason) { + txn *roachpb.Transaction, args roachpb.EndTransactionRequest, +) (retry bool, reason roachpb.TransactionRetryReason) { // If we saw any WriteTooOldErrors, we must restart to avoid lost // update anomalies. if txn.WriteTooOld { - return true, roachpb.RETRY_WRITE_TOO_OLD + retry, reason = true, roachpb.RETRY_WRITE_TOO_OLD + } else { + origTimestamp := txn.OrigTimestamp + origTimestamp.Forward(txn.RefreshedTimestamp) + isTxnPushed := txn.Timestamp != origTimestamp + + // If the isolation level is SERIALIZABLE, return a transaction + // retry error if the commit timestamp isn't equal to the txn + // timestamp. + if isTxnPushed { + if txn.Isolation == enginepb.SERIALIZABLE { + retry, reason = true, roachpb.RETRY_SERIALIZABLE + } else if txn.RetryOnPush { + // If pushing requires a retry and the transaction was pushed, retry. + retry, reason = true, roachpb.RETRY_DELETE_RANGE + } + } } - origTimestamp := txn.OrigTimestamp - origTimestamp.Forward(txn.RefreshedTimestamp) - isTxnPushed := txn.Timestamp != origTimestamp - - // If the isolation level is SERIALIZABLE, return a transaction - // retry error if the commit timestamp isn't equal to the txn - // timestamp. - if txn.Isolation == enginepb.SERIALIZABLE && isTxnPushed { - return true, roachpb.RETRY_SERIALIZABLE + // A serializable transaction can still avoid a retry under certain conditions. + if retry && txn.IsSerializable() && canForwardSerializableTimestamp(txn, args.NoRefreshSpans) { + retry, reason = false, 0 } - // If pushing requires a retry and the transaction was pushed, retry. - if txn.RetryOnPush && isTxnPushed { - return true, roachpb.RETRY_DELETE_RANGE - } + return retry, reason +} - return false, 0 +// canForwardSerializableTimestamp returns whether a serializable txn can +// be safely committed with a forwarded timestamp. This requires that +// the transaction's timestamp has not leaked and that the transaction +// has encountered no spans which require refreshing at the forwarded +// timestamp. If either of those conditions are true, a cient-side +// retry is required. +func canForwardSerializableTimestamp(txn *roachpb.Transaction, noRefreshSpans bool) bool { + return !txn.OrigTimestampWasObserved && noRefreshSpans } // resolveLocalIntents synchronously resolves any intents that are diff --git a/pkg/storage/replica_test.go b/pkg/storage/replica_test.go index a353f2b200a0..44f2fe7759e7 100644 --- a/pkg/storage/replica_test.go +++ b/pkg/storage/replica_test.go @@ -9086,6 +9086,12 @@ func TestReplicaLocalRetries(t *testing.T) { } return br.Timestamp, nil } + get := func(key string) (hlc.Timestamp, error) { + var ba roachpb.BatchRequest + get := getArgs(roachpb.Key(key)) + ba.Add(&get) + return send(ba) + } put := func(key, val string) (hlc.Timestamp, error) { var ba roachpb.BatchRequest put := putArgs(roachpb.Key(key), []byte(val)) @@ -9238,6 +9244,64 @@ func TestReplicaLocalRetries(t *testing.T) { }, expTSCUpdateKeys: []string{"g1", "g2", "g3"}, }, + // Serializable transaction will commit with forwarded timestamp if no refresh spans. + { + name: "serializable commit with forwarded timestamp", + setupFn: func() (hlc.Timestamp, error) { + if _, err := put("h", "put"); err != nil { + return hlc.Timestamp{}, err + } + return get("h") + }, + batchFn: func(ts hlc.Timestamp) (ba roachpb.BatchRequest, expTS hlc.Timestamp) { + txn := newTxn("h", ts.Prev()) + // Send begin transaction first. + ba.Txn = txn + bt, _ := beginTxnArgs(ba.Txn.Key, ba.Txn) + ba.Add(&bt) + if _, err := send(ba); err != nil { + panic(err) + } + // Send the remainder of the transaction in another batch. + expTS = ts.Next() + ba = roachpb.BatchRequest{} + ba.Txn = txn + cput := cPutArgs(ba.Txn.Key, []byte("cput"), []byte("put")) + ba.Add(&cput) + et, _ := endTxnArgs(ba.Txn, true /* commit */) + et.NoRefreshSpans = true // necessary to indicate local retry is possible + ba.Add(&et) + return + }, + expTSCUpdateKeys: []string{"h"}, + }, + // Serializable transaction will commit with WriteTooOld flag if no refresh spans. + { + name: "serializable commit with write-too-old flag", + setupFn: func() (hlc.Timestamp, error) { + return put("i", "put") + }, + batchFn: func(ts hlc.Timestamp) (ba roachpb.BatchRequest, expTS hlc.Timestamp) { + txn := newTxn("i", ts.Prev()) + // Send begin transaction first. + ba.Txn = txn + bt, _ := beginTxnArgs(ba.Txn.Key, ba.Txn) + ba.Add(&bt) + if _, err := send(ba); err != nil { + panic(err) + } + // Send the remainder of the transaction in another batch. + expTS = ts.Next() + ba = roachpb.BatchRequest{} + ba.Txn = txn + put := putArgs(ba.Txn.Key, []byte("newput")) + ba.Add(&put) + et, _ := endTxnArgs(ba.Txn, true /* commit */) + et.NoRefreshSpans = true // necessary to indicate local retry is possible + ba.Add(&et) + return + }, + }, } for _, test := range testCases {