From 6027abefe3fe54181ad6eb389419303a22e6b8f6 Mon Sep 17 00:00:00 2001 From: Lukasz Klimek <842586+lklimek@users.noreply.github.com> Date: Wed, 15 Jan 2025 16:35:53 +0100 Subject: [PATCH] chore: FinalizeSnapshot implemented, not tested --- abci/client/grpc_client.go | 4 + abci/client/mocks/client.go | 59 +++ abci/client/routed_client.go | 5 + abci/client/socket_client.go | 8 + abci/types/application.go | 6 + abci/types/messages.go | 6 + abci/types/mocks/application.go | 59 +++ abci/types/types.pb.go | 513 ++++++++++++---------- internal/statesync/mocks/stateprovider.go | 59 +++ internal/statesync/stateprovider.go | 16 + internal/statesync/syncer.go | 34 +- proto/tendermint/abci/types.proto | 1 + spec/abci++/api.md | 1 + 13 files changed, 529 insertions(+), 242 deletions(-) diff --git a/abci/client/grpc_client.go b/abci/client/grpc_client.go index 0ffed9b399..d8e57bd45e 100644 --- a/abci/client/grpc_client.go +++ b/abci/client/grpc_client.go @@ -255,6 +255,10 @@ func (cli *grpcClient) ApplySnapshotChunk(ctx context.Context, params *types.Req return cli.client.ApplySnapshotChunk(ctx, types.ToRequestApplySnapshotChunk(params).GetApplySnapshotChunk(), grpc.WaitForReady(true)) } +func (cli *grpcClient) FinalizeSnapshot(ctx context.Context, params *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error) { + return cli.client.FinalizeSnapshot(ctx, types.ToRequestFinalizeSnapshot(params).GetFinalizeSnapshot(), grpc.WaitForReady(true)) +} + func (cli *grpcClient) PrepareProposal(ctx context.Context, params *types.RequestPrepareProposal) (*types.ResponsePrepareProposal, error) { return cli.client.PrepareProposal(ctx, types.ToRequestPrepareProposal(params).GetPrepareProposal(), grpc.WaitForReady(true)) } diff --git a/abci/client/mocks/client.go b/abci/client/mocks/client.go index 7c2d062858..9994b266df 100644 --- a/abci/client/mocks/client.go +++ b/abci/client/mocks/client.go @@ -362,6 +362,65 @@ func (_c *Client_FinalizeBlock_Call) RunAndReturn(run func(context.Context, *typ return _c } +// FinalizeSnapshot provides a mock function with given fields: _a0, _a1 +func (_m *Client) FinalizeSnapshot(_a0 context.Context, _a1 *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error) { + ret := _m.Called(_a0, _a1) + + if len(ret) == 0 { + panic("no return value specified for FinalizeSnapshot") + } + + var r0 *types.ResponseFinalizeSnapshot + var r1 error + if rf, ok := ret.Get(0).(func(context.Context, *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error)); ok { + return rf(_a0, _a1) + } + if rf, ok := ret.Get(0).(func(context.Context, *types.RequestFinalizeSnapshot) *types.ResponseFinalizeSnapshot); ok { + r0 = rf(_a0, _a1) + } else { + if ret.Get(0) != nil { + r0 = ret.Get(0).(*types.ResponseFinalizeSnapshot) + } + } + + if rf, ok := ret.Get(1).(func(context.Context, *types.RequestFinalizeSnapshot) error); ok { + r1 = rf(_a0, _a1) + } else { + r1 = ret.Error(1) + } + + return r0, r1 +} + +// Client_FinalizeSnapshot_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'FinalizeSnapshot' +type Client_FinalizeSnapshot_Call struct { + *mock.Call +} + +// FinalizeSnapshot is a helper method to define mock.On call +// - _a0 context.Context +// - _a1 *types.RequestFinalizeSnapshot +func (_e *Client_Expecter) FinalizeSnapshot(_a0 interface{}, _a1 interface{}) *Client_FinalizeSnapshot_Call { + return &Client_FinalizeSnapshot_Call{Call: _e.mock.On("FinalizeSnapshot", _a0, _a1)} +} + +func (_c *Client_FinalizeSnapshot_Call) Run(run func(_a0 context.Context, _a1 *types.RequestFinalizeSnapshot)) *Client_FinalizeSnapshot_Call { + _c.Call.Run(func(args mock.Arguments) { + run(args[0].(context.Context), args[1].(*types.RequestFinalizeSnapshot)) + }) + return _c +} + +func (_c *Client_FinalizeSnapshot_Call) Return(_a0 *types.ResponseFinalizeSnapshot, _a1 error) *Client_FinalizeSnapshot_Call { + _c.Call.Return(_a0, _a1) + return _c +} + +func (_c *Client_FinalizeSnapshot_Call) RunAndReturn(run func(context.Context, *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error)) *Client_FinalizeSnapshot_Call { + _c.Call.Return(run) + return _c +} + // Flush provides a mock function with given fields: _a0 func (_m *Client) Flush(_a0 context.Context) error { ret := _m.Called(_a0) diff --git a/abci/client/routed_client.go b/abci/client/routed_client.go index fa1afc1bc3..2bc4a8aac1 100644 --- a/abci/client/routed_client.go +++ b/abci/client/routed_client.go @@ -351,6 +351,11 @@ func (cli *routedClient) ApplySnapshotChunk(ctx context.Context, req *types.Requ return result.(*types.ResponseApplySnapshotChunk), err } +func (cli *routedClient) FinalizeSnapshot(ctx context.Context, req *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error) { + result, err := cli.delegate(ctx, req) + return result.(*types.ResponseFinalizeSnapshot), err +} + func (cli *routedClient) PrepareProposal(ctx context.Context, req *types.RequestPrepareProposal) (*types.ResponsePrepareProposal, error) { result, err := cli.delegate(ctx, req) return result.(*types.ResponsePrepareProposal), err diff --git a/abci/client/socket_client.go b/abci/client/socket_client.go index fb046187d8..e80fe9d998 100644 --- a/abci/client/socket_client.go +++ b/abci/client/socket_client.go @@ -357,6 +357,14 @@ func (cli *socketClient) ApplySnapshotChunk(ctx context.Context, req *types.Requ return res.GetApplySnapshotChunk(), nil } +func (cli *socketClient) FinalizeSnapshot(ctx context.Context, req *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error) { + res, err := cli.doRequest(ctx, types.ToRequestFinalizeSnapshot(req)) + if err != nil { + return nil, err + } + return res.GetFinalizeSnapshot(), nil +} + func (cli *socketClient) PrepareProposal(ctx context.Context, req *types.RequestPrepareProposal) (*types.ResponsePrepareProposal, error) { res, err := cli.doRequest(ctx, types.ToRequestPrepareProposal(req)) if err != nil { diff --git a/abci/types/application.go b/abci/types/application.go index fe7b60bca4..9000d8a884 100644 --- a/abci/types/application.go +++ b/abci/types/application.go @@ -16,6 +16,8 @@ type StateSyncer interface { LoadSnapshotChunk(context.Context, *RequestLoadSnapshotChunk) (*ResponseLoadSnapshotChunk, error) // ApplySnapshotChunk applies a chunk of snapshot ApplySnapshotChunk(context.Context, *RequestApplySnapshotChunk) (*ResponseApplySnapshotChunk, error) + // FinalizeSnapshot sends light block to ABCI app after successful state sync + FinalizeSnapshot(context.Context, *RequestFinalizeSnapshot) (*ResponseFinalizeSnapshot, error) } // Application is an interface that enables any finite, deterministic state machine @@ -97,6 +99,10 @@ func (BaseApplication) ApplySnapshotChunk(_ context.Context, _req *RequestApplyS return &ResponseApplySnapshotChunk{}, nil } +func (BaseApplication) FinalizeSnapshot(_ context.Context, _req *RequestFinalizeSnapshot) (*ResponseFinalizeSnapshot, error) { + return &ResponseFinalizeSnapshot{}, nil +} + func (BaseApplication) PrepareProposal(_ context.Context, req *RequestPrepareProposal) (*ResponsePrepareProposal, error) { trs := make([]*TxRecord, 0, len(req.Txs)) var totalBytes int64 diff --git a/abci/types/messages.go b/abci/types/messages.go index 4a749fc83a..5c058a791e 100644 --- a/abci/types/messages.go +++ b/abci/types/messages.go @@ -87,6 +87,12 @@ func ToRequestApplySnapshotChunk(req *RequestApplySnapshotChunk) *Request { } } +func ToRequestFinalizeSnapshot(req *RequestFinalizeSnapshot) *Request { + return &Request{ + Value: &Request_FinalizeSnapshot{req}, + } +} + func ToRequestExtendVote(req *RequestExtendVote) *Request { return &Request{ Value: &Request_ExtendVote{req}, diff --git a/abci/types/mocks/application.go b/abci/types/mocks/application.go index 1a706370d6..5e0404ee5a 100644 --- a/abci/types/mocks/application.go +++ b/abci/types/mocks/application.go @@ -258,6 +258,65 @@ func (_c *Application_FinalizeBlock_Call) RunAndReturn(run func(context.Context, return _c } +// FinalizeSnapshot provides a mock function with given fields: _a0, _a1 +func (_m *Application) FinalizeSnapshot(_a0 context.Context, _a1 *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error) { + ret := _m.Called(_a0, _a1) + + if len(ret) == 0 { + panic("no return value specified for FinalizeSnapshot") + } + + var r0 *types.ResponseFinalizeSnapshot + var r1 error + if rf, ok := ret.Get(0).(func(context.Context, *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error)); ok { + return rf(_a0, _a1) + } + if rf, ok := ret.Get(0).(func(context.Context, *types.RequestFinalizeSnapshot) *types.ResponseFinalizeSnapshot); ok { + r0 = rf(_a0, _a1) + } else { + if ret.Get(0) != nil { + r0 = ret.Get(0).(*types.ResponseFinalizeSnapshot) + } + } + + if rf, ok := ret.Get(1).(func(context.Context, *types.RequestFinalizeSnapshot) error); ok { + r1 = rf(_a0, _a1) + } else { + r1 = ret.Error(1) + } + + return r0, r1 +} + +// Application_FinalizeSnapshot_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'FinalizeSnapshot' +type Application_FinalizeSnapshot_Call struct { + *mock.Call +} + +// FinalizeSnapshot is a helper method to define mock.On call +// - _a0 context.Context +// - _a1 *types.RequestFinalizeSnapshot +func (_e *Application_Expecter) FinalizeSnapshot(_a0 interface{}, _a1 interface{}) *Application_FinalizeSnapshot_Call { + return &Application_FinalizeSnapshot_Call{Call: _e.mock.On("FinalizeSnapshot", _a0, _a1)} +} + +func (_c *Application_FinalizeSnapshot_Call) Run(run func(_a0 context.Context, _a1 *types.RequestFinalizeSnapshot)) *Application_FinalizeSnapshot_Call { + _c.Call.Run(func(args mock.Arguments) { + run(args[0].(context.Context), args[1].(*types.RequestFinalizeSnapshot)) + }) + return _c +} + +func (_c *Application_FinalizeSnapshot_Call) Return(_a0 *types.ResponseFinalizeSnapshot, _a1 error) *Application_FinalizeSnapshot_Call { + _c.Call.Return(_a0, _a1) + return _c +} + +func (_c *Application_FinalizeSnapshot_Call) RunAndReturn(run func(context.Context, *types.RequestFinalizeSnapshot) (*types.ResponseFinalizeSnapshot, error)) *Application_FinalizeSnapshot_Call { + _c.Call.Return(run) + return _c +} + // Info provides a mock function with given fields: _a0, _a1 func (_m *Application) Info(_a0 context.Context, _a1 *types.RequestInfo) (*types.ResponseInfo, error) { ret := _m.Called(_a0, _a1) diff --git a/abci/types/types.pb.go b/abci/types/types.pb.go index f157a7c808..9855779aef 100644 --- a/abci/types/types.pb.go +++ b/abci/types/types.pb.go @@ -4485,244 +4485,245 @@ func init() { func init() { proto.RegisterFile("tendermint/abci/types.proto", fileDescriptor_252557cfdd89a31a) } var fileDescriptor_252557cfdd89a31a = []byte{ - // 3779 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xd4, 0x5b, 0x4b, 0x70, 0x1b, 0x47, - 0x73, 0xc6, 0xe2, 0x8d, 0xc6, 0x6b, 0x39, 0xa4, 0x24, 0x08, 0x92, 0x48, 0xfe, 0xab, 0xf8, 0x97, - 0x2c, 0xdb, 0xa4, 0x2d, 0xc5, 0x96, 0x1d, 0xdb, 0xa9, 0x02, 0x41, 0x28, 0x20, 0x45, 0x91, 0xf4, - 0x12, 0xa4, 0xec, 0x38, 0xf6, 0xd6, 0x12, 0x18, 0x12, 0x6b, 0x01, 0xd8, 0xf5, 0xee, 0x82, 0x02, - 0x7d, 0x4d, 0x52, 0x95, 0xf2, 0xc9, 0xf7, 0x94, 0x6f, 0xc9, 0x31, 0xf7, 0x9c, 0x92, 0x63, 0x9c, - 0xca, 0xc5, 0xc7, 0x54, 0xa5, 0xa2, 0xb8, 0xe4, 0x5b, 0x6e, 0x3e, 0xe5, 0x92, 0x43, 0x6a, 0x1e, - 0xfb, 0x04, 0x16, 0x0f, 0xcb, 0x55, 0xa9, 0xff, 0x86, 0xe9, 0xe9, 0xee, 0x9d, 0x47, 0x4f, 0x77, - 0xcf, 0xd7, 0x03, 0xb8, 0x61, 0xe3, 0x41, 0x07, 0x9b, 0x7d, 0x6d, 0x60, 0x6f, 0xaa, 0xa7, 0x6d, - 0x6d, 0xd3, 0xbe, 0x34, 0xb0, 0xb5, 0x61, 0x98, 0xba, 0xad, 0xa3, 0xb2, 0xd7, 0xb9, 0x41, 0x3a, - 0xab, 0xb7, 0x7c, 0xdc, 0x6d, 0xf3, 0xd2, 0xb0, 0xf5, 0x4d, 0xc3, 0xd4, 0xf5, 0x33, 0xc6, 0x5f, - 0xf5, 0x2b, 0xa3, 0x7a, 0x36, 0x3b, 0xaa, 0xd5, 0xe5, 0x9d, 0x37, 0xc7, 0x3a, 0x4f, 0x7b, 0x7a, - 0xfb, 0x59, 0x64, 0xaf, 0x6f, 0x20, 0x81, 0x5e, 0xfe, 0xdd, 0x67, 0xf8, 0xd2, 0xe9, 0xbd, 0x35, - 0x26, 0x6b, 0xa8, 0xa6, 0xda, 0x77, 0xba, 0x57, 0x7d, 0xdd, 0x17, 0xd8, 0xb4, 0x34, 0x7d, 0x10, - 0x50, 0xbe, 0x76, 0xae, 0xeb, 0xe7, 0x3d, 0xbc, 0x49, 0x5b, 0xa7, 0xc3, 0xb3, 0x4d, 0x5b, 0xeb, - 0x63, 0xcb, 0x56, 0xfb, 0x06, 0x67, 0x58, 0x39, 0xd7, 0xcf, 0x75, 0xfa, 0x73, 0x93, 0xfc, 0x62, - 0x54, 0xe9, 0x45, 0x0e, 0x32, 0x32, 0xfe, 0x7a, 0x88, 0x2d, 0x1b, 0xdd, 0x87, 0x24, 0x6e, 0x77, - 0xf5, 0x8a, 0xb0, 0x2e, 0xdc, 0xcd, 0xdf, 0xbf, 0xb9, 0x11, 0x5a, 0xb7, 0x0d, 0xce, 0xd7, 0x68, - 0x77, 0xf5, 0x66, 0x4c, 0xa6, 0xbc, 0xe8, 0x5d, 0x48, 0x9d, 0xf5, 0x86, 0x56, 0xb7, 0x12, 0xa7, - 0x42, 0xb7, 0xa2, 0x84, 0x1e, 0x11, 0xa6, 0x66, 0x4c, 0x66, 0xdc, 0xe4, 0x53, 0xda, 0xe0, 0x4c, - 0xaf, 0x24, 0xa6, 0x7f, 0x6a, 0x67, 0x70, 0x46, 0x3f, 0x45, 0x78, 0xd1, 0x16, 0x80, 0x36, 0xd0, - 0x6c, 0xa5, 0xdd, 0x55, 0xb5, 0x41, 0x25, 0x49, 0x25, 0x7f, 0x17, 0x2d, 0xa9, 0xd9, 0x75, 0xc2, - 0xd8, 0x8c, 0xc9, 0x39, 0xcd, 0x69, 0x90, 0xe1, 0x7e, 0x3d, 0xc4, 0xe6, 0x65, 0x25, 0x35, 0x7d, - 0xb8, 0x9f, 0x10, 0x26, 0x32, 0x5c, 0xca, 0x8d, 0x3e, 0x82, 0x6c, 0xbb, 0x8b, 0xdb, 0xcf, 0x14, - 0x7b, 0x54, 0xc9, 0x50, 0xc9, 0xb5, 0x28, 0xc9, 0x3a, 0xe1, 0x6b, 0x8d, 0x9a, 0x31, 0x39, 0xd3, - 0x66, 0x3f, 0xd1, 0x3e, 0x94, 0x7a, 0x9a, 0x65, 0x2b, 0xd6, 0x40, 0x35, 0xac, 0xae, 0x6e, 0x5b, - 0x95, 0x3c, 0xd5, 0xf1, 0x5a, 0x94, 0x8e, 0x3d, 0xcd, 0xb2, 0x8f, 0x1c, 0xe6, 0x66, 0x4c, 0x2e, - 0xf6, 0xfc, 0x04, 0xa2, 0x4f, 0x3f, 0x3b, 0xc3, 0xa6, 0xab, 0xb0, 0x52, 0x98, 0xae, 0xef, 0x80, - 0x70, 0x3b, 0xf2, 0x44, 0x9f, 0xee, 0x27, 0xa0, 0xcf, 0x61, 0xb9, 0xa7, 0xab, 0x1d, 0x57, 0x9d, - 0xd2, 0xee, 0x0e, 0x07, 0xcf, 0x2a, 0x45, 0xaa, 0xf4, 0xf5, 0xc8, 0x41, 0xea, 0x6a, 0xc7, 0x51, - 0x51, 0x27, 0x02, 0xcd, 0x98, 0xbc, 0xd4, 0x0b, 0x13, 0xd1, 0x97, 0xb0, 0xa2, 0x1a, 0x46, 0xef, - 0x32, 0xac, 0xbd, 0x44, 0xb5, 0xdf, 0x8b, 0xd2, 0x5e, 0x23, 0x32, 0x61, 0xf5, 0x48, 0x1d, 0xa3, - 0xa2, 0xa7, 0xb0, 0x74, 0xa6, 0x0d, 0xd4, 0x9e, 0xf6, 0x0d, 0xf6, 0xd6, 0x63, 0x85, 0x2a, 0xbf, - 0x1b, 0x69, 0x8c, 0x5c, 0xc0, 0xb7, 0x24, 0xe2, 0x59, 0x88, 0x86, 0x5a, 0x20, 0x1a, 0x26, 0x36, - 0x54, 0x13, 0x2b, 0x86, 0xa9, 0x1b, 0xba, 0xa5, 0xf6, 0x2a, 0x65, 0xaa, 0xf7, 0x4e, 0x94, 0xde, - 0x43, 0xc6, 0x7f, 0xc8, 0xd9, 0x9b, 0x31, 0xb9, 0x6c, 0x04, 0x49, 0x4c, 0xab, 0xde, 0xc6, 0x96, - 0xe5, 0x69, 0x15, 0x67, 0x69, 0xa5, 0xfc, 0x41, 0xad, 0x01, 0x12, 0x6a, 0x40, 0x1e, 0x8f, 0x88, - 0xb8, 0x72, 0xa1, 0xdb, 0xb8, 0xb2, 0x44, 0x15, 0x4a, 0x91, 0x07, 0x98, 0xb2, 0x9e, 0xe8, 0x36, - 0x6e, 0xc6, 0x64, 0xc0, 0x6e, 0x0b, 0xa9, 0x70, 0xe5, 0x02, 0x9b, 0xda, 0xd9, 0x25, 0x55, 0xa3, - 0xd0, 0x1e, 0xe2, 0x68, 0x2a, 0x88, 0x2a, 0x7c, 0x23, 0x4a, 0xe1, 0x09, 0x15, 0x22, 0x2a, 0x1a, - 0x8e, 0x48, 0x33, 0x26, 0x2f, 0x5f, 0x8c, 0x93, 0x89, 0xed, 0xba, 0xdb, 0x45, 0x3d, 0x67, 0x65, - 0x79, 0xba, 0xed, 0x3a, 0x7b, 0xb5, 0x45, 0x98, 0x89, 0xed, 0x9e, 0xf9, 0x09, 0x5b, 0x19, 0x48, - 0x5d, 0xa8, 0xbd, 0x21, 0xde, 0x4d, 0x66, 0xd3, 0x62, 0x66, 0x37, 0x99, 0xcd, 0x8a, 0xb9, 0xdd, - 0x64, 0x36, 0x27, 0xc2, 0x6e, 0x32, 0x0b, 0x62, 0x5e, 0xba, 0x03, 0x79, 0x9f, 0xdf, 0x42, 0x15, - 0xc8, 0xf4, 0xb1, 0x65, 0xa9, 0xe7, 0x98, 0xba, 0xb9, 0x9c, 0xec, 0x34, 0xa5, 0x12, 0x14, 0xfc, - 0xbe, 0x4a, 0xfa, 0x4e, 0x70, 0x25, 0x89, 0x1b, 0x22, 0x92, 0xdc, 0xef, 0x3a, 0x92, 0xbc, 0x89, - 0x6e, 0x43, 0x91, 0x4e, 0x45, 0x71, 0xfa, 0x89, 0x2f, 0x4c, 0xca, 0x05, 0x4a, 0x3c, 0xe1, 0x4c, - 0x6b, 0x90, 0x37, 0xee, 0x1b, 0x2e, 0x4b, 0x82, 0xb2, 0x80, 0x71, 0xdf, 0x70, 0x18, 0x7e, 0x07, - 0x05, 0x32, 0x6f, 0x97, 0x23, 0x49, 0x3f, 0x92, 0x27, 0x34, 0xce, 0x22, 0xfd, 0x55, 0x02, 0xc4, - 0xb0, 0x7f, 0x43, 0xef, 0x43, 0x92, 0xb8, 0x7a, 0xee, 0xb5, 0xab, 0x1b, 0x2c, 0x0e, 0x6c, 0x38, - 0x71, 0x60, 0xa3, 0xe5, 0xc4, 0x81, 0xad, 0xec, 0x0f, 0x2f, 0xd6, 0x62, 0xdf, 0xfd, 0xd7, 0x9a, - 0x20, 0x53, 0x09, 0x74, 0x9d, 0x78, 0x35, 0x55, 0x1b, 0x28, 0x5a, 0x87, 0x0e, 0x39, 0x47, 0x5c, - 0x96, 0xaa, 0x0d, 0x76, 0x3a, 0x68, 0x0f, 0xc4, 0xb6, 0x3e, 0xb0, 0xf0, 0xc0, 0x1a, 0x5a, 0x0a, - 0x8b, 0x43, 0xdc, 0x57, 0x07, 0x3c, 0x2e, 0x0b, 0x40, 0x75, 0x87, 0xf3, 0x90, 0x32, 0xca, 0xe5, - 0x76, 0x90, 0x80, 0xf6, 0xa1, 0x78, 0xa1, 0xf6, 0xb4, 0x8e, 0x6a, 0xeb, 0xa6, 0x62, 0x61, 0x9b, - 0x3b, 0xef, 0xdb, 0x63, 0x7b, 0x7e, 0xe2, 0x70, 0x1d, 0x61, 0xfb, 0xd8, 0xe8, 0xa8, 0x36, 0xde, - 0x4a, 0xfe, 0xf0, 0x62, 0x4d, 0x90, 0x0b, 0x17, 0xbe, 0x1e, 0xf4, 0x7b, 0x28, 0xab, 0x86, 0xa1, - 0x58, 0xb6, 0x6a, 0x63, 0xe5, 0xf4, 0xd2, 0xc6, 0x16, 0xf5, 0xe7, 0x05, 0xb9, 0xa8, 0x1a, 0xc6, - 0x11, 0xa1, 0x6e, 0x11, 0x22, 0x7a, 0x0d, 0x4a, 0xc4, 0xf5, 0x6b, 0x6a, 0x4f, 0xe9, 0x62, 0xed, - 0xbc, 0x6b, 0x57, 0xd2, 0xeb, 0xc2, 0xdd, 0x84, 0x5c, 0xe4, 0xd4, 0x26, 0x25, 0xa2, 0x0d, 0x58, - 0x76, 0xd8, 0xda, 0xba, 0x89, 0x1d, 0x5e, 0xe2, 0xe8, 0x8b, 0xf2, 0x12, 0xef, 0xaa, 0xeb, 0x26, - 0x66, 0xfc, 0x52, 0xc7, 0xb5, 0x14, 0x1a, 0x26, 0x10, 0x82, 0x64, 0x47, 0xb5, 0x55, 0xba, 0x03, - 0x05, 0x99, 0xfe, 0x26, 0x34, 0x43, 0xb5, 0xbb, 0x7c, 0x5d, 0xe9, 0x6f, 0x74, 0x15, 0xd2, 0x5c, - 0x75, 0x82, 0x0e, 0x83, 0xb7, 0xd0, 0x0a, 0xa4, 0x0c, 0x53, 0xbf, 0xc0, 0x74, 0x59, 0xb2, 0x32, - 0x6b, 0x48, 0x32, 0x94, 0x82, 0x21, 0x05, 0x95, 0x20, 0x6e, 0x8f, 0xf8, 0x57, 0xe2, 0xf6, 0x08, - 0xbd, 0x0d, 0x49, 0xb2, 0x01, 0xf4, 0x1b, 0xa5, 0x09, 0x41, 0x94, 0xcb, 0xb5, 0x2e, 0x0d, 0x2c, - 0x53, 0x4e, 0xe9, 0x2a, 0xac, 0x4c, 0x0a, 0x31, 0x52, 0xd7, 0xa5, 0x07, 0x42, 0x05, 0x7a, 0x17, - 0xb2, 0xae, 0x4f, 0x65, 0xf6, 0x75, 0x7d, 0xec, 0x2b, 0x0e, 0xb3, 0xec, 0xb2, 0x12, 0xc3, 0x22, - 0xfb, 0xd3, 0x55, 0x79, 0x5e, 0x50, 0x90, 0x33, 0xaa, 0x61, 0x34, 0x55, 0xab, 0x2b, 0x9d, 0x43, - 0x25, 0x2a, 0x7e, 0xf8, 0xd6, 0x47, 0xa0, 0xa7, 0xc3, 0x59, 0x1f, 0xdf, 0xc9, 0x8b, 0xd3, 0x3d, - 0x71, 0x4f, 0x1e, 0xb5, 0xe0, 0xe1, 0xe0, 0x19, 0xb1, 0xe0, 0x04, 0xfb, 0x10, 0x6d, 0xef, 0x74, - 0xa4, 0x0e, 0x5c, 0x8f, 0x0c, 0x25, 0x01, 0x39, 0x21, 0x20, 0x47, 0x36, 0x83, 0x05, 0x28, 0x36, - 0x70, 0xd6, 0x20, 0x43, 0xb3, 0xe8, 0xbc, 0xe9, 0x67, 0x72, 0x32, 0x6f, 0x49, 0x9f, 0xc2, 0xb5, - 0x88, 0x98, 0x82, 0x3e, 0x86, 0x7c, 0x8f, 0x0c, 0x9f, 0xbb, 0xb9, 0x09, 0x49, 0x15, 0x3b, 0x3d, - 0x7b, 0x84, 0x89, 0x3a, 0x33, 0x19, 0x7a, 0xee, 0x6f, 0xe9, 0x97, 0x24, 0x5c, 0x9d, 0x1c, 0x56, - 0xd0, 0x3a, 0x14, 0xfa, 0xea, 0x48, 0xb1, 0x47, 0xdc, 0xf6, 0x05, 0x6a, 0x4d, 0xd0, 0x57, 0x47, - 0xad, 0x11, 0x33, 0x7c, 0x11, 0x12, 0xf6, 0xc8, 0xaa, 0xc4, 0xd7, 0x13, 0x77, 0x0b, 0x32, 0xf9, - 0x89, 0x9e, 0xc0, 0x52, 0x4f, 0x6f, 0xab, 0x3d, 0xa5, 0xa7, 0x5a, 0xb6, 0xd2, 0xd6, 0xfb, 0x7d, - 0xcd, 0xe6, 0x27, 0xfa, 0xc6, 0xb8, 0xe1, 0xd0, 0x6e, 0xe2, 0xf5, 0xe8, 0xf1, 0x8b, 0xc9, 0x65, - 0x2a, 0xbb, 0xa7, 0x5a, 0x36, 0xeb, 0x42, 0xdb, 0x90, 0xef, 0x6b, 0xd6, 0x29, 0xee, 0xaa, 0x17, - 0x9a, 0x6e, 0x56, 0x92, 0xeb, 0x89, 0x89, 0x69, 0xdc, 0x13, 0x8f, 0x87, 0x6b, 0xf2, 0x8b, 0xf9, - 0x36, 0x3c, 0x15, 0x38, 0x10, 0x8e, 0x4b, 0x4b, 0x2f, 0xec, 0xd2, 0xde, 0x86, 0x95, 0x01, 0x1e, - 0xd9, 0x8a, 0xeb, 0x2e, 0x2c, 0x66, 0x85, 0x19, 0xba, 0x99, 0x88, 0xf4, 0xb9, 0x3e, 0xc6, 0x22, - 0x06, 0x49, 0xf6, 0xdb, 0xd4, 0x87, 0x83, 0x4e, 0x25, 0xbb, 0x2e, 0xdc, 0x4d, 0xc9, 0xac, 0x81, - 0x1e, 0x42, 0x85, 0xba, 0x02, 0xe6, 0x1f, 0xc9, 0x86, 0xe0, 0x8e, 0xe3, 0x17, 0x72, 0xd4, 0x06, - 0xaf, 0x90, 0x7e, 0xea, 0x81, 0xf7, 0x68, 0x2f, 0xf7, 0x25, 0x9b, 0xb0, 0xc2, 0xe2, 0x3a, 0x36, - 0x49, 0x80, 0x27, 0x9b, 0x44, 0x07, 0x00, 0x74, 0x00, 0x4b, 0x4e, 0xdf, 0xa1, 0xa9, 0xb7, 0x46, - 0xf4, 0xfb, 0x6f, 0xbb, 0x02, 0x1d, 0x85, 0x1c, 0x1a, 0xc7, 0xd2, 0xf3, 0xf4, 0x08, 0x20, 0xa7, - 0xaf, 0x66, 0xb8, 0x81, 0xe2, 0xa1, 0x77, 0x1c, 0x0a, 0xe3, 0x59, 0x2c, 0xef, 0xf2, 0x9c, 0xb2, - 0x77, 0x5a, 0xd6, 0x20, 0xff, 0xf5, 0x50, 0x37, 0x87, 0x7d, 0x36, 0xa4, 0x22, 0x1d, 0x12, 0x30, - 0x12, 0x3d, 0x9c, 0xff, 0x9c, 0xf2, 0xd9, 0x5c, 0x30, 0xc3, 0xe0, 0x16, 0x25, 0x78, 0x16, 0x75, - 0xe4, 0x1b, 0xb8, 0xdf, 0xa8, 0xe2, 0xf3, 0x1a, 0x95, 0x3b, 0xb7, 0x68, 0xbb, 0x4a, 0xfc, 0x3a, - 0xbb, 0x42, 0x90, 0xa4, 0x33, 0x4c, 0x32, 0x87, 0x4c, 0x7e, 0x47, 0xda, 0x9a, 0xbb, 0xff, 0x69, - 0xff, 0xfe, 0x3b, 0x16, 0x98, 0xf9, 0xcd, 0x2c, 0x30, 0x1b, 0x69, 0x81, 0xbf, 0xda, 0xd6, 0x5a, - 0x70, 0x35, 0x24, 0xa8, 0x0c, 0x69, 0xd0, 0xa4, 0xd6, 0x16, 0xba, 0xa3, 0x38, 0xa1, 0xda, 0xa7, - 0x48, 0x5e, 0x0e, 0xe8, 0x65, 0x01, 0x37, 0xd2, 0x82, 0xf3, 0x8b, 0x5a, 0x70, 0x61, 0x1e, 0x0b, - 0x2e, 0xbe, 0x8a, 0x05, 0x97, 0xc6, 0x2c, 0xf8, 0x18, 0x96, 0xc6, 0x92, 0x5c, 0xd7, 0x1c, 0x84, - 0x89, 0xe6, 0x10, 0x9f, 0x6c, 0x0e, 0x09, 0x9f, 0x39, 0x48, 0x3f, 0x09, 0x50, 0x8d, 0xce, 0x75, - 0x27, 0x7e, 0xe0, 0x1d, 0xb8, 0xe2, 0xe5, 0x3c, 0xfe, 0x75, 0x64, 0x71, 0x05, 0xb9, 0x9d, 0xde, - 0x42, 0x4e, 0xc9, 0x0f, 0xd8, 0x98, 0x92, 0x7e, 0x13, 0x7d, 0x02, 0xe5, 0x60, 0x96, 0x4e, 0x92, - 0x20, 0x72, 0x5c, 0xfe, 0x68, 0xec, 0xb8, 0x78, 0x6b, 0xe1, 0x8e, 0x59, 0x2e, 0x5d, 0xf8, 0x9b, - 0x96, 0xf4, 0x6f, 0x71, 0x37, 0x07, 0x08, 0xa4, 0xdc, 0xe8, 0x03, 0x48, 0xf3, 0x93, 0x2d, 0xcc, - 0x7b, 0xb2, 0xb9, 0x40, 0xf8, 0x34, 0xc7, 0x5f, 0xed, 0x34, 0x27, 0x26, 0x6e, 0x5f, 0x72, 0xf2, - 0x52, 0xa5, 0xfc, 0x4b, 0xf5, 0x16, 0xa4, 0x58, 0x10, 0x66, 0x01, 0xe5, 0xda, 0xf8, 0xb9, 0x60, - 0xf1, 0x97, 0x71, 0xa1, 0x1a, 0x64, 0x59, 0x3e, 0xaf, 0x75, 0xb8, 0x03, 0xb8, 0x1e, 0x21, 0xb1, - 0xb3, 0xbd, 0x95, 0x7f, 0xf9, 0x62, 0x2d, 0xc3, 0x1b, 0x72, 0x86, 0xca, 0xed, 0x74, 0xa4, 0xbf, - 0x05, 0xc8, 0xca, 0xd8, 0x32, 0x88, 0x09, 0xa3, 0x2d, 0xc8, 0xe1, 0x51, 0x1b, 0x1b, 0xb6, 0x73, - 0x77, 0x98, 0x7c, 0x37, 0x63, 0xdc, 0x0d, 0x87, 0xb3, 0x19, 0x93, 0x3d, 0x31, 0xf4, 0x80, 0x63, - 0x33, 0xd1, 0x30, 0x0b, 0x17, 0xf7, 0x83, 0x33, 0xef, 0x39, 0xe0, 0x0c, 0x0b, 0xf4, 0xab, 0x91, - 0x52, 0x21, 0x74, 0xe6, 0x01, 0x47, 0x67, 0x92, 0x33, 0x3e, 0x16, 0x80, 0x67, 0xea, 0x01, 0x78, - 0x26, 0x35, 0x63, 0x9a, 0x11, 0xf8, 0xcc, 0x7b, 0x0e, 0x3e, 0x93, 0x9e, 0x31, 0xe2, 0x10, 0x40, - 0xf3, 0xf1, 0x18, 0x40, 0xb3, 0x1e, 0x29, 0x3a, 0x01, 0xa1, 0x39, 0x18, 0x43, 0x68, 0xb2, 0x54, - 0xc9, 0xef, 0x23, 0x95, 0xcc, 0x80, 0x68, 0x0e, 0xc6, 0x20, 0x9a, 0xdc, 0x0c, 0x85, 0x33, 0x30, - 0x9a, 0xbf, 0x98, 0x8c, 0xd1, 0x40, 0x24, 0x8a, 0xc2, 0x87, 0x39, 0x1f, 0x48, 0xa3, 0x44, 0x80, - 0x34, 0xf9, 0xc8, 0x7b, 0x3f, 0x53, 0x3f, 0x37, 0x4a, 0xf3, 0xe9, 0x24, 0x94, 0x66, 0x29, 0x12, - 0x60, 0xe2, 0x56, 0x39, 0x0f, 0x4c, 0x73, 0x3c, 0x01, 0xa6, 0x29, 0x44, 0xc2, 0x3f, 0x4c, 0xf1, - 0x1c, 0x38, 0xcd, 0xf1, 0x04, 0x9c, 0xa6, 0x38, 0x53, 0xed, 0x4c, 0xa0, 0xe6, 0x51, 0x10, 0xa8, - 0x29, 0x45, 0xdc, 0x83, 0x3d, 0x67, 0x10, 0x81, 0xd4, 0x9c, 0x46, 0x21, 0x35, 0x0c, 0xa1, 0x7a, - 0x33, 0x52, 0xe3, 0x02, 0x50, 0xcd, 0xc1, 0x18, 0x54, 0x23, 0xce, 0xb0, 0xe1, 0x39, 0xb1, 0x1a, - 0xe9, 0x75, 0x12, 0xa5, 0x43, 0xee, 0x8e, 0xb8, 0x6e, 0x6c, 0x9a, 0xba, 0xc9, 0xd1, 0x15, 0xd6, - 0x90, 0xee, 0x92, 0xbb, 0xb6, 0xe7, 0xda, 0xa6, 0xe0, 0x37, 0x65, 0x28, 0x06, 0xdc, 0x99, 0xf4, - 0x8f, 0x82, 0x27, 0x4b, 0x11, 0x1c, 0xff, 0x3d, 0x3d, 0xc7, 0xef, 0xe9, 0xa1, 0xbb, 0x65, 0x2e, - 0x90, 0x6b, 0xf8, 0xb3, 0x19, 0x0e, 0xd8, 0xa8, 0x5e, 0x16, 0x73, 0x0f, 0x96, 0x68, 0xde, 0xcb, - 0x62, 0x45, 0x20, 0x1c, 0x95, 0x49, 0x07, 0x5b, 0x05, 0x16, 0x97, 0xde, 0x82, 0x65, 0x1f, 0xaf, - 0x7b, 0x39, 0x66, 0xa8, 0x85, 0xe8, 0x72, 0xd7, 0xf8, 0x2d, 0xf9, 0x5f, 0x12, 0xde, 0x0a, 0x79, - 0x48, 0xcf, 0x24, 0x50, 0x46, 0xf8, 0xd5, 0xa0, 0x4c, 0xf4, 0x25, 0x1d, 0x7d, 0x0e, 0x2b, 0x01, - 0xbc, 0xc6, 0x49, 0x2b, 0x13, 0x8b, 0xc1, 0x36, 0x31, 0x5f, 0x96, 0xe3, 0xf6, 0xa0, 0x2f, 0xe0, - 0x06, 0x4d, 0x90, 0x23, 0x52, 0xd7, 0xe4, 0x7c, 0xa9, 0xeb, 0x35, 0xa2, 0xa3, 0x3e, 0x21, 0x7d, - 0x8d, 0x00, 0x73, 0x52, 0x11, 0x60, 0x0e, 0xda, 0x83, 0xc2, 0x39, 0x1e, 0x60, 0x4b, 0xb3, 0x94, - 0x05, 0xee, 0x9c, 0x02, 0xc9, 0xf8, 0x9b, 0x31, 0x39, 0xcf, 0x65, 0x49, 0xef, 0xdf, 0x08, 0xc2, - 0x56, 0x19, 0x8a, 0x8a, 0x5f, 0x9d, 0xf4, 0x3f, 0x82, 0x67, 0x96, 0x2e, 0x5a, 0xd4, 0xd6, 0x3b, - 0xcc, 0x7c, 0x8b, 0x32, 0xfd, 0x4d, 0x6e, 0x57, 0x3d, 0xfd, 0x9c, 0x5b, 0x20, 0xf9, 0x49, 0xb8, - 0xdc, 0x02, 0x49, 0x8e, 0x47, 0xd8, 0x15, 0x48, 0x69, 0x83, 0x0e, 0x1e, 0x71, 0x23, 0x63, 0x0d, - 0x22, 0xfb, 0x0c, 0x5f, 0x72, 0x53, 0x22, 0x3f, 0x09, 0x1f, 0x3d, 0x67, 0x74, 0x2e, 0x05, 0x99, - 0x35, 0xd0, 0xfb, 0x90, 0xa3, 0x55, 0x2e, 0x45, 0x37, 0x2c, 0x1e, 0x23, 0x03, 0xa9, 0x1c, 0xab, - 0x48, 0x6d, 0x1c, 0x12, 0x9e, 0x03, 0xc3, 0x92, 0xb3, 0x06, 0xff, 0xe5, 0x4b, 0xb6, 0xb2, 0x81, - 0x64, 0xeb, 0x26, 0xe4, 0xc8, 0xe8, 0x2d, 0x43, 0x6d, 0x63, 0x1a, 0xdf, 0x72, 0xb2, 0x47, 0x90, - 0xfe, 0x49, 0x80, 0x72, 0x28, 0xe4, 0x4e, 0x9c, 0xbb, 0x73, 0x2a, 0xe3, 0x41, 0xf4, 0x6c, 0x6c, - 0xf6, 0xb7, 0x00, 0xce, 0x55, 0x4b, 0x79, 0xae, 0x0e, 0x6c, 0xdc, 0xe1, 0x4b, 0x90, 0x3b, 0x57, - 0xad, 0xa7, 0x94, 0x10, 0x1c, 0x4c, 0x2a, 0x34, 0x18, 0x1f, 0x7e, 0x93, 0xf6, 0xe3, 0x37, 0xa8, - 0x0a, 0x59, 0xc3, 0xd4, 0x74, 0x53, 0xb3, 0x2f, 0xe9, 0x9a, 0x24, 0x64, 0xb7, 0x2d, 0x1d, 0xc2, - 0x95, 0x89, 0xd1, 0x1e, 0x3d, 0x84, 0x9c, 0x97, 0x28, 0x08, 0x34, 0xa9, 0x9d, 0x02, 0x8b, 0x79, - 0xbc, 0x64, 0x49, 0xae, 0x4c, 0x8c, 0xf7, 0xa8, 0x01, 0x69, 0x13, 0x5b, 0xc3, 0x1e, 0x4b, 0xb2, - 0x4b, 0xf7, 0xdf, 0x9a, 0x2f, 0x4f, 0x20, 0xd4, 0x61, 0xcf, 0x96, 0xb9, 0xb0, 0xf4, 0x25, 0xa4, - 0x19, 0x05, 0xe5, 0x21, 0x73, 0xbc, 0xff, 0x78, 0xff, 0xe0, 0xe9, 0xbe, 0x18, 0x43, 0x00, 0xe9, - 0x5a, 0xbd, 0xde, 0x38, 0x6c, 0x89, 0x02, 0xca, 0x41, 0xaa, 0xb6, 0x75, 0x20, 0xb7, 0xc4, 0x38, - 0x21, 0xcb, 0x8d, 0xdd, 0x46, 0xbd, 0x25, 0x26, 0xd0, 0x12, 0x14, 0xd9, 0x6f, 0xe5, 0xd1, 0x81, - 0xfc, 0xa4, 0xd6, 0x12, 0x93, 0x3e, 0xd2, 0x51, 0x63, 0x7f, 0xbb, 0x21, 0x8b, 0x29, 0xe9, 0x1d, - 0xb8, 0x1e, 0x99, 0x59, 0x78, 0xc8, 0x99, 0xe0, 0x43, 0xce, 0xa4, 0x1f, 0xe3, 0xe4, 0xea, 0x14, - 0x95, 0x2e, 0xa0, 0xdd, 0xd0, 0xc4, 0xef, 0x2f, 0x90, 0x6b, 0x84, 0x66, 0x8f, 0x5e, 0x83, 0x92, - 0x89, 0xcf, 0xb0, 0xdd, 0xee, 0xb2, 0xf4, 0xc5, 0x01, 0xc0, 0x8a, 0x9c, 0x4a, 0x85, 0x2c, 0xc6, - 0xf6, 0x15, 0x6e, 0xdb, 0x0a, 0x33, 0x02, 0x8b, 0xc2, 0x0c, 0x39, 0xc2, 0x46, 0xa8, 0x47, 0x8c, - 0x48, 0xfc, 0x3f, 0xf3, 0x53, 0x4c, 0x55, 0x92, 0xaa, 0x02, 0xea, 0x76, 0x28, 0x45, 0x7a, 0xbe, - 0xd0, 0x62, 0xe7, 0x20, 0x25, 0x37, 0x5a, 0xf2, 0x67, 0x62, 0x02, 0x21, 0x28, 0xd1, 0x9f, 0xca, - 0xd1, 0x7e, 0xed, 0xf0, 0xa8, 0x79, 0x40, 0x16, 0x7b, 0x19, 0xca, 0xce, 0x62, 0x3b, 0xc4, 0x14, - 0xba, 0x02, 0x4b, 0xf5, 0x83, 0x27, 0x87, 0x7b, 0x8d, 0x56, 0xc3, 0x23, 0xa7, 0xa5, 0x2a, 0x54, - 0xa2, 0x52, 0x24, 0xe9, 0x3f, 0x12, 0x70, 0x2d, 0x22, 0xcd, 0x41, 0xef, 0x03, 0xd8, 0x23, 0xc5, - 0xc4, 0x6d, 0xdd, 0xec, 0x44, 0x1b, 0x6e, 0x6b, 0x24, 0x53, 0x0e, 0x39, 0x67, 0xf3, 0x5f, 0x53, - 0x63, 0xc5, 0x47, 0x5c, 0x29, 0x59, 0x08, 0x8b, 0x03, 0x36, 0xb7, 0x26, 0xdc, 0x40, 0x71, 0x9b, - 0x28, 0xa6, 0xfb, 0x45, 0x15, 0x53, 0x7e, 0xf4, 0x19, 0x5c, 0x0b, 0x85, 0x34, 0x1e, 0x07, 0xac, - 0x49, 0x05, 0xde, 0xc9, 0x91, 0xed, 0x4a, 0x30, 0xb2, 0xb1, 0x38, 0x60, 0x4d, 0x41, 0x47, 0x52, - 0xaf, 0x80, 0x8e, 0x44, 0x85, 0xc6, 0xf4, 0xa2, 0x15, 0x8d, 0x49, 0xa1, 0x31, 0x94, 0x72, 0x64, - 0xc2, 0x29, 0x87, 0xf4, 0xbf, 0x81, 0xdd, 0x0d, 0xa6, 0x96, 0x07, 0x90, 0xb6, 0x6c, 0xd5, 0x1e, - 0x5a, 0xfc, 0x24, 0x3d, 0x9c, 0x37, 0x4f, 0xdd, 0x70, 0x7e, 0x1c, 0x51, 0x71, 0x99, 0xab, 0xf9, - 0x83, 0xdc, 0xf4, 0xa8, 0xed, 0x49, 0xfd, 0x16, 0xdb, 0xd3, 0x84, 0x34, 0xbe, 0xc0, 0x03, 0xdb, - 0xaa, 0xa4, 0xe9, 0x8c, 0xaf, 0x8e, 0xcf, 0x98, 0x74, 0x6f, 0x55, 0x48, 0xee, 0xf3, 0xdf, 0x2f, - 0xd6, 0x44, 0xc6, 0xfd, 0xa6, 0xde, 0xd7, 0x6c, 0xdc, 0x37, 0xec, 0x4b, 0x99, 0xcb, 0x4b, 0xef, - 0x42, 0x29, 0xb8, 0xe8, 0xd1, 0x2e, 0xc4, 0x73, 0xd2, 0x71, 0xe9, 0x1f, 0x04, 0x58, 0x9e, 0x80, - 0xe5, 0xa0, 0x87, 0xbc, 0x10, 0xc4, 0x36, 0xfe, 0xf6, 0xf8, 0xea, 0x05, 0xd8, 0xbd, 0x7a, 0x10, - 0x09, 0x9a, 0xde, 0xd5, 0x81, 0xed, 0xb1, 0x47, 0x40, 0x6f, 0x40, 0xd9, 0xd2, 0xce, 0x07, 0x8a, - 0xc9, 0x60, 0x21, 0xb7, 0xc8, 0x42, 0x32, 0x7b, 0xd2, 0xe1, 0x94, 0x22, 0x3b, 0x24, 0xf3, 0x41, - 0x20, 0x2a, 0x21, 0x6e, 0xa9, 0x0d, 0x68, 0xfc, 0x26, 0x33, 0x09, 0xb8, 0x12, 0x5e, 0x01, 0xb8, - 0xfa, 0x7b, 0x01, 0x6e, 0x4c, 0xb9, 0xdd, 0xa0, 0x4f, 0x42, 0xe7, 0xe2, 0x83, 0x45, 0xee, 0x46, - 0x1b, 0x8c, 0x16, 0x3c, 0x19, 0xd2, 0x03, 0x28, 0xf8, 0xe9, 0xf3, 0x6d, 0xde, 0xae, 0x17, 0xfb, - 0x83, 0x00, 0xdb, 0x6d, 0x28, 0x9a, 0xd8, 0x26, 0x4e, 0x2a, 0x80, 0x48, 0x16, 0x18, 0x91, 0xa5, - 0xa9, 0xbb, 0xc9, 0xac, 0x20, 0xc6, 0x5d, 0xfb, 0xf9, 0x57, 0x01, 0xc0, 0x43, 0xdd, 0x3c, 0xd4, - 0x4b, 0xf0, 0xa3, 0x5e, 0x21, 0xb0, 0x34, 0x1e, 0x06, 0x4b, 0xd1, 0x1d, 0x28, 0xb3, 0xfb, 0x08, - 0xd9, 0x37, 0xd5, 0x1e, 0x9a, 0x98, 0x63, 0x6c, 0x25, 0x4a, 0x3e, 0x72, 0xa8, 0xe8, 0x73, 0xb8, - 0x6e, 0x77, 0x4d, 0x6c, 0x75, 0xf5, 0x5e, 0x47, 0x09, 0xef, 0x1d, 0xab, 0xfd, 0xac, 0xcd, 0x30, - 0x3a, 0xf9, 0x9a, 0xab, 0xe1, 0x24, 0xb8, 0x7f, 0xdf, 0x40, 0x8a, 0x1e, 0x1b, 0x92, 0xf4, 0xb9, - 0x56, 0x9c, 0xe3, 0x06, 0xfa, 0x05, 0x80, 0x6a, 0xdb, 0xa6, 0x76, 0x3a, 0x24, 0xde, 0x21, 0x3e, - 0xfe, 0x29, 0xef, 0xd8, 0xd5, 0x1c, 0xbe, 0xad, 0x9b, 0xfc, 0xfc, 0xad, 0x78, 0xa2, 0xbe, 0x33, - 0xe8, 0x53, 0x28, 0xed, 0x43, 0x29, 0x28, 0xeb, 0x64, 0xd3, 0x6c, 0x0c, 0xc1, 0x6c, 0x9a, 0x65, - 0xe7, 0x3c, 0x9b, 0x76, 0x73, 0xf1, 0x04, 0xab, 0xd9, 0xd2, 0x86, 0xf4, 0x8b, 0x00, 0x05, 0xbf, - 0xd7, 0x9b, 0x3b, 0xe1, 0xe5, 0x17, 0x80, 0xc4, 0xf8, 0x05, 0x20, 0xe9, 0x4b, 0x81, 0xaf, 0x43, - 0x96, 0xa4, 0xc0, 0x43, 0x0b, 0x77, 0x78, 0x25, 0x3b, 0x73, 0xae, 0x5a, 0xc7, 0x16, 0xee, 0xf8, - 0x7c, 0x53, 0xe6, 0xd5, 0x7c, 0x53, 0x30, 0x91, 0xce, 0x86, 0x12, 0xe9, 0xdd, 0x64, 0x36, 0x25, - 0xa6, 0x65, 0x5f, 0x26, 0x2e, 0xfd, 0xb5, 0x00, 0x59, 0x77, 0xbe, 0xc1, 0x12, 0x6e, 0x00, 0x97, - 0x65, 0xcb, 0xc5, 0x0a, 0xb8, 0xfc, 0xea, 0xc2, 0x0a, 0xda, 0x09, 0xb7, 0xa0, 0xfd, 0xa1, 0x9b, - 0x0c, 0x46, 0x21, 0x8f, 0xfe, 0xc5, 0x75, 0xc0, 0x66, 0x9e, 0xfb, 0xfe, 0x1d, 0x1f, 0x07, 0xc9, - 0x58, 0xd0, 0x9f, 0x40, 0x5a, 0x6d, 0xbb, 0x78, 0x6b, 0x69, 0x02, 0x10, 0xe9, 0xb0, 0x6e, 0xb4, - 0x46, 0x35, 0xca, 0x29, 0x73, 0x09, 0x3e, 0xaa, 0xb8, 0x33, 0x2a, 0x69, 0x8f, 0xe8, 0x65, 0x3c, - 0xc1, 0x93, 0x5e, 0x02, 0x38, 0xde, 0x7f, 0x72, 0xb0, 0xbd, 0xf3, 0x68, 0xa7, 0xb1, 0xcd, 0xb3, - 0xbd, 0xed, 0xed, 0xc6, 0xb6, 0x18, 0x27, 0x7c, 0x72, 0xe3, 0xc9, 0xc1, 0x49, 0x63, 0x5b, 0x4c, - 0x90, 0xc6, 0x76, 0x63, 0xaf, 0xf6, 0x59, 0x63, 0x5b, 0x4c, 0x4a, 0x35, 0xc8, 0xb9, 0x41, 0x87, - 0x56, 0xfe, 0xf5, 0xe7, 0xd8, 0xe4, 0xab, 0xc5, 0x1a, 0x68, 0x15, 0xf2, 0xe3, 0x05, 0x03, 0x72, - 0x79, 0x63, 0x75, 0x02, 0x12, 0x06, 0xca, 0xae, 0x0e, 0x1e, 0x9b, 0x3e, 0x84, 0x8c, 0x31, 0x3c, - 0x55, 0x1c, 0xdb, 0x0d, 0xc1, 0xec, 0xce, 0xdd, 0x6e, 0x78, 0xda, 0xd3, 0xda, 0x8f, 0xf1, 0x25, - 0x0f, 0x72, 0x69, 0x63, 0x78, 0xfa, 0x98, 0x99, 0x38, 0x1b, 0x46, 0x7c, 0xca, 0x30, 0x12, 0xa1, - 0x61, 0xa0, 0x3b, 0x50, 0x18, 0xe8, 0x1d, 0xac, 0xa8, 0x9d, 0x8e, 0x89, 0x2d, 0x16, 0xbb, 0x73, - 0x5c, 0x73, 0x9e, 0xf4, 0xd4, 0x58, 0x87, 0xf4, 0x93, 0x00, 0x68, 0x3c, 0xd0, 0xa2, 0x23, 0x58, - 0xf2, 0x62, 0xb5, 0x93, 0x00, 0xb0, 0x48, 0xb0, 0x1e, 0x1d, 0xa8, 0x03, 0xf8, 0x82, 0x78, 0x11, - 0x24, 0x93, 0xac, 0x6f, 0xc5, 0x73, 0x55, 0x06, 0x9d, 0x2f, 0x5d, 0x94, 0xf8, 0x9c, 0x8b, 0x12, - 0x93, 0x91, 0x2b, 0xef, 0xf6, 0x84, 0x5d, 0x69, 0x62, 0xac, 0xee, 0x64, 0x40, 0xa5, 0x35, 0x26, - 0xc6, 0xe7, 0x19, 0x35, 0x24, 0xe1, 0x55, 0x86, 0x24, 0x3d, 0x00, 0xf1, 0x13, 0xf7, 0xfb, 0x5e, - 0xfe, 0xe8, 0x1f, 0xa6, 0x30, 0x36, 0xcc, 0x0b, 0xc8, 0x12, 0xef, 0x4b, 0x83, 0xc6, 0x9f, 0x42, - 0xce, 0x5d, 0x3d, 0xf7, 0xf1, 0x50, 0xe4, 0xb2, 0xf3, 0x91, 0x78, 0x22, 0xe8, 0x1e, 0x2c, 0x91, - 0xb8, 0xe1, 0x54, 0x7f, 0x19, 0x42, 0x18, 0xa7, 0xde, 0xb0, 0xcc, 0x3a, 0xf6, 0x1c, 0x58, 0x8b, - 0xc4, 0x68, 0x91, 0xc5, 0x72, 0xdc, 0xf9, 0xff, 0x18, 0x00, 0xb9, 0xf3, 0x85, 0x80, 0x52, 0xb6, - 0x87, 0xc5, 0x40, 0x32, 0x21, 0xfd, 0x65, 0x1c, 0xf2, 0xbe, 0x6a, 0x14, 0xfa, 0xe3, 0x40, 0x62, - 0xb5, 0x3e, 0xad, 0x72, 0xe5, 0xcb, 0xaa, 0x02, 0x13, 0x8b, 0x2f, 0x3e, 0xb1, 0xa8, 0x3a, 0xa0, - 0x53, 0x94, 0x4e, 0x2e, 0x5c, 0x94, 0x7e, 0x13, 0x90, 0xad, 0xdb, 0x6a, 0x8f, 0x04, 0x6f, 0x6d, - 0x70, 0xae, 0xb0, 0xd3, 0xce, 0x0a, 0xe1, 0x22, 0xed, 0x39, 0xa1, 0x1d, 0x87, 0x84, 0x2e, 0xf5, - 0x20, 0xeb, 0x02, 0x13, 0x8b, 0xbf, 0xc9, 0x99, 0x54, 0x7c, 0xaf, 0x42, 0xb6, 0x8f, 0x6d, 0x95, - 0x86, 0x3d, 0x06, 0x54, 0xb9, 0xed, 0x7b, 0x1f, 0x40, 0xde, 0xf7, 0x50, 0x89, 0x44, 0xc2, 0xfd, - 0xc6, 0x53, 0x31, 0x56, 0xcd, 0x7c, 0xfb, 0xfd, 0x7a, 0x62, 0x1f, 0x3f, 0x27, 0x9f, 0x92, 0x1b, - 0xf5, 0x66, 0xa3, 0xfe, 0x58, 0x14, 0xaa, 0xf9, 0x6f, 0xbf, 0x5f, 0xcf, 0xc8, 0x98, 0x16, 0x6e, - 0xee, 0x3d, 0x86, 0x72, 0x68, 0x07, 0x82, 0x0e, 0x1a, 0x41, 0x69, 0xfb, 0xf8, 0x70, 0x6f, 0xa7, - 0x5e, 0x6b, 0x35, 0x94, 0x93, 0x83, 0x56, 0x43, 0x14, 0xd0, 0x35, 0x58, 0xde, 0xdb, 0xf9, 0xb3, - 0x66, 0x4b, 0xa9, 0xef, 0xed, 0x34, 0xf6, 0x5b, 0x4a, 0xad, 0xd5, 0xaa, 0xd5, 0x1f, 0x8b, 0xf1, - 0xfb, 0xff, 0x09, 0x50, 0xae, 0x6d, 0xd5, 0x77, 0x6a, 0x86, 0xd1, 0xd3, 0xda, 0x2a, 0x75, 0xf7, - 0x75, 0x48, 0x52, 0xd4, 0x79, 0xea, 0x5b, 0xe8, 0xea, 0xf4, 0x6a, 0x1c, 0x7a, 0x04, 0x29, 0x0a, - 0x48, 0xa3, 0xe9, 0x8f, 0xa3, 0xab, 0x33, 0xca, 0x73, 0x64, 0x30, 0xf4, 0xdc, 0x4c, 0x7d, 0x2d, - 0x5d, 0x9d, 0x5e, 0xad, 0x43, 0x7b, 0x90, 0x71, 0xc0, 0xb8, 0x59, 0x4f, 0x98, 0xab, 0x33, 0x4b, - 0x68, 0x64, 0x6a, 0x0c, 0xd4, 0x9c, 0xfe, 0x90, 0xba, 0x3a, 0xa3, 0x8e, 0x87, 0x64, 0xc8, 0x79, - 0x30, 0xf7, 0xec, 0x37, 0xdd, 0xd5, 0x39, 0xea, 0x8a, 0xe8, 0x4b, 0x28, 0x06, 0x61, 0xbb, 0xf9, - 0x9e, 0x5b, 0x57, 0xe7, 0xac, 0xf9, 0x11, 0xfd, 0x41, 0x0c, 0x6f, 0xbe, 0xe7, 0xd7, 0xd5, 0x39, - 0x4b, 0x80, 0xe8, 0x2b, 0x58, 0x1a, 0xc7, 0xd8, 0xe6, 0x7f, 0x8d, 0x5d, 0x5d, 0xa0, 0x28, 0x88, - 0xfa, 0x80, 0x26, 0x60, 0x73, 0x0b, 0x3c, 0xce, 0xae, 0x2e, 0x52, 0x23, 0x44, 0x1d, 0x28, 0x87, - 0xb1, 0xa9, 0x79, 0xdf, 0x54, 0x57, 0xe7, 0xae, 0xea, 0xb1, 0xaf, 0x04, 0x31, 0x92, 0x79, 0xdf, - 0x58, 0x57, 0xe7, 0x2e, 0xf2, 0xa1, 0x63, 0x00, 0xdf, 0xdd, 0x76, 0x8e, 0x37, 0xd7, 0xd5, 0x79, - 0xca, 0x7d, 0xc8, 0x80, 0xe5, 0x49, 0x97, 0xd9, 0x45, 0x9e, 0x60, 0x57, 0x17, 0xaa, 0x02, 0x12, - 0x7b, 0x0e, 0xde, 0x4b, 0xe7, 0x7b, 0x92, 0x5d, 0x9d, 0xb3, 0x1c, 0xb8, 0xb5, 0xf5, 0xc3, 0xcb, - 0x55, 0xe1, 0xc7, 0x97, 0xab, 0xc2, 0x4f, 0x2f, 0x57, 0x85, 0xef, 0x7e, 0x5e, 0x8d, 0xfd, 0xf8, - 0xf3, 0x6a, 0xec, 0xdf, 0x7f, 0x5e, 0x8d, 0xfd, 0xf9, 0xdd, 0x73, 0xcd, 0xee, 0x0e, 0x4f, 0x37, - 0xda, 0x7a, 0x9f, 0xfe, 0xd5, 0xc6, 0x50, 0x2f, 0x37, 0x99, 0x4e, 0xd2, 0xf2, 0xfd, 0xa1, 0xe7, - 0x34, 0x4d, 0x63, 0xdd, 0x83, 0xff, 0x0b, 0x00, 0x00, 0xff, 0xff, 0x98, 0x78, 0x79, 0x4b, 0xf0, - 0x33, 0x00, 0x00, + // 3796 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xd4, 0x5b, 0x4d, 0x70, 0x1b, 0x57, + 0x72, 0xc6, 0xe0, 0x1f, 0x8d, 0xbf, 0xe1, 0x23, 0x25, 0x41, 0x90, 0x44, 0x72, 0x47, 0xf1, 0x4a, + 0xab, 0xb5, 0x49, 0xaf, 0x14, 0xaf, 0xec, 0xec, 0x6e, 0xaa, 0x40, 0x10, 0x0a, 0x48, 0x51, 0x24, + 0x3d, 0x04, 0xa9, 0x75, 0x1c, 0x7b, 0x6a, 0x08, 0x3c, 0x02, 0x63, 0x01, 0x98, 0xf1, 0xcc, 0x80, + 0x02, 0x7d, 0x4d, 0x52, 0x95, 0xf2, 0xc9, 0xf7, 0x94, 0x6f, 0xc9, 0x31, 0xf7, 0x9c, 0x92, 0x5b, + 0xe2, 0x54, 0x2e, 0x3e, 0xa6, 0x2a, 0x55, 0x8a, 0x4b, 0xbe, 0xe5, 0xe6, 0x53, 0x2e, 0x39, 0xa4, + 0xde, 0xcf, 0xfc, 0x02, 0x83, 0x1f, 0xcb, 0x55, 0xa9, 0xbd, 0xe1, 0xf5, 0xeb, 0xee, 0x79, 0x3f, + 0xfd, 0xba, 0xfb, 0x7d, 0xfd, 0x00, 0xb7, 0x6c, 0x3c, 0xec, 0x60, 0x73, 0xa0, 0x0d, 0xed, 0x6d, + 0xf5, 0xbc, 0xad, 0x6d, 0xdb, 0x57, 0x06, 0xb6, 0xb6, 0x0c, 0x53, 0xb7, 0x75, 0x54, 0xf6, 0x3a, + 0xb7, 0x48, 0x67, 0xf5, 0x8e, 0x8f, 0xbb, 0x6d, 0x5e, 0x19, 0xb6, 0xbe, 0x6d, 0x98, 0xba, 0x7e, + 0xc1, 0xf8, 0xab, 0x7e, 0x65, 0x54, 0xcf, 0x76, 0x47, 0xb5, 0x7a, 0xbc, 0xf3, 0xf6, 0x44, 0xe7, + 0x79, 0x5f, 0x6f, 0xbf, 0x88, 0xec, 0xf5, 0x0d, 0x24, 0xd0, 0xcb, 0xbf, 0xfb, 0x02, 0x5f, 0x39, + 0xbd, 0x77, 0x26, 0x64, 0x0d, 0xd5, 0x54, 0x07, 0x4e, 0xf7, 0xba, 0xaf, 0xfb, 0x12, 0x9b, 0x96, + 0xa6, 0x0f, 0x03, 0xca, 0x37, 0xba, 0xba, 0xde, 0xed, 0xe3, 0x6d, 0xda, 0x3a, 0x1f, 0x5d, 0x6c, + 0xdb, 0xda, 0x00, 0x5b, 0xb6, 0x3a, 0x30, 0x38, 0xc3, 0x5a, 0x57, 0xef, 0xea, 0xf4, 0xe7, 0x36, + 0xf9, 0xc5, 0xa8, 0xd2, 0xab, 0x1c, 0x64, 0x64, 0xfc, 0xf9, 0x08, 0x5b, 0x36, 0x7a, 0x08, 0x49, + 0xdc, 0xee, 0xe9, 0x15, 0x61, 0x53, 0xb8, 0x9f, 0x7f, 0x78, 0x7b, 0x2b, 0xb4, 0x6e, 0x5b, 0x9c, + 0xaf, 0xd1, 0xee, 0xe9, 0xcd, 0x98, 0x4c, 0x79, 0xd1, 0x7b, 0x90, 0xba, 0xe8, 0x8f, 0xac, 0x5e, + 0x25, 0x4e, 0x85, 0xee, 0x44, 0x09, 0x3d, 0x21, 0x4c, 0xcd, 0x98, 0xcc, 0xb8, 0xc9, 0xa7, 0xb4, + 0xe1, 0x85, 0x5e, 0x49, 0xcc, 0xfe, 0xd4, 0xde, 0xf0, 0x82, 0x7e, 0x8a, 0xf0, 0xa2, 0x1d, 0x00, + 0x6d, 0xa8, 0xd9, 0x4a, 0xbb, 0xa7, 0x6a, 0xc3, 0x4a, 0x92, 0x4a, 0xfe, 0x2c, 0x5a, 0x52, 0xb3, + 0xeb, 0x84, 0xb1, 0x19, 0x93, 0x73, 0x9a, 0xd3, 0x20, 0xc3, 0xfd, 0x7c, 0x84, 0xcd, 0xab, 0x4a, + 0x6a, 0xf6, 0x70, 0x3f, 0x24, 0x4c, 0x64, 0xb8, 0x94, 0x1b, 0xfd, 0x16, 0xb2, 0xed, 0x1e, 0x6e, + 0xbf, 0x50, 0xec, 0x71, 0x25, 0x43, 0x25, 0x37, 0xa2, 0x24, 0xeb, 0x84, 0xaf, 0x35, 0x6e, 0xc6, + 0xe4, 0x4c, 0x9b, 0xfd, 0x44, 0x87, 0x50, 0xea, 0x6b, 0x96, 0xad, 0x58, 0x43, 0xd5, 0xb0, 0x7a, + 0xba, 0x6d, 0x55, 0xf2, 0x54, 0xc7, 0x5b, 0x51, 0x3a, 0x0e, 0x34, 0xcb, 0x3e, 0x71, 0x98, 0x9b, + 0x31, 0xb9, 0xd8, 0xf7, 0x13, 0x88, 0x3e, 0xfd, 0xe2, 0x02, 0x9b, 0xae, 0xc2, 0x4a, 0x61, 0xb6, + 0xbe, 0x23, 0xc2, 0xed, 0xc8, 0x13, 0x7d, 0xba, 0x9f, 0x80, 0x3e, 0x86, 0xd5, 0xbe, 0xae, 0x76, + 0x5c, 0x75, 0x4a, 0xbb, 0x37, 0x1a, 0xbe, 0xa8, 0x14, 0xa9, 0xd2, 0x5f, 0x44, 0x0e, 0x52, 0x57, + 0x3b, 0x8e, 0x8a, 0x3a, 0x11, 0x68, 0xc6, 0xe4, 0x95, 0x7e, 0x98, 0x88, 0x3e, 0x85, 0x35, 0xd5, + 0x30, 0xfa, 0x57, 0x61, 0xed, 0x25, 0xaa, 0xfd, 0x41, 0x94, 0xf6, 0x1a, 0x91, 0x09, 0xab, 0x47, + 0xea, 0x04, 0x15, 0x3d, 0x87, 0x95, 0x0b, 0x6d, 0xa8, 0xf6, 0xb5, 0x2f, 0xb0, 0xb7, 0x1e, 0x6b, + 0x54, 0xf9, 0xfd, 0x48, 0x63, 0xe4, 0x02, 0xbe, 0x25, 0x11, 0x2f, 0x42, 0x34, 0xd4, 0x02, 0xd1, + 0x30, 0xb1, 0xa1, 0x9a, 0x58, 0x31, 0x4c, 0xdd, 0xd0, 0x2d, 0xb5, 0x5f, 0x29, 0x53, 0xbd, 0xf7, + 0xa2, 0xf4, 0x1e, 0x33, 0xfe, 0x63, 0xce, 0xde, 0x8c, 0xc9, 0x65, 0x23, 0x48, 0x62, 0x5a, 0xf5, + 0x36, 0xb6, 0x2c, 0x4f, 0xab, 0x38, 0x4f, 0x2b, 0xe5, 0x0f, 0x6a, 0x0d, 0x90, 0x50, 0x03, 0xf2, + 0x78, 0x4c, 0xc4, 0x95, 0x4b, 0xdd, 0xc6, 0x95, 0x15, 0xaa, 0x50, 0x8a, 0x3c, 0xc0, 0x94, 0xf5, + 0x4c, 0xb7, 0x71, 0x33, 0x26, 0x03, 0x76, 0x5b, 0x48, 0x85, 0x6b, 0x97, 0xd8, 0xd4, 0x2e, 0xae, + 0xa8, 0x1a, 0x85, 0xf6, 0x10, 0x47, 0x53, 0x41, 0x54, 0xe1, 0x2f, 0xa3, 0x14, 0x9e, 0x51, 0x21, + 0xa2, 0xa2, 0xe1, 0x88, 0x34, 0x63, 0xf2, 0xea, 0xe5, 0x24, 0x99, 0xd8, 0xae, 0xbb, 0x5d, 0xd4, + 0x73, 0x56, 0x56, 0x67, 0xdb, 0xae, 0xb3, 0x57, 0x3b, 0x84, 0x99, 0xd8, 0xee, 0x85, 0x9f, 0xb0, + 0x93, 0x81, 0xd4, 0xa5, 0xda, 0x1f, 0xe1, 0xfd, 0x64, 0x36, 0x2d, 0x66, 0xf6, 0x93, 0xd9, 0xac, + 0x98, 0xdb, 0x4f, 0x66, 0x73, 0x22, 0xec, 0x27, 0xb3, 0x20, 0xe6, 0xa5, 0x7b, 0x90, 0xf7, 0xf9, + 0x2d, 0x54, 0x81, 0xcc, 0x00, 0x5b, 0x96, 0xda, 0xc5, 0xd4, 0xcd, 0xe5, 0x64, 0xa7, 0x29, 0x95, + 0xa0, 0xe0, 0xf7, 0x55, 0xd2, 0x57, 0x82, 0x2b, 0x49, 0xdc, 0x10, 0x91, 0xe4, 0x7e, 0xd7, 0x91, + 0xe4, 0x4d, 0x74, 0x17, 0x8a, 0x74, 0x2a, 0x8a, 0xd3, 0x4f, 0x7c, 0x61, 0x52, 0x2e, 0x50, 0xe2, + 0x19, 0x67, 0xda, 0x80, 0xbc, 0xf1, 0xd0, 0x70, 0x59, 0x12, 0x94, 0x05, 0x8c, 0x87, 0x86, 0xc3, + 0xf0, 0x33, 0x28, 0x90, 0x79, 0xbb, 0x1c, 0x49, 0xfa, 0x91, 0x3c, 0xa1, 0x71, 0x16, 0xe9, 0xaf, + 0x12, 0x20, 0x86, 0xfd, 0x1b, 0x7a, 0x1f, 0x92, 0xc4, 0xd5, 0x73, 0xaf, 0x5d, 0xdd, 0x62, 0x71, + 0x60, 0xcb, 0x89, 0x03, 0x5b, 0x2d, 0x27, 0x0e, 0xec, 0x64, 0xbf, 0x79, 0xb5, 0x11, 0xfb, 0xea, + 0xbf, 0x36, 0x04, 0x99, 0x4a, 0xa0, 0x9b, 0xc4, 0xab, 0xa9, 0xda, 0x50, 0xd1, 0x3a, 0x74, 0xc8, + 0x39, 0xe2, 0xb2, 0x54, 0x6d, 0xb8, 0xd7, 0x41, 0x07, 0x20, 0xb6, 0xf5, 0xa1, 0x85, 0x87, 0xd6, + 0xc8, 0x52, 0x58, 0x1c, 0xe2, 0xbe, 0x3a, 0xe0, 0x71, 0x59, 0x00, 0xaa, 0x3b, 0x9c, 0xc7, 0x94, + 0x51, 0x2e, 0xb7, 0x83, 0x04, 0x74, 0x08, 0xc5, 0x4b, 0xb5, 0xaf, 0x75, 0x54, 0x5b, 0x37, 0x15, + 0x0b, 0xdb, 0xdc, 0x79, 0xdf, 0x9d, 0xd8, 0xf3, 0x33, 0x87, 0xeb, 0x04, 0xdb, 0xa7, 0x46, 0x47, + 0xb5, 0xf1, 0x4e, 0xf2, 0x9b, 0x57, 0x1b, 0x82, 0x5c, 0xb8, 0xf4, 0xf5, 0xa0, 0x9f, 0x43, 0x59, + 0x35, 0x0c, 0xc5, 0xb2, 0x55, 0x1b, 0x2b, 0xe7, 0x57, 0x36, 0xb6, 0xa8, 0x3f, 0x2f, 0xc8, 0x45, + 0xd5, 0x30, 0x4e, 0x08, 0x75, 0x87, 0x10, 0xd1, 0x5b, 0x50, 0x22, 0xae, 0x5f, 0x53, 0xfb, 0x4a, + 0x0f, 0x6b, 0xdd, 0x9e, 0x5d, 0x49, 0x6f, 0x0a, 0xf7, 0x13, 0x72, 0x91, 0x53, 0x9b, 0x94, 0x88, + 0xb6, 0x60, 0xd5, 0x61, 0x6b, 0xeb, 0x26, 0x76, 0x78, 0x89, 0xa3, 0x2f, 0xca, 0x2b, 0xbc, 0xab, + 0xae, 0x9b, 0x98, 0xf1, 0x4b, 0x1d, 0xd7, 0x52, 0x68, 0x98, 0x40, 0x08, 0x92, 0x1d, 0xd5, 0x56, + 0xe9, 0x0e, 0x14, 0x64, 0xfa, 0x9b, 0xd0, 0x0c, 0xd5, 0xee, 0xf1, 0x75, 0xa5, 0xbf, 0xd1, 0x75, + 0x48, 0x73, 0xd5, 0x09, 0x3a, 0x0c, 0xde, 0x42, 0x6b, 0x90, 0x32, 0x4c, 0xfd, 0x12, 0xd3, 0x65, + 0xc9, 0xca, 0xac, 0x21, 0xc9, 0x50, 0x0a, 0x86, 0x14, 0x54, 0x82, 0xb8, 0x3d, 0xe6, 0x5f, 0x89, + 0xdb, 0x63, 0xf4, 0x2e, 0x24, 0xc9, 0x06, 0xd0, 0x6f, 0x94, 0xa6, 0x04, 0x51, 0x2e, 0xd7, 0xba, + 0x32, 0xb0, 0x4c, 0x39, 0xa5, 0xeb, 0xb0, 0x36, 0x2d, 0xc4, 0x48, 0x3d, 0x97, 0x1e, 0x08, 0x15, + 0xe8, 0x3d, 0xc8, 0xba, 0x3e, 0x95, 0xd9, 0xd7, 0xcd, 0x89, 0xaf, 0x38, 0xcc, 0xb2, 0xcb, 0x4a, + 0x0c, 0x8b, 0xec, 0x4f, 0x4f, 0xe5, 0x79, 0x41, 0x41, 0xce, 0xa8, 0x86, 0xd1, 0x54, 0xad, 0x9e, + 0xd4, 0x85, 0x4a, 0x54, 0xfc, 0xf0, 0xad, 0x8f, 0x40, 0x4f, 0x87, 0xb3, 0x3e, 0xbe, 0x93, 0x17, + 0xa7, 0x7b, 0xe2, 0x9e, 0x3c, 0x6a, 0xc1, 0xa3, 0xe1, 0x0b, 0x62, 0xc1, 0x09, 0xf6, 0x21, 0xda, + 0xde, 0xeb, 0x48, 0x1d, 0xb8, 0x19, 0x19, 0x4a, 0x02, 0x72, 0x42, 0x40, 0x8e, 0x6c, 0x06, 0x0b, + 0x50, 0x6c, 0xe0, 0xac, 0x41, 0x86, 0x66, 0xd1, 0x79, 0xd3, 0xcf, 0xe4, 0x64, 0xde, 0x92, 0x7e, + 0x0f, 0x37, 0x22, 0x62, 0x0a, 0xfa, 0x1d, 0xe4, 0xfb, 0x64, 0xf8, 0xdc, 0xcd, 0x4d, 0x49, 0xaa, + 0xd8, 0xe9, 0x39, 0x20, 0x4c, 0xd4, 0x99, 0xc9, 0xd0, 0x77, 0x7f, 0x4b, 0x3f, 0x24, 0xe1, 0xfa, + 0xf4, 0xb0, 0x82, 0x36, 0xa1, 0x30, 0x50, 0xc7, 0x8a, 0x3d, 0xe6, 0xb6, 0x2f, 0x50, 0x6b, 0x82, + 0x81, 0x3a, 0x6e, 0x8d, 0x99, 0xe1, 0x8b, 0x90, 0xb0, 0xc7, 0x56, 0x25, 0xbe, 0x99, 0xb8, 0x5f, + 0x90, 0xc9, 0x4f, 0xf4, 0x0c, 0x56, 0xfa, 0x7a, 0x5b, 0xed, 0x2b, 0x7d, 0xd5, 0xb2, 0x95, 0xb6, + 0x3e, 0x18, 0x68, 0x36, 0x3f, 0xd1, 0xb7, 0x26, 0x0d, 0x87, 0x76, 0x13, 0xaf, 0x47, 0x8f, 0x5f, + 0x4c, 0x2e, 0x53, 0xd9, 0x03, 0xd5, 0xb2, 0x59, 0x17, 0xda, 0x85, 0xfc, 0x40, 0xb3, 0xce, 0x71, + 0x4f, 0xbd, 0xd4, 0x74, 0xb3, 0x92, 0xdc, 0x4c, 0x4c, 0x4d, 0xe3, 0x9e, 0x79, 0x3c, 0x5c, 0x93, + 0x5f, 0xcc, 0xb7, 0xe1, 0xa9, 0xc0, 0x81, 0x70, 0x5c, 0x5a, 0x7a, 0x69, 0x97, 0xf6, 0x2e, 0xac, + 0x0d, 0xf1, 0xd8, 0x56, 0x5c, 0x77, 0x61, 0x31, 0x2b, 0xcc, 0xd0, 0xcd, 0x44, 0xa4, 0xcf, 0xf5, + 0x31, 0x16, 0x31, 0x48, 0xb2, 0xdf, 0xa6, 0x3e, 0x1a, 0x76, 0x2a, 0xd9, 0x4d, 0xe1, 0x7e, 0x4a, + 0x66, 0x0d, 0xf4, 0x18, 0x2a, 0xd4, 0x15, 0x30, 0xff, 0x48, 0x36, 0x04, 0x77, 0x1c, 0xbf, 0x90, + 0xa3, 0x36, 0x78, 0x8d, 0xf4, 0x53, 0x0f, 0x7c, 0x40, 0x7b, 0xb9, 0x2f, 0xd9, 0x86, 0x35, 0x16, + 0xd7, 0xb1, 0x49, 0x02, 0x3c, 0xd9, 0x24, 0x3a, 0x00, 0xa0, 0x03, 0x58, 0x71, 0xfa, 0x8e, 0x4d, + 0xbd, 0x35, 0xa6, 0xdf, 0x7f, 0xd7, 0x15, 0xe8, 0x28, 0xe4, 0xd0, 0x38, 0x96, 0x9e, 0xa7, 0x47, + 0x00, 0x39, 0x7d, 0x35, 0xc3, 0x0d, 0x14, 0x8f, 0xbd, 0xe3, 0x50, 0x98, 0xcc, 0x62, 0x79, 0x97, + 0xe7, 0x94, 0xbd, 0xd3, 0xb2, 0x01, 0xf9, 0xcf, 0x47, 0xba, 0x39, 0x1a, 0xb0, 0x21, 0x15, 0xe9, + 0x90, 0x80, 0x91, 0xe8, 0xe1, 0xfc, 0xe7, 0x94, 0xcf, 0xe6, 0x82, 0x19, 0x06, 0xb7, 0x28, 0xc1, + 0xb3, 0xa8, 0x13, 0xdf, 0xc0, 0xfd, 0x46, 0x15, 0x5f, 0xd4, 0xa8, 0xdc, 0xb9, 0x45, 0xdb, 0x55, + 0xe2, 0xc7, 0xd9, 0x15, 0x82, 0x24, 0x9d, 0x61, 0x92, 0x39, 0x64, 0xf2, 0x3b, 0xd2, 0xd6, 0xdc, + 0xfd, 0x4f, 0xfb, 0xf7, 0xdf, 0xb1, 0xc0, 0xcc, 0x4f, 0x66, 0x81, 0xd9, 0x48, 0x0b, 0xfc, 0xd1, + 0xb6, 0xd6, 0x82, 0xeb, 0x21, 0x41, 0x65, 0x44, 0x83, 0x26, 0xb5, 0xb6, 0xd0, 0x1d, 0xc5, 0x09, + 0xd5, 0x3e, 0x45, 0xf2, 0x6a, 0x40, 0x2f, 0x0b, 0xb8, 0x91, 0x16, 0x9c, 0x5f, 0xd6, 0x82, 0x0b, + 0x8b, 0x58, 0x70, 0xf1, 0x4d, 0x2c, 0xb8, 0x34, 0x61, 0xc1, 0xa7, 0xb0, 0x32, 0x91, 0xe4, 0xba, + 0xe6, 0x20, 0x4c, 0x35, 0x87, 0xf8, 0x74, 0x73, 0x48, 0xf8, 0xcc, 0x41, 0xfa, 0x4e, 0x80, 0x6a, + 0x74, 0xae, 0x3b, 0xf5, 0x03, 0xbf, 0x82, 0x6b, 0x5e, 0xce, 0xe3, 0x5f, 0x47, 0x16, 0x57, 0x90, + 0xdb, 0xe9, 0x2d, 0xe4, 0x8c, 0xfc, 0x80, 0x8d, 0x29, 0xe9, 0x37, 0xd1, 0x67, 0x50, 0x0e, 0x66, + 0xe9, 0x24, 0x09, 0x22, 0xc7, 0xe5, 0x8f, 0x26, 0x8e, 0x8b, 0xb7, 0x16, 0xee, 0x98, 0xe5, 0xd2, + 0xa5, 0xbf, 0x69, 0x49, 0xff, 0x1e, 0x77, 0x73, 0x80, 0x40, 0xca, 0x8d, 0x3e, 0x80, 0x34, 0x3f, + 0xd9, 0xc2, 0xa2, 0x27, 0x9b, 0x0b, 0x84, 0x4f, 0x73, 0xfc, 0xcd, 0x4e, 0x73, 0x62, 0xea, 0xf6, + 0x25, 0xa7, 0x2f, 0x55, 0xca, 0xbf, 0x54, 0xef, 0x40, 0x8a, 0x05, 0x61, 0x16, 0x50, 0x6e, 0x4c, + 0x9e, 0x0b, 0x16, 0x7f, 0x19, 0x17, 0xaa, 0x41, 0x96, 0xe5, 0xf3, 0x5a, 0x87, 0x3b, 0x80, 0x9b, + 0x11, 0x12, 0x7b, 0xbb, 0x3b, 0xf9, 0xd7, 0xaf, 0x36, 0x32, 0xbc, 0x21, 0x67, 0xa8, 0xdc, 0x5e, + 0x47, 0xfa, 0x5b, 0x80, 0xac, 0x8c, 0x2d, 0x83, 0x98, 0x30, 0xda, 0x81, 0x1c, 0x1e, 0xb7, 0xb1, + 0x61, 0x3b, 0x77, 0x87, 0xe9, 0x77, 0x33, 0xc6, 0xdd, 0x70, 0x38, 0x9b, 0x31, 0xd9, 0x13, 0x43, + 0x8f, 0x38, 0x36, 0x13, 0x0d, 0xb3, 0x70, 0x71, 0x3f, 0x38, 0xf3, 0x6b, 0x07, 0x9c, 0x61, 0x81, + 0x7e, 0x3d, 0x52, 0x2a, 0x84, 0xce, 0x3c, 0xe2, 0xe8, 0x4c, 0x72, 0xce, 0xc7, 0x02, 0xf0, 0x4c, + 0x3d, 0x00, 0xcf, 0xa4, 0xe6, 0x4c, 0x33, 0x02, 0x9f, 0xf9, 0xb5, 0x83, 0xcf, 0xa4, 0xe7, 0x8c, + 0x38, 0x04, 0xd0, 0xfc, 0x6e, 0x02, 0xa0, 0xd9, 0x8c, 0x14, 0x9d, 0x82, 0xd0, 0x1c, 0x4d, 0x20, + 0x34, 0x59, 0xaa, 0xe4, 0xe7, 0x91, 0x4a, 0xe6, 0x40, 0x34, 0x47, 0x13, 0x10, 0x4d, 0x6e, 0x8e, + 0xc2, 0x39, 0x18, 0xcd, 0x5f, 0x4c, 0xc7, 0x68, 0x20, 0x12, 0x45, 0xe1, 0xc3, 0x5c, 0x0c, 0xa4, + 0x51, 0x22, 0x40, 0x9a, 0x7c, 0xe4, 0xbd, 0x9f, 0xa9, 0x5f, 0x18, 0xa5, 0xf9, 0xfd, 0x34, 0x94, + 0x66, 0x25, 0x12, 0x60, 0xe2, 0x56, 0xb9, 0x08, 0x4c, 0x73, 0x3a, 0x05, 0xa6, 0x29, 0x44, 0xc2, + 0x3f, 0x4c, 0xf1, 0x02, 0x38, 0xcd, 0xe9, 0x14, 0x9c, 0xa6, 0x38, 0x57, 0xed, 0x5c, 0xa0, 0xe6, + 0x49, 0x10, 0xa8, 0x29, 0x45, 0xdc, 0x83, 0x3d, 0x67, 0x10, 0x81, 0xd4, 0x9c, 0x47, 0x21, 0x35, + 0x0c, 0xa1, 0x7a, 0x3b, 0x52, 0xe3, 0x12, 0x50, 0xcd, 0xd1, 0x04, 0x54, 0x23, 0xce, 0xb1, 0xe1, + 0x05, 0xb1, 0x1a, 0xe9, 0x17, 0x24, 0x4a, 0x87, 0xdc, 0x1d, 0x71, 0xdd, 0xd8, 0x34, 0x75, 0x93, + 0xa3, 0x2b, 0xac, 0x21, 0xdd, 0x27, 0x77, 0x6d, 0xcf, 0xb5, 0xcd, 0xc0, 0x6f, 0xca, 0x50, 0x0c, + 0xb8, 0x33, 0xe9, 0x1f, 0x05, 0x4f, 0x96, 0x22, 0x38, 0xfe, 0x7b, 0x7a, 0x8e, 0xdf, 0xd3, 0x43, + 0x77, 0xcb, 0x5c, 0x20, 0xd7, 0xf0, 0x67, 0x33, 0x1c, 0xb0, 0x51, 0xbd, 0x2c, 0xe6, 0x01, 0xac, + 0xd0, 0xbc, 0x97, 0xc5, 0x8a, 0x40, 0x38, 0x2a, 0x93, 0x0e, 0xb6, 0x0a, 0x2c, 0x2e, 0xbd, 0x03, + 0xab, 0x3e, 0x5e, 0xf7, 0x72, 0xcc, 0x50, 0x0b, 0xd1, 0xe5, 0xae, 0xf1, 0x5b, 0xf2, 0xbf, 0x26, + 0xbc, 0x15, 0xf2, 0x90, 0x9e, 0x69, 0xa0, 0x8c, 0xf0, 0xa3, 0x41, 0x99, 0xe8, 0x4b, 0x3a, 0xfa, + 0x18, 0xd6, 0x02, 0x78, 0x8d, 0x93, 0x56, 0x26, 0x96, 0x83, 0x6d, 0x62, 0xbe, 0x2c, 0xc7, 0xed, + 0x41, 0x9f, 0xc0, 0x2d, 0x9a, 0x20, 0x47, 0xa4, 0xae, 0xc9, 0xc5, 0x52, 0xd7, 0x1b, 0x44, 0x47, + 0x7d, 0x4a, 0xfa, 0x1a, 0x01, 0xe6, 0xa4, 0x22, 0xc0, 0x1c, 0x74, 0x00, 0x85, 0x2e, 0x1e, 0x62, + 0x4b, 0xb3, 0x94, 0x25, 0xee, 0x9c, 0x02, 0xc9, 0xf8, 0x9b, 0x31, 0x39, 0xcf, 0x65, 0x49, 0xef, + 0xdf, 0x08, 0xc2, 0x4e, 0x19, 0x8a, 0x8a, 0x5f, 0x9d, 0xf4, 0x3f, 0x82, 0x67, 0x96, 0x2e, 0x5a, + 0xd4, 0xd6, 0x3b, 0xcc, 0x7c, 0x8b, 0x32, 0xfd, 0x4d, 0x6e, 0x57, 0x7d, 0xbd, 0xcb, 0x2d, 0x90, + 0xfc, 0x24, 0x5c, 0x6e, 0x81, 0x24, 0xc7, 0x23, 0xec, 0x1a, 0xa4, 0xb4, 0x61, 0x07, 0x8f, 0xb9, + 0x91, 0xb1, 0x06, 0x91, 0x7d, 0x81, 0xaf, 0xb8, 0x29, 0x91, 0x9f, 0x84, 0x8f, 0x9e, 0x33, 0x3a, + 0x97, 0x82, 0xcc, 0x1a, 0xe8, 0x7d, 0xc8, 0xd1, 0x2a, 0x97, 0xa2, 0x1b, 0x16, 0x8f, 0x91, 0x81, + 0x54, 0x8e, 0x55, 0xa4, 0xb6, 0x8e, 0x09, 0xcf, 0x91, 0x61, 0xc9, 0x59, 0x83, 0xff, 0xf2, 0x25, + 0x5b, 0xd9, 0x40, 0xb2, 0x75, 0x1b, 0x72, 0x64, 0xf4, 0x96, 0xa1, 0xb6, 0x31, 0x8d, 0x6f, 0x39, + 0xd9, 0x23, 0x48, 0xff, 0x24, 0x40, 0x39, 0x14, 0x72, 0xa7, 0xce, 0xdd, 0x39, 0x95, 0xf1, 0x20, + 0x7a, 0x36, 0x31, 0xfb, 0x3b, 0x00, 0x5d, 0xd5, 0x52, 0x5e, 0xaa, 0x43, 0x1b, 0x77, 0xf8, 0x12, + 0xe4, 0xba, 0xaa, 0xf5, 0x9c, 0x12, 0x82, 0x83, 0x49, 0x85, 0x06, 0xe3, 0xc3, 0x6f, 0xd2, 0x7e, + 0xfc, 0x06, 0x55, 0x21, 0x6b, 0x98, 0x9a, 0x6e, 0x6a, 0xf6, 0x15, 0x5d, 0x93, 0x84, 0xec, 0xb6, + 0xa5, 0x63, 0xb8, 0x36, 0x35, 0xda, 0xa3, 0xc7, 0x90, 0xf3, 0x12, 0x05, 0x81, 0x26, 0xb5, 0x33, + 0x60, 0x31, 0x8f, 0x97, 0x2c, 0xc9, 0xb5, 0xa9, 0xf1, 0x1e, 0x35, 0x20, 0x6d, 0x62, 0x6b, 0xd4, + 0x67, 0x49, 0x76, 0xe9, 0xe1, 0x3b, 0x8b, 0xe5, 0x09, 0x84, 0x3a, 0xea, 0xdb, 0x32, 0x17, 0x96, + 0x3e, 0x85, 0x34, 0xa3, 0xa0, 0x3c, 0x64, 0x4e, 0x0f, 0x9f, 0x1e, 0x1e, 0x3d, 0x3f, 0x14, 0x63, + 0x08, 0x20, 0x5d, 0xab, 0xd7, 0x1b, 0xc7, 0x2d, 0x51, 0x40, 0x39, 0x48, 0xd5, 0x76, 0x8e, 0xe4, + 0x96, 0x18, 0x27, 0x64, 0xb9, 0xb1, 0xdf, 0xa8, 0xb7, 0xc4, 0x04, 0x5a, 0x81, 0x22, 0xfb, 0xad, + 0x3c, 0x39, 0x92, 0x9f, 0xd5, 0x5a, 0x62, 0xd2, 0x47, 0x3a, 0x69, 0x1c, 0xee, 0x36, 0x64, 0x31, + 0x25, 0xfd, 0x0a, 0x6e, 0x46, 0x66, 0x16, 0x1e, 0x72, 0x26, 0xf8, 0x90, 0x33, 0xe9, 0xdb, 0x38, + 0xb9, 0x3a, 0x45, 0xa5, 0x0b, 0x68, 0x3f, 0x34, 0xf1, 0x87, 0x4b, 0xe4, 0x1a, 0xa1, 0xd9, 0xa3, + 0xb7, 0xa0, 0x64, 0xe2, 0x0b, 0x6c, 0xb7, 0x7b, 0x2c, 0x7d, 0x71, 0x00, 0xb0, 0x22, 0xa7, 0x52, + 0x21, 0x8b, 0xb1, 0x7d, 0x86, 0xdb, 0xb6, 0xc2, 0x8c, 0xc0, 0xa2, 0x30, 0x43, 0x8e, 0xb0, 0x11, + 0xea, 0x09, 0x23, 0x12, 0xff, 0xcf, 0xfc, 0x14, 0x53, 0x95, 0xa4, 0xaa, 0x80, 0xba, 0x1d, 0x4a, + 0x91, 0x5e, 0x2e, 0xb5, 0xd8, 0x39, 0x48, 0xc9, 0x8d, 0x96, 0xfc, 0x91, 0x98, 0x40, 0x08, 0x4a, + 0xf4, 0xa7, 0x72, 0x72, 0x58, 0x3b, 0x3e, 0x69, 0x1e, 0x91, 0xc5, 0x5e, 0x85, 0xb2, 0xb3, 0xd8, + 0x0e, 0x31, 0x85, 0xae, 0xc1, 0x4a, 0xfd, 0xe8, 0xd9, 0xf1, 0x41, 0xa3, 0xd5, 0xf0, 0xc8, 0x69, + 0xa9, 0x0a, 0x95, 0xa8, 0x14, 0x49, 0xfa, 0xcf, 0x04, 0xdc, 0x88, 0x48, 0x73, 0xd0, 0xfb, 0x00, + 0xf6, 0x58, 0x31, 0x71, 0x5b, 0x37, 0x3b, 0xd1, 0x86, 0xdb, 0x1a, 0xcb, 0x94, 0x43, 0xce, 0xd9, + 0xfc, 0xd7, 0xcc, 0x58, 0xf1, 0x5b, 0xae, 0x94, 0x2c, 0x84, 0xc5, 0x01, 0x9b, 0x3b, 0x53, 0x6e, + 0xa0, 0xb8, 0x4d, 0x14, 0xd3, 0xfd, 0xa2, 0x8a, 0x29, 0x3f, 0xfa, 0x08, 0x6e, 0x84, 0x42, 0x1a, + 0x8f, 0x03, 0xd6, 0xb4, 0x02, 0xef, 0xf4, 0xc8, 0x76, 0x2d, 0x18, 0xd9, 0x58, 0x1c, 0xb0, 0x66, + 0xa0, 0x23, 0xa9, 0x37, 0x40, 0x47, 0xa2, 0x42, 0x63, 0x7a, 0xd9, 0x8a, 0xc6, 0xb4, 0xd0, 0x18, + 0x4a, 0x39, 0x32, 0xe1, 0x94, 0x43, 0xfa, 0xdf, 0xc0, 0xee, 0x06, 0x53, 0xcb, 0x23, 0x48, 0x5b, + 0xb6, 0x6a, 0x8f, 0x2c, 0x7e, 0x92, 0x1e, 0x2f, 0x9a, 0xa7, 0x6e, 0x39, 0x3f, 0x4e, 0xa8, 0xb8, + 0xcc, 0xd5, 0xfc, 0x41, 0x6e, 0x7a, 0xd4, 0xf6, 0xa4, 0x7e, 0x8a, 0xed, 0x69, 0x42, 0x1a, 0x5f, + 0xe2, 0xa1, 0x6d, 0x55, 0xd2, 0x74, 0xc6, 0xd7, 0x27, 0x67, 0x4c, 0xba, 0x77, 0x2a, 0x24, 0xf7, + 0xf9, 0xef, 0x57, 0x1b, 0x22, 0xe3, 0x7e, 0x5b, 0x1f, 0x68, 0x36, 0x1e, 0x18, 0xf6, 0x95, 0xcc, + 0xe5, 0xa5, 0xf7, 0xa0, 0x14, 0x5c, 0xf4, 0x68, 0x17, 0xe2, 0x39, 0xe9, 0xb8, 0xf4, 0x0f, 0x02, + 0xac, 0x4e, 0xc1, 0x72, 0xd0, 0x63, 0x5e, 0x08, 0x62, 0x1b, 0x7f, 0x77, 0x72, 0xf5, 0x02, 0xec, + 0x5e, 0x3d, 0x88, 0x04, 0x4d, 0xef, 0xea, 0xc0, 0xf6, 0xd8, 0x23, 0xa0, 0x5f, 0x42, 0xd9, 0xd2, + 0xba, 0x43, 0xc5, 0x64, 0xb0, 0x90, 0x5b, 0x64, 0x21, 0x99, 0x3d, 0xe9, 0x70, 0x4a, 0x91, 0x1d, + 0x92, 0xf9, 0x20, 0x10, 0x95, 0x10, 0xb7, 0xd4, 0x06, 0x34, 0x79, 0x93, 0x99, 0x06, 0x5c, 0x09, + 0x6f, 0x00, 0x5c, 0xfd, 0xbd, 0x00, 0xb7, 0x66, 0xdc, 0x6e, 0xd0, 0x87, 0xa1, 0x73, 0xf1, 0xc1, + 0x32, 0x77, 0xa3, 0x2d, 0x46, 0x0b, 0x9e, 0x0c, 0xe9, 0x11, 0x14, 0xfc, 0xf4, 0xc5, 0x36, 0x6f, + 0xdf, 0x8b, 0xfd, 0x41, 0x80, 0xed, 0x2e, 0x14, 0x4d, 0x6c, 0x13, 0x27, 0x15, 0x40, 0x24, 0x0b, + 0x8c, 0xc8, 0xd2, 0xd4, 0xfd, 0x64, 0x56, 0x10, 0xe3, 0xae, 0xfd, 0xfc, 0x9b, 0x00, 0xe0, 0xa1, + 0x6e, 0x1e, 0xea, 0x25, 0xf8, 0x51, 0xaf, 0x10, 0x58, 0x1a, 0x0f, 0x83, 0xa5, 0xe8, 0x1e, 0x94, + 0xd9, 0x7d, 0x84, 0xec, 0x9b, 0x6a, 0x8f, 0x4c, 0xcc, 0x31, 0xb6, 0x12, 0x25, 0x9f, 0x38, 0x54, + 0xf4, 0x31, 0xdc, 0xb4, 0x7b, 0x26, 0xb6, 0x7a, 0x7a, 0xbf, 0xa3, 0x84, 0xf7, 0x8e, 0xd5, 0x7e, + 0x36, 0xe6, 0x18, 0x9d, 0x7c, 0xc3, 0xd5, 0x70, 0x16, 0xdc, 0xbf, 0x2f, 0x20, 0x45, 0x8f, 0x0d, + 0x49, 0xfa, 0x5c, 0x2b, 0xce, 0x71, 0x03, 0xfd, 0x04, 0x40, 0xb5, 0x6d, 0x53, 0x3b, 0x1f, 0x11, + 0xef, 0x10, 0x9f, 0xfc, 0x94, 0x77, 0xec, 0x6a, 0x0e, 0xdf, 0xce, 0x6d, 0x7e, 0xfe, 0xd6, 0x3c, + 0x51, 0xdf, 0x19, 0xf4, 0x29, 0x94, 0x0e, 0xa1, 0x14, 0x94, 0x75, 0xb2, 0x69, 0x36, 0x86, 0x60, + 0x36, 0xcd, 0xb2, 0x73, 0x9e, 0x4d, 0xbb, 0xb9, 0x78, 0x82, 0xd5, 0x6c, 0x69, 0x43, 0xfa, 0x41, + 0x80, 0x82, 0xdf, 0xeb, 0x2d, 0x9c, 0xf0, 0xf2, 0x0b, 0x40, 0x62, 0xf2, 0x02, 0x90, 0xf4, 0xa5, + 0xc0, 0x37, 0x21, 0x4b, 0x52, 0xe0, 0x91, 0x85, 0x3b, 0xbc, 0x92, 0x9d, 0xe9, 0xaa, 0xd6, 0xa9, + 0x85, 0x3b, 0x3e, 0xdf, 0x94, 0x79, 0x33, 0xdf, 0x14, 0x4c, 0xa4, 0xb3, 0xa1, 0x44, 0x7a, 0x3f, + 0x99, 0x4d, 0x89, 0x69, 0xd9, 0x97, 0x89, 0x4b, 0x7f, 0x2d, 0x40, 0xd6, 0x9d, 0x6f, 0xb0, 0x84, + 0x1b, 0xc0, 0x65, 0xd9, 0x72, 0xb1, 0x02, 0x2e, 0xbf, 0xba, 0xb0, 0x82, 0x76, 0xc2, 0x2d, 0x68, + 0xff, 0xc6, 0x4d, 0x06, 0xa3, 0x90, 0x47, 0xff, 0xe2, 0x3a, 0x60, 0x33, 0xcf, 0x7d, 0xff, 0x8e, + 0x8f, 0x83, 0x64, 0x2c, 0xe8, 0x4f, 0x20, 0xad, 0xb6, 0x5d, 0xbc, 0xb5, 0x34, 0x05, 0x88, 0x74, + 0x58, 0xb7, 0x5a, 0xe3, 0x1a, 0xe5, 0x94, 0xb9, 0x04, 0x1f, 0x55, 0xdc, 0x19, 0x95, 0x74, 0x40, + 0xf4, 0x32, 0x9e, 0xe0, 0x49, 0x2f, 0x01, 0x9c, 0x1e, 0x3e, 0x3b, 0xda, 0xdd, 0x7b, 0xb2, 0xd7, + 0xd8, 0xe5, 0xd9, 0xde, 0xee, 0x6e, 0x63, 0x57, 0x8c, 0x13, 0x3e, 0xb9, 0xf1, 0xec, 0xe8, 0xac, + 0xb1, 0x2b, 0x26, 0x48, 0x63, 0xb7, 0x71, 0x50, 0xfb, 0xa8, 0xb1, 0x2b, 0x26, 0xa5, 0x1a, 0xe4, + 0xdc, 0xa0, 0x43, 0x2b, 0xff, 0xfa, 0x4b, 0x6c, 0xf2, 0xd5, 0x62, 0x0d, 0xb4, 0x0e, 0xf9, 0xc9, + 0x82, 0x01, 0xb9, 0xbc, 0xb1, 0x3a, 0x01, 0x09, 0x03, 0x65, 0x57, 0x07, 0x8f, 0x4d, 0xbf, 0x81, + 0x8c, 0x31, 0x3a, 0x57, 0x1c, 0xdb, 0x0d, 0xc1, 0xec, 0xce, 0xdd, 0x6e, 0x74, 0xde, 0xd7, 0xda, + 0x4f, 0xf1, 0x15, 0x0f, 0x72, 0x69, 0x63, 0x74, 0xfe, 0x94, 0x99, 0x38, 0x1b, 0x46, 0x7c, 0xc6, + 0x30, 0x12, 0xa1, 0x61, 0xa0, 0x7b, 0x50, 0x18, 0xea, 0x1d, 0xac, 0xa8, 0x9d, 0x8e, 0x89, 0x2d, + 0x16, 0xbb, 0x73, 0x5c, 0x73, 0x9e, 0xf4, 0xd4, 0x58, 0x87, 0xf4, 0x9d, 0x00, 0x68, 0x32, 0xd0, + 0xa2, 0x13, 0x58, 0xf1, 0x62, 0xb5, 0x93, 0x00, 0xb0, 0x48, 0xb0, 0x19, 0x1d, 0xa8, 0x03, 0xf8, + 0x82, 0x78, 0x19, 0x24, 0x93, 0xac, 0x6f, 0xcd, 0x73, 0x55, 0x06, 0x9d, 0x2f, 0x5d, 0x94, 0xf8, + 0x82, 0x8b, 0x12, 0x93, 0x91, 0x2b, 0xef, 0xf6, 0x84, 0x5d, 0x69, 0x62, 0xa2, 0xee, 0x64, 0x40, + 0xa5, 0x35, 0x21, 0xc6, 0xe7, 0x19, 0x35, 0x24, 0xe1, 0x4d, 0x86, 0x24, 0x3d, 0x02, 0xf1, 0x43, + 0xf7, 0xfb, 0x5e, 0xfe, 0xe8, 0x1f, 0xa6, 0x30, 0x31, 0xcc, 0x4b, 0xc8, 0x12, 0xef, 0x4b, 0x83, + 0xc6, 0x9f, 0x42, 0xce, 0x5d, 0x3d, 0xf7, 0xf1, 0x50, 0xe4, 0xb2, 0xf3, 0x91, 0x78, 0x22, 0xe8, + 0x01, 0xac, 0x90, 0xb8, 0xe1, 0x54, 0x7f, 0x19, 0x42, 0x18, 0xa7, 0xde, 0xb0, 0xcc, 0x3a, 0x0e, + 0x1c, 0x58, 0x8b, 0xc4, 0x68, 0x91, 0xc5, 0x72, 0xdc, 0xf9, 0xff, 0x18, 0x00, 0xb9, 0xf3, 0x85, + 0x80, 0x52, 0xb6, 0x87, 0xc5, 0x40, 0x32, 0x21, 0xfd, 0x65, 0x1c, 0xf2, 0xbe, 0x6a, 0x14, 0xfa, + 0xe3, 0x40, 0x62, 0xb5, 0x39, 0xab, 0x72, 0xe5, 0xcb, 0xaa, 0x02, 0x13, 0x8b, 0x2f, 0x3f, 0xb1, + 0xa8, 0x3a, 0xa0, 0x53, 0x94, 0x4e, 0x2e, 0x5d, 0x94, 0x7e, 0x1b, 0x90, 0xad, 0xdb, 0x6a, 0x9f, + 0x04, 0x6f, 0x6d, 0xd8, 0x55, 0xd8, 0x69, 0x67, 0x85, 0x70, 0x91, 0xf6, 0x9c, 0xd1, 0x8e, 0x63, + 0x42, 0x97, 0xfa, 0x90, 0x75, 0x81, 0x89, 0xe5, 0xdf, 0xe4, 0x4c, 0x2b, 0xbe, 0x57, 0x21, 0x3b, + 0xc0, 0xb6, 0x4a, 0xc3, 0x1e, 0x03, 0xaa, 0xdc, 0xf6, 0x83, 0x0f, 0x20, 0xef, 0x7b, 0xa8, 0x44, + 0x22, 0xe1, 0x61, 0xe3, 0xb9, 0x18, 0xab, 0x66, 0xbe, 0xfc, 0x7a, 0x33, 0x71, 0x88, 0x5f, 0x92, + 0x4f, 0xc9, 0x8d, 0x7a, 0xb3, 0x51, 0x7f, 0x2a, 0x0a, 0xd5, 0xfc, 0x97, 0x5f, 0x6f, 0x66, 0x64, + 0x4c, 0x0b, 0x37, 0x0f, 0x9e, 0x42, 0x39, 0xb4, 0x03, 0x41, 0x07, 0x8d, 0xa0, 0xb4, 0x7b, 0x7a, + 0x7c, 0xb0, 0x57, 0xaf, 0xb5, 0x1a, 0xca, 0xd9, 0x51, 0xab, 0x21, 0x0a, 0xe8, 0x06, 0xac, 0x1e, + 0xec, 0xfd, 0x59, 0xb3, 0xa5, 0xd4, 0x0f, 0xf6, 0x1a, 0x87, 0x2d, 0xa5, 0xd6, 0x6a, 0xd5, 0xea, + 0x4f, 0xc5, 0xf8, 0xc3, 0x7f, 0xc9, 0x43, 0xb9, 0xb6, 0x53, 0xdf, 0xab, 0x19, 0x46, 0x5f, 0x6b, + 0xab, 0xd4, 0xdd, 0xd7, 0x21, 0x49, 0x51, 0xe7, 0x99, 0x6f, 0xa1, 0xab, 0xb3, 0xab, 0x71, 0xe8, + 0x09, 0xa4, 0x28, 0x20, 0x8d, 0x66, 0x3f, 0x8e, 0xae, 0xce, 0x29, 0xcf, 0x91, 0xc1, 0xd0, 0x73, + 0x33, 0xf3, 0xb5, 0x74, 0x75, 0x76, 0xb5, 0x0e, 0x1d, 0x40, 0xc6, 0x01, 0xe3, 0xe6, 0x3d, 0x61, + 0xae, 0xce, 0x2d, 0xa1, 0x91, 0xa9, 0x31, 0x50, 0x73, 0xf6, 0x43, 0xea, 0xea, 0x9c, 0x3a, 0x1e, + 0x92, 0x21, 0xe7, 0xc1, 0xdc, 0xf3, 0xdf, 0x74, 0x57, 0x17, 0xa8, 0x2b, 0xa2, 0x4f, 0xa1, 0x18, + 0x84, 0xed, 0x16, 0x7b, 0x6e, 0x5d, 0x5d, 0xb0, 0xe6, 0x47, 0xf4, 0x07, 0x31, 0xbc, 0xc5, 0x9e, + 0x5f, 0x57, 0x17, 0x2c, 0x01, 0xa2, 0xcf, 0x60, 0x65, 0x12, 0x63, 0x5b, 0xfc, 0x35, 0x76, 0x75, + 0x89, 0xa2, 0x20, 0x1a, 0x00, 0x9a, 0x82, 0xcd, 0x2d, 0xf1, 0x38, 0xbb, 0xba, 0x4c, 0x8d, 0x10, + 0x75, 0x41, 0x9c, 0x78, 0x2e, 0xb7, 0xf0, 0x63, 0xed, 0xea, 0xe2, 0x05, 0x43, 0xd4, 0x81, 0x72, + 0x18, 0x04, 0x5b, 0xf4, 0xf1, 0x76, 0x75, 0xe1, 0xf2, 0x21, 0xfb, 0x4a, 0x10, 0x8c, 0x59, 0xf4, + 0x31, 0x77, 0x75, 0xe1, 0x6a, 0x22, 0x3a, 0x05, 0xf0, 0x5d, 0xa2, 0x17, 0x78, 0xdc, 0x5d, 0x5d, + 0xa4, 0xae, 0x88, 0x0c, 0x58, 0x9d, 0x76, 0x6b, 0x5e, 0xe6, 0xad, 0x77, 0x75, 0xa9, 0x72, 0x23, + 0x39, 0x38, 0xc1, 0x0b, 0xf0, 0x62, 0x6f, 0xbf, 0xab, 0x0b, 0xd6, 0x1d, 0x77, 0x76, 0xbe, 0x79, + 0xbd, 0x2e, 0x7c, 0xfb, 0x7a, 0x5d, 0xf8, 0xee, 0xf5, 0xba, 0xf0, 0xd5, 0xf7, 0xeb, 0xb1, 0x6f, + 0xbf, 0x5f, 0x8f, 0xfd, 0xc7, 0xf7, 0xeb, 0xb1, 0x3f, 0xbf, 0xdf, 0xd5, 0xec, 0xde, 0xe8, 0x7c, + 0xab, 0xad, 0x0f, 0xe8, 0x7f, 0x7a, 0x0c, 0xf5, 0x6a, 0x9b, 0xe9, 0x24, 0x2d, 0xdf, 0x3f, 0x87, + 0xce, 0xd3, 0x34, 0xa8, 0x3e, 0xfa, 0xbf, 0x00, 0x00, 0x00, 0xff, 0xff, 0x0c, 0x9b, 0xee, 0x1d, + 0x59, 0x34, 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. @@ -4748,6 +4749,7 @@ type ABCIApplicationClient interface { OfferSnapshot(ctx context.Context, in *RequestOfferSnapshot, opts ...grpc.CallOption) (*ResponseOfferSnapshot, error) LoadSnapshotChunk(ctx context.Context, in *RequestLoadSnapshotChunk, opts ...grpc.CallOption) (*ResponseLoadSnapshotChunk, error) ApplySnapshotChunk(ctx context.Context, in *RequestApplySnapshotChunk, opts ...grpc.CallOption) (*ResponseApplySnapshotChunk, error) + FinalizeSnapshot(ctx context.Context, in *RequestFinalizeSnapshot, opts ...grpc.CallOption) (*ResponseFinalizeSnapshot, error) PrepareProposal(ctx context.Context, in *RequestPrepareProposal, opts ...grpc.CallOption) (*ResponsePrepareProposal, error) ProcessProposal(ctx context.Context, in *RequestProcessProposal, opts ...grpc.CallOption) (*ResponseProcessProposal, error) ExtendVote(ctx context.Context, in *RequestExtendVote, opts ...grpc.CallOption) (*ResponseExtendVote, error) @@ -4853,6 +4855,15 @@ func (c *aBCIApplicationClient) ApplySnapshotChunk(ctx context.Context, in *Requ return out, nil } +func (c *aBCIApplicationClient) FinalizeSnapshot(ctx context.Context, in *RequestFinalizeSnapshot, opts ...grpc.CallOption) (*ResponseFinalizeSnapshot, error) { + out := new(ResponseFinalizeSnapshot) + err := c.cc.Invoke(ctx, "/tendermint.abci.ABCIApplication/FinalizeSnapshot", in, out, opts...) + if err != nil { + return nil, err + } + return out, nil +} + func (c *aBCIApplicationClient) PrepareProposal(ctx context.Context, in *RequestPrepareProposal, opts ...grpc.CallOption) (*ResponsePrepareProposal, error) { out := new(ResponsePrepareProposal) err := c.cc.Invoke(ctx, "/tendermint.abci.ABCIApplication/PrepareProposal", in, out, opts...) @@ -4911,6 +4922,7 @@ type ABCIApplicationServer interface { OfferSnapshot(context.Context, *RequestOfferSnapshot) (*ResponseOfferSnapshot, error) LoadSnapshotChunk(context.Context, *RequestLoadSnapshotChunk) (*ResponseLoadSnapshotChunk, error) ApplySnapshotChunk(context.Context, *RequestApplySnapshotChunk) (*ResponseApplySnapshotChunk, error) + FinalizeSnapshot(context.Context, *RequestFinalizeSnapshot) (*ResponseFinalizeSnapshot, error) PrepareProposal(context.Context, *RequestPrepareProposal) (*ResponsePrepareProposal, error) ProcessProposal(context.Context, *RequestProcessProposal) (*ResponseProcessProposal, error) ExtendVote(context.Context, *RequestExtendVote) (*ResponseExtendVote, error) @@ -4952,6 +4964,9 @@ func (*UnimplementedABCIApplicationServer) LoadSnapshotChunk(ctx context.Context func (*UnimplementedABCIApplicationServer) ApplySnapshotChunk(ctx context.Context, req *RequestApplySnapshotChunk) (*ResponseApplySnapshotChunk, error) { return nil, status.Errorf(codes.Unimplemented, "method ApplySnapshotChunk not implemented") } +func (*UnimplementedABCIApplicationServer) FinalizeSnapshot(ctx context.Context, req *RequestFinalizeSnapshot) (*ResponseFinalizeSnapshot, error) { + return nil, status.Errorf(codes.Unimplemented, "method FinalizeSnapshot not implemented") +} func (*UnimplementedABCIApplicationServer) PrepareProposal(ctx context.Context, req *RequestPrepareProposal) (*ResponsePrepareProposal, error) { return nil, status.Errorf(codes.Unimplemented, "method PrepareProposal not implemented") } @@ -5152,6 +5167,24 @@ func _ABCIApplication_ApplySnapshotChunk_Handler(srv interface{}, ctx context.Co return interceptor(ctx, in, info, handler) } +func _ABCIApplication_FinalizeSnapshot_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) { + in := new(RequestFinalizeSnapshot) + if err := dec(in); err != nil { + return nil, err + } + if interceptor == nil { + return srv.(ABCIApplicationServer).FinalizeSnapshot(ctx, in) + } + info := &grpc.UnaryServerInfo{ + Server: srv, + FullMethod: "/tendermint.abci.ABCIApplication/FinalizeSnapshot", + } + handler := func(ctx context.Context, req interface{}) (interface{}, error) { + return srv.(ABCIApplicationServer).FinalizeSnapshot(ctx, req.(*RequestFinalizeSnapshot)) + } + return interceptor(ctx, in, info, handler) +} + func _ABCIApplication_PrepareProposal_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) { in := new(RequestPrepareProposal) if err := dec(in); err != nil { @@ -5286,6 +5319,10 @@ var _ABCIApplication_serviceDesc = grpc.ServiceDesc{ MethodName: "ApplySnapshotChunk", Handler: _ABCIApplication_ApplySnapshotChunk_Handler, }, + { + MethodName: "FinalizeSnapshot", + Handler: _ABCIApplication_FinalizeSnapshot_Handler, + }, { MethodName: "PrepareProposal", Handler: _ABCIApplication_PrepareProposal_Handler, diff --git a/internal/statesync/mocks/stateprovider.go b/internal/statesync/mocks/stateprovider.go index 8ac2b1544c..a4189eb08e 100644 --- a/internal/statesync/mocks/stateprovider.go +++ b/internal/statesync/mocks/stateprovider.go @@ -145,6 +145,65 @@ func (_c *StateProvider_Commit_Call) RunAndReturn(run func(context.Context, uint return _c } +// LightBlock provides a mock function with given fields: ctx, height +func (_m *StateProvider) LightBlock(ctx context.Context, height uint64) (*types.LightBlock, error) { + ret := _m.Called(ctx, height) + + if len(ret) == 0 { + panic("no return value specified for LightBlock") + } + + var r0 *types.LightBlock + var r1 error + if rf, ok := ret.Get(0).(func(context.Context, uint64) (*types.LightBlock, error)); ok { + return rf(ctx, height) + } + if rf, ok := ret.Get(0).(func(context.Context, uint64) *types.LightBlock); ok { + r0 = rf(ctx, height) + } else { + if ret.Get(0) != nil { + r0 = ret.Get(0).(*types.LightBlock) + } + } + + if rf, ok := ret.Get(1).(func(context.Context, uint64) error); ok { + r1 = rf(ctx, height) + } else { + r1 = ret.Error(1) + } + + return r0, r1 +} + +// StateProvider_LightBlock_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'LightBlock' +type StateProvider_LightBlock_Call struct { + *mock.Call +} + +// LightBlock is a helper method to define mock.On call +// - ctx context.Context +// - height uint64 +func (_e *StateProvider_Expecter) LightBlock(ctx interface{}, height interface{}) *StateProvider_LightBlock_Call { + return &StateProvider_LightBlock_Call{Call: _e.mock.On("LightBlock", ctx, height)} +} + +func (_c *StateProvider_LightBlock_Call) Run(run func(ctx context.Context, height uint64)) *StateProvider_LightBlock_Call { + _c.Call.Run(func(args mock.Arguments) { + run(args[0].(context.Context), args[1].(uint64)) + }) + return _c +} + +func (_c *StateProvider_LightBlock_Call) Return(_a0 *types.LightBlock, _a1 error) *StateProvider_LightBlock_Call { + _c.Call.Return(_a0, _a1) + return _c +} + +func (_c *StateProvider_LightBlock_Call) RunAndReturn(run func(context.Context, uint64) (*types.LightBlock, error)) *StateProvider_LightBlock_Call { + _c.Call.Return(run) + return _c +} + // State provides a mock function with given fields: ctx, height func (_m *StateProvider) State(ctx context.Context, height uint64) (state.State, error) { ret := _m.Called(ctx, height) diff --git a/internal/statesync/stateprovider.go b/internal/statesync/stateprovider.go index a76c6d546e..cd6104df52 100644 --- a/internal/statesync/stateprovider.go +++ b/internal/statesync/stateprovider.go @@ -40,6 +40,8 @@ type StateProvider interface { Commit(ctx context.Context, height uint64) (*types.Commit, error) // State returns a state object at the given height. State(ctx context.Context, height uint64) (sm.State, error) + // LightBlock returns light block at the given height. + LightBlock(ctx context.Context, height uint64) (*types.LightBlock, error) } type stateProviderRPC struct { @@ -124,6 +126,13 @@ func (s *stateProviderRPC) Commit(ctx context.Context, height uint64) (*types.Co return header.Commit, nil } +// LightBlock implements StateProvider. +func (s *stateProviderRPC) LightBlock(ctx context.Context, height uint64) (*types.LightBlock, error) { + s.Lock() + defer s.Unlock() + return s.verifyLightBlockAtHeight(ctx, height, time.Now()) +} + // State implements StateProvider. func (s *stateProviderRPC) State(ctx context.Context, height uint64) (sm.State, error) { s.Lock() @@ -264,6 +273,13 @@ func (s *stateProviderP2P) Commit(ctx context.Context, height uint64) (*types.Co return header.Commit, nil } +// LightBlock implements StateProvider. +func (s *stateProviderP2P) LightBlock(ctx context.Context, height uint64) (*types.LightBlock, error) { + s.Lock() + defer s.Unlock() + return s.verifyLightBlockAtHeight(ctx, height, time.Now()) +} + // State implements StateProvider. func (s *stateProviderP2P) State(ctx context.Context, height uint64) (sm.State, error) { s.Lock() diff --git a/internal/statesync/syncer.go b/internal/statesync/syncer.go index 24ce2eb0a6..aff823cc2b 100644 --- a/internal/statesync/syncer.go +++ b/internal/statesync/syncer.go @@ -350,7 +350,8 @@ func (s *syncer) Sync(ctx context.Context, snapshot *snapshot, queue *chunkQueue "err", err, "height", snapshot.Height) return sm.State{}, nil, errRejectSnapshot } - commit, err := s.getStateProvider().Commit(pctx, snapshot.Height) + block, err := s.getStateProvider().LightBlock(pctx, snapshot.Height) + if err != nil { // check if the provider context exceeded the 10 second deadline if ctx.Err() != nil { @@ -358,9 +359,9 @@ func (s *syncer) Sync(ctx context.Context, snapshot *snapshot, queue *chunkQueue } if err == light.ErrNoWitnesses { return sm.State{}, nil, - fmt.Errorf("failed to get commit at height %d. No witnesses remaining", snapshot.Height) + fmt.Errorf("failed to get light block at height %d. No witnesses remaining", snapshot.Height) } - s.logger.Info("failed to get and verify commit. Dropping snapshot and trying again", + s.logger.Info("failed to get and verify light block. Dropping snapshot and trying again", "err", err, "height", snapshot.Height) return sm.State{}, nil, errRejectSnapshot } @@ -371,6 +372,11 @@ func (s *syncer) Sync(ctx context.Context, snapshot *snapshot, queue *chunkQueue return sm.State{}, nil, err } + // Finalize + if err := s.finalizeSnapshot(ctx, snapshot, block); err != nil { + return sm.State{}, nil, fmt.Errorf("failed to finalize snapshot: %w", err) + } + // Verify app and app version if err := s.verifyApp(ctx, snapshot, state.Version.Consensus.App); err != nil { return sm.State{}, nil, err @@ -382,7 +388,7 @@ func (s *syncer) Sync(ctx context.Context, snapshot *snapshot, queue *chunkQueue "version", snapshot.Version, "hash", snapshot.Hash) - return state, commit, nil + return state, block.Commit, nil } // offerSnapshot offers a snapshot to the app. It returns various errors depending on the app's @@ -572,6 +578,26 @@ func (s *syncer) requestChunk(ctx context.Context, snapshot *snapshot, chunkID t return s.chunkCh.Send(ctx, msg) } +// / finalizeSnapshot sends light block to ABCI app after state sync is done +func (s *syncer) finalizeSnapshot(ctx context.Context, snapshot *snapshot, block *types.LightBlock) error { + s.logger.Info("Finalizing snapshot restoration", + "snapshot", snapshot.Hash.String(), + "height", snapshot.Height, + "version", snapshot.Version, + "app_hash", snapshot.trustedAppHash, + ) + lightBlock, err := block.ToProto() + if err != nil { + return fmt.Errorf("failed to convert light block %s to proto: %w", lightBlock.String(), err) + } + + _, err = s.conn.FinalizeSnapshot(ctx, &abci.RequestFinalizeSnapshot{ + LightBlock: lightBlock, + }) + + return err +} + // verifyApp verifies the sync, checking the app hash, last block height and app version func (s *syncer) verifyApp(ctx context.Context, snapshot *snapshot, appVersion uint64) error { resp, err := s.conn.Info(ctx, &proxy.RequestInfo) diff --git a/proto/tendermint/abci/types.proto b/proto/tendermint/abci/types.proto index 143fd5cc92..4a10c16abb 100644 --- a/proto/tendermint/abci/types.proto +++ b/proto/tendermint/abci/types.proto @@ -905,6 +905,7 @@ service ABCIApplication { rpc OfferSnapshot(RequestOfferSnapshot) returns (ResponseOfferSnapshot); rpc LoadSnapshotChunk(RequestLoadSnapshotChunk) returns (ResponseLoadSnapshotChunk); rpc ApplySnapshotChunk(RequestApplySnapshotChunk) returns (ResponseApplySnapshotChunk); + rpc FinalizeSnapshot(RequestFinalizeSnapshot) returns (ResponseFinalizeSnapshot); rpc PrepareProposal(RequestPrepareProposal) returns (ResponsePrepareProposal); rpc ProcessProposal(RequestProcessProposal) returns (ResponseProcessProposal); rpc ExtendVote(RequestExtendVote) returns (ResponseExtendVote); diff --git a/spec/abci++/api.md b/spec/abci++/api.md index abc33a6eb7..8d10026a8c 100644 --- a/spec/abci++/api.md +++ b/spec/abci++/api.md @@ -1395,6 +1395,7 @@ TxAction contains App-provided information on what to do with a transaction that | OfferSnapshot | [RequestOfferSnapshot](#tendermint-abci-RequestOfferSnapshot) | [ResponseOfferSnapshot](#tendermint-abci-ResponseOfferSnapshot) | | | LoadSnapshotChunk | [RequestLoadSnapshotChunk](#tendermint-abci-RequestLoadSnapshotChunk) | [ResponseLoadSnapshotChunk](#tendermint-abci-ResponseLoadSnapshotChunk) | | | ApplySnapshotChunk | [RequestApplySnapshotChunk](#tendermint-abci-RequestApplySnapshotChunk) | [ResponseApplySnapshotChunk](#tendermint-abci-ResponseApplySnapshotChunk) | | +| FinalizeSnapshot | [RequestFinalizeSnapshot](#tendermint-abci-RequestFinalizeSnapshot) | [ResponseFinalizeSnapshot](#tendermint-abci-ResponseFinalizeSnapshot) | | | PrepareProposal | [RequestPrepareProposal](#tendermint-abci-RequestPrepareProposal) | [ResponsePrepareProposal](#tendermint-abci-ResponsePrepareProposal) | | | ProcessProposal | [RequestProcessProposal](#tendermint-abci-RequestProcessProposal) | [ResponseProcessProposal](#tendermint-abci-ResponseProcessProposal) | | | ExtendVote | [RequestExtendVote](#tendermint-abci-RequestExtendVote) | [ResponseExtendVote](#tendermint-abci-ResponseExtendVote) | |