Trait sc_consensus_grandpa::GrandpaApi
pub trait GrandpaApi<Block>: Core<Block>where
Block: Block,{
// Provided methods
fn grandpa_authorities(
&self,
__runtime_api_at_param__: <Block as Block>::Hash
) -> Result<Vec<(Public, u64), Global>, ApiError> { ... }
fn submit_report_equivocation_unsigned_extrinsic(
&self,
__runtime_api_at_param__: <Block as Block>::Hash,
equivocation_proof: EquivocationProof<<Block as Block>::Hash, <<Block as Block>::Header as Header>::Number>,
key_owner_proof: OpaqueKeyOwnershipProof
) -> Result<Option<()>, ApiError> { ... }
fn generate_key_ownership_proof(
&self,
__runtime_api_at_param__: <Block as Block>::Hash,
set_id: u64,
authority_id: Public
) -> Result<Option<OpaqueKeyOwnershipProof>, ApiError> { ... }
fn current_set_id(
&self,
__runtime_api_at_param__: <Block as Block>::Hash
) -> Result<u64, ApiError> { ... }
}Expand description
APIs for integrating the GRANDPA finality gadget into runtimes. This should be implemented on the runtime side.
This is primarily used for negotiating authority-set changes for the gadget. GRANDPA uses a signaling model of changing authority sets: changes should be signaled with a delay of N blocks, and then automatically applied in the runtime after those N blocks have passed.
The consensus protocol will coordinate the handoff externally.
Provided Methods§
Get the current GRANDPA authorities and weights. This should not change except for when changes are scheduled and the corresponding delay has passed.
When called at block B, it will return the set of authorities that should be used to finalize descendants of this block (B+1, B+2, …). The block B itself is finalized by the authorities from block B-1.
fn submit_report_equivocation_unsigned_extrinsic(
&self,
__runtime_api_at_param__: <Block as Block>::Hash,
equivocation_proof: EquivocationProof<<Block as Block>::Hash, <<Block as Block>::Header as Header>::Number>,
key_owner_proof: OpaqueKeyOwnershipProof
) -> Result<Option<()>, ApiError>
fn submit_report_equivocation_unsigned_extrinsic( &self, __runtime_api_at_param__: <Block as Block>::Hash, equivocation_proof: EquivocationProof<<Block as Block>::Hash, <<Block as Block>::Header as Header>::Number>, key_owner_proof: OpaqueKeyOwnershipProof ) -> Result<Option<()>, ApiError>
Submits an unsigned extrinsic to report an equivocation. The caller
must provide the equivocation proof and a key ownership proof
(should be obtained using generate_key_ownership_proof). The
extrinsic will be unsigned and should only be accepted for local
authorship (not to be broadcast to the network). This method returns
None when creation of the extrinsic fails, e.g. if equivocation
reporting is disabled for the given runtime (i.e. this method is
hardcoded to return None). Only useful in an offchain context.
fn generate_key_ownership_proof(
&self,
__runtime_api_at_param__: <Block as Block>::Hash,
set_id: u64,
authority_id: Public
) -> Result<Option<OpaqueKeyOwnershipProof>, ApiError>
fn generate_key_ownership_proof( &self, __runtime_api_at_param__: <Block as Block>::Hash, set_id: u64, authority_id: Public ) -> Result<Option<OpaqueKeyOwnershipProof>, ApiError>
Generates a proof of key ownership for the given authority in the
given set. An example usage of this module is coupled with the
session historical module to prove that a given authority key is
tied to a given staking identity during a specific session. Proofs
of key ownership are necessary for submitting equivocation reports.
NOTE: even though the API takes a set_id as parameter the current
implementations ignore this parameter and instead rely on this
method being called at the correct block height, i.e. any point at
which the given set id is live on-chain. Future implementations will
instead use indexed data through an offchain worker, not requiring
older states to be available.
fn current_set_id(
&self,
__runtime_api_at_param__: <Block as Block>::Hash
) -> Result<u64, ApiError>
fn current_set_id( &self, __runtime_api_at_param__: <Block as Block>::Hash ) -> Result<u64, ApiError>
Get current GRANDPA authority set id.