bor

package
v0.0.0-...-92d349b Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 15, 2023 License: GPL-3.0 Imports: 41 Imported by: 0

Documentation

Overview

Package bor is a generated GoMock package.

Package bor is a generated GoMock package.

Index

Constants

View Source 
const BorSeparate = "BorSeparate"

Variables

View Source 
var (

	// ErrInvalidTimestamp is returned if the timestamp of a block is lower than
	// the previous block's timestamp + the minimum block period.
	ErrInvalidTimestamp = errors.New("invalid timestamp")
)

Various error messages to mark blocks invalid. These should be private to prevent engine specific errors from being referenced in the remainder of the codebase, inherently breaking if the engine is swapped out. Please put common error types into the consensus package.

View Source 
var (
	// MaxCheckpointLength is the maximum number of blocks that can be requested for constructing a checkpoint root hash
	MaxCheckpointLength = uint64(math.Pow(2, 15))
)

Functions

func AppendBytes32 

func AppendBytes32(data ...[]byte) []byte

func BorRLP 

func BorRLP(header *types.Header, c *erigonchain.BorConfig) []byte

BorRLP returns the rlp bytes which needs to be signed for the bor sealing. The RLP to sign consists of the entire header apart from the 65 byte signature contained at the end of the extra data.

Note, the method requires the extra data to be at least 65 bytes, otherwise it panics. This is done to avoid accidentally using both forms (signature present or not), which could be abused to produce different hashes for the same header.

func CalcProducerDelay 

func CalcProducerDelay(number uint64, succession int, c *erigonchain.BorConfig) uint64

CalcProducerDelay is the block delay algorithm based on block time, period, producerDelay and turn-ness of a signer

func Convert 

func Convert(input [][32]byte) [][]byte

func ConvertTo32 

func ConvertTo32(input []byte) (output [32]byte, err error)

func IsBlockOnTime 

func IsBlockOnTime(parent *types.Header, header *types.Header, number uint64, succession int, cfg *erigonchain.BorConfig) bool

func NextPowerOfTwo 

func NextPowerOfTwo(n uint64) uint64

func SealHash 

func SealHash(header *types.Header, c *erigonchain.BorConfig) (hash libcommon.Hash)

SealHash returns the hash of a block prior to it being sealed.

Types

type API 

type API struct {
	// contains filtered or unexported fields
}

API is a user facing RPC API to allow controlling the signer and voting mechanisms of the proof-of-authority scheme.

func (*API) GetAuthor 

func (api *API) GetAuthor(number *rpc.BlockNumber) (*common.Address, error)

GetAuthor retrieves the author a block.

func (*API) GetCurrentProposer 

func (api *API) GetCurrentProposer() (common.Address, error)

GetCurrentProposer gets the current proposer

func (*API) GetCurrentValidators 

func (api *API) GetCurrentValidators() ([]*valset.Validator, error)

GetCurrentValidators gets the current validators

func (*API) GetRootHash 

func (api *API) GetRootHash(start uint64, end uint64) (string, error)

GetRootHash returns the merkle root of the start to end block headers

func (*API) GetSigners 

func (api *API) GetSigners(number *rpc.BlockNumber) ([]common.Address, error)

GetSigners retrieves the list of authorized signers at the specified block.

func (*API) GetSignersAtHash 

func (api *API) GetSignersAtHash(hash common.Hash) ([]common.Address, error)

GetSignersAtHash retrieves the list of authorized signers at the specified block.

func (*API) GetSnapshot 

func (api *API) GetSnapshot(number *rpc.BlockNumber) (*Snapshot, error)

GetSnapshot retrieves the state snapshot at a given block.

func (*API) GetSnapshotAtHash 

func (api *API) GetSnapshotAtHash(hash common.Hash) (*Snapshot, error)

GetSnapshotAtHash retrieves the state snapshot at a given block.

func (*API) GetSnapshotProposer 

func (api *API) GetSnapshotProposer(number *rpc.BlockNumber) (common.Address, error)

GetSnapshotProposer retrieves the in-turn signer at a given block.

func (*API) GetSnapshotProposerSequence 

func (api *API) GetSnapshotProposerSequence(number *rpc.BlockNumber) (BlockSigners, error)

GetSnapshotProposerSequence retrieves the in-turn signers of all sprints in a span

type BlockSigners 

type BlockSigners struct {
	Signers []difficultiesKV
	Diff    int
	Author  common.Address
}

type BlockTooSoonError 

type BlockTooSoonError struct {
	Number     uint64
	Succession int
}

func (*BlockTooSoonError) Error 

