Struct ethcore::engines::Clique

pub struct Clique { /* private fields */ }

Clique Engine implementation

Implementations

impl Clique

pub fn new(
    params: CliqueParams,
    machine: EthereumMachine
) -> Result<Arc<Self>, Error>

Initialize Clique engine from empty state.

Trait Implementations

impl Engine<EthereumMachine> for Clique

fn sealing_state(&self) -> SealingState

Clique doesn’t require external work to seal, so we always return true here.

fn generate_seal(&self, block: &ExecutedBlock, parent: &Header) -> Seal

Returns if we are ready to seal, the real sealing (signing extra_data) is actually done in on_seal_block().

fn verify_block_family(
    &self,
    header: &Header,
    parent: &Header
) -> Result<(), Error>

Verify block family by looking up parent state (backfill if needed), then try to apply current header. see https://github.com/ethereum/go-ethereum/blob/master/consensus/clique/clique.go#L338

fn open_block_header_timestamp(&self, parent_timestamp: u64) -> u64

Clique timestamp is set to parent + period , or current time which ever is higher.

fn name(&self) -> &str

The name of this engine.

fn machine(&self) -> &EthereumMachine

Get access to the underlying state machine.

fn seal_fields(&self, _header: &Header) -> usize

The number of additional header fields required for this engine.

fn maximum_uncle_count(&self, _block: BlockNumber) -> usize

Maximum number of uncles a block is allowed to declare.

fn on_new_block(
    &self,
    _block: &mut ExecutedBlock,
    _epoch_begin: bool,
    _ancestry: &mut dyn Iterator<Item = ExtendedHeader>
) -> Result<(), Error>

Block transformation functions, before the transactions. epoch_begin set to true if this block kicks off an epoch.

fn on_close_block(&self, _block: &mut ExecutedBlock) -> Result<(), Error>

Block transformation functions, after the transactions.

fn on_seal_block(&self, block: &mut ExecutedBlock) -> Result<(), Error>

Allow mutating the header during seal generation. Currently only used by Clique.

fn verify_local_seal(&self, _header: &Header) -> Result<(), Error>

Verify a locally-generated seal of a header.

fn verify_block_basic(&self, header: &Header) -> Result<(), Error>

Phase 1 quick block verification. Only does checks that are cheap. Returns either a null Ok or a general error detailing the problem with import. The verification module can optionally avoid checking the seal (check_seal), if seal verification is disabled this method won’t be called.

fn verify_block_unordered(&self, _header: &Header) -> Result<(), Error>

Phase 2 verification. Perform costly checks such as transaction signatures. Returns either a null Ok or a general error detailing the problem with import. The verification module can optionally avoid checking the seal (check_seal), if seal verification is disabled this method won’t be called.

fn genesis_epoch_data(
    &self,
    header: &Header,
    _call: &Call<'_>
) -> Result<Vec<u8>, String>

Genesis epoch data.

fn populate_from_parent(&self, header: &mut Header, parent: &Header)

Populate a header’s fields based on its parent’s header. Usually implements the chain scoring rule based on weight.

fn set_signer(&self, signer: Option<Box<dyn EngineSigner>>)

Register a component which signs consensus messages.

fn register_client(&self, client: Weak<dyn EngineClient>)

Add Client which can be used for sealing, potentially querying the state and sending messages.

fn step(&self)

Trigger next step of the consensus engine.

fn is_timestamp_valid(
    &self,
    header_timestamp: u64,
    parent_timestamp: u64
) -> bool

Check whether the parent timestamp is valid.

fn fork_choice(
    &self,
    new: &ExtendedHeader,
    current: &ExtendedHeader
) -> ForkChoice

Check whether the given new block is the best block, after finalization check.

fn executive_author(&self, header: &Header) -> Result<Address, Error>

Returns author should used when executing tx’s for this block.

fn extra_info(&self, _header: &Header) -> BTreeMap<String, String>

Additional engine-specific information for the user/developer concerning header.

fn maximum_gas_limit(&self) -> Option<U256>

Optional maximum gas limit.

fn should_reseal_on_update(&self) -> bool

Called in miner.chain_new_blocks if the engine wishes to update_sealing after a block was recently sealed.

fn verify_block_external(&self, _header: &Header) -> Result<(), M::Error>

Phase 4 verification. Verify block header against potentially external data. Should only be called when register_client has been called previously.

fn signals_epoch_end<'a>(
    &self,
    _header: &Header,
    _aux: AuxiliaryData<'a>
) -> EpochChange<M>

Whether an epoch change is signalled at the given header but will require finality. If a change can be enacted immediately then return No from this function but Yes from is_epoch_end.

fn is_epoch_end(
    &self,
    _chain_head: &Header,
    _finalized: &[H256],
    _chain: &Headers<'_, Header>,
    _transition_store: &PendingTransitionStore<'_>
) -> Option<Vec<u8>>

Whether a block is the end of an epoch.

fn epoch_verifier<'a>(
    &self,
    _header: &Header,
    _proof: &'a [u8]
) -> ConstructedVerifier<'a, M>

Create an epoch verifier from validation proof and a flag indicating whether finality is required.

fn handle_message(&self, _message: &[u8]) -> Result<(), EngineError>

Handle any potential consensus messages; updating consensus state and potentially issuing a new one.

fn is_allowed_to_seal(&self) -> bool

Returns whether the current node is a validator and actually may seal a block if AuRa engine is used.

fn sign(&self, _hash: H256) -> Result<Signature, M::Error>

Sign using the EngineSigner, to be used for consensus tx signing.

fn snapshot_components(&self) -> Option<Box<dyn SnapshotComponents>>

Create a factory for building snapshot chunks and restoring from them. Returning None indicates that this engine doesn’t support snapshot creation.

fn supports_warp(&self) -> bool

Whether this engine supports warp sync.

fn ancestry_actions(
    &self,
    _header: &Header,
    _ancestry: &mut dyn Iterator<Item = ExtendedHeader>
) -> Vec<AncestryAction>

the ancestry exists.

fn generate_engine_transactions(
    &self,
    _block: &ExecutedBlock
) -> Result<Vec<SignedTransaction>, Error>

Returns a list of transactions for a new block if we are the author.

fn gas_limit_override(&self, _header: &Header) -> Option<U256>

Overrides the block gas limit. Whenever this returns Some for a header, the next block’s gas limit must be exactly that value. used by AuRa engine.