diff --git a/UPGRADING.md b/UPGRADING.md
index 78b5313945..7ea642aad2 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -70,6 +70,25 @@ opening context or calling `Stop`/`Wait` alone does not close the head file.
See [service lifecycle](docs/architecture/service-lifecycle.md) for ownership
and migration boundaries.
+### ABCI: ApplyBlockRandomness and commit beacon fields
+
+The ABCI version is 1.5.0. The `Application` interface and the gRPC `ABCIApplication` service gain
+`ApplyBlockRandomness`, which hands the application a block's random beacon from consensus version 2.
+This release never calls it, at any consensus version.
+
+- Go applications that do not embed `abci/types.BaseApplication` must implement the method to
+ compile. `BaseApplication.ApplyBlockRandomness` returns `ErrApplyBlockRandomnessNotImplemented`,
+ not an empty response, so an application must implement it before its chain moves to consensus
+ version 2.
+- With the routed ABCI transport, a method no routing rule names goes to the `*` client. Route
+ `ApplyBlockRandomness` to the client that runs `ProcessProposal`, since it answers for the state
+ `ProcessProposal` left.
+- `Commit` and `CommitInfo` gain `beacon` and `app_hash`. At every consensus version, a commit whose
+ beacon and app hash are not both empty, or exactly 96 and 32 bytes, is refused, and a block's
+ last commit is read without malformed ones. Before consensus version 2, nodes drop well-sized ones
+ from the commits they adopt, from the previous height's commit they store from a block, and from the
+ last commit they pass to the application.
+
### ABCI: commit vote-extension verification
Tenderdash now calls `VerifyVoteExtension` after `ProcessProposal` and before it
diff --git a/abci/client/grpc_client.go b/abci/client/grpc_client.go
index 0ffed9b399..b66dea9390 100644
--- a/abci/client/grpc_client.go
+++ b/abci/client/grpc_client.go
@@ -274,3 +274,7 @@ func (cli *grpcClient) VerifyVoteExtension(ctx context.Context, params *types.Re
func (cli *grpcClient) FinalizeBlock(ctx context.Context, params *types.RequestFinalizeBlock) (*types.ResponseFinalizeBlock, error) {
return cli.client.FinalizeBlock(ctx, types.ToRequestFinalizeBlock(params).GetFinalizeBlock(), grpc.WaitForReady(true))
}
+
+func (cli *grpcClient) ApplyBlockRandomness(ctx context.Context, params *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error) {
+ return cli.client.ApplyBlockRandomness(ctx, types.ToRequestApplyBlockRandomness(params).GetApplyBlockRandomness(), grpc.WaitForReady(true))
+}
diff --git a/abci/client/mocks/client.go b/abci/client/mocks/client.go
index b39444b38f..e75bf4676b 100644
--- a/abci/client/mocks/client.go
+++ b/abci/client/mocks/client.go
@@ -47,6 +47,74 @@ func (_m *Client) EXPECT() *Client_Expecter {
return &Client_Expecter{mock: &_m.Mock}
}
+// ApplyBlockRandomness provides a mock function for the type Client
+func (_mock *Client) ApplyBlockRandomness(context1 context.Context, requestApplyBlockRandomness *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error) {
+ ret := _mock.Called(context1, requestApplyBlockRandomness)
+
+ if len(ret) == 0 {
+ panic("no return value specified for ApplyBlockRandomness")
+ }
+
+ var r0 *types.ResponseApplyBlockRandomness
+ var r1 error
+ if returnFunc, ok := ret.Get(0).(func(context.Context, *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error)); ok {
+ return returnFunc(context1, requestApplyBlockRandomness)
+ }
+ if returnFunc, ok := ret.Get(0).(func(context.Context, *types.RequestApplyBlockRandomness) *types.ResponseApplyBlockRandomness); ok {
+ r0 = returnFunc(context1, requestApplyBlockRandomness)
+ } else {
+ if ret.Get(0) != nil {
+ r0 = ret.Get(0).(*types.ResponseApplyBlockRandomness)
+ }
+ }
+ if returnFunc, ok := ret.Get(1).(func(context.Context, *types.RequestApplyBlockRandomness) error); ok {
+ r1 = returnFunc(context1, requestApplyBlockRandomness)
+ } else {
+ r1 = ret.Error(1)
+ }
+ return r0, r1
+}
+
+// Client_ApplyBlockRandomness_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'ApplyBlockRandomness'
+type Client_ApplyBlockRandomness_Call struct {
+ *mock.Call
+}
+
+// ApplyBlockRandomness is a helper method to define mock.On call
+// - context1 context.Context
+// - requestApplyBlockRandomness *types.RequestApplyBlockRandomness
+func (_e *Client_Expecter) ApplyBlockRandomness(context1 any, requestApplyBlockRandomness any) *Client_ApplyBlockRandomness_Call {
+ return &Client_ApplyBlockRandomness_Call{Call: _e.mock.On("ApplyBlockRandomness", context1, requestApplyBlockRandomness)}
+}
+
+func (_c *Client_ApplyBlockRandomness_Call) Run(run func(context1 context.Context, requestApplyBlockRandomness *types.RequestApplyBlockRandomness)) *Client_ApplyBlockRandomness_Call {
+ _c.Call.Run(func(args mock.Arguments) {
+ var arg0 context.Context
+ if args[0] != nil {
+ arg0 = args[0].(context.Context)
+ }
+ var arg1 *types.RequestApplyBlockRandomness
+ if args[1] != nil {
+ arg1 = args[1].(*types.RequestApplyBlockRandomness)
+ }
+ run(
+ arg0,
+ arg1,
+ )
+ })
+ return _c
+}
+
+func (_c *Client_ApplyBlockRandomness_Call) Return(responseApplyBlockRandomness *types.ResponseApplyBlockRandomness, err error) *Client_ApplyBlockRandomness_Call {
+ _c.Call.Return(responseApplyBlockRandomness, err)
+ return _c
+}
+
+func (_c *Client_ApplyBlockRandomness_Call) RunAndReturn(run func(context1 context.Context, requestApplyBlockRandomness *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error)) *Client_ApplyBlockRandomness_Call {
+ _c.Call.Return(run)
+ return _c
+}
+
// ApplySnapshotChunk provides a mock function for the type Client
func (_mock *Client) ApplySnapshotChunk(context1 context.Context, requestApplySnapshotChunk *types.RequestApplySnapshotChunk) (*types.ResponseApplySnapshotChunk, error) {
ret := _mock.Called(context1, requestApplySnapshotChunk)
diff --git a/abci/client/routed_client.go b/abci/client/routed_client.go
index 492eed2617..df57b9a457 100644
--- a/abci/client/routed_client.go
+++ b/abci/client/routed_client.go
@@ -392,3 +392,8 @@ func (cli *routedClient) FinalizeBlock(ctx context.Context, req *types.RequestFi
result, err := cli.delegate(ctx, req)
return result.(*types.ResponseFinalizeBlock), err
}
+
+func (cli *routedClient) ApplyBlockRandomness(ctx context.Context, req *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error) {
+ result, err := cli.delegate(ctx, req)
+ return result.(*types.ResponseApplyBlockRandomness), err
+}
diff --git a/abci/client/routed_client_test.go b/abci/client/routed_client_test.go
index 89abdd943f..2665202ed7 100644
--- a/abci/client/routed_client_test.go
+++ b/abci/client/routed_client_test.go
@@ -26,6 +26,7 @@ import (
// * when a request of type FinalizeBlock is made, it should be first routed to queryApp, then to consensusApp
// * when a request of type CheckTx is made, it should be routed to queryApp
// * when a request of type PrepareProposal is made, it should be routed to to consensusApp
+// * when a request of type ApplyBlockRandomness is made, it should be routed to consensusApp
func TestRouting(t *testing.T) {
ctx, cancel := context.WithCancel(context.Background())
defer cancel()
@@ -65,10 +66,14 @@ func TestRouting(t *testing.T) {
consensusApp.On("FinalizeBlock", mock.Anything, mock.Anything).Return(&types.ResponseFinalizeBlock{
RetainHeight: 1,
}, nil).Once()
+ consensusApp.On("ApplyBlockRandomness", mock.Anything, mock.Anything).Return(&types.ResponseApplyBlockRandomness{
+ AppHash: []byte("final apphash"),
+ }, nil).Once()
addr := fmt.Sprintf("CheckTx:socket:%s", querySocket) +
fmt.Sprintf(",FinalizeBlock:socket:%s,FinalizeBlock:socket:%s", querySocket, consensusSocket) +
fmt.Sprintf(",PrepareProposal:socket:%s", consensusSocket) +
+ fmt.Sprintf(",ApplyBlockRandomness:socket:%s", consensusSocket) +
fmt.Sprintf(",*:socket:%s", defaultSocket)
logger.Info("configuring routed abci client with address", "addr", addr)
@@ -102,6 +107,11 @@ func TestRouting(t *testing.T) {
_, err = routedClient.PrepareProposal(ctx, &types.RequestPrepareProposal{})
assert.NoError(t, err)
+ // ApplyBlockRandomness
+ randomness, err := routedClient.ApplyBlockRandomness(ctx, &types.RequestApplyBlockRandomness{})
+ assert.NoError(t, err)
+ assert.EqualValues(t, "final apphash", randomness.AppHash)
+
// unlock info
assert.False(t, infoExecuted)
infoMtx.Unlock()
diff --git a/abci/client/socket_client.go b/abci/client/socket_client.go
index fb046187d8..5c3b2a8270 100644
--- a/abci/client/socket_client.go
+++ b/abci/client/socket_client.go
@@ -397,6 +397,14 @@ func (cli *socketClient) FinalizeBlock(ctx context.Context, req *types.RequestFi
return res.GetFinalizeBlock(), nil
}
+func (cli *socketClient) ApplyBlockRandomness(ctx context.Context, req *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error) {
+ res, err := cli.doRequest(ctx, types.ToRequestApplyBlockRandomness(req))
+ if err != nil {
+ return nil, err
+ }
+ return res.GetApplyBlockRandomness(), nil
+}
+
//----------------------------------------
func resMatchesReq(req *types.Request, res *types.Response) (ok bool) {
@@ -431,6 +439,8 @@ func resMatchesReq(req *types.Request, res *types.Response) (ok bool) {
_, ok = res.Value.(*types.Response_OfferSnapshot)
case *types.Request_FinalizeBlock:
_, ok = res.Value.(*types.Response_FinalizeBlock)
+ case *types.Request_ApplyBlockRandomness:
+ _, ok = res.Value.(*types.Response_ApplyBlockRandomness)
}
return ok
}
diff --git a/abci/example/kvstore/kvstore.go b/abci/example/kvstore/kvstore.go
index 02e287e7a0..2b8d3075ac 100644
--- a/abci/example/kvstore/kvstore.go
+++ b/abci/example/kvstore/kvstore.go
@@ -47,8 +47,12 @@ type Application struct {
// LastCommittedState is last state that was committed by Tenderdash and finalized with abci.FinalizeBlock()
LastCommittedState State
// roundStates contains state for each round, indexed by roundKey()
- roundStates map[string]State
- RetainBlocks int64 // blocks to retain after commit (via ResponseCommit.RetainHeight)
+ roundStates map[string]State
+ // processedBlocks maps each block ProcessProposal executed at this height, by round and block hash,
+ // to its key in roundStates. Two blocks of one round, from an equivocating proposer, have
+ // different keys.
+ processedBlocks map[processedBlock]string
+ RetainBlocks int64 // blocks to retain after commit (via ResponseCommit.RetainHeight)
// preparedProposals stores info about all rounds that got PrepareProposal executed, used to detect
// duplicate PrepareProposal calls.
@@ -218,6 +222,7 @@ func newApplication(stateStore StoreFactory, opts ...OptFunc) (*Application, err
logger: log.NewNopLogger(),
LastCommittedState: NewKvState(dbm.NewMemDB(), initialHeight), // initial state to avoid InitChain() in unit tests
roundStates: map[string]State{},
+ processedBlocks: map[processedBlock]string{},
preparedProposals: map[int32]bool{},
processedProposals: map[int32][]byte{},
validatorSetUpdates: map[int64]abci.ValidatorSetUpdate{},
@@ -392,6 +397,8 @@ func (app *Application) ProcessProposal(_ context.Context, req *abci.RequestProc
Status: abci.ResponseProcessProposal_REJECT,
}, err
}
+ block := processedBlock{round: req.Round, hash: string(req.Hash)}
+ app.processedBlocks[block] = roundKey(roundState.GetAppHash(), roundState.GetHeight(), roundState.GetRound())
if req.Version.App != app.appVersionForHeight(req.Height) {
app.logger.Error("app version mismatch in process proposal request",
@@ -490,6 +497,39 @@ func (app *Application) FinalizeBlock(_ context.Context, req *abci.RequestFinali
return resp, nil
}
+// ApplyBlockRandomness implements ABCI. The example application uses no randomness, so it returns
+// the app hash of the state that ProcessProposal left for the block and round.
+func (app *Application) ApplyBlockRandomness(_ context.Context, req *abci.RequestApplyBlockRandomness) (*abci.ResponseApplyBlockRandomness, error) {
+ app.mu.Lock()
+ defer app.mu.Unlock()
+
+ roundState, err := app.processedRoundState(req.Hash, req.Height, req.Round)
+ if err != nil {
+ return nil, fmt.Errorf("apply block randomness (hash: %X): %w", req.Hash, err)
+ }
+
+ resp := &abci.ResponseApplyBlockRandomness{AppHash: roundState.GetAppHash()}
+ app.logger.Debug("ApplyBlockRandomness", "req", req, "resp", resp)
+ return resp, nil
+}
+
+// processedBlock identifies a block ProcessProposal executed at the current height.
+type processedBlock struct {
+ round int32
+ hash string
+}
+
+// processedRoundState returns the state ProcessProposal left for the block with the given hash at
+// the given height and round.
+// Caller should lock the Application.
+func (app *Application) processedRoundState(hash []byte, height int64, round int32) (State, error) {
+ state := app.roundStates[app.processedBlocks[processedBlock{round: round, hash: string(hash)}]]
+ if state == nil || state.GetHeight() != height {
+ return nil, fmt.Errorf("block not processed at height %d round %d", height, round)
+ }
+ return state, nil
+}
+
// eventValUpdate generates an event that contains info about current validator set
func (app *Application) eventValUpdate(height int64) abci.Event {
size := 0
@@ -792,6 +832,7 @@ func (app *Application) resetRoundStates() {
state.Close()
}
app.roundStates = map[string]State{}
+ app.processedBlocks = map[processedBlock]string{}
}
// executeProposal executes transactions and creates new candidate state
diff --git a/abci/example/kvstore/kvstore_test.go b/abci/example/kvstore/kvstore_test.go
index e109c851d2..43343a6c84 100644
--- a/abci/example/kvstore/kvstore_test.go
+++ b/abci/example/kvstore/kvstore_test.go
@@ -441,6 +441,13 @@ func testClient(ctx context.Context, t *testing.T, app abciclient.Client, height
require.False(t, rpp.TxResults[0].IsErr())
require.Len(t, rpp.Events, 1)
+ rabr, err := app.ApplyBlockRandomness(ctx, &types.RequestApplyBlockRandomness{
+ Height: height,
+ Beacon: tmcrypto.CRandBytes(tmtypes.SignatureSize),
+ })
+ require.NoError(t, err)
+ require.Equal(t, rpp.AppHash, rabr.AppHash, "no randomness is applied, so the app hash is unchanged")
+
rfb := &types.RequestFinalizeBlock{Height: height}
rfb.Block, rfb.BlockID = makeBlock(t, height, [][]byte{tx}, rpp.AppHash)
ar, err := app.FinalizeBlock(ctx, rfb)
@@ -644,3 +651,97 @@ func TestProcessProposalRoundReprocessing(t *testing.T) {
_, err = app.FinalizeBlock(ctx, reqFin)
require.NoError(t, err)
}
+
+// TestApplyBlockRandomness checks that ApplyBlockRandomness answers for the round that was processed,
+// gives the same answer when called again, and fails for a round that was not processed.
+func TestApplyBlockRandomness(t *testing.T) {
+ ctx, cancel := context.WithCancel(context.Background())
+ defer cancel()
+
+ app := newKvApp(ctx, t, 1)
+ const height = 1
+ resp, err := app.ProcessProposal(ctx, &types.RequestProcessProposal{
+ Txs: [][]byte{[]byte(testKey)},
+ Hash: []byte("block-hash"),
+ Height: height,
+ Round: 1,
+ Version: &pbversion.Consensus{App: uint64(height)},
+ })
+ require.NoError(t, err)
+
+ req := &types.RequestApplyBlockRandomness{
+ Hash: []byte("block-hash"),
+ Height: height,
+ Round: 1,
+ Beacon: tmcrypto.CRandBytes(tmtypes.SignatureSize),
+ }
+ first, err := app.ApplyBlockRandomness(ctx, req)
+ require.NoError(t, err)
+ require.Equal(t, resp.AppHash, first.AppHash)
+
+ again, err := app.ApplyBlockRandomness(ctx, req)
+ require.NoError(t, err)
+ require.Equal(t, first.AppHash, again.AppHash)
+
+ _, err = app.ApplyBlockRandomness(ctx, &types.RequestApplyBlockRandomness{Height: height, Round: 0})
+ require.ErrorContains(t, err, "block not processed")
+}
+
+// TestApplyBlockRandomnessEquivocation is the regression test for a node that executed two blocks of
+// one round, as with an equivocating proposer: it processed block A at round 0, then a block at round 1,
+// which lets round 0 be processed again, then the other round 0 block B, which the network committed.
+// ApplyBlockRandomness used to pick the state by height and round only and failed with "more than one
+// proposal executed", which is fatal; it now picks the state of the block the request names, and
+// refuses a block that was not processed.
+func TestApplyBlockRandomnessEquivocation(t *testing.T) {
+ ctx, cancel := context.WithCancel(context.Background())
+ defer cancel()
+
+ app := newKvApp(ctx, t, 1)
+ process := func(height int64, round int32, hash string, txs ...string) *types.ResponseProcessProposal {
+ t.Helper()
+ resp, err := app.ProcessProposal(ctx, &types.RequestProcessProposal{
+ Txs: bytes2TxsBytes(txs),
+ Hash: []byte(hash),
+ Height: height,
+ Round: round,
+ Version: &pbversion.Consensus{App: uint64(height)},
+ })
+ require.NoError(t, err)
+ return resp
+ }
+ // The app hash changes with the txs only after the initial height.
+ h1 := process(1, 0, "h1", "k=v")
+ reqFin := &types.RequestFinalizeBlock{Height: 1}
+ reqFin.Block, reqFin.BlockID = makeBlock(t, 1, [][]byte{[]byte("k=v")}, h1.AppHash)
+ _, err := app.FinalizeBlock(ctx, reqFin)
+ require.NoError(t, err)
+
+ const height = 2
+ a := process(height, 0, "block-A", "a=1")
+ process(height, 1, "block-X", "x=3")
+ b := process(height, 0, "block-B", "b=2", "c=4")
+ require.NotEqual(t, a.AppHash, b.AppHash, "two states for round 0")
+
+ apply := func(hash string) (*types.ResponseApplyBlockRandomness, error) {
+ return app.ApplyBlockRandomness(ctx, &types.RequestApplyBlockRandomness{
+ Hash: []byte(hash), Height: height, Round: 0, Beacon: tmcrypto.CRandBytes(tmtypes.SignatureSize),
+ })
+ }
+ respB, err := apply("block-B")
+ require.NoError(t, err)
+ require.EqualValues(t, b.AppHash, respB.AppHash)
+ respA, err := apply("block-A")
+ require.NoError(t, err)
+ require.EqualValues(t, a.AppHash, respA.AppHash)
+ _, err = apply("block-never-processed")
+ require.ErrorContains(t, err, "block not processed")
+}
+
+func bytes2TxsBytes(txs []string) [][]byte {
+ out := make([][]byte, 0, len(txs))
+ for _, tx := range txs {
+ out = append(out, []byte(tx))
+ }
+ return out
+}
diff --git a/abci/server/socket_server.go b/abci/server/socket_server.go
index 650d9828f2..c1ef4e627c 100644
--- a/abci/server/socket_server.go
+++ b/abci/server/socket_server.go
@@ -280,6 +280,12 @@ func (s *SocketServer) processRequest(ctx context.Context, req *types.Request) (
return nil, err
}
return types.ToResponseFinalizeBlock(res), nil
+ case *types.Request_ApplyBlockRandomness:
+ res, err := s.app.ApplyBlockRandomness(ctx, r.ApplyBlockRandomness)
+ if err != nil {
+ return nil, err
+ }
+ return types.ToResponseApplyBlockRandomness(res), nil
default:
return types.ToResponseException("Unknown request"), errors.New("unknown request type")
}
diff --git a/abci/types/application.go b/abci/types/application.go
index fe7b60bca4..157fa5c802 100644
--- a/abci/types/application.go
+++ b/abci/types/application.go
@@ -2,10 +2,14 @@ package types
import (
"context"
+ "errors"
"github.com/dashpay/tenderdash/crypto"
)
+// ErrApplyBlockRandomnessNotImplemented is returned by BaseApplication.ApplyBlockRandomness.
+var ErrApplyBlockRandomnessNotImplemented = errors.New("ApplyBlockRandomness is not implemented by the application")
+
// StateSyncer is an interface that handles the state sync protocol
type StateSyncer interface {
// ListSnapshots returns list available snapshots
@@ -42,6 +46,8 @@ type Application interface {
VerifyVoteExtension(context.Context, *RequestVerifyVoteExtension) (*ResponseVerifyVoteExtension, error)
// Deliver the decided block with its txs to the Application
FinalizeBlock(context.Context, *RequestFinalizeBlock) (*ResponseFinalizeBlock, error)
+ // Apply the block's random beacon and return the app hash the precommit signs (consensus version 2).
+ ApplyBlockRandomness(context.Context, *RequestApplyBlockRandomness) (*ResponseApplyBlockRandomness, error)
}
//-------------------------------------------------------
@@ -137,3 +143,9 @@ func (BaseApplication) FinalizeBlock(_ context.Context, _req *RequestFinalizeBlo
return &ResponseFinalizeBlock{}, nil
}
+
+// ApplyBlockRandomness returns an error: an empty app hash must never pass as an answer, so applications
+// that run at consensus version 2 must implement it.
+func (BaseApplication) ApplyBlockRandomness(_ context.Context, _req *RequestApplyBlockRandomness) (*ResponseApplyBlockRandomness, error) {
+ return nil, ErrApplyBlockRandomnessNotImplemented
+}
diff --git a/abci/types/messages.go b/abci/types/messages.go
index fed82db198..1e762f5243 100644
--- a/abci/types/messages.go
+++ b/abci/types/messages.go
@@ -117,6 +117,12 @@ func ToRequestFinalizeBlock(req *RequestFinalizeBlock) *Request {
}
}
+func ToRequestApplyBlockRandomness(req *RequestApplyBlockRandomness) *Request {
+ return &Request{
+ Value: &Request_ApplyBlockRandomness{req},
+ }
+}
+
//----------------------------------------
func ToResponseException(errStr string) *Response {
@@ -214,3 +220,9 @@ func ToResponseFinalizeBlock(res *ResponseFinalizeBlock) *Response {
Value: &Response_FinalizeBlock{res},
}
}
+
+func ToResponseApplyBlockRandomness(res *ResponseApplyBlockRandomness) *Response {
+ return &Response{
+ Value: &Response_ApplyBlockRandomness{res},
+ }
+}
diff --git a/abci/types/mocks/application.go b/abci/types/mocks/application.go
index c63b765649..e47bde6873 100644
--- a/abci/types/mocks/application.go
+++ b/abci/types/mocks/application.go
@@ -47,6 +47,74 @@ func (_m *Application) EXPECT() *Application_Expecter {
return &Application_Expecter{mock: &_m.Mock}
}
+// ApplyBlockRandomness provides a mock function for the type Application
+func (_mock *Application) ApplyBlockRandomness(context1 context.Context, requestApplyBlockRandomness *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error) {
+ ret := _mock.Called(context1, requestApplyBlockRandomness)
+
+ if len(ret) == 0 {
+ panic("no return value specified for ApplyBlockRandomness")
+ }
+
+ var r0 *types.ResponseApplyBlockRandomness
+ var r1 error
+ if returnFunc, ok := ret.Get(0).(func(context.Context, *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error)); ok {
+ return returnFunc(context1, requestApplyBlockRandomness)
+ }
+ if returnFunc, ok := ret.Get(0).(func(context.Context, *types.RequestApplyBlockRandomness) *types.ResponseApplyBlockRandomness); ok {
+ r0 = returnFunc(context1, requestApplyBlockRandomness)
+ } else {
+ if ret.Get(0) != nil {
+ r0 = ret.Get(0).(*types.ResponseApplyBlockRandomness)
+ }
+ }
+ if returnFunc, ok := ret.Get(1).(func(context.Context, *types.RequestApplyBlockRandomness) error); ok {
+ r1 = returnFunc(context1, requestApplyBlockRandomness)
+ } else {
+ r1 = ret.Error(1)
+ }
+ return r0, r1
+}
+
+// Application_ApplyBlockRandomness_Call is a *mock.Call that shadows Run/Return methods with type explicit version for method 'ApplyBlockRandomness'
+type Application_ApplyBlockRandomness_Call struct {
+ *mock.Call
+}
+
+// ApplyBlockRandomness is a helper method to define mock.On call
+// - context1 context.Context
+// - requestApplyBlockRandomness *types.RequestApplyBlockRandomness
+func (_e *Application_Expecter) ApplyBlockRandomness(context1 any, requestApplyBlockRandomness any) *Application_ApplyBlockRandomness_Call {
+ return &Application_ApplyBlockRandomness_Call{Call: _e.mock.On("ApplyBlockRandomness", context1, requestApplyBlockRandomness)}
+}
+
+func (_c *Application_ApplyBlockRandomness_Call) Run(run func(context1 context.Context, requestApplyBlockRandomness *types.RequestApplyBlockRandomness)) *Application_ApplyBlockRandomness_Call {
+ _c.Call.Run(func(args mock.Arguments) {
+ var arg0 context.Context
+ if args[0] != nil {
+ arg0 = args[0].(context.Context)
+ }
+ var arg1 *types.RequestApplyBlockRandomness
+ if args[1] != nil {
+ arg1 = args[1].(*types.RequestApplyBlockRandomness)
+ }
+ run(
+ arg0,
+ arg1,
+ )
+ })
+ return _c
+}
+
+func (_c *Application_ApplyBlockRandomness_Call) Return(responseApplyBlockRandomness *types.ResponseApplyBlockRandomness, err error) *Application_ApplyBlockRandomness_Call {
+ _c.Call.Return(responseApplyBlockRandomness, err)
+ return _c
+}
+
+func (_c *Application_ApplyBlockRandomness_Call) RunAndReturn(run func(context1 context.Context, requestApplyBlockRandomness *types.RequestApplyBlockRandomness) (*types.ResponseApplyBlockRandomness, error)) *Application_ApplyBlockRandomness_Call {
+ _c.Call.Return(run)
+ return _c
+}
+
// ApplySnapshotChunk provides a mock function for the type Application
func (_mock *Application) ApplySnapshotChunk(context1 context.Context, requestApplySnapshotChunk *types.RequestApplySnapshotChunk) (*types.ResponseApplySnapshotChunk, error) {
ret := _mock.Called(context1, requestApplySnapshotChunk)
diff --git a/abci/types/types.pb.go b/abci/types/types.pb.go
index 3f535c820a..cf5c8fe994 100644
--- a/abci/types/types.pb.go
+++ b/abci/types/types.pb.go
@@ -125,7 +125,7 @@ func (x ResponseOfferSnapshot_Result) String() string {
}
func (ResponseOfferSnapshot_Result) EnumDescriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{25, 0}
+ return fileDescriptor_252557cfdd89a31a, []int{26, 0}
}
type ResponseApplySnapshotChunk_Result int32
@@ -165,7 +165,7 @@ func (x ResponseApplySnapshotChunk_Result) String() string {
}
func (ResponseApplySnapshotChunk_Result) EnumDescriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{27, 0}
+ return fileDescriptor_252557cfdd89a31a, []int{28, 0}
}
type ResponseProcessProposal_ProposalStatus int32
@@ -193,7 +193,7 @@ func (x ResponseProcessProposal_ProposalStatus) String() string {
}
func (ResponseProcessProposal_ProposalStatus) EnumDescriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{29, 0}
+ return fileDescriptor_252557cfdd89a31a, []int{30, 0}
}
type ResponseVerifyVoteExtension_VerifyStatus int32
@@ -221,7 +221,7 @@ func (x ResponseVerifyVoteExtension_VerifyStatus) String() string {
}
func (ResponseVerifyVoteExtension_VerifyStatus) EnumDescriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{32, 0}
+ return fileDescriptor_252557cfdd89a31a, []int{33, 0}
}
// TxAction contains App-provided information on what to do with a transaction that is part of a raw proposal
@@ -256,7 +256,7 @@ func (x TxRecord_TxAction) String() string {
}
func (TxRecord_TxAction) EnumDescriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{39, 0}
+ return fileDescriptor_252557cfdd89a31a, []int{41, 0}
}
// Request types
@@ -277,6 +277,7 @@ type Request struct {
// *Request_ExtendVote
// *Request_VerifyVoteExtension
// *Request_FinalizeBlock
+ // *Request_ApplyBlockRandomness
Value isRequest_Value `protobuf_oneof:"value"`
}
@@ -364,22 +365,26 @@ type Request_VerifyVoteExtension struct {
type Request_FinalizeBlock struct {
FinalizeBlock *RequestFinalizeBlock `protobuf:"bytes,19,opt,name=finalize_block,json=finalizeBlock,proto3,oneof" json:"finalize_block,omitempty"`
}
-
-func (*Request_Echo) isRequest_Value() {}
-func (*Request_Flush) isRequest_Value() {}
-func (*Request_Info) isRequest_Value() {}
-func (*Request_InitChain) isRequest_Value() {}
-func (*Request_Query) isRequest_Value() {}
-func (*Request_CheckTx) isRequest_Value() {}
-func (*Request_ListSnapshots) isRequest_Value() {}
-func (*Request_OfferSnapshot) isRequest_Value() {}
-func (*Request_LoadSnapshotChunk) isRequest_Value() {}
-func (*Request_ApplySnapshotChunk) isRequest_Value() {}
-func (*Request_PrepareProposal) isRequest_Value() {}
-func (*Request_ProcessProposal) isRequest_Value() {}
-func (*Request_ExtendVote) isRequest_Value() {}
-func (*Request_VerifyVoteExtension) isRequest_Value() {}
-func (*Request_FinalizeBlock) isRequest_Value() {}
+type Request_ApplyBlockRandomness struct {
+ ApplyBlockRandomness *RequestApplyBlockRandomness `protobuf:"bytes,20,opt,name=apply_block_randomness,json=applyBlockRandomness,proto3,oneof" json:"apply_block_randomness,omitempty"`
+}
+
+func (*Request_Echo) isRequest_Value() {}
+func (*Request_Flush) isRequest_Value() {}
+func (*Request_Info) isRequest_Value() {}
+func (*Request_InitChain) isRequest_Value() {}
+func (*Request_Query) isRequest_Value() {}
+func (*Request_CheckTx) isRequest_Value() {}
+func (*Request_ListSnapshots) isRequest_Value() {}
+func (*Request_OfferSnapshot) isRequest_Value() {}
+func (*Request_LoadSnapshotChunk) isRequest_Value() {}
+func (*Request_ApplySnapshotChunk) isRequest_Value() {}
+func (*Request_PrepareProposal) isRequest_Value() {}
+func (*Request_ProcessProposal) isRequest_Value() {}
+func (*Request_ExtendVote) isRequest_Value() {}
+func (*Request_VerifyVoteExtension) isRequest_Value() {}
+func (*Request_FinalizeBlock) isRequest_Value() {}
+func (*Request_ApplyBlockRandomness) isRequest_Value() {}
func (m *Request) GetValue() isRequest_Value {
if m != nil {
@@ -493,6 +498,13 @@ func (m *Request) GetFinalizeBlock() *RequestFinalizeBlock {
return nil
}
+func (m *Request) GetApplyBlockRandomness() *RequestApplyBlockRandomness {
+ if x, ok := m.GetValue().(*Request_ApplyBlockRandomness); ok {
+ return x.ApplyBlockRandomness
+ }
+ return nil
+}
+
// XXX_OneofWrappers is for the internal use of the proto package.
func (*Request) XXX_OneofWrappers() []interface{} {
return []interface{}{
@@ -511,6 +523,7 @@ func (*Request) XXX_OneofWrappers() []interface{} {
(*Request_ExtendVote)(nil),
(*Request_VerifyVoteExtension)(nil),
(*Request_FinalizeBlock)(nil),
+ (*Request_ApplyBlockRandomness)(nil),
}
}
@@ -1506,6 +1519,8 @@ func (m *RequestProcessProposal) GetQuorumHash() []byte {
// a commit vector, to learn the expected vector without signing or broadcasting.
// The call must be free of side effects. Threshold-recoverable extensions must be
// deterministic and match the vector accepted at commit-level VerifyVoteExtension.
+// From consensus version 2, ApplyBlockRandomness runs first, but the extensions
+// must not depend on the beacon or on the state it produced.
// See the [ExtendVote contract](methods.md#extendvote).
type RequestExtendVote struct {
Hash []byte `protobuf:"bytes,1,opt,name=hash,proto3" json:"hash,omitempty"`
@@ -1721,6 +1736,8 @@ func (m *RequestVerifyVoteExtension) GetVoteExtensions() []*ExtendVoteExtension
// and events are provided through proposal processing, not ResponseFinalizeBlock.
// The response contains retention and next-block scheduling hints only.
// Use retain_height with care: pruning blocks can prevent replay and bootstrapping.
+// From consensus version 2, the state to persist is that candidate with commit.beacon
+// applied, as ApplyBlockRandomness applies it, and its root must equal commit.app_hash.
// See the [FinalizeBlock contract](methods.md#finalizeblock) and
// [commit and apply](../consensus/consensus-happy-path.md#9-commit-and-apply).
type RequestFinalizeBlock struct {
@@ -1822,6 +1839,110 @@ func (m *RequestFinalizeBlock) GetBlockID() *types1.BlockID {
return nil
}
+// Applies the block's randomness and returns the app hash the Precommit signs.
+//
+// #### Usage
+//
+// - Used from consensus version 2 (`VersionParams.consensus_version`). Before that, Tenderdash never calls it.
+// This release never calls it, at any consensus version.
+// - `RequestApplyBlockRandomness.beacon` is the random beacon of the block and round: the 96-byte BLS threshold
+// signature recovered from the Prevotes of round `round` for the block `hash`. Tenderdash has verified it against
+// the quorum's threshold public key before the call.
+// - The Application applies the randomness to the state that `ProcessProposal` (or `PrepareProposal`) left for
+// that block and round, and returns the resulting Merkle root hash in `ResponseApplyBlockRandomness.app_hash`.
+// When nothing in the block uses randomness, `app_hash` equals the app hash of the block header.
+// - The header keeps the app hash from `ProcessProposal`, which Prevotes sign. Precommits and the commit sign
+// `ResponseApplyBlockRandomness.app_hash`, and the commit carries it in `Commit.app_hash`.
+// - The randomness may change only the application state behind `app_hash`. Transaction results, events,
+// validator set updates, consensus parameter updates and the other outputs of `ProcessProposal` are fixed
+// by the header the Prevotes signed: they MUST NOT depend on the beacon, and Tenderdash keeps the ones
+// `ProcessProposal` returned.
+// - Vote extensions and their verification MUST NOT depend on the beacon or on the state this call produces;
+// see `ExtendVote`.
+// - The implementation MUST be deterministic: every process that applies the same beacon to the same block
+// and round MUST return the same `app_hash`.
+// - Tenderdash may call it more than once for the same block, round and beacon; the Application MUST return
+// the same `app_hash` each time.
+// - It MUST NOT modify the committed state: Tenderdash may call it for a round that never commits, and
+// `FinalizeBlock` commits the state for the commit round.
+// - An ABCI error is fatal, as for `ExtendVote`.
+//
+// #### When does Tenderdash call it?
+//
+// - On a validator, once the Prevotes of round _r_ for block _v_ reach the threshold and their signature is
+// recovered, before `ExtendVote` and before signing its Precommit for _v_.
+// - On every path that finalizes a block from a commit (consensus, block sync, replay, a node that did not
+// vote): after `ProcessProposal` of the committed block for the commit round, with the commit's beacon, and
+// before `FinalizeBlock`. Tenderdash compares the returned `app_hash` with `Commit.app_hash` and stops on a
+// mismatch.
+type RequestApplyBlockRandomness struct {
+ Hash []byte `protobuf:"bytes,1,opt,name=hash,proto3" json:"hash,omitempty"`
+ Height int64 `protobuf:"varint,2,opt,name=height,proto3" json:"height,omitempty"`
+ Round int32 `protobuf:"varint,3,opt,name=round,proto3" json:"round,omitempty"`
+ Beacon []byte `protobuf:"bytes,4,opt,name=beacon,proto3" json:"beacon,omitempty"`
+}
+
+func (m *RequestApplyBlockRandomness) Reset() { *m = RequestApplyBlockRandomness{} }
+func (m *RequestApplyBlockRandomness) String() string { return proto.CompactTextString(m) }
+func (*RequestApplyBlockRandomness) ProtoMessage() {}
+func (*RequestApplyBlockRandomness) Descriptor() ([]byte, []int) {
+ return fileDescriptor_252557cfdd89a31a, []int{16}
+}
+func (m *RequestApplyBlockRandomness) XXX_Unmarshal(b []byte) error {
+ return m.Unmarshal(b)
+}
+func (m *RequestApplyBlockRandomness) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
+ if deterministic {
+ return xxx_messageInfo_RequestApplyBlockRandomness.Marshal(b, m, deterministic)
+ } else {
+ b = b[:cap(b)]
+ n, err := m.MarshalToSizedBuffer(b)
+ if err != nil {
+ return nil, err
+ }
+ return b[:n], nil
+ }
+}
+func (m *RequestApplyBlockRandomness) XXX_Merge(src proto.Message) {
+ xxx_messageInfo_RequestApplyBlockRandomness.Merge(m, src)
+}
+func (m *RequestApplyBlockRandomness) XXX_Size() int {
+ return m.Size()
+}
+func (m *RequestApplyBlockRandomness) XXX_DiscardUnknown() {
+ xxx_messageInfo_RequestApplyBlockRandomness.DiscardUnknown(m)
+}
+
+var xxx_messageInfo_RequestApplyBlockRandomness proto.InternalMessageInfo
+
+func (m *RequestApplyBlockRandomness) GetHash() []byte {
+ if m != nil {
+ return m.Hash
+ }
+ return nil
+}
+
+func (m *RequestApplyBlockRandomness) GetHeight() int64 {
+ if m != nil {
+ return m.Height
+ }
+ return 0
+}
+
+func (m *RequestApplyBlockRandomness) GetRound() int32 {
+ if m != nil {
+ return m.Round
+ }
+ return 0
+}
+
+func (m *RequestApplyBlockRandomness) GetBeacon() []byte {
+ if m != nil {
+ return m.Beacon
+ }
+ return nil
+}
+
type Response struct {
// Types that are valid to be assigned to Value:
// *Response_Exception
@@ -1840,6 +1961,7 @@ type Response struct {
// *Response_ExtendVote
// *Response_VerifyVoteExtension
// *Response_FinalizeBlock
+ // *Response_ApplyBlockRandomness
Value isResponse_Value `protobuf_oneof:"value"`
}
@@ -1847,7 +1969,7 @@ func (m *Response) Reset() { *m = Response{} }
func (m *Response) String() string { return proto.CompactTextString(m) }
func (*Response) ProtoMessage() {}
func (*Response) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{16}
+ return fileDescriptor_252557cfdd89a31a, []int{17}
}
func (m *Response) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -1930,23 +2052,27 @@ type Response_VerifyVoteExtension struct {
type Response_FinalizeBlock struct {
FinalizeBlock *ResponseFinalizeBlock `protobuf:"bytes,16,opt,name=finalize_block,json=finalizeBlock,proto3,oneof" json:"finalize_block,omitempty"`
}
-
-func (*Response_Exception) isResponse_Value() {}
-func (*Response_Echo) isResponse_Value() {}
-func (*Response_Flush) isResponse_Value() {}
-func (*Response_Info) isResponse_Value() {}
-func (*Response_InitChain) isResponse_Value() {}
-func (*Response_Query) isResponse_Value() {}
-func (*Response_CheckTx) isResponse_Value() {}
-func (*Response_ListSnapshots) isResponse_Value() {}
-func (*Response_OfferSnapshot) isResponse_Value() {}
-func (*Response_LoadSnapshotChunk) isResponse_Value() {}
-func (*Response_ApplySnapshotChunk) isResponse_Value() {}
-func (*Response_PrepareProposal) isResponse_Value() {}
-func (*Response_ProcessProposal) isResponse_Value() {}
-func (*Response_ExtendVote) isResponse_Value() {}
-func (*Response_VerifyVoteExtension) isResponse_Value() {}
-func (*Response_FinalizeBlock) isResponse_Value() {}
+type Response_ApplyBlockRandomness struct {
+ ApplyBlockRandomness *ResponseApplyBlockRandomness `protobuf:"bytes,17,opt,name=apply_block_randomness,json=applyBlockRandomness,proto3,oneof" json:"apply_block_randomness,omitempty"`
+}
+
+func (*Response_Exception) isResponse_Value() {}
+func (*Response_Echo) isResponse_Value() {}
+func (*Response_Flush) isResponse_Value() {}
+func (*Response_Info) isResponse_Value() {}
+func (*Response_InitChain) isResponse_Value() {}
+func (*Response_Query) isResponse_Value() {}
+func (*Response_CheckTx) isResponse_Value() {}
+func (*Response_ListSnapshots) isResponse_Value() {}
+func (*Response_OfferSnapshot) isResponse_Value() {}
+func (*Response_LoadSnapshotChunk) isResponse_Value() {}
+func (*Response_ApplySnapshotChunk) isResponse_Value() {}
+func (*Response_PrepareProposal) isResponse_Value() {}
+func (*Response_ProcessProposal) isResponse_Value() {}
+func (*Response_ExtendVote) isResponse_Value() {}
+func (*Response_VerifyVoteExtension) isResponse_Value() {}
+func (*Response_FinalizeBlock) isResponse_Value() {}
+func (*Response_ApplyBlockRandomness) isResponse_Value() {}
func (m *Response) GetValue() isResponse_Value {
if m != nil {
@@ -2067,6 +2193,13 @@ func (m *Response) GetFinalizeBlock() *ResponseFinalizeBlock {
return nil
}
+func (m *Response) GetApplyBlockRandomness() *ResponseApplyBlockRandomness {
+ if x, ok := m.GetValue().(*Response_ApplyBlockRandomness); ok {
+ return x.ApplyBlockRandomness
+ }
+ return nil
+}
+
// XXX_OneofWrappers is for the internal use of the proto package.
func (*Response) XXX_OneofWrappers() []interface{} {
return []interface{}{
@@ -2086,6 +2219,7 @@ func (*Response) XXX_OneofWrappers() []interface{} {
(*Response_ExtendVote)(nil),
(*Response_VerifyVoteExtension)(nil),
(*Response_FinalizeBlock)(nil),
+ (*Response_ApplyBlockRandomness)(nil),
}
}
@@ -2098,7 +2232,7 @@ func (m *ResponseException) Reset() { *m = ResponseException{} }
func (m *ResponseException) String() string { return proto.CompactTextString(m) }
func (*ResponseException) ProtoMessage() {}
func (*ResponseException) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{17}
+ return fileDescriptor_252557cfdd89a31a, []int{18}
}
func (m *ResponseException) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2142,7 +2276,7 @@ func (m *ResponseEcho) Reset() { *m = ResponseEcho{} }
func (m *ResponseEcho) String() string { return proto.CompactTextString(m) }
func (*ResponseEcho) ProtoMessage() {}
func (*ResponseEcho) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{18}
+ return fileDescriptor_252557cfdd89a31a, []int{19}
}
func (m *ResponseEcho) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2185,7 +2319,7 @@ func (m *ResponseFlush) Reset() { *m = ResponseFlush{} }
func (m *ResponseFlush) String() string { return proto.CompactTextString(m) }
func (*ResponseFlush) ProtoMessage() {}
func (*ResponseFlush) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{19}
+ return fileDescriptor_252557cfdd89a31a, []int{20}
}
func (m *ResponseFlush) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2226,7 +2360,7 @@ func (m *ResponseInfo) Reset() { *m = ResponseInfo{} }
func (m *ResponseInfo) String() string { return proto.CompactTextString(m) }
func (*ResponseInfo) ProtoMessage() {}
func (*ResponseInfo) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{20}
+ return fileDescriptor_252557cfdd89a31a, []int{21}
}
func (m *ResponseInfo) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2310,7 +2444,7 @@ func (m *ResponseInitChain) Reset() { *m = ResponseInitChain{} }
func (m *ResponseInitChain) String() string { return proto.CompactTextString(m) }
func (*ResponseInitChain) ProtoMessage() {}
func (*ResponseInitChain) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{21}
+ return fileDescriptor_252557cfdd89a31a, []int{22}
}
func (m *ResponseInitChain) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2427,7 +2561,7 @@ func (m *ResponseQuery) Reset() { *m = ResponseQuery{} }
func (m *ResponseQuery) String() string { return proto.CompactTextString(m) }
func (*ResponseQuery) ProtoMessage() {}
func (*ResponseQuery) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{22}
+ return fileDescriptor_252557cfdd89a31a, []int{23}
}
func (m *ResponseQuery) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2533,7 +2667,7 @@ func (m *ResponseCheckTx) Reset() { *m = ResponseCheckTx{} }
func (m *ResponseCheckTx) String() string { return proto.CompactTextString(m) }
func (*ResponseCheckTx) ProtoMessage() {}
func (*ResponseCheckTx) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{23}
+ return fileDescriptor_252557cfdd89a31a, []int{24}
}
func (m *ResponseCheckTx) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2619,7 +2753,7 @@ func (m *ResponseListSnapshots) Reset() { *m = ResponseListSnapshots{} }
func (m *ResponseListSnapshots) String() string { return proto.CompactTextString(m) }
func (*ResponseListSnapshots) ProtoMessage() {}
func (*ResponseListSnapshots) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{24}
+ return fileDescriptor_252557cfdd89a31a, []int{25}
}
func (m *ResponseListSnapshots) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2663,7 +2797,7 @@ func (m *ResponseOfferSnapshot) Reset() { *m = ResponseOfferSnapshot{} }
func (m *ResponseOfferSnapshot) String() string { return proto.CompactTextString(m) }
func (*ResponseOfferSnapshot) ProtoMessage() {}
func (*ResponseOfferSnapshot) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{25}
+ return fileDescriptor_252557cfdd89a31a, []int{26}
}
func (m *ResponseOfferSnapshot) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2709,7 +2843,7 @@ func (m *ResponseLoadSnapshotChunk) Reset() { *m = ResponseLoadSnapshotC
func (m *ResponseLoadSnapshotChunk) String() string { return proto.CompactTextString(m) }
func (*ResponseLoadSnapshotChunk) ProtoMessage() {}
func (*ResponseLoadSnapshotChunk) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{26}
+ return fileDescriptor_252557cfdd89a31a, []int{27}
}
func (m *ResponseLoadSnapshotChunk) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2761,7 +2895,7 @@ func (m *ResponseApplySnapshotChunk) Reset() { *m = ResponseApplySnapsho
func (m *ResponseApplySnapshotChunk) String() string { return proto.CompactTextString(m) }
func (*ResponseApplySnapshotChunk) ProtoMessage() {}
func (*ResponseApplySnapshotChunk) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{27}
+ return fileDescriptor_252557cfdd89a31a, []int{28}
}
func (m *ResponseApplySnapshotChunk) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2839,7 +2973,7 @@ func (m *ResponsePrepareProposal) Reset() { *m = ResponsePrepareProposal
func (m *ResponsePrepareProposal) String() string { return proto.CompactTextString(m) }
func (*ResponsePrepareProposal) ProtoMessage() {}
func (*ResponsePrepareProposal) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{28}
+ return fileDescriptor_252557cfdd89a31a, []int{29}
}
func (m *ResponsePrepareProposal) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -2936,7 +3070,7 @@ func (m *ResponseProcessProposal) Reset() { *m = ResponseProcessProposal
func (m *ResponseProcessProposal) String() string { return proto.CompactTextString(m) }
func (*ResponseProcessProposal) ProtoMessage() {}
func (*ResponseProcessProposal) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{29}
+ return fileDescriptor_252557cfdd89a31a, []int{30}
}
func (m *ResponseProcessProposal) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3025,7 +3159,7 @@ func (m *ExtendVoteExtension) Reset() { *m = ExtendVoteExtension{} }
func (m *ExtendVoteExtension) String() string { return proto.CompactTextString(m) }
func (*ExtendVoteExtension) ProtoMessage() {}
func (*ExtendVoteExtension) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{30}
+ return fileDescriptor_252557cfdd89a31a, []int{31}
}
func (m *ExtendVoteExtension) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3109,7 +3243,7 @@ func (m *ResponseExtendVote) Reset() { *m = ResponseExtendVote{} }
func (m *ResponseExtendVote) String() string { return proto.CompactTextString(m) }
func (*ResponseExtendVote) ProtoMessage() {}
func (*ResponseExtendVote) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{31}
+ return fileDescriptor_252557cfdd89a31a, []int{32}
}
func (m *ResponseExtendVote) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3153,7 +3287,7 @@ func (m *ResponseVerifyVoteExtension) Reset() { *m = ResponseVerifyVoteE
func (m *ResponseVerifyVoteExtension) String() string { return proto.CompactTextString(m) }
func (*ResponseVerifyVoteExtension) ProtoMessage() {}
func (*ResponseVerifyVoteExtension) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{32}
+ return fileDescriptor_252557cfdd89a31a, []int{33}
}
func (m *ResponseVerifyVoteExtension) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3205,7 +3339,7 @@ func (m *ResponseFinalizeBlock) Reset() { *m = ResponseFinalizeBlock{} }
func (m *ResponseFinalizeBlock) String() string { return proto.CompactTextString(m) }
func (*ResponseFinalizeBlock) ProtoMessage() {}
func (*ResponseFinalizeBlock) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{33}
+ return fileDescriptor_252557cfdd89a31a, []int{34}
}
func (m *ResponseFinalizeBlock) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3248,18 +3382,72 @@ func (m *ResponseFinalizeBlock) GetProposeNextBlockImmediately() bool {
return false
}
+type ResponseApplyBlockRandomness struct {
+ // The Merkle root hash of the application state after the randomness is applied. 32 bytes.
+ // Equals the header app hash when nothing in the block uses randomness. The randomness changes
+ // nothing but this state: the other results of the block are the ones ProcessProposal returned.
+ AppHash []byte `protobuf:"bytes,1,opt,name=app_hash,json=appHash,proto3" json:"app_hash,omitempty"`
+}
+
+func (m *ResponseApplyBlockRandomness) Reset() { *m = ResponseApplyBlockRandomness{} }
+func (m *ResponseApplyBlockRandomness) String() string { return proto.CompactTextString(m) }
+func (*ResponseApplyBlockRandomness) ProtoMessage() {}
+func (*ResponseApplyBlockRandomness) Descriptor() ([]byte, []int) {
+ return fileDescriptor_252557cfdd89a31a, []int{35}
+}
+func (m *ResponseApplyBlockRandomness) XXX_Unmarshal(b []byte) error {
+ return m.Unmarshal(b)
+}
+func (m *ResponseApplyBlockRandomness) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
+ if deterministic {
+ return xxx_messageInfo_ResponseApplyBlockRandomness.Marshal(b, m, deterministic)
+ } else {
+ b = b[:cap(b)]
+ n, err := m.MarshalToSizedBuffer(b)
+ if err != nil {
+ return nil, err
+ }
+ return b[:n], nil
+ }
+}
+func (m *ResponseApplyBlockRandomness) XXX_Merge(src proto.Message) {
+ xxx_messageInfo_ResponseApplyBlockRandomness.Merge(m, src)
+}
+func (m *ResponseApplyBlockRandomness) XXX_Size() int {
+ return m.Size()
+}
+func (m *ResponseApplyBlockRandomness) XXX_DiscardUnknown() {
+ xxx_messageInfo_ResponseApplyBlockRandomness.DiscardUnknown(m)
+}
+
+var xxx_messageInfo_ResponseApplyBlockRandomness proto.InternalMessageInfo
+
+func (m *ResponseApplyBlockRandomness) GetAppHash() []byte {
+ if m != nil {
+ return m.AppHash
+ }
+ return nil
+}
+
type CommitInfo struct {
Round int32 `protobuf:"varint,1,opt,name=round,proto3" json:"round,omitempty"`
QuorumHash []byte `protobuf:"bytes,2,opt,name=quorum_hash,json=quorumHash,proto3" json:"quorum_hash,omitempty"`
BlockSignature []byte `protobuf:"bytes,3,opt,name=block_signature,json=blockSignature,proto3" json:"block_signature,omitempty"`
ThresholdVoteExtensions []*types1.VoteExtension `protobuf:"bytes,4,rep,name=threshold_vote_extensions,json=thresholdVoteExtensions,proto3" json:"threshold_vote_extensions,omitempty"`
+ // Random beacon of the committed block: the threshold signature recovered from the prevotes of
+ // the commit round. Set from consensus version 2; empty before.
+ Beacon []byte `protobuf:"bytes,5,opt,name=beacon,proto3" json:"beacon,omitempty"`
+ // App hash after `ApplyBlockRandomness` for the committed block and round. The commit signs it
+ // through the state ID of its block ID, which Tenderdash checks before passing it on.
+ // Set from consensus version 2; empty before.
+ AppHash []byte `protobuf:"bytes,6,opt,name=app_hash,json=appHash,proto3" json:"app_hash,omitempty"`
}
func (m *CommitInfo) Reset() { *m = CommitInfo{} }
func (m *CommitInfo) String() string { return proto.CompactTextString(m) }
func (*CommitInfo) ProtoMessage() {}
func (*CommitInfo) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{34}
+ return fileDescriptor_252557cfdd89a31a, []int{36}
}
func (m *CommitInfo) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3316,6 +3504,20 @@ func (m *CommitInfo) GetThresholdVoteExtensions() []*types1.VoteExtension {
return nil
}
+func (m *CommitInfo) GetBeacon() []byte {
+ if m != nil {
+ return m.Beacon
+ }
+ return nil
+}
+
+func (m *CommitInfo) GetAppHash() []byte {
+ if m != nil {
+ return m.AppHash
+ }
+ return nil
+}
+
// Event carries application attributes in ResponseProcessProposal
// and ExecTxResult.
//
@@ -3329,7 +3531,7 @@ func (m *Event) Reset() { *m = Event{} }
func (m *Event) String() string { return proto.CompactTextString(m) }
func (*Event) ProtoMessage() {}
func (*Event) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{35}
+ return fileDescriptor_252557cfdd89a31a, []int{37}
}
func (m *Event) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3383,7 +3585,7 @@ func (m *EventAttribute) Reset() { *m = EventAttribute{} }
func (m *EventAttribute) String() string { return proto.CompactTextString(m) }
func (*EventAttribute) ProtoMessage() {}
func (*EventAttribute) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{36}
+ return fileDescriptor_252557cfdd89a31a, []int{38}
}
func (m *EventAttribute) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3449,7 +3651,7 @@ func (m *ExecTxResult) Reset() { *m = ExecTxResult{} }
func (m *ExecTxResult) String() string { return proto.CompactTextString(m) }
func (*ExecTxResult) ProtoMessage() {}
func (*ExecTxResult) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{37}
+ return fileDescriptor_252557cfdd89a31a, []int{39}
}
func (m *ExecTxResult) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3541,7 +3743,7 @@ func (m *TxResult) Reset() { *m = TxResult{} }
func (m *TxResult) String() string { return proto.CompactTextString(m) }
func (*TxResult) ProtoMessage() {}
func (*TxResult) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{38}
+ return fileDescriptor_252557cfdd89a31a, []int{40}
}
func (m *TxResult) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3607,7 +3809,7 @@ func (m *TxRecord) Reset() { *m = TxRecord{} }
func (m *TxRecord) String() string { return proto.CompactTextString(m) }
func (*TxRecord) ProtoMessage() {}
func (*TxRecord) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{39}
+ return fileDescriptor_252557cfdd89a31a, []int{41}
}
func (m *TxRecord) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3660,7 +3862,7 @@ func (m *Validator) Reset() { *m = Validator{} }
func (m *Validator) String() string { return proto.CompactTextString(m) }
func (*Validator) ProtoMessage() {}
func (*Validator) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{40}
+ return fileDescriptor_252557cfdd89a31a, []int{42}
}
func (m *Validator) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3717,7 +3919,7 @@ func (m *ValidatorUpdate) Reset() { *m = ValidatorUpdate{} }
func (m *ValidatorUpdate) String() string { return proto.CompactTextString(m) }
func (*ValidatorUpdate) ProtoMessage() {}
func (*ValidatorUpdate) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{41}
+ return fileDescriptor_252557cfdd89a31a, []int{43}
}
func (m *ValidatorUpdate) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3799,7 +4001,7 @@ func (m *ValidatorSetUpdate) Reset() { *m = ValidatorSetUpdate{} }
func (m *ValidatorSetUpdate) String() string { return proto.CompactTextString(m) }
func (*ValidatorSetUpdate) ProtoMessage() {}
func (*ValidatorSetUpdate) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{42}
+ return fileDescriptor_252557cfdd89a31a, []int{44}
}
func (m *ValidatorSetUpdate) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3857,7 +4059,7 @@ func (m *ThresholdPublicKeyUpdate) Reset() { *m = ThresholdPublicKeyUpda
func (m *ThresholdPublicKeyUpdate) String() string { return proto.CompactTextString(m) }
func (*ThresholdPublicKeyUpdate) ProtoMessage() {}
func (*ThresholdPublicKeyUpdate) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{43}
+ return fileDescriptor_252557cfdd89a31a, []int{45}
}
func (m *ThresholdPublicKeyUpdate) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3901,7 +4103,7 @@ func (m *QuorumHashUpdate) Reset() { *m = QuorumHashUpdate{} }
func (m *QuorumHashUpdate) String() string { return proto.CompactTextString(m) }
func (*QuorumHashUpdate) ProtoMessage() {}
func (*QuorumHashUpdate) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{44}
+ return fileDescriptor_252557cfdd89a31a, []int{46}
}
func (m *QuorumHashUpdate) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -3947,7 +4149,7 @@ func (m *VoteInfo) Reset() { *m = VoteInfo{} }
func (m *VoteInfo) String() string { return proto.CompactTextString(m) }
func (*VoteInfo) ProtoMessage() {}
func (*VoteInfo) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{45}
+ return fileDescriptor_252557cfdd89a31a, []int{47}
}
func (m *VoteInfo) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -4004,7 +4206,7 @@ func (m *ExtendedVoteInfo) Reset() { *m = ExtendedVoteInfo{} }
func (m *ExtendedVoteInfo) String() string { return proto.CompactTextString(m) }
func (*ExtendedVoteInfo) ProtoMessage() {}
func (*ExtendedVoteInfo) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{46}
+ return fileDescriptor_252557cfdd89a31a, []int{48}
}
func (m *ExtendedVoteInfo) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -4072,7 +4274,7 @@ func (m *Misbehavior) Reset() { *m = Misbehavior{} }
func (m *Misbehavior) String() string { return proto.CompactTextString(m) }
func (*Misbehavior) ProtoMessage() {}
func (*Misbehavior) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{47}
+ return fileDescriptor_252557cfdd89a31a, []int{49}
}
func (m *Misbehavior) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -4147,7 +4349,7 @@ func (m *Snapshot) Reset() { *m = Snapshot{} }
func (m *Snapshot) String() string { return proto.CompactTextString(m) }
func (*Snapshot) ProtoMessage() {}
func (*Snapshot) Descriptor() ([]byte, []int) {
- return fileDescriptor_252557cfdd89a31a, []int{48}
+ return fileDescriptor_252557cfdd89a31a, []int{50}
}
func (m *Snapshot) XXX_Unmarshal(b []byte) error {
return m.Unmarshal(b)
@@ -4228,6 +4430,7 @@ func init() {
proto.RegisterType((*RequestExtendVote)(nil), "tendermint.abci.RequestExtendVote")
proto.RegisterType((*RequestVerifyVoteExtension)(nil), "tendermint.abci.RequestVerifyVoteExtension")
proto.RegisterType((*RequestFinalizeBlock)(nil), "tendermint.abci.RequestFinalizeBlock")
+ proto.RegisterType((*RequestApplyBlockRandomness)(nil), "tendermint.abci.RequestApplyBlockRandomness")
proto.RegisterType((*Response)(nil), "tendermint.abci.Response")
proto.RegisterType((*ResponseException)(nil), "tendermint.abci.ResponseException")
proto.RegisterType((*ResponseEcho)(nil), "tendermint.abci.ResponseEcho")
@@ -4246,6 +4449,7 @@ func init() {
proto.RegisterType((*ResponseExtendVote)(nil), "tendermint.abci.ResponseExtendVote")
proto.RegisterType((*ResponseVerifyVoteExtension)(nil), "tendermint.abci.ResponseVerifyVoteExtension")
proto.RegisterType((*ResponseFinalizeBlock)(nil), "tendermint.abci.ResponseFinalizeBlock")
+ proto.RegisterType((*ResponseApplyBlockRandomness)(nil), "tendermint.abci.ResponseApplyBlockRandomness")
proto.RegisterType((*CommitInfo)(nil), "tendermint.abci.CommitInfo")
proto.RegisterType((*Event)(nil), "tendermint.abci.Event")
proto.RegisterType((*EventAttribute)(nil), "tendermint.abci.EventAttribute")
@@ -4266,241 +4470,248 @@ func init() {
func init() { proto.RegisterFile("tendermint/abci/types.proto", fileDescriptor_252557cfdd89a31a) }
var fileDescriptor_252557cfdd89a31a = []byte{
- // 3737 bytes of a gzipped FileDescriptorProto
- 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xd4, 0x5b, 0xcb, 0x73, 0xdb, 0x56,
- 0x77, 0x27, 0xf8, 0xe6, 0xe1, 0x0b, 0xba, 0x92, 0x6d, 0x9a, 0xb6, 0x25, 0x05, 0x6e, 0x62, 0xc7,
- 0x49, 0xa4, 0xc4, 0x6e, 0xe2, 0xa4, 0x49, 0x3b, 0x43, 0x51, 0x74, 0x29, 0x59, 0x96, 0x14, 0x88,
- 0x52, 0x26, 0x4d, 0x13, 0x0c, 0x44, 0x5e, 0x89, 0x88, 0x49, 0x02, 0x01, 0x40, 0x99, 0xca, 0xb6,
- 0xcd, 0x4c, 0x27, 0x9b, 0xe6, 0x1f, 0xc8, 0xae, 0x5d, 0x76, 0xdf, 0x55, 0x3b, 0x5d, 0x35, 0x9d,
- 0x6e, 0xb2, 0xec, 0x4c, 0xa7, 0x6e, 0xc6, 0xd9, 0x75, 0x97, 0x55, 0x37, 0xdf, 0xe2, 0x9b, 0xfb,
- 0x00, 0x08, 0x10, 0x00, 0x1f, 0x71, 0x66, 0xbe, 0xf9, 0x76, 0xb8, 0xe7, 0x9e, 0x73, 0x78, 0x1f,
- 0xe7, 0x9e, 0x73, 0xee, 0xef, 0x5c, 0xc2, 0x0d, 0x1b, 0x0f, 0x3a, 0xd8, 0xec, 0x6b, 0x03, 0x7b,
- 0x53, 0x3d, 0x6d, 0x6b, 0x9b, 0xf6, 0xa5, 0x81, 0xad, 0x0d, 0xc3, 0xd4, 0x6d, 0x1d, 0x95, 0xc7,
- 0x9d, 0x1b, 0xa4, 0xb3, 0x7a, 0xcb, 0xc3, 0xdd, 0x36, 0x2f, 0x0d, 0x5b, 0xdf, 0x34, 0x4c, 0x5d,
- 0x3f, 0x63, 0xfc, 0x55, 0xaf, 0x32, 0xaa, 0x67, 0xb3, 0xa3, 0x5a, 0x5d, 0xde, 0x79, 0x33, 0xd0,
- 0x79, 0xda, 0xd3, 0xdb, 0x4f, 0x23, 0x7b, 0x3d, 0x03, 0xa9, 0xde, 0x0c, 0xfe, 0xee, 0x53, 0x7c,
- 0xe9, 0xf4, 0xde, 0x0a, 0xc8, 0x1a, 0xaa, 0xa9, 0xf6, 0x9d, 0xee, 0x55, 0x4f, 0xf7, 0x05, 0x36,
- 0x2d, 0x4d, 0x1f, 0xf8, 0x94, 0xaf, 0x9d, 0xeb, 0xfa, 0x79, 0x0f, 0x6f, 0xd2, 0xd6, 0xe9, 0xf0,
- 0x6c, 0xd3, 0xd6, 0xfa, 0xd8, 0xb2, 0xd5, 0xbe, 0xc1, 0x19, 0x56, 0xce, 0xf5, 0x73, 0x9d, 0x7e,
- 0x6e, 0x92, 0x2f, 0x46, 0x95, 0xbe, 0xc9, 0x41, 0x46, 0xc6, 0x5f, 0x0d, 0xb1, 0x65, 0xa3, 0xfb,
- 0x90, 0xc4, 0xed, 0xae, 0x5e, 0x11, 0xd6, 0x85, 0xbb, 0xf9, 0xfb, 0x37, 0x37, 0x26, 0xd6, 0x6d,
- 0x83, 0xf3, 0x35, 0xda, 0x5d, 0xbd, 0x19, 0x93, 0x29, 0x2f, 0x7a, 0x17, 0x52, 0x67, 0xbd, 0xa1,
- 0xd5, 0xad, 0xc4, 0xa9, 0xd0, 0xad, 0x28, 0xa1, 0x47, 0x84, 0xa9, 0x19, 0x93, 0x19, 0x37, 0xf9,
- 0x29, 0x6d, 0x70, 0xa6, 0x57, 0x12, 0xd3, 0x7f, 0x6a, 0x67, 0x70, 0x46, 0x7f, 0x8a, 0xf0, 0xa2,
- 0x2d, 0x00, 0x6d, 0xa0, 0xd9, 0x4a, 0xbb, 0xab, 0x6a, 0x83, 0x4a, 0x92, 0x4a, 0xbe, 0x12, 0x2d,
- 0xa9, 0xd9, 0x75, 0xc2, 0xd8, 0x8c, 0xc9, 0x39, 0xcd, 0x69, 0x90, 0xe1, 0x7e, 0x35, 0xc4, 0xe6,
- 0x65, 0x25, 0x35, 0x7d, 0xb8, 0x1f, 0x13, 0x26, 0x32, 0x5c, 0xca, 0x8d, 0x3e, 0x82, 0x6c, 0xbb,
- 0x8b, 0xdb, 0x4f, 0x15, 0x7b, 0x54, 0xc9, 0x50, 0xc9, 0xb5, 0x28, 0xc9, 0x3a, 0xe1, 0x6b, 0x8d,
- 0x9a, 0x31, 0x39, 0xd3, 0x66, 0x9f, 0x68, 0x1f, 0x4a, 0x3d, 0xcd, 0xb2, 0x15, 0x6b, 0xa0, 0x1a,
- 0x56, 0x57, 0xb7, 0xad, 0x4a, 0x9e, 0xea, 0x78, 0x35, 0x4a, 0xc7, 0x9e, 0x66, 0xd9, 0x47, 0x0e,
- 0x73, 0x33, 0x26, 0x17, 0x7b, 0x5e, 0x02, 0xd1, 0xa7, 0x9f, 0x9d, 0x61, 0xd3, 0x55, 0x58, 0x29,
- 0x4c, 0xd7, 0x77, 0x40, 0xb8, 0x1d, 0x79, 0xa2, 0x4f, 0xf7, 0x12, 0xd0, 0x67, 0xb0, 0xdc, 0xd3,
- 0xd5, 0x8e, 0xab, 0x4e, 0x69, 0x77, 0x87, 0x83, 0xa7, 0x95, 0x22, 0x55, 0xfa, 0x7a, 0xe4, 0x20,
- 0x75, 0xb5, 0xe3, 0xa8, 0xa8, 0x13, 0x81, 0x66, 0x4c, 0x5e, 0xea, 0x4d, 0x12, 0xd1, 0x17, 0xb0,
- 0xa2, 0x1a, 0x46, 0xef, 0x72, 0x52, 0x7b, 0x89, 0x6a, 0xbf, 0x17, 0xa5, 0xbd, 0x46, 0x64, 0x26,
- 0xd5, 0x23, 0x35, 0x40, 0x45, 0x2d, 0x10, 0x0d, 0x13, 0x1b, 0xaa, 0x89, 0x15, 0xc3, 0xd4, 0x0d,
- 0xdd, 0x52, 0x7b, 0x95, 0x32, 0xd5, 0x7d, 0x27, 0x4a, 0xf7, 0x21, 0xe3, 0x3f, 0xe4, 0xec, 0xcd,
- 0x98, 0x5c, 0x36, 0xfc, 0x24, 0xa6, 0x55, 0x6f, 0x63, 0xcb, 0x1a, 0x6b, 0x15, 0x67, 0x69, 0xa5,
- 0xfc, 0x7e, 0xad, 0x3e, 0x12, 0x6a, 0x40, 0x1e, 0x8f, 0x88, 0xb8, 0x72, 0xa1, 0xdb, 0xb8, 0xb2,
- 0x44, 0x15, 0x4a, 0x91, 0xe7, 0x8c, 0xb2, 0x9e, 0xe8, 0x36, 0x6e, 0xc6, 0x64, 0xc0, 0x6e, 0x0b,
- 0xa9, 0x70, 0xe5, 0x02, 0x9b, 0xda, 0xd9, 0x25, 0x55, 0xa3, 0xd0, 0x1e, 0xe2, 0x0f, 0x2a, 0x88,
- 0x2a, 0x7c, 0x23, 0x4a, 0xe1, 0x09, 0x15, 0x22, 0x2a, 0x1a, 0x8e, 0x48, 0x33, 0x26, 0x2f, 0x5f,
- 0x04, 0xc9, 0xc4, 0xc4, 0xce, 0xb4, 0x81, 0xda, 0xd3, 0xbe, 0xc6, 0x0a, 0x75, 0x70, 0x95, 0xe5,
- 0xe9, 0x26, 0xf6, 0x88, 0x73, 0x6f, 0x11, 0x66, 0x62, 0x62, 0x67, 0x5e, 0xc2, 0x56, 0x06, 0x52,
- 0x17, 0x6a, 0x6f, 0x88, 0x77, 0x93, 0xd9, 0xb4, 0x98, 0xd9, 0x4d, 0x66, 0xb3, 0x62, 0x6e, 0x37,
- 0x99, 0xcd, 0x89, 0xb0, 0x9b, 0xcc, 0x82, 0x98, 0x97, 0xee, 0x40, 0xde, 0xe3, 0x5e, 0x50, 0x05,
- 0x32, 0x7d, 0x6c, 0x59, 0xea, 0x39, 0xa6, 0xde, 0x28, 0x27, 0x3b, 0x4d, 0xa9, 0x04, 0x05, 0xaf,
- 0x4b, 0x91, 0xbe, 0x13, 0x20, 0xef, 0xf1, 0x16, 0x44, 0x92, 0xbb, 0x47, 0x47, 0x92, 0x37, 0xd1,
- 0x6d, 0x28, 0xd2, 0xa9, 0x28, 0x4e, 0x3f, 0x71, 0x59, 0x49, 0xb9, 0x40, 0x89, 0x27, 0x9c, 0x69,
- 0x0d, 0xf2, 0xc6, 0x7d, 0xc3, 0x65, 0x49, 0x50, 0x16, 0x30, 0xee, 0x1b, 0x0e, 0xc3, 0x2b, 0x50,
- 0x20, 0xf3, 0x76, 0x39, 0x92, 0xf4, 0x47, 0xf2, 0x84, 0xc6, 0x59, 0xa4, 0xbf, 0x4d, 0x80, 0x38,
- 0xe9, 0x86, 0xd0, 0xfb, 0x90, 0x24, 0x1e, 0x99, 0x3b, 0xd7, 0xea, 0x06, 0x73, 0xd7, 0x1b, 0x8e,
- 0xbb, 0xde, 0x68, 0x39, 0xee, 0x7a, 0x2b, 0xfb, 0xc3, 0xf3, 0xb5, 0xd8, 0x77, 0xff, 0xbb, 0x26,
- 0xc8, 0x54, 0x02, 0x5d, 0x27, 0xce, 0x47, 0xd5, 0x06, 0x8a, 0xd6, 0xa1, 0x43, 0xce, 0x11, 0xcf,
- 0xa2, 0x6a, 0x83, 0x9d, 0x0e, 0xda, 0x03, 0xb1, 0xad, 0x0f, 0x2c, 0x3c, 0xb0, 0x86, 0x96, 0xc2,
- 0xc2, 0x45, 0x25, 0x11, 0x74, 0x8c, 0x2c, 0x4e, 0xd4, 0x1d, 0xce, 0x43, 0xca, 0x28, 0x97, 0xdb,
- 0x7e, 0x02, 0xda, 0x87, 0xe2, 0x85, 0xda, 0xd3, 0x3a, 0xaa, 0xad, 0x9b, 0x8a, 0x85, 0x6d, 0xee,
- 0x63, 0x6f, 0x07, 0xf6, 0xfc, 0xc4, 0xe1, 0x3a, 0xc2, 0xf6, 0xb1, 0xd1, 0x51, 0x6d, 0xbc, 0x95,
- 0xfc, 0xe1, 0xf9, 0x9a, 0x20, 0x17, 0x2e, 0x3c, 0x3d, 0xe8, 0x35, 0x28, 0xab, 0x86, 0xa1, 0x58,
- 0xb6, 0x6a, 0x63, 0xe5, 0xf4, 0xd2, 0xc6, 0x16, 0x75, 0xbb, 0x05, 0xb9, 0xa8, 0x1a, 0xc6, 0x11,
- 0xa1, 0x6e, 0x11, 0x22, 0x7a, 0x15, 0x4a, 0xc4, 0x43, 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, 0x8f, 0x8b, 0xf2, 0x12, 0xef, 0xaa, 0xeb, 0x26, 0x66,
- 0xfc, 0x52, 0x07, 0x0a, 0x5e, 0x6f, 0x8e, 0x10, 0x24, 0x3b, 0xaa, 0xad, 0xd2, 0x1d, 0x28, 0xc8,
- 0xf4, 0x9b, 0xd0, 0x0c, 0xd5, 0xee, 0xf2, 0x75, 0xa5, 0xdf, 0xe8, 0x2a, 0xa4, 0xb9, 0xea, 0x04,
- 0x1d, 0x06, 0x6f, 0xa1, 0x15, 0x48, 0x19, 0xa6, 0x7e, 0x81, 0xe9, 0xb2, 0x64, 0x65, 0xd6, 0x90,
- 0x64, 0x28, 0xf9, 0x3d, 0x3f, 0x2a, 0x41, 0xdc, 0x1e, 0xf1, 0x5f, 0x89, 0xdb, 0x23, 0xf4, 0x36,
- 0x24, 0xc9, 0x06, 0xd0, 0xdf, 0x28, 0x85, 0xc4, 0x3a, 0x2e, 0xd7, 0xba, 0x34, 0xb0, 0x4c, 0x39,
- 0xa5, 0xab, 0xb0, 0x12, 0x16, 0x09, 0xa4, 0x2e, 0xac, 0x84, 0x79, 0x74, 0xf4, 0x2e, 0x64, 0xdd,
- 0x50, 0xc0, 0xec, 0xeb, 0x7a, 0xe0, 0x57, 0x1c, 0x66, 0xd9, 0x65, 0x25, 0x86, 0x45, 0xf6, 0xa7,
- 0xab, 0xf2, 0xf0, 0x5d, 0x90, 0x33, 0xaa, 0x61, 0x34, 0x55, 0xab, 0x2b, 0x9d, 0x43, 0x25, 0xca,
- 0xcd, 0x7b, 0xd6, 0x47, 0xa0, 0xa7, 0xc3, 0x59, 0x1f, 0xcf, 0xc9, 0x8b, 0xd3, 0x3d, 0x71, 0x9a,
- 0xcc, 0x82, 0x87, 0x83, 0xa7, 0xc4, 0x82, 0x13, 0xec, 0x87, 0x68, 0x7b, 0xa7, 0x23, 0x75, 0xe0,
- 0x7a, 0xa4, 0xc7, 0xf7, 0xc9, 0x09, 0x3e, 0x39, 0xb2, 0x19, 0xf4, 0x93, 0x0f, 0x3c, 0xd5, 0x76,
- 0x86, 0x66, 0xd1, 0x79, 0xd3, 0x9f, 0xc9, 0xc9, 0xbc, 0x25, 0xfd, 0x92, 0x84, 0xab, 0xe1, 0xce,
- 0x1f, 0xad, 0x43, 0xa1, 0xaf, 0x8e, 0x14, 0x7b, 0xc4, 0x2d, 0x54, 0xa0, 0x7b, 0x0e, 0x7d, 0x75,
- 0xd4, 0x1a, 0x31, 0xf3, 0x14, 0x21, 0x61, 0x8f, 0xac, 0x4a, 0x7c, 0x3d, 0x71, 0xb7, 0x20, 0x93,
- 0x4f, 0xf4, 0x04, 0x96, 0x7a, 0x7a, 0x5b, 0xed, 0x29, 0x3d, 0xd5, 0xb2, 0x95, 0xb6, 0xde, 0xef,
- 0x6b, 0x36, 0x3f, 0x77, 0x37, 0x82, 0xdb, 0x4b, 0xbb, 0x89, 0x6f, 0xa2, 0x87, 0x24, 0x26, 0x97,
- 0xa9, 0xec, 0x9e, 0x6a, 0xd9, 0xac, 0x0b, 0x6d, 0x43, 0xbe, 0xaf, 0x59, 0xa7, 0xb8, 0xab, 0x5e,
- 0x68, 0xba, 0x59, 0x49, 0xae, 0x27, 0x42, 0x73, 0xa2, 0x27, 0x63, 0x1e, 0xae, 0xc9, 0x2b, 0xe6,
- 0xd9, 0x96, 0x94, 0xcf, 0x6c, 0x1d, 0xc7, 0x93, 0x5e, 0xd8, 0xf1, 0xbc, 0x0d, 0x2b, 0x03, 0x3c,
- 0xb2, 0x15, 0xf7, 0x50, 0x5b, 0xcc, 0x56, 0x32, 0x74, 0xc9, 0x11, 0xe9, 0x73, 0x3d, 0x81, 0x45,
- 0xcc, 0x86, 0xec, 0x8a, 0xa9, 0x0f, 0x07, 0x9d, 0x4a, 0x76, 0x5d, 0xb8, 0x9b, 0x92, 0x59, 0x03,
- 0x3d, 0x84, 0x0a, 0x3d, 0xb0, 0xcc, 0x8b, 0x11, 0x6f, 0x8b, 0x3b, 0xce, 0xe9, 0xcd, 0x51, 0x4b,
- 0xb9, 0x42, 0xfa, 0xa9, 0x9f, 0xdc, 0xa3, 0xbd, 0xfc, 0xc4, 0x6f, 0xc2, 0x0a, 0x8b, 0xbe, 0xd8,
- 0x24, 0x61, 0x98, 0x6c, 0x12, 0x1d, 0x00, 0xd0, 0x01, 0x2c, 0x39, 0x7d, 0x87, 0xa6, 0xde, 0x1a,
- 0xd1, 0xdf, 0x7f, 0xdb, 0x15, 0xe8, 0x28, 0xc4, 0xb4, 0x1d, 0x7b, 0xcc, 0x53, 0x43, 0x45, 0x4e,
- 0x5f, 0xcd, 0x70, 0xdd, 0xf9, 0xc3, 0xb1, 0xd1, 0x16, 0x82, 0x29, 0x21, 0xef, 0x1a, 0xbb, 0xce,
- 0xb1, 0x4d, 0xaf, 0x41, 0xfe, 0xab, 0xa1, 0x6e, 0x0e, 0xfb, 0x6c, 0x48, 0x45, 0x3a, 0x24, 0x60,
- 0x24, 0x7a, 0x84, 0xfe, 0x35, 0xe5, 0xb1, 0x39, 0x7f, 0x1e, 0xc0, 0x2d, 0x4a, 0x18, 0x5b, 0xd4,
- 0x91, 0x67, 0xe0, 0x5e, 0xa3, 0x8a, 0xcf, 0x6b, 0x54, 0xee, 0xdc, 0xa2, 0xed, 0x2a, 0xf1, 0xeb,
- 0xec, 0x0a, 0x41, 0x92, 0xce, 0x30, 0xc9, 0xdc, 0x26, 0xf9, 0x8e, 0xb4, 0x35, 0x77, 0xff, 0xd3,
- 0xde, 0xfd, 0x77, 0x2c, 0x30, 0xf3, 0x9b, 0x59, 0x60, 0x36, 0xd2, 0x02, 0x7f, 0xb5, 0xad, 0xb5,
- 0xe0, 0xea, 0x84, 0xa0, 0x32, 0xa4, 0xa1, 0xad, 0x02, 0xc1, 0x84, 0xdf, 0x09, 0xa8, 0x1e, 0x45,
- 0xf2, 0xb2, 0x4f, 0x2f, 0x0b, 0x8b, 0x91, 0x16, 0x9c, 0x5f, 0xd4, 0x82, 0x0b, 0xf3, 0x58, 0x70,
- 0xf1, 0x65, 0x2c, 0xb8, 0x14, 0xb0, 0xe0, 0x63, 0x58, 0x0a, 0xa4, 0xa2, 0xae, 0x39, 0x08, 0xa1,
- 0xe6, 0x10, 0x0f, 0x37, 0x87, 0x84, 0xc7, 0x1c, 0xa4, 0x9f, 0x04, 0xa8, 0x46, 0x67, 0xa4, 0xa1,
- 0x3f, 0xf0, 0x0e, 0x5c, 0x19, 0x67, 0x26, 0xde, 0x75, 0x64, 0xde, 0x1f, 0xb9, 0x9d, 0xe3, 0x85,
- 0x9c, 0x12, 0xc5, 0xd9, 0x98, 0x92, 0x5e, 0x13, 0x7d, 0x02, 0x65, 0x7f, 0x2e, 0x4d, 0x52, 0x15,
- 0x72, 0x5c, 0xfe, 0x24, 0x70, 0x5c, 0xc6, 0x6b, 0xe1, 0x8e, 0x59, 0x2e, 0x5d, 0x78, 0x9b, 0x96,
- 0xf4, 0x9f, 0x71, 0x58, 0x09, 0x4b, 0x8c, 0xd1, 0x07, 0x90, 0xe6, 0x27, 0x5b, 0x98, 0xf7, 0x64,
- 0xa7, 0xdb, 0xa1, 0xa7, 0x39, 0xfe, 0x72, 0xa7, 0x39, 0x11, 0xba, 0x7d, 0xc9, 0xf0, 0xa5, 0x4a,
- 0x79, 0x97, 0xea, 0x2d, 0x48, 0xb1, 0x1b, 0x01, 0x0b, 0x28, 0xd7, 0x82, 0xe7, 0x82, 0x4e, 0x55,
- 0x66, 0x5c, 0xa8, 0x06, 0x59, 0xfa, 0x41, 0x62, 0x78, 0x26, 0x98, 0x9b, 0x78, 0x24, 0x76, 0xb6,
- 0xb7, 0xf2, 0x2f, 0x9e, 0xaf, 0x65, 0x78, 0x43, 0xce, 0x50, 0xb9, 0x9d, 0x8e, 0xf4, 0x6f, 0x39,
- 0xc8, 0xca, 0xd8, 0x32, 0x88, 0x09, 0xa3, 0x2d, 0xc8, 0xe1, 0x51, 0x1b, 0x1b, 0xb6, 0x93, 0xe1,
- 0x87, 0xdf, 0xa0, 0x18, 0x77, 0xc3, 0xe1, 0x24, 0x28, 0x80, 0x2b, 0x86, 0x1e, 0x70, 0xa0, 0x23,
- 0x1a, 0xb3, 0xe0, 0xe2, 0x5e, 0xa4, 0xe3, 0x3d, 0x07, 0xe9, 0x60, 0x81, 0x7e, 0x35, 0x52, 0x6a,
- 0x02, 0xea, 0x78, 0xc0, 0xa1, 0x8e, 0xe4, 0x8c, 0x1f, 0xf3, 0x61, 0x1d, 0x75, 0x1f, 0xd6, 0x91,
- 0x9a, 0x31, 0xcd, 0x08, 0xb0, 0xe3, 0x3d, 0x07, 0xec, 0x48, 0xcf, 0x18, 0xf1, 0x04, 0xda, 0xf1,
- 0xe7, 0x01, 0xb4, 0x63, 0x3d, 0x52, 0x34, 0x04, 0xee, 0x38, 0x08, 0xc0, 0x1d, 0x59, 0xaa, 0xe4,
- 0xb5, 0x48, 0x25, 0x33, 0xf0, 0x8e, 0x83, 0x00, 0xde, 0x91, 0x9b, 0xa1, 0x70, 0x06, 0xe0, 0xf1,
- 0xd7, 0xe1, 0x80, 0x07, 0x44, 0x42, 0x12, 0x7c, 0x98, 0xf3, 0x21, 0x1e, 0x4a, 0x04, 0xe2, 0x91,
- 0x8f, 0xbc, 0x9d, 0x33, 0xf5, 0x73, 0x43, 0x1e, 0xc7, 0x21, 0x90, 0x07, 0x4b, 0x5e, 0xee, 0x46,
- 0x2a, 0x9f, 0x03, 0xf3, 0x38, 0x0e, 0xc1, 0x3c, 0x8a, 0x33, 0xd5, 0xce, 0x04, 0x3d, 0x1e, 0xf9,
- 0x41, 0x8f, 0x52, 0xc4, 0x9d, 0x72, 0x7c, 0x64, 0x23, 0x50, 0x8f, 0xd3, 0x28, 0xd4, 0x83, 0xa1,
- 0x3d, 0x6f, 0x46, 0x6a, 0x5c, 0x00, 0xf6, 0x38, 0x08, 0xc0, 0x1e, 0xe2, 0x0c, 0x4b, 0x9b, 0x13,
- 0xf7, 0x90, 0x5e, 0x87, 0x25, 0x47, 0xc4, 0x75, 0x4a, 0xc4, 0xc1, 0x62, 0xd3, 0xd4, 0x4d, 0x8e,
- 0x54, 0xb0, 0x86, 0x74, 0x17, 0x0a, 0x2e, 0xeb, 0x74, 0x2c, 0xa4, 0x0c, 0x45, 0x9f, 0xd3, 0x91,
- 0xfe, 0x59, 0x80, 0x82, 0xd7, 0x9f, 0xf8, 0xee, 0xbc, 0x39, 0x7e, 0xe7, 0x9d, 0xb8, 0xa7, 0xe5,
- 0x7c, 0x19, 0x81, 0x37, 0xe7, 0xe0, 0xe0, 0x87, 0x3a, 0xce, 0x35, 0xee, 0xc1, 0x12, 0xcd, 0x4e,
- 0x99, 0x47, 0xf7, 0x05, 0x8d, 0x32, 0xe9, 0x60, 0xab, 0x40, 0xc9, 0xe8, 0x2d, 0x58, 0xf6, 0xf0,
- 0xba, 0x17, 0x4d, 0x86, 0x00, 0x88, 0x2e, 0x77, 0x8d, 0xdf, 0x38, 0xff, 0x3d, 0x01, 0x4b, 0x01,
- 0x7f, 0x16, 0x0a, 0x70, 0x08, 0xbf, 0x1a, 0xe0, 0x88, 0xbe, 0xf0, 0xa2, 0xcf, 0x60, 0xc5, 0x87,
- 0x7d, 0x38, 0xc9, 0x5f, 0x62, 0x31, 0x08, 0x24, 0xe6, 0xc9, 0x45, 0xdc, 0x1e, 0xf4, 0x39, 0xdc,
- 0xa0, 0x69, 0x6c, 0x44, 0x82, 0x99, 0x9c, 0x2f, 0xc1, 0xbc, 0x46, 0x74, 0xd4, 0x43, 0x92, 0xcc,
- 0x08, 0x60, 0x24, 0x15, 0x01, 0x8c, 0xa0, 0x3d, 0x28, 0x9c, 0xe3, 0x01, 0xb6, 0x34, 0x4b, 0x59,
- 0xe0, 0x66, 0x28, 0x90, 0xbc, 0xbc, 0x19, 0x93, 0xf3, 0x5c, 0x96, 0xf4, 0xfe, 0x9d, 0x20, 0x6c,
- 0x95, 0xa1, 0xa8, 0x78, 0xd5, 0x49, 0xff, 0x2f, 0x40, 0xd1, 0x17, 0x59, 0x88, 0x15, 0xb6, 0xf5,
- 0x0e, 0x33, 0xdf, 0xa2, 0x4c, 0xbf, 0xc9, 0x1d, 0xa8, 0xa7, 0x9f, 0x73, 0x0b, 0x24, 0x9f, 0x84,
- 0xcb, 0xad, 0x09, 0xe4, 0x78, 0x1c, 0x5c, 0x81, 0x94, 0x36, 0xe8, 0xe0, 0x11, 0x37, 0x32, 0xd6,
- 0x20, 0xb2, 0x4f, 0xf1, 0x25, 0x37, 0x25, 0xf2, 0x89, 0x56, 0xf8, 0x39, 0xa3, 0x73, 0x29, 0xc8,
- 0xac, 0x81, 0xde, 0x87, 0x1c, 0x2d, 0xec, 0x28, 0xba, 0x61, 0x55, 0x32, 0xc1, 0x84, 0x8b, 0x15,
- 0x61, 0x36, 0x0e, 0x09, 0xcf, 0x81, 0x61, 0xc9, 0x59, 0x83, 0x7f, 0x79, 0x52, 0xa2, 0xac, 0x2f,
- 0x25, 0xba, 0x09, 0x39, 0x32, 0x7a, 0xcb, 0x50, 0xdb, 0x98, 0x46, 0xa1, 0x9c, 0x3c, 0x26, 0x48,
- 0xff, 0x22, 0x40, 0x79, 0x22, 0x30, 0x86, 0xce, 0xdd, 0x39, 0x95, 0x71, 0x3f, 0x12, 0x15, 0x98,
- 0xfd, 0x2d, 0x80, 0x73, 0xd5, 0x52, 0x9e, 0xa9, 0x03, 0x1b, 0x77, 0xf8, 0x12, 0xe4, 0xce, 0x55,
- 0xeb, 0x13, 0x4a, 0xf0, 0x0f, 0x26, 0x35, 0x31, 0x18, 0x0f, 0x16, 0x92, 0xf6, 0x62, 0x21, 0xa8,
- 0x0a, 0x59, 0xc3, 0xd4, 0x74, 0x53, 0xb3, 0x2f, 0xe9, 0x9a, 0x24, 0x64, 0xb7, 0x2d, 0x1d, 0xc2,
- 0x95, 0xd0, 0x98, 0x8c, 0x1e, 0x42, 0x6e, 0x1c, 0xce, 0x85, 0xf5, 0xc4, 0x64, 0x1a, 0xe7, 0x87,
- 0x98, 0xc6, 0xbc, 0x64, 0x49, 0xae, 0x84, 0x46, 0x65, 0xd4, 0x80, 0xb4, 0x89, 0xad, 0x61, 0x8f,
- 0xa5, 0xc2, 0xa5, 0xfb, 0x6f, 0xcd, 0x17, 0xcd, 0x09, 0x75, 0xd8, 0xb3, 0x65, 0x2e, 0x2c, 0x7d,
- 0x01, 0x69, 0x46, 0x41, 0x79, 0xc8, 0x1c, 0xef, 0x3f, 0xde, 0x3f, 0xf8, 0x64, 0x5f, 0x8c, 0x21,
- 0x80, 0x74, 0xad, 0x5e, 0x6f, 0x1c, 0xb6, 0x44, 0x01, 0xe5, 0x20, 0x55, 0xdb, 0x3a, 0x90, 0x5b,
- 0x62, 0x9c, 0x90, 0xe5, 0xc6, 0x6e, 0xa3, 0xde, 0x12, 0x13, 0x68, 0x09, 0x8a, 0xec, 0x5b, 0x79,
- 0x74, 0x20, 0x3f, 0xa9, 0xb5, 0xc4, 0xa4, 0x87, 0x74, 0xd4, 0xd8, 0xdf, 0x6e, 0xc8, 0x62, 0x4a,
- 0x7a, 0x07, 0xae, 0x3b, 0xe3, 0x08, 0x42, 0x61, 0x2e, 0x0a, 0x25, 0x78, 0x50, 0x28, 0xe9, 0xc7,
- 0x38, 0x54, 0x1d, 0x99, 0x10, 0x54, 0x6b, 0x77, 0x62, 0xe2, 0xf7, 0x17, 0xc8, 0x08, 0x26, 0x66,
- 0x4f, 0xa0, 0x53, 0x13, 0x9f, 0x61, 0xbb, 0xdd, 0x65, 0x49, 0x86, 0x03, 0x53, 0x15, 0x39, 0x95,
- 0x0a, 0x59, 0x8c, 0xed, 0x4b, 0xdc, 0xb6, 0x15, 0x66, 0x04, 0x16, 0x05, 0x03, 0x72, 0x72, 0x91,
- 0x51, 0x8f, 0x18, 0x91, 0xf8, 0x7f, 0xe6, 0xa7, 0x98, 0xaa, 0x24, 0x55, 0x05, 0xd4, 0xed, 0x50,
- 0x8a, 0xf4, 0x6c, 0xa1, 0xc5, 0xce, 0x41, 0x4a, 0x6e, 0xb4, 0xe4, 0x4f, 0xc5, 0x04, 0x42, 0x50,
- 0xa2, 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, 0x63, 0x4c, 0x4e,
- 0x4b, 0xff, 0x9d, 0x80, 0x6b, 0x11, 0xa9, 0x0c, 0x7a, 0x1f, 0xc0, 0x1e, 0x29, 0x26, 0x6e, 0xeb,
- 0x66, 0x27, 0xda, 0x38, 0x5b, 0x23, 0x99, 0x72, 0xc8, 0x39, 0x9b, 0x7f, 0x4d, 0x8d, 0x07, 0x1f,
- 0x71, 0xa5, 0x64, 0xb2, 0x16, 0x87, 0x4e, 0x6e, 0x85, 0xdc, 0x05, 0x71, 0x9b, 0x28, 0xa6, 0x7b,
- 0x92, 0xb3, 0xf9, 0x97, 0x85, 0x3e, 0x85, 0x6b, 0x13, 0x61, 0x8b, 0xfb, 0x7a, 0x2b, 0xac, 0x6e,
- 0x19, 0x1e, 0xbd, 0xae, 0xf8, 0xa3, 0x17, 0xf3, 0xf5, 0xd6, 0x14, 0x9c, 0x22, 0xf5, 0x12, 0x38,
- 0x45, 0x54, 0xf8, 0x4b, 0x2f, 0x5a, 0x01, 0x08, 0x0b, 0x7f, 0x13, 0x69, 0x45, 0x66, 0x32, 0xad,
- 0x90, 0x7e, 0xe7, 0xdb, 0x5d, 0x7f, 0xfa, 0x78, 0x00, 0x69, 0xcb, 0x56, 0xed, 0xa1, 0xc5, 0x4f,
- 0xcb, 0xc3, 0x79, 0x73, 0xd1, 0x0d, 0xe7, 0xe3, 0x88, 0x8a, 0xcb, 0x5c, 0xcd, 0x1f, 0xe5, 0xa6,
- 0x47, 0x6d, 0x4f, 0xea, 0xb7, 0xd8, 0x9e, 0x26, 0xa4, 0xf1, 0x05, 0x1e, 0xd8, 0x56, 0x25, 0x4d,
- 0x67, 0x7c, 0x35, 0x38, 0x63, 0xd2, 0xbd, 0x55, 0x21, 0xf9, 0xcd, 0xff, 0x3d, 0x5f, 0x13, 0x19,
- 0xf7, 0x9b, 0x7a, 0x5f, 0xb3, 0x71, 0xdf, 0xb0, 0x2f, 0x65, 0x2e, 0x2f, 0xbd, 0x0b, 0x25, 0xff,
- 0xa2, 0x47, 0xbb, 0x89, 0xb1, 0x23, 0x8e, 0x4b, 0xff, 0x24, 0xc0, 0x72, 0x08, 0xaa, 0x82, 0x1e,
- 0xf2, 0xc2, 0x09, 0xdb, 0xf8, 0xdb, 0xc1, 0xd5, 0xf3, 0xb1, 0x8f, 0xeb, 0x27, 0x24, 0x30, 0x8e,
- 0xaf, 0x07, 0x6c, 0x8f, 0xc7, 0x04, 0xf4, 0x06, 0x94, 0x2d, 0xed, 0x7c, 0xa0, 0x98, 0x0c, 0xa0,
- 0x71, 0x8b, 0x12, 0x24, 0x7b, 0x27, 0x1d, 0x4e, 0xe9, 0xae, 0x43, 0xb2, 0x1b, 0x04, 0xa2, 0x32,
- 0xc1, 0x2d, 0xb5, 0x01, 0x05, 0x6f, 0x2b, 0x61, 0x10, 0x92, 0xf0, 0x12, 0x10, 0xd2, 0x3f, 0x0a,
- 0x70, 0x63, 0xca, 0x0d, 0x06, 0x7d, 0x3c, 0x71, 0x2e, 0x3e, 0x58, 0xe4, 0xfe, 0xb3, 0xc1, 0x68,
- 0xfe, 0x93, 0x21, 0x3d, 0x80, 0x82, 0x97, 0x3e, 0xdf, 0xe6, 0xfd, 0xbd, 0x27, 0xc0, 0xfb, 0xb1,
- 0xae, 0xdb, 0x50, 0x34, 0xb1, 0x4d, 0xbc, 0x94, 0x0f, 0x1c, 0x2c, 0x30, 0x22, 0xcf, 0x45, 0xeb,
- 0xb0, 0xca, 0x31, 0x4d, 0x85, 0x86, 0x1e, 0x8e, 0x15, 0xf5, 0xfb, 0xb8, 0xa3, 0xa9, 0x36, 0xee,
- 0x5d, 0xd2, 0xbd, 0xc9, 0xca, 0x37, 0x38, 0xd7, 0x3e, 0x1e, 0xb1, 0x7b, 0xc3, 0xce, 0x98, 0x65,
- 0x37, 0x99, 0x15, 0xc4, 0xb8, 0x6b, 0x85, 0xff, 0x21, 0x00, 0x8c, 0x51, 0xb4, 0x31, 0x8a, 0x25,
- 0x78, 0x51, 0xac, 0x09, 0xf0, 0x33, 0x3e, 0x09, 0x7e, 0xa2, 0x3b, 0x50, 0x66, 0x63, 0x21, 0xbb,
- 0xaf, 0xda, 0x43, 0x13, 0x73, 0xcc, 0xac, 0x44, 0xc9, 0x47, 0x0e, 0x15, 0x7d, 0x06, 0xd7, 0xed,
- 0xae, 0x89, 0xad, 0xae, 0xde, 0xeb, 0x28, 0x93, 0x16, 0xc0, 0x6a, 0x39, 0x6b, 0x33, 0x4c, 0x57,
- 0xbe, 0xe6, 0x6a, 0x38, 0xf1, 0x5b, 0xc1, 0xd7, 0x90, 0xa2, 0x87, 0x8f, 0xa4, 0x87, 0xee, 0x59,
- 0xc8, 0x71, 0x33, 0xff, 0x1c, 0x40, 0xb5, 0x6d, 0x53, 0x3b, 0x1d, 0xda, 0x98, 0x05, 0xfe, 0xb0,
- 0x77, 0x29, 0x54, 0xbe, 0xe6, 0xf0, 0x6d, 0xdd, 0xe4, 0xa7, 0x78, 0x65, 0x2c, 0xea, 0x39, 0xc9,
- 0x1e, 0x85, 0xd2, 0x3e, 0x94, 0xfc, 0xb2, 0x4e, 0xde, 0xcd, 0xc6, 0xe0, 0xcf, 0xbb, 0x59, 0x1e,
- 0xcf, 0x1a, 0xe3, 0xac, 0x9d, 0xed, 0x1d, 0x6b, 0x48, 0xbf, 0x08, 0x50, 0xf0, 0xfa, 0xce, 0xb9,
- 0x53, 0x63, 0x7e, 0x55, 0x48, 0x04, 0xaf, 0x0a, 0x49, 0x4f, 0xb2, 0x7c, 0x1d, 0xb2, 0x24, 0x59,
- 0x1e, 0x5a, 0xb8, 0xc3, 0xeb, 0xc7, 0x99, 0x73, 0xd5, 0x3a, 0xb6, 0x70, 0xc7, 0xe3, 0xe1, 0x32,
- 0x2f, 0xe7, 0xe1, 0xfc, 0x29, 0x77, 0x76, 0x22, 0xe5, 0xde, 0x4d, 0x66, 0x53, 0x62, 0x5a, 0xf6,
- 0xe4, 0xec, 0xd2, 0x37, 0x02, 0x64, 0xdd, 0xf9, 0xfa, 0x0b, 0xa7, 0x3e, 0x9c, 0x95, 0x2d, 0x17,
- 0x2b, 0x9b, 0xb2, 0x06, 0x2f, 0x23, 0x27, 0xdc, 0x32, 0xf2, 0x87, 0x6e, 0xda, 0x18, 0x85, 0x24,
- 0x7a, 0x17, 0xd7, 0x01, 0x8f, 0x79, 0x96, 0xfc, 0x0f, 0x7c, 0x1c, 0x24, 0xef, 0x41, 0x7f, 0x06,
- 0x69, 0xb5, 0xed, 0xe2, 0xa7, 0xa5, 0x10, 0x60, 0xd1, 0x61, 0xdd, 0x68, 0x8d, 0x6a, 0x94, 0x53,
- 0xe6, 0x12, 0x7c, 0x54, 0x71, 0x67, 0x54, 0xd2, 0x1e, 0x64, 0x1d, 0x1e, 0xbf, 0xbf, 0x28, 0x01,
- 0x1c, 0xef, 0x3f, 0x39, 0xd8, 0xde, 0x79, 0xb4, 0xd3, 0xd8, 0xe6, 0x79, 0xe1, 0xf6, 0x76, 0x63,
- 0x5b, 0x8c, 0x13, 0x3e, 0xb9, 0xf1, 0xe4, 0xe0, 0xa4, 0xb1, 0x2d, 0x26, 0x48, 0x63, 0xbb, 0xb1,
- 0x57, 0xfb, 0xb4, 0xb1, 0x2d, 0x26, 0xa5, 0x1a, 0xe4, 0xdc, 0xd0, 0x45, 0xeb, 0xed, 0xfa, 0x33,
- 0x6c, 0xf2, 0xd5, 0x62, 0x0d, 0xb4, 0x0a, 0xf9, 0x60, 0x01, 0x20, 0x67, 0x38, 0xb8, 0x3f, 0x09,
- 0x26, 0x65, 0x57, 0x07, 0x8f, 0x70, 0x1f, 0x42, 0xc6, 0x18, 0x9e, 0x2a, 0x8e, 0xed, 0x4e, 0xc0,
- 0xe6, 0xce, 0x2d, 0x70, 0x78, 0xda, 0xd3, 0xda, 0x8f, 0xf1, 0x25, 0x0f, 0x95, 0x69, 0x63, 0x78,
- 0xfa, 0x98, 0x99, 0x38, 0x1b, 0x46, 0x7c, 0xca, 0x30, 0x12, 0x13, 0xc3, 0x40, 0x77, 0xa0, 0x30,
- 0xd0, 0x3b, 0x58, 0x51, 0x3b, 0x1d, 0x13, 0x5b, 0x2c, 0x03, 0xc8, 0x71, 0xcd, 0x79, 0xd2, 0x53,
- 0x63, 0x1d, 0xa4, 0x1a, 0x82, 0x82, 0xe1, 0x1a, 0x1d, 0xc1, 0xd2, 0x38, 0xe2, 0x3b, 0x69, 0x04,
- 0x8b, 0x27, 0xeb, 0xd1, 0xe1, 0xde, 0x87, 0x44, 0x88, 0x17, 0x7e, 0x32, 0xc9, 0x1d, 0x57, 0xc6,
- 0xae, 0xca, 0xa0, 0xf3, 0xa5, 0x8b, 0x12, 0x9f, 0x73, 0x51, 0x62, 0x32, 0x72, 0xe5, 0xdd, 0x9e,
- 0x49, 0x57, 0x9a, 0x08, 0xd4, 0x91, 0x0c, 0xa8, 0xb4, 0x02, 0x62, 0x7c, 0x9e, 0x51, 0x43, 0x12,
- 0x5e, 0x66, 0x48, 0xd2, 0x03, 0x10, 0x3f, 0x76, 0x7f, 0x7f, 0x9c, 0x85, 0x7a, 0x87, 0x29, 0x04,
- 0x86, 0x79, 0x01, 0x59, 0xe2, 0x7d, 0x69, 0xd0, 0xf8, 0x0b, 0xc8, 0xb9, 0xab, 0xe7, 0x3e, 0xd9,
- 0x89, 0x5c, 0x76, 0x3e, 0x92, 0xb1, 0x08, 0x01, 0xca, 0x48, 0xdc, 0x70, 0xaa, 0xb9, 0x0c, 0x4b,
- 0x8c, 0x53, 0x6f, 0x58, 0x66, 0x1d, 0x7b, 0x0e, 0x00, 0x46, 0x22, 0xbd, 0xc8, 0x32, 0x02, 0xdc,
- 0xf9, 0x43, 0x0c, 0x80, 0xdc, 0x0e, 0x27, 0x20, 0x55, 0xb6, 0x87, 0x45, 0x5f, 0x4a, 0x22, 0xfd,
- 0x4d, 0x1c, 0xf2, 0x9e, 0xea, 0x12, 0xfa, 0x53, 0x5f, 0x7a, 0xb6, 0x3e, 0xad, 0x12, 0xe5, 0xc9,
- 0xcd, 0x7c, 0x13, 0x8b, 0x2f, 0x3e, 0xb1, 0xa8, 0xba, 0x9e, 0x53, 0x64, 0x4e, 0x2e, 0x5c, 0x64,
- 0x7e, 0x13, 0x90, 0xad, 0xdb, 0x6a, 0x8f, 0x04, 0x6f, 0x6d, 0x70, 0xae, 0xb0, 0xd3, 0xce, 0x0a,
- 0xdb, 0x22, 0xed, 0x39, 0xa1, 0x1d, 0x87, 0x84, 0x2e, 0xf5, 0x20, 0xeb, 0x42, 0x18, 0x8b, 0xbf,
- 0x84, 0x09, 0x2b, 0xa6, 0x57, 0x21, 0xdb, 0xc7, 0xb6, 0x4a, 0xc3, 0x1e, 0x83, 0xb4, 0xdc, 0xf6,
- 0xbd, 0x0f, 0x20, 0xef, 0x79, 0x1e, 0x44, 0x22, 0xe1, 0x7e, 0xe3, 0x13, 0x31, 0x56, 0xcd, 0x7c,
- 0xfb, 0xfd, 0x7a, 0x62, 0x1f, 0x3f, 0x23, 0x3f, 0x25, 0x37, 0xea, 0xcd, 0x46, 0xfd, 0xb1, 0x28,
- 0x54, 0xf3, 0xdf, 0x7e, 0xbf, 0x9e, 0x91, 0x31, 0x2d, 0xc4, 0xdc, 0x7b, 0x0c, 0xe5, 0x89, 0x1d,
- 0xf0, 0x3b, 0x68, 0x04, 0xa5, 0xed, 0xe3, 0xc3, 0xbd, 0x9d, 0x7a, 0xad, 0xd5, 0x50, 0x4e, 0x0e,
- 0x5a, 0x0d, 0x51, 0x40, 0xd7, 0x60, 0x79, 0x6f, 0xe7, 0x2f, 0x9b, 0x2d, 0xa5, 0xbe, 0xb7, 0xd3,
- 0xd8, 0x6f, 0x29, 0xb5, 0x56, 0xab, 0x56, 0x7f, 0x2c, 0xc6, 0xef, 0xff, 0x0f, 0x40, 0xb9, 0xb6,
- 0x55, 0xdf, 0x21, 0x88, 0x84, 0xd6, 0x56, 0xa9, 0xbb, 0xaf, 0x43, 0x92, 0xe2, 0xd3, 0x53, 0x1f,
- 0x0a, 0x57, 0xa7, 0x57, 0xd7, 0xd0, 0x23, 0x48, 0x51, 0xe8, 0x1a, 0x4d, 0x7f, 0x39, 0x5c, 0x9d,
- 0x51, 0x6e, 0x23, 0x83, 0xa1, 0xe7, 0x66, 0xea, 0x53, 0xe2, 0xea, 0xf4, 0xea, 0x1b, 0xda, 0x83,
- 0x8c, 0x03, 0xdb, 0xcd, 0x7a, 0xdf, 0x5b, 0x9d, 0x59, 0x12, 0x23, 0x53, 0x63, 0xf0, 0xe7, 0xf4,
- 0x57, 0xc6, 0xd5, 0x19, 0x75, 0x39, 0x24, 0x43, 0x6e, 0x0c, 0x88, 0xcf, 0x7e, 0xf0, 0x5c, 0x9d,
- 0xa3, 0x4e, 0x88, 0xbe, 0x80, 0xa2, 0x1f, 0xe0, 0x9b, 0xef, 0x2d, 0x72, 0x75, 0xce, 0x1a, 0x1e,
- 0xd1, 0xef, 0x47, 0xfb, 0xe6, 0x7b, 0x9b, 0x5c, 0x9d, 0xb3, 0xa4, 0x87, 0xbe, 0x84, 0xa5, 0x20,
- 0x1a, 0x37, 0xff, 0x53, 0xe5, 0xea, 0x02, 0x45, 0x3e, 0xd4, 0x07, 0x14, 0x82, 0xe2, 0x2d, 0xf0,
- 0x72, 0xb9, 0xba, 0x48, 0xcd, 0x0f, 0x75, 0xa0, 0x3c, 0x89, 0x70, 0xcd, 0xfb, 0x92, 0xb9, 0x3a,
- 0x77, 0xfd, 0x8f, 0xfd, 0x8a, 0x1f, 0x69, 0x99, 0xf7, 0x65, 0x73, 0x75, 0xee, 0x72, 0x20, 0x3a,
- 0x06, 0xf0, 0xdc, 0x90, 0xe7, 0x78, 0xe9, 0x5c, 0x9d, 0xa7, 0x30, 0x88, 0x0c, 0x58, 0x0e, 0xbb,
- 0x12, 0x2f, 0xf2, 0xf0, 0xb9, 0xba, 0x50, 0xbd, 0x90, 0xd8, 0xb3, 0xff, 0x72, 0x3b, 0xdf, 0x43,
- 0xe8, 0xea, 0x9c, 0x85, 0xc3, 0xad, 0xad, 0x1f, 0x5e, 0xac, 0x0a, 0x3f, 0xbe, 0x58, 0x15, 0x7e,
- 0x7a, 0xb1, 0x2a, 0x7c, 0xf7, 0xf3, 0x6a, 0xec, 0xc7, 0x9f, 0x57, 0x63, 0xff, 0xf5, 0xf3, 0x6a,
- 0xec, 0xaf, 0xee, 0x9e, 0x6b, 0x76, 0x77, 0x78, 0xba, 0xd1, 0xd6, 0xfb, 0xf4, 0x7f, 0x28, 0x86,
- 0x7a, 0xb9, 0xc9, 0x74, 0x92, 0x96, 0xe7, 0xdf, 0x2e, 0xa7, 0x69, 0x1a, 0xeb, 0x1e, 0xfc, 0x7e,
- 0x00, 0xb8, 0x8f, 0x2b, 0xda, 0x0d, 0x33, 0x00, 0x00,
+ // 3845 bytes of a gzipped FileDescriptorProto
+ 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xd4, 0x5b, 0xcd, 0x73, 0xdb, 0x58,
+ 0x72, 0x27, 0xf8, 0xcd, 0xe6, 0x17, 0xf4, 0x44, 0xdb, 0x34, 0x6d, 0x4b, 0x5a, 0x4c, 0x76, 0xed,
+ 0xf5, 0xce, 0x48, 0xb3, 0x76, 0x66, 0x3d, 0xce, 0x6e, 0x52, 0x45, 0x51, 0x74, 0x28, 0x59, 0x96,
+ 0x34, 0x10, 0xe5, 0xa9, 0xc9, 0x64, 0x07, 0x05, 0x11, 0x4f, 0x22, 0xd6, 0x24, 0x81, 0x01, 0x40,
+ 0x99, 0xda, 0x6b, 0x92, 0xaa, 0xd4, 0x5e, 0x32, 0xff, 0xc0, 0xde, 0x92, 0xaa, 0x5c, 0x72, 0xcf,
+ 0x29, 0x39, 0x66, 0xaa, 0x72, 0x99, 0xca, 0x29, 0x55, 0xa9, 0x72, 0xb6, 0x3c, 0xb7, 0xe4, 0xb4,
+ 0xa7, 0x5c, 0xf6, 0x90, 0x7a, 0x1f, 0x00, 0x01, 0x02, 0xe0, 0xc7, 0x78, 0xab, 0x52, 0xb9, 0xe1,
+ 0xf5, 0xeb, 0x6e, 0xbe, 0x8f, 0x7e, 0xdd, 0xfd, 0x7e, 0xfd, 0x08, 0x77, 0x1c, 0x3c, 0xd2, 0xb0,
+ 0x35, 0xd4, 0x47, 0xce, 0x8e, 0x7a, 0xde, 0xd3, 0x77, 0x9c, 0x6b, 0x13, 0xdb, 0xdb, 0xa6, 0x65,
+ 0x38, 0x06, 0xaa, 0x4e, 0x3b, 0xb7, 0x49, 0x67, 0xe3, 0x9e, 0x8f, 0xbb, 0x67, 0x5d, 0x9b, 0x8e,
+ 0xb1, 0x63, 0x5a, 0x86, 0x71, 0xc1, 0xf8, 0x1b, 0x7e, 0x65, 0x54, 0xcf, 0x8e, 0xa6, 0xda, 0x7d,
+ 0xde, 0x79, 0x37, 0xd4, 0x79, 0x3e, 0x30, 0x7a, 0xaf, 0x62, 0x7b, 0x7d, 0x03, 0x69, 0xdc, 0x0d,
+ 0xff, 0xee, 0x2b, 0x7c, 0xed, 0xf6, 0xde, 0x0b, 0xc9, 0x9a, 0xaa, 0xa5, 0x0e, 0xdd, 0xee, 0x0d,
+ 0x5f, 0xf7, 0x15, 0xb6, 0x6c, 0xdd, 0x18, 0x05, 0x94, 0x6f, 0x5e, 0x1a, 0xc6, 0xe5, 0x00, 0xef,
+ 0xd0, 0xd6, 0xf9, 0xf8, 0x62, 0xc7, 0xd1, 0x87, 0xd8, 0x76, 0xd4, 0xa1, 0xc9, 0x19, 0x6a, 0x97,
+ 0xc6, 0xa5, 0x41, 0x3f, 0x77, 0xc8, 0x17, 0xa3, 0x4a, 0xff, 0x5d, 0x80, 0x9c, 0x8c, 0xbf, 0x1c,
+ 0x63, 0xdb, 0x41, 0x8f, 0x20, 0x8d, 0x7b, 0x7d, 0xa3, 0x2e, 0x6c, 0x09, 0x0f, 0x8a, 0x8f, 0xee,
+ 0x6e, 0xcf, 0xac, 0xdb, 0x36, 0xe7, 0x6b, 0xf7, 0xfa, 0x46, 0x27, 0x21, 0x53, 0x5e, 0xf4, 0x11,
+ 0x64, 0x2e, 0x06, 0x63, 0xbb, 0x5f, 0x4f, 0x52, 0xa1, 0x7b, 0x71, 0x42, 0xcf, 0x08, 0x53, 0x27,
+ 0x21, 0x33, 0x6e, 0xf2, 0x53, 0xfa, 0xe8, 0xc2, 0xa8, 0xa7, 0xe6, 0xff, 0xd4, 0xfe, 0xe8, 0x82,
+ 0xfe, 0x14, 0xe1, 0x45, 0xbb, 0x00, 0xfa, 0x48, 0x77, 0x94, 0x5e, 0x5f, 0xd5, 0x47, 0xf5, 0x34,
+ 0x95, 0xfc, 0x5e, 0xbc, 0xa4, 0xee, 0xb4, 0x08, 0x63, 0x27, 0x21, 0x17, 0x74, 0xb7, 0x41, 0x86,
+ 0xfb, 0xe5, 0x18, 0x5b, 0xd7, 0xf5, 0xcc, 0xfc, 0xe1, 0x7e, 0x42, 0x98, 0xc8, 0x70, 0x29, 0x37,
+ 0xfa, 0x19, 0xe4, 0x7b, 0x7d, 0xdc, 0x7b, 0xa5, 0x38, 0x93, 0x7a, 0x8e, 0x4a, 0x6e, 0xc6, 0x49,
+ 0xb6, 0x08, 0x5f, 0x77, 0xd2, 0x49, 0xc8, 0xb9, 0x1e, 0xfb, 0x44, 0x47, 0x50, 0x19, 0xe8, 0xb6,
+ 0xa3, 0xd8, 0x23, 0xd5, 0xb4, 0xfb, 0x86, 0x63, 0xd7, 0x8b, 0x54, 0xc7, 0xf7, 0xe3, 0x74, 0x1c,
+ 0xea, 0xb6, 0x73, 0xea, 0x32, 0x77, 0x12, 0x72, 0x79, 0xe0, 0x27, 0x10, 0x7d, 0xc6, 0xc5, 0x05,
+ 0xb6, 0x3c, 0x85, 0xf5, 0xd2, 0x7c, 0x7d, 0xc7, 0x84, 0xdb, 0x95, 0x27, 0xfa, 0x0c, 0x3f, 0x01,
+ 0x7d, 0x0e, 0xeb, 0x03, 0x43, 0xd5, 0x3c, 0x75, 0x4a, 0xaf, 0x3f, 0x1e, 0xbd, 0xaa, 0x97, 0xa9,
+ 0xd2, 0x1f, 0xc6, 0x0e, 0xd2, 0x50, 0x35, 0x57, 0x45, 0x8b, 0x08, 0x74, 0x12, 0xf2, 0xda, 0x60,
+ 0x96, 0x88, 0xbe, 0x80, 0x9a, 0x6a, 0x9a, 0x83, 0xeb, 0x59, 0xed, 0x15, 0xaa, 0xfd, 0x61, 0x9c,
+ 0xf6, 0x26, 0x91, 0x99, 0x55, 0x8f, 0xd4, 0x10, 0x15, 0x75, 0x41, 0x34, 0x2d, 0x6c, 0xaa, 0x16,
+ 0x56, 0x4c, 0xcb, 0x30, 0x0d, 0x5b, 0x1d, 0xd4, 0xab, 0x54, 0xf7, 0xfd, 0x38, 0xdd, 0x27, 0x8c,
+ 0xff, 0x84, 0xb3, 0x77, 0x12, 0x72, 0xd5, 0x0c, 0x92, 0x98, 0x56, 0xa3, 0x87, 0x6d, 0x7b, 0xaa,
+ 0x55, 0x5c, 0xa4, 0x95, 0xf2, 0x07, 0xb5, 0x06, 0x48, 0xa8, 0x0d, 0x45, 0x3c, 0x21, 0xe2, 0xca,
+ 0x95, 0xe1, 0xe0, 0xfa, 0x1a, 0x55, 0x28, 0xc5, 0x9e, 0x33, 0xca, 0xfa, 0xd2, 0x70, 0x70, 0x27,
+ 0x21, 0x03, 0xf6, 0x5a, 0x48, 0x85, 0x1b, 0x57, 0xd8, 0xd2, 0x2f, 0xae, 0xa9, 0x1a, 0x85, 0xf6,
+ 0x10, 0x7f, 0x50, 0x47, 0x54, 0xe1, 0x8f, 0xe2, 0x14, 0xbe, 0xa4, 0x42, 0x44, 0x45, 0xdb, 0x15,
+ 0xe9, 0x24, 0xe4, 0xf5, 0xab, 0x30, 0x99, 0x98, 0xd8, 0x85, 0x3e, 0x52, 0x07, 0xfa, 0x2f, 0xb1,
+ 0x42, 0x1d, 0x5c, 0x7d, 0x7d, 0xbe, 0x89, 0x3d, 0xe3, 0xdc, 0xbb, 0x84, 0x99, 0x98, 0xd8, 0x85,
+ 0x9f, 0x80, 0x34, 0xb8, 0xc9, 0xac, 0x80, 0x2a, 0x53, 0x2c, 0x75, 0xa4, 0x19, 0xc3, 0x11, 0xb6,
+ 0xed, 0x7a, 0x8d, 0xea, 0x7d, 0x7f, 0xae, 0x1d, 0x50, 0x1d, 0xb2, 0x27, 0xd3, 0x49, 0xc8, 0x35,
+ 0x35, 0x82, 0xbe, 0x9b, 0x83, 0xcc, 0x95, 0x3a, 0x18, 0xe3, 0x83, 0x74, 0x3e, 0x2b, 0xe6, 0x0e,
+ 0xd2, 0xf9, 0xbc, 0x58, 0x38, 0x48, 0xe7, 0x0b, 0x22, 0x1c, 0xa4, 0xf3, 0x20, 0x16, 0xa5, 0xfb,
+ 0x50, 0xf4, 0x39, 0x31, 0x54, 0x87, 0xdc, 0x10, 0xdb, 0xb6, 0x7a, 0x89, 0xa9, 0xcf, 0x2b, 0xc8,
+ 0x6e, 0x53, 0xaa, 0x40, 0xc9, 0xef, 0xb8, 0xa4, 0xaf, 0x04, 0x28, 0xfa, 0x7c, 0x12, 0x91, 0xe4,
+ 0x4e, 0xd8, 0x95, 0xe4, 0x4d, 0xf4, 0x1e, 0x94, 0xd9, 0x1c, 0xdd, 0x7e, 0xe2, 0x18, 0xd3, 0x72,
+ 0x89, 0x12, 0x5f, 0x72, 0xa6, 0x4d, 0x28, 0x9a, 0x8f, 0x4c, 0x8f, 0x25, 0x45, 0x59, 0xc0, 0x7c,
+ 0x64, 0xba, 0x0c, 0xdf, 0x83, 0x12, 0x59, 0x05, 0x8f, 0x23, 0x4d, 0x7f, 0xa4, 0x48, 0x68, 0x9c,
+ 0x45, 0xfa, 0xcb, 0x14, 0x88, 0xb3, 0xce, 0x0e, 0x7d, 0x0c, 0x69, 0xe2, 0xf7, 0xb9, 0x0b, 0x6f,
+ 0x6c, 0xb3, 0xa0, 0xb0, 0xed, 0x06, 0x85, 0xed, 0xae, 0x1b, 0x14, 0x76, 0xf3, 0x5f, 0xbf, 0xd9,
+ 0x4c, 0x7c, 0xf5, 0x9f, 0x9b, 0x82, 0x4c, 0x25, 0xd0, 0x6d, 0xe2, 0xe2, 0x54, 0x7d, 0xa4, 0xe8,
+ 0x1a, 0x1d, 0x72, 0x81, 0xf8, 0x2f, 0x55, 0x1f, 0xed, 0x6b, 0xe8, 0x10, 0xc4, 0x9e, 0x31, 0xb2,
+ 0xf1, 0xc8, 0x1e, 0xdb, 0x0a, 0x0b, 0x4a, 0xf5, 0x54, 0xd8, 0xfd, 0xb2, 0x68, 0xd4, 0x72, 0x39,
+ 0x4f, 0x28, 0xa3, 0x5c, 0xed, 0x05, 0x09, 0xe8, 0x08, 0xca, 0x57, 0xea, 0x40, 0xd7, 0x54, 0xc7,
+ 0xb0, 0x14, 0x1b, 0x3b, 0xdc, 0x93, 0xbf, 0x17, 0xb2, 0x80, 0x97, 0x2e, 0xd7, 0x29, 0x76, 0xce,
+ 0x4c, 0x4d, 0x75, 0xf0, 0x6e, 0xfa, 0xeb, 0x37, 0x9b, 0x82, 0x5c, 0xba, 0xf2, 0xf5, 0xa0, 0x1f,
+ 0x40, 0x55, 0x35, 0x4d, 0xc5, 0x76, 0x54, 0x07, 0x2b, 0xe7, 0xd7, 0x0e, 0xb6, 0xa9, 0x73, 0x2f,
+ 0xc9, 0x65, 0xd5, 0x34, 0x4f, 0x09, 0x75, 0x97, 0x10, 0xd1, 0xf7, 0xa1, 0x42, 0xe2, 0x80, 0xae,
+ 0x0e, 0x94, 0x3e, 0xd6, 0x2f, 0xfb, 0x4e, 0x3d, 0xbb, 0x25, 0x3c, 0x48, 0xc9, 0x65, 0x4e, 0xed,
+ 0x50, 0x22, 0xda, 0x86, 0x75, 0x97, 0xad, 0x67, 0x58, 0xd8, 0xe5, 0x25, 0x5e, 0xbf, 0x2c, 0xaf,
+ 0xf1, 0xae, 0x96, 0x61, 0x61, 0xc6, 0x2f, 0x69, 0x50, 0xf2, 0xc7, 0x0c, 0x84, 0x20, 0xad, 0xa9,
+ 0x8e, 0x4a, 0x77, 0xa0, 0x24, 0xd3, 0x6f, 0x42, 0x33, 0x55, 0xa7, 0xcf, 0xd7, 0x95, 0x7e, 0xa3,
+ 0x9b, 0x90, 0xe5, 0xaa, 0x53, 0x74, 0x18, 0xbc, 0x85, 0x6a, 0x90, 0x31, 0x2d, 0xe3, 0x0a, 0xd3,
+ 0x65, 0xc9, 0xcb, 0xac, 0x21, 0xc9, 0x50, 0x09, 0xc6, 0x17, 0x54, 0x81, 0xa4, 0x33, 0xe1, 0xbf,
+ 0x92, 0x74, 0x26, 0xe8, 0x43, 0x48, 0x93, 0x0d, 0xa0, 0xbf, 0x51, 0x89, 0x88, 0xa8, 0x5c, 0xae,
+ 0x7b, 0x6d, 0x62, 0x99, 0x72, 0x4a, 0x37, 0xa1, 0x16, 0x15, 0x6f, 0xa4, 0x3e, 0xd4, 0xa2, 0xe2,
+ 0x06, 0xfa, 0x08, 0xf2, 0x5e, 0xc0, 0x61, 0xf6, 0x75, 0x3b, 0xf4, 0x2b, 0x2e, 0xb3, 0xec, 0xb1,
+ 0x12, 0xc3, 0x22, 0xfb, 0xd3, 0x57, 0x79, 0x92, 0x50, 0x92, 0x73, 0xaa, 0x69, 0x76, 0x54, 0xbb,
+ 0x2f, 0x5d, 0x42, 0x3d, 0x2e, 0x98, 0xf8, 0xd6, 0x47, 0xa0, 0xa7, 0xc3, 0x5d, 0x1f, 0xdf, 0xc9,
+ 0x4b, 0xd2, 0x3d, 0x71, 0x9b, 0xcc, 0x82, 0xc7, 0xa3, 0x57, 0xc4, 0x82, 0x53, 0xec, 0x87, 0x68,
+ 0x7b, 0x5f, 0x93, 0x34, 0xb8, 0x1d, 0x1b, 0x57, 0x02, 0x72, 0x42, 0x40, 0x8e, 0x6c, 0x06, 0xfd,
+ 0xe4, 0x03, 0xcf, 0xf4, 0xdc, 0xa1, 0xd9, 0x74, 0xde, 0xf4, 0x67, 0x0a, 0x32, 0x6f, 0x49, 0xbf,
+ 0x4d, 0xc3, 0xcd, 0xe8, 0x10, 0x83, 0xb6, 0xa0, 0x34, 0x54, 0x27, 0x8a, 0x33, 0xe1, 0x16, 0x2a,
+ 0xd0, 0x3d, 0x87, 0xa1, 0x3a, 0xe9, 0x4e, 0x98, 0x79, 0x8a, 0x90, 0x72, 0x26, 0x76, 0x3d, 0xb9,
+ 0x95, 0x7a, 0x50, 0x92, 0xc9, 0x27, 0x7a, 0x01, 0x6b, 0x03, 0xa3, 0xa7, 0x0e, 0x94, 0x81, 0x6a,
+ 0x3b, 0x4a, 0xcf, 0x18, 0x0e, 0x75, 0x87, 0x9f, 0xbb, 0x3b, 0xe1, 0xed, 0xa5, 0xdd, 0xc4, 0x37,
+ 0xd1, 0x43, 0x92, 0x90, 0xab, 0x54, 0xf6, 0x50, 0xb5, 0x1d, 0xd6, 0x85, 0xf6, 0xa0, 0x38, 0xd4,
+ 0xed, 0x73, 0xdc, 0x57, 0xaf, 0x74, 0xc3, 0xaa, 0xa7, 0xb7, 0x52, 0x91, 0x99, 0xd7, 0x8b, 0x29,
+ 0x0f, 0xd7, 0xe4, 0x17, 0xf3, 0x6d, 0x4b, 0x26, 0x60, 0xb6, 0xae, 0xe3, 0xc9, 0xae, 0xec, 0x78,
+ 0x3e, 0x84, 0xda, 0x08, 0x4f, 0x1c, 0xc5, 0x3b, 0xd4, 0x36, 0xb3, 0x95, 0x1c, 0x5d, 0x72, 0x44,
+ 0xfa, 0x3c, 0x4f, 0x60, 0x13, 0xb3, 0x21, 0xbb, 0x62, 0x19, 0xe3, 0x91, 0x56, 0xcf, 0x6f, 0x09,
+ 0x0f, 0x32, 0x32, 0x6b, 0xa0, 0x27, 0x50, 0xa7, 0x07, 0x96, 0x79, 0x31, 0xe2, 0x6d, 0xb1, 0xe6,
+ 0x9e, 0xde, 0x02, 0xb5, 0x94, 0x1b, 0xa4, 0x9f, 0xfa, 0xc9, 0x43, 0xda, 0xcb, 0x4f, 0xfc, 0x0e,
+ 0xd4, 0x58, 0x8c, 0xc7, 0x16, 0x09, 0xf6, 0x64, 0x93, 0xe8, 0x00, 0x80, 0x0e, 0x60, 0xcd, 0xed,
+ 0x3b, 0xb1, 0x8c, 0xee, 0x84, 0xfe, 0xfe, 0x87, 0x9e, 0x80, 0xa6, 0x10, 0xd3, 0x76, 0xed, 0xb1,
+ 0x48, 0x0d, 0x15, 0xb9, 0x7d, 0x4d, 0xd3, 0x73, 0xe7, 0x4f, 0xa6, 0x46, 0x5b, 0x0a, 0x27, 0x9e,
+ 0xbc, 0x6b, 0xea, 0x3a, 0xa7, 0x36, 0xbd, 0x09, 0xc5, 0x2f, 0xc7, 0x86, 0x35, 0x1e, 0xb2, 0x21,
+ 0x95, 0xe9, 0x90, 0x80, 0x91, 0xe8, 0x11, 0xfa, 0xe7, 0x8c, 0xcf, 0xe6, 0x82, 0xd9, 0x06, 0xb7,
+ 0x28, 0x61, 0x6a, 0x51, 0xa7, 0xbe, 0x81, 0xfb, 0x8d, 0x2a, 0xb9, 0xac, 0x51, 0x79, 0x73, 0x8b,
+ 0xb7, 0xab, 0xd4, 0x77, 0xb3, 0x2b, 0x04, 0x69, 0x3a, 0xc3, 0x34, 0x73, 0x9b, 0xe4, 0x3b, 0xd6,
+ 0xd6, 0xbc, 0xfd, 0xcf, 0xfa, 0xf7, 0xdf, 0xb5, 0xc0, 0xdc, 0xef, 0xcd, 0x02, 0xf3, 0xb1, 0x16,
+ 0xf8, 0x9d, 0x6d, 0xad, 0x0b, 0x37, 0x67, 0x04, 0x95, 0x31, 0x0d, 0x6d, 0x75, 0x08, 0x5f, 0x2b,
+ 0xdc, 0x80, 0xea, 0x53, 0x24, 0xaf, 0x07, 0xf4, 0xb2, 0xb0, 0x18, 0x6b, 0xc1, 0xc5, 0x55, 0x2d,
+ 0xb8, 0xb4, 0x8c, 0x05, 0x97, 0xdf, 0xc5, 0x82, 0x2b, 0x21, 0x0b, 0x3e, 0x83, 0xb5, 0x50, 0xc2,
+ 0xeb, 0x99, 0x83, 0x10, 0x69, 0x0e, 0xc9, 0x68, 0x73, 0x48, 0xf9, 0xcc, 0x41, 0xfa, 0x8d, 0x00,
+ 0x8d, 0xf8, 0xbc, 0x37, 0xf2, 0x07, 0x7e, 0x0c, 0x37, 0xa6, 0x99, 0x89, 0x7f, 0x1d, 0x99, 0xf7,
+ 0x47, 0x5e, 0xe7, 0x74, 0x21, 0xe7, 0x44, 0x71, 0x36, 0xa6, 0xb4, 0xdf, 0x44, 0x5f, 0x40, 0x35,
+ 0x98, 0xb1, 0x93, 0x54, 0x85, 0x1c, 0x97, 0x3f, 0x08, 0x1d, 0x97, 0xe9, 0x5a, 0x78, 0x63, 0x96,
+ 0x2b, 0x57, 0xfe, 0xa6, 0x2d, 0xfd, 0x6b, 0x12, 0x6a, 0x51, 0xe9, 0x37, 0x7a, 0x0a, 0x59, 0x7e,
+ 0xb2, 0x85, 0x65, 0x4f, 0x76, 0xb6, 0x17, 0x79, 0x9a, 0x93, 0xef, 0x76, 0x9a, 0x53, 0x91, 0xdb,
+ 0x97, 0x8e, 0x5e, 0xaa, 0x8c, 0x7f, 0xa9, 0x3e, 0x80, 0x0c, 0xbb, 0x77, 0xb0, 0x80, 0x72, 0x2b,
+ 0x7c, 0x2e, 0x58, 0xf2, 0xcf, 0xb8, 0x50, 0x13, 0xf2, 0xf4, 0x83, 0xc4, 0xf0, 0x5c, 0x38, 0x37,
+ 0xf1, 0x49, 0xec, 0xef, 0xed, 0x16, 0xdf, 0xbe, 0xd9, 0xcc, 0xf1, 0x86, 0x9c, 0xa3, 0x72, 0xfb,
+ 0x9a, 0xf4, 0x1a, 0xee, 0xcc, 0xb9, 0x73, 0xbc, 0xbb, 0x45, 0x12, 0xee, 0x73, 0xac, 0xf6, 0x78,
+ 0x36, 0x5f, 0x92, 0x79, 0x4b, 0xfa, 0x7b, 0x80, 0xbc, 0x8c, 0x6d, 0x93, 0x9c, 0x1d, 0xb4, 0x0b,
+ 0x05, 0x3c, 0xe9, 0x61, 0xd3, 0x71, 0xaf, 0x16, 0xd1, 0x17, 0x44, 0xc6, 0xdd, 0x76, 0x39, 0x09,
+ 0xc8, 0xe1, 0x89, 0xa1, 0xc7, 0x1c, 0xc7, 0x89, 0x87, 0x64, 0xb8, 0xb8, 0x1f, 0xc8, 0xf9, 0x89,
+ 0x0b, 0xe4, 0xb0, 0x0c, 0x63, 0x23, 0x56, 0x6a, 0x06, 0xc9, 0x79, 0xcc, 0x91, 0x9c, 0xf4, 0x82,
+ 0x1f, 0x0b, 0x40, 0x39, 0xad, 0x00, 0x94, 0x93, 0x59, 0x30, 0xcd, 0x18, 0x2c, 0xe7, 0x27, 0x2e,
+ 0x96, 0x93, 0x5d, 0x30, 0xe2, 0x19, 0x30, 0xe7, 0x8f, 0x43, 0x60, 0xce, 0x56, 0xac, 0x68, 0x04,
+ 0x9a, 0x73, 0x1c, 0x42, 0x73, 0xf2, 0x54, 0xc9, 0x0f, 0x62, 0x95, 0x2c, 0x80, 0x73, 0x8e, 0x43,
+ 0x70, 0x4e, 0x61, 0x81, 0xc2, 0x05, 0x78, 0xce, 0x9f, 0x47, 0xe3, 0x39, 0x10, 0x8b, 0xb8, 0xf0,
+ 0x61, 0x2e, 0x07, 0xe8, 0x28, 0x31, 0x80, 0x4e, 0x31, 0x16, 0x7c, 0x60, 0xea, 0x97, 0x46, 0x74,
+ 0xce, 0x22, 0x10, 0x1d, 0x96, 0x35, 0x3d, 0x88, 0x55, 0xbe, 0x04, 0xa4, 0x73, 0x16, 0x01, 0xe9,
+ 0x94, 0x17, 0xaa, 0x5d, 0x88, 0xe9, 0x3c, 0x0b, 0x62, 0x3a, 0x95, 0x98, 0xcb, 0xec, 0xf4, 0xc8,
+ 0xc6, 0x80, 0x3a, 0xe7, 0x71, 0xa0, 0x4e, 0x35, 0x16, 0x20, 0x61, 0x1a, 0x57, 0x40, 0x75, 0x8e,
+ 0x43, 0xa8, 0x8e, 0xb8, 0xc0, 0xd2, 0x16, 0xc0, 0x3a, 0x38, 0x16, 0xd6, 0x61, 0xd8, 0xd6, 0x07,
+ 0xf3, 0xad, 0x61, 0x55, 0x5c, 0x47, 0xfa, 0x21, 0xac, 0xb9, 0x0a, 0x3c, 0xdf, 0x47, 0xbc, 0x2d,
+ 0xb6, 0x2c, 0xc3, 0xe2, 0x48, 0x0c, 0x6b, 0x48, 0x0f, 0xa0, 0xe4, 0xb1, 0xce, 0xc7, 0x7a, 0xaa,
+ 0x50, 0x0e, 0xf8, 0x36, 0xe9, 0x1f, 0x05, 0x28, 0xf9, 0xdd, 0x56, 0xe0, 0x4e, 0x5f, 0xe0, 0x77,
+ 0xfa, 0x99, 0x7b, 0x68, 0x21, 0x90, 0xf1, 0xf8, 0x73, 0x2a, 0x0e, 0xee, 0xa8, 0xd3, 0x5c, 0xea,
+ 0x21, 0xac, 0xd1, 0xec, 0x9b, 0x2d, 0x5a, 0x20, 0x28, 0x56, 0x49, 0x07, 0x5b, 0x6c, 0x4a, 0x46,
+ 0x1f, 0xc0, 0xba, 0x8f, 0xd7, 0xbb, 0x48, 0x33, 0x84, 0x43, 0xf4, 0xb8, 0x9b, 0xfc, 0x46, 0xfd,
+ 0x2f, 0x29, 0x58, 0x0b, 0xb9, 0xcd, 0x48, 0x00, 0x47, 0xf8, 0xce, 0x00, 0x4e, 0xfc, 0x85, 0x1e,
+ 0x7d, 0x0e, 0xb5, 0x00, 0xb6, 0xe3, 0x26, 0xb7, 0xa9, 0xd5, 0x20, 0x9e, 0x84, 0x2f, 0xd7, 0xf2,
+ 0x7a, 0xd0, 0xcf, 0xe1, 0x0e, 0x4d, 0xd3, 0x63, 0x12, 0xe8, 0xf4, 0x72, 0x09, 0xf4, 0x2d, 0xa2,
+ 0xa3, 0x15, 0x91, 0x44, 0xc7, 0x00, 0x3f, 0x99, 0x18, 0xe0, 0x07, 0x1d, 0x42, 0xe9, 0x12, 0x8f,
+ 0xb0, 0xad, 0xdb, 0xca, 0x0a, 0x37, 0x5f, 0x81, 0xdc, 0x3b, 0x3a, 0x09, 0xb9, 0xc8, 0x65, 0x49,
+ 0xef, 0x5f, 0x0b, 0xc2, 0x6e, 0x15, 0xca, 0x8a, 0x5f, 0x9d, 0xf4, 0x3f, 0x02, 0x94, 0x03, 0x01,
+ 0x8c, 0x58, 0x61, 0xcf, 0xd0, 0x98, 0xf9, 0x96, 0x65, 0xfa, 0x4d, 0xee, 0x78, 0x03, 0xe3, 0x92,
+ 0x5b, 0x20, 0xf9, 0x24, 0x5c, 0x5e, 0x65, 0xa5, 0xc0, 0xc3, 0x6d, 0x0d, 0x32, 0xfa, 0x48, 0xc3,
+ 0x13, 0x6e, 0x64, 0xac, 0x41, 0x64, 0x5f, 0xe1, 0x6b, 0x6e, 0x4a, 0xe4, 0x13, 0xd5, 0xf8, 0x39,
+ 0xa3, 0x73, 0x29, 0xc9, 0xac, 0x81, 0x3e, 0x86, 0x02, 0x2d, 0x8f, 0x29, 0x86, 0x69, 0xd7, 0x73,
+ 0xe1, 0x84, 0x92, 0x95, 0xb2, 0xb6, 0x4f, 0x08, 0xcf, 0xb1, 0x69, 0xcb, 0x79, 0x93, 0x7f, 0xf9,
+ 0xf2, 0xa3, 0x7c, 0x20, 0x3f, 0xba, 0x0b, 0x05, 0x32, 0x7a, 0xdb, 0x54, 0x7b, 0x98, 0x06, 0xbb,
+ 0x82, 0x3c, 0x25, 0x48, 0xff, 0x24, 0x40, 0x75, 0x26, 0xfe, 0x46, 0xce, 0xdd, 0x3d, 0x95, 0xc9,
+ 0x20, 0xd2, 0x16, 0x9a, 0xfd, 0x3d, 0x80, 0x4b, 0xd5, 0x56, 0x5e, 0xab, 0x23, 0x07, 0x6b, 0x7c,
+ 0x09, 0x0a, 0x97, 0xaa, 0xfd, 0x29, 0x25, 0x04, 0x07, 0x93, 0x99, 0x19, 0x8c, 0x0f, 0xeb, 0xc9,
+ 0xfa, 0xb1, 0x1e, 0xd4, 0x80, 0xbc, 0x69, 0xe9, 0x86, 0xa5, 0x3b, 0xd7, 0x74, 0x4d, 0x52, 0xb2,
+ 0xd7, 0x96, 0x4e, 0xe0, 0x46, 0x64, 0xe8, 0x47, 0x4f, 0xa0, 0x30, 0xcd, 0x1a, 0x84, 0xad, 0xd4,
+ 0x6c, 0x9a, 0x1a, 0x84, 0xd0, 0xa6, 0xbc, 0x64, 0x49, 0x6e, 0x44, 0x06, 0x7f, 0xd4, 0x86, 0xac,
+ 0x85, 0xed, 0xf1, 0x80, 0xa5, 0xfa, 0x95, 0x39, 0x1e, 0x37, 0x20, 0x47, 0xa8, 0xe3, 0x81, 0x23,
+ 0x73, 0x61, 0xe9, 0x0b, 0xc8, 0x32, 0x0a, 0x2a, 0x42, 0xee, 0xec, 0xe8, 0xf9, 0xd1, 0xf1, 0xa7,
+ 0x47, 0x62, 0x02, 0x01, 0x64, 0x9b, 0xad, 0x56, 0xfb, 0xa4, 0x2b, 0x0a, 0xa8, 0x00, 0x99, 0xe6,
+ 0xee, 0xb1, 0xdc, 0x15, 0x93, 0x84, 0x2c, 0xb7, 0x0f, 0xda, 0xad, 0xae, 0x98, 0x42, 0x6b, 0x50,
+ 0x66, 0xdf, 0xca, 0xb3, 0x63, 0xf9, 0x45, 0xb3, 0x2b, 0xa6, 0x7d, 0xa4, 0xd3, 0xf6, 0xd1, 0x5e,
+ 0x5b, 0x16, 0x33, 0xd2, 0x8f, 0xe1, 0xb6, 0x3b, 0x8e, 0x30, 0xd4, 0xe7, 0xa1, 0x6c, 0x82, 0x0f,
+ 0x65, 0x93, 0xbe, 0x49, 0x42, 0xc3, 0x95, 0x89, 0x40, 0xed, 0x0e, 0x66, 0x26, 0xfe, 0x68, 0x85,
+ 0xc4, 0x63, 0x66, 0xf6, 0x04, 0x1a, 0xb6, 0xf0, 0x05, 0x76, 0x7a, 0x7d, 0x96, 0xcb, 0xb8, 0x30,
+ 0x5c, 0x99, 0x53, 0xa9, 0x90, 0xcd, 0xd8, 0x7e, 0x81, 0x7b, 0x8e, 0xc2, 0x8c, 0xc0, 0xa6, 0x60,
+ 0x47, 0x41, 0x2e, 0x33, 0xea, 0x29, 0x23, 0x12, 0xff, 0xcf, 0xfc, 0x14, 0x53, 0x95, 0xa6, 0xaa,
+ 0x80, 0xba, 0x1d, 0x4a, 0x91, 0x5e, 0xaf, 0xb4, 0xd8, 0x05, 0xc8, 0xc8, 0xed, 0xae, 0xfc, 0x99,
+ 0x98, 0x42, 0x08, 0x2a, 0xf4, 0x53, 0x39, 0x3d, 0x6a, 0x9e, 0x9c, 0x76, 0x8e, 0xc9, 0x62, 0xaf,
+ 0x43, 0xd5, 0x5d, 0x6c, 0x97, 0x98, 0x41, 0x37, 0x60, 0xad, 0x75, 0xfc, 0xe2, 0xe4, 0xb0, 0xdd,
+ 0x6d, 0x4f, 0xc9, 0x59, 0xe9, 0x3f, 0x52, 0x70, 0x2b, 0x26, 0x63, 0x42, 0x1f, 0x03, 0x38, 0x13,
+ 0xc5, 0xc2, 0x3d, 0xc3, 0xd2, 0xe2, 0x8d, 0xb3, 0x3b, 0x91, 0x29, 0x87, 0x5c, 0x70, 0xf8, 0xd7,
+ 0xdc, 0x78, 0xf0, 0x33, 0xae, 0x94, 0x4c, 0xd6, 0xe6, 0xd0, 0xd0, 0xbd, 0x88, 0xbb, 0x2e, 0xee,
+ 0x11, 0xc5, 0x74, 0x4f, 0x0a, 0x0e, 0xff, 0xb2, 0xd1, 0x67, 0x70, 0x6b, 0x26, 0x6c, 0x71, 0x5f,
+ 0x6f, 0x47, 0x55, 0x7f, 0xa3, 0xa3, 0xd7, 0x8d, 0x60, 0xf4, 0x62, 0xbe, 0xde, 0x9e, 0x83, 0xc3,
+ 0x64, 0xde, 0x01, 0x87, 0x89, 0x0b, 0x7f, 0xd9, 0x55, 0x2b, 0x1c, 0x51, 0xe1, 0x6f, 0x26, 0xad,
+ 0xc8, 0xcd, 0xa6, 0x15, 0xd2, 0xef, 0x02, 0xbb, 0x1b, 0xcc, 0x52, 0x8f, 0x21, 0x6b, 0x3b, 0xaa,
+ 0x33, 0xb6, 0xf9, 0x69, 0x79, 0xb2, 0x6c, 0xca, 0xbb, 0xed, 0x7e, 0x9c, 0x52, 0x71, 0x99, 0xab,
+ 0xf9, 0x7f, 0xb9, 0xe9, 0x71, 0xdb, 0x93, 0xf9, 0x7d, 0x6c, 0x4f, 0x07, 0xb2, 0xf8, 0x0a, 0x8f,
+ 0x1c, 0xbb, 0x9e, 0xa5, 0x33, 0xbe, 0x19, 0x9e, 0x31, 0xe9, 0xde, 0xad, 0x93, 0xfc, 0xe6, 0xbf,
+ 0xde, 0x6c, 0x8a, 0x8c, 0xfb, 0x7d, 0x63, 0xa8, 0x3b, 0x78, 0x68, 0x3a, 0xd7, 0x32, 0x97, 0x97,
+ 0x3e, 0x82, 0x4a, 0x70, 0xd1, 0xe3, 0xdd, 0xc4, 0xd4, 0x11, 0x27, 0xa5, 0x7f, 0x10, 0x60, 0x3d,
+ 0x02, 0x35, 0x42, 0x4f, 0x78, 0x61, 0x88, 0x6d, 0xfc, 0x7b, 0xe1, 0xd5, 0x0b, 0xb0, 0x4f, 0xeb,
+ 0x43, 0x24, 0x30, 0x4e, 0x6f, 0x21, 0x6c, 0x8f, 0xa7, 0x04, 0xf4, 0x23, 0xa8, 0xda, 0xfa, 0xe5,
+ 0x48, 0xb1, 0x18, 0x66, 0xe2, 0x15, 0x5d, 0xc8, 0x25, 0x81, 0x74, 0xb8, 0xa5, 0x49, 0x8d, 0x64,
+ 0x37, 0x08, 0x44, 0x65, 0x86, 0x5b, 0xea, 0x01, 0x0a, 0x5f, 0x8a, 0xa2, 0x20, 0x32, 0xe1, 0x1d,
+ 0x20, 0xb2, 0xbf, 0x13, 0xe0, 0x8e, 0xfb, 0x2b, 0x51, 0x30, 0xe0, 0x27, 0x33, 0xe7, 0xe2, 0xe9,
+ 0x2a, 0xd7, 0xac, 0x6d, 0x46, 0x0b, 0x9e, 0x0c, 0xe9, 0x31, 0x94, 0xfc, 0xf4, 0xe5, 0x36, 0xef,
+ 0x6f, 0x7c, 0x01, 0x3e, 0x88, 0xe5, 0xbd, 0x07, 0x65, 0x0b, 0x3b, 0xc4, 0x4b, 0x05, 0xa0, 0xa6,
+ 0x12, 0x23, 0xf2, 0x5c, 0xb4, 0x05, 0x1b, 0x1c, 0xb3, 0x55, 0x68, 0xe8, 0xe1, 0x58, 0xd8, 0x70,
+ 0x88, 0x35, 0x5d, 0x75, 0xf0, 0xe0, 0x9a, 0xee, 0x4d, 0x5e, 0xbe, 0xc3, 0xb9, 0x8e, 0xf0, 0x84,
+ 0xdd, 0x1b, 0xf6, 0xa7, 0x2c, 0x07, 0xe9, 0xbc, 0x20, 0x26, 0x3d, 0x2b, 0x7c, 0x0a, 0x77, 0xe7,
+ 0xdd, 0xd5, 0x02, 0x0e, 0x40, 0x08, 0x96, 0xf5, 0x7e, 0x27, 0x00, 0x4c, 0x01, 0xc6, 0x29, 0x1a,
+ 0x26, 0xf8, 0xd1, 0xb0, 0x19, 0x5c, 0x38, 0x39, 0x8b, 0x0b, 0xa3, 0xfb, 0x50, 0x65, 0xd3, 0x20,
+ 0x86, 0xa3, 0x3a, 0x63, 0x0b, 0x73, 0x38, 0xb1, 0x42, 0xc9, 0xa7, 0x2e, 0x15, 0x7d, 0x0e, 0xb7,
+ 0x9d, 0xbe, 0x85, 0xed, 0xbe, 0x31, 0xd0, 0x94, 0x59, 0xe3, 0x61, 0x65, 0xae, 0xcd, 0x05, 0x56,
+ 0x2f, 0xdf, 0xf2, 0x34, 0x04, 0xe8, 0xb6, 0x0f, 0xb4, 0xcb, 0xf8, 0x41, 0xbb, 0xc0, 0xf4, 0xb3,
+ 0xc1, 0xe9, 0xff, 0x12, 0x32, 0xf4, 0xa8, 0x93, 0x64, 0xd4, 0x3b, 0x79, 0x05, 0x7e, 0xa8, 0x7e,
+ 0x0e, 0xa0, 0x3a, 0x8e, 0xa5, 0x9f, 0x8f, 0x1d, 0xcc, 0xd2, 0x8c, 0xa8, 0xb7, 0x44, 0x54, 0xbe,
+ 0xe9, 0xf2, 0xed, 0xde, 0xe5, 0x3e, 0xa3, 0x36, 0x15, 0xf5, 0xf9, 0x0d, 0x9f, 0x42, 0xe9, 0x08,
+ 0x2a, 0x41, 0x59, 0x37, 0xcb, 0x67, 0x63, 0x08, 0x66, 0xf9, 0xec, 0xd6, 0xc0, 0x1a, 0xd3, 0x3b,
+ 0x02, 0xb3, 0x14, 0xd6, 0x90, 0x7e, 0x2b, 0x40, 0xc9, 0xef, 0xa9, 0x97, 0x4e, 0xc4, 0xf9, 0xc5,
+ 0x24, 0x15, 0xbe, 0x98, 0xa4, 0x7d, 0xa9, 0xf9, 0x6d, 0xc8, 0x93, 0xd4, 0x7c, 0x6c, 0x63, 0x8d,
+ 0x57, 0xe3, 0x73, 0x97, 0xaa, 0x7d, 0x66, 0x63, 0xcd, 0xe7, 0x4f, 0x73, 0xef, 0xe6, 0x4f, 0x83,
+ 0x09, 0x7e, 0x7e, 0x26, 0xc1, 0x3f, 0x48, 0xe7, 0x33, 0x62, 0x56, 0xf6, 0xdd, 0x10, 0xa4, 0xbf,
+ 0x12, 0x20, 0xef, 0xcd, 0x37, 0x58, 0x86, 0x0e, 0x40, 0xbc, 0x6c, 0xb9, 0x58, 0x11, 0x9a, 0x35,
+ 0x78, 0x51, 0x3e, 0xe5, 0x15, 0xe5, 0x7f, 0xea, 0x25, 0xa9, 0x71, 0xf0, 0xa8, 0x7f, 0x71, 0x5d,
+ 0x28, 0x9e, 0xe7, 0xe4, 0x7f, 0xcb, 0xc7, 0x41, 0xb2, 0x2c, 0xf4, 0x47, 0x90, 0x55, 0x7b, 0x1e,
+ 0x28, 0x5c, 0x89, 0x40, 0x4b, 0x5d, 0xd6, 0xed, 0xee, 0xa4, 0x49, 0x39, 0x65, 0x2e, 0xc1, 0x47,
+ 0x95, 0x74, 0x47, 0x25, 0x1d, 0x42, 0xde, 0xe5, 0x09, 0x7a, 0xa7, 0x0a, 0xc0, 0xd9, 0xd1, 0x8b,
+ 0xe3, 0xbd, 0xfd, 0x67, 0xfb, 0xed, 0x3d, 0x9e, 0x85, 0xee, 0xed, 0xb5, 0xf7, 0xc4, 0x24, 0xe1,
+ 0x93, 0xdb, 0x2f, 0x8e, 0x5f, 0xb6, 0xf7, 0xc4, 0x14, 0x69, 0xec, 0xb5, 0x0f, 0x9b, 0x9f, 0xb5,
+ 0xf7, 0xc4, 0xb4, 0xd4, 0x84, 0x82, 0x17, 0x28, 0xc9, 0xb2, 0x98, 0xc6, 0x6b, 0x6c, 0xf1, 0xd5,
+ 0x62, 0x0d, 0xb4, 0x01, 0xc5, 0x70, 0x39, 0xa5, 0x60, 0xba, 0x55, 0x14, 0x12, 0xba, 0xaa, 0x9e,
+ 0x0e, 0x1e, 0x4f, 0x7f, 0x0a, 0x39, 0x73, 0x7c, 0xae, 0xb8, 0xb6, 0x3b, 0x53, 0x84, 0x70, 0xef,
+ 0x9c, 0xe3, 0xf3, 0x81, 0xde, 0x7b, 0x8e, 0xaf, 0x79, 0x60, 0xce, 0x9a, 0xe3, 0xf3, 0xe7, 0xcc,
+ 0xc4, 0xd9, 0x30, 0x92, 0x73, 0x86, 0x91, 0x9a, 0x19, 0x06, 0xba, 0x0f, 0xa5, 0x91, 0xa1, 0x61,
+ 0x45, 0xd5, 0x34, 0x0b, 0xdb, 0x2c, 0xdf, 0x28, 0x70, 0xcd, 0x45, 0xd2, 0xd3, 0x64, 0x1d, 0xa4,
+ 0xb6, 0x84, 0xc2, 0xc9, 0x01, 0x3a, 0x85, 0xb5, 0x69, 0x7e, 0xe1, 0x26, 0x2d, 0x2c, 0x7a, 0x6d,
+ 0xc5, 0x27, 0x17, 0x01, 0xdc, 0x43, 0xbc, 0x0a, 0x92, 0x49, 0xa6, 0x5a, 0x9b, 0x7a, 0x37, 0x93,
+ 0xce, 0x97, 0x2e, 0x4a, 0x72, 0xc9, 0x45, 0x49, 0xc8, 0xc8, 0x93, 0xf7, 0x7a, 0x66, 0xbd, 0x6f,
+ 0x2a, 0x54, 0x95, 0x33, 0xa1, 0xde, 0x0d, 0x89, 0xf1, 0x79, 0xc6, 0x0d, 0x49, 0x78, 0x97, 0x21,
+ 0x49, 0x8f, 0x41, 0xfc, 0xc4, 0xfb, 0xfd, 0x69, 0xce, 0xeb, 0x1f, 0xa6, 0x10, 0x1a, 0xe6, 0x15,
+ 0xe4, 0x89, 0xc3, 0xa6, 0x71, 0xe6, 0x4f, 0xa0, 0xe0, 0xad, 0x9e, 0xf7, 0x00, 0x2a, 0x76, 0xd9,
+ 0xf9, 0x48, 0xa6, 0x22, 0x04, 0x96, 0x23, 0xa1, 0xc6, 0xad, 0x8d, 0x33, 0x80, 0x34, 0x49, 0xbd,
+ 0x61, 0x95, 0x75, 0x1c, 0xba, 0x70, 0x1b, 0xc9, 0x2b, 0x44, 0x96, 0x7f, 0x60, 0xed, 0xff, 0x62,
+ 0x00, 0xe4, 0x2e, 0x3a, 0x83, 0x13, 0xb3, 0x3d, 0x2c, 0x07, 0x12, 0x20, 0xe9, 0x2f, 0x92, 0x50,
+ 0xf4, 0xd5, 0xea, 0xd0, 0x1f, 0x06, 0x92, 0xc1, 0xad, 0x79, 0x75, 0x3d, 0x5f, 0x26, 0x18, 0x98,
+ 0x58, 0x72, 0xf5, 0x89, 0xc5, 0x55, 0x49, 0xdd, 0x92, 0x7d, 0x7a, 0xe5, 0x92, 0xfd, 0xfb, 0x80,
+ 0x1c, 0xc3, 0x51, 0x07, 0x24, 0xde, 0xeb, 0xa3, 0x4b, 0x85, 0x9d, 0x76, 0xf6, 0x4c, 0x40, 0xa4,
+ 0x3d, 0x2f, 0x69, 0xc7, 0x09, 0xa1, 0x4b, 0x03, 0xc8, 0x7b, 0x80, 0xc9, 0xea, 0xef, 0x8a, 0xa2,
+ 0x9e, 0x26, 0x34, 0x20, 0x3f, 0xc4, 0x8e, 0x4a, 0xc3, 0x1e, 0x4b, 0x0c, 0xbc, 0xf6, 0xc3, 0xa7,
+ 0x50, 0xf4, 0x3d, 0xb6, 0x22, 0x91, 0xf0, 0xa8, 0xfd, 0xa9, 0x98, 0x68, 0xe4, 0x7e, 0xf5, 0xeb,
+ 0xad, 0xd4, 0x11, 0x7e, 0x4d, 0x7e, 0x4a, 0x6e, 0xb7, 0x3a, 0xed, 0xd6, 0x73, 0x51, 0x68, 0x14,
+ 0x7f, 0xf5, 0xeb, 0xad, 0x9c, 0x8c, 0x69, 0x75, 0xe9, 0xe1, 0x73, 0xa8, 0xce, 0xec, 0x40, 0xd0,
+ 0x41, 0x23, 0xa8, 0xec, 0x9d, 0x9d, 0x1c, 0xee, 0xb7, 0x9a, 0xdd, 0xb6, 0xf2, 0xf2, 0xb8, 0xdb,
+ 0x16, 0x05, 0x74, 0x0b, 0xd6, 0x0f, 0xf7, 0xff, 0xb4, 0xd3, 0x55, 0x5a, 0x87, 0xfb, 0xed, 0xa3,
+ 0xae, 0xd2, 0xec, 0x76, 0x9b, 0xad, 0xe7, 0x62, 0xf2, 0xd1, 0xbf, 0x15, 0xa1, 0xda, 0xdc, 0x6d,
+ 0xed, 0x93, 0xf4, 0x4d, 0xef, 0xa9, 0xd4, 0xdd, 0xb7, 0x20, 0x4d, 0xd1, 0xf0, 0xb9, 0x8f, 0xbb,
+ 0x1b, 0xf3, 0x4b, 0x86, 0xe8, 0x19, 0x64, 0x28, 0x50, 0x8e, 0xe6, 0xbf, 0xf6, 0x6e, 0x2c, 0xa8,
+ 0x21, 0x92, 0xc1, 0xd0, 0x73, 0x33, 0xf7, 0xf9, 0x77, 0x63, 0x7e, 0x49, 0x11, 0x1d, 0x42, 0xce,
+ 0x05, 0x09, 0x17, 0xbd, 0xc9, 0x6e, 0x2c, 0xac, 0xf3, 0x91, 0xa9, 0x31, 0xb0, 0x75, 0xfe, 0xcb,
+ 0xf0, 0xc6, 0x82, 0x62, 0x23, 0x92, 0xa1, 0x30, 0x85, 0xdf, 0x17, 0x3f, 0x52, 0x6f, 0x2c, 0x51,
+ 0xfc, 0x44, 0x5f, 0x40, 0x39, 0x08, 0x27, 0x2e, 0xf7, 0x7e, 0xbc, 0xb1, 0x64, 0x61, 0x92, 0xe8,
+ 0x0f, 0x62, 0x8b, 0xcb, 0xbd, 0x27, 0x6f, 0x2c, 0x59, 0xa7, 0x44, 0xbf, 0x80, 0xb5, 0x30, 0xf6,
+ 0xb7, 0xfc, 0xf3, 0xf2, 0xc6, 0x0a, 0x95, 0x4b, 0x34, 0x04, 0x14, 0x81, 0x19, 0xae, 0xf0, 0xda,
+ 0xbc, 0xb1, 0x4a, 0x21, 0x13, 0x69, 0x50, 0x9d, 0xc5, 0xd3, 0x96, 0x7d, 0x7d, 0xde, 0x58, 0xba,
+ 0xa8, 0xc9, 0x7e, 0x25, 0x88, 0xeb, 0x2c, 0xfb, 0x1a, 0xbd, 0xb1, 0x74, 0x8d, 0x13, 0x9d, 0x01,
+ 0xf8, 0xee, 0xe3, 0x4b, 0xbc, 0x4e, 0x6f, 0x2c, 0x53, 0xed, 0x44, 0x26, 0xac, 0x47, 0x5d, 0xc0,
+ 0x57, 0x79, 0xac, 0xde, 0x58, 0xa9, 0x08, 0x4a, 0xec, 0x39, 0x78, 0x95, 0x5e, 0xee, 0xf1, 0x7a,
+ 0x63, 0xc9, 0x6a, 0x28, 0xb2, 0xa1, 0x16, 0x79, 0x33, 0x5e, 0xe9, 0x2d, 0x7b, 0x63, 0xb5, 0x12,
+ 0xe9, 0xee, 0xee, 0xd7, 0x6f, 0x37, 0x84, 0x6f, 0xde, 0x6e, 0x08, 0xbf, 0x79, 0xbb, 0x21, 0x7c,
+ 0xf5, 0xed, 0x46, 0xe2, 0x9b, 0x6f, 0x37, 0x12, 0xff, 0xfe, 0xed, 0x46, 0xe2, 0xcf, 0x1e, 0x5c,
+ 0xea, 0x4e, 0x7f, 0x7c, 0xbe, 0xdd, 0x33, 0x86, 0xf4, 0x0f, 0x4b, 0xa6, 0x7a, 0xbd, 0xc3, 0x54,
+ 0x93, 0x96, 0xef, 0x6f, 0x51, 0xe7, 0x59, 0x1a, 0x60, 0x1f, 0xff, 0xef, 0x00, 0x9f, 0x6d, 0xf1,
+ 0x61, 0x36, 0x35, 0x00, 0x00,
}
// Reference imports to suppress errors if they are not otherwise used.
@@ -4531,6 +4742,7 @@ type ABCIApplicationClient interface {
ExtendVote(ctx context.Context, in *RequestExtendVote, opts ...grpc.CallOption) (*ResponseExtendVote, error)
VerifyVoteExtension(ctx context.Context, in *RequestVerifyVoteExtension, opts ...grpc.CallOption) (*ResponseVerifyVoteExtension, error)
FinalizeBlock(ctx context.Context, in *RequestFinalizeBlock, opts ...grpc.CallOption) (*ResponseFinalizeBlock, error)
+ ApplyBlockRandomness(ctx context.Context, in *RequestApplyBlockRandomness, opts ...grpc.CallOption) (*ResponseApplyBlockRandomness, error)
}
type aBCIApplicationClient struct {
@@ -4676,6 +4888,15 @@ func (c *aBCIApplicationClient) FinalizeBlock(ctx context.Context, in *RequestFi
return out, nil
}
+func (c *aBCIApplicationClient) ApplyBlockRandomness(ctx context.Context, in *RequestApplyBlockRandomness, opts ...grpc.CallOption) (*ResponseApplyBlockRandomness, error) {
+ out := new(ResponseApplyBlockRandomness)
+ err := c.cc.Invoke(ctx, "/tendermint.abci.ABCIApplication/ApplyBlockRandomness", in, out, opts...)
+ if err != nil {
+ return nil, err
+ }
+ return out, nil
+}
+
// ABCIApplicationServer is the server API for ABCIApplication service.
type ABCIApplicationServer interface {
// Echo a string to test an abci client/server implementation
@@ -4694,6 +4915,7 @@ type ABCIApplicationServer interface {
ExtendVote(context.Context, *RequestExtendVote) (*ResponseExtendVote, error)
VerifyVoteExtension(context.Context, *RequestVerifyVoteExtension) (*ResponseVerifyVoteExtension, error)
FinalizeBlock(context.Context, *RequestFinalizeBlock) (*ResponseFinalizeBlock, error)
+ ApplyBlockRandomness(context.Context, *RequestApplyBlockRandomness) (*ResponseApplyBlockRandomness, error)
}
// UnimplementedABCIApplicationServer can be embedded to have forward compatible implementations.
@@ -4745,6 +4967,9 @@ func (*UnimplementedABCIApplicationServer) VerifyVoteExtension(ctx context.Conte
func (*UnimplementedABCIApplicationServer) FinalizeBlock(ctx context.Context, req *RequestFinalizeBlock) (*ResponseFinalizeBlock, error) {
return nil, status.Errorf(codes.Unimplemented, "method FinalizeBlock not implemented")
}
+func (*UnimplementedABCIApplicationServer) ApplyBlockRandomness(ctx context.Context, req *RequestApplyBlockRandomness) (*ResponseApplyBlockRandomness, error) {
+ return nil, status.Errorf(codes.Unimplemented, "method ApplyBlockRandomness not implemented")
+}
func RegisterABCIApplicationServer(s grpc1.Server, srv ABCIApplicationServer) {
s.RegisterService(&_ABCIApplication_serviceDesc, srv)
@@ -5020,6 +5245,24 @@ func _ABCIApplication_FinalizeBlock_Handler(srv interface{}, ctx context.Context
return interceptor(ctx, in, info, handler)
}
+func _ABCIApplication_ApplyBlockRandomness_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+ in := new(RequestApplyBlockRandomness)
+ if err := dec(in); err != nil {
+ return nil, err
+ }
+ if interceptor == nil {
+ return srv.(ABCIApplicationServer).ApplyBlockRandomness(ctx, in)
+ }
+ info := &grpc.UnaryServerInfo{
+ Server: srv,
+ FullMethod: "/tendermint.abci.ABCIApplication/ApplyBlockRandomness",
+ }
+ handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+ return srv.(ABCIApplicationServer).ApplyBlockRandomness(ctx, req.(*RequestApplyBlockRandomness))
+ }
+ return interceptor(ctx, in, info, handler)
+}
+
var ABCIApplication_serviceDesc = _ABCIApplication_serviceDesc
var _ABCIApplication_serviceDesc = grpc.ServiceDesc{
ServiceName: "tendermint.abci.ABCIApplication",
@@ -5085,6 +5328,10 @@ var _ABCIApplication_serviceDesc = grpc.ServiceDesc{
MethodName: "FinalizeBlock",
Handler: _ABCIApplication_FinalizeBlock_Handler,
},
+ {
+ MethodName: "ApplyBlockRandomness",
+ Handler: _ABCIApplication_ApplyBlockRandomness_Handler,
+ },
},
Streams: []grpc.StreamDesc{},
Metadata: "tendermint/abci/types.proto",
@@ -5493,6 +5740,32 @@ func (m *Request_FinalizeBlock) MarshalToSizedBuffer(dAtA []byte) (int, error) {
}
return len(dAtA) - i, nil
}
+func (m *Request_ApplyBlockRandomness) MarshalTo(dAtA []byte) (int, error) {
+ size := m.Size()
+ return m.MarshalToSizedBuffer(dAtA[:size])
+}
+
+func (m *Request_ApplyBlockRandomness) MarshalToSizedBuffer(dAtA []byte) (int, error) {
+ if m == nil {
+ return 0, nil
+ }
+ i := len(dAtA)
+ if m.ApplyBlockRandomness != nil {
+ {
+ size, err := m.ApplyBlockRandomness.MarshalToSizedBuffer(dAtA[:i])
+ if err != nil {
+ return 0, err
+ }
+ i -= size
+ i = encodeVarintTypes(dAtA, i, uint64(size))
+ }
+ i--
+ dAtA[i] = 0x1
+ i--
+ dAtA[i] = 0xa2
+ }
+ return len(dAtA) - i, nil
+}
func (m *RequestEcho) Marshal() (dAtA []byte, err error) {
size := m.Size()
dAtA = make([]byte, size)
@@ -5673,12 +5946,12 @@ func (m *RequestInitChain) MarshalToSizedBuffer(dAtA []byte) (int, error) {
i--
dAtA[i] = 0x12
}
- n18, err18 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(m.Time, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(m.Time):])
- if err18 != nil {
- return 0, err18
+ n19, err19 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(m.Time, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(m.Time):])
+ if err19 != nil {
+ return 0, err19
}
- i -= n18
- i = encodeVarintTypes(dAtA, i, uint64(n18))
+ i -= n19
+ i = encodeVarintTypes(dAtA, i, uint64(n19))
i--
dAtA[i] = 0xa
return len(dAtA) - i, nil
@@ -6009,12 +6282,12 @@ func (m *RequestPrepareProposal) MarshalToSizedBuffer(dAtA []byte) (int, error)
i--
dAtA[i] = 0x3a
}
- n21, err21 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(m.Time, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(m.Time):])
- if err21 != nil {
- return 0, err21
+ n22, err22 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(m.Time, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(m.Time):])
+ if err22 != nil {
+ return 0, err22
}
- i -= n21
- i = encodeVarintTypes(dAtA, i, uint64(n21))
+ i -= n22
+ i = encodeVarintTypes(dAtA, i, uint64(n22))
i--
dAtA[i] = 0x32
if m.Height != 0 {
@@ -6141,12 +6414,12 @@ func (m *RequestProcessProposal) MarshalToSizedBuffer(dAtA []byte) (int, error)
i--
dAtA[i] = 0x42
}
- n25, err25 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(m.Time, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(m.Time):])
- if err25 != nil {
- return 0, err25
+ n26, err26 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(m.Time, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(m.Time):])
+ if err26 != nil {
+ return 0, err26
}
- i -= n25
- i = encodeVarintTypes(dAtA, i, uint64(n25))
+ i -= n26
+ i = encodeVarintTypes(dAtA, i, uint64(n26))
i--
dAtA[i] = 0x3a
if m.Round != 0 {
@@ -6400,6 +6673,56 @@ func (m *RequestFinalizeBlock) MarshalToSizedBuffer(dAtA []byte) (int, error) {
return len(dAtA) - i, nil
}
+func (m *RequestApplyBlockRandomness) Marshal() (dAtA []byte, err error) {
+ size := m.Size()
+ dAtA = make([]byte, size)
+ n, err := m.MarshalToSizedBuffer(dAtA[:size])
+ if err != nil {
+ return nil, err
+ }
+ return dAtA[:n], nil
+}
+
+func (m *RequestApplyBlockRandomness) MarshalTo(dAtA []byte) (int, error) {
+ size := m.Size()
+ return m.MarshalToSizedBuffer(dAtA[:size])
+}
+
+func (m *RequestApplyBlockRandomness) MarshalToSizedBuffer(dAtA []byte) (int, error) {
+ if m == nil {
+ return 0, nil
+ }
+ i := len(dAtA)
+ _ = i
+ var l int
+ _ = l
+ if len(m.Beacon) > 0 {
+ i -= len(m.Beacon)
+ copy(dAtA[i:], m.Beacon)
+ i = encodeVarintTypes(dAtA, i, uint64(len(m.Beacon)))
+ i--
+ dAtA[i] = 0x22
+ }
+ if m.Round != 0 {
+ i = encodeVarintTypes(dAtA, i, uint64(m.Round))
+ i--
+ dAtA[i] = 0x18
+ }
+ if m.Height != 0 {
+ i = encodeVarintTypes(dAtA, i, uint64(m.Height))
+ i--
+ dAtA[i] = 0x10
+ }
+ if len(m.Hash) > 0 {
+ i -= len(m.Hash)
+ copy(dAtA[i:], m.Hash)
+ i = encodeVarintTypes(dAtA, i, uint64(len(m.Hash)))
+ i--
+ dAtA[i] = 0xa
+ }
+ return len(dAtA) - i, nil
+}
+
func (m *Response) Marshal() (dAtA []byte, err error) {
size := m.Size()
dAtA = make([]byte, size)
@@ -6821,10 +7144,36 @@ func (m *Response_FinalizeBlock) MarshalToSizedBuffer(dAtA []byte) (int, error)
}
return len(dAtA) - i, nil
}
-func (m *ResponseException) Marshal() (dAtA []byte, err error) {
+func (m *Response_ApplyBlockRandomness) MarshalTo(dAtA []byte) (int, error) {
size := m.Size()
- dAtA = make([]byte, size)
- n, err := m.MarshalToSizedBuffer(dAtA[:size])
+ return m.MarshalToSizedBuffer(dAtA[:size])
+}
+
+func (m *Response_ApplyBlockRandomness) MarshalToSizedBuffer(dAtA []byte) (int, error) {
+ if m == nil {
+ return 0, nil
+ }
+ i := len(dAtA)
+ if m.ApplyBlockRandomness != nil {
+ {
+ size, err := m.ApplyBlockRandomness.MarshalToSizedBuffer(dAtA[:i])
+ if err != nil {
+ return 0, err
+ }
+ i -= size
+ i = encodeVarintTypes(dAtA, i, uint64(size))
+ }
+ i--
+ dAtA[i] = 0x1
+ i--
+ dAtA[i] = 0x8a
+ }
+ return len(dAtA) - i, nil
+}
+func (m *ResponseException) Marshal() (dAtA []byte, err error) {
+ size := m.Size()
+ dAtA = make([]byte, size)
+ n, err := m.MarshalToSizedBuffer(dAtA[:size])
if err != nil {
return nil, err
}
@@ -7062,12 +7411,12 @@ func (m *ResponseInitChain_GenesisTime) MarshalToSizedBuffer(dAtA []byte) (int,
}
i := len(dAtA)
if m.GenesisTime != nil {
- n49, err49 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(*m.GenesisTime, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(*m.GenesisTime):])
- if err49 != nil {
- return 0, err49
+ n51, err51 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(*m.GenesisTime, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(*m.GenesisTime):])
+ if err51 != nil {
+ return 0, err51
}
- i -= n49
- i = encodeVarintTypes(dAtA, i, uint64(n49))
+ i -= n51
+ i = encodeVarintTypes(dAtA, i, uint64(n51))
i--
dAtA[i] = 0x32
}
@@ -7762,6 +8111,39 @@ func (m *ResponseFinalizeBlock) MarshalToSizedBuffer(dAtA []byte) (int, error) {
return len(dAtA) - i, nil
}
+func (m *ResponseApplyBlockRandomness) Marshal() (dAtA []byte, err error) {
+ size := m.Size()
+ dAtA = make([]byte, size)
+ n, err := m.MarshalToSizedBuffer(dAtA[:size])
+ if err != nil {
+ return nil, err
+ }
+ return dAtA[:n], nil
+}
+
+func (m *ResponseApplyBlockRandomness) MarshalTo(dAtA []byte) (int, error) {
+ size := m.Size()
+ return m.MarshalToSizedBuffer(dAtA[:size])
+}
+
+func (m *ResponseApplyBlockRandomness) MarshalToSizedBuffer(dAtA []byte) (int, error) {
+ if m == nil {
+ return 0, nil
+ }
+ i := len(dAtA)
+ _ = i
+ var l int
+ _ = l
+ if len(m.AppHash) > 0 {
+ i -= len(m.AppHash)
+ copy(dAtA[i:], m.AppHash)
+ i = encodeVarintTypes(dAtA, i, uint64(len(m.AppHash)))
+ i--
+ dAtA[i] = 0xa
+ }
+ return len(dAtA) - i, nil
+}
+
func (m *CommitInfo) Marshal() (dAtA []byte, err error) {
size := m.Size()
dAtA = make([]byte, size)
@@ -7785,6 +8167,20 @@ func (m *CommitInfo) MarshalToSizedBuffer(dAtA []byte) (int, error) {
_ = i
var l int
_ = l
+ if len(m.AppHash) > 0 {
+ i -= len(m.AppHash)
+ copy(dAtA[i:], m.AppHash)
+ i = encodeVarintTypes(dAtA, i, uint64(len(m.AppHash)))
+ i--
+ dAtA[i] = 0x32
+ }
+ if len(m.Beacon) > 0 {
+ i -= len(m.Beacon)
+ copy(dAtA[i:], m.Beacon)
+ i = encodeVarintTypes(dAtA, i, uint64(len(m.Beacon)))
+ i--
+ dAtA[i] = 0x2a
+ }
if len(m.ThresholdVoteExtensions) > 0 {
for iNdEx := len(m.ThresholdVoteExtensions) - 1; iNdEx >= 0; iNdEx-- {
{
@@ -8435,12 +8831,12 @@ func (m *Misbehavior) MarshalToSizedBuffer(dAtA []byte) (int, error) {
i--
dAtA[i] = 0x28
}
- n62, err62 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(m.Time, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(m.Time):])
- if err62 != nil {
- return 0, err62
+ n64, err64 := github_com_cosmos_gogoproto_types.StdTimeMarshalTo(m.Time, dAtA[i-github_com_cosmos_gogoproto_types.SizeOfStdTime(m.Time):])
+ if err64 != nil {
+ return 0, err64
}
- i -= n62
- i = encodeVarintTypes(dAtA, i, uint64(n62))
+ i -= n64
+ i = encodeVarintTypes(dAtA, i, uint64(n64))
i--
dAtA[i] = 0x22
if m.Height != 0 {
@@ -8719,6 +9115,18 @@ func (m *Request_FinalizeBlock) Size() (n int) {
}
return n
}
+func (m *Request_ApplyBlockRandomness) Size() (n int) {
+ if m == nil {
+ return 0
+ }
+ var l int
+ _ = l
+ if m.ApplyBlockRandomness != nil {
+ l = m.ApplyBlockRandomness.Size()
+ n += 2 + l + sovTypes(uint64(l))
+ }
+ return n
+}
func (m *RequestEcho) Size() (n int) {
if m == nil {
return 0
@@ -9102,6 +9510,29 @@ func (m *RequestFinalizeBlock) Size() (n int) {
return n
}
+func (m *RequestApplyBlockRandomness) Size() (n int) {
+ if m == nil {
+ return 0
+ }
+ var l int
+ _ = l
+ l = len(m.Hash)
+ if l > 0 {
+ n += 1 + l + sovTypes(uint64(l))
+ }
+ if m.Height != 0 {
+ n += 1 + sovTypes(uint64(m.Height))
+ }
+ if m.Round != 0 {
+ n += 1 + sovTypes(uint64(m.Round))
+ }
+ l = len(m.Beacon)
+ if l > 0 {
+ n += 1 + l + sovTypes(uint64(l))
+ }
+ return n
+}
+
func (m *Response) Size() (n int) {
if m == nil {
return 0
@@ -9306,6 +9737,18 @@ func (m *Response_FinalizeBlock) Size() (n int) {
}
return n
}
+func (m *Response_ApplyBlockRandomness) Size() (n int) {
+ if m == nil {
+ return 0
+ }
+ var l int
+ _ = l
+ if m.ApplyBlockRandomness != nil {
+ l = m.ApplyBlockRandomness.Size()
+ n += 2 + l + sovTypes(uint64(l))
+ }
+ return n
+}
func (m *ResponseException) Size() (n int) {
if m == nil {
return 0
@@ -9704,6 +10147,19 @@ func (m *ResponseFinalizeBlock) Size() (n int) {
return n
}
+func (m *ResponseApplyBlockRandomness) Size() (n int) {
+ if m == nil {
+ return 0
+ }
+ var l int
+ _ = l
+ l = len(m.AppHash)
+ if l > 0 {
+ n += 1 + l + sovTypes(uint64(l))
+ }
+ return n
+}
+
func (m *CommitInfo) Size() (n int) {
if m == nil {
return 0
@@ -9727,6 +10183,14 @@ func (m *CommitInfo) Size() (n int) {
n += 1 + l + sovTypes(uint64(l))
}
}
+ l = len(m.Beacon)
+ if l > 0 {
+ n += 1 + l + sovTypes(uint64(l))
+ }
+ l = len(m.AppHash)
+ if l > 0 {
+ n += 1 + l + sovTypes(uint64(l))
+ }
return n
}
@@ -10565,6 +11029,41 @@ func (m *Request) Unmarshal(dAtA []byte) error {
}
m.Value = &Request_FinalizeBlock{v}
iNdEx = postIndex
+ case 20:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field ApplyBlockRandomness", wireType)
+ }
+ var msglen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ msglen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if msglen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + msglen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ v := &RequestApplyBlockRandomness{}
+ if err := v.Unmarshal(dAtA[iNdEx:postIndex]); err != nil {
+ return err
+ }
+ m.Value = &Request_ApplyBlockRandomness{v}
+ iNdEx = postIndex
default:
iNdEx = preIndex
skippy, err := skipTypes(dAtA[iNdEx:])
@@ -13283,6 +13782,162 @@ func (m *RequestFinalizeBlock) Unmarshal(dAtA []byte) error {
}
return nil
}
+func (m *RequestApplyBlockRandomness) Unmarshal(dAtA []byte) error {
+ l := len(dAtA)
+ iNdEx := 0
+ for iNdEx < l {
+ preIndex := iNdEx
+ var wire uint64
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ wire |= uint64(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ fieldNum := int32(wire >> 3)
+ wireType := int(wire & 0x7)
+ if wireType == 4 {
+ return fmt.Errorf("proto: RequestApplyBlockRandomness: wiretype end group for non-group")
+ }
+ if fieldNum <= 0 {
+ return fmt.Errorf("proto: RequestApplyBlockRandomness: illegal tag %d (wire type %d)", fieldNum, wire)
+ }
+ switch fieldNum {
+ case 1:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field Hash", wireType)
+ }
+ var byteLen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ byteLen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if byteLen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + byteLen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ m.Hash = append(m.Hash[:0], dAtA[iNdEx:postIndex]...)
+ if m.Hash == nil {
+ m.Hash = []byte{}
+ }
+ iNdEx = postIndex
+ case 2:
+ if wireType != 0 {
+ return fmt.Errorf("proto: wrong wireType = %d for field Height", wireType)
+ }
+ m.Height = 0
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ m.Height |= int64(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ case 3:
+ if wireType != 0 {
+ return fmt.Errorf("proto: wrong wireType = %d for field Round", wireType)
+ }
+ m.Round = 0
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ m.Round |= int32(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ case 4:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field Beacon", wireType)
+ }
+ var byteLen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ byteLen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if byteLen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + byteLen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ m.Beacon = append(m.Beacon[:0], dAtA[iNdEx:postIndex]...)
+ if m.Beacon == nil {
+ m.Beacon = []byte{}
+ }
+ iNdEx = postIndex
+ default:
+ iNdEx = preIndex
+ skippy, err := skipTypes(dAtA[iNdEx:])
+ if err != nil {
+ return err
+ }
+ if (skippy < 0) || (iNdEx+skippy) < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if (iNdEx + skippy) > l {
+ return io.ErrUnexpectedEOF
+ }
+ iNdEx += skippy
+ }
+ }
+
+ if iNdEx > l {
+ return io.ErrUnexpectedEOF
+ }
+ return nil
+}
func (m *Response) Unmarshal(dAtA []byte) error {
l := len(dAtA)
iNdEx := 0
@@ -13872,6 +14527,41 @@ func (m *Response) Unmarshal(dAtA []byte) error {
}
m.Value = &Response_FinalizeBlock{v}
iNdEx = postIndex
+ case 17:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field ApplyBlockRandomness", wireType)
+ }
+ var msglen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ msglen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if msglen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + msglen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ v := &ResponseApplyBlockRandomness{}
+ if err := v.Unmarshal(dAtA[iNdEx:postIndex]); err != nil {
+ return err
+ }
+ m.Value = &Response_ApplyBlockRandomness{v}
+ iNdEx = postIndex
default:
iNdEx = preIndex
skippy, err := skipTypes(dAtA[iNdEx:])
@@ -16382,6 +17072,90 @@ func (m *ResponseFinalizeBlock) Unmarshal(dAtA []byte) error {
}
return nil
}
+func (m *ResponseApplyBlockRandomness) Unmarshal(dAtA []byte) error {
+ l := len(dAtA)
+ iNdEx := 0
+ for iNdEx < l {
+ preIndex := iNdEx
+ var wire uint64
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ wire |= uint64(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ fieldNum := int32(wire >> 3)
+ wireType := int(wire & 0x7)
+ if wireType == 4 {
+ return fmt.Errorf("proto: ResponseApplyBlockRandomness: wiretype end group for non-group")
+ }
+ if fieldNum <= 0 {
+ return fmt.Errorf("proto: ResponseApplyBlockRandomness: illegal tag %d (wire type %d)", fieldNum, wire)
+ }
+ switch fieldNum {
+ case 1:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field AppHash", wireType)
+ }
+ var byteLen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ byteLen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if byteLen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + byteLen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ m.AppHash = append(m.AppHash[:0], dAtA[iNdEx:postIndex]...)
+ if m.AppHash == nil {
+ m.AppHash = []byte{}
+ }
+ iNdEx = postIndex
+ default:
+ iNdEx = preIndex
+ skippy, err := skipTypes(dAtA[iNdEx:])
+ if err != nil {
+ return err
+ }
+ if (skippy < 0) || (iNdEx+skippy) < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if (iNdEx + skippy) > l {
+ return io.ErrUnexpectedEOF
+ }
+ iNdEx += skippy
+ }
+ }
+
+ if iNdEx > l {
+ return io.ErrUnexpectedEOF
+ }
+ return nil
+}
func (m *CommitInfo) Unmarshal(dAtA []byte) error {
l := len(dAtA)
iNdEx := 0
@@ -16532,6 +17306,74 @@ func (m *CommitInfo) Unmarshal(dAtA []byte) error {
return err
}
iNdEx = postIndex
+ case 5:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field Beacon", wireType)
+ }
+ var byteLen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ byteLen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if byteLen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + byteLen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ m.Beacon = append(m.Beacon[:0], dAtA[iNdEx:postIndex]...)
+ if m.Beacon == nil {
+ m.Beacon = []byte{}
+ }
+ iNdEx = postIndex
+ case 6:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field AppHash", wireType)
+ }
+ var byteLen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ byteLen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if byteLen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + byteLen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ m.AppHash = append(m.AppHash[:0], dAtA[iNdEx:postIndex]...)
+ if m.AppHash == nil {
+ m.AppHash = []byte{}
+ }
+ iNdEx = postIndex
default:
iNdEx = preIndex
skippy, err := skipTypes(dAtA[iNdEx:])
diff --git a/abci/types/types_test.go b/abci/types/types_test.go
index ca178c8e23..8d3e846f00 100644
--- a/abci/types/types_test.go
+++ b/abci/types/types_test.go
@@ -1,6 +1,7 @@
package types_test
import (
+ "context"
"encoding/json"
"testing"
@@ -130,3 +131,11 @@ func TestVoteExtensionDoesNotSharetheApplicationsBytes(t *testing.T) {
require.Equal(t, []byte("returned by the application"), converted.Extension)
require.Equal(t, []byte("also returned by the application"), converted.GetSignRequestId())
}
+
+// TestBaseApplicationApplyBlockRandomness checks that the base application refuses ApplyBlockRandomness:
+// an empty app hash must never pass as an answer.
+func TestBaseApplicationApplyBlockRandomness(t *testing.T) {
+ resp, err := abci.NewBaseApplication().ApplyBlockRandomness(context.Background(), &abci.RequestApplyBlockRandomness{})
+ require.ErrorIs(t, err, abci.ErrApplyBlockRandomnessNotImplemented)
+ require.Nil(t, resp)
+}
diff --git a/go.mod b/go.mod
index 4f17668d1c..7347ffa421 100644
--- a/go.mod
+++ b/go.mod
@@ -276,7 +276,6 @@ require (
golang.org/x/tools v0.52.0 // indirect
google.golang.org/genproto/googleapis/api v0.0.0-20261012220534-4341edf3f941 // indirect
google.golang.org/genproto/googleapis/rpc v0.0.0-20261012220534-4341edf3f941 // indirect
- google.golang.org/protobuf v1.36.13-0.20261016172727-e9ee2a76ab8e // indirect
gopkg.in/yaml.v3 v3.0.1 // indirect
honnef.co/go/tools v0.8.2 // indirect
mvdan.cc/gofumpt v0.12.0 // indirect
@@ -337,6 +336,7 @@ require (
golang.org/x/term v0.47.0
golang.org/x/time v0.16.0
google.golang.org/grpc v1.85.0
+ google.golang.org/protobuf v1.36.13-0.20261016172727-e9ee2a76ab8e
pgregory.net/rapid v1.3.0
)
diff --git a/internal/blocksync/applier.go b/internal/blocksync/applier.go
index 66e7c61fa5..f9a7e07665 100644
--- a/internal/blocksync/applier.go
+++ b/internal/blocksync/applier.go
@@ -93,6 +93,9 @@ func (e *blockApplier) Apply(ctx context.Context, block *types.Block, commit *ty
blockID := block.BlockID(blockParts)
partSetTime := e.observeSince("partset", start)
+ // Before consensus version 2 a commit carries no beacon; see WithoutRandomBeacon.
+ commit = commit.WithoutRandomBeacon()
+
start = time.Now()
verified, err := e.verify(ctx, blockID, block, commit)
if err != nil {
diff --git a/internal/blocksync/commit_randomness_test.go b/internal/blocksync/commit_randomness_test.go
new file mode 100644
index 0000000000..e239c7adc1
--- /dev/null
+++ b/internal/blocksync/commit_randomness_test.go
@@ -0,0 +1,126 @@
+package blocksync
+
+import (
+ "context"
+ "testing"
+
+ "github.com/stretchr/testify/mock"
+ "github.com/stretchr/testify/require"
+
+ abciclient "github.com/dashpay/tenderdash/abci/client"
+ abci "github.com/dashpay/tenderdash/abci/types"
+ "github.com/dashpay/tenderdash/crypto"
+ "github.com/dashpay/tenderdash/internal/eventbus"
+ mpmocks "github.com/dashpay/tenderdash/internal/mempool/mocks"
+ "github.com/dashpay/tenderdash/internal/proxy"
+ sm "github.com/dashpay/tenderdash/internal/state"
+ "github.com/dashpay/tenderdash/internal/store"
+ "github.com/dashpay/tenderdash/internal/test/factory"
+ dbm "github.com/dashpay/tenderdash/libs/db"
+ "github.com/dashpay/tenderdash/libs/log"
+ bcproto "github.com/dashpay/tenderdash/proto/tendermint/blocksync"
+ "github.com/dashpay/tenderdash/types"
+)
+
+// TestBlockResponseRefusesPaddedCommitBeacon is the regression test for a block sync peer relaying an
+// honest block and its validly signed commit with the commit's beacon padded: neither the commit hash
+// nor its threshold signature covers the beacon, so before the size bound the padded commit passed
+// verification, was stored as the seen commit and reached the application. The response is now
+// refused while it is decoded, before anything is verified, stored or passed on.
+func TestBlockResponseRefusesPaddedCommitBeacon(t *testing.T) {
+ ctx, cancel := context.WithCancel(context.Background())
+ defer cancel()
+
+ genDoc, privVals := factory.RandGenesisDoc(1, factory.ConsensusParams())
+ state, err := sm.MakeGenesisState(genDoc)
+ require.NoError(t, err)
+ block, _, _, seen := makeNextBlock(ctx, t, state, privVals[0], 1, types.NewCommit(0, 0, types.BlockID{}, nil, nil))
+
+ response := func(beacon, appHash []byte) (*BlockResponse, error) {
+ t.Helper()
+ pbBlock, err := block.ToProto()
+ require.NoError(t, err)
+ pbCommit := seen.ToProto()
+ pbCommit.Beacon = beacon
+ pbCommit.AppHash = appHash
+ bz, err := (&bcproto.BlockResponse{Block: pbBlock, Commit: pbCommit}).Marshal()
+ require.NoError(t, err)
+ var decoded bcproto.BlockResponse
+ require.NoError(t, decoded.Unmarshal(bz))
+ return BlockResponseFromProto(&decoded, "peer")
+ }
+
+ honest, err := response(nil, nil)
+ require.NoError(t, err)
+ require.Equal(t, seen.Hash(), honest.Commit.Hash())
+
+ for name, fields := range map[string][2][]byte{
+ "25 MiB beacon": {make([]byte, 25<<20), []byte("junk")},
+ "5 MiB beacon": {make([]byte, 5<<20), make([]byte, 32)},
+ "app hash without beacon": {nil, make([]byte, 32)},
+ } {
+ t.Run(name, func(t *testing.T) {
+ resp, err := response(fields[0], fields[1])
+ require.ErrorIs(t, err, types.ErrInvalidCommitRandomness)
+ require.Nil(t, resp)
+ })
+ }
+}
+
+// finalizeRecorder records the last commit FinalizeBlock received.
+type finalizeRecorder struct {
+ abci.BaseApplication
+ commit abci.CommitInfo
+}
+
+func (r *finalizeRecorder) FinalizeBlock(_ context.Context, req *abci.RequestFinalizeBlock) (*abci.ResponseFinalizeBlock, error) {
+ r.commit = req.Commit
+ return &abci.ResponseFinalizeBlock{}, nil
+}
+
+// TestBlockSyncDropsRelayedCommitRandomness is the regression test for a block sync peer relaying an
+// honest block and its validly signed commit with a correctly sized beacon and app hash added: neither
+// is covered by the commit's hash or threshold signature, so the commit passes verification. Before
+// consensus version 2 a commit carries neither, and the applier drops both, so they are neither passed
+// to the application nor stored as the seen commit this node serves.
+func TestBlockSyncDropsRelayedCommitRandomness(t *testing.T) {
+ ctx, cancel := context.WithCancel(context.Background())
+ defer cancel()
+ logger := log.NewNopLogger()
+
+ genDoc, privVals := factory.RandGenesisDoc(1, factory.ConsensusParams())
+ state, err := sm.MakeGenesisState(genDoc)
+ require.NoError(t, err)
+ stateStore := sm.NewStore(dbm.NewMemDB())
+ require.NoError(t, stateStore.Save(state))
+ blockStore := store.NewBlockStore(dbm.NewMemDB())
+ app := &finalizeRecorder{}
+ proxyApp := proxy.New(abciclient.NewLocalClient(logger, app), logger, proxy.NopMetrics())
+ require.NoError(t, proxyApp.Start(ctx))
+ eventBus := eventbus.NewDefault(logger)
+ require.NoError(t, eventBus.Start(ctx))
+ mp := &mpmocks.Mempool{}
+ mp.On("Lock").Return()
+ mp.On("Unlock").Return()
+ mp.On("FlushAppConn", mock.Anything).Return(nil)
+ mp.On("Update", mock.Anything, mock.Anything, mock.Anything, mock.Anything,
+ mock.Anything, mock.Anything, mock.Anything).Return(nil)
+ blockExec := sm.NewBlockExecutor(stateStore, proxyApp, mp, sm.EmptyEvidencePool{}, blockStore, eventBus)
+ applier := newBlockApplier(blockExec, blockStore, applierWithState(state))
+
+ block, _, _, seen := makeNextBlock(ctx, t, state, privVals[0], 1, types.NewCommit(0, 0, types.BlockID{}, nil, nil))
+ pbBlock, err := block.ToProto()
+ require.NoError(t, err)
+ pbCommit := seen.ToProto()
+ pbCommit.Beacon = crypto.CRandBytes(types.SignatureSize)
+ pbCommit.AppHash = crypto.CRandBytes(crypto.DefaultAppHashSize)
+ resp, err := BlockResponseFromProto(&bcproto.BlockResponse{Block: pbBlock, Commit: pbCommit}, "peer")
+ require.NoError(t, err, "a correctly sized beacon and app hash pass the size bound")
+
+ require.NoError(t, applier.Apply(ctx, resp.Block, resp.Commit))
+ require.Equal(t, seen.ToCommitInfo(), app.commit)
+ stored := blockStore.LoadSeenCommitAt(1)
+ require.Empty(t, stored.Beacon)
+ require.Empty(t, stored.AppHash)
+ require.Equal(t, seen.Hash(), stored.Hash())
+}
diff --git a/internal/consensus/msgs_test.go b/internal/consensus/msgs_test.go
index 726d616a4a..1bc066b436 100644
--- a/internal/consensus/msgs_test.go
+++ b/internal/consensus/msgs_test.go
@@ -761,3 +761,25 @@ func TestHasVoteMessageValidateBasic(t *testing.T) {
})
}
}
+
+// TestCommitMessageRefusesMalformedRandomness checks that a commit gossiped with a beacon or app hash
+// of the wrong size is refused when the message is decoded: the commit's signature covers neither, so
+// a relaying peer could otherwise attach any bytes to a valid commit.
+func TestCommitMessageRefusesMalformedRandomness(t *testing.T) {
+ commit := &types.Commit{
+ Height: 2,
+ BlockID: types.BlockID{Hash: crypto.CRandBytes(crypto.HashSize), PartSetHeader: types.PartSetHeader{Total: 1, Hash: crypto.CRandBytes(crypto.HashSize)}, StateID: crypto.CRandBytes(crypto.HashSize)},
+ QuorumHash: crypto.RandQuorumHash(),
+ ThresholdBlockSignature: crypto.CRandBytes(types.SignatureSize),
+ }
+ decode := func(beacon, appHash []byte) error {
+ pb := commit.ToProto()
+ pb.Beacon = beacon
+ pb.AppHash = appHash
+ _, err := MsgFromProto(&tmcons.Commit{Commit: pb})
+ return err
+ }
+ require.NoError(t, decode(nil, nil))
+ require.NoError(t, decode(crypto.CRandBytes(types.SignatureSize), crypto.CRandBytes(crypto.DefaultAppHashSize)))
+ require.ErrorIs(t, decode(make([]byte, 900<<10), []byte("junk")), types.ErrInvalidCommitRandomness)
+}
diff --git a/internal/consensus/state_add_prop_block.go b/internal/consensus/state_add_prop_block.go
index 9ab668c4a0..a5596a5006 100644
--- a/internal/consensus/state_add_prop_block.go
+++ b/internal/consensus/state_add_prop_block.go
@@ -10,12 +10,9 @@ import (
"slices"
"time"
- "github.com/cosmos/gogoproto/proto"
-
cstypes "github.com/dashpay/tenderdash/internal/consensus/types"
tmstrings "github.com/dashpay/tenderdash/internal/libs/strings"
"github.com/dashpay/tenderdash/libs/log"
- tmproto "github.com/dashpay/tenderdash/proto/tendermint/types"
"github.com/dashpay/tenderdash/types"
)
@@ -170,8 +167,7 @@ func (c *AddProposalBlockPartAction) addProposalBlockPart(
return added, err
}
- var pbb = new(tmproto.Block)
- err = proto.Unmarshal(bz, pbb)
+ pbb, err := types.UnmarshalBlockProto(bz)
if err != nil {
return added, err
}
diff --git a/internal/consensus/state_try_add_commit.go b/internal/consensus/state_try_add_commit.go
index b98941c86c..8757c45f43 100644
--- a/internal/consensus/state_try_add_commit.go
+++ b/internal/consensus/state_try_add_commit.go
@@ -46,6 +46,13 @@ func (cs *TryAddCommitAction) Execute(ctx context.Context, stateEvent StateEvent
event := stateEvent.Data.(*TryAddCommitEvent)
stateData := stateEvent.StateData
commit := event.Commit
+ if stripped := commit.WithoutRandomBeacon(); stripped != commit {
+ // Before consensus version 2 a commit carries no beacon; see WithoutRandomBeacon.
+ commit = stripped
+ withoutBeacon := *event
+ withoutBeacon.Commit = commit
+ event = &withoutBeacon
+ }
peerID := event.PeerID
fromReplay := event.FromReplay
ctx = ctxWithPeerVerificationBudget(ctx, peerID, fromReplay, cs.verificationBudget)
diff --git a/internal/proxy/client.go b/internal/proxy/client.go
index d1e399ef53..f219ce1f83 100644
--- a/internal/proxy/client.go
+++ b/internal/proxy/client.go
@@ -167,6 +167,11 @@ func (app *proxyClient) FinalizeBlock(ctx context.Context, req *types.RequestFin
return app.client.FinalizeBlock(ctx, req)
}
+func (app *proxyClient) ApplyBlockRandomness(ctx context.Context, req *types.RequestApplyBlockRandomness) (r *types.ResponseApplyBlockRandomness, err error) {
+ defer addTimeSample(app.metrics.MethodTiming.With("method", "apply_block_randomness", "type", "sync"))(&err)
+ return app.client.ApplyBlockRandomness(ctx, req)
+}
+
func (app *proxyClient) Flush(ctx context.Context) (err error) {
defer addTimeSample(app.metrics.MethodTiming.With("method", "flush", "type", "sync"))(&err)
return app.client.Flush(ctx)
diff --git a/internal/proxy/client_test.go b/internal/proxy/client_test.go
index 8821ef7ea5..d14d0cd131 100644
--- a/internal/proxy/client_test.go
+++ b/internal/proxy/client_test.go
@@ -285,6 +285,36 @@ func TestFailureMetrics(t *testing.T) {
assert.Equal(t, 2, hst.count["method=check_tx,type=sync,success=true"])
}
+// TestApplyBlockRandomnessMetrics checks that the proxy client forwards ApplyBlockRandomness and records
+// its timing under the apply_block_randomness method.
+func TestApplyBlockRandomnessMetrics(t *testing.T) {
+ ctx, cancel := context.WithCancel(context.Background())
+ defer cancel()
+
+ logger := log.NewTestingLogger(t)
+ mtr := mockMetrics()
+ hst := mtr.MethodTiming.(*mockMetric)
+
+ app := mocks.NewApplication(t)
+ app.On("ApplyBlockRandomness", mock.Anything, mock.Anything).
+ Return(&types.ResponseApplyBlockRandomness{AppHash: []byte("final apphash")}, nil).Once()
+ app.On("ApplyBlockRandomness", mock.Anything, mock.Anything).
+ Return(nil, errors.New("some error")).Once()
+
+ proxy := New(abciclient.NewLocalClient(logger, app), log.NewNopLogger(), mtr)
+
+ res, err := proxy.ApplyBlockRandomness(ctx, &types.RequestApplyBlockRandomness{})
+ require.NoError(t, err)
+ assert.EqualValues(t, "final apphash", res.AppHash)
+ _, err = proxy.ApplyBlockRandomness(ctx, &types.RequestApplyBlockRandomness{})
+ assert.Error(t, err)
+
+ cancel()
+ proxy.Wait()
+ assert.Equal(t, 1, hst.count["method=apply_block_randomness,type=sync,success=true"])
+ assert.Equal(t, 1, hst.count["method=apply_block_randomness,type=sync,success=false"])
+}
+
func mockMetrics() *Metrics {
return &Metrics{
MethodTiming: &mockMetric{
diff --git a/internal/state/execution.go b/internal/state/execution.go
index 6f90f77b91..f0a568b01c 100644
--- a/internal/state/execution.go
+++ b/internal/state/execution.go
@@ -233,6 +233,11 @@ func (blockExec *BlockExecutor) CreateProposalBlock(
maxBytes := state.ConsensusParams.Block.MaxBytes
maxGas := state.ConsensusParams.Block.MaxGas
+ // The commit may come from a peer, which can set its beacon and app hash: they are empty before
+ // consensus version 2, and releases before them drop them when they decode a block, so block sync
+ // on those releases would rebuild a block that carried them into parts the next commit does not sign.
+ commit = commit.WithoutRandomBeacon()
+
evidence, evSize := blockExec.evpool.PendingEvidence(state.ConsensusParams.Evidence.MaxBytes)
// Fetch a limited amount of valid txs
@@ -769,18 +774,16 @@ func (blockExec *BlockExecutor) flushMempool(
return err
}
+// buildLastCommitInfo returns the CommitInfo of block.LastCommit for the application, without its
+// beacon and app hash: they are empty before consensus version 2, and neither the block hash nor the
+// commit's signature covers them, so the proposer could have set any.
func buildLastCommitInfo(block *types.Block, initialHeight int64) abci.CommitInfo {
if block.Height == initialHeight {
// there is no last commit for the initial height.
// return an empty value.
return abci.CommitInfo{}
}
- return abci.CommitInfo{
- Round: block.LastCommit.Round,
- QuorumHash: block.LastCommit.QuorumHash,
- BlockSignature: block.LastCommit.ThresholdBlockSignature,
- ThresholdVoteExtensions: block.LastCommit.ThresholdVoteExtensions,
- }
+ return block.LastCommit.WithoutRandomBeacon().ToCommitInfo()
}
// Update returns a copy of state with the fields set using the arguments passed in.
diff --git a/internal/state/execution_test.go b/internal/state/execution_test.go
index c277409bfd..3862356b74 100644
--- a/internal/state/execution_test.go
+++ b/internal/state/execution_test.go
@@ -898,6 +898,100 @@ func TestEmptyPrepareProposal(t *testing.T) {
require.NoError(t, err)
}
+// TestProposalDropsRelayedCommitRandomness is the regression test for a peer relaying a validly
+// signed commit with a correctly sized beacon and app hash added, and for a proposer putting them in
+// its block's LastCommit: neither is covered by the commit's hash or threshold signature, and both are
+// empty before consensus version 2.
+//
+// The proposer drops them from the commit it builds on. Releases before the beacon drop both fields
+// when they decode a block, and block sync rebuilds the parts of the block from what it decoded, so a
+// proposal that kept them could not be block synced by those releases. PrepareProposal and
+// ProcessProposal pass the other fields of the last commit to the application, without them.
+func TestProposalDropsRelayedCommitRandomness(t *testing.T) {
+ const height = 2
+ ctx, cancel := context.WithCancel(context.Background())
+ defer cancel()
+
+ logger := log.NewNopLogger()
+
+ eventBus := eventbus.NewDefault(logger)
+ require.NoError(t, eventBus.Start(ctx))
+ state, stateDB, privVals := makeState(t, 1, height)
+
+ var prepareReq *abci.RequestPrepareProposal
+ var processReq *abci.RequestProcessProposal
+ app := abcimocks.NewApplication(t)
+ app.On("PrepareProposal", mock.Anything, mock.Anything).Run(func(args mock.Arguments) {
+ prepareReq = args.Get(1).(*abci.RequestPrepareProposal)
+ }).Return(&abci.ResponsePrepareProposal{
+ AppHash: make([]byte, crypto.DefaultAppHashSize), AppVersion: 1,
+ }, nil)
+ app.On("ProcessProposal", mock.Anything, mock.Anything).Run(func(args mock.Arguments) {
+ processReq = args.Get(1).(*abci.RequestProcessProposal)
+ }).Return(&abci.ResponseProcessProposal{
+ AppHash: make([]byte, crypto.DefaultAppHashSize),
+ Status: abci.ResponseProcessProposal_ACCEPT,
+ }, nil)
+ cc := abciclient.NewLocalClient(logger, app)
+ proxyApp := proxy.New(cc, logger, proxy.NopMetrics())
+ require.NoError(t, proxyApp.Start(ctx))
+
+ mp := &mpmocks.Mempool{}
+ mp.On("ReapMaxBytesMaxGas", mock.Anything, mock.Anything).Return(types.Txs{})
+
+ blockExec := sm.NewBlockExecutor(sm.NewStore(stateDB), proxyApp, mp, sm.EmptyEvidencePool{}, nil, eventBus)
+ proposer := state.Validators.GetByIndex(0)
+ commit, _ := makeValidCommit(ctx, t, height, factory.MakeBlockID(), state.Validators, privVals)
+ beacon := crypto.CRandBytes(bls12381.SignatureSize)
+ appHash := crypto.CRandBytes(crypto.DefaultAppHashSize)
+ commit.Beacon, commit.AppHash = beacon, appHash
+ relayed, err := types.CommitFromProto(commit.ToProto())
+ require.NoError(t, err)
+ require.Equal(t, commit.Hash(), relayed.Hash(), "the beacon and app hash are not part of the commit hash")
+ expected := relayed.WithoutRandomBeacon().ToCommitInfo()
+
+ block, _, err := blockExec.CreateProposalBlock(ctx, height, 0, state, relayed, proposer.ProTxHash, 0)
+ require.NoError(t, err)
+ assert.Empty(t, block.LastCommit.Beacon)
+ assert.Empty(t, block.LastCommit.AppHash)
+ require.NotNil(t, prepareReq)
+ assert.Equal(t, expected, prepareReq.LocalLastCommit)
+ assert.Equal(t, beacon, relayed.Beacon, "the relayed commit is not changed")
+ assert.EqualValues(t, appHash, relayed.AppHash, "the relayed commit is not changed")
+
+ // A block whose LastCommit keeps them, as a byzantine proposer can build.
+ pb, err := block.ToProto()
+ require.NoError(t, err)
+ pb.LastCommit = relayed.ToProto()
+ byzantine, err := types.BlockFromProto(pb)
+ require.NoError(t, err)
+ require.Equal(t, beacon, byzantine.LastCommit.Beacon)
+
+ // A release before the beacon decodes a block without fields 7 and 8 of its LastCommit, and block
+ // sync checks the parts it rebuilds from that block against the next commit's BlockID: they match
+ // for the proposal, and not for a block that kept the relayed fields.
+ partSetHeader := func(b *types.Block, legacy bool) types.PartSetHeader {
+ t.Helper()
+ pb, err := b.ToProto()
+ require.NoError(t, err)
+ if legacy {
+ pb.LastCommit.Beacon, pb.LastCommit.AppHash = nil, nil
+ }
+ decoded, err := types.BlockFromProto(pb)
+ require.NoError(t, err)
+ parts, err := decoded.MakePartSet(types.BlockPartSizeBytes)
+ require.NoError(t, err)
+ return parts.Header()
+ }
+ assert.Equal(t, partSetHeader(block, false), partSetHeader(block, true))
+ assert.NotEqual(t, partSetHeader(byzantine, false), partSetHeader(byzantine, true))
+
+ _, err = blockExec.ProcessProposal(ctx, byzantine, 0, state, false, types.VerifiedCommit{})
+ require.NoError(t, err)
+ require.NotNil(t, processReq)
+ assert.Equal(t, expected, processReq.ProposedLastCommit)
+}
+
// TestPrepareProposalErrorOnNonExistingRemoved tests that the block creation logic returns
// an error if the ResponsePrepareProposal returned from the application marks
//
diff --git a/internal/statesync/reactor.go b/internal/statesync/reactor.go
index bbb8154d91..5953108e2e 100644
--- a/internal/statesync/reactor.go
+++ b/internal/statesync/reactor.go
@@ -399,6 +399,8 @@ func (r *Reactor) Sync(ctx context.Context) (sm.State, error) {
if err != nil {
return sm.State{}, fmt.Errorf("sync any: %w", err)
}
+ // Before consensus version 2 a commit carries no beacon; see WithoutRandomBeacon.
+ commit = commit.WithoutRandomBeacon()
err = r.publishCommitEvent(commit)
if err != nil {
@@ -915,8 +917,11 @@ func (r *Reactor) backfill(
return fmt.Errorf("authenticating backfill validator set at height %d: %w", resp.block.Height, err)
}
- // save the signed headers
- if err := r.blockStore.SaveSignedHeader(resp.block.SignedHeader, trustedBlockID); err != nil {
+ // save the signed headers; before consensus version 2 a commit carries no beacon, see
+ // WithoutRandomBeacon
+ signedHeader := *resp.block.SignedHeader
+ signedHeader.Commit = signedHeader.Commit.WithoutRandomBeacon()
+ if err := r.blockStore.SaveSignedHeader(&signedHeader, trustedBlockID); err != nil {
return err
}
diff --git a/internal/store/store.go b/internal/store/store.go
index ef88c6ce8c..7eb8cad09c 100644
--- a/internal/store/store.go
+++ b/internal/store/store.go
@@ -183,7 +183,6 @@ func (bs *BlockStore) LoadBlock(height int64) *types.Block {
return nil
}
- pbb := new(tmproto.Block)
buf := []byte{}
for i := 0; i < int(blockMeta.BlockID.PartSetHeader.Total); i++ {
part := bs.LoadBlockPart(height, i)
@@ -194,7 +193,7 @@ func (bs *BlockStore) LoadBlock(height int64) *types.Block {
}
buf = append(buf, part.Bytes...)
}
- err := proto.Unmarshal(buf, pbb)
+ pbb, err := types.UnmarshalBlockProto(buf)
if err != nil {
// NOTE: The existence of meta should imply the existence of the
// block. So, make sure meta is only saved after blocks are saved.
@@ -603,7 +602,9 @@ func (bs *BlockStore) saveBlockToBatch(batch dbm.Batch, block *types.Block, bloc
return err
}
- pbc := block.LastCommit.ToProto()
+ // Nothing signs the beacon and app hash of block.LastCommit, so a proposer can fill them. The block's
+ // parts keep them, as the encoding the next commit signs, but they are not the previous height's commit.
+ pbc := block.LastCommit.WithoutRandomBeacon().ToProto()
blockCommitBytes := mustEncode(pbc)
if err := batch.Set(blockCommitKey(height-1), blockCommitBytes); err != nil {
return err
diff --git a/internal/store/store_test.go b/internal/store/store_test.go
index 447ba59cfe..d61dcd2329 100644
--- a/internal/store/store_test.go
+++ b/internal/store/store_test.go
@@ -1,6 +1,7 @@
package store
import (
+ "bytes"
"context"
"fmt"
"os"
@@ -597,3 +598,61 @@ func newBlock(hdr types.Header, lastCommit *types.Commit) *types.Block {
LastCommit: lastCommit,
}
}
+
+// TestLoadBlockMistypedLastCommitRandomness is the regression test for a block an older release
+// stored while its LastCommit carried the beacon field with the varint wire type: that release skips
+// the field, so it commits and stores such a block from a byzantine proposer, and an upgraded node
+// panicked when loading it. It now loads the block without the field.
+func TestLoadBlockMistypedLastCommitRandomness(t *testing.T) {
+ state, bs := makeStateAndBlockStore(t, t.TempDir())
+ block, err := factory.MakeBlock(state, 1, new(types.Commit), 0)
+ require.NoError(t, err)
+ pb, err := block.ToProto()
+ require.NoError(t, err)
+ bz, err := pb.Marshal()
+ require.NoError(t, err)
+ // another occurrence of last_commit (field 4) holding field 7 with wire type 0
+ raw := append(append([]byte{}, bz...), 0x22, 0x02, 0x38, 0x01)
+ parts := types.NewPartSetFromData(raw, types.BlockPartSizeBytes)
+ bs.SaveBlock(block, parts, makeTestCommit(t, state, block.Height))
+
+ var loaded *types.Block
+ require.NotPanics(t, func() { loaded = bs.LoadBlock(1) })
+ require.NotNil(t, loaded)
+ require.Equal(t, block.Hash(), loaded.Hash())
+}
+
+// TestSaveBlockDropsLastCommitRandomness is the regression test for a proposer that fills the beacon
+// and app hash of its block's LastCommit, which nothing signs: they were stored as the canonical
+// commit of the previous height, and served from there. The block's parts keep them, as the encoding
+// the next commit signs.
+func TestSaveBlockDropsLastCommitRandomness(t *testing.T) {
+ state, bs := makeStateAndBlockStore(t, t.TempDir())
+ const height = int64(2)
+ state.LastBlockHeight = height - 1
+
+ lastCommit := makeTestCommit(t, state, height-1)
+ lastCommit.Beacon = bytes.Repeat([]byte{0x01}, types.SignatureSize)
+ lastCommit.AppHash = bytes.Repeat([]byte{0x02}, crypto.DefaultAppHashSize)
+ block, err := factory.MakeBlock(state, height, lastCommit, 0)
+ require.NoError(t, err)
+ parts, err := block.MakePartSet(types.BlockPartSizeBytes)
+ require.NoError(t, err)
+
+ bs.SaveBlock(block, parts, makeTestCommit(t, state, height))
+
+ canonical := bs.LoadBlockCommit(height - 1)
+ require.NotNil(t, canonical)
+ require.Empty(t, canonical.Beacon)
+ require.Empty(t, canonical.AppHash)
+ require.Equal(t, lastCommit.Hash(), canonical.Hash())
+
+ for i := 0; i < int(parts.Total()); i++ {
+ require.Equal(t, parts.GetPart(i).Bytes, bs.LoadBlockPart(height, i).Bytes)
+ }
+ loaded := bs.LoadBlock(height)
+ require.NotNil(t, loaded)
+ require.Equal(t, lastCommit.Beacon, loaded.LastCommit.Beacon)
+ require.Equal(t, lastCommit.AppHash, loaded.LastCommit.AppHash)
+ require.NotEmpty(t, block.LastCommit.Beacon, "saving must not change the block")
+}
diff --git a/node/node_test.go b/node/node_test.go
index eac1c86152..3712220a7c 100644
--- a/node/node_test.go
+++ b/node/node_test.go
@@ -853,6 +853,8 @@ func TestMaxProposalBlockSize(t *testing.T) {
BlockID: blockID,
QuorumHash: crypto.RandQuorumHash(),
ThresholdBlockSignature: crypto.CRandBytes(bls12381.SignatureSize),
+ Beacon: crypto.CRandBytes(bls12381.SignatureSize),
+ AppHash: crypto.Checksum([]byte("final_app_hash")),
}
block, _, err := blockExec.CreateProposalBlock(
@@ -874,7 +876,8 @@ func TestMaxProposalBlockSize(t *testing.T) {
pb, err := block.ToProto()
require.NoError(t, err)
- // require that the header and commit be the max possible size
+ // require that the header and commit be the max possible size; the proposal drops the beacon and
+ // app hash of the commit before consensus version 2
require.Equal(t, types.MaxHeaderBytes, int64(pb.Header.Size()))
require.Equal(t, types.MaxCommitOverheadBytes, int64(pb.LastCommit.Size()))
// make sure that the block is less than the max possible size
diff --git a/proto/tendermint/abci/types.proto b/proto/tendermint/abci/types.proto
index 27931d24fe..0c10e0e6ee 100644
--- a/proto/tendermint/abci/types.proto
+++ b/proto/tendermint/abci/types.proto
@@ -22,21 +22,22 @@ import "gogoproto/gogo.proto";
// Request types
message Request {
oneof value {
- RequestEcho echo = 1;
- RequestFlush flush = 2;
- RequestInfo info = 3;
- RequestInitChain init_chain = 4;
- RequestQuery query = 5;
- RequestCheckTx check_tx = 7;
- RequestListSnapshots list_snapshots = 11;
- RequestOfferSnapshot offer_snapshot = 12;
- RequestLoadSnapshotChunk load_snapshot_chunk = 13;
- RequestApplySnapshotChunk apply_snapshot_chunk = 14;
- RequestPrepareProposal prepare_proposal = 15;
- RequestProcessProposal process_proposal = 16;
- RequestExtendVote extend_vote = 17;
- RequestVerifyVoteExtension verify_vote_extension = 18;
- RequestFinalizeBlock finalize_block = 19;
+ RequestEcho echo = 1;
+ RequestFlush flush = 2;
+ RequestInfo info = 3;
+ RequestInitChain init_chain = 4;
+ RequestQuery query = 5;
+ RequestCheckTx check_tx = 7;
+ RequestListSnapshots list_snapshots = 11;
+ RequestOfferSnapshot offer_snapshot = 12;
+ RequestLoadSnapshotChunk load_snapshot_chunk = 13;
+ RequestApplySnapshotChunk apply_snapshot_chunk = 14;
+ RequestPrepareProposal prepare_proposal = 15;
+ RequestProcessProposal process_proposal = 16;
+ RequestExtendVote extend_vote = 17;
+ RequestVerifyVoteExtension verify_vote_extension = 18;
+ RequestFinalizeBlock finalize_block = 19;
+ RequestApplyBlockRandomness apply_block_randomness = 20;
}
reserved 6, 8, 9, 10; // RequestBeginBlock, RequestDeliverTx, RequestEndBlock, RequestCommit
}
@@ -272,6 +273,8 @@ message RequestProcessProposal {
// a commit vector, to learn the expected vector without signing or broadcasting.
// The call must be free of side effects. Threshold-recoverable extensions must be
// deterministic and match the vector accepted at commit-level VerifyVoteExtension.
+// From consensus version 2, ApplyBlockRandomness runs first, but the extensions
+// must not depend on the beacon or on the state it produced.
// See the [ExtendVote contract](methods.md#extendvote).
message RequestExtendVote {
bytes hash = 1; // The header hash of the proposed block that the vote extensions is to refer to.
@@ -365,6 +368,8 @@ message RequestVerifyVoteExtension {
// and events are provided through proposal processing, not ResponseFinalizeBlock.
// The response contains retention and next-block scheduling hints only.
// Use retain_height with care: pruning blocks can prevent replay and bootstrapping.
+// From consensus version 2, the state to persist is that candidate with commit.beacon
+// applied, as ApplyBlockRandomness applies it, and its root must equal commit.app_hash.
// See the [FinalizeBlock contract](methods.md#finalizeblock) and
// [commit and apply](../consensus/consensus-happy-path.md#9-commit-and-apply).
message RequestFinalizeBlock {
@@ -384,27 +389,71 @@ message RequestFinalizeBlock {
tendermint.types.BlockID block_id = 7 [(gogoproto.customname) = "BlockID"];
}
+// Applies the block's randomness and returns the app hash the Precommit signs.
+//
+// #### Usage
+//
+// - Used from consensus version 2 (`VersionParams.consensus_version`). Before that, Tenderdash never calls it.
+// This release never calls it, at any consensus version.
+// - `RequestApplyBlockRandomness.beacon` is the random beacon of the block and round: the 96-byte BLS threshold
+// signature recovered from the Prevotes of round `round` for the block `hash`. Tenderdash has verified it against
+// the quorum's threshold public key before the call.
+// - The Application applies the randomness to the state that `ProcessProposal` (or `PrepareProposal`) left for
+// that block and round, and returns the resulting Merkle root hash in `ResponseApplyBlockRandomness.app_hash`.
+// When nothing in the block uses randomness, `app_hash` equals the app hash of the block header.
+// - The header keeps the app hash from `ProcessProposal`, which Prevotes sign. Precommits and the commit sign
+// `ResponseApplyBlockRandomness.app_hash`, and the commit carries it in `Commit.app_hash`.
+// - The randomness may change only the application state behind `app_hash`. Transaction results, events,
+// validator set updates, consensus parameter updates and the other outputs of `ProcessProposal` are fixed
+// by the header the Prevotes signed: they MUST NOT depend on the beacon, and Tenderdash keeps the ones
+// `ProcessProposal` returned.
+// - Vote extensions and their verification MUST NOT depend on the beacon or on the state this call produces;
+// see `ExtendVote`.
+// - The implementation MUST be deterministic: every process that applies the same beacon to the same block
+// and round MUST return the same `app_hash`.
+// - Tenderdash may call it more than once for the same block, round and beacon; the Application MUST return
+// the same `app_hash` each time.
+// - It MUST NOT modify the committed state: Tenderdash may call it for a round that never commits, and
+// `FinalizeBlock` commits the state for the commit round.
+// - An ABCI error is fatal, as for `ExtendVote`.
+//
+// #### When does Tenderdash call it?
+//
+// - On a validator, once the Prevotes of round _r_ for block _v_ reach the threshold and their signature is
+// recovered, before `ExtendVote` and before signing its Precommit for _v_.
+// - On every path that finalizes a block from a commit (consensus, block sync, replay, a node that did not
+// vote): after `ProcessProposal` of the committed block for the commit round, with the commit's beacon, and
+// before `FinalizeBlock`. Tenderdash compares the returned `app_hash` with `Commit.app_hash` and stops on a
+// mismatch.
+message RequestApplyBlockRandomness {
+ bytes hash = 1; // The header hash of the block the Prevotes are for.
+ int64 height = 2; // Height of the block.
+ int32 round = 3; // Round whose Prevotes produced the beacon.
+ bytes beacon = 4; // 96-byte BLS threshold signature recovered from those Prevotes.
+}
+
//----------------------------------------
// Response types
message Response {
oneof value {
- ResponseException exception = 1;
- ResponseEcho echo = 2;
- ResponseFlush flush = 3;
- ResponseInfo info = 4;
- ResponseInitChain init_chain = 5;
- ResponseQuery query = 6;
- ResponseCheckTx check_tx = 7;
- ResponseListSnapshots list_snapshots = 8;
- ResponseOfferSnapshot offer_snapshot = 9;
- ResponseLoadSnapshotChunk load_snapshot_chunk = 10;
- ResponseApplySnapshotChunk apply_snapshot_chunk = 11;
- ResponsePrepareProposal prepare_proposal = 12;
- ResponseProcessProposal process_proposal = 13;
- ResponseExtendVote extend_vote = 14;
- ResponseVerifyVoteExtension verify_vote_extension = 15;
- ResponseFinalizeBlock finalize_block = 16;
+ ResponseException exception = 1;
+ ResponseEcho echo = 2;
+ ResponseFlush flush = 3;
+ ResponseInfo info = 4;
+ ResponseInitChain init_chain = 5;
+ ResponseQuery query = 6;
+ ResponseCheckTx check_tx = 7;
+ ResponseListSnapshots list_snapshots = 8;
+ ResponseOfferSnapshot offer_snapshot = 9;
+ ResponseLoadSnapshotChunk load_snapshot_chunk = 10;
+ ResponseApplySnapshotChunk apply_snapshot_chunk = 11;
+ ResponsePrepareProposal prepare_proposal = 12;
+ ResponseProcessProposal process_proposal = 13;
+ ResponseExtendVote extend_vote = 14;
+ ResponseVerifyVoteExtension verify_vote_extension = 15;
+ ResponseFinalizeBlock finalize_block = 16;
+ ResponseApplyBlockRandomness apply_block_randomness = 17;
}
}
@@ -608,6 +657,13 @@ message ResponseFinalizeBlock {
bool propose_next_block_immediately = 3;
}
+message ResponseApplyBlockRandomness {
+ // The Merkle root hash of the application state after the randomness is applied. 32 bytes.
+ // Equals the header app hash when nothing in the block uses randomness. The randomness changes
+ // nothing but this state: the other results of the block are the ones ProcessProposal returned.
+ bytes app_hash = 1;
+}
+
//----------------------------------------
// Misc.
@@ -616,6 +672,13 @@ message CommitInfo {
bytes quorum_hash = 2;
bytes block_signature = 3;
repeated tendermint.types.VoteExtension threshold_vote_extensions = 4;
+ // Random beacon of the committed block: the threshold signature recovered from the prevotes of
+ // the commit round. Set from consensus version 2; empty before.
+ bytes beacon = 5;
+ // App hash after `ApplyBlockRandomness` for the committed block and round. The commit signs it
+ // through the state ID of its block ID, which Tenderdash checks before passing it on.
+ // Set from consensus version 2; empty before.
+ bytes app_hash = 6;
}
// Event carries application attributes in ResponseProcessProposal
@@ -787,4 +850,5 @@ service ABCIApplication {
rpc ExtendVote(RequestExtendVote) returns (ResponseExtendVote);
rpc VerifyVoteExtension(RequestVerifyVoteExtension) returns (ResponseVerifyVoteExtension);
rpc FinalizeBlock(RequestFinalizeBlock) returns (ResponseFinalizeBlock);
+ rpc ApplyBlockRandomness(RequestApplyBlockRandomness) returns (ResponseApplyBlockRandomness);
}
diff --git a/proto/tendermint/types/types.pb.go b/proto/tendermint/types/types.pb.go
index f10db1166c..649c8cd24e 100644
--- a/proto/tendermint/types/types.pb.go
+++ b/proto/tendermint/types/types.pb.go
@@ -699,6 +699,16 @@ type Commit struct {
QuorumHash []byte `protobuf:"bytes,4,opt,name=quorum_hash,json=quorumHash,proto3" json:"quorum_hash,omitempty"`
ThresholdBlockSignature []byte `protobuf:"bytes,5,opt,name=threshold_block_signature,json=thresholdBlockSignature,proto3" json:"threshold_block_signature,omitempty"`
ThresholdVoteExtensions []*VoteExtension `protobuf:"bytes,6,rep,name=threshold_vote_extensions,json=thresholdVoteExtensions,proto3" json:"threshold_vote_extensions,omitempty"`
+ // Random beacon: the threshold signature recovered from the prevotes of the commit round, which
+ // verifies against their sign item and the quorum's threshold public key.
+ // Set from consensus version 2; empty before. The commit's signature covers neither this field
+ // nor app_hash as bytes: a commit is refused unless both are empty or they are exactly 96 and 32
+ // bytes, and a block's last commit is read without them when they are not.
+ Beacon []byte `protobuf:"bytes,7,opt,name=beacon,proto3" json:"beacon,omitempty"`
+ // App hash returned by ApplyBlockRandomness for this block and round. The precommits sign it only
+ // through block_id.state_id, the hash of the block header's state ID with its app hash replaced by
+ // this one: trust this field only once that hash matches. Set from consensus version 2; empty before.
+ AppHash []byte `protobuf:"bytes,8,opt,name=app_hash,json=appHash,proto3" json:"app_hash,omitempty"`
}
func (m *Commit) Reset() { *m = Commit{} }
@@ -776,6 +786,20 @@ func (m *Commit) GetThresholdVoteExtensions() []*VoteExtension {
return nil
}
+func (m *Commit) GetBeacon() []byte {
+ if m != nil {
+ return m.Beacon
+ }
+ return nil
+}
+
+func (m *Commit) GetAppHash() []byte {
+ if m != nil {
+ return m.AppHash
+ }
+ return nil
+}
+
type Proposal struct {
Type SignedMsgType `protobuf:"varint,1,opt,name=type,proto3,enum=tendermint.types.SignedMsgType" json:"type,omitempty"`
Height int64 `protobuf:"varint,2,opt,name=height,proto3" json:"height,omitempty"`
@@ -1400,116 +1424,117 @@ func init() {
func init() { proto.RegisterFile("tendermint/types/types.proto", fileDescriptor_d3a6e55e2345de56) }
var fileDescriptor_d3a6e55e2345de56 = []byte{
- // 1742 bytes of a gzipped FileDescriptorProto
- 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xbc, 0x58, 0xcd, 0x6f, 0xdb, 0xd8,
- 0x11, 0x37, 0x2d, 0xea, 0xc3, 0xa3, 0x0f, 0xcb, 0x8c, 0x9d, 0xc8, 0xca, 0x46, 0x62, 0x55, 0xb4,
- 0x75, 0x17, 0xad, 0x94, 0x64, 0x17, 0xfd, 0x58, 0xa0, 0x07, 0x49, 0xd6, 0xc6, 0x42, 0x6c, 0x59,
- 0xa0, 0x14, 0x17, 0x6d, 0x0f, 0x04, 0x25, 0xbe, 0x48, 0x6c, 0x24, 0x92, 0x4b, 0x3e, 0xb9, 0xf2,
- 0x9e, 0x7a, 0xeb, 0xc2, 0xa7, 0x3d, 0x14, 0xc5, 0x5e, 0x0c, 0x74, 0xd1, 0x1e, 0xfa, 0x1f, 0xec,
- 0xbd, 0xa7, 0xbd, 0x14, 0xd8, 0x5b, 0x7b, 0x28, 0xd2, 0xc2, 0xf9, 0x07, 0x7a, 0xe8, 0xb9, 0x2d,
- 0xde, 0x3c, 0x92, 0x22, 0x25, 0x39, 0x8d, 0x83, 0xa2, 0x17, 0x81, 0x6f, 0xe6, 0x37, 0xef, 0xcd,
- 0xfc, 0xde, 0xcc, 0x70, 0x28, 0x78, 0x87, 0x12, 0x53, 0x27, 0xce, 0xd4, 0x30, 0x69, 0x8d, 0x5e,
- 0xd8, 0xc4, 0xe5, 0xbf, 0x55, 0xdb, 0xb1, 0xa8, 0x25, 0xe5, 0x17, 0xda, 0x2a, 0xca, 0x8b, 0xbb,
- 0x23, 0x6b, 0x64, 0xa1, 0xb2, 0xc6, 0x9e, 0x38, 0xae, 0x58, 0x1e, 0x59, 0xd6, 0x68, 0x42, 0x6a,
- 0xb8, 0x1a, 0xcc, 0x9e, 0xd7, 0xa8, 0x31, 0x25, 0x2e, 0xd5, 0xa6, 0xb6, 0x07, 0x78, 0x10, 0x3a,
- 0x66, 0xe8, 0x5c, 0xd8, 0xd4, 0x62, 0x58, 0xeb, 0xb9, 0xa7, 0x2e, 0x85, 0xd4, 0xe7, 0xc4, 0x71,
- 0x0d, 0xcb, 0x0c, 0xfb, 0x51, 0xbc, 0xbf, 0xe2, 0xa5, 0xae, 0xb9, 0x63, 0x4f, 0x29, 0xaf, 0x28,
- 0xcf, 0xb5, 0x89, 0xa1, 0x6b, 0xd4, 0x72, 0x38, 0xa2, 0xf2, 0x43, 0xc8, 0x76, 0x35, 0x87, 0xf6,
- 0x08, 0x3d, 0x22, 0x9a, 0x4e, 0x1c, 0x69, 0x17, 0xe2, 0xd4, 0xa2, 0xda, 0xa4, 0x20, 0xc8, 0xc2,
- 0x41, 0x56, 0xe1, 0x0b, 0x49, 0x02, 0x71, 0xac, 0xb9, 0xe3, 0xc2, 0xa6, 0x2c, 0x1c, 0x64, 0x14,
- 0x7c, 0xae, 0x8c, 0x41, 0x64, 0xa6, 0xcc, 0xc2, 0x30, 0x75, 0x32, 0xf7, 0x2d, 0x70, 0xc1, 0xa4,
- 0x83, 0x0b, 0x4a, 0x5c, 0xcf, 0x84, 0x2f, 0xa4, 0xf7, 0x21, 0x8e, 0xc1, 0x15, 0x62, 0xb2, 0x70,
- 0x90, 0x7e, 0x5c, 0xa8, 0x86, 0x58, 0xe4, 0xc1, 0x57, 0xbb, 0x4c, 0xdf, 0x10, 0xbf, 0x7c, 0x59,
- 0xde, 0x50, 0x38, 0xb8, 0xf2, 0x6b, 0x01, 0x92, 0x8d, 0x89, 0x35, 0x7c, 0xd1, 0x3e, 0x0c, 0x3c,
- 0x11, 0x16, 0x9e, 0x48, 0x27, 0xb0, 0x6d, 0x6b, 0x0e, 0x55, 0x5d, 0x42, 0xd5, 0x31, 0x86, 0x81,
- 0xa7, 0xa6, 0x1f, 0x97, 0xab, 0xcb, 0xb7, 0x54, 0x8d, 0x44, 0xeb, 0x1d, 0x93, 0xb5, 0x23, 0x14,
- 0x7c, 0x13, 0x52, 0x2e, 0xd5, 0x28, 0x51, 0x0d, 0x1d, 0xfd, 0xcc, 0x34, 0xd2, 0xd7, 0x2f, 0xcb,
- 0xc9, 0x1e, 0x93, 0xb5, 0x0f, 0x95, 0x24, 0x2a, 0xdb, 0x7a, 0xe5, 0x9f, 0x02, 0xf8, 0x42, 0xa9,
- 0x06, 0x69, 0xcd, 0xb6, 0x55, 0xef, 0x86, 0xd0, 0xbb, 0x44, 0x23, 0x77, 0xfd, 0xb2, 0x0c, 0x75,
- 0xdb, 0x3e, 0xe3, 0x52, 0x05, 0xb4, 0xe0, 0x59, 0xba, 0x0b, 0x89, 0x31, 0x31, 0x46, 0x63, 0x8a,
- 0xae, 0x26, 0x14, 0x6f, 0xc5, 0x0e, 0x67, 0x1b, 0x61, 0x8c, 0xa1, 0xc3, 0xeb, 0xb6, 0x7d, 0xa4,
- 0xb9, 0x63, 0x25, 0xa9, 0xf1, 0x07, 0x49, 0x81, 0xc2, 0xd0, 0x72, 0x88, 0x3a, 0x1c, 0x6b, 0x86,
- 0xa9, 0x32, 0x72, 0x88, 0xae, 0x7a, 0x3b, 0x8a, 0xb2, 0x70, 0x90, 0x6c, 0xec, 0x5f, 0xbf, 0x2c,
- 0xef, 0x35, 0x2d, 0x87, 0x34, 0x19, 0xe4, 0x18, 0x11, 0x47, 0x08, 0x50, 0xf6, 0x86, 0xeb, 0xc4,
- 0x8c, 0x5b, 0x96, 0x9d, 0x85, 0x38, 0x7a, 0x84, 0xcf, 0x1f, 0xe4, 0x3f, 0xfb, 0x6d, 0x79, 0xe3,
- 0x93, 0xcf, 0xcb, 0xc2, 0x67, 0x9f, 0x97, 0x85, 0x5f, 0xfe, 0x55, 0xde, 0xa8, 0xfc, 0x2b, 0x0e,
- 0x09, 0x8f, 0xa9, 0x1f, 0x41, 0x32, 0x1c, 0x71, 0xfa, 0xf1, 0x83, 0x30, 0xe1, 0x9e, 0xaa, 0xda,
- 0xb4, 0x4c, 0x97, 0x98, 0xee, 0xcc, 0xf5, 0xe8, 0xf6, 0x6d, 0x58, 0xac, 0xdc, 0x7d, 0x43, 0x47,
- 0x16, 0xb6, 0x78, 0xac, 0xe8, 0x18, 0x23, 0x1a, 0x95, 0x6d, 0x3d, 0xc4, 0x15, 0x63, 0x24, 0x16,
- 0x70, 0xf5, 0x03, 0xcf, 0x5f, 0x11, 0xcf, 0x2e, 0x56, 0x79, 0xa9, 0x55, 0xfd, 0x52, 0xab, 0xf6,
- 0xfd, 0x52, 0x6b, 0xa4, 0xd8, 0xc1, 0x9f, 0xfe, 0xad, 0x2c, 0xf0, 0xa8, 0xa4, 0x26, 0x64, 0x27,
- 0x9a, 0x4b, 0xd5, 0x01, 0x23, 0x8e, 0x1d, 0x1f, 0xc7, 0x2d, 0xf6, 0x57, 0xf3, 0xc5, 0xcb, 0x3b,
- 0xcf, 0xf5, 0x34, 0xb3, 0xe2, 0x22, 0x5d, 0x3a, 0x80, 0x3c, 0x6e, 0x32, 0xb4, 0xa6, 0x53, 0x83,
- 0xf2, 0x2b, 0x4b, 0x60, 0x5a, 0xe6, 0x98, 0xbc, 0x89, 0x62, 0xbc, 0xac, 0xfb, 0xb0, 0xa5, 0x6b,
- 0x54, 0xe3, 0x90, 0x24, 0x42, 0x52, 0x4c, 0x80, 0xca, 0x6f, 0xc1, 0x76, 0x50, 0x95, 0x2e, 0x87,
- 0xa4, 0xf8, 0x2e, 0x0b, 0x31, 0x02, 0x1f, 0xc2, 0xae, 0x49, 0xe6, 0x54, 0x5d, 0x46, 0x6f, 0x21,
- 0x5a, 0x62, 0xba, 0xb3, 0xa8, 0xc5, 0x37, 0x20, 0x37, 0xf4, 0xc9, 0xe7, 0x58, 0x40, 0x6c, 0x36,
- 0x90, 0x22, 0xac, 0x0a, 0x77, 0x70, 0xe3, 0x25, 0x6c, 0x1a, 0xb1, 0x3b, 0x4c, 0xd5, 0x8c, 0xe0,
- 0xf7, 0x43, 0x39, 0x9a, 0x41, 0x50, 0x90, 0x96, 0x5f, 0x83, 0x8c, 0x43, 0xdc, 0xd9, 0x84, 0x7a,
- 0x7b, 0x64, 0x51, 0x9d, 0xf6, 0x64, 0x08, 0xf9, 0x3a, 0x64, 0xc9, 0xb9, 0xa1, 0x13, 0x73, 0x48,
- 0x38, 0x26, 0x87, 0x98, 0x8c, 0x2f, 0xf4, 0x63, 0xb5, 0x1d, 0xcb, 0xb6, 0x5c, 0xa2, 0xab, 0xe1,
- 0xc2, 0xda, 0x96, 0x85, 0x03, 0x51, 0x91, 0x7c, 0xdd, 0xa2, 0xb8, 0xa4, 0x5a, 0x60, 0xe1, 0xa8,
- 0xb6, 0x63, 0xa9, 0x74, 0xce, 0x77, 0xcf, 0xf3, 0x28, 0x7c, 0x5d, 0xd7, 0xb1, 0xfa, 0x73, 0x3c,
- 0xe2, 0xfb, 0xaf, 0xa9, 0xa0, 0x1d, 0x6c, 0x65, 0xeb, 0xcb, 0xa4, 0x52, 0x00, 0xf1, 0x50, 0xa3,
- 0x9a, 0x94, 0x87, 0x18, 0x9d, 0xbb, 0x05, 0x41, 0x8e, 0x1d, 0x64, 0x14, 0xf6, 0x58, 0xf9, 0xf7,
- 0x26, 0x88, 0x67, 0x16, 0x25, 0xd2, 0x7b, 0x20, 0xb2, 0xf4, 0xc1, 0xaa, 0xc8, 0xad, 0x6b, 0x43,
- 0x3d, 0x63, 0x64, 0x12, 0xfd, 0xc4, 0x1d, 0xf5, 0x2f, 0x6c, 0xa2, 0x20, 0x78, 0xa9, 0x25, 0x2c,
- 0xd2, 0x7c, 0x17, 0xe2, 0x8e, 0x35, 0x33, 0x79, 0x33, 0x8a, 0x2b, 0x7c, 0x21, 0xb5, 0x20, 0x15,
- 0x64, 0xaf, 0xf8, 0xdf, 0xb2, 0x77, 0x9b, 0x65, 0x2f, 0xab, 0x2d, 0x4f, 0xa0, 0x24, 0x07, 0x5e,
- 0x12, 0x3f, 0x82, 0xbd, 0x20, 0x9f, 0x22, 0xbc, 0xc5, 0x79, 0x56, 0x05, 0xca, 0x05, 0x71, 0xe1,
- 0x84, 0x55, 0x79, 0xeb, 0x4f, 0xa0, 0x67, 0x8b, 0x84, 0x6d, 0x33, 0x29, 0x03, 0x72, 0x17, 0x5d,
- 0x63, 0x64, 0x6a, 0x74, 0xe6, 0x10, 0x2f, 0xf9, 0x73, 0x28, 0xee, 0xf9, 0x52, 0xe9, 0x08, 0xb6,
- 0xcf, 0x2d, 0x4a, 0x54, 0x32, 0xa7, 0xc4, 0x64, 0xb7, 0xe9, 0x16, 0x52, 0x72, 0x6c, 0x7d, 0x03,
- 0x67, 0xfc, 0xb6, 0x7c, 0x9c, 0x92, 0x3b, 0x0f, 0x2f, 0xdd, 0xca, 0x17, 0x9b, 0x90, 0xe0, 0x85,
- 0x17, 0xa2, 0x53, 0x58, 0x4f, 0xe7, 0xe6, 0x4d, 0x74, 0xc6, 0xde, 0x9e, 0xce, 0x32, 0xa4, 0x3f,
- 0x9a, 0x59, 0xce, 0x6c, 0xca, 0x49, 0x14, 0x31, 0x5c, 0xe0, 0x22, 0x24, 0xef, 0x03, 0xd8, 0xa7,
- 0x63, 0x87, 0xb8, 0x63, 0x6b, 0xa2, 0xab, 0xcb, 0xec, 0x70, 0xce, 0xef, 0x05, 0x80, 0x46, 0x94,
- 0xa6, 0x9f, 0x85, 0x6d, 0x97, 0x09, 0x4b, 0xbc, 0x19, 0x61, 0x8b, 0xcd, 0xcf, 0xa2, 0xcc, 0xfd,
- 0x31, 0x06, 0xa9, 0x2e, 0x16, 0x89, 0x36, 0xf9, 0x7f, 0xe4, 0xef, 0x7d, 0xd8, 0xb2, 0xad, 0x89,
- 0xca, 0x35, 0x22, 0x6a, 0x52, 0xb6, 0x35, 0x51, 0x56, 0x6e, 0x23, 0xfe, 0xf6, 0xb7, 0xd1, 0x80,
- 0xad, 0x60, 0xdc, 0x2a, 0x24, 0x6e, 0xf1, 0x96, 0x58, 0x98, 0x49, 0xef, 0xc0, 0xd6, 0x72, 0xfa,
- 0x2e, 0x04, 0xaf, 0x6d, 0x22, 0xa9, 0xd7, 0x34, 0x11, 0xa9, 0x0f, 0x77, 0x97, 0x0c, 0xd5, 0x99,
- 0xad, 0x6b, 0x94, 0x60, 0x3b, 0x5f, 0x7b, 0x91, 0x91, 0x77, 0xb9, 0x72, 0x27, 0xb2, 0xef, 0x33,
- 0xb4, 0xad, 0xfc, 0x43, 0x80, 0x9d, 0xae, 0xd7, 0xe9, 0x8e, 0x88, 0xe6, 0xd0, 0x01, 0xd1, 0x6e,
- 0x5b, 0x09, 0x45, 0x48, 0xb9, 0xe4, 0xa3, 0x19, 0x6b, 0xc5, 0x78, 0x63, 0xa2, 0x12, 0xac, 0x6f,
- 0x6c, 0xb2, 0xe2, 0x4d, 0x4d, 0x36, 0x72, 0x03, 0xf1, 0xff, 0xc1, 0x0d, 0x24, 0x96, 0x6e, 0xa0,
- 0xf2, 0x85, 0x00, 0x59, 0x4c, 0x9a, 0xde, 0x0b, 0xc3, 0xc6, 0xe6, 0x7b, 0xbb, 0x70, 0x6f, 0x6c,
- 0x80, 0xb1, 0xdb, 0x34, 0x40, 0x71, 0x6d, 0x03, 0x8c, 0x78, 0x1e, 0x5f, 0xf6, 0xfc, 0x37, 0x02,
- 0xec, 0x06, 0x9e, 0x37, 0x89, 0x43, 0x8d, 0xe7, 0xc6, 0x50, 0xbb, 0x75, 0x00, 0x4b, 0x2d, 0x27,
- 0xb6, 0xd2, 0x72, 0x6a, 0x70, 0x67, 0xd1, 0x36, 0x16, 0xfe, 0xf0, 0x3b, 0x93, 0x02, 0x55, 0xd0,
- 0x67, 0x2a, 0x0e, 0x64, 0x78, 0x7d, 0x7b, 0x63, 0xde, 0x43, 0xe6, 0x0f, 0x7b, 0x2a, 0x08, 0xab,
- 0x63, 0x3b, 0xcf, 0x4d, 0x8e, 0x54, 0x12, 0xe3, 0xc0, 0x82, 0x4f, 0x45, 0x85, 0xcd, 0x9b, 0x2c,
- 0x78, 0x97, 0x56, 0x3c, 0x1c, 0x23, 0x03, 0x8e, 0x59, 0x94, 0x58, 0xc4, 0x6c, 0x40, 0x73, 0xd1,
- 0x05, 0x35, 0x72, 0x72, 0xe9, 0xa6, 0x4e, 0xe4, 0x9d, 0x9f, 0x71, 0xc3, 0x7e, 0x37, 0x21, 0xbb,
- 0xb8, 0x27, 0x97, 0xf8, 0xce, 0xac, 0xd9, 0x24, 0x98, 0x9b, 0x7a, 0x84, 0x2a, 0x99, 0xf3, 0xd0,
- 0xaa, 0xf2, 0xab, 0x4d, 0xd8, 0x42, 0x9f, 0x4e, 0x08, 0xd5, 0x22, 0x8d, 0x49, 0x78, 0xfb, 0xc6,
- 0xf4, 0x00, 0xc0, 0xef, 0xfd, 0x1f, 0x13, 0xaf, 0x5d, 0x6e, 0x79, 0x2f, 0xc5, 0x8f, 0x89, 0xf4,
- 0xbd, 0x80, 0xf0, 0xd8, 0xeb, 0x09, 0xf7, 0xc6, 0x52, 0x9f, 0xf6, 0x7b, 0x90, 0x34, 0x67, 0x53,
- 0x95, 0x4d, 0x25, 0x22, 0xcf, 0x1c, 0x73, 0x36, 0xed, 0xcf, 0xdd, 0x45, 0xe6, 0xc4, 0xc3, 0x99,
- 0xf3, 0x5d, 0xb8, 0x33, 0xd6, 0x5c, 0x75, 0xa9, 0x0f, 0x61, 0x89, 0xa5, 0x94, 0xfc, 0x58, 0x73,
- 0x23, 0x1d, 0xa7, 0xf2, 0x73, 0x48, 0xf6, 0xe7, 0xf8, 0x79, 0xc6, 0x9a, 0xb7, 0x63, 0x59, 0xde,
- 0xcc, 0xcb, 0x3f, 0xc5, 0x52, 0x4c, 0x80, 0xf9, 0x26, 0x81, 0xc8, 0x86, 0x5b, 0xff, 0x63, 0x91,
- 0x3d, 0x4b, 0xd5, 0x37, 0xfc, 0xf0, 0xf3, 0x3e, 0xf9, 0xde, 0xfd, 0xb3, 0x00, 0x69, 0x8f, 0xb5,
- 0x0f, 0x27, 0xda, 0x88, 0x55, 0x69, 0xe3, 0xf8, 0xb4, 0xf9, 0x54, 0x6d, 0x1f, 0xaa, 0x1f, 0x1e,
- 0xd7, 0x9f, 0xa8, 0xcf, 0x3a, 0x4f, 0x3b, 0xa7, 0x3f, 0xee, 0xe4, 0x37, 0x8a, 0x77, 0x2f, 0xaf,
- 0x64, 0x29, 0x84, 0x7d, 0x66, 0xbe, 0x30, 0xad, 0x5f, 0xe0, 0x40, 0x18, 0x35, 0xa9, 0x37, 0x7a,
- 0xad, 0x4e, 0x3f, 0x2f, 0x14, 0xf7, 0x2e, 0xaf, 0xe4, 0x9d, 0x90, 0x45, 0x7d, 0xe0, 0x12, 0x93,
- 0xae, 0x1a, 0x34, 0x4f, 0x4f, 0x4e, 0xda, 0xfd, 0xfc, 0xe6, 0x8a, 0x81, 0x37, 0x61, 0x7c, 0x1b,
- 0x76, 0xa2, 0x06, 0x9d, 0xf6, 0x71, 0x3e, 0x56, 0x94, 0x2e, 0xaf, 0xe4, 0x5c, 0x08, 0xdd, 0x31,
- 0x26, 0xc5, 0xd4, 0x27, 0xbf, 0x2b, 0x6d, 0xfc, 0xe1, 0xf7, 0x25, 0xe1, 0xdd, 0x3f, 0x6d, 0x42,
- 0x36, 0xf2, 0xf6, 0x94, 0xbe, 0x03, 0xf7, 0x7a, 0xed, 0x27, 0x9d, 0xd6, 0xa1, 0x7a, 0xd2, 0x7b,
- 0xa2, 0xf6, 0x7f, 0xd2, 0x6d, 0x85, 0xa2, 0xdb, 0xbe, 0xbc, 0x92, 0xd3, 0x5e, 0x48, 0x37, 0xa1,
- 0xbb, 0x4a, 0xeb, 0xec, 0xb4, 0xdf, 0xca, 0x0b, 0x1c, 0xdd, 0x75, 0x08, 0x1b, 0x0e, 0x10, 0xfd,
- 0x10, 0xf6, 0xd7, 0xa0, 0x83, 0xc0, 0x76, 0x2e, 0xaf, 0xe4, 0x6c, 0xd7, 0x21, 0xbc, 0x08, 0xd1,
- 0xa2, 0x0a, 0x85, 0x55, 0x8b, 0xd3, 0xee, 0x69, 0xaf, 0x7e, 0x9c, 0x97, 0x8b, 0xf9, 0xcb, 0x2b,
- 0x39, 0xe3, 0x8f, 0x09, 0x88, 0xaf, 0x43, 0x65, 0x3d, 0xbe, 0xa5, 0xa8, 0x47, 0xad, 0xba, 0xd2,
- 0x6f, 0xb4, 0xea, 0xfd, 0xfc, 0xc3, 0xe2, 0xfe, 0xe5, 0x95, 0xbc, 0xb7, 0xf2, 0x6e, 0xc2, 0x2d,
- 0x1e, 0x41, 0x71, 0x79, 0x0b, 0xe5, 0xf4, 0x59, 0xe7, 0x50, 0xed, 0x3d, 0x6d, 0x77, 0xf3, 0x8f,
- 0xb8, 0x97, 0x41, 0xa7, 0x64, 0x26, 0x0b, 0x3e, 0x1b, 0x9d, 0x2f, 0xaf, 0x4b, 0xc2, 0x57, 0xd7,
- 0x25, 0xe1, 0xef, 0xd7, 0x25, 0xe1, 0xd3, 0x57, 0xa5, 0x8d, 0xaf, 0x5e, 0x95, 0x36, 0xfe, 0xf2,
- 0xaa, 0xb4, 0xf1, 0xd3, 0xf7, 0x47, 0x06, 0x1d, 0xcf, 0x06, 0xd5, 0xa1, 0x35, 0xc5, 0x3f, 0x45,
- 0x6c, 0xed, 0xa2, 0xc6, 0xd3, 0x8e, 0xad, 0xf8, 0x3f, 0x32, 0xb5, 0xe5, 0x7f, 0x48, 0x06, 0x09,
- 0x94, 0xbf, 0xf7, 0x9f, 0x01, 0x00, 0xb0, 0x1a, 0xa1, 0x28, 0xff, 0x11, 0x00, 0x00,
+ // 1757 bytes of a gzipped FileDescriptorProto
+ 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xbc, 0x58, 0xcd, 0x6f, 0x23, 0x49,
+ 0x15, 0x4f, 0xc7, 0x9f, 0x79, 0xb6, 0x13, 0xa7, 0x27, 0x99, 0x71, 0x3c, 0x3b, 0x76, 0x63, 0x04,
+ 0x84, 0x15, 0xd8, 0x33, 0xb3, 0x2b, 0x3e, 0x56, 0xe2, 0x60, 0x3b, 0xde, 0x89, 0x35, 0x89, 0x63,
+ 0xb5, 0x3d, 0x83, 0x80, 0x43, 0xab, 0xed, 0xae, 0xb1, 0x9b, 0xb1, 0xbb, 0x7b, 0xbb, 0xcb, 0x21,
+ 0xd9, 0x13, 0x37, 0x56, 0x39, 0xed, 0x01, 0xa1, 0xbd, 0x44, 0x62, 0x05, 0x07, 0xfe, 0x03, 0xee,
+ 0x9c, 0xf6, 0x82, 0xb4, 0x37, 0x38, 0xa0, 0x01, 0x65, 0x6e, 0x9c, 0x38, 0x70, 0x06, 0x54, 0xaf,
+ 0xaa, 0xdb, 0xdd, 0xb6, 0x13, 0x26, 0x23, 0xc4, 0xc5, 0xea, 0x7a, 0xef, 0xf7, 0xaa, 0xde, 0xfb,
+ 0xbd, 0x8f, 0xae, 0x36, 0xbc, 0x43, 0x89, 0x65, 0x10, 0x77, 0x6a, 0x5a, 0xb4, 0x46, 0xcf, 0x1d,
+ 0xe2, 0xf1, 0xdf, 0xaa, 0xe3, 0xda, 0xd4, 0x96, 0xf3, 0x73, 0x6d, 0x15, 0xe5, 0xc5, 0x9d, 0x91,
+ 0x3d, 0xb2, 0x51, 0x59, 0x63, 0x4f, 0x1c, 0x57, 0x2c, 0x8f, 0x6c, 0x7b, 0x34, 0x21, 0x35, 0x5c,
+ 0x0d, 0x66, 0x2f, 0x6a, 0xd4, 0x9c, 0x12, 0x8f, 0xea, 0x53, 0x47, 0x00, 0x1e, 0x84, 0x8e, 0x19,
+ 0xba, 0xe7, 0x0e, 0xb5, 0x19, 0xd6, 0x7e, 0x21, 0xd4, 0xa5, 0x90, 0xfa, 0x94, 0xb8, 0x9e, 0x69,
+ 0x5b, 0x61, 0x3f, 0x8a, 0xf7, 0x97, 0xbc, 0x34, 0x74, 0x6f, 0x2c, 0x94, 0xca, 0x92, 0xf2, 0x54,
+ 0x9f, 0x98, 0x86, 0x4e, 0x6d, 0x97, 0x23, 0x2a, 0xdf, 0x87, 0x5c, 0x57, 0x77, 0x69, 0x8f, 0xd0,
+ 0x43, 0xa2, 0x1b, 0xc4, 0x95, 0x77, 0x20, 0x41, 0x6d, 0xaa, 0x4f, 0x0a, 0x92, 0x22, 0xed, 0xe7,
+ 0x54, 0xbe, 0x90, 0x65, 0x88, 0x8f, 0x75, 0x6f, 0x5c, 0x58, 0x57, 0xa4, 0xfd, 0xac, 0x8a, 0xcf,
+ 0x95, 0x31, 0xc4, 0x99, 0x29, 0xb3, 0x30, 0x2d, 0x83, 0x9c, 0xf9, 0x16, 0xb8, 0x60, 0xd2, 0xc1,
+ 0x39, 0x25, 0x9e, 0x30, 0xe1, 0x0b, 0xf9, 0x7d, 0x48, 0x60, 0x70, 0x85, 0x98, 0x22, 0xed, 0x67,
+ 0x1e, 0x17, 0xaa, 0x21, 0x16, 0x79, 0xf0, 0xd5, 0x2e, 0xd3, 0x37, 0xe2, 0x5f, 0xbc, 0x2a, 0xaf,
+ 0xa9, 0x1c, 0x5c, 0xf9, 0xa5, 0x04, 0xa9, 0xc6, 0xc4, 0x1e, 0xbe, 0x6c, 0x1f, 0x04, 0x9e, 0x48,
+ 0x73, 0x4f, 0xe4, 0x63, 0xd8, 0x72, 0x74, 0x97, 0x6a, 0x1e, 0xa1, 0xda, 0x18, 0xc3, 0xc0, 0x53,
+ 0x33, 0x8f, 0xcb, 0xd5, 0xc5, 0x2c, 0x55, 0x23, 0xd1, 0x8a, 0x63, 0x72, 0x4e, 0x84, 0x82, 0xaf,
+ 0x43, 0xda, 0xa3, 0x3a, 0x25, 0x9a, 0x69, 0xa0, 0x9f, 0xd9, 0x46, 0xe6, 0xea, 0x55, 0x39, 0xd5,
+ 0x63, 0xb2, 0xf6, 0x81, 0x9a, 0x42, 0x65, 0xdb, 0xa8, 0xfc, 0x53, 0x02, 0x5f, 0x28, 0xd7, 0x20,
+ 0xa3, 0x3b, 0x8e, 0x26, 0x32, 0x84, 0xde, 0x25, 0x1b, 0x9b, 0x57, 0xaf, 0xca, 0x50, 0x77, 0x9c,
+ 0xe7, 0x5c, 0xaa, 0x82, 0x1e, 0x3c, 0xcb, 0x77, 0x21, 0x39, 0x26, 0xe6, 0x68, 0x4c, 0xd1, 0xd5,
+ 0xa4, 0x2a, 0x56, 0xec, 0x70, 0xb6, 0x11, 0xc6, 0x18, 0x3a, 0xbc, 0xee, 0x38, 0x87, 0xba, 0x37,
+ 0x56, 0x53, 0x3a, 0x7f, 0x90, 0x55, 0x28, 0x0c, 0x6d, 0x97, 0x68, 0xc3, 0xb1, 0x6e, 0x5a, 0x1a,
+ 0x23, 0x87, 0x18, 0x9a, 0xd8, 0x31, 0xae, 0x48, 0xfb, 0xa9, 0xc6, 0xde, 0xd5, 0xab, 0xf2, 0x6e,
+ 0xd3, 0x76, 0x49, 0x93, 0x41, 0x8e, 0x10, 0x71, 0x88, 0x00, 0x75, 0x77, 0xb8, 0x4a, 0xcc, 0xb8,
+ 0x65, 0xd5, 0x59, 0x48, 0xa0, 0x47, 0xf8, 0xfc, 0x41, 0xfe, 0xb3, 0x5f, 0x97, 0xd7, 0x3e, 0xf9,
+ 0xbc, 0x2c, 0x7d, 0xf6, 0x79, 0x59, 0xfa, 0xf9, 0x5f, 0x94, 0xb5, 0xca, 0xbf, 0x12, 0x90, 0x14,
+ 0x4c, 0xfd, 0x00, 0x52, 0xe1, 0x88, 0x33, 0x8f, 0x1f, 0x84, 0x09, 0x17, 0xaa, 0x6a, 0xd3, 0xb6,
+ 0x3c, 0x62, 0x79, 0x33, 0x4f, 0xd0, 0xed, 0xdb, 0xb0, 0x58, 0xb9, 0xfb, 0xa6, 0x81, 0x2c, 0x6c,
+ 0xf0, 0x58, 0xd1, 0x31, 0x46, 0x34, 0x2a, 0xdb, 0x46, 0x88, 0x2b, 0xc6, 0x48, 0x2c, 0xe0, 0xea,
+ 0x7b, 0xc2, 0xdf, 0x38, 0x9e, 0x5d, 0xac, 0xf2, 0x56, 0xab, 0xfa, 0xad, 0x56, 0xed, 0xfb, 0xad,
+ 0xd6, 0x48, 0xb3, 0x83, 0x3f, 0xfd, 0x6b, 0x59, 0xe2, 0x51, 0xc9, 0x4d, 0xc8, 0x4d, 0x74, 0x8f,
+ 0x6a, 0x03, 0x46, 0x1c, 0x3b, 0x3e, 0x81, 0x5b, 0xec, 0x2d, 0xd7, 0x8b, 0xa8, 0x3b, 0xe1, 0x7a,
+ 0x86, 0x59, 0x71, 0x91, 0x21, 0xef, 0x43, 0x1e, 0x37, 0x19, 0xda, 0xd3, 0xa9, 0x49, 0x79, 0xca,
+ 0x92, 0x58, 0x96, 0x9b, 0x4c, 0xde, 0x44, 0x31, 0x26, 0xeb, 0x3e, 0x6c, 0x18, 0x3a, 0xd5, 0x39,
+ 0x24, 0x85, 0x90, 0x34, 0x13, 0xa0, 0xf2, 0x1b, 0xb0, 0x15, 0x74, 0xa5, 0xc7, 0x21, 0x69, 0xbe,
+ 0xcb, 0x5c, 0x8c, 0xc0, 0x87, 0xb0, 0x63, 0x91, 0x33, 0xaa, 0x2d, 0xa2, 0x37, 0x10, 0x2d, 0x33,
+ 0xdd, 0xf3, 0xa8, 0xc5, 0xd7, 0x60, 0x73, 0xe8, 0x93, 0xcf, 0xb1, 0x80, 0xd8, 0x5c, 0x20, 0x45,
+ 0x58, 0x15, 0xee, 0xe0, 0xc6, 0x0b, 0xd8, 0x0c, 0x62, 0xb7, 0x99, 0xaa, 0x19, 0xc1, 0xef, 0x85,
+ 0x6a, 0x34, 0x8b, 0xa0, 0xa0, 0x2c, 0xbf, 0x02, 0x59, 0x97, 0x78, 0xb3, 0x09, 0x15, 0x7b, 0xe4,
+ 0x50, 0x9d, 0x11, 0x32, 0x84, 0x7c, 0x15, 0x72, 0xe4, 0xd4, 0x34, 0x88, 0x35, 0x24, 0x1c, 0xb3,
+ 0x89, 0x98, 0xac, 0x2f, 0xf4, 0x63, 0x75, 0x5c, 0xdb, 0xb1, 0x3d, 0x62, 0x68, 0xe1, 0xc6, 0xda,
+ 0x52, 0xa4, 0xfd, 0xb8, 0x2a, 0xfb, 0xba, 0x79, 0x73, 0xc9, 0xb5, 0xc0, 0xc2, 0xd5, 0x1c, 0xd7,
+ 0xd6, 0xe8, 0x19, 0xdf, 0x3d, 0xcf, 0xa3, 0xf0, 0x75, 0x5d, 0xd7, 0xee, 0x9f, 0xe1, 0x11, 0xdf,
+ 0xbd, 0xa1, 0x83, 0xb6, 0x71, 0x94, 0xad, 0x6e, 0x93, 0x4a, 0x01, 0xe2, 0x07, 0x3a, 0xd5, 0xe5,
+ 0x3c, 0xc4, 0xe8, 0x99, 0x57, 0x90, 0x94, 0xd8, 0x7e, 0x56, 0x65, 0x8f, 0x95, 0x7f, 0xaf, 0x43,
+ 0xfc, 0xb9, 0x4d, 0x89, 0xfc, 0x1e, 0xc4, 0x59, 0xf9, 0x60, 0x57, 0x6c, 0xae, 0x1a, 0x43, 0x3d,
+ 0x73, 0x64, 0x11, 0xe3, 0xd8, 0x1b, 0xf5, 0xcf, 0x1d, 0xa2, 0x22, 0x78, 0x61, 0x24, 0xcc, 0xcb,
+ 0x7c, 0x07, 0x12, 0xae, 0x3d, 0xb3, 0xf8, 0x30, 0x4a, 0xa8, 0x7c, 0x21, 0xb7, 0x20, 0x1d, 0x54,
+ 0x6f, 0xfc, 0xbf, 0x55, 0xef, 0x16, 0xab, 0x5e, 0xd6, 0x5b, 0x42, 0xa0, 0xa6, 0x06, 0xa2, 0x88,
+ 0x1f, 0xc1, 0x6e, 0x50, 0x4f, 0x11, 0xde, 0x12, 0xbc, 0xaa, 0x02, 0xe5, 0x9c, 0xb8, 0x70, 0xc1,
+ 0x6a, 0x7c, 0xf4, 0x27, 0xd1, 0xb3, 0x79, 0xc1, 0xb6, 0x99, 0x94, 0x01, 0xb9, 0x8b, 0x9e, 0x39,
+ 0xb2, 0x74, 0x3a, 0x73, 0x89, 0x28, 0xfe, 0x4d, 0x14, 0xf7, 0x7c, 0xa9, 0x7c, 0x08, 0x5b, 0xa7,
+ 0x36, 0x25, 0x1a, 0x39, 0xa3, 0xc4, 0x62, 0xd9, 0xf4, 0x0a, 0x69, 0x25, 0xb6, 0x7a, 0x80, 0x33,
+ 0x7e, 0x5b, 0x3e, 0x4e, 0xdd, 0x3c, 0x0d, 0x2f, 0xbd, 0xca, 0xdf, 0xd7, 0x21, 0xc9, 0x1b, 0x2f,
+ 0x44, 0xa7, 0xb4, 0x9a, 0xce, 0xf5, 0xeb, 0xe8, 0x8c, 0xbd, 0x3d, 0x9d, 0x65, 0xc8, 0x7c, 0x34,
+ 0xb3, 0xdd, 0xd9, 0x94, 0x93, 0x18, 0xc7, 0x70, 0x81, 0x8b, 0x90, 0xbc, 0x0f, 0x60, 0x8f, 0x8e,
+ 0x5d, 0xe2, 0x8d, 0xed, 0x89, 0xa1, 0x2d, 0xb2, 0xc3, 0x39, 0xbf, 0x17, 0x00, 0x1a, 0x51, 0x9a,
+ 0x7e, 0x12, 0xb6, 0x5d, 0x24, 0x2c, 0xf9, 0x66, 0x84, 0xcd, 0x37, 0x8f, 0xc8, 0x3d, 0x46, 0xd7,
+ 0x80, 0xe8, 0x43, 0xdb, 0x12, 0x39, 0x12, 0xab, 0x48, 0xb3, 0xa7, 0x23, 0xcd, 0x5e, 0xf9, 0x43,
+ 0x0c, 0xd2, 0x5d, 0xec, 0x2b, 0x7d, 0xf2, 0xff, 0x28, 0xf9, 0xfb, 0xb0, 0xe1, 0xd8, 0x13, 0x8d,
+ 0x6b, 0xe2, 0xa8, 0x49, 0x3b, 0xf6, 0x44, 0x5d, 0x4a, 0x60, 0xe2, 0xed, 0x13, 0xd8, 0x80, 0x8d,
+ 0xe0, 0x86, 0x56, 0x48, 0xde, 0xe2, 0xc5, 0x32, 0x37, 0x93, 0xdf, 0x81, 0x8d, 0xc5, 0x8a, 0x9f,
+ 0x0b, 0x6e, 0x9c, 0x3b, 0xe9, 0x1b, 0xe6, 0x8e, 0xdc, 0x87, 0xbb, 0x0b, 0x86, 0xda, 0xcc, 0x31,
+ 0x74, 0x4a, 0xf0, 0x0d, 0xb0, 0x32, 0xf7, 0x91, 0xd7, 0xbf, 0x7a, 0x27, 0xb2, 0xef, 0x33, 0xb4,
+ 0xad, 0xfc, 0x43, 0x82, 0xed, 0xae, 0x18, 0x8e, 0x87, 0x44, 0x77, 0xe9, 0x80, 0xe8, 0xb7, 0x6d,
+ 0x9e, 0x22, 0xa4, 0x3d, 0xf2, 0xd1, 0x8c, 0x4d, 0x6f, 0xcc, 0x58, 0x5c, 0x0d, 0xd6, 0xd7, 0xce,
+ 0xe5, 0xf8, 0x75, 0x73, 0x39, 0x92, 0x81, 0xc4, 0xff, 0x20, 0x03, 0xc9, 0x85, 0x0c, 0x54, 0x7e,
+ 0x2f, 0x41, 0x0e, 0x8b, 0xa6, 0xf7, 0xd2, 0x74, 0x70, 0x5e, 0xdf, 0x2e, 0xdc, 0x6b, 0x67, 0x66,
+ 0xec, 0x36, 0x33, 0x33, 0xbe, 0x72, 0x66, 0x46, 0x3c, 0x4f, 0x2c, 0x7a, 0xfe, 0x2b, 0x09, 0x76,
+ 0x02, 0xcf, 0x9b, 0xc4, 0xa5, 0xe6, 0x0b, 0x73, 0xa8, 0xdf, 0x3a, 0x80, 0x85, 0x29, 0x15, 0x5b,
+ 0x9a, 0x52, 0x35, 0xb8, 0x33, 0x9f, 0x34, 0x73, 0x7f, 0x78, 0xce, 0xe4, 0x40, 0x15, 0x8c, 0xa6,
+ 0x8a, 0x0b, 0x59, 0xde, 0xdf, 0xe2, 0x66, 0xf8, 0x90, 0xf9, 0xc3, 0x9e, 0x0a, 0xd2, 0xf2, 0x4d,
+ 0x9f, 0xd7, 0x26, 0x47, 0xaa, 0xc9, 0x71, 0x60, 0xc1, 0x2f, 0x52, 0x85, 0xf5, 0xeb, 0x2c, 0xf8,
+ 0x60, 0x57, 0x05, 0x8e, 0x91, 0x01, 0x47, 0x2c, 0x4a, 0x6c, 0x62, 0x76, 0xa7, 0xf3, 0xd0, 0x05,
+ 0x2d, 0x72, 0x72, 0xe9, 0xba, 0x49, 0x24, 0xce, 0xcf, 0x7a, 0x61, 0xbf, 0x9b, 0x90, 0x9b, 0xe7,
+ 0xc9, 0x23, 0xbe, 0x33, 0x2b, 0x36, 0x09, 0xae, 0x5a, 0x3d, 0x42, 0xd5, 0xec, 0x69, 0x68, 0x55,
+ 0xf9, 0xc5, 0x3a, 0x6c, 0xa0, 0x4f, 0xc7, 0x84, 0xea, 0x91, 0xc1, 0x24, 0xbd, 0xfd, 0x60, 0x7a,
+ 0x00, 0xe0, 0xbf, 0x2e, 0x3e, 0x26, 0x62, 0x5c, 0x6e, 0x88, 0xf7, 0xe8, 0xc7, 0x44, 0xfe, 0x4e,
+ 0x40, 0x78, 0xec, 0x66, 0xc2, 0xc5, 0x4d, 0xd6, 0xa7, 0xfd, 0x1e, 0xa4, 0xac, 0xd9, 0x54, 0x63,
+ 0x17, 0x99, 0x38, 0xaf, 0x1c, 0x6b, 0x36, 0xed, 0x9f, 0x79, 0xf3, 0xca, 0x49, 0x84, 0x2b, 0xe7,
+ 0xdb, 0x70, 0x67, 0xac, 0x7b, 0xda, 0xc2, 0x1c, 0xc2, 0x16, 0x4b, 0xab, 0xf9, 0xb1, 0xee, 0x45,
+ 0x26, 0x4e, 0xe5, 0xa7, 0x90, 0xea, 0x9f, 0xe1, 0x17, 0x1d, 0x1b, 0xde, 0xae, 0x6d, 0x8b, 0x6b,
+ 0x32, 0xff, 0x7a, 0x4b, 0x33, 0x01, 0xd6, 0x9b, 0x0c, 0x71, 0x76, 0x1f, 0xf6, 0xbf, 0x2f, 0xd9,
+ 0xb3, 0x5c, 0x7d, 0xc3, 0x6f, 0x45, 0xf1, 0x95, 0xf8, 0xee, 0x9f, 0x24, 0xc8, 0x08, 0xd6, 0x3e,
+ 0x9c, 0xe8, 0x23, 0xd6, 0xa5, 0x8d, 0xa3, 0x93, 0xe6, 0x53, 0xad, 0x7d, 0xa0, 0x7d, 0x78, 0x54,
+ 0x7f, 0xa2, 0x3d, 0xeb, 0x3c, 0xed, 0x9c, 0xfc, 0xb0, 0x93, 0x5f, 0x2b, 0xde, 0xbd, 0xb8, 0x54,
+ 0xe4, 0x10, 0xf6, 0x99, 0xf5, 0xd2, 0xb2, 0x7f, 0x86, 0x77, 0xc8, 0xa8, 0x49, 0xbd, 0xd1, 0x6b,
+ 0x75, 0xfa, 0x79, 0xa9, 0xb8, 0x7b, 0x71, 0xa9, 0x6c, 0x87, 0x2c, 0xea, 0x03, 0x8f, 0x58, 0x74,
+ 0xd9, 0xa0, 0x79, 0x72, 0x7c, 0xdc, 0xee, 0xe7, 0xd7, 0x97, 0x0c, 0xc4, 0xa5, 0xe4, 0x9b, 0xb0,
+ 0x1d, 0x35, 0xe8, 0xb4, 0x8f, 0xf2, 0xb1, 0xa2, 0x7c, 0x71, 0xa9, 0x6c, 0x86, 0xd0, 0x1d, 0x73,
+ 0x52, 0x4c, 0x7f, 0xf2, 0x9b, 0xd2, 0xda, 0xef, 0x7e, 0x5b, 0x92, 0xde, 0xfd, 0xe3, 0x3a, 0xe4,
+ 0x22, 0x6f, 0x4f, 0xf9, 0x5b, 0x70, 0xaf, 0xd7, 0x7e, 0xd2, 0x69, 0x1d, 0x68, 0xc7, 0xbd, 0x27,
+ 0x5a, 0xff, 0x47, 0xdd, 0x56, 0x28, 0xba, 0xad, 0x8b, 0x4b, 0x25, 0x23, 0x42, 0xba, 0x0e, 0xdd,
+ 0x55, 0x5b, 0xcf, 0x4f, 0xfa, 0xad, 0xbc, 0xc4, 0xd1, 0x5d, 0x97, 0xb0, 0xfb, 0x04, 0xa2, 0x1f,
+ 0xc2, 0xde, 0x0a, 0x74, 0x10, 0xd8, 0xf6, 0xc5, 0xa5, 0x92, 0xeb, 0xba, 0x84, 0x37, 0x21, 0x5a,
+ 0x54, 0xa1, 0xb0, 0x6c, 0x71, 0xd2, 0x3d, 0xe9, 0xd5, 0x8f, 0xf2, 0x4a, 0x31, 0x7f, 0x71, 0xa9,
+ 0x64, 0xfd, 0x6b, 0x02, 0xe2, 0xeb, 0x50, 0x59, 0x8d, 0x6f, 0xa9, 0xda, 0x61, 0xab, 0xae, 0xf6,
+ 0x1b, 0xad, 0x7a, 0x3f, 0xff, 0xb0, 0xb8, 0x77, 0x71, 0xa9, 0xec, 0x2e, 0xbd, 0x9b, 0x70, 0x8b,
+ 0x47, 0x50, 0x5c, 0xdc, 0x42, 0x3d, 0x79, 0xd6, 0x39, 0xd0, 0x7a, 0x4f, 0xdb, 0xdd, 0xfc, 0x23,
+ 0xee, 0x65, 0x30, 0x29, 0x99, 0xc9, 0x9c, 0xcf, 0x46, 0xe7, 0x8b, 0xab, 0x92, 0xf4, 0xe5, 0x55,
+ 0x49, 0xfa, 0xdb, 0x55, 0x49, 0xfa, 0xf4, 0x75, 0x69, 0xed, 0xcb, 0xd7, 0xa5, 0xb5, 0x3f, 0xbf,
+ 0x2e, 0xad, 0xfd, 0xf8, 0xfd, 0x91, 0x49, 0xc7, 0xb3, 0x41, 0x75, 0x68, 0x4f, 0xf1, 0x7f, 0x14,
+ 0x47, 0x3f, 0xaf, 0xf1, 0xb2, 0x63, 0x2b, 0xfe, 0x27, 0x4e, 0x6d, 0xf1, 0x4f, 0x95, 0x41, 0x12,
+ 0xe5, 0xef, 0xfd, 0x67, 0x00, 0x12, 0xab, 0xa9, 0xf3, 0x32, 0x12, 0x00, 0x00,
}
func (m *PartSetHeader) Marshal() (dAtA []byte, err error) {
@@ -1997,6 +2022,20 @@ func (m *Commit) MarshalToSizedBuffer(dAtA []byte) (int, error) {
_ = i
var l int
_ = l
+ if len(m.AppHash) > 0 {
+ i -= len(m.AppHash)
+ copy(dAtA[i:], m.AppHash)
+ i = encodeVarintTypes(dAtA, i, uint64(len(m.AppHash)))
+ i--
+ dAtA[i] = 0x42
+ }
+ if len(m.Beacon) > 0 {
+ i -= len(m.Beacon)
+ copy(dAtA[i:], m.Beacon)
+ i = encodeVarintTypes(dAtA, i, uint64(len(m.Beacon)))
+ i--
+ dAtA[i] = 0x3a
+ }
if len(m.ThresholdVoteExtensions) > 0 {
for iNdEx := len(m.ThresholdVoteExtensions) - 1; iNdEx >= 0; iNdEx-- {
{
@@ -2764,6 +2803,14 @@ func (m *Commit) Size() (n int) {
n += 1 + l + sovTypes(uint64(l))
}
}
+ l = len(m.Beacon)
+ if l > 0 {
+ n += 1 + l + sovTypes(uint64(l))
+ }
+ l = len(m.AppHash)
+ if l > 0 {
+ n += 1 + l + sovTypes(uint64(l))
+ }
return n
}
@@ -4603,6 +4650,74 @@ func (m *Commit) Unmarshal(dAtA []byte) error {
return err
}
iNdEx = postIndex
+ case 7:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field Beacon", wireType)
+ }
+ var byteLen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ byteLen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if byteLen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + byteLen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ m.Beacon = append(m.Beacon[:0], dAtA[iNdEx:postIndex]...)
+ if m.Beacon == nil {
+ m.Beacon = []byte{}
+ }
+ iNdEx = postIndex
+ case 8:
+ if wireType != 2 {
+ return fmt.Errorf("proto: wrong wireType = %d for field AppHash", wireType)
+ }
+ var byteLen int
+ for shift := uint(0); ; shift += 7 {
+ if shift >= 64 {
+ return ErrIntOverflowTypes
+ }
+ if iNdEx >= l {
+ return io.ErrUnexpectedEOF
+ }
+ b := dAtA[iNdEx]
+ iNdEx++
+ byteLen |= int(b&0x7F) << shift
+ if b < 0x80 {
+ break
+ }
+ }
+ if byteLen < 0 {
+ return ErrInvalidLengthTypes
+ }
+ postIndex := iNdEx + byteLen
+ if postIndex < 0 {
+ return ErrInvalidLengthTypes
+ }
+ if postIndex > l {
+ return io.ErrUnexpectedEOF
+ }
+ m.AppHash = append(m.AppHash[:0], dAtA[iNdEx:postIndex]...)
+ if m.AppHash == nil {
+ m.AppHash = []byte{}
+ }
+ iNdEx = postIndex
default:
iNdEx = preIndex
skippy, err := skipTypes(dAtA[iNdEx:])
diff --git a/proto/tendermint/types/types.proto b/proto/tendermint/types/types.proto
index 860a2b644e..59a4b78090 100644
--- a/proto/tendermint/types/types.proto
+++ b/proto/tendermint/types/types.proto
@@ -162,6 +162,16 @@ message Commit {
bytes quorum_hash = 4;
bytes threshold_block_signature = 5;
repeated VoteExtension threshold_vote_extensions = 6;
+ // Random beacon: the threshold signature recovered from the prevotes of the commit round, which
+ // verifies against their sign item and the quorum's threshold public key.
+ // Set from consensus version 2; empty before. The commit's signature covers neither this field
+ // nor app_hash as bytes: a commit is refused unless both are empty or they are exactly 96 and 32
+ // bytes, and a block's last commit is read without them when they are not.
+ bytes beacon = 7;
+ // App hash returned by ApplyBlockRandomness for this block and round. The precommits sign it only
+ // through block_id.state_id, the hash of the block header's state ID with its app hash replaced by
+ // this one: trust this field only once that hash matches. Set from consensus version 2; empty before.
+ bytes app_hash = 8;
}
message Proposal {
diff --git a/spec/abci/api.md b/spec/abci/api.md
index 19be3e9e07..48041dbb78 100644
--- a/spec/abci/api.md
+++ b/spec/abci/api.md
@@ -13,6 +13,7 @@
- [Misbehavior](#tendermint-abci-Misbehavior)
- [QuorumHashUpdate](#tendermint-abci-QuorumHashUpdate)
- [Request](#tendermint-abci-Request)
+ - [RequestApplyBlockRandomness](#tendermint-abci-RequestApplyBlockRandomness)
- [RequestApplySnapshotChunk](#tendermint-abci-RequestApplySnapshotChunk)
- [RequestCheckTx](#tendermint-abci-RequestCheckTx)
- [RequestEcho](#tendermint-abci-RequestEcho)
@@ -29,6 +30,7 @@
- [RequestQuery](#tendermint-abci-RequestQuery)
- [RequestVerifyVoteExtension](#tendermint-abci-RequestVerifyVoteExtension)
- [Response](#tendermint-abci-Response)
+ - [ResponseApplyBlockRandomness](#tendermint-abci-ResponseApplyBlockRandomness)
- [ResponseApplySnapshotChunk](#tendermint-abci-ResponseApplySnapshotChunk)
- [ResponseCheckTx](#tendermint-abci-ResponseCheckTx)
- [ResponseEcho](#tendermint-abci-ResponseEcho)
@@ -87,6 +89,8 @@
| quorum_hash | [bytes](#bytes) | | |
| block_signature | [bytes](#bytes) | | |
| threshold_vote_extensions | [tendermint.types.VoteExtension](../../proto/tendermint/types/) | repeated | |
+| beacon | [bytes](#bytes) | | Random beacon of the committed block: the threshold signature recovered from the prevotes of the commit round. Set from consensus version 2; empty before. |
+| app_hash | [bytes](#bytes) | | App hash after `ApplyBlockRandomness` for the committed block and round. The commit signs it through the state ID of its block ID, which Tenderdash checks before passing it on. Set from consensus version 2; empty before. |
@@ -251,6 +255,60 @@ Request types
| extend_vote | [RequestExtendVote](#tendermint-abci-RequestExtendVote) | | |
| verify_vote_extension | [RequestVerifyVoteExtension](#tendermint-abci-RequestVerifyVoteExtension) | | |
| finalize_block | [RequestFinalizeBlock](#tendermint-abci-RequestFinalizeBlock) | | |
+| apply_block_randomness | [RequestApplyBlockRandomness](#tendermint-abci-RequestApplyBlockRandomness) | | |
+
+
+
+
+
+
+
+
+### RequestApplyBlockRandomness
+Applies the block's randomness and returns the app hash the Precommit signs.
+
+#### Usage
+
+- Used from consensus version 2 (`VersionParams.consensus_version`). Before that, Tenderdash never calls it.
+ This release never calls it, at any consensus version.
+- `RequestApplyBlockRandomness.beacon` is the random beacon of the block and round: the 96-byte BLS threshold
+ signature recovered from the Prevotes of round `round` for the block `hash`. Tenderdash has verified it against
+ the quorum's threshold public key before the call.
+- The Application applies the randomness to the state that `ProcessProposal` (or `PrepareProposal`) left for
+ that block and round, and returns the resulting Merkle root hash in `ResponseApplyBlockRandomness.app_hash`.
+ When nothing in the block uses randomness, `app_hash` equals the app hash of the block header.
+- The header keeps the app hash from `ProcessProposal`, which Prevotes sign. Precommits and the commit sign
+ `ResponseApplyBlockRandomness.app_hash`, and the commit carries it in `Commit.app_hash`.
+- The randomness may change only the application state behind `app_hash`. Transaction results, events,
+ validator set updates, consensus parameter updates and the other outputs of `ProcessProposal` are fixed
+ by the header the Prevotes signed: they MUST NOT depend on the beacon, and Tenderdash keeps the ones
+ `ProcessProposal` returned.
+- Vote extensions and their verification MUST NOT depend on the beacon or on the state this call produces;
+ see `ExtendVote`.
+- The implementation MUST be deterministic: every process that applies the same beacon to the same block
+ and round MUST return the same `app_hash`.
+- Tenderdash may call it more than once for the same block, round and beacon; the Application MUST return
+ the same `app_hash` each time.
+- It MUST NOT modify the committed state: Tenderdash may call it for a round that never commits, and
+ `FinalizeBlock` commits the state for the commit round.
+- An ABCI error is fatal, as for `ExtendVote`.
+
+#### When does Tenderdash call it?
+
+- On a validator, once the Prevotes of round _r_ for block _v_ reach the threshold and their signature is
+ recovered, before `ExtendVote` and before signing its Precommit for _v_.
+- On every path that finalizes a block from a commit (consensus, block sync, replay, a node that did not
+ vote): after `ProcessProposal` of the committed block for the commit round, with the commit's beacon, and
+ before `FinalizeBlock`. Tenderdash compares the returned `app_hash` with `Commit.app_hash` and stops on a
+ mismatch.
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| hash | [bytes](#bytes) | | The header hash of the block the Prevotes are for. |
+| height | [int64](#int64) | | Height of the block. |
+| round | [int32](#int32) | | Round whose Prevotes produced the beacon. |
+| beacon | [bytes](#bytes) | | 96-byte BLS threshold signature recovered from those Prevotes. |
@@ -337,6 +395,8 @@ to attach to that vote. It may also call ExtendVote on any node after rejecting
a commit vector, to learn the expected vector without signing or broadcasting.
The call must be free of side effects. Threshold-recoverable extensions must be
deterministic and match the vector accepted at commit-level VerifyVoteExtension.
+From consensus version 2, ApplyBlockRandomness runs first, but the extensions
+must not depend on the beacon or on the state it produced.
See the [ExtendVote contract](methods.md#extendvote).
@@ -360,6 +420,8 @@ The application must persist the candidate before returning; execution results
and events are provided through proposal processing, not ResponseFinalizeBlock.
The response contains retention and next-block scheduling hints only.
Use retain_height with care: pruning blocks can prevent replay and bootstrapping.
+From consensus version 2, the state to persist is that candidate with commit.beacon
+applied, as ApplyBlockRandomness applies it, and its root must equal commit.app_hash.
See the [FinalizeBlock contract](methods.md#finalizeblock) and
[commit and apply](../consensus/consensus-happy-path.md#9-commit-and-apply).
@@ -694,6 +756,22 @@ block. This includes commits the process assembled from its own +2/3 precomm
| extend_vote | [ResponseExtendVote](#tendermint-abci-ResponseExtendVote) | | |
| verify_vote_extension | [ResponseVerifyVoteExtension](#tendermint-abci-ResponseVerifyVoteExtension) | | |
| finalize_block | [ResponseFinalizeBlock](#tendermint-abci-ResponseFinalizeBlock) | | |
+| apply_block_randomness | [ResponseApplyBlockRandomness](#tendermint-abci-ResponseApplyBlockRandomness) | | |
+
+
+
+
+
+
+
+
+### ResponseApplyBlockRandomness
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| app_hash | [bytes](#bytes) | | The Merkle root hash of the application state after the randomness is applied. 32 bytes. Equals the header app hash when nothing in the block uses randomness. The randomness changes nothing but this state: the other results of the block are the ones ProcessProposal returned. |
@@ -793,7 +871,7 @@ nondeterministic
| Field | Type | Label | Description |
| ----- | ---- | ----- | ----------- |
| retain_height | [int64](#int64) | | Blocks below this height may be removed. Defaults to `0` (retain all). |
-| propose_next_block_immediately | [bool](#bool) | | When `true`, this node does not wait for transactions (`create-empty-blocks-interval`) before proposing at the next height, in round 0 or, on consensus version 2, in a round entered after a silent proposer's round was skipped: the application has block-driven work pending, for example withdrawal transactions to sign. A hint for the local node only, consumed once; a node that restarts in between falls back to the configured wait. Defaults to `false`. |
+| propose_next_block_immediately | [bool](#bool) | | When `true`, this node does not wait for transactions (`create-empty-blocks-interval`) before proposing at the next height, in round 0 or, on consensus version 2, in a round entered after a silent proposer's round was skipped: the application has block-driven work pending, for example withdrawal transactions to sign. A hint for the local node only, consumed once; a node that restarts in between falls back to the configured wait. Defaults to `false`. |
@@ -1250,6 +1328,7 @@ TxAction contains App-provided information on what to do with a transaction that
| ExtendVote | [RequestExtendVote](#tendermint-abci-RequestExtendVote) | [ResponseExtendVote](#tendermint-abci-ResponseExtendVote) | |
| VerifyVoteExtension | [RequestVerifyVoteExtension](#tendermint-abci-RequestVerifyVoteExtension) | [ResponseVerifyVoteExtension](#tendermint-abci-ResponseVerifyVoteExtension) | |
| FinalizeBlock | [RequestFinalizeBlock](#tendermint-abci-RequestFinalizeBlock) | [ResponseFinalizeBlock](#tendermint-abci-ResponseFinalizeBlock) | |
+| ApplyBlockRandomness | [RequestApplyBlockRandomness](#tendermint-abci-RequestApplyBlockRandomness) | [ResponseApplyBlockRandomness](#tendermint-abci-ResponseApplyBlockRandomness) | |
diff --git a/spec/abci/app-requirements.md b/spec/abci/app-requirements.md
index 3b89af1ae7..e3227d4117 100644
--- a/spec/abci/app-requirements.md
+++ b/spec/abci/app-requirements.md
@@ -134,8 +134,10 @@ for the block can pass it. See [VerifyVoteExtension](methods.md#verifyvoteextens
Tenderdash does on each path when a commit is rejected.
* Requirement 10 [_all_, no-side-effects]: $p$'s calls to `RequestPrepareProposal`,
- `RequestProcessProposal`, `RequestExtendVote`, and `RequestVerifyVoteExtension` at height $h$ do
- not modify $s_{p,h-1}$.
+ `RequestProcessProposal`, `RequestApplyBlockRandomness`, `RequestExtendVote`, and
+ `RequestVerifyVoteExtension` at height $h$ do not modify $s_{p,h-1}$. Tenderdash may call
+ `RequestApplyBlockRandomness` for a round that never commits, so the randomized state it produces
+ stays a candidate until `FinalizeBlock` commits the one for the commit round.
* Requirement 11 [`ExtendVote`, `FinalizeBlock`, non-dependency]: for any correct process $p$,
and any vote extensions $e$ that $p$ received at height $h$, the computation of
diff --git a/spec/abci/basic-concepts.md b/spec/abci/basic-concepts.md
index 350239cf0e..c9aabc789d 100644
--- a/spec/abci/basic-concepts.md
+++ b/spec/abci/basic-concepts.md
@@ -44,7 +44,7 @@ The first time a new blockchain is started, Tenderdash calls
`InitChain`. From then on, method `FinalizeBlock` is executed at the end of each
block, resulting in an updated Application state.
During consensus execution of a block height, before method `FinalizeBlock` is
-called, methods `PrepareProposal`, `ProcessProposal`, `ExtendVote`, and
+called, methods `PrepareProposal`, `ProcessProposal`, `ApplyBlockRandomness`, `ExtendVote`, and
`VerifyVoteExtension` may be called several times.
See [Tenderdash's expected behavior](expected-behavior.md)
for details on the possible call sequences of these methods.
@@ -57,6 +57,11 @@ for details on the possible call sequences of these methods.
* [**ProcessProposal:**](methods.md#processproposal) Executes a candidate deterministically
and returns its status and commitments. Processing precedes the lock-based voting
decision and can repeat when validating a commit from another round.
+* [**ApplyBlockRandomness:**](methods.md#applyblockrandomness) From consensus version 2, it hands the
+ Application the random beacon of a block and round, recovered from the Prevotes, and the Application
+ applies it to the candidate state that `ProcessProposal` left for that block and round. Tenderdash calls
+ it before `ExtendVote` and before signing a Precommit for the block, and may call it for rounds that
+ never commit, so it must not modify the committed state.
* [**ExtendVote:**](methods.md#extendvote) Supplies the extensions for a non-nil precommit.
It can also run on an observer after a rejected commit, without signing a vote.
* [**VerifyVoteExtension:**](methods.md#verifyvoteextension) Checks a peer's precommit
@@ -146,9 +151,10 @@ for the actual fields, defaults and scheduling rules.
Application processing must produce deterministic consensus commitments for a
block, round and last committed state. `PrepareProposal` constructs a candidate;
`ProcessProposal` verifies its current-block application/results hashes and
-next-state commitments. Candidate changes must not replace committed application
-state until `FinalizeBlock` persists the decided candidate. There is no subsequent
-ABCI `Commit` call.
+next-state commitments. `ApplyBlockRandomness` applies a block's randomness to its
+candidate. Candidate changes must not replace committed application state until
+`FinalizeBlock` persists the decided candidate. There is no subsequent ABCI `Commit`
+call.
Processing can revisit the same block and round after another execution context
has replaced it. Commit verification can also call `ExtendVote` without signing
diff --git a/spec/abci/expected-behavior.md b/spec/abci/expected-behavior.md
index edb1b2f17b..f8460d234a 100644
--- a/spec/abci/expected-behavior.md
+++ b/spec/abci/expected-behavior.md
@@ -21,9 +21,11 @@ succeeds in round zero. Its ordinary application calls are:
| --- | --- |
| Proposer creating a fresh block | `PrepareProposal` supplies transactions, same-block application/results hashes and next-state changes. A reused valid block does not require another `PrepareProposal`. |
| Processing before voting or commit application | `ProcessProposal` for the block and the round being checked, unless that exact result is already current. |
+| Validator signing a non-nil precommit, from consensus version 2 | `ApplyBlockRandomness` with the beacon recovered from the round's Prevotes, before `ExtendVote`. Before version 2 it is never called. |
| Validator signing a non-nil precommit | `ExtendVote` after processing for that round. Nil precommits and prevotes carry no extensions. |
| Peer non-nil precommit | `VerifyVoteExtension` with the validator's pro-tx-hash, after signature verification. |
| Commit, on any full node | `VerifyVoteExtension` with an empty validator pro-tx-hash, after processing for the commit round. |
+| Commit, on any full node, from consensus version 2 | `ApplyBlockRandomness` with the commit's beacon, before verifying the commit and again before `FinalizeBlock`. |
| Accepted decided block | `FinalizeBlock` persists the candidate corresponding to that block and round. |
These are not exact per-height callback counts. A node can finish on a commit
@@ -83,6 +85,10 @@ Keep speculative execution as candidate state; publish and persist it only when
`propose_next_block_immediately`; it returns neither `AppHash`, transaction results,
nor events. Block/transaction events belong to `ProcessProposal` results; see
[Events](basic-concepts.md#events).
+From consensus version 2, the state `FinalizeBlock` persists also has the block's
+randomness applied, and its root is the app hash `ApplyBlockRandomness` returned,
+which the commit carries. An Application that uses no randomness returns the app hash
+`ProcessProposal` returned for the block and round, without changing any state.
An Application returning no vote extensions must accept an empty expected commit
vector and reject a nonempty one at commit-level verification. Other Applications
diff --git a/spec/abci/methods.md b/spec/abci/methods.md
index 880c016acf..fe518065c3 100644
--- a/spec/abci/methods.md
+++ b/spec/abci/methods.md
@@ -452,6 +452,10 @@ changed the execution context; see
round, to learn the vector a commit of that block and round must carry; see
[VerifyVoteExtension](#verifyvoteextension). An ABCI error or an invalid response from this
call is fatal, as on the Precommit path.
+* From consensus version 2, Tenderdash calls [ApplyBlockRandomness](#applyblockrandomness) before
+ `ExtendVote`, but the extensions MUST NOT depend on the beacon or on the state `ApplyBlockRandomness`
+ produced: other processes verify them against the state `ProcessProposal` left, possibly before they
+ recover the round's beacon, or without ever recovering it.
#### When does Tenderdash call it?
@@ -551,6 +555,58 @@ requires acceptance before saving/finalizing the block. Replacement candidates a
stored-block replay have different retry behavior, as described in the usage
contract above and [Commit handling](../consensus/consensus-commit.md).
+### ApplyBlockRandomness
+
+#### Parameters and Types
+
+* **Request**:
+
+ | Name | Type | Description | Field Number |
+ |--------|-------|--------------------------------------------------------------------------|--------------|
+ | hash | bytes | The header hash of the block the Prevotes are for. | 1 |
+ | height | int64 | Height of the block. | 2 |
+ | round | int32 | Round whose Prevotes produced the beacon. | 3 |
+ | beacon | bytes | 96-byte BLS threshold signature recovered from the Prevotes of `round`. | 4 |
+
+* **Response**:
+
+ | Name | Type | Description | Field Number |
+ |----------|-------|----------------------------------------------------------------------------|--------------|
+ | app_hash | bytes | App hash after the randomness is applied; the hash the Precommits sign. | 1 |
+
+#### Usage
+
+* Used from consensus version 2 (`VersionParams.consensus_version`). Before that, Tenderdash never calls it.
+ This release never calls it, at any consensus version.
+* The beacon is the BLS threshold signature recovered from the Prevotes of round `round` for block `hash`.
+ Every set of threshold shares recovers the same bytes, and nobody can compute them before the Prevotes exist.
+ Tenderdash verifies the beacon against the quorum's threshold public key before the call.
+* The Application applies the randomness to the state that `ProcessProposal` (or `PrepareProposal`) left for
+ that block and round, and returns the resulting app hash. When nothing in the block uses randomness, it
+ returns the header app hash.
+* The header keeps the app hash from `ProcessProposal`, which Prevotes sign. Precommits and the commit sign the
+ returned app hash, and the commit carries it with the beacon (`Commit.app_hash`, `Commit.beacon`, and
+ `CommitInfo.app_hash`, `CommitInfo.beacon` in `RequestFinalizeBlock`).
+* The randomness may change only the application state behind `app_hash`. Transaction results, events,
+ validator set updates, consensus parameter updates and the other outputs of `ProcessProposal` are fixed by
+ the header the Prevotes signed: they MUST NOT depend on the beacon, and Tenderdash keeps the ones
+ `ProcessProposal` returned.
+* Vote extensions and their verification MUST NOT depend on the beacon or on the state this call produces;
+ see [ExtendVote](#extendvote).
+* The implementation MUST be deterministic, and MUST return the same `app_hash` when called again for the same
+ block, round and beacon.
+* It MUST NOT modify the committed state: Tenderdash may call it for a round that never commits, and
+ `FinalizeBlock` commits the state for the commit round.
+* An ABCI error is fatal, as for `ExtendVote`.
+
+#### When does Tenderdash call it?
+
+* On a validator, once the Prevotes of round _r_ for block _v_ reach the threshold and their signature is
+ recovered, before `ExtendVote` and before signing its Precommit for _v_.
+* On every path that finalizes a block from a commit (consensus, block sync, replay, a node that did not
+ vote): after `ProcessProposal` of the committed block for the commit round, with the commit's beacon, and
+ before `FinalizeBlock`. Tenderdash compares the returned `app_hash` with the commit's and stops on a mismatch.
+
### FinalizeBlock
#### Parameters and Types
@@ -594,6 +650,11 @@ contract above and [Commit handling](../consensus/consensus-commit.md).
The Application must select the candidate matching the finalized block and
the round processed last; a block hash alone does not identify a round's
execution context. See [Commit validity depends on the application](../consensus/consensus-commit.md#commit-validity-depends-on-the-application).
+* From consensus version 2, the state to commit is the candidate state of the block for
+ `RequestFinalizeBlock.round` with `RequestFinalizeBlock.commit.beacon` applied, as
+ [ApplyBlockRandomness](#applyblockrandomness) applies it, and its Merkle root hash MUST equal
+ `RequestFinalizeBlock.commit.app_hash`. Committing the candidate state without the randomness diverges
+ from the rest of the network.
#### When does Tenderdash call it?
diff --git a/spec/consensus/consensus-commit.md b/spec/consensus/consensus-commit.md
index 6fa6708e15..23d266fa14 100644
--- a/spec/consensus/consensus-commit.md
+++ b/spec/consensus/consensus-commit.md
@@ -5,7 +5,8 @@ order: 6
# Commit handling
A *commit* for height `h` is `(Height, Round, BlockID, QuorumHash,
-ThresholdBlockSignature, ThresholdVoteExtensions)` (`types.Commit`). A node
+ThresholdBlockSignature, ThresholdVoteExtensions, Beacon, AppHash)` (`types.Commit`); Beacon and
+AppHash are set from consensus version 2 and are not covered by the signature. A node
obtains one in two ways:
1. **locally**, from its own precommit vote set once the threshold signature
diff --git a/spec/consensus/consensus.md b/spec/consensus/consensus.md
index ce3226aed2..db80a2e886 100644
--- a/spec/consensus/consensus.md
+++ b/spec/consensus/consensus.md
@@ -69,7 +69,7 @@ numbers are omitted because they drift.
| **POLRound** | The round whose polka a proposal claims as justification; `-1` when the proposal claims none. | `types.Proposal.POLRound` |
| **BlockID** | `(Hash, PartSetHeader, StateID)`. Nil block id = all three empty. | `types/block.go`, `types/block_meta.go` |
| **StateID** | Hash of `{AppVersion, Height, AppHash, CoreChainLockedHeight, Time}` of the block header; the app hash is the state **after** executing that block (same-block execution). | `Header.StateID` in `types/block.go` |
-| **Commit** | `(Height, Round, BlockID, QuorumHash, ThresholdBlockSignature, ThresholdVoteExtensions)`: a single aggregate BLS threshold signature plus one threshold signature per threshold-recoverable vote extension. There are no per-validator signatures in a commit. | `types.Commit` in `types/block.go` |
+| **Commit** | `(Height, Round, BlockID, QuorumHash, ThresholdBlockSignature, ThresholdVoteExtensions, Beacon, AppHash)`: a single aggregate BLS threshold signature plus one threshold signature per threshold-recoverable vote extension. There are no per-validator signatures in a commit. Beacon and AppHash, set from consensus version 2, are not covered by the signature; before it, nodes drop them where they adopt a commit. | `types.Commit` in `types/block.go` |
| **Locked block / round** | The block the node precommitted most recently and the round it did so; `-1`/nil when none. | `RoundState.LockedRound/LockedBlock` |
| **Valid block / round** | The most recent block (and round) for which the node saw a polka in a round `≥` any previous one. | `RoundState.ValidRound/ValidBlock` |
| **CurrentRoundState** | The application's answer to the latest `PrepareProposal`/`ProcessProposal` for the block held in `ProposalBlock`, tagged with the round it was processed for. | `RoundState.CurrentRoundState`, `RoundState.ProcessedBlockID`; `processedFor` in `internal/consensus/block_executor.go` |
diff --git a/spec/core/data_structures.md b/spec/core/data_structures.md
index 624af59a13..85c0b08f1d 100644
--- a/spec/core/data_structures.md
+++ b/spec/core/data_structures.md
@@ -55,7 +55,7 @@ and a list of evidence of malfeasance (ie. signing conflicting votes).
| Header | [Header](#header) | Header corresponding to the block. This field contains information used throughout consensus and other areas of the protocol. To find out what it contains, visit [header] (#header) | Must adhere to the validation rules of [header](#header) |
| Data | [Data](#data) | Data contains a list of transactions. The contents of the transaction is unknown to Tenderdash. | This field can be empty or populated, but no validation is performed. Applications can perform validation on individual transactions prior to block creation using [checkTx](../abci/methods.md#checktx). |
| Evidence | [EvidenceList](#evidencelist) | Evidence contains a list of infractions committed by validators. | Can be empty, but when populated the validations rules from [evidenceList](#evidencelist) apply |
-| LastCommit | [Commit](#commit) | The threshold-signed commit of the previous block. | Must not be nil, must carry no threshold block signature at the initial height, and must adhere to the validation rules of [commit](#commit). |
+| LastCommit | [Commit](#commit) | The threshold-signed commit of the previous block. | Must not be nil, must carry no threshold block signature at the initial height, and must adhere to the validation rules of [commit](#commit), except for Beacon and AppHash: a LastCommit whose Beacon or AppHash breaks their rule, or does not have the bytes wire type, is read without both instead of refused, as releases that do not know the fields skip them. |
| CoreChainLock | `CoreChainLock` (optional) | Core chain lock carried by the block. | When present, must pass `CoreChainLock.ValidateBasic`. |
## Execution
@@ -162,6 +162,8 @@ Commit proves that a quorum decided a block: it carries the threshold-recovered
| QuorumHash | slice of bytes (`[]byte`) | Hash of the quorum that signed the commit. | |
| ThresholdBlockSignature | [Signature](#signature) | Threshold-recovered block signature. | At height >= 1, must be of length 96 |
| ThresholdVoteExtensions | Array of [VoteExtension](#voteextension) | Threshold-recovered vote extensions. | No nil entries; every type must be a defined enum value |
+| Beacon | slice of bytes (`[]byte`) | Random beacon: the threshold signature recovered from the prevotes of the commit round. Set from consensus version 2; empty before. Not covered by the commit's signature. | Must be empty with an empty AppHash, or 96 bytes with a 32-byte AppHash |
+| AppHash | slice of bytes (`[]byte`) | App hash returned by `ApplyBlockRandomness` for the block and round, which the precommits sign through `BlockID.StateID`. Set from consensus version 2; empty before. Not covered by the commit's signature. | Must be empty with an empty Beacon, or 32 bytes with a 96-byte Beacon |
## BlockIDFlag
diff --git a/types/block.go b/types/block.go
index 7d281e4cb5..9b308d73b2 100644
--- a/types/block.go
+++ b/types/block.go
@@ -337,7 +337,7 @@ func BlockFromProto(bp *tmproto.Block) (*Block, error) {
b.CoreChainLock = coreChainLock
if bp.LastCommit != nil {
- lc, err := CommitFromProto(bp.LastCommit)
+ lc, err := CommitFromProto(lastCommitWithoutMalformedRandomness(bp.LastCommit))
if err != nil {
return nil, err
}
@@ -347,6 +347,23 @@ func BlockFromProto(bp *tmproto.Block) (*Block, error) {
return b, b.ValidateBasic()
}
+// lastCommitWithoutMalformedRandomness returns the block's LastCommit without its beacon and app hash
+// when they do not have the sizes ValidateBasic requires, and cp itself otherwise.
+//
+// A block's LastCommit is not refused for them, unlike a commit received on its own: releases before
+// these fields skip them as unknown, so they accept such a block, and an upgraded node refusing it
+// would split from them. Neither field is covered by the block hash, and dropping them here keeps
+// them from being read, stored in the decoded block, or passed on.
+func lastCommitWithoutMalformedRandomness(cp *tmproto.Commit) *tmproto.Commit {
+ if validRandomBeaconSizes(cp.Beacon, cp.AppHash) {
+ return cp
+ }
+ stripped := *cp
+ stripped.Beacon = nil
+ stripped.AppHash = nil
+ return &stripped
+}
+
//-----------------------------------------------------------------------------
// MaxDataBytes returns the maximum size of block's data.
@@ -747,10 +764,24 @@ const (
// (110+2) for BlockID, (8+2) for Height, (4+2) for Round,
// (32+2) for QuorumHash, (96+2) for Block signature.
MaxCommitOverheadBytes int64 = (110 + 2) + (8 + 2) + (4 + 2) + (32 + 2) + (96 + 2) + 0
+ // MaxCommitRandomnessBytes is what a commit grows by when it carries a random beacon (consensus
+ // version 2): (96+2) for Beacon, (32+2) for AppHash.
+ MaxCommitRandomnessBytes int64 = (96 + 2) + (32 + 2)
)
//-------------------------------------
+// ErrInvalidCommitRandomness is returned for a commit whose beacon and app hash are neither both empty
+// nor exactly a threshold signature and an app hash.
+var ErrInvalidCommitRandomness = errors.New("invalid commit beacon or app hash size")
+
+// validRandomBeaconSizes reports whether a commit's beacon and app hash are both empty, or a threshold
+// signature and an app hash: the only forms a commit can carry them in.
+func validRandomBeaconSizes(beacon, appHash []byte) bool {
+ return (len(beacon) == 0 && len(appHash) == 0) ||
+ (len(beacon) == SignatureSize && len(appHash) == crypto.DefaultAppHashSize)
+}
+
// Commit contains the evidence that a block was committed by a set of validators.
// NOTE: Commit is empty for height 1, but never nil.
type Commit struct {
@@ -765,6 +796,13 @@ type Commit struct {
ThresholdBlockSignature []byte `json:"threshold_block_signature"`
// ThresholdVoteExtensions keeps the list of recovered threshold signatures for vote-extensions
ThresholdVoteExtensions tmproto.VoteExtensions `json:"threshold_vote_extensions"`
+ // Beacon is the threshold signature recovered from the prevotes of the commit round.
+ // Set from consensus version 2; empty before.
+ Beacon []byte `json:"beacon,omitempty"`
+ // AppHash is the result of ApplyBlockRandomness for this block and round. The precommits sign it
+ // only through BlockID.StateID, the hash of the header's state ID with this app hash: the field
+ // itself is not signed. Set from consensus version 2; empty before.
+ AppHash tmbytes.HexBytes `json:"app_hash,omitempty"`
// Memoized in first call to corresponding method.
// NOTE: can't memoize in constructor because constructor isn't used for
@@ -797,9 +835,25 @@ func (commit *Commit) ToCommitInfo() types.CommitInfo {
QuorumHash: commit.QuorumHash,
BlockSignature: commit.ThresholdBlockSignature,
ThresholdVoteExtensions: commit.ThresholdVoteExtensions,
+ Beacon: commit.Beacon,
+ AppHash: commit.AppHash,
}
}
+// WithoutRandomBeacon returns commit without its random beacon and app hash. Before consensus version 2
+// both fields must be empty, but neither is covered by the commit's threshold signature, so a peer could
+// fill them; nodes drop them from commits of such heights instead of storing or passing them on. It
+// returns commit itself when both are already empty.
+func (commit *Commit) WithoutRandomBeacon() *Commit {
+ if commit == nil || (len(commit.Beacon) == 0 && len(commit.AppHash) == 0) {
+ return commit
+ }
+ stripped := *commit
+ stripped.Beacon = nil
+ stripped.AppHash = nil
+ return &stripped
+}
+
// GetCanonicalVote returns the message that is being voted on in the form of a vote without signatures.
// It returns an error if the commit carries a vote extension of an unknown type.
func (commit *Commit) GetCanonicalVote() (*Vote, error) {
@@ -893,6 +947,15 @@ func (commit *Commit) ValidateBasic() error {
}
}
+ // Neither field is covered by the commit hash or its threshold signature, so a peer can fill them
+ // in a commit it relays. Bounding them here refuses a commit with wrongly sized ones before it is
+ // stored or passed to the application, whatever the consensus version; before consensus version 2,
+ // nodes also drop well-sized ones where they adopt a commit (see WithoutRandomBeacon).
+ if !validRandomBeaconSizes(commit.Beacon, commit.AppHash) {
+ return fmt.Errorf("%w: beacon of %d bytes and app hash of %d bytes, expected both empty or %d and %d bytes",
+ ErrInvalidCommitRandomness, len(commit.Beacon), len(commit.AppHash), SignatureSize, crypto.DefaultAppHashSize)
+ }
+
// Reject extension types nothing can dispatch on: proto3's open enums let an
// undefined varint decode untouched, and no other check rejects it. Type only —
// each extension's contents are covered by its own threshold signature.
@@ -953,12 +1016,14 @@ func (commit *Commit) String() string {
return "nil-Commit"
}
return fmt.Sprintf(
- `Commit{H: %d, R: %d, BlockID: %v, QuorumHash %v, BlockSignature: %v}#%v`,
+ `Commit{H: %d, R: %d, BlockID: %v, QuorumHash %v, BlockSignature: %v, Beacon: %v, AppHash: %v}#%v`,
commit.Height,
commit.Round,
commit.BlockID,
commit.QuorumHash,
base64.StdEncoding.EncodeToString(commit.ThresholdBlockSignature),
+ base64.StdEncoding.EncodeToString(commit.Beacon),
+ commit.AppHash,
commit.hash)
}
@@ -972,11 +1037,15 @@ func (commit *Commit) StringIndented(indent string) string {
%s Round: %d
%s BlockID: %v
%s BlockSignature: %v
+%s Beacon: %v
+%s AppHash: %v
%s}#%v`,
indent, commit.Height,
indent, commit.Round,
indent, commit.BlockID,
indent, base64.StdEncoding.EncodeToString(commit.ThresholdBlockSignature),
+ indent, base64.StdEncoding.EncodeToString(commit.Beacon),
+ indent, commit.AppHash,
indent, commit.hash)
}
@@ -987,6 +1056,8 @@ func (commit *Commit) MarshalZerologObject(e *zerolog.Event) {
e.Int32("round", commit.Round)
e.Str("BlockID.Hash", commit.BlockID.Hash.String())
e.Str("BlockSignature", hex.EncodeToString(commit.ThresholdBlockSignature))
+ e.Str("Beacon", hex.EncodeToString(commit.Beacon))
+ e.Str("AppHash", commit.AppHash.String())
}
}
@@ -1005,6 +1076,8 @@ func (commit *Commit) ToProto() *tmproto.Commit {
c.ThresholdBlockSignature = commit.ThresholdBlockSignature
c.ThresholdVoteExtensions = commit.ThresholdVoteExtensions
c.QuorumHash = commit.QuorumHash
+ c.Beacon = commit.Beacon
+ c.AppHash = commit.AppHash
return c
}
@@ -1031,6 +1104,8 @@ func CommitFromProto(cp *tmproto.Commit) (*Commit, error) {
commit.QuorumHash = cp.QuorumHash
commit.ThresholdBlockSignature = cp.ThresholdBlockSignature
commit.ThresholdVoteExtensions = cp.ThresholdVoteExtensions
+ commit.Beacon = cp.Beacon
+ commit.AppHash = cp.AppHash
commit.Height = cp.Height
commit.Round = cp.Round
diff --git a/types/block_decode.go b/types/block_decode.go
new file mode 100644
index 0000000000..4a00f9c458
--- /dev/null
+++ b/types/block_decode.go
@@ -0,0 +1,190 @@
+package types
+
+import (
+ "github.com/cosmos/gogoproto/proto"
+ "google.golang.org/protobuf/encoding/protowire"
+
+ tmproto "github.com/dashpay/tenderdash/proto/tendermint/types"
+)
+
+// Field numbers of tendermint.types.Block.last_commit and of tendermint.types.Commit.beacon and
+// app_hash.
+const (
+ blockLastCommitField protowire.Number = 4
+ commitBeaconField protowire.Number = 7
+ commitAppHashField protowire.Number = 8
+ commitRandomnessWType = protowire.BytesType
+)
+
+// UnmarshalBlockProto decodes the bytes of a block, as joined from its parts.
+//
+// The beacon and app hash fields of a commit (fields 7 and 8) are unknown to releases before them,
+// which skip them whatever their wire type. A block whose LastCommit carries one of them with another
+// wire type is therefore valid to those releases, which can commit and store it, while strict
+// decoding refuses it. Such occurrences are dropped here, so an upgraded node decodes every block an
+// older one does. Blocks without them decode exactly as with proto.Unmarshal.
+func UnmarshalBlockProto(bz []byte) (*tmproto.Block, error) {
+ pb := new(tmproto.Block)
+ err := proto.Unmarshal(bz, pb)
+ if err == nil {
+ return pb, nil
+ }
+ cleaned, dropped := dropMistypedLastCommitRandomness(bz)
+ if !dropped {
+ return nil, err
+ }
+ pb = new(tmproto.Block)
+ if err := proto.Unmarshal(cleaned, pb); err != nil {
+ return nil, err
+ }
+ return pb, nil
+}
+
+// dropMistypedLastCommitRandomness returns the block bytes bz without the occurrences of the
+// LastCommit beacon and app hash fields that do not have the bytes wire type, and whether there were
+// any. It splits the bytes into fields as the generated decoder does, and returns false where that
+// decoder fails. It allocates nothing before the first field it drops, and then only the bytes it
+// returns.
+func dropMistypedLastCommitRandomness(bz []byte) ([]byte, bool) {
+ var out []byte
+ for i := 0; i < len(bz); {
+ num, typ, n, ok := consumeGeneratedField(bz[i:])
+ if !ok {
+ return nil, false
+ }
+ field := bz[i : i+n]
+ if num == blockLastCommitField && typ == protowire.BytesType {
+ _, tagLen := proto.DecodeVarint(field)
+ _, lenLen := proto.DecodeVarint(field[tagLen:])
+ commit := field[tagLen+lenLen:]
+ if kept, ok := keptCommitLength(commit); ok && kept < len(commit) {
+ if out == nil {
+ out = append(make([]byte, 0, len(bz)), bz[:i]...)
+ }
+ out = protowire.AppendTag(out, num, typ)
+ out = protowire.AppendVarint(out, uint64(kept)) //nolint:gosec // a length, never negative
+ out = appendKeptCommitFields(out, commit)
+ i += n
+ continue
+ }
+ }
+ if out != nil {
+ out = append(out, field...)
+ }
+ i += n
+ }
+ return out, out != nil
+}
+
+// keptCommitLength returns the length of the commit bytes bz without the beacon and app hash fields
+// that do not have the bytes wire type, and false where the generated decoder fails.
+func keptCommitLength(bz []byte) (int, bool) {
+ kept := 0
+ for len(bz) > 0 {
+ num, typ, n, ok := consumeGeneratedField(bz)
+ if !ok {
+ return 0, false
+ }
+ if !mistypedCommitRandomness(num, typ) {
+ kept += n
+ }
+ bz = bz[n:]
+ }
+ return kept, true
+}
+
+// appendKeptCommitFields appends to out the fields of the commit bytes bz that keptCommitLength
+// counts.
+func appendKeptCommitFields(out, bz []byte) []byte {
+ for len(bz) > 0 {
+ num, typ, n, ok := consumeGeneratedField(bz)
+ if !ok {
+ break
+ }
+ if !mistypedCommitRandomness(num, typ) {
+ out = append(out, bz[:n]...)
+ }
+ bz = bz[n:]
+ }
+ return out
+}
+
+// mistypedCommitRandomness reports whether a commit field is a beacon or an app hash without the bytes
+// wire type.
+func mistypedCommitRandomness(num protowire.Number, typ protowire.Type) bool {
+ return (num == commitBeaconField || num == commitAppHashField) && typ != commitRandomnessWType
+}
+
+// consumeGeneratedField returns the number, the wire type and the length, tag included, of the field at
+// the start of bz, as the Unmarshal methods that gogoproto generates read a field they skip: the
+// field number is the tag shifted right by 3 and truncated to 32 bits. It returns false where those
+// methods fail. Varints are read with proto.DecodeVarint, which, like those methods and unlike
+// protowire, drops the bits of a tenth byte past the 64th instead of failing.
+//
+// Releases before the beacon skip fields 7 and 8 of a commit with these rules, which accept more than
+// protowire does, so the bytes must be split with the same rules to drop exactly those fields.
+func consumeGeneratedField(bz []byte) (protowire.Number, protowire.Type, int, bool) {
+ tag, n := proto.DecodeVarint(bz)
+ if n == 0 {
+ return 0, 0, 0, false
+ }
+ num, typ := protowire.Number(int32(tag>>3)), protowire.Type(tag&0x7) //nolint:gosec // truncated as generated code does
+ if typ == protowire.EndGroupType || num <= 0 {
+ return 0, 0, 0, false
+ }
+ n, ok := skipGeneratedField(bz)
+ if !ok || n > len(bz) {
+ return 0, 0, 0, false
+ }
+ return num, typ, n, true
+}
+
+// skipGeneratedField returns the length, tag included, of the field at the start of bz, computed as
+// the skip functions that gogoproto generates compute it. The length may exceed len(bz), which the
+// caller checks. A group ends at the first end-group tag that brings the nesting depth back to zero,
+// whatever its field number.
+func skipGeneratedField(bz []byte) (int, bool) {
+ i, depth := 0, 0
+ for i < len(bz) {
+ tag, n := proto.DecodeVarint(bz[i:])
+ if n == 0 {
+ return 0, false
+ }
+ i += n
+ switch protowire.Type(tag & 0x7) {
+ case protowire.VarintType:
+ _, n := proto.DecodeVarint(bz[i:])
+ if n == 0 {
+ return 0, false
+ }
+ i += n
+ case protowire.Fixed64Type:
+ i += 8
+ case protowire.BytesType:
+ length, n := proto.DecodeVarint(bz[i:])
+ size := int(length) //nolint:gosec // wraps as the int length of generated code does
+ if n == 0 || size < 0 {
+ return 0, false
+ }
+ i += n + size
+ case protowire.StartGroupType:
+ depth++
+ case protowire.EndGroupType:
+ if depth == 0 {
+ return 0, false
+ }
+ depth--
+ case protowire.Fixed32Type:
+ i += 4
+ default:
+ return 0, false
+ }
+ if i < 0 {
+ return 0, false
+ }
+ if depth == 0 {
+ return i, true
+ }
+ }
+ return 0, false
+}
diff --git a/types/block_decode_test.go b/types/block_decode_test.go
new file mode 100644
index 0000000000..ab71d50617
--- /dev/null
+++ b/types/block_decode_test.go
@@ -0,0 +1,78 @@
+package types
+
+import (
+ "testing"
+
+ "github.com/cosmos/gogoproto/proto"
+ gogotypes "github.com/cosmos/gogoproto/types"
+ "github.com/stretchr/testify/require"
+
+ "github.com/dashpay/tenderdash/crypto"
+ tmproto "github.com/dashpay/tenderdash/proto/tendermint/types"
+)
+
+// TestUnmarshalBlockProtoMistypedLastCommitRandomness checks that a block whose LastCommit carries the
+// beacon or app hash field with a wire type other than bytes decodes as releases before those fields
+// decode it, without them, instead of failing: such a block is valid to those releases, which can
+// commit it while upgraded nodes could not read it.
+func TestUnmarshalBlockProtoMistypedLastCommitRandomness(t *testing.T) {
+ block := MakeBlock(3, []Tx{Tx("tx")}, &Commit{
+ Height: 2,
+ BlockID: makeBlockIDRandom(),
+ ThresholdBlockSignature: make([]byte, SignatureSize),
+ }, nil)
+ block.ProposerProTxHash = crypto.RandProTxHash()
+ block.ValidatorsHash = crypto.CRandBytes(crypto.HashSize)
+ pb, err := block.ToProto()
+ require.NoError(t, err)
+ bz, err := pb.Marshal()
+ require.NoError(t, err)
+
+ plain, err := UnmarshalBlockProto(bz)
+ require.NoError(t, err)
+ require.True(t, proto.Equal(pb, plain), "a block without such fields decodes as with proto.Unmarshal")
+
+ // Each suffix is another occurrence of last_commit (field 4), which protobuf merges into the first.
+ // Releases before the beacon read its content as a message that knows none of its fields, which
+ // gogotypes.Empty stands for: their generated decoder skips fields 7 and 8 as Empty's does.
+ for name, suffix := range map[string][]byte{
+ "beacon as varint": {0x22, 0x02, 0x38, 0x01}, // field 7, wire type 0
+ "app hash as fixed32": {0x22, 0x05, 0x45, 0x01, 0x02, 0x03, 0x04}, // field 8, wire type 5
+ "beacon as fixed64": {0x22, 0x09, 0x39, 1, 2, 3, 4, 5, 6, 7, 8}, // field 7, wire type 1
+ // field 7 start-group closed by a field 8 end-group: the generated skip does not match them
+ "beacon as group closed by app hash": {0x22, 0x02, 0x3b, 0x44},
+ // field 7, wire type 0, a ten-byte varint whose last byte overflows 64 bits
+ "beacon as overflowing varint": {0x22, 0x0b, 0x38, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x02},
+ // field 8 group holding a varint and an empty field 7 group
+ "app hash as nested group": {0x22, 0x06, 0x43, 0x08, 0x01, 0x3b, 0x3c, 0x44},
+ } {
+ t.Run(name, func(t *testing.T) {
+ require.NoError(t, new(gogotypes.Empty).Unmarshal(suffix[2:]), "releases before the beacon accept it")
+ raw := append(append([]byte{}, bz...), suffix...)
+ var strict tmproto.Block
+ require.Error(t, proto.Unmarshal(raw, &strict), "strict decoding refuses it")
+
+ decoded, err := UnmarshalBlockProto(raw)
+ require.NoError(t, err)
+ require.True(t, proto.Equal(pb, decoded), "decodes to the block without the mistyped field")
+ got, err := BlockFromProto(decoded)
+ require.NoError(t, err)
+ require.Equal(t, block.Hash(), got.Hash())
+ })
+ }
+
+ for name, suffix := range map[string][]byte{
+ "truncated": {0x22, 0x05, 0x38},
+ "end-group without start": {0x22, 0x01, 0x3c},
+ "unclosed group": {0x22, 0x01, 0x3b},
+ "end-group past the group": {0x22, 0x03, 0x3b, 0x3c, 0x44},
+ // field 7, wire type 0, an eleven-byte varint
+ "varint past ten bytes": {0x22, 0x0c, 0x38, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x01},
+ } {
+ t.Run(name, func(t *testing.T) {
+ require.Error(t, new(gogotypes.Empty).Unmarshal(suffix[2:]), "releases before the beacon refuse it")
+ _, err := UnmarshalBlockProto(append(append([]byte{}, bz...), suffix...))
+ require.Error(t, err, "still refused")
+ })
+ }
+}
diff --git a/types/block_test.go b/types/block_test.go
index a65a2f20a0..b736aced6f 100644
--- a/types/block_test.go
+++ b/types/block_test.go
@@ -18,6 +18,7 @@ import (
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
+ abci "github.com/dashpay/tenderdash/abci/types"
"github.com/dashpay/tenderdash/crypto"
"github.com/dashpay/tenderdash/crypto/bls12381"
"github.com/dashpay/tenderdash/crypto/merkle"
@@ -314,6 +315,45 @@ func TestCommit(t *testing.T) {
assert.True(t, commit.IsCommit())
}
+// TestCommitBeaconFields checks that the beacon and the app hash of a commit survive protobuf
+// encoding and decoding, reach the CommitInfo passed to the application, and show in the commit's
+// string form.
+func TestCommitBeaconFields(t *testing.T) {
+ commit := &Commit{
+ Height: 3,
+ Round: 1,
+ BlockID: BlockID{
+ Hash: crypto.Checksum([]byte("block")),
+ PartSetHeader: PartSetHeader{Total: 1, Hash: crypto.Checksum([]byte("parts"))},
+ StateID: RandStateID().Hash(),
+ },
+ QuorumHash: crypto.RandQuorumHash(),
+ ThresholdBlockSignature: crypto.CRandBytes(SignatureSize),
+ Beacon: crypto.CRandBytes(SignatureSize),
+ AppHash: crypto.Checksum([]byte("final app hash")),
+ }
+
+ bz, err := commit.ToProto().Marshal()
+ require.NoError(t, err)
+ var pb tmproto.Commit
+ require.NoError(t, pb.Unmarshal(bz))
+ decoded, err := CommitFromProto(&pb)
+ require.NoError(t, err)
+ require.Equal(t, commit, decoded)
+
+ info := commit.ToCommitInfo()
+ assert.Equal(t, commit.Beacon, info.Beacon)
+ assert.EqualValues(t, commit.AppHash, info.AppHash)
+ bz, err = info.Marshal()
+ require.NoError(t, err)
+ var decodedInfo abci.CommitInfo
+ require.NoError(t, decodedInfo.Unmarshal(bz))
+ require.Equal(t, info, decodedInfo)
+
+ assert.Contains(t, commit.String(), commit.AppHash.String())
+ assert.Contains(t, commit.StringIndented(""), commit.AppHash.String())
+}
+
func TestCommitValidateBasic(t *testing.T) {
const height int64 = 5
testCases := []struct {
@@ -357,6 +397,8 @@ func TestMaxCommitBytes(t *testing.T) {
},
QuorumHash: crypto.Checksum([]byte("QuorumHash")),
ThresholdBlockSignature: crypto.CRandBytes(SignatureSize),
+ Beacon: crypto.CRandBytes(SignatureSize),
+ AppHash: crypto.Checksum([]byte("AppHash")),
}
bIDProto := commit.BlockID.ToProto()
@@ -364,7 +406,10 @@ func TestMaxCommitBytes(t *testing.T) {
pb := commit.ToProto()
pbSize := int64(pb.Size())
- assert.EqualValues(t, MaxCommitOverheadBytes, pbSize)
+ assert.EqualValues(t, MaxCommitOverheadBytes+MaxCommitRandomnessBytes, pbSize)
+
+ commit.Beacon, commit.AppHash = nil, nil
+ assert.EqualValues(t, MaxCommitOverheadBytes, commit.ToProto().Size())
}
func TestHeaderHash(t *testing.T) {
@@ -1494,3 +1539,81 @@ func TestCommit_ValidateBasic_RejectsUnknownExtensionType(t *testing.T) {
"a nil extension must not reach a consumer that will dereference it")
require.EqualError(t, nilErr, "nil vote extension at index 0")
}
+
+// TestCommitValidateBasicRandomnessSizes checks that a commit's beacon and app hash must be both empty
+// or exactly a threshold signature and an app hash. Neither is covered by the commit hash or its
+// signature, so a peer relaying a commit can fill them with anything.
+func TestCommitValidateBasicRandomnessSizes(t *testing.T) {
+ testCases := map[string]struct {
+ beacon []byte
+ appHash []byte
+ valid bool
+ }{
+ "both empty": {valid: true},
+ "both set": {beacon: crypto.CRandBytes(SignatureSize), appHash: crypto.CRandBytes(crypto.DefaultAppHashSize), valid: true},
+ "beacon only": {beacon: crypto.CRandBytes(SignatureSize)},
+ "app hash only": {appHash: crypto.CRandBytes(crypto.DefaultAppHashSize)},
+ "long beacon": {beacon: crypto.CRandBytes(SignatureSize + 1), appHash: crypto.CRandBytes(crypto.DefaultAppHashSize)},
+ "short app hash": {beacon: crypto.CRandBytes(SignatureSize), appHash: crypto.CRandBytes(crypto.DefaultAppHashSize - 1)},
+ "one MiB of beacon": {beacon: make([]byte, 1<<20), appHash: crypto.CRandBytes(crypto.DefaultAppHashSize)},
+ }
+ for name, tc := range testCases {
+ t.Run(name, func(t *testing.T) {
+ commit := &Commit{
+ Height: 3,
+ BlockID: makeBlockIDRandom(),
+ QuorumHash: crypto.RandQuorumHash(),
+ ThresholdBlockSignature: crypto.CRandBytes(SignatureSize),
+ Beacon: tc.beacon,
+ AppHash: tc.appHash,
+ }
+ _, err := CommitFromProto(commit.ToProto())
+ if tc.valid {
+ require.NoError(t, err)
+ } else {
+ require.ErrorIs(t, err, ErrInvalidCommitRandomness)
+ }
+ })
+ }
+}
+
+// TestBlockFromProtoMalformedLastCommitRandomness checks that a block whose LastCommit carries a beacon
+// or app hash of the wrong size is decoded without them rather than refused: releases before these
+// fields skip them, and refusing such a block would split an upgraded node from them.
+func TestBlockFromProtoMalformedLastCommitRandomness(t *testing.T) {
+ ctx, cancel := context.WithCancel(context.Background())
+ defer cancel()
+
+ lastID := makeBlockIDRandom()
+ voteSet, _, vals := randVoteSet(ctx, t, 2, 1, tmproto.PrecommitType, 4)
+ lastCommit, err := makeCommit(ctx, lastID, 2, 1, voteSet, vals)
+ require.NoError(t, err)
+ block := MakeBlock(3, []Tx{Tx("tx")}, lastCommit, nil)
+ block.ProposerProTxHash = crypto.RandProTxHash()
+ block.ValidatorsHash = crypto.CRandBytes(crypto.HashSize)
+
+ decode := func(beacon, appHash []byte) *Block {
+ t.Helper()
+ pb, err := block.ToProto()
+ require.NoError(t, err)
+ pb.LastCommit.Beacon = beacon
+ pb.LastCommit.AppHash = appHash
+ bz, err := pb.Marshal()
+ require.NoError(t, err)
+ var decoded tmproto.Block
+ require.NoError(t, decoded.Unmarshal(bz))
+ got, err := BlockFromProto(&decoded)
+ require.NoError(t, err)
+ return got
+ }
+
+ got := decode(make([]byte, 10), []byte("junk"))
+ require.Empty(t, got.LastCommit.Beacon, "a malformed beacon is dropped, not stored")
+ require.Empty(t, got.LastCommit.AppHash)
+ require.Equal(t, block.LastCommit.Hash(), got.LastCommit.Hash(), "the commit hash covers neither field")
+
+ beacon, appHash := crypto.CRandBytes(SignatureSize), crypto.CRandBytes(crypto.DefaultAppHashSize)
+ got = decode(beacon, appHash)
+ require.Equal(t, beacon, got.LastCommit.Beacon, "well-formed fields are kept")
+ require.EqualValues(t, appHash, got.LastCommit.AppHash)
+}