diff --git a/pkg/kv/kvclient/kvcoord/dist_sender_test.go b/pkg/kv/kvclient/kvcoord/dist_sender_test.go index d21ff6c34857..3cfc86396a2b 100644 --- a/pkg/kv/kvclient/kvcoord/dist_sender_test.go +++ b/pkg/kv/kvclient/kvcoord/dist_sender_test.go @@ -3559,12 +3559,11 @@ func TestErrorIndexAlignment(t *testing.T) { var testFn simpleSendFn = func(ctx context.Context, ba roachpb.BatchRequest) (*roachpb.BatchResponse, error) { reply := ba.CreateReply() if nthRequest == tc.nthPartialBatch { - reply.Error = &roachpb.Error{ - // The relative index is always 0 since - // we return an error for the first - // request of the nthPartialBatch. - Index: &roachpb.ErrPosition{Index: 0}, - } + reply.Error = roachpb.NewError(errors.Errorf("injected error on batch #%d", nthRequest)) + // The relative index is always 0 since + // we return an error for the first + // request of the nthPartialBatch. + reply.Error.SetErrorIndex(0) } nthRequest++ return reply, nil diff --git a/pkg/roachpb/errors.go b/pkg/roachpb/errors.go index 4f86b03632da..6d4b28a4ba2a 100644 --- a/pkg/roachpb/errors.go +++ b/pkg/roachpb/errors.go @@ -21,7 +21,6 @@ import ( "github.com/cockroachdb/cockroach/pkg/util/protoutil" "github.com/cockroachdb/cockroach/pkg/util/uuid" "github.com/cockroachdb/errors" - "github.com/cockroachdb/errors/errorspb" _ "github.com/cockroachdb/errors/extgrpc" // register EncodeError support for gRPC Status "github.com/cockroachdb/redact" ) @@ -149,30 +148,12 @@ func NewError(err error) *Error { if err == nil { return nil } - e := &Error{ - EncodedError: errors.EncodeError(context.Background(), err), + if intErr, ok := err.(*internalError); ok { + return (*Error)(intErr) } - - // This block is deprecated behavior retained for compat with - // 20.2 nodes. It makes sure that if applicable, deprecatedMessage, - // ErrorDetail, and deprecatedTransactionRestart are set. - { - if intErr, ok := err.(*internalError); ok { - *e = *(*Error)(intErr) - } else if detail := ErrorDetailInterface(nil); errors.As(err, &detail) { - e.deprecatedMessage = detail.message(e) - if r, ok := detail.(transactionRestartError); ok { - e.deprecatedTransactionRestart = r.canRestartTransaction() - } else { - e.deprecatedTransactionRestart = TransactionRestart_NONE - } - e.deprecatedDetail.MustSetInner(detail) - e.checkTxnStatusValid() - } else { - e.deprecatedMessage = err.Error() - } + return &Error{ + EncodedError: errors.EncodeError(context.Background(), err), } - return e } // NewErrorWithTxn creates an Error from the given error and a transaction. @@ -194,6 +175,14 @@ func NewErrorf(format string, a ...interface{}) *Error { return NewError(err) } +func (e *Error) decode() error { + if e.EncodedError.Error == nil { + // DecodeError would crash on this EncodedError, so terminate it here. + return errors.AssertionFailedf("Error with nil EncodedError") + } + return errors.DecodeError(context.Background(), e.EncodedError) +} + // SafeFormat implements redact.SafeFormatter. func (e *Error) SafeFormat(s redact.SafePrinter, _ rune) { if e == nil { @@ -201,42 +190,28 @@ func (e *Error) SafeFormat(s redact.SafePrinter, _ rune) { return } - if e.EncodedError != (errors.EncodedError{}) { - err := errors.DecodeError(context.Background(), e.EncodedError) - var iface ErrorDetailInterface - if errors.As(err, &iface) { - // Deprecated code: if there is a detail and the message produced by the detail - // (which gets to see the surrounding Error) is different, then use that message. - // What is likely the cause of that is that someone passed an updated Transaction - // to the Error via SetTxn, and the error detail prints that txn. - // - // TODO(tbg): change SetTxn so that instead of stashing the transaction on the - // Error struct, it wraps the EncodedError with an error containing the updated - // txn. Make GetTxn retrieve the first one it sees (overridden by UnexposedTxn - // while it's still around). Remove the `message(Error)` methods from ErrorDetailInterface. - // We also have to remove GetDetail() in the process since it doesn't understand the - // wrapping; instead we need a method that looks for a specific kind of detail, i.e. - // we basically want to use `errors.As` instead. - deprecatedMsg := iface.message(e) - if deprecatedMsg != err.Error() { - s.Print(deprecatedMsg) - return - } - } - s.Print(err) - } else { - // TODO(tbg): remove this block in the 21.2 cycle and rely on EncodedError - // always being populated. - switch t := e.GetDetail().(type) { - case nil: - s.Print(e.deprecatedMessage) - default: - // We have a detail and ignore e.deprecatedMessage. We do assume that if a detail is - // present, e.deprecatedMessage does correspond to that detail's message. This - // assumption is not enforced but appears sane. - s.Print(t) + err := e.decode() + var iface ErrorDetailInterface + if errors.As(err, &iface) { + // Deprecated code: if there is a detail and the message produced by the detail + // (which gets to see the surrounding Error) is different, then use that message. + // What is likely the cause of that is that someone passed an updated Transaction + // to the Error via SetTxn, and the error detail prints that txn. + // + // TODO(tbg): change SetTxn so that instead of stashing the transaction on the + // Error struct, it wraps the EncodedError with an error containing the updated + // txn. Make GetTxn retrieve the first one it sees (overridden by UnexposedTxn + // while it's still around). Remove the `message(Error)` methods from ErrorDetailInterface. + // We also have to remove GetDetail() in the process since it doesn't understand the + // wrapping; instead we need a method that looks for a specific kind of detail, i.e. + // we basically want to use `errors.As` instead. + deprecatedMsg := iface.message(e) + if deprecatedMsg != err.Error() { + s.Print(deprecatedMsg) + return } } + s.Print(err) if txn := e.GetTxn(); txn != nil { s.SafeString(": ") @@ -251,14 +226,8 @@ func (e *Error) String() string { // TransactionRestart returns the TransactionRestart for this Error. func (e *Error) TransactionRestart() TransactionRestart { - if e.EncodedError == (errorspb.EncodedError{}) { - // Legacy code. - // - // TODO(tbg): delete in 21.2. - return e.deprecatedTransactionRestart - } var iface transactionRestartError - if errors.As(errors.DecodeError(context.Background(), e.EncodedError), &iface) { + if errors.As(e.decode(), &iface) { return iface.canRestartTransaction() } return TransactionRestart_NONE @@ -334,39 +303,28 @@ const ( NumErrors int = 43 ) -// GoError returns a Go error converted from Error. If the error is a transaction -// retry error, it returns the error itself wrapped in an UnhandledRetryableError. -// Otherwise, if an error detail is present, is is returned (i.e. the result will -// match GetDetail()). Otherwise, returns the error itself masqueraded as an `error`. +// GoError returns a Go error wrapped in this Error. If the error is a +// transaction retry error, it returns the error itself wrapped in an +// UnhandledRetryableError. +// +// Note that this is a lossy conversion: the UnexposedTxn, OriginNode, Index, +// and Now fields will be lost during roachpb.NewError(pErr.GoError()). func (e *Error) GoError() error { if e == nil { return nil } - if e.EncodedError != (errorspb.EncodedError{}) { - err := errors.DecodeError(context.Background(), e.EncodedError) - var iface transactionRestartError - if errors.As(err, &iface) { - if txnRestart := iface.canRestartTransaction(); txnRestart != TransactionRestart_NONE { - // TODO(tbg): revisit this unintuitive error wrapping here and see if - // a better solution can be found. - return &UnhandledRetryableError{ - PErr: *e, - } + err := e.decode() + var iface transactionRestartError + if errors.As(err, &iface) { + if txnRestart := iface.canRestartTransaction(); txnRestart != TransactionRestart_NONE { + // TODO(tbg): revisit this unintuitive error wrapping here and see if + // a better solution can be found. + return &UnhandledRetryableError{ + PErr: *e, } } - return err - } - - // Everything below is legacy behavior that can be deleted in 21.2. - if e.TransactionRestart() != TransactionRestart_NONE { - return &UnhandledRetryableError{ - PErr: *e, - } - } - if detail := e.GetDetail(); detail != nil { - return detail } - return (*internalError)(e) + return err } // GetDetail returns an error detail associated with the error, or nil otherwise. @@ -375,14 +333,7 @@ func (e *Error) GetDetail() ErrorDetailInterface { return nil } var detail ErrorDetailInterface - if e.EncodedError != (errorspb.EncodedError{}) { - errors.As(errors.DecodeError(context.Background(), e.EncodedError), &detail) - } else { - // Legacy behavior. - // - // TODO(tbg): delete in v21.2. - detail, _ = e.deprecatedDetail.GetInner().(ErrorDetailInterface) - } + errors.As(e.decode(), &detail) return detail } @@ -404,35 +355,6 @@ func (e *Error) UpdateTxn(o *Transaction) { } else { e.UnexposedTxn.Update(o) } - if sErr, ok := e.deprecatedDetail.GetInner().(ErrorDetailInterface); ok { - // Refresh the message as the txn is updated. - // - // TODO(tbg): deprecated, remove in 21.2. - e.deprecatedMessage = sErr.message(e) - } - e.checkTxnStatusValid() -} - -// checkTxnStatusValid verifies that the transaction status is in-sync with the -// error detail. -func (e *Error) checkTxnStatusValid() { - // TODO(tbg): this will need to be updated when we - // remove all of these deprecated fields in 21.2. - - txn := e.UnexposedTxn - err := e.deprecatedDetail.GetInner() - if txn == nil { - return - } - if e.deprecatedTransactionRestart == TransactionRestart_NONE { - return - } - if errors.HasType(err, (*TransactionAbortedError)(nil)) { - return - } - if txn.Status.IsFinalized() { - log.Fatalf(context.TODO(), "transaction unexpectedly finalized in (%T): %v", err, e) - } } // GetTxn returns the txn. diff --git a/pkg/roachpb/errors.pb.go b/pkg/roachpb/errors.pb.go index 842d23cf449e..383f1b198397 100644 --- a/pkg/roachpb/errors.pb.go +++ b/pkg/roachpb/errors.pb.go @@ -2203,15 +2203,6 @@ var xxx_messageInfo_ErrPosition proto.InternalMessageInfo // Error is a generic representation including a string message // and information about retryability. type Error struct { - // message is a human-readable error message. - // - // DEPRECATED. - deprecatedMessage string `protobuf:"bytes,1,opt,name=message" json:"message"` - // If transaction_restart is not NONE, the error condition may be handled by - // restarting the transaction. - // - // DEPRECATED. - deprecatedTransactionRestart TransactionRestart `protobuf:"varint,3,opt,name=transaction_restart,json=transactionRestart,enum=cockroach.kv.kvpb.TransactionRestart" json:"transaction_restart"` // An optional updated transaction. This is to be used by the client in case // of retryable errors. // @@ -2219,11 +2210,6 @@ type Error struct { UnexposedTxn *Transaction `protobuf:"bytes,4,opt,name=unexposed_txn,json=unexposedTxn" json:"unexposed_txn,omitempty"` // Node at which the error was generated (zero if does not apply). OriginNode NodeID `protobuf:"varint,5,opt,name=origin_node,json=originNode,casttype=NodeID" json:"origin_node"` - // If an ErrorDetail is present, it may contain additional structured data - // about the error. - // - // DEPRECATED - consult encoded_error instead. - deprecatedDetail ErrorDetail `protobuf:"bytes,6,opt,name=detail" json:"detail"` // encoded_error is the Go error that caused this Error. EncodedError errorspb.EncodedError `protobuf:"bytes,9,opt,name=encoded_error,json=encodedError" json:"encoded_error"` // The index, if given, contains the index of the request (in the batch) @@ -2309,211 +2295,206 @@ func init() { func init() { proto.RegisterFile("roachpb/errors.proto", fileDescriptor_123941c6716fd549) } var fileDescriptor_123941c6716fd549 = []byte{ - // 3258 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0x9c, 0x59, 0xcd, 0x6f, 0xdb, 0xd8, - 0xb5, 0xd7, 0x97, 0x6d, 0xf9, 0xf8, 0x23, 0xf4, 0xf5, 0x17, 0xed, 0x24, 0xb2, 0xa3, 0x24, 0x33, - 0x49, 0x06, 0x23, 0x3f, 0x64, 0xde, 0xbc, 0xf7, 0x26, 0x2f, 0x6f, 0x21, 0x4b, 0xb4, 0x45, 0x59, - 0x5f, 0x43, 0xc9, 0x71, 0x32, 0xc1, 0xe0, 0x3e, 0x5a, 0xba, 0x96, 0xf9, 0x42, 0x91, 0x1a, 0x92, - 0x72, 0x6c, 0xe0, 0x2d, 0xda, 0xce, 0x66, 0xd0, 0x6e, 0xba, 0x29, 0xd0, 0x65, 0x81, 0x41, 0x17, - 0x05, 0x8a, 0xa2, 0x7f, 0x41, 0x57, 0x2d, 0x30, 0xab, 0x62, 0xd0, 0xd5, 0xa0, 0x8b, 0xb4, 0x4d, - 0xfa, 0x57, 0xcc, 0xaa, 0xb8, 0x1f, 0x94, 0x28, 0x89, 0x72, 0x9c, 0xd9, 0x91, 0xe7, 0xeb, 0x9e, - 0x7b, 0xee, 0xe1, 0x39, 0xbf, 0x73, 0x09, 0x2b, 0x8e, 0xad, 0x37, 0x4f, 0xbb, 0xc7, 0x3b, 0xc4, - 0x71, 0x6c, 0xc7, 0xcd, 0x74, 0x1d, 0xdb, 0xb3, 0xd1, 0x52, 0xd3, 0x6e, 0xbe, 0x60, 0x9c, 0xcc, - 0x8b, 0xb3, 0xcc, 0x8b, 0xb3, 0xee, 0xf1, 0xe6, 0x2a, 0x17, 0x18, 0x91, 0xdc, 0x44, 0xbe, 0x7e, - 0x4b, 0xf7, 0x74, 0x41, 0x5b, 0xf3, 0x69, 0x1d, 0xe2, 0xe9, 0x01, 0xba, 0xdc, 0xf3, 0x0c, 0x73, - 0xe7, 0xd4, 0x6c, 0xee, 0x78, 0x46, 0x87, 0xb8, 0x9e, 0xde, 0xe9, 0x0a, 0xce, 0x4a, 0xdb, 0x6e, - 0xdb, 0xec, 0x71, 0x87, 0x3e, 0x71, 0x6a, 0xfa, 0xf7, 0x31, 0x58, 0xae, 0xd8, 0x5e, 0x89, 0xe8, - 0x2e, 0x29, 0xd8, 0x66, 0x8b, 0x38, 0x0a, 0x5d, 0x1a, 0xe5, 0x61, 0xc6, 0x21, 0x5d, 0xd3, 0x68, - 0xea, 0x72, 0x74, 0x3b, 0x7a, 0x6f, 0xee, 0xe1, 0x9d, 0xcc, 0xc0, 0x5f, 0xb1, 0x76, 0x46, 0xe3, - 0x12, 0x79, 0xe2, 0x36, 0x1d, 0xa3, 0xeb, 0xd9, 0xce, 0x6e, 0xe2, 0x9b, 0x57, 0x5b, 0x11, 0xcd, - 0x57, 0x45, 0xfb, 0x30, 0x6f, 0x52, 0xcb, 0xf8, 0x94, 0x99, 0x96, 0x63, 0x57, 0x37, 0xa5, 0xcd, - 0x99, 0x03, 0x9f, 0x50, 0x06, 0xa6, 0xd8, 0xab, 0x9c, 0x60, 0x16, 0xe4, 0x10, 0x0b, 0x6c, 0x0b, - 0x1a, 0x17, 0x43, 0x1f, 0x43, 0xd2, 0xd1, 0xad, 0x36, 0xc1, 0x46, 0x4b, 0x8e, 0x6f, 0x47, 0xef, - 0xc5, 0x77, 0x37, 0xa9, 0x67, 0xaf, 0x5f, 0x6d, 0xcd, 0x68, 0x94, 0xae, 0xe6, 0xbf, 0x1f, 0x3c, - 0x6a, 0x33, 0x4c, 0x56, 0x6d, 0xa1, 0xdb, 0x00, 0xcd, 0x9e, 0xeb, 0xd9, 0x1d, 0xdc, 0x71, 0xdb, - 0xf2, 0xd4, 0x76, 0xf4, 0xde, 0xac, 0xd8, 0xd2, 0x2c, 0xa7, 0x97, 0xdd, 0x76, 0x7a, 0x0d, 0x56, - 0x2a, 0x76, 0x8b, 0x1c, 0x5a, 0xfa, 0x99, 0x6e, 0x98, 0xfa, 0xb1, 0x49, 0x58, 0xc8, 0xd2, 0x1b, - 0xb0, 0x7e, 0x68, 0xb9, 0xbd, 0x6e, 0xd7, 0x76, 0x3c, 0xd2, 0xd2, 0xc8, 0x17, 0x3d, 0xe2, 0x7a, - 0x9c, 0xf5, 0x93, 0x28, 0x20, 0xb6, 0x58, 0xc5, 0xf6, 0xf6, 0xec, 0x9e, 0xd5, 0xe2, 0x41, 0x0e, - 0x7a, 0x19, 0xbd, 0xba, 0x97, 0x1f, 0x43, 0xd2, 0xf5, 0x6c, 0x87, 0xa9, 0xc5, 0x86, 0xd5, 0xea, - 0x94, 0xce, 0xd5, 0xc4, 0xa3, 0x36, 0xc3, 0x64, 0xd5, 0x56, 0xfa, 0x4f, 0x51, 0x58, 0x65, 0xb6, - 0x0e, 0xc8, 0x45, 0xd9, 0x70, 0x3b, 0xba, 0xd7, 0x3c, 0xe5, 0x7e, 0x7c, 0x04, 0x4b, 0x0e, 0x77, - 0x17, 0xbb, 0x9e, 0xee, 0x78, 0xf8, 0x05, 0xb9, 0x60, 0x0e, 0xcd, 0xef, 0xce, 0x7c, 0xff, 0x6a, - 0x2b, 0x7e, 0x40, 0x2e, 0xb4, 0x6b, 0x42, 0xa2, 0x4e, 0x05, 0x0e, 0xc8, 0x05, 0xda, 0x01, 0x9f, - 0x84, 0x89, 0xd5, 0x62, 0x2a, 0xb1, 0x61, 0x95, 0x05, 0xc1, 0x57, 0xac, 0x16, 0x55, 0x78, 0x04, - 0xd3, 0x6c, 0x07, 0xae, 0x3c, 0xb5, 0x1d, 0xbf, 0x37, 0xf7, 0xf0, 0x46, 0x58, 0x1a, 0xb0, 0x2d, - 0x5a, 0x27, 0xb6, 0x08, 0xbb, 0xd0, 0x28, 0x26, 0x92, 0x71, 0x29, 0x51, 0x4c, 0x24, 0x13, 0xd2, - 0x54, 0xfa, 0x4d, 0x1c, 0xd2, 0x1a, 0xd1, 0x5b, 0x47, 0x86, 0x77, 0x6a, 0x58, 0x87, 0x56, 0x93, - 0x38, 0x9e, 0x6e, 0x58, 0xde, 0x85, 0x6a, 0x79, 0xc4, 0x39, 0xd3, 0x4d, 0xbe, 0xa9, 0x22, 0x2c, - 0x3a, 0x44, 0x6f, 0xe1, 0xfe, 0x77, 0x20, 0x12, 0xf9, 0x66, 0x60, 0x59, 0xfa, 0xb1, 0x64, 0x4e, - 0xcd, 0x66, 0xa6, 0xe1, 0x0b, 0x89, 0x75, 0x17, 0xa8, 0x6a, 0x9f, 0x88, 0x34, 0x40, 0xe4, 0xdc, - 0x70, 0x3d, 0xc3, 0x6a, 0x07, 0xec, 0xc5, 0xae, 0x6e, 0x6f, 0xc9, 0x57, 0x1f, 0xd8, 0x7c, 0x0e, - 0xeb, 0xa6, 0xdd, 0xd4, 0x4d, 0xdc, 0x1b, 0xec, 0x00, 0x9b, 0x46, 0xc7, 0xf0, 0x58, 0xe2, 0x5d, - 0xd1, 0xf0, 0x2a, 0xb3, 0x11, 0x08, 0x42, 0x89, 0x5a, 0x40, 0x9f, 0x83, 0xdc, 0x36, 0xed, 0xe3, - 0x50, 0xeb, 0xf1, 0xab, 0x5b, 0x5f, 0xe3, 0x46, 0xc6, 0xcc, 0x3f, 0x87, 0x65, 0xfb, 0xd8, 0x25, - 0xce, 0x19, 0x09, 0xc4, 0xd7, 0x95, 0x13, 0xec, 0x5c, 0xc3, 0x3e, 0xef, 0xaa, 0x90, 0x1e, 0x5d, - 0x00, 0xd9, 0xa3, 0x0c, 0xf7, 0x51, 0xe2, 0x97, 0xbf, 0xda, 0x8a, 0xa4, 0x5b, 0xb0, 0xde, 0x70, - 0x74, 0xcb, 0xd5, 0x9b, 0x9e, 0x61, 0x5b, 0xd9, 0x63, 0xf6, 0x51, 0xf1, 0x93, 0x55, 0x61, 0xda, - 0x21, 0xba, 0x6b, 0x5b, 0xec, 0x44, 0x17, 0x1f, 0x7e, 0x90, 0x19, 0x2b, 0xa5, 0x99, 0x71, 0x5d, - 0x8d, 0xa9, 0xf4, 0xf3, 0x8a, 0xbd, 0xa5, 0x9f, 0xc3, 0x4a, 0x40, 0xb2, 0xd6, 0x73, 0xc5, 0x17, - 0x91, 0x03, 0xe8, 0xf6, 0xdc, 0x53, 0x42, 0xb0, 0x77, 0x6e, 0x89, 0xc4, 0x49, 0x85, 0xec, 0x2b, - 0xa0, 0xec, 0x17, 0x0a, 0xae, 0xd7, 0x38, 0xb7, 0xd2, 0x5f, 0x46, 0x61, 0x35, 0x20, 0xa0, 0x11, - 0xcf, 0xb9, 0xe0, 0xe6, 0xf7, 0x47, 0x76, 0x70, 0xff, 0xf2, 0x1d, 0x30, 0xcd, 0x30, 0xff, 0xd1, - 0x2d, 0x98, 0x25, 0xe7, 0x9e, 0xa3, 0xb3, 0x7a, 0x15, 0x0b, 0xd4, 0xab, 0x24, 0x23, 0xd3, 0x72, - 0xf5, 0x87, 0x28, 0xac, 0x05, 0x6c, 0xd5, 0x3d, 0xdd, 0xeb, 0xb9, 0xdc, 0x8d, 0x35, 0x88, 0x53, - 0xbd, 0x68, 0x40, 0x8f, 0x12, 0x50, 0xa5, 0xef, 0x5e, 0x8c, 0xb9, 0xf7, 0x6f, 0x97, 0xbb, 0x17, - 0x30, 0x99, 0x09, 0x8d, 0xf2, 0x63, 0x98, 0xe6, 0x74, 0x84, 0x60, 0x51, 0x53, 0xb2, 0xf5, 0x6a, - 0x05, 0x1f, 0x56, 0x0e, 0x2a, 0xd5, 0xa3, 0x8a, 0x14, 0x41, 0x32, 0xac, 0x08, 0x5a, 0xe3, 0x69, - 0x05, 0xe7, 0xaa, 0xe5, 0xb2, 0xda, 0x68, 0x28, 0x79, 0x29, 0x96, 0x4e, 0x24, 0xa3, 0x52, 0x34, - 0xfd, 0xb7, 0x18, 0x48, 0x47, 0x8e, 0xe1, 0x11, 0xfa, 0x7d, 0x5b, 0xbc, 0xa2, 0xa2, 0x4f, 0x60, - 0xc6, 0x60, 0xaf, 0xae, 0x1c, 0x65, 0x59, 0xb7, 0x11, 0x72, 0x3a, 0x5c, 0xc1, 0x6f, 0x4a, 0x42, - 0x1e, 0x3d, 0x86, 0x45, 0xde, 0x94, 0x5c, 0x5a, 0x9e, 0xac, 0x26, 0x11, 0x1d, 0x62, 0x95, 0x8a, - 0x7d, 0xff, 0x6a, 0x6b, 0x81, 0x75, 0x92, 0xba, 0x60, 0x6a, 0x0b, 0x66, 0xf0, 0x15, 0x15, 0xfa, - 0xb1, 0x49, 0xb0, 0xd8, 0x3c, 0x08, 0x89, 0xcd, 0xa8, 0xb7, 0xe1, 0x51, 0xf9, 0x71, 0xb4, 0x1f, - 0x96, 0x35, 0x40, 0xfd, 0xb0, 0xd4, 0x6b, 0x4a, 0x4e, 0xdd, 0x53, 0x95, 0xbc, 0x14, 0x09, 0xd0, - 0x8f, 0xb2, 0x6a, 0x03, 0xd7, 0xaa, 0x25, 0x35, 0xf7, 0x4c, 0x8a, 0xa2, 0x75, 0x58, 0x16, 0xf4, - 0x52, 0x35, 0x77, 0x80, 0x1b, 0x6a, 0x59, 0xa9, 0x1e, 0x36, 0xa4, 0x18, 0xca, 0xc0, 0x83, 0x20, - 0x83, 0x69, 0x7d, 0x7a, 0xa8, 0x1c, 0x2a, 0xb8, 0x9c, 0x7d, 0x8a, 0x4b, 0x4a, 0x65, 0xbf, 0x51, - 0xc0, 0xca, 0xd3, 0x9c, 0xa2, 0xe4, 0x95, 0xbc, 0x14, 0x2f, 0x26, 0x92, 0x31, 0x29, 0x9e, 0xfe, - 0x75, 0x54, 0x44, 0xb8, 0x61, 0xdb, 0x55, 0x53, 0x7c, 0x65, 0x59, 0x98, 0xfd, 0x41, 0xa5, 0x73, - 0xa0, 0x85, 0x2a, 0x20, 0xe9, 0x4d, 0xaf, 0xa7, 0x9b, 0x3f, 0xac, 0x68, 0x5e, 0xe3, 0xca, 0x7d, - 0x72, 0x7a, 0x05, 0x50, 0xb5, 0x4b, 0x1b, 0xab, 0xe1, 0x10, 0xb7, 0x71, 0x6e, 0xf1, 0xe6, 0x5a, - 0x87, 0x95, 0x9c, 0x6d, 0xb5, 0x0c, 0x9a, 0x8a, 0x7b, 0xba, 0x61, 0xfa, 0x65, 0xe2, 0xbf, 0x61, - 0x5e, 0xac, 0x7e, 0xa6, 0x9b, 0x3d, 0x22, 0xf6, 0x10, 0x06, 0x1d, 0x9e, 0x50, 0xbe, 0x36, 0xc7, - 0xa5, 0xd9, 0x4b, 0xfa, 0x77, 0x51, 0x40, 0x1c, 0x51, 0x90, 0xff, 0x23, 0xcd, 0x7e, 0xe9, 0x49, - 0xc1, 0x4c, 0x87, 0xb8, 0xae, 0xde, 0x26, 0x43, 0x5f, 0x8d, 0x4f, 0x44, 0x8f, 0x61, 0x56, 0x34, - 0x3d, 0xd2, 0x12, 0x5b, 0x9d, 0x88, 0x55, 0xfc, 0x78, 0xf5, 0x15, 0xd0, 0x23, 0x48, 0xfa, 0x7d, - 0x42, 0x54, 0xe9, 0xb7, 0x29, 0xf7, 0xe5, 0xd3, 0x5f, 0xc0, 0x4a, 0xb6, 0x73, 0x6c, 0xb4, 0x7b, - 0x76, 0xcf, 0xd5, 0x88, 0xdb, 0x33, 0xbd, 0xab, 0x79, 0xfc, 0x09, 0xcc, 0xbd, 0x74, 0xf4, 0x6e, - 0x97, 0xb4, 0x30, 0x71, 0x9c, 0x10, 0x9f, 0xfd, 0xa4, 0x66, 0xe6, 0x34, 0x10, 0xc2, 0x8a, 0xe3, - 0xa4, 0xd7, 0x29, 0x9e, 0x38, 0xf1, 0xf6, 0x1d, 0xbb, 0xd7, 0xcd, 0x13, 0x93, 0xf8, 0x51, 0x4a, - 0x63, 0x58, 0x13, 0x78, 0x2e, 0x67, 0x3b, 0x4e, 0xaf, 0x4b, 0x4f, 0x86, 0x7b, 0x43, 0xeb, 0x15, - 0x7d, 0xc0, 0xa3, 0x75, 0x27, 0xc9, 0xc8, 0x65, 0xb7, 0x8d, 0xd2, 0x30, 0xdb, 0x75, 0xec, 0x26, - 0x71, 0x5d, 0x11, 0xc2, 0x64, 0xbf, 0xb2, 0xfa, 0xe4, 0x74, 0x1d, 0x90, 0x58, 0x20, 0x98, 0xb1, - 0xff, 0x03, 0x20, 0x80, 0xa7, 0x0f, 0xa8, 0xa6, 0x76, 0x53, 0x02, 0x19, 0xcd, 0x0a, 0x79, 0x86, - 0x8d, 0x06, 0x2f, 0x34, 0xfa, 0xfc, 0xb1, 0x95, 0x3e, 0x00, 0xc4, 0x30, 0xd3, 0x18, 0x46, 0xeb, - 0x83, 0xad, 0xe8, 0xd5, 0xc1, 0x56, 0x9d, 0x82, 0xc1, 0x53, 0xdd, 0x6a, 0x99, 0xb4, 0xf3, 0x78, - 0xce, 0x45, 0x1f, 0x27, 0xa2, 0x87, 0x90, 0xe8, 0x2a, 0x8e, 0x13, 0x92, 0x8f, 0x43, 0xa1, 0x16, - 0xbb, 0x66, 0xb2, 0xa2, 0x27, 0xfe, 0x33, 0x0a, 0x77, 0x47, 0xdb, 0x02, 0x45, 0x41, 0x35, 0x0a, - 0xe5, 0x35, 0x72, 0xe2, 0x10, 0xbf, 0x7f, 0x4d, 0xaa, 0xec, 0xcf, 0x61, 0xda, 0x3b, 0xb7, 0x7c, - 0xe0, 0x38, 0xbf, 0x9b, 0xa7, 0xac, 0xbf, 0xbe, 0xda, 0xfa, 0xa8, 0x6d, 0x78, 0xa7, 0xbd, 0xe3, - 0x4c, 0xd3, 0xee, 0xec, 0xf4, 0xfd, 0x69, 0x1d, 0x0f, 0x9e, 0x77, 0xba, 0x2f, 0xda, 0x3b, 0x6c, - 0xb6, 0xe8, 0xf5, 0x8c, 0x56, 0xe6, 0xf0, 0x50, 0xcd, 0xbf, 0x7e, 0xb5, 0x35, 0xd5, 0x38, 0xb7, - 0xd4, 0xbc, 0x36, 0xe5, 0x9d, 0x5b, 0x6a, 0x0b, 0xed, 0xc1, 0x9c, 0x37, 0xf0, 0x4e, 0x64, 0xf0, - 0xd5, 0xba, 0x66, 0x50, 0x31, 0xbd, 0x07, 0x5b, 0x8d, 0x73, 0x2b, 0x6b, 0x52, 0x0c, 0x76, 0xa1, - 0x58, 0x4d, 0xbb, 0x47, 0x81, 0x9d, 0x48, 0x2e, 0xbe, 0xbf, 0xdb, 0x00, 0x5d, 0x87, 0x9c, 0x61, - 0x96, 0x35, 0x43, 0xdb, 0x9c, 0xa5, 0x74, 0x9e, 0x86, 0x3f, 0x8b, 0xc2, 0x0a, 0xad, 0xc2, 0x6d, - 0xe2, 0x54, 0xcf, 0x88, 0x73, 0x62, 0xda, 0x2f, 0xb9, 0xf6, 0x06, 0xc4, 0x43, 0x10, 0x2e, 0xa5, - 0xa1, 0xfb, 0xb0, 0xd0, 0xec, 0x39, 0x0e, 0xb1, 0x3c, 0x51, 0x35, 0x38, 0xc0, 0xe6, 0xb6, 0xe7, - 0x05, 0x8b, 0x95, 0x08, 0xf4, 0x21, 0x5c, 0x33, 0xac, 0xa6, 0x43, 0x3a, 0x03, 0xe1, 0x78, 0x40, - 0x78, 0xb1, 0xcf, 0xe4, 0x15, 0xe5, 0xeb, 0x28, 0x5c, 0xdf, 0xa5, 0x98, 0x7b, 0x50, 0xe6, 0xc8, - 0x89, 0xed, 0x90, 0xfd, 0x5c, 0xbf, 0xde, 0x36, 0x7e, 0x50, 0xbd, 0x1d, 0x40, 0x4a, 0x6a, 0xe2, - 0x94, 0x26, 0x81, 0x6d, 0xb6, 0xde, 0xa5, 0xd0, 0x0e, 0xb4, 0xd2, 0x1d, 0x40, 0xbc, 0x71, 0x95, - 0x0d, 0xd7, 0x35, 0xac, 0x36, 0xf7, 0xed, 0x31, 0xcc, 0xbf, 0x74, 0x6c, 0xab, 0x8d, 0x79, 0x0f, - 0x15, 0xee, 0x4d, 0x6e, 0xb9, 0xda, 0x1c, 0x13, 0xe7, 0x2f, 0x7e, 0xb8, 0x63, 0xe3, 0xe1, 0xa6, - 0xb3, 0x54, 0x99, 0x38, 0x14, 0xf2, 0xd7, 0x1c, 0xbb, 0xed, 0x10, 0x97, 0xc3, 0x88, 0xf4, 0x6f, - 0x62, 0xb0, 0xcc, 0x66, 0x81, 0x3d, 0x22, 0xbe, 0x1f, 0xee, 0xc8, 0xc1, 0x08, 0x70, 0xfa, 0x30, - 0xe4, 0xeb, 0x09, 0xd1, 0x0b, 0x6f, 0xc0, 0x7f, 0x1c, 0x34, 0xe0, 0x4d, 0x58, 0x13, 0x7d, 0x53, - 0x53, 0x6a, 0x25, 0x35, 0x97, 0xc5, 0x9a, 0x52, 0xae, 0x3e, 0x19, 0x69, 0xc2, 0x5a, 0xb6, 0xb2, - 0xaf, 0xe0, 0x7a, 0xad, 0xa4, 0x36, 0x86, 0x9a, 0x30, 0xa7, 0x97, 0x15, 0x6d, 0x9f, 0xc2, 0x96, - 0x00, 0xa0, 0xd1, 0xb2, 0x7b, 0x0d, 0x5c, 0xaf, 0x64, 0x6b, 0xf5, 0x42, 0xb5, 0x21, 0xc5, 0x51, - 0x0a, 0x36, 0xfb, 0xed, 0x79, 0x5f, 0xcd, 0x65, 0x4b, 0xb8, 0x5a, 0xab, 0xe3, 0xb2, 0x5a, 0xaf, - 0xab, 0x95, 0x7d, 0x29, 0x11, 0xd0, 0xac, 0x97, 0xaa, 0x47, 0x38, 0x57, 0xad, 0xd4, 0x0f, 0xcb, - 0x8a, 0x26, 0x4d, 0xa1, 0x0d, 0x58, 0x15, 0x9c, 0x4a, 0x15, 0x97, 0x94, 0x6c, 0x5d, 0x29, 0x54, - 0x4b, 0x79, 0x45, 0x93, 0xa6, 0xd3, 0x3a, 0xc8, 0xaa, 0xd5, 0x22, 0x1e, 0x71, 0x3a, 0x86, 0xa5, - 0x7b, 0x24, 0x67, 0x77, 0x3a, 0x86, 0xa8, 0xfe, 0x0a, 0xcc, 0xb9, 0x9e, 0xde, 0x66, 0x73, 0xcb, - 0x3b, 0x02, 0x59, 0x10, 0x8a, 0x14, 0xc9, 0x2e, 0xc3, 0x92, 0x6a, 0x9d, 0xe9, 0xa6, 0xd1, 0x62, - 0xcd, 0x87, 0x9f, 0x51, 0x0a, 0x6e, 0x54, 0xbb, 0x9e, 0xd1, 0xa1, 0x0d, 0xa8, 0xa9, 0x9c, 0xe9, - 0x66, 0xce, 0xb6, 0x4e, 0x4c, 0xa3, 0xe9, 0x89, 0x33, 0xfc, 0x73, 0x14, 0x6e, 0x97, 0x0d, 0x6b, - 0x90, 0x6c, 0xb4, 0xa8, 0x1e, 0x5a, 0xae, 0xee, 0x19, 0xee, 0x89, 0x31, 0xa8, 0x87, 0x75, 0x58, - 0xee, 0x18, 0xd6, 0x00, 0x22, 0xe0, 0x63, 0x2a, 0xf8, 0x2e, 0x9f, 0xc0, 0x52, 0x67, 0x74, 0x19, - 0x3a, 0xb1, 0x39, 0xc4, 0xb5, 0xcd, 0xa1, 0x09, 0xe5, 0x9d, 0x26, 0x36, 0x5f, 0x7d, 0x00, 0x3f, - 0x7e, 0xb1, 0x0e, 0x73, 0xcc, 0xe5, 0x3c, 0xf1, 0x74, 0xc3, 0x44, 0x1a, 0x48, 0x96, 0xed, 0xe1, - 0xa1, 0x1b, 0x0e, 0xee, 0xf5, 0x7b, 0x21, 0x69, 0x19, 0x72, 0xcb, 0x52, 0x88, 0x68, 0x8b, 0xd6, - 0x10, 0x19, 0x55, 0xe1, 0x1a, 0xbf, 0x12, 0xa0, 0x96, 0x4f, 0x58, 0x20, 0xb8, 0xd3, 0x77, 0x27, - 0x65, 0xfa, 0x50, 0xbb, 0x2a, 0xd0, 0xd1, 0x35, 0x48, 0x45, 0x4f, 0x01, 0x71, 0x83, 0x2f, 0xc8, - 0x05, 0xee, 0x88, 0xb1, 0x5f, 0xd4, 0xe6, 0x7b, 0x93, 0x6c, 0x8e, 0xde, 0x10, 0x14, 0x22, 0x9a, - 0xe4, 0x8c, 0x30, 0xd0, 0x8f, 0xa2, 0xb0, 0xcd, 0x26, 0xec, 0x97, 0x6c, 0x10, 0x1f, 0x9a, 0x34, - 0x0d, 0x31, 0x8a, 0x8b, 0xfb, 0x9a, 0x8f, 0xc3, 0x16, 0x7a, 0xeb, 0x08, 0x5f, 0x88, 0x68, 0x37, - 0x9d, 0xcb, 0xa4, 0xd0, 0xe7, 0xb0, 0x1c, 0x68, 0x1c, 0x58, 0xe7, 0x93, 0x9e, 0x98, 0x9f, 0x1f, - 0x5c, 0x69, 0x2c, 0xf4, 0x57, 0x42, 0xde, 0x18, 0x0b, 0x35, 0x40, 0x0a, 0x9a, 0xa7, 0x93, 0x9d, - 0x3c, 0xcd, 0x6c, 0xbf, 0x7f, 0xb9, 0xed, 0xfe, 0x20, 0x59, 0x88, 0x68, 0xd7, 0xbc, 0x61, 0x3a, - 0x3a, 0x82, 0xa5, 0xa0, 0x55, 0x87, 0x56, 0x29, 0x79, 0x66, 0xe2, 0x81, 0x84, 0x4e, 0x90, 0xf4, - 0x40, 0xbc, 0x11, 0x06, 0xfa, 0x0c, 0x82, 0x9b, 0xc0, 0x2e, 0x1b, 0xcb, 0xe4, 0x24, 0xb3, 0x7c, - 0xff, 0xca, 0x23, 0x5c, 0x21, 0xa2, 0x05, 0xfd, 0xe3, 0x1c, 0x54, 0xa0, 0x1d, 0xc0, 0xf0, 0x88, - 0xdf, 0x01, 0x66, 0x99, 0xd5, 0xdb, 0x57, 0x18, 0x7e, 0x0a, 0x11, 0xda, 0x0d, 0xfa, 0x34, 0xa4, - 0xc2, 0x02, 0xb7, 0xe4, 0xd9, 0x36, 0xa6, 0x8d, 0x0a, 0x2e, 0x37, 0x15, 0x40, 0x78, 0x7d, 0x53, - 0x9c, 0x46, 0x3f, 0x16, 0xbb, 0x8b, 0x1d, 0x31, 0x10, 0xb0, 0x0a, 0x37, 0x37, 0xf1, 0x63, 0x19, - 0x9f, 0x1c, 0xe8, 0xc7, 0x62, 0x07, 0xa9, 0xf4, 0xc0, 0x9b, 0xfe, 0x28, 0x81, 0x4f, 0xd8, 0x2c, - 0x21, 0xcf, 0x4f, 0x3c, 0xf0, 0xb0, 0xa9, 0x83, 0x1e, 0x78, 0x73, 0x98, 0x8e, 0x2a, 0xfe, 0xc0, - 0xe9, 0x88, 0x59, 0x42, 0x5e, 0x98, 0xe8, 0xe5, 0xf8, 0xcc, 0x41, 0xbd, 0x34, 0x83, 0x54, 0xea, - 0xa5, 0x65, 0xb7, 0x08, 0xee, 0x0d, 0x6e, 0x20, 0xe5, 0xc5, 0x89, 0x5e, 0x86, 0xdd, 0x55, 0x52, - 0x2f, 0xad, 0x61, 0x3a, 0x2f, 0x14, 0x27, 0x1e, 0x6e, 0x53, 0x38, 0x8f, 0x5b, 0x1c, 0xcf, 0xcb, - 0xd2, 0x25, 0x85, 0x22, 0x04, 0xfa, 0xf3, 0x42, 0x31, 0xcc, 0xa0, 0x79, 0xe9, 0xe3, 0xf2, 0x66, - 0x7f, 0x1e, 0x90, 0x97, 0x26, 0xe6, 0x65, 0xf8, 0xec, 0x50, 0x60, 0x35, 0x79, 0x84, 0xc3, 0xea, - 0xa5, 0xb0, 0xed, 0xe7, 0x13, 0x9a, 0x5c, 0x2f, 0xc7, 0x66, 0x06, 0x56, 0x2f, 0x83, 0x54, 0x1a, - 0x5c, 0xdd, 0x9f, 0xa3, 0xb0, 0xc3, 0x06, 0x29, 0x79, 0x73, 0x62, 0x70, 0xc3, 0x46, 0x2e, 0x1a, - 0x5c, 0x7d, 0x98, 0x4e, 0xdd, 0xe4, 0x53, 0xc4, 0xa0, 0xac, 0x5f, 0x9f, 0xe8, 0xe6, 0xf8, 0x14, - 0x42, 0xdd, 0x74, 0x83, 0x54, 0xf4, 0xd3, 0x28, 0xdc, 0x19, 0xab, 0x22, 0xac, 0x12, 0x63, 0x76, - 0xb1, 0x8f, 0x1d, 0x3e, 0x0e, 0xc8, 0x37, 0xd8, 0x32, 0xff, 0x75, 0x85, 0xc2, 0x12, 0x3a, 0x49, - 0x14, 0x22, 0xda, 0xb6, 0xf7, 0x16, 0x41, 0x1a, 0x33, 0x83, 0xe3, 0x6c, 0x6c, 0x0b, 0xa0, 0x2d, - 0x6f, 0x4d, 0x8c, 0x59, 0x18, 0x24, 0xa7, 0x31, 0x33, 0x86, 0xe9, 0xb4, 0xb8, 0xf7, 0x06, 0xf7, - 0xe9, 0x58, 0x8c, 0xc9, 0xf2, 0xf6, 0xc4, 0xe2, 0x3e, 0xe1, 0xf6, 0x9d, 0x16, 0xf7, 0xde, 0x18, - 0x0b, 0x3d, 0x07, 0x29, 0x00, 0x39, 0x18, 0x14, 0x97, 0xd3, 0xcc, 0x76, 0x26, 0xc4, 0xf6, 0x25, - 0xc8, 0x9d, 0xd5, 0xf8, 0x61, 0x0e, 0x7a, 0x09, 0x37, 0xe9, 0x9c, 0xa5, 0xf3, 0x19, 0x06, 0x93, - 0xc1, 0x10, 0x23, 0x46, 0x96, 0xdb, 0x6c, 0xa5, 0x87, 0x61, 0xc7, 0x72, 0xf9, 0xe8, 0x53, 0x88, - 0x68, 0x9b, 0xde, 0x44, 0x11, 0x5a, 0x6b, 0x78, 0x85, 0xa6, 0xbd, 0x9e, 0x02, 0x78, 0xf9, 0xce, - 0xc4, 0x3c, 0x1b, 0x07, 0xfa, 0x34, 0xcf, 0x8c, 0x20, 0x15, 0x1d, 0xc2, 0x52, 0x87, 0x02, 0x74, - 0x6c, 0x58, 0x34, 0xb1, 0x18, 0x44, 0x97, 0xef, 0x4e, 0x3c, 0xdb, 0x30, 0x30, 0x4f, 0xe3, 0xd3, - 0x19, 0xa6, 0xa3, 0x4f, 0x05, 0xcc, 0x39, 0x21, 0xec, 0x64, 0x69, 0x07, 0x7c, 0x6f, 0x22, 0x72, - 0x0a, 0x01, 0xf4, 0x14, 0x39, 0xf5, 0x0d, 0xf0, 0xee, 0xf7, 0xbf, 0xb0, 0x62, 0x04, 0x61, 0x30, - 0x6e, 0x32, 0x1c, 0x2c, 0xbf, 0xcf, 0xec, 0x7e, 0x10, 0xba, 0xff, 0x70, 0xd4, 0x5c, 0x88, 0x68, - 0xcb, 0xc6, 0x38, 0x0f, 0x3d, 0x81, 0x65, 0x83, 0xa3, 0x60, 0x81, 0xf9, 0xf8, 0x51, 0xde, 0x1b, - 0xfb, 0xa9, 0x35, 0x58, 0x60, 0x04, 0x33, 0xd3, 0x1a, 0x66, 0x8c, 0x12, 0x51, 0x07, 0x36, 0xec, - 0x3e, 0x90, 0xc6, 0xe4, 0x4c, 0x37, 0x71, 0xd3, 0x87, 0xd2, 0xf2, 0x7d, 0x66, 0x7d, 0x27, 0xb4, - 0xa1, 0x4d, 0x06, 0xdf, 0x85, 0x88, 0xb6, 0x6e, 0x87, 0xf3, 0xd1, 0x97, 0x51, 0xb8, 0x15, 0x02, - 0xb8, 0x71, 0x2f, 0x08, 0xcd, 0xe5, 0x07, 0x6c, 0xdd, 0xff, 0x08, 0x3b, 0xe3, 0xb7, 0x63, 0xfa, - 0x42, 0x44, 0x4b, 0x75, 0x2e, 0x15, 0xdb, 0x9d, 0x81, 0x29, 0x36, 0x33, 0x17, 0x13, 0xc9, 0x6b, - 0x92, 0x54, 0x4c, 0x24, 0x97, 0xa5, 0x95, 0x62, 0x22, 0xb9, 0x22, 0xad, 0x16, 0x13, 0xc9, 0x55, - 0x69, 0xad, 0x98, 0x48, 0xae, 0x49, 0xeb, 0xc5, 0x44, 0x72, 0x5d, 0x92, 0x8b, 0x89, 0xa4, 0x2c, - 0x6d, 0x14, 0x13, 0xc9, 0x0d, 0x69, 0xb3, 0x98, 0x48, 0xde, 0x94, 0x52, 0xc5, 0x44, 0x32, 0x25, - 0x6d, 0x15, 0x13, 0xc9, 0x5b, 0x52, 0x3a, 0x7d, 0x9f, 0xc1, 0xf2, 0x9a, 0xed, 0xb2, 0xa6, 0x8b, - 0x36, 0x61, 0x8a, 0x9e, 0xde, 0xb9, 0xb8, 0x01, 0xe2, 0x70, 0x9e, 0x93, 0xd2, 0x5f, 0x4d, 0xc1, - 0x94, 0xff, 0xcf, 0x6b, 0xe4, 0x5e, 0x6c, 0x43, 0x5c, 0xeb, 0x2c, 0xb5, 0x48, 0xd7, 0x21, 0x4d, - 0xdd, 0x23, 0xad, 0x32, 0x17, 0x18, 0x5c, 0x96, 0xfd, 0xff, 0x30, 0xde, 0x74, 0x08, 0xfb, 0x5d, - 0xc6, 0xd0, 0xf4, 0x62, 0xe8, 0x27, 0x36, 0x54, 0x63, 0x99, 0xf0, 0xee, 0x1d, 0xb1, 0xce, 0x8d, - 0xc1, 0x3a, 0xe3, 0x52, 0x43, 0x70, 0x54, 0xd0, 0x50, 0x0e, 0x16, 0x7a, 0x16, 0x39, 0xef, 0xda, - 0x2e, 0x1d, 0x6a, 0xce, 0x2d, 0x01, 0xae, 0xdf, 0x32, 0xce, 0x69, 0xf3, 0x7d, 0x25, 0x0a, 0x71, - 0x76, 0x60, 0xce, 0x76, 0x8c, 0xb6, 0x61, 0x61, 0x0a, 0x00, 0x18, 0x54, 0x9e, 0xda, 0x5d, 0x14, - 0x57, 0xdf, 0xd3, 0x14, 0x2c, 0xa8, 0x79, 0x0d, 0xb8, 0x08, 0x7d, 0x43, 0x35, 0x98, 0x6e, 0xb1, - 0x79, 0x47, 0x40, 0xdf, 0xd4, 0xa4, 0x0b, 0x2b, 0x3e, 0x15, 0xed, 0xca, 0x62, 0x7f, 0xd2, 0x60, - 0x7f, 0x9c, 0xa3, 0x09, 0x3b, 0xe8, 0x00, 0x16, 0x68, 0x41, 0x6c, 0xf5, 0x8b, 0x21, 0x07, 0x93, - 0xdb, 0x01, 0xc3, 0xfe, 0x8f, 0xf0, 0x8c, 0xc2, 0x05, 0x83, 0x37, 0x62, 0xf3, 0x24, 0x40, 0x43, - 0xff, 0xee, 0x9f, 0xf6, 0xcc, 0x65, 0xde, 0xf9, 0xc9, 0x21, 0xf2, 0x00, 0xf5, 0x20, 0x6e, 0xd9, - 0x2f, 0x05, 0x36, 0x7e, 0xcb, 0x3c, 0x98, 0x17, 0xc1, 0x79, 0x7c, 0xf5, 0x3b, 0x32, 0x6a, 0x20, - 0x67, 0xda, 0xcd, 0x17, 0x7d, 0x2b, 0x1a, 0x5d, 0x8f, 0x5f, 0xe3, 0xf1, 0x4b, 0xf7, 0x07, 0x7f, - 0x89, 0x81, 0x3c, 0xe9, 0x2f, 0x15, 0x92, 0x61, 0x25, 0xbb, 0x5b, 0xd5, 0x1a, 0x78, 0xec, 0x6f, - 0xc9, 0x5d, 0xb8, 0x35, 0xc4, 0x61, 0x2f, 0x4a, 0x1e, 0x6b, 0x4a, 0xae, 0xaa, 0xe5, 0xf1, 0x5e, - 0xf5, 0xb0, 0x92, 0x97, 0xa2, 0x28, 0x05, 0x9b, 0x43, 0x62, 0xb9, 0x92, 0xaa, 0x54, 0xe8, 0x5b, - 0x51, 0xc9, 0x35, 0xa4, 0x38, 0xda, 0x82, 0xeb, 0x43, 0xfc, 0xda, 0x61, 0xbd, 0xa0, 0x68, 0xbe, - 0x35, 0x29, 0x81, 0xae, 0xc3, 0xfa, 0xf8, 0x3a, 0xb8, 0x5e, 0xcb, 0x56, 0xa4, 0x29, 0xf4, 0x9f, - 0xf0, 0xd1, 0x10, 0x53, 0x2c, 0x9e, 0x2d, 0x69, 0x4a, 0x36, 0xff, 0x0c, 0x1f, 0x69, 0x6a, 0xa3, - 0xa1, 0x54, 0x70, 0xad, 0x5a, 0xaf, 0xab, 0xbb, 0x25, 0x85, 0x5d, 0xaa, 0x64, 0x9f, 0x49, 0xd3, - 0xe8, 0x7d, 0xb8, 0x3d, 0xa4, 0x58, 0x51, 0x8e, 0xf8, 0x6d, 0x06, 0xae, 0x69, 0xca, 0x13, 0xa5, - 0xd2, 0xa8, 0xe3, 0xc6, 0xd3, 0x8a, 0x94, 0x44, 0xf7, 0xe1, 0xee, 0x90, 0x60, 0x43, 0x2d, 0x2b, - 0xf5, 0x46, 0xb6, 0x5c, 0xc3, 0xb9, 0x6c, 0xae, 0xa0, 0x88, 0x8d, 0x28, 0x79, 0x69, 0x66, 0x33, - 0xf1, 0xd5, 0xd7, 0xa9, 0x48, 0x9a, 0x06, 0x35, 0xf6, 0xe0, 0xb7, 0xc3, 0x3f, 0xbb, 0x02, 0x3f, - 0xce, 0xf8, 0xdd, 0x4a, 0x43, 0x7b, 0x36, 0x1e, 0x52, 0x76, 0x91, 0x43, 0x39, 0xd4, 0x6f, 0x05, - 0x37, 0xaa, 0x55, 0x5c, 0x2d, 0xd1, 0x20, 0xb2, 0x9b, 0x1f, 0xca, 0xa8, 0x2b, 0x9a, 0x9a, 0x2d, - 0xa9, 0x9f, 0x65, 0x77, 0x4b, 0x8a, 0x14, 0x47, 0x37, 0x61, 0x83, 0xd3, 0xb3, 0xf5, 0x67, 0x95, - 0x9c, 0x50, 0xdb, 0xcb, 0xaa, 0xa5, 0x43, 0x4d, 0x91, 0xa6, 0x50, 0x1a, 0x52, 0x9c, 0xcd, 0xff, - 0x65, 0xe1, 0xbc, 0x92, 0xcd, 0x97, 0xd4, 0x8a, 0x32, 0xf8, 0xf1, 0x32, 0xcd, 0x9d, 0x7e, 0xf0, - 0x08, 0xd0, 0xf8, 0xb7, 0x8f, 0x92, 0x90, 0xa8, 0x54, 0x2b, 0x8a, 0x14, 0x41, 0x73, 0x30, 0xb3, - 0x9b, 0xcd, 0x1d, 0x54, 0xf7, 0xf6, 0xa4, 0x28, 0x5a, 0x80, 0x59, 0xb5, 0x5c, 0x56, 0xf2, 0x6a, - 0xb6, 0xa1, 0x48, 0xb1, 0xdd, 0xfb, 0xdf, 0xfc, 0x23, 0x15, 0xf9, 0xe6, 0x75, 0x2a, 0xfa, 0xed, - 0xeb, 0x54, 0xf4, 0xbb, 0xd7, 0xa9, 0xe8, 0xdf, 0x5f, 0xa7, 0xa2, 0x3f, 0x7f, 0x93, 0x8a, 0x7c, - 0xfb, 0x26, 0x15, 0xf9, 0xee, 0x4d, 0x2a, 0xf2, 0xd9, 0x8c, 0xa8, 0x06, 0xff, 0x0a, 0x00, 0x00, - 0xff, 0xff, 0x58, 0x87, 0xd7, 0x3e, 0x81, 0x22, 0x00, 0x00, + // 3182 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0x9c, 0x59, 0xcd, 0x73, 0xdb, 0xc8, + 0x95, 0x27, 0x48, 0x4a, 0xa2, 0x9e, 0x3e, 0x0c, 0xb5, 0xbe, 0x20, 0x79, 0x4c, 0xc9, 0xf4, 0x78, + 0xc6, 0xf6, 0xd4, 0x50, 0x5b, 0x9e, 0x9d, 0xdd, 0x1d, 0xaf, 0xf7, 0x40, 0x91, 0x90, 0x08, 0x8a, + 0x1f, 0x1a, 0x90, 0xb2, 0xec, 0x71, 0x4d, 0xf5, 0x42, 0x64, 0x8b, 0xc2, 0x1a, 0x04, 0x38, 0x00, + 0x28, 0x4b, 0xb7, 0xdd, 0x9d, 0xcb, 0xd6, 0xe6, 0x92, 0x4b, 0xaa, 0x72, 0x4c, 0xd5, 0x54, 0x0e, + 0xa9, 0x4a, 0xa5, 0xf2, 0x17, 0xe4, 0x94, 0x54, 0xcd, 0x29, 0x35, 0x95, 0xd3, 0x54, 0x0e, 0x4e, + 0x62, 0xe7, 0xaf, 0x98, 0x53, 0xaa, 0x3f, 0x40, 0x82, 0x24, 0x28, 0xcb, 0x73, 0x03, 0x5e, 0xbf, + 0xf7, 0xfa, 0xf5, 0xeb, 0xc6, 0x7b, 0xbf, 0x5f, 0x03, 0x56, 0x5c, 0xc7, 0x68, 0x9e, 0x75, 0x4f, + 0x76, 0x88, 0xeb, 0x3a, 0xae, 0x97, 0xed, 0xba, 0x8e, 0xef, 0xa0, 0xa5, 0xa6, 0xd3, 0x7c, 0xc1, + 0x46, 0xb2, 0x2f, 0xce, 0xb3, 0x2f, 0xce, 0xbb, 0x27, 0x9b, 0xab, 0x5c, 0x61, 0x44, 0x73, 0x13, + 0x05, 0xf6, 0x2d, 0xc3, 0x37, 0x84, 0x6c, 0x2d, 0x90, 0x75, 0x88, 0x6f, 0x84, 0xe4, 0x4a, 0xcf, + 0x37, 0xad, 0x9d, 0x33, 0xab, 0xb9, 0xe3, 0x9b, 0x1d, 0xe2, 0xf9, 0x46, 0xa7, 0x2b, 0x46, 0x56, + 0xda, 0x4e, 0xdb, 0x61, 0x8f, 0x3b, 0xf4, 0x89, 0x4b, 0x33, 0xbf, 0x8d, 0xc3, 0x72, 0xd5, 0xf1, + 0xcb, 0xc4, 0xf0, 0x48, 0xd1, 0xb1, 0x5a, 0xc4, 0x55, 0xe9, 0xd4, 0xa8, 0x00, 0x33, 0x2e, 0xe9, + 0x5a, 0x66, 0xd3, 0x50, 0xa4, 0x6d, 0xe9, 0xde, 0xdc, 0xc3, 0xf7, 0xb3, 0x83, 0x78, 0xc5, 0xdc, + 0x59, 0x9d, 0x6b, 0x14, 0x88, 0xd7, 0x74, 0xcd, 0xae, 0xef, 0xb8, 0xbb, 0xc9, 0x6f, 0x5f, 0x6d, + 0xc5, 0xf4, 0xc0, 0x14, 0xed, 0xc3, 0xbc, 0x45, 0x3d, 0xe3, 0x33, 0xe6, 0x5a, 0x89, 0x5f, 0xdf, + 0x95, 0x3e, 0x67, 0x0d, 0x62, 0x42, 0x59, 0x98, 0x62, 0xaf, 0x4a, 0x92, 0x79, 0x50, 0x22, 0x3c, + 0xb0, 0x25, 0xe8, 0x5c, 0x0d, 0x7d, 0x0a, 0x29, 0xd7, 0xb0, 0xdb, 0x04, 0x9b, 0x2d, 0x25, 0xb1, + 0x2d, 0xdd, 0x4b, 0xec, 0x6e, 0xd2, 0xc8, 0x5e, 0xbf, 0xda, 0x9a, 0xd1, 0xa9, 0x5c, 0x2b, 0xfc, + 0x30, 0x78, 0xd4, 0x67, 0x98, 0xae, 0xd6, 0x42, 0x77, 0x00, 0x9a, 0x3d, 0xcf, 0x77, 0x3a, 0xb8, + 0xe3, 0xb5, 0x95, 0xa9, 0x6d, 0xe9, 0xde, 0xac, 0x58, 0xd2, 0x2c, 0x97, 0x57, 0xbc, 0x76, 0x66, + 0x0d, 0x56, 0xaa, 0x4e, 0x8b, 0x1c, 0xd9, 0xc6, 0xb9, 0x61, 0x5a, 0xc6, 0x89, 0x45, 0x58, 0xca, + 0x32, 0x1b, 0xb0, 0x7e, 0x64, 0x7b, 0xbd, 0x6e, 0xd7, 0x71, 0x7d, 0xd2, 0xd2, 0xc9, 0x57, 0x3d, + 0xe2, 0xf9, 0x7c, 0xe8, 0x7f, 0x25, 0x40, 0x6c, 0xb2, 0xaa, 0xe3, 0xef, 0x39, 0x3d, 0xbb, 0xc5, + 0x93, 0x1c, 0x8e, 0x52, 0xba, 0x7e, 0x94, 0x9f, 0x42, 0xca, 0xf3, 0x1d, 0x97, 0x99, 0xc5, 0x87, + 0xcd, 0xea, 0x54, 0xce, 0xcd, 0xc4, 0xa3, 0x3e, 0xc3, 0x74, 0xb5, 0x56, 0xe6, 0x0f, 0x12, 0xac, + 0x32, 0x5f, 0x07, 0xe4, 0xb2, 0x62, 0x7a, 0x1d, 0xc3, 0x6f, 0x9e, 0xf1, 0x38, 0x3e, 0x81, 0x25, + 0x97, 0x87, 0x8b, 0x3d, 0xdf, 0x70, 0x7d, 0xfc, 0x82, 0x5c, 0xb2, 0x80, 0xe6, 0x77, 0x67, 0x7e, + 0x78, 0xb5, 0x95, 0x38, 0x20, 0x97, 0xfa, 0x0d, 0xa1, 0x51, 0xa7, 0x0a, 0x07, 0xe4, 0x12, 0xed, + 0x40, 0x20, 0xc2, 0xc4, 0x6e, 0x31, 0x93, 0xf8, 0xb0, 0xc9, 0x82, 0x18, 0x57, 0xed, 0x16, 0x35, + 0x78, 0x04, 0xd3, 0x6c, 0x05, 0x9e, 0x32, 0xb5, 0x9d, 0xb8, 0x37, 0xf7, 0xf0, 0xbd, 0xa8, 0x63, + 0xc0, 0x96, 0x68, 0x9f, 0x3a, 0x22, 0xed, 0xc2, 0xa2, 0x94, 0x4c, 0x25, 0xe4, 0x64, 0x29, 0x99, + 0x4a, 0xca, 0x53, 0x99, 0x37, 0x09, 0xc8, 0xe8, 0xc4, 0x68, 0x1d, 0x9b, 0xfe, 0x99, 0x69, 0x1f, + 0xd9, 0x4d, 0xe2, 0xfa, 0x86, 0x69, 0xfb, 0x97, 0x9a, 0xed, 0x13, 0xf7, 0xdc, 0xb0, 0xf8, 0xa2, + 0x4a, 0xb0, 0xe8, 0x12, 0xa3, 0x85, 0xfb, 0xdf, 0x81, 0x38, 0xc8, 0xb7, 0x42, 0xd3, 0xd2, 0x8f, + 0x25, 0x7b, 0x66, 0x35, 0xb3, 0x8d, 0x40, 0x49, 0xcc, 0xbb, 0x40, 0x4d, 0xfb, 0x42, 0xa4, 0x03, + 0x22, 0x17, 0xa6, 0xe7, 0x9b, 0x76, 0x3b, 0xe4, 0x2f, 0x7e, 0x7d, 0x7f, 0x4b, 0x81, 0xf9, 0xc0, + 0xe7, 0x73, 0x58, 0xb7, 0x9c, 0xa6, 0x61, 0xe1, 0xde, 0x60, 0x05, 0xd8, 0x32, 0x3b, 0xa6, 0xcf, + 0x0e, 0xde, 0x35, 0x1d, 0xaf, 0x32, 0x1f, 0xa1, 0x24, 0x94, 0xa9, 0x07, 0xf4, 0x25, 0x28, 0x6d, + 0xcb, 0x39, 0x89, 0xf4, 0x9e, 0xb8, 0xbe, 0xf7, 0x35, 0xee, 0x64, 0xcc, 0xfd, 0x73, 0x58, 0x76, + 0x4e, 0x3c, 0xe2, 0x9e, 0x93, 0x50, 0x7e, 0x3d, 0x25, 0xc9, 0xf6, 0x35, 0xea, 0xf3, 0xae, 0x09, + 0xed, 0xd1, 0x09, 0x90, 0x33, 0x3a, 0xe0, 0x3d, 0x4a, 0xfe, 0xfc, 0x17, 0x5b, 0xb1, 0x4c, 0x0b, + 0xd6, 0x1b, 0xae, 0x61, 0x7b, 0x46, 0xd3, 0x37, 0x1d, 0x3b, 0x77, 0xc2, 0x3e, 0x2a, 0xbe, 0xb3, + 0x1a, 0x4c, 0xbb, 0xc4, 0xf0, 0x1c, 0x9b, 0xed, 0xe8, 0xe2, 0xc3, 0x8f, 0xb2, 0x63, 0xa5, 0x34, + 0x3b, 0x6e, 0xab, 0x33, 0x93, 0xfe, 0xb9, 0x62, 0x6f, 0x99, 0xe7, 0xb0, 0x12, 0xd2, 0x3c, 0xec, + 0x79, 0xe2, 0x8b, 0xc8, 0x03, 0x74, 0x7b, 0xde, 0x19, 0x21, 0xd8, 0xbf, 0xb0, 0xc5, 0xc1, 0x49, + 0x47, 0xac, 0x2b, 0x64, 0x1c, 0x14, 0x0a, 0x6e, 0xd7, 0xb8, 0xb0, 0x33, 0x5f, 0x4b, 0xb0, 0x1a, + 0x52, 0xd0, 0x89, 0xef, 0x5e, 0x72, 0xf7, 0xfb, 0x23, 0x2b, 0xb8, 0x7f, 0xf5, 0x0a, 0x98, 0x65, + 0x54, 0xfc, 0xe8, 0x36, 0xcc, 0x92, 0x0b, 0xdf, 0x35, 0x58, 0xbd, 0x8a, 0x87, 0xea, 0x55, 0x8a, + 0x89, 0x69, 0xb9, 0xfa, 0x9d, 0x04, 0x6b, 0x21, 0x5f, 0x75, 0xdf, 0xf0, 0x7b, 0x1e, 0x0f, 0x63, + 0x0d, 0x12, 0xd4, 0x4e, 0x0a, 0xd9, 0x51, 0x01, 0xaa, 0xf6, 0xc3, 0x8b, 0xb3, 0xf0, 0xfe, 0xe9, + 0xea, 0xf0, 0x42, 0x2e, 0xb3, 0x91, 0x59, 0x7e, 0x0c, 0xd3, 0x5c, 0x8e, 0x10, 0x2c, 0xea, 0x6a, + 0xae, 0x5e, 0xab, 0xe2, 0xa3, 0xea, 0x41, 0xb5, 0x76, 0x5c, 0x95, 0x63, 0x48, 0x81, 0x15, 0x21, + 0x6b, 0x3c, 0xad, 0xe2, 0x7c, 0xad, 0x52, 0xd1, 0x1a, 0x0d, 0xb5, 0x20, 0xc7, 0x33, 0xc9, 0x94, + 0x24, 0x4b, 0x99, 0xbf, 0xc4, 0x41, 0x3e, 0x76, 0x4d, 0x9f, 0xd0, 0xef, 0xdb, 0xe6, 0x15, 0x15, + 0x7d, 0x06, 0x33, 0x26, 0x7b, 0xf5, 0x14, 0x89, 0x9d, 0xba, 0x8d, 0x88, 0xdd, 0xe1, 0x06, 0x41, + 0x53, 0x12, 0xfa, 0xe8, 0x31, 0x2c, 0xf2, 0xa6, 0xe4, 0xd1, 0xf2, 0x64, 0x37, 0x89, 0xe8, 0x10, + 0xab, 0x54, 0xed, 0x87, 0x57, 0x5b, 0x0b, 0xac, 0x93, 0xd4, 0xc5, 0xa0, 0xbe, 0x60, 0x85, 0x5f, + 0x51, 0xb1, 0x9f, 0x9b, 0x24, 0xcb, 0xcd, 0x83, 0x88, 0xdc, 0x8c, 0x46, 0x1b, 0x9d, 0x95, 0xff, + 0x91, 0xfa, 0x69, 0x59, 0x03, 0xd4, 0x4f, 0x4b, 0xfd, 0x50, 0xcd, 0x6b, 0x7b, 0x9a, 0x5a, 0x90, + 0x63, 0x21, 0xf9, 0x71, 0x4e, 0x6b, 0xe0, 0xc3, 0x5a, 0x59, 0xcb, 0x3f, 0x93, 0x25, 0xb4, 0x0e, + 0xcb, 0x42, 0x5e, 0xae, 0xe5, 0x0f, 0x70, 0x43, 0xab, 0xa8, 0xb5, 0xa3, 0x86, 0x1c, 0x47, 0x59, + 0x78, 0x10, 0x1e, 0x60, 0x56, 0x9f, 0x1f, 0xa9, 0x47, 0x2a, 0xae, 0xe4, 0x9e, 0xe2, 0xb2, 0x5a, + 0xdd, 0x6f, 0x14, 0xb1, 0xfa, 0x34, 0xaf, 0xaa, 0x05, 0xb5, 0x20, 0x27, 0x4a, 0xc9, 0x54, 0x5c, + 0x4e, 0x64, 0x7e, 0x29, 0x89, 0x0c, 0x37, 0x1c, 0xa7, 0x66, 0x89, 0xaf, 0x2c, 0x07, 0xb3, 0x3f, + 0xaa, 0x74, 0x0e, 0xac, 0x50, 0x15, 0x64, 0xa3, 0xe9, 0xf7, 0x0c, 0xeb, 0xc7, 0x15, 0xcd, 0x1b, + 0xdc, 0xb8, 0x2f, 0xce, 0xac, 0x00, 0xaa, 0x75, 0x69, 0x63, 0x35, 0x5d, 0xe2, 0x35, 0x2e, 0x6c, + 0xde, 0x5c, 0xeb, 0xb0, 0x92, 0x77, 0xec, 0x96, 0x49, 0x8f, 0xe2, 0x9e, 0x61, 0x5a, 0x41, 0x99, + 0xf8, 0x77, 0x98, 0x17, 0xb3, 0x9f, 0x1b, 0x56, 0x8f, 0x88, 0x35, 0x44, 0x41, 0x87, 0x27, 0x74, + 0x5c, 0x9f, 0xe3, 0xda, 0xec, 0x25, 0xf3, 0x1b, 0x09, 0x10, 0x47, 0x14, 0xe4, 0xbf, 0x48, 0xb3, + 0x5f, 0x7a, 0xd2, 0x30, 0xd3, 0x21, 0x9e, 0x67, 0xb4, 0xc9, 0xd0, 0x57, 0x13, 0x08, 0xd1, 0x63, + 0x98, 0x15, 0x4d, 0x8f, 0xb4, 0xc4, 0x52, 0x27, 0x62, 0x95, 0x20, 0x5f, 0x7d, 0x03, 0xf4, 0x08, + 0x52, 0x41, 0x9f, 0x10, 0x55, 0xfa, 0x6d, 0xc6, 0x7d, 0xfd, 0xcc, 0x57, 0xb0, 0x92, 0xeb, 0x9c, + 0x98, 0xed, 0x9e, 0xd3, 0xf3, 0x74, 0xe2, 0xf5, 0x2c, 0xff, 0x7a, 0x11, 0x7f, 0x06, 0x73, 0x2f, + 0x5d, 0xa3, 0xdb, 0x25, 0x2d, 0x4c, 0x5c, 0x37, 0x22, 0xe6, 0xe0, 0x50, 0x33, 0x77, 0x3a, 0x08, + 0x65, 0xd5, 0x75, 0x33, 0xeb, 0x14, 0x4f, 0x9c, 0xfa, 0xfb, 0xae, 0xd3, 0xeb, 0x16, 0x88, 0x45, + 0x82, 0x2c, 0x65, 0x30, 0xac, 0x09, 0x3c, 0x97, 0x77, 0x5c, 0xb7, 0xd7, 0xa5, 0x3b, 0xc3, 0xa3, + 0xa1, 0xf5, 0x8a, 0x3e, 0xe0, 0xd1, 0xba, 0x93, 0x62, 0xe2, 0x8a, 0xd7, 0x46, 0x19, 0x98, 0xed, + 0xba, 0x4e, 0x93, 0x78, 0x9e, 0x48, 0x61, 0xaa, 0x5f, 0x59, 0x03, 0x71, 0xa6, 0x0e, 0x48, 0x4c, + 0x10, 0x3e, 0xb1, 0xff, 0x01, 0x20, 0x80, 0x67, 0x00, 0xa8, 0xa6, 0x76, 0xd3, 0x02, 0x19, 0xcd, + 0x0a, 0x7d, 0x86, 0x8d, 0x06, 0x2f, 0x34, 0xfb, 0xfc, 0xb1, 0x95, 0x39, 0x00, 0xc4, 0x30, 0xd3, + 0x18, 0x46, 0xeb, 0x83, 0x2d, 0xe9, 0xfa, 0x60, 0xab, 0x4e, 0xc1, 0xe0, 0x99, 0x61, 0xb7, 0x2c, + 0xda, 0x79, 0x7c, 0xf7, 0xb2, 0x8f, 0x13, 0xd1, 0x43, 0x48, 0x76, 0x55, 0xd7, 0x8d, 0x38, 0x8f, + 0x43, 0xa9, 0x16, 0xab, 0x66, 0xba, 0xa2, 0x27, 0xfe, 0x5d, 0x82, 0xbb, 0xa3, 0x6d, 0x81, 0xa2, + 0xa0, 0x43, 0x0a, 0xe5, 0x75, 0x72, 0xea, 0x92, 0xa0, 0x7f, 0x4d, 0xaa, 0xec, 0xcf, 0x61, 0xda, + 0xbf, 0xb0, 0x03, 0xe0, 0x38, 0xbf, 0x5b, 0xa0, 0x43, 0x7f, 0x7e, 0xb5, 0xf5, 0x49, 0xdb, 0xf4, + 0xcf, 0x7a, 0x27, 0xd9, 0xa6, 0xd3, 0xd9, 0xe9, 0xc7, 0xd3, 0x3a, 0x19, 0x3c, 0xef, 0x74, 0x5f, + 0xb4, 0x77, 0x18, 0xb7, 0xe8, 0xf5, 0xcc, 0x56, 0xf6, 0xe8, 0x48, 0x2b, 0xbc, 0x7e, 0xb5, 0x35, + 0xd5, 0xb8, 0xb0, 0xb5, 0x82, 0x3e, 0xe5, 0x5f, 0xd8, 0x5a, 0x0b, 0xed, 0xc1, 0x9c, 0x3f, 0x88, + 0x4e, 0x9c, 0xe0, 0xeb, 0x75, 0xcd, 0xb0, 0x61, 0x66, 0x0f, 0xb6, 0x1a, 0x17, 0x76, 0xce, 0xa2, + 0x18, 0xec, 0x52, 0xb5, 0x9b, 0x4e, 0x8f, 0x02, 0x3b, 0x71, 0xb8, 0xf8, 0xfa, 0xee, 0x00, 0x74, + 0x5d, 0x72, 0x8e, 0xd9, 0xa9, 0x19, 0x5a, 0xe6, 0x2c, 0x95, 0xf3, 0x63, 0xf8, 0x13, 0x09, 0x56, + 0x68, 0x15, 0x6e, 0x13, 0xb7, 0x76, 0x4e, 0xdc, 0x53, 0xcb, 0x79, 0xc9, 0xad, 0x37, 0x20, 0x11, + 0x81, 0x70, 0xa9, 0x0c, 0xdd, 0x87, 0x85, 0x66, 0xcf, 0x75, 0x89, 0xed, 0x8b, 0xaa, 0xc1, 0x01, + 0x36, 0xf7, 0x3d, 0x2f, 0x86, 0x58, 0x89, 0x40, 0x1f, 0xc3, 0x0d, 0xd3, 0x6e, 0xba, 0xa4, 0x33, + 0x50, 0x4e, 0x84, 0x94, 0x17, 0xfb, 0x83, 0xbc, 0xa2, 0x7c, 0x23, 0xc1, 0xcd, 0x5d, 0x8a, 0xb9, + 0x07, 0x65, 0x8e, 0x9c, 0x3a, 0x2e, 0xd9, 0xcf, 0xf7, 0xeb, 0x6d, 0xe3, 0x47, 0xd5, 0xdb, 0x01, + 0xa4, 0xa4, 0x2e, 0xce, 0xe8, 0x21, 0x70, 0xac, 0xd6, 0xbb, 0x14, 0xda, 0x81, 0x55, 0xa6, 0x03, + 0x88, 0x37, 0xae, 0x8a, 0xe9, 0x79, 0xa6, 0xdd, 0xe6, 0xb1, 0x3d, 0x86, 0xf9, 0x97, 0xae, 0x63, + 0xb7, 0x31, 0xef, 0xa1, 0x22, 0xbc, 0xc9, 0x2d, 0x57, 0x9f, 0x63, 0xea, 0xfc, 0x25, 0x48, 0x77, + 0x7c, 0x3c, 0xdd, 0x94, 0x4b, 0x55, 0x88, 0x4b, 0x21, 0xff, 0xa1, 0xeb, 0xb4, 0x5d, 0xe2, 0x71, + 0x18, 0x91, 0xf9, 0x55, 0x1c, 0x96, 0x19, 0x17, 0xd8, 0x23, 0xe2, 0xfb, 0xe1, 0x81, 0x1c, 0x8c, + 0x00, 0xa7, 0x8f, 0x23, 0xbe, 0x9e, 0x08, 0xbb, 0xe8, 0x06, 0xfc, 0xfb, 0x41, 0x03, 0xde, 0x84, + 0x35, 0xd1, 0x37, 0x75, 0xf5, 0xb0, 0xac, 0xe5, 0x73, 0x58, 0x57, 0x2b, 0xb5, 0x27, 0x23, 0x4d, + 0x58, 0xcf, 0x55, 0xf7, 0x55, 0x5c, 0x3f, 0x2c, 0x6b, 0x8d, 0xa1, 0x26, 0xcc, 0xe5, 0x15, 0x55, + 0xdf, 0xa7, 0xb0, 0x25, 0x04, 0x68, 0xf4, 0xdc, 0x5e, 0x03, 0xd7, 0xab, 0xb9, 0xc3, 0x7a, 0xb1, + 0xd6, 0x90, 0x13, 0x28, 0x0d, 0x9b, 0xfd, 0xf6, 0xbc, 0xaf, 0xe5, 0x73, 0x65, 0x5c, 0x3b, 0xac, + 0xe3, 0x8a, 0x56, 0xaf, 0x6b, 0xd5, 0x7d, 0x39, 0x19, 0xb2, 0xac, 0x97, 0x6b, 0xc7, 0x38, 0x5f, + 0xab, 0xd6, 0x8f, 0x2a, 0xaa, 0x2e, 0x4f, 0xa1, 0x0d, 0x58, 0x15, 0x23, 0xd5, 0x1a, 0x2e, 0xab, + 0xb9, 0xba, 0x5a, 0xac, 0x95, 0x0b, 0xaa, 0x2e, 0x4f, 0x67, 0x0c, 0x50, 0x34, 0xbb, 0x45, 0x7c, + 0xe2, 0x76, 0x4c, 0xdb, 0xf0, 0x49, 0xde, 0xe9, 0x74, 0x4c, 0x51, 0xfd, 0x55, 0x98, 0xf3, 0x7c, + 0xa3, 0xcd, 0x78, 0xcb, 0x3b, 0x02, 0x59, 0x10, 0x86, 0x14, 0xc9, 0x2e, 0xc3, 0x92, 0x66, 0x9f, + 0x1b, 0x96, 0xd9, 0x62, 0xcd, 0x87, 0xef, 0x51, 0x1a, 0xde, 0xab, 0x75, 0x7d, 0xb3, 0x43, 0x1b, + 0x50, 0x53, 0x3d, 0x37, 0xac, 0xbc, 0x63, 0x9f, 0x5a, 0x66, 0xd3, 0x17, 0x7b, 0xf8, 0x47, 0x09, + 0xee, 0x54, 0x4c, 0x7b, 0x70, 0xd8, 0x68, 0x51, 0x3d, 0xb2, 0x3d, 0xc3, 0x37, 0xbd, 0x53, 0x73, + 0x50, 0x0f, 0xeb, 0xb0, 0xdc, 0x31, 0xed, 0x01, 0x44, 0xc0, 0x27, 0x54, 0xf1, 0x5d, 0x3e, 0x81, + 0xa5, 0xce, 0xe8, 0x34, 0x94, 0xb1, 0xb9, 0xc4, 0x73, 0xac, 0x21, 0x86, 0xf2, 0x4e, 0x8c, 0x2d, + 0x30, 0x1f, 0xc0, 0x8f, 0x9f, 0xad, 0xc3, 0x1c, 0x0b, 0xb9, 0x40, 0x7c, 0xc3, 0xb4, 0x90, 0x0e, + 0xb2, 0xed, 0xf8, 0x78, 0xe8, 0x86, 0x83, 0x47, 0xfd, 0x41, 0xc4, 0xb1, 0x8c, 0xb8, 0x65, 0x29, + 0xc6, 0xf4, 0x45, 0x7b, 0x48, 0x8c, 0x6a, 0x70, 0x83, 0x5f, 0x09, 0x50, 0xcf, 0xa7, 0x2c, 0x11, + 0x3c, 0xe8, 0xbb, 0x93, 0x4e, 0xfa, 0x50, 0xbb, 0x2a, 0x52, 0xea, 0x1a, 0x96, 0xa2, 0xa7, 0x80, + 0xb8, 0xc3, 0x17, 0xe4, 0x12, 0x77, 0x04, 0xed, 0x17, 0xb5, 0xf9, 0xde, 0x24, 0x9f, 0xa3, 0x37, + 0x04, 0xc5, 0x98, 0x2e, 0xbb, 0x23, 0x03, 0xe8, 0xbf, 0x25, 0xd8, 0x66, 0x0c, 0xfb, 0x25, 0x23, + 0xe2, 0x43, 0x4c, 0xd3, 0x14, 0x54, 0x5c, 0xdc, 0xd7, 0x7c, 0x1a, 0x35, 0xd1, 0x5b, 0x29, 0x7c, + 0x31, 0xa6, 0xdf, 0x72, 0xaf, 0xd2, 0x42, 0x5f, 0xc2, 0x72, 0xa8, 0x71, 0x60, 0x83, 0x33, 0x3d, + 0xc1, 0x9f, 0x1f, 0x5c, 0x8b, 0x16, 0x06, 0x33, 0x21, 0x7f, 0x6c, 0x08, 0x35, 0x40, 0x0e, 0xbb, + 0xa7, 0xcc, 0x4e, 0x99, 0x66, 0xbe, 0x3f, 0xbc, 0xda, 0x77, 0x9f, 0x48, 0x16, 0x63, 0xfa, 0x0d, + 0x7f, 0x58, 0x8e, 0x8e, 0x61, 0x29, 0xec, 0xd5, 0xa5, 0x55, 0x4a, 0x99, 0x99, 0xb8, 0x21, 0x91, + 0x0c, 0x92, 0x6e, 0x88, 0x3f, 0x32, 0x80, 0xbe, 0x80, 0xf0, 0x22, 0xb0, 0xc7, 0x68, 0x99, 0x92, + 0x62, 0x9e, 0xef, 0x5f, 0x9b, 0xc2, 0x15, 0x63, 0x7a, 0x38, 0x3e, 0x3e, 0x82, 0x8a, 0xb4, 0x03, + 0x98, 0x3e, 0x09, 0x3a, 0xc0, 0x2c, 0xf3, 0x7a, 0xe7, 0x1a, 0xe4, 0xa7, 0x18, 0xa3, 0xdd, 0xa0, + 0x2f, 0x43, 0x1a, 0x2c, 0x70, 0x4f, 0xbe, 0xe3, 0x60, 0xda, 0xa8, 0xe0, 0x6a, 0x57, 0x21, 0x84, + 0xd7, 0x77, 0xc5, 0x65, 0xf4, 0x63, 0x71, 0xba, 0xd8, 0x15, 0x84, 0x80, 0x55, 0xb8, 0xb9, 0x89, + 0x1f, 0xcb, 0x38, 0x73, 0xa0, 0x1f, 0x8b, 0x13, 0x96, 0xd2, 0x0d, 0x6f, 0x06, 0x54, 0x02, 0x9f, + 0x32, 0x2e, 0xa1, 0xcc, 0x4f, 0xdc, 0xf0, 0x28, 0xd6, 0x41, 0x37, 0xbc, 0x39, 0x2c, 0x47, 0xd5, + 0x80, 0x70, 0xba, 0x82, 0x4b, 0x28, 0x0b, 0x13, 0xa3, 0x1c, 0xe7, 0x1c, 0x34, 0x4a, 0x2b, 0x2c, + 0xa5, 0x51, 0xda, 0x4e, 0x8b, 0xe0, 0xde, 0xe0, 0x06, 0x52, 0x59, 0x9c, 0x18, 0x65, 0xd4, 0x5d, + 0x25, 0x8d, 0xd2, 0x1e, 0x96, 0xf3, 0x42, 0x71, 0xea, 0xe3, 0x36, 0x85, 0xf3, 0xb8, 0xc5, 0xf1, + 0xbc, 0x22, 0x5f, 0x51, 0x28, 0x22, 0xa0, 0x3f, 0x2f, 0x14, 0xc3, 0x03, 0xf4, 0x5c, 0x06, 0xb8, + 0xbc, 0xd9, 0xe7, 0x03, 0xca, 0xd2, 0xc4, 0x73, 0x19, 0xcd, 0x1d, 0x8a, 0xac, 0x26, 0x8f, 0x8c, + 0xb0, 0x7a, 0x29, 0x7c, 0x07, 0xe7, 0x09, 0x4d, 0xae, 0x97, 0x63, 0x9c, 0x81, 0xd5, 0xcb, 0xb0, + 0x94, 0x26, 0xd7, 0x08, 0x78, 0x14, 0x76, 0x19, 0x91, 0x52, 0x36, 0x27, 0x26, 0x37, 0x8a, 0x72, + 0xd1, 0xe4, 0x1a, 0xc3, 0x72, 0x1a, 0x26, 0x67, 0x11, 0x83, 0xb2, 0x7e, 0x73, 0x62, 0x98, 0xe3, + 0x2c, 0x84, 0x86, 0xe9, 0x85, 0xa5, 0xe8, 0xff, 0x25, 0x78, 0x7f, 0xac, 0x8a, 0xb0, 0x4a, 0x8c, + 0xd9, 0xc5, 0x3e, 0x76, 0x39, 0x1d, 0x50, 0xde, 0x63, 0xd3, 0xfc, 0xdb, 0x35, 0x0a, 0x4b, 0x24, + 0x93, 0x28, 0xc6, 0xf4, 0x6d, 0xff, 0x2d, 0x8a, 0x34, 0x67, 0x26, 0xc7, 0xd9, 0xd8, 0x11, 0x40, + 0x5b, 0xd9, 0x9a, 0x98, 0xb3, 0x28, 0x48, 0x4e, 0x73, 0x66, 0x0e, 0xcb, 0x69, 0x71, 0xef, 0x0d, + 0xee, 0xd3, 0xb1, 0xa0, 0xc9, 0xca, 0xf6, 0xc4, 0xe2, 0x3e, 0xe1, 0xf6, 0x9d, 0x16, 0xf7, 0xde, + 0xd8, 0x10, 0x7a, 0x0e, 0x72, 0x08, 0x72, 0x30, 0x28, 0xae, 0x64, 0x98, 0xef, 0x6c, 0x84, 0xef, + 0x2b, 0x90, 0x3b, 0xab, 0xf1, 0xc3, 0x23, 0xe8, 0x25, 0xdc, 0xa2, 0x3c, 0xcb, 0xe0, 0x1c, 0x06, + 0x93, 0x01, 0x89, 0x11, 0x94, 0xe5, 0x0e, 0x9b, 0xe9, 0x61, 0xd4, 0xb6, 0x5c, 0x4d, 0x7d, 0x8a, + 0x31, 0x7d, 0xd3, 0x9f, 0xa8, 0x42, 0x6b, 0x0d, 0xaf, 0xd0, 0xb4, 0xd7, 0x53, 0x00, 0xaf, 0xbc, + 0x3f, 0xf1, 0x9c, 0x8d, 0x03, 0x7d, 0x7a, 0xce, 0xcc, 0xb0, 0x14, 0x1d, 0xc1, 0x52, 0x87, 0x02, + 0x74, 0x6c, 0xda, 0xf4, 0x60, 0x31, 0x88, 0xae, 0xdc, 0x9d, 0xb8, 0xb7, 0x51, 0x60, 0x9e, 0xe6, + 0xa7, 0x33, 0x2c, 0x47, 0x9f, 0x0b, 0x98, 0x73, 0x4a, 0xd8, 0xce, 0xd2, 0x0e, 0xf8, 0xc1, 0x44, + 0xe4, 0x14, 0x01, 0xe8, 0x29, 0x72, 0xea, 0x3b, 0xe0, 0xdd, 0xef, 0x3f, 0x61, 0xc5, 0x0c, 0xc3, + 0x60, 0xdc, 0x64, 0x38, 0x58, 0xf9, 0x90, 0xf9, 0xfd, 0x28, 0x72, 0xfd, 0xd1, 0xa8, 0xb9, 0x18, + 0xd3, 0x97, 0xcd, 0xf1, 0x31, 0xf4, 0x04, 0x96, 0x4d, 0x8e, 0x82, 0x05, 0xe6, 0xe3, 0x5b, 0x79, + 0x6f, 0xec, 0xa7, 0xd6, 0x60, 0x82, 0x11, 0xcc, 0x4c, 0x6b, 0x98, 0x39, 0x2a, 0x44, 0x1d, 0xd8, + 0x70, 0xfa, 0x40, 0x1a, 0x93, 0x73, 0xc3, 0xc2, 0xcd, 0x00, 0x4a, 0x2b, 0xf7, 0x99, 0xf7, 0x9d, + 0xc8, 0x86, 0x36, 0x19, 0x7c, 0x17, 0x63, 0xfa, 0xba, 0x13, 0x3d, 0x8e, 0xbe, 0x96, 0xe0, 0x76, + 0x04, 0xe0, 0xc6, 0xbd, 0x30, 0x34, 0x57, 0x1e, 0xb0, 0x79, 0xff, 0x25, 0x6a, 0x8f, 0xdf, 0x8e, + 0xe9, 0x8b, 0x31, 0x3d, 0xdd, 0xb9, 0x52, 0x6d, 0x77, 0x06, 0xa6, 0x18, 0x67, 0x2e, 0x25, 0x53, + 0x37, 0x64, 0xb9, 0x94, 0x4c, 0x2d, 0xcb, 0x2b, 0xa5, 0x64, 0x6a, 0x45, 0x5e, 0x2d, 0x25, 0x53, + 0xab, 0xf2, 0x5a, 0x29, 0x99, 0x5a, 0x93, 0xd7, 0x4b, 0xc9, 0xd4, 0xba, 0xac, 0x94, 0x92, 0x29, + 0x45, 0xde, 0x28, 0x25, 0x53, 0x1b, 0xf2, 0x66, 0x29, 0x99, 0xba, 0x25, 0xa7, 0x4b, 0xc9, 0x54, + 0x5a, 0xde, 0x2a, 0x25, 0x53, 0xb7, 0xe5, 0x4c, 0xe6, 0x3e, 0x83, 0xe5, 0x87, 0x8e, 0xc7, 0x9a, + 0x2e, 0xda, 0x84, 0x29, 0xba, 0x7b, 0x17, 0xe2, 0x06, 0x88, 0xc3, 0x79, 0x2e, 0xca, 0x7c, 0x9d, + 0x80, 0xa9, 0xe0, 0x86, 0x7f, 0xa1, 0x67, 0x93, 0x8b, 0xae, 0xe3, 0x51, 0x86, 0x70, 0x61, 0x0b, + 0xa4, 0xfa, 0x16, 0x6e, 0xa4, 0xcf, 0xf7, 0x8d, 0x28, 0x5e, 0xd8, 0x81, 0x39, 0xc7, 0x35, 0xdb, + 0xa6, 0x8d, 0x69, 0x37, 0x65, 0xb8, 0x73, 0x6a, 0x77, 0x51, 0xdc, 0x23, 0x4f, 0xd3, 0xce, 0xab, + 0x15, 0x74, 0xe0, 0x2a, 0xf4, 0x0d, 0x1d, 0xc0, 0x02, 0xad, 0x05, 0xad, 0x7e, 0x1d, 0xe0, 0x38, + 0x6a, 0x3b, 0x34, 0x6b, 0xf0, 0x0f, 0x38, 0xab, 0x72, 0xc5, 0xf0, 0x65, 0xd0, 0x3c, 0x09, 0xc9, + 0xd0, 0x3f, 0x07, 0x0b, 0x9d, 0x19, 0x0b, 0x3d, 0x74, 0x93, 0x14, 0xe4, 0x45, 0xa4, 0x00, 0xf5, + 0x20, 0x61, 0x3b, 0x2f, 0x05, 0x2c, 0x7c, 0x0b, 0x15, 0x2a, 0x88, 0xa5, 0x3c, 0xbe, 0xfe, 0xf5, + 0x10, 0x75, 0x90, 0xb7, 0x9c, 0xe6, 0x8b, 0xbe, 0x17, 0x9d, 0xce, 0xc7, 0x6f, 0xb0, 0xf8, 0x7d, + 0xf3, 0x83, 0x3f, 0xc5, 0x41, 0x99, 0xf4, 0x83, 0x86, 0x72, 0xe0, 0xdc, 0x6e, 0x4d, 0x6f, 0xe0, + 0xb1, 0x1f, 0x05, 0x77, 0xe1, 0xf6, 0xd0, 0x08, 0x7b, 0x51, 0x0b, 0x58, 0x57, 0xf3, 0x35, 0xbd, + 0x80, 0xf7, 0x6a, 0x47, 0xd5, 0x82, 0x2c, 0x51, 0x92, 0x3d, 0xa4, 0x96, 0x2f, 0x6b, 0x6a, 0x95, + 0xbe, 0x95, 0xd4, 0x3c, 0x25, 0xe1, 0x5b, 0x70, 0x73, 0x68, 0xfc, 0xf0, 0xa8, 0x5e, 0x54, 0xf5, + 0xc0, 0x9b, 0x9c, 0x44, 0x37, 0x61, 0x7d, 0x7c, 0x1e, 0x5c, 0x3f, 0xcc, 0x55, 0xe5, 0x29, 0xf4, + 0xaf, 0xf0, 0xc9, 0xd0, 0xa0, 0x98, 0x3c, 0x57, 0xd6, 0xd5, 0x5c, 0xe1, 0x19, 0x3e, 0xd6, 0xb5, + 0x46, 0x43, 0xad, 0xe2, 0xc3, 0x5a, 0xbd, 0xae, 0xed, 0x96, 0x55, 0x76, 0x9f, 0x90, 0x7b, 0x26, + 0x4f, 0xa3, 0x0f, 0xe1, 0xce, 0x90, 0x61, 0x55, 0x3d, 0xe6, 0x44, 0x1e, 0x1f, 0xea, 0xea, 0x13, + 0xb5, 0xda, 0xa8, 0xe3, 0xc6, 0xd3, 0xaa, 0x9c, 0x42, 0xf7, 0xe1, 0xee, 0x90, 0x62, 0x43, 0xab, + 0xa8, 0xf5, 0x46, 0xae, 0x72, 0x88, 0xf3, 0xb9, 0x7c, 0x51, 0x15, 0x0b, 0x51, 0x0b, 0xf2, 0xcc, + 0x66, 0xf2, 0xff, 0xbe, 0x49, 0xc7, 0x32, 0x34, 0xa9, 0xf1, 0x07, 0xbf, 0x1e, 0xfe, 0xcf, 0x13, + 0xfa, 0x67, 0xc4, 0xaf, 0x15, 0x1a, 0xfa, 0xb3, 0xf1, 0x94, 0xb2, 0x3b, 0x0c, 0x3a, 0x42, 0xe3, + 0x56, 0x71, 0xa3, 0x56, 0xc3, 0xb5, 0x32, 0x4d, 0x22, 0xbb, 0xf4, 0xa0, 0x03, 0x75, 0x55, 0xd7, + 0x72, 0x65, 0xed, 0x8b, 0xdc, 0x6e, 0x59, 0x95, 0x13, 0xe8, 0x16, 0x6c, 0x70, 0x79, 0xae, 0xfe, + 0xac, 0x9a, 0x17, 0x66, 0x7b, 0x39, 0xad, 0x7c, 0xa4, 0xab, 0xf2, 0x14, 0xca, 0x40, 0x9a, 0x0f, + 0xf3, 0xdf, 0x38, 0xb8, 0xa0, 0xe6, 0x0a, 0x65, 0xad, 0xaa, 0x0e, 0xfe, 0x39, 0x4c, 0xf3, 0xa0, + 0x1f, 0x3c, 0x02, 0x34, 0x14, 0x2d, 0xfb, 0xf1, 0x8c, 0x52, 0x90, 0xac, 0xd6, 0xaa, 0xaa, 0x1c, + 0x43, 0x73, 0x30, 0xb3, 0x9b, 0xcb, 0x1f, 0xd4, 0xf6, 0xf6, 0x64, 0x09, 0x2d, 0xc0, 0xac, 0x56, + 0xa9, 0xa8, 0x05, 0x2d, 0xd7, 0x50, 0xe5, 0xf8, 0xee, 0xfd, 0x6f, 0xff, 0x96, 0x8e, 0x7d, 0xfb, + 0x3a, 0x2d, 0x7d, 0xf7, 0x3a, 0x2d, 0x7d, 0xff, 0x3a, 0x2d, 0xfd, 0xf5, 0x75, 0x5a, 0xfa, 0xe9, + 0x9b, 0x74, 0xec, 0xbb, 0x37, 0xe9, 0xd8, 0xf7, 0x6f, 0xd2, 0xb1, 0x2f, 0x66, 0xc4, 0xb7, 0xfb, + 0x8f, 0x00, 0x00, 0x00, 0xff, 0xff, 0xd1, 0xf7, 0xc6, 0x4b, 0x7c, 0x21, 0x00, 0x00, } func (m *NotLeaseHolderError) Marshal() (dAtA []byte, err error) { @@ -4444,16 +4425,6 @@ func (m *Error) MarshalToSizedBuffer(dAtA []byte) (int, error) { i-- dAtA[i] = 0x3a } - { - size, err := m.deprecatedDetail.MarshalToSizedBuffer(dAtA[:i]) - if err != nil { - return 0, err - } - i -= size - i = encodeVarintErrors(dAtA, i, uint64(size)) - } - i-- - dAtA[i] = 0x32 i = encodeVarintErrors(dAtA, i, uint64(m.OriginNode)) i-- dAtA[i] = 0x28 @@ -4469,14 +4440,6 @@ func (m *Error) MarshalToSizedBuffer(dAtA []byte) (int, error) { i-- dAtA[i] = 0x22 } - i = encodeVarintErrors(dAtA, i, uint64(m.deprecatedTransactionRestart)) - i-- - dAtA[i] = 0x18 - i -= len(m.deprecatedMessage) - copy(dAtA[i:], m.deprecatedMessage) - i = encodeVarintErrors(dAtA, i, uint64(len(m.deprecatedMessage))) - i-- - dAtA[i] = 0xa return len(dAtA) - i, nil } @@ -5299,16 +5262,11 @@ func (m *Error) Size() (n int) { } var l int _ = l - l = len(m.deprecatedMessage) - n += 1 + l + sovErrors(uint64(l)) - n += 1 + sovErrors(uint64(m.deprecatedTransactionRestart)) if m.UnexposedTxn != nil { l = m.UnexposedTxn.Size() n += 1 + l + sovErrors(uint64(l)) } n += 1 + sovErrors(uint64(m.OriginNode)) - l = m.deprecatedDetail.Size() - n += 1 + l + sovErrors(uint64(l)) if m.Index != nil { l = m.Index.Size() n += 1 + l + sovErrors(uint64(l)) @@ -9694,57 +9652,6 @@ func (m *Error) Unmarshal(dAtA []byte) error { return fmt.Errorf("proto: Error: illegal tag %d (wire type %d)", fieldNum, wire) } switch fieldNum { - case 1: - if wireType != 2 { - return fmt.Errorf("proto: wrong wireType = %d for field deprecatedMessage", wireType) - } - var stringLen uint64 - for shift := uint(0); ; shift += 7 { - if shift >= 64 { - return ErrIntOverflowErrors - } - if iNdEx >= l { - return io.ErrUnexpectedEOF - } - b := dAtA[iNdEx] - iNdEx++ - stringLen |= uint64(b&0x7F) << shift - if b < 0x80 { - break - } - } - intStringLen := int(stringLen) - if intStringLen < 0 { - return ErrInvalidLengthErrors - } - postIndex := iNdEx + intStringLen - if postIndex < 0 { - return ErrInvalidLengthErrors - } - if postIndex > l { - return io.ErrUnexpectedEOF - } - m.deprecatedMessage = string(dAtA[iNdEx:postIndex]) - iNdEx = postIndex - case 3: - if wireType != 0 { - return fmt.Errorf("proto: wrong wireType = %d for field deprecatedTransactionRestart", wireType) - } - m.deprecatedTransactionRestart = 0 - for shift := uint(0); ; shift += 7 { - if shift >= 64 { - return ErrIntOverflowErrors - } - if iNdEx >= l { - return io.ErrUnexpectedEOF - } - b := dAtA[iNdEx] - iNdEx++ - m.deprecatedTransactionRestart |= TransactionRestart(b&0x7F) << shift - if b < 0x80 { - break - } - } case 4: if wireType != 2 { return fmt.Errorf("proto: wrong wireType = %d for field UnexposedTxn", wireType) @@ -9800,39 +9707,6 @@ func (m *Error) Unmarshal(dAtA []byte) error { break } } - case 6: - if wireType != 2 { - return fmt.Errorf("proto: wrong wireType = %d for field deprecatedDetail", wireType) - } - var msglen int - for shift := uint(0); ; shift += 7 { - if shift >= 64 { - return ErrIntOverflowErrors - } - if iNdEx >= l { - return io.ErrUnexpectedEOF - } - b := dAtA[iNdEx] - iNdEx++ - msglen |= int(b&0x7F) << shift - if b < 0x80 { - break - } - } - if msglen < 0 { - return ErrInvalidLengthErrors - } - postIndex := iNdEx + msglen - if postIndex < 0 { - return ErrInvalidLengthErrors - } - if postIndex > l { - return io.ErrUnexpectedEOF - } - if err := m.deprecatedDetail.Unmarshal(dAtA[iNdEx:postIndex]); err != nil { - return err - } - iNdEx = postIndex case 7: if wireType != 2 { return fmt.Errorf("proto: wrong wireType = %d for field Index", wireType) diff --git a/pkg/roachpb/errors.proto b/pkg/roachpb/errors.proto index cb4e10969591..8162f0da3e8a 100644 --- a/pkg/roachpb/errors.proto +++ b/pkg/roachpb/errors.proto @@ -620,17 +620,6 @@ message ErrPosition { message Error { option (gogoproto.goproto_stringer) = false; - // message is a human-readable error message. - // - // DEPRECATED. - optional string message = 1 [(gogoproto.nullable) = false, (gogoproto.customname) = "deprecatedMessage"]; - - // If transaction_restart is not NONE, the error condition may be handled by - // restarting the transaction. - // - // DEPRECATED. - optional TransactionRestart transaction_restart = 3 [(gogoproto.nullable) = false, (gogoproto.customname) = "deprecatedTransactionRestart"]; - // An optional updated transaction. This is to be used by the client in case // of retryable errors. // @@ -640,12 +629,6 @@ message Error { // Node at which the error was generated (zero if does not apply). optional int32 origin_node = 5 [(gogoproto.nullable) = false, (gogoproto.casttype) = "NodeID"]; - // If an ErrorDetail is present, it may contain additional structured data - // about the error. - // - // DEPRECATED - consult encoded_error instead. - optional ErrorDetail detail = 6 [(gogoproto.nullable) = false, (gogoproto.customname) = "deprecatedDetail"]; - // encoded_error is the Go error that caused this Error. optional errorspb.EncodedError encoded_error = 9 [(gogoproto.nullable) = false]; diff --git a/pkg/roachpb/errors_test.go b/pkg/roachpb/errors_test.go index 697a90bc0ba5..4eaaca629038 100644 --- a/pkg/roachpb/errors_test.go +++ b/pkg/roachpb/errors_test.go @@ -16,6 +16,7 @@ import ( "github.com/cockroachdb/cockroach/pkg/storage/enginepb" "github.com/cockroachdb/cockroach/pkg/util/hlc" + "github.com/cockroachdb/cockroach/pkg/util/protoutil" "github.com/cockroachdb/cockroach/pkg/util/uuid" "github.com/cockroachdb/errors" "github.com/cockroachdb/redact" @@ -158,27 +159,21 @@ func TestErrorRedaction(t *testing.T) { }) } -func TestErrorDeprecatedFields(t *testing.T) { - // Verify that deprecated fields are populated and queried correctly. +func TestErrorEncodingRoundTrip(t *testing.T) { + // Smoke check that encoding-decoding cycles don't lose or perturb information. - t.Run("unstructured", func(t *testing.T) { + t.Run("missing-encoded-error", func(t *testing.T) { err := errors.New("I am an error") pErr := NewError(err) pErr.EncodedError.Reset() - - require.Equal(t, err.Error(), pErr.String()) - require.IsType(t, &internalError{}, pErr.GoError()) - require.Equal(t, err.Error(), pErr.GoError().Error()) - require.Equal(t, err.Error(), pErr.deprecatedMessage) - require.Equal(t, TransactionRestart_NONE, pErr.deprecatedTransactionRestart) - require.Nil(t, pErr.deprecatedDetail.Value) + err = pErr.GoError() + require.True(t, errors.IsAssertionFailure(err), "%+v", err) }) txn := MakeTransaction("foo", Key("k"), 0, hlc.Timestamp{WallTime: 1}, 50000) t.Run("structured-wrapped", func(t *testing.T) { - // For extra spice, wrap the structured error. This ensures - // that we populate the deprecated fields even when - // the error detail is not the head of the error chain. + // Check that structured errors can be interpreted, even when they are + // wrapped. err := NewReadWithinUncertaintyIntervalError( hlc.Timestamp{WallTime: 1}, hlc.Timestamp{WallTime: 2}, @@ -189,15 +184,34 @@ func TestErrorDeprecatedFields(t *testing.T) { pErr := NewError(errors.Wrap(err, "foo")) // Quick check that the detail round-trips when EncodedError is still there. require.EqualValues(t, err, pErr.GetDetail()) + // A ReadWithinUncertaintyIntervalError wants an immediate restart. + require.Equal(t, TransactionRestart_IMMEDIATE, pErr.TransactionRestart()) - pErr.EncodedError.Reset() - + // Txn retry errors are wrapped in an UnhandledRetryableError in Error.GoError, + // so this is more proof that the error round-tripped just fine. var ure *UnhandledRetryableError require.True(t, errors.As(pErr.GoError(), &ure)) require.Equal(t, &ure.PErr, pErr) require.Contains(t, pErr.GoError().Error(), err.Error()) require.EqualValues(t, err, pErr.GetDetail()) - require.Equal(t, TransactionRestart_IMMEDIATE, pErr.deprecatedTransactionRestart) + }) + + t.Run("roundtrip-loses-info", func(t *testing.T) { + // Documents that the pErr -> error -> pErr conversion is lossy. This is + // also documented on Error.GoError. + qErr := func() *Error { + pErr := NewErrorf("foo") + pErr.SetTxn(&txn) + pErr.SetErrorIndex(123) + pErr.OriginNode = 321 + pErr.Now.WallTime++ + return NewError(pErr.GoError()) + }() + + require.Zero(t, qErr.GetTxn()) + require.Zero(t, qErr.Index) + require.Zero(t, qErr.OriginNode) + require.Zero(t, qErr.Now) }) } @@ -215,3 +229,15 @@ func TestErrorGRPCStatus(t *testing.T) { require.Equal(t, s.Code(), decoded.Code()) require.Equal(t, s.Message(), decoded.Message()) } + +func TestErrorToJsonPB(t *testing.T) { + // Verify that Error can marshal to JSON without blowing up. + jsonpb := protoutil.JSONPb{ + Indent: " ", + } + pErr := NewErrorf("foo") + require.NotPanics(t, func() { + _, err := jsonpb.Marshal(pErr) + require.NoError(t, err) + }) +}