func (e *BlockTooSoonError) Error() string

type Bor 

type Bor struct {
	DB kv.RwDB // Database to store and retrieve snapshot checkpoints

	GenesisContractsClient GenesisContract
	HeimdallClient         IHeimdallClient
	// contains filtered or unexported fields
}

Bor is the matic-bor consensus engine

func New 

func New(
	chainConfig *chain.Config,
	db kv.RwDB,
	spanner Spanner,
	heimdallClient IHeimdallClient,
	genesisContracts GenesisContract,
) *Bor

New creates a Matic Bor consensus engine.

func (*Bor) APIs 

func (c *Bor) APIs(chain consensus.ChainHeaderReader) []rpc.API

APIs implements consensus.Engine, returning the user facing RPC API to allow controlling the signer voting.

func (*Bor) Author 

func (c *Bor) Author(header *types.Header) (libcommon.Address, error)

Author implements consensus.Engine, returning the Ethereum address recovered from the signature in the header's extra-data section. This is thread-safe (only access the header and config (which is never updated), as well as signatures, which are lru.ARCCache, which is thread-safe)

func (*Bor) Authorize 

func (c *Bor) Authorize(currentSigner libcommon.Address, signFn SignerFn)

Authorize injects a private key into the consensus engine to mint new blocks with.

func (*Bor) CalcDifficulty 

func (c *Bor) CalcDifficulty(chain consensus.ChainHeaderReader, _, _ uint64, _ *big.Int, parentNumber uint64, parentHash, _ libcommon.Hash, _ uint64) *big.Int

func (*Bor) Close 

func (c *Bor) Close() error

Close implements consensus.Engine. It's a noop for bor as there are no background threads.

func (*Bor) CommitStates 

func (c *Bor) CommitStates(
	state *state.IntraBlockState,
	header *types.Header,
	chain statefull.ChainContext,
	syscall consensus.SystemCall,
) ([]*types.StateSyncData, error)

CommitStates commit states

func (*Bor) Finalize 

func (c *Bor) Finalize(config *chain.Config, header *types.Header, state *state.IntraBlockState,
	txs types.Transactions, uncles []*types.Header, r types.Receipts, withdrawals []*types.Withdrawal,
	chain consensus.ChainHeaderReader, syscall consensus.SystemCall,
) (types.Transactions, types.Receipts, error)

Finalize implements consensus.Engine, ensuring no uncles are set, nor block rewards given.

func (*Bor) FinalizeAndAssemble 

func (c *Bor) FinalizeAndAssemble(chainConfig *chain.Config, header *types.Header, state *state.IntraBlockState,
	txs types.Transactions, uncles []*types.Header, receipts types.Receipts, withdrawals []*types.Withdrawal,
	chain consensus.ChainHeaderReader, syscall consensus.SystemCall, call consensus.Call,
) (*types.Block, types.Transactions, types.Receipts, error)

FinalizeAndAssemble implements consensus.Engine, ensuring no uncles are set, nor block rewards given, and returns the final block.

func (*Bor) GenerateSeal 

func (c *Bor) GenerateSeal(chain consensus.ChainHeaderReader, currnt, parent *types.Header, call consensus.Call) []byte

func (*Bor) GetCurrentValidators 

func (c *Bor) GetCurrentValidators(blockNumber uint64, signer libcommon.Address, getSpanForBlock func(blockNum uint64) (*span.HeimdallSpan, error)) ([]*valset.Validator, error)

func (*Bor) Initialize 

func (c *Bor) Initialize(config *chain.Config, chain consensus.ChainHeaderReader, header *types.Header,
	state *state.IntraBlockState, txs []types.Transaction, uncles []*types.Header, syscall consensus.SystemCall)

func (*Bor) IsServiceTransaction 

func (c *Bor) IsServiceTransaction(sender libcommon.Address, syscall consensus.SystemCall) bool

func (*Bor) Prepare 

func (c *Bor) Prepare(chain consensus.ChainHeaderReader, header *types.Header, state *state.IntraBlockState) error

Prepare implements consensus.Engine, preparing all the consensus fields of the header for running the transactions on top.

func (*Bor) Seal 

func (c *Bor) Seal(chain consensus.ChainHeaderReader, block *types.Block, results chan<- *types.Block, stop <-chan struct{}) error

Seal implements consensus.Engine, attempting to create a sealed block using the local signing credentials.

func (*Bor) SealHash 

func (c *Bor) SealHash(header *types.Header) libcommon.Hash

SealHash returns the hash of a block prior to it being sealed.

func (*Bor) SetHeimdallClient 

func (c *Bor) SetHeimdallClient(h IHeimdallClient)

func (*Bor) Type 

func (c *Bor) Type() erigonchain.ConsensusName

Type returns underlying consensus engine

func (*Bor) VerifyHeader 

func (c *Bor) VerifyHeader(chain consensus.ChainHeaderReader, header *types.Header, seal bool) error

VerifyHeader checks whether a header conforms to the consensus rules.

func (*Bor) VerifyHeaders 

func (c *Bor) VerifyHeaders(chain consensus.ChainHeaderReader, headers []*types.Header, _ []bool) (chan<- struct{}, <-chan error)

VerifyHeaders is similar to VerifyHeader, but verifies a batch of headers. The method returns a quit channel to abort the operations and a results channel to retrieve the async verifications (the order is that of the input slice).

func (*Bor) VerifySeal 

func (c *Bor) VerifySeal(chain consensus.ChainHeaderReader, header *types.Header) error

VerifySeal implements consensus.Engine, checking whether the signature contained in the header satisfies the consensus protocol requirements.

func (*Bor) VerifyUncles 

func (c *Bor) VerifyUncles(_ consensus.ChainReader, _ *types.Header, uncles []*types.Header) error

VerifyUncles implements consensus.Engine, always returning an error for any uncles as this consensus mechanism doesn't permit uncles. VerifyUncles implements consensus.Engine, always returning an error for any uncles as this consensus mechanism doesn't permit uncles.

type GenesisContract 

type GenesisContract interface {
	CommitState(event *clerk.EventRecordWithTime, syscall consensus.SystemCall) error
	LastStateId(syscall consensus.SystemCall) (*big.Int, error)
}

type IHeimdallClient 

type IHeimdallClient interface {
	StateSyncEvents(ctx context.Context, fromID uint64, to int64) ([]*clerk.EventRecordWithTime, error)
	Span(ctx context.Context, spanID uint64) (*span.HeimdallSpan, error)
	FetchCheckpoint(ctx context.Context, number int64) (*checkpoint.Checkpoint, error)
	FetchCheckpointCount(ctx context.Context) (int64, error)
	Close()
}

type InvalidStateReceivedError 

type InvalidStateReceivedError struct {
	Number      uint64
	LastStateID uint64
	To          *time.Time
	Event       *clerk.EventRecordWithTime
}

func (*InvalidStateReceivedError) Error 

func (e *InvalidStateReceivedError) Error() string

type MaxCheckpointLengthExceededError 

type MaxCheckpointLengthExceededError struct {
	Start uint64
	End   uint64
}

func (*MaxCheckpointLengthExceededError) Error 

func (e *MaxCheckpointLengthExceededError) Error() string

type MismatchingValidatorsError 

type MismatchingValidatorsError struct {
	Number             uint64
	ValidatorSetSnap   []byte
	ValidatorSetHeader []byte
}

MismatchingValidatorsError is returned if a last block in sprint contains a list of validators different from the one that local node calculated

func (*MismatchingValidatorsError) Error 

func (e *MismatchingValidatorsError) Error() string

type MockGenesisContract 

type MockGenesisContract struct {
	// contains filtered or unexported fields
}

MockGenesisContract is a mock of GenesisContract interface.

func NewMockGenesisContract 

func NewMockGenesisContract(ctrl *gomock.Controller) *MockGenesisContract

NewMockGenesisContract creates a new mock instance.

func (*MockGenesisContract) CommitState 

func (m *MockGenesisContract) CommitState(arg0 *clerk.EventRecordWithTime, arg1 consensus.SystemCall) error

CommitState mocks base method.

func (*MockGenesisContract) EXPECT 

func (m *MockGenesisContract) EXPECT() *MockGenesisContractMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockGenesisContract) LastStateId 

func (m *MockGenesisContract) LastStateId(arg0 consensus.SystemCall) (*big.Int, error)

LastStateId mocks base method.

type MockGenesisContractMockRecorder 

type MockGenesisContractMockRecorder struct {
	// contains filtered or unexported fields
}

MockGenesisContractMockRecorder is the mock recorder for MockGenesisContract.

func (*MockGenesisContractMockRecorder) CommitState 

func (mr *MockGenesisContractMockRecorder) CommitState(arg0, arg1 interface{}) *gomock.Call

CommitState indicates an expected call of CommitState.

func (*MockGenesisContractMockRecorder) LastStateId 

func (mr *MockGenesisContractMockRecorder) LastStateId(arg0 interface{}) *gomock.Call

LastStateId indicates an expected call of LastStateId.

type MockSpanner 

type MockSpanner struct {
	// contains filtered or unexported fields
}

MockSpanner is a mock of Spanner interface.

func NewMockSpanner 

func NewMockSpanner(ctrl *gomock.Controller) *MockSpanner

NewMockSpanner creates a new mock instance.

func (*MockSpanner) CommitSpan 

func (m *MockSpanner) CommitSpan(arg0 span.HeimdallSpan, arg1 consensus.SystemCall) error

CommitSpan mocks base method.

func (*MockSpanner) EXPECT 

func (m *MockSpanner) EXPECT() *MockSpannerMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockSpanner) GetCurrentSpan 

func (m *MockSpanner) GetCurrentSpan(arg0 consensus.SystemCall) (*span.Span, error)

GetCurrentSpan mocks base method.

func (*MockSpanner) GetCurrentValidators 

func (m *MockSpanner) GetCurrentValidators(arg0 uint64, arg1 common.Address, arg2 func(uint64) (*span.HeimdallSpan, error)) ([]*valset.Validator, error)

GetCurrentValidators mocks base method.

type MockSpannerMockRecorder 

type MockSpannerMockRecorder struct {
	// contains filtered or unexported fields
}

MockSpannerMockRecorder is the mock recorder for MockSpanner.

func (*MockSpannerMockRecorder) CommitSpan 

func (mr *MockSpannerMockRecorder) CommitSpan(arg0, arg1 interface{}) *gomock.Call

CommitSpan indicates an expected call of CommitSpan.

func (*MockSpannerMockRecorder) GetCurrentSpan 

func (mr *MockSpannerMockRecorder) GetCurrentSpan(arg0 interface{}) *gomock.Call

GetCurrentSpan indicates an expected call of GetCurrentSpan.

func (*MockSpannerMockRecorder) GetCurrentValidators 

func (mr *MockSpannerMockRecorder) GetCurrentValidators(arg0, arg1, arg2 interface{}) *gomock.Call

GetCurrentValidators indicates an expected call of GetCurrentValidators.

type SignerFn 

type SignerFn func(signer libcommon.Address, mimeType string, message []byte) ([]byte, error)

SignerFn is a signer callback function to request a header to be signed by a backing account.

type Snapshot 

type Snapshot struct {
	Number       uint64                    `json:"number"`       // Block number where the snapshot was created
	Hash         common.Hash               `json:"hash"`         // Block hash where the snapshot was created
	ValidatorSet *valset.ValidatorSet      `json:"validatorSet"` // Validator set at this moment
	Recents      map[uint64]common.Address `json:"recents"`      // Set of recent signers for spam protections
	// contains filtered or unexported fields
}

Snapshot is the state of the authorization voting at a given point in time.

func (*Snapshot) Difficulty 

func (s *Snapshot) Difficulty(signer common.Address) uint64

Difficulty returns the difficulty for a particular signer at the current snapshot number

func (*Snapshot) GetSignerSuccessionNumber 

func (s *Snapshot) GetSignerSuccessionNumber(signer common.Address) (int, error)

GetSignerSuccessionNumber returns the relative position of signer in terms of the in-turn proposer

type Spanner 

type Spanner interface {
	GetCurrentSpan(syscall consensus.SystemCall) (*span.Span, error)
	GetCurrentValidators(blockNumber uint64, signer libcommon.Address, getSpanForBlock func(blockNum uint64) (*span.HeimdallSpan, error)) ([]*valset.Validator, error)
	CommitSpan(heimdallSpan span.HeimdallSpan, syscall consensus.SystemCall) error
}

type UnauthorizedProposerError 

type UnauthorizedProposerError struct {
	Number   uint64
	Proposer []byte
}

UnauthorizedProposerError is returned if a header is [being] signed by an unauthorized entity.

func (*UnauthorizedProposerError) Error 

func (e *UnauthorizedProposerError) Error() string

type UnauthorizedSignerError 

type UnauthorizedSignerError struct {
	Number uint64
	Signer []byte
}

UnauthorizedSignerError is returned if a header is [being] signed by an unauthorized entity.

func (*UnauthorizedSignerError) Error 

func (e *UnauthorizedSignerError) Error() string

type WrongDifficultyError 

type WrongDifficultyError struct {
	Number   uint64
	Expected uint64
	Actual   uint64
	Signer   []byte
}

WrongDifficultyError is returned if the difficulty of a block doesn't match the turn of the signer.

func (*WrongDifficultyError) Error 

func (e *WrongDifficultyError) Error() string

Source Files

View all Source files

Directories

Path Synopsis
checkpoint
span

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.