@dedot/chaintypes 0.67.0 → 0.68.0

package/paseo/runtime.d.ts

@@ -25,37 +25,39 @@ import type {
   SpInherentsCheckInherentsResult,
   SpRuntimeTransactionValidityValidTransaction,
   SpRuntimeTransactionValidityTransactionSource,
-  PolkadotPrimitivesV7ValidatorAppPublic,
-  PolkadotPrimitivesV7ValidatorIndex,
-  PolkadotPrimitivesV7GroupRotationInfo,
-  PolkadotPrimitivesV7CoreState,
-  PolkadotPrimitivesV7PersistedValidationData,
+  PolkadotPrimitivesV8ValidatorAppPublic,
+  PolkadotPrimitivesV8ValidatorIndex,
+  PolkadotPrimitivesV8GroupRotationInfo,
+  PolkadotPrimitivesV8CoreState,
+  PolkadotPrimitivesV8PersistedValidationData,
   PolkadotParachainPrimitivesPrimitivesId,
-  PolkadotPrimitivesV7OccupiedCoreAssumption,
+  PolkadotPrimitivesV8OccupiedCoreAssumption,
   PolkadotParachainPrimitivesPrimitivesValidationCodeHash,
-  PolkadotPrimitivesV7CandidateCommitments,
+  PolkadotPrimitivesV8CandidateCommitments,
   PolkadotParachainPrimitivesPrimitivesValidationCode,
-  PolkadotPrimitivesV7CommittedCandidateReceipt,
-  PolkadotPrimitivesV7CandidateEvent,
+  PolkadotPrimitivesV8CommittedCandidateReceipt,
+  PolkadotPrimitivesV8CandidateEvent,
   PolkadotCorePrimitivesInboundDownwardMessage,
   PolkadotCorePrimitivesInboundHrmpMessage,
-  PolkadotPrimitivesV7ScrapedOnChainVotes,
-  PolkadotPrimitivesV7SessionInfo,
-  PolkadotPrimitivesV7PvfCheckStatement,
-  PolkadotPrimitivesV7ValidatorAppSignature,
+  PolkadotPrimitivesV8ScrapedOnChainVotes,
+  PolkadotPrimitivesV8SessionInfo,
+  PolkadotPrimitivesV8PvfCheckStatement,
+  PolkadotPrimitivesV8ValidatorAppSignature,
   PolkadotCorePrimitivesCandidateHash,
-  PolkadotPrimitivesV7DisputeState,
-  PolkadotPrimitivesV7ExecutorParams,
-  PolkadotPrimitivesV7SlashingPendingSlashes,
-  PolkadotPrimitivesV7SlashingOpaqueKeyOwnershipProof,
-  PolkadotPrimitivesV7SlashingDisputeProof,
-  PolkadotPrimitivesV7AsyncBackingBackingState,
-  PolkadotPrimitivesV7AsyncBackingAsyncBackingParams,
-  PolkadotPrimitivesV7ApprovalVotingParams,
-  PolkadotPrimitivesV7CoreIndex,
+  PolkadotPrimitivesV8DisputeState,
+  PolkadotPrimitivesV8ExecutorParams,
+  PolkadotPrimitivesV8SlashingPendingSlashes,
+  PolkadotPrimitivesV8SlashingOpaqueKeyOwnershipProof,
+  PolkadotPrimitivesV8SlashingDisputeProof,
+  PolkadotPrimitivesV8AsyncBackingBackingState,
+  PolkadotPrimitivesV8AsyncBackingAsyncBackingParams,
+  PolkadotPrimitivesV8ApprovalVotingParams,
+  PolkadotPrimitivesV8CoreIndex,
   SpConsensusBeefyValidatorSet,
   SpConsensusBeefyDoubleVotingProof,
   SpRuntimeOpaqueValue,
+  SpConsensusBeefyForkVotingProofOpaqueValue,
+  SpConsensusBeefyFutureBlockVotingProof,
   SpConsensusBeefyEcdsaCryptoPublic,
   SpMmrPrimitivesError,
   SpMmrPrimitivesEncodableOpaqueLeaf,
@@ -271,6 +273,9 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
     /**
      * Returns the pending slash for a given pool member.
      *
+     * If pending slash of the member exceeds `ExistentialDeposit`, it can be reported on
+     * chain.
+     *
      * @callname: NominationPoolsApi_member_pending_slash
      * @param {AccountId32Like} member
      **/
@@ -305,6 +310,22 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      **/
     memberNeedsDelegateMigration: GenericRuntimeApiMethod<Rv, (member: AccountId32Like) => Promise<boolean>>;
 
+    /**
+     * Returns the total contribution of a pool member including any balance that is unbonding.
+     *
+     * @callname: NominationPoolsApi_member_total_balance
+     * @param {AccountId32Like} who
+     **/
+    memberTotalBalance: GenericRuntimeApiMethod<Rv, (who: AccountId32Like) => Promise<bigint>>;
+
+    /**
+     * Total balance contributed to the pool.
+     *
+     * @callname: NominationPoolsApi_pool_balance
+     * @param {number} pool_id
+     **/
+    poolBalance: GenericRuntimeApiMethod<Rv, (poolId: number) => Promise<bigint>>;
+
     /**
      * Generic runtime api call
      **/
@@ -407,7 +428,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_validators
      **/
-    validators: GenericRuntimeApiMethod<Rv, () => Promise<Array<PolkadotPrimitivesV7ValidatorAppPublic>>>;
+    validators: GenericRuntimeApiMethod<Rv, () => Promise<Array<PolkadotPrimitivesV8ValidatorAppPublic>>>;
 
     /**
      * Returns the validator groups and rotation info localized based on the hypothetical child
@@ -418,7 +439,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      **/
     validatorGroups: GenericRuntimeApiMethod<
       Rv,
-      () => Promise<[Array<Array<PolkadotPrimitivesV7ValidatorIndex>>, PolkadotPrimitivesV7GroupRotationInfo]>
+      () => Promise<[Array<Array<PolkadotPrimitivesV8ValidatorIndex>>, PolkadotPrimitivesV8GroupRotationInfo]>
     >;
 
     /**
@@ -427,7 +448,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_availability_cores
      **/
-    availabilityCores: GenericRuntimeApiMethod<Rv, () => Promise<Array<PolkadotPrimitivesV7CoreState>>>;
+    availabilityCores: GenericRuntimeApiMethod<Rv, () => Promise<Array<PolkadotPrimitivesV8CoreState>>>;
 
     /**
      * Yields the persisted validation data for the given `ParaId` along with an assumption that
@@ -438,14 +459,14 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_persisted_validation_data
      * @param {PolkadotParachainPrimitivesPrimitivesId} para_id
-     * @param {PolkadotPrimitivesV7OccupiedCoreAssumption} assumption
+     * @param {PolkadotPrimitivesV8OccupiedCoreAssumption} assumption
      **/
     persistedValidationData: GenericRuntimeApiMethod<
       Rv,
       (
         paraId: PolkadotParachainPrimitivesPrimitivesId,
-        assumption: PolkadotPrimitivesV7OccupiedCoreAssumption,
-      ) => Promise<PolkadotPrimitivesV7PersistedValidationData | undefined>
+        assumption: PolkadotPrimitivesV8OccupiedCoreAssumption,
+      ) => Promise<PolkadotPrimitivesV8PersistedValidationData | undefined>
     >;
 
     /**
@@ -463,7 +484,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
         paraId: PolkadotParachainPrimitivesPrimitivesId,
         expectedPersistedValidationDataHash: H256,
       ) => Promise<
-        | [PolkadotPrimitivesV7PersistedValidationData, PolkadotParachainPrimitivesPrimitivesValidationCodeHash]
+        | [PolkadotPrimitivesV8PersistedValidationData, PolkadotParachainPrimitivesPrimitivesValidationCodeHash]
         | undefined
       >
     >;
@@ -473,13 +494,13 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_check_validation_outputs
      * @param {PolkadotParachainPrimitivesPrimitivesId} para_id
-     * @param {PolkadotPrimitivesV7CandidateCommitments} outputs
+     * @param {PolkadotPrimitivesV8CandidateCommitments} outputs
      **/
     checkValidationOutputs: GenericRuntimeApiMethod<
       Rv,
       (
         paraId: PolkadotParachainPrimitivesPrimitivesId,
-        outputs: PolkadotPrimitivesV7CandidateCommitments,
+        outputs: PolkadotPrimitivesV8CandidateCommitments,
       ) => Promise<boolean>
     >;
 
@@ -500,13 +521,13 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_validation_code
      * @param {PolkadotParachainPrimitivesPrimitivesId} para_id
-     * @param {PolkadotPrimitivesV7OccupiedCoreAssumption} assumption
+     * @param {PolkadotPrimitivesV8OccupiedCoreAssumption} assumption
      **/
     validationCode: GenericRuntimeApiMethod<
       Rv,
       (
         paraId: PolkadotParachainPrimitivesPrimitivesId,
-        assumption: PolkadotPrimitivesV7OccupiedCoreAssumption,
+        assumption: PolkadotPrimitivesV8OccupiedCoreAssumption,
       ) => Promise<PolkadotParachainPrimitivesPrimitivesValidationCode | undefined>
     >;
 
@@ -521,7 +542,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
       Rv,
       (
         paraId: PolkadotParachainPrimitivesPrimitivesId,
-      ) => Promise<PolkadotPrimitivesV7CommittedCandidateReceipt | undefined>
+      ) => Promise<PolkadotPrimitivesV8CommittedCandidateReceipt | undefined>
     >;
 
     /**
@@ -529,7 +550,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_candidate_events
      **/
-    candidateEvents: GenericRuntimeApiMethod<Rv, () => Promise<Array<PolkadotPrimitivesV7CandidateEvent>>>;
+    candidateEvents: GenericRuntimeApiMethod<Rv, () => Promise<Array<PolkadotPrimitivesV8CandidateEvent>>>;
 
     /**
      * Get all the pending inbound messages in the downward message queue for a para.
@@ -576,7 +597,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_on_chain_votes
      **/
-    onChainVotes: GenericRuntimeApiMethod<Rv, () => Promise<PolkadotPrimitivesV7ScrapedOnChainVotes | undefined>>;
+    onChainVotes: GenericRuntimeApiMethod<Rv, () => Promise<PolkadotPrimitivesV8ScrapedOnChainVotes | undefined>>;
 
     /**
      * Get the session info for the given session, if stored.
@@ -586,7 +607,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      * @callname: ParachainHost_session_info
      * @param {number} index
      **/
-    sessionInfo: GenericRuntimeApiMethod<Rv, (index: number) => Promise<PolkadotPrimitivesV7SessionInfo | undefined>>;
+    sessionInfo: GenericRuntimeApiMethod<Rv, (index: number) => Promise<PolkadotPrimitivesV8SessionInfo | undefined>>;
 
     /**
      * Submits a PVF pre-checking statement into the transaction pool.
@@ -594,12 +615,12 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      * NOTE: This function is only available since parachain host version 2.
      *
      * @callname: ParachainHost_submit_pvf_check_statement
-     * @param {PolkadotPrimitivesV7PvfCheckStatement} stmt
-     * @param {PolkadotPrimitivesV7ValidatorAppSignature} signature
+     * @param {PolkadotPrimitivesV8PvfCheckStatement} stmt
+     * @param {PolkadotPrimitivesV8ValidatorAppSignature} signature
      **/
     submitPvfCheckStatement: GenericRuntimeApiMethod<
       Rv,
-      (stmt: PolkadotPrimitivesV7PvfCheckStatement, signature: PolkadotPrimitivesV7ValidatorAppSignature) => Promise<[]>
+      (stmt: PolkadotPrimitivesV8PvfCheckStatement, signature: PolkadotPrimitivesV8ValidatorAppSignature) => Promise<[]>
     >;
 
     /**
@@ -621,13 +642,13 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_validation_code_hash
      * @param {PolkadotParachainPrimitivesPrimitivesId} para_id
-     * @param {PolkadotPrimitivesV7OccupiedCoreAssumption} assumption
+     * @param {PolkadotPrimitivesV8OccupiedCoreAssumption} assumption
      **/
     validationCodeHash: GenericRuntimeApiMethod<
       Rv,
       (
         paraId: PolkadotParachainPrimitivesPrimitivesId,
-        assumption: PolkadotPrimitivesV7OccupiedCoreAssumption,
+        assumption: PolkadotPrimitivesV8OccupiedCoreAssumption,
       ) => Promise<PolkadotParachainPrimitivesPrimitivesValidationCodeHash | undefined>
     >;
 
@@ -638,7 +659,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      **/
     disputes: GenericRuntimeApiMethod<
       Rv,
-      () => Promise<Array<[number, PolkadotCorePrimitivesCandidateHash, PolkadotPrimitivesV7DisputeState]>>
+      () => Promise<Array<[number, PolkadotCorePrimitivesCandidateHash, PolkadotPrimitivesV8DisputeState]>>
     >;
 
     /**
@@ -649,7 +670,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      **/
     sessionExecutorParams: GenericRuntimeApiMethod<
       Rv,
-      (sessionIndex: number) => Promise<PolkadotPrimitivesV7ExecutorParams | undefined>
+      (sessionIndex: number) => Promise<PolkadotPrimitivesV8ExecutorParams | undefined>
     >;
 
     /**
@@ -660,7 +681,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      **/
     unappliedSlashes: GenericRuntimeApiMethod<
       Rv,
-      () => Promise<Array<[number, PolkadotCorePrimitivesCandidateHash, PolkadotPrimitivesV7SlashingPendingSlashes]>>
+      () => Promise<Array<[number, PolkadotCorePrimitivesCandidateHash, PolkadotPrimitivesV8SlashingPendingSlashes]>>
     >;
 
     /**
@@ -668,13 +689,13 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      * NOTE: This function is only available since parachain host version 5.
      *
      * @callname: ParachainHost_key_ownership_proof
-     * @param {PolkadotPrimitivesV7ValidatorAppPublic} validator_id
+     * @param {PolkadotPrimitivesV8ValidatorAppPublic} validator_id
      **/
     keyOwnershipProof: GenericRuntimeApiMethod<
       Rv,
       (
-        validatorId: PolkadotPrimitivesV7ValidatorAppPublic,
-      ) => Promise<PolkadotPrimitivesV7SlashingOpaqueKeyOwnershipProof | undefined>
+        validatorId: PolkadotPrimitivesV8ValidatorAppPublic,
+      ) => Promise<PolkadotPrimitivesV8SlashingOpaqueKeyOwnershipProof | undefined>
     >;
 
     /**
@@ -683,14 +704,14 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      * NOTE: This function is only available since parachain host version 5.
      *
      * @callname: ParachainHost_submit_report_dispute_lost
-     * @param {PolkadotPrimitivesV7SlashingDisputeProof} dispute_proof
-     * @param {PolkadotPrimitivesV7SlashingOpaqueKeyOwnershipProof} key_ownership_proof
+     * @param {PolkadotPrimitivesV8SlashingDisputeProof} dispute_proof
+     * @param {PolkadotPrimitivesV8SlashingOpaqueKeyOwnershipProof} key_ownership_proof
      **/
     submitReportDisputeLost: GenericRuntimeApiMethod<
       Rv,
       (
-        disputeProof: PolkadotPrimitivesV7SlashingDisputeProof,
-        keyOwnershipProof: PolkadotPrimitivesV7SlashingOpaqueKeyOwnershipProof,
+        disputeProof: PolkadotPrimitivesV8SlashingDisputeProof,
+        keyOwnershipProof: PolkadotPrimitivesV8SlashingOpaqueKeyOwnershipProof,
       ) => Promise<[] | undefined>
     >;
 
@@ -712,7 +733,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
       Rv,
       (
         undefined: PolkadotParachainPrimitivesPrimitivesId,
-      ) => Promise<PolkadotPrimitivesV7AsyncBackingBackingState | undefined>
+      ) => Promise<PolkadotPrimitivesV8AsyncBackingBackingState | undefined>
     >;
 
     /**
@@ -720,14 +741,14 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_async_backing_params
      **/
-    asyncBackingParams: GenericRuntimeApiMethod<Rv, () => Promise<PolkadotPrimitivesV7AsyncBackingAsyncBackingParams>>;
+    asyncBackingParams: GenericRuntimeApiMethod<Rv, () => Promise<PolkadotPrimitivesV8AsyncBackingAsyncBackingParams>>;
 
     /**
      * Returns a list of all disabled validators at the given block.
      *
      * @callname: ParachainHost_disabled_validators
      **/
-    disabledValidators: GenericRuntimeApiMethod<Rv, () => Promise<Array<PolkadotPrimitivesV7ValidatorIndex>>>;
+    disabledValidators: GenericRuntimeApiMethod<Rv, () => Promise<Array<PolkadotPrimitivesV8ValidatorIndex>>>;
 
     /**
      * Get node features.
@@ -742,7 +763,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * @callname: ParachainHost_approval_voting_params
      **/
-    approvalVotingParams: GenericRuntimeApiMethod<Rv, () => Promise<PolkadotPrimitivesV7ApprovalVotingParams>>;
+    approvalVotingParams: GenericRuntimeApiMethod<Rv, () => Promise<PolkadotPrimitivesV8ApprovalVotingParams>>;
 
     /**
      * Claim queue
@@ -751,7 +772,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      **/
     claimQueue: GenericRuntimeApiMethod<
       Rv,
-      () => Promise<Array<[PolkadotPrimitivesV7CoreIndex, Array<PolkadotParachainPrimitivesPrimitivesId>]>>
+      () => Promise<Array<[PolkadotPrimitivesV8CoreIndex, Array<PolkadotParachainPrimitivesPrimitivesId>]>>
     >;
 
     /**
@@ -762,7 +783,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      **/
     candidatesPendingAvailability: GenericRuntimeApiMethod<
       Rv,
-      (paraId: PolkadotParachainPrimitivesPrimitivesId) => Promise<Array<PolkadotPrimitivesV7CommittedCandidateReceipt>>
+      (paraId: PolkadotParachainPrimitivesPrimitivesId) => Promise<Array<PolkadotPrimitivesV8CommittedCandidateReceipt>>
     >;
 
     /**
@@ -789,8 +810,8 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
     validatorSet: GenericRuntimeApiMethod<Rv, () => Promise<SpConsensusBeefyValidatorSet | undefined>>;
 
     /**
-     * Submits an unsigned extrinsic to report an equivocation. The caller
-     * must provide the equivocation proof and a key ownership proof
+     * Submits an unsigned extrinsic to report a double voting equivocation. The caller
+     * must provide the double voting 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
@@ -798,11 +819,11 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      * reporting is disabled for the given runtime (i.e. this method is
      * hardcoded to return `None`). Only useful in an offchain context.
      *
-     * @callname: BeefyApi_submit_report_equivocation_unsigned_extrinsic
+     * @callname: BeefyApi_submit_report_double_voting_unsigned_extrinsic
      * @param {SpConsensusBeefyDoubleVotingProof} equivocation_proof
      * @param {SpRuntimeOpaqueValue} key_owner_proof
      **/
-    submitReportEquivocationUnsignedExtrinsic: GenericRuntimeApiMethod<
+    submitReportDoubleVotingUnsignedExtrinsic: GenericRuntimeApiMethod<
       Rv,
       (
         equivocationProof: SpConsensusBeefyDoubleVotingProof,
@@ -810,6 +831,50 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
       ) => Promise<[] | undefined>
     >;
 
+    /**
+     * Submits an unsigned extrinsic to report a fork voting equivocation. The caller
+     * must provide the fork voting proof (the ancestry proof should be obtained using
+     * `generate_ancestry_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.
+     *
+     * @callname: BeefyApi_submit_report_fork_voting_unsigned_extrinsic
+     * @param {SpConsensusBeefyForkVotingProofOpaqueValue} equivocation_proof
+     * @param {SpRuntimeOpaqueValue} key_owner_proof
+     **/
+    submitReportForkVotingUnsignedExtrinsic: GenericRuntimeApiMethod<
+      Rv,
+      (
+        equivocationProof: SpConsensusBeefyForkVotingProofOpaqueValue,
+        keyOwnerProof: SpRuntimeOpaqueValue,
+      ) => Promise<[] | undefined>
+    >;
+
+    /**
+     * Submits an unsigned extrinsic to report a future block voting equivocation. The caller
+     * must provide the future block voting 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.
+     *
+     * @callname: BeefyApi_submit_report_future_block_voting_unsigned_extrinsic
+     * @param {SpConsensusBeefyFutureBlockVotingProof} equivocation_proof
+     * @param {SpRuntimeOpaqueValue} key_owner_proof
+     **/
+    submitReportFutureBlockVotingUnsignedExtrinsic: GenericRuntimeApiMethod<
+      Rv,
+      (
+        equivocationProof: SpConsensusBeefyFutureBlockVotingProof,
+        keyOwnerProof: SpRuntimeOpaqueValue,
+      ) => Promise<[] | undefined>
+    >;
+
     /**
      * Generates a proof of key ownership for the given authority in the
      * given set. An example usage of this module is coupled with the
@@ -832,6 +897,19 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
       (setId: bigint, authorityId: SpConsensusBeefyEcdsaCryptoPublic) => Promise<SpRuntimeOpaqueValue | undefined>
     >;
 
+    /**
+     * Generates a proof that the `prev_block_number` is part of the canonical chain at
+     * `best_known_block_number`.
+     *
+     * @callname: BeefyApi_generate_ancestry_proof
+     * @param {number} prev_block_number
+     * @param {number | undefined} best_known_block_number
+     **/
+    generateAncestryProof: GenericRuntimeApiMethod<
+      Rv,
+      (prevBlockNumber: number, bestKnownBlockNumber?: number | undefined) => Promise<SpRuntimeOpaqueValue | undefined>
+    >;
+
     /**
      * Generic runtime api call
      **/
@@ -1428,7 +1506,7 @@ export interface RuntimeApis<Rv extends RpcVersion> extends GenericRuntimeApis<R
      *
      * Otherwise function returns a JSON representation of the built-in, named
      * `RuntimeGenesisConfig` preset identified by `id`, or `None` if such preset does not
-     * exists. Returned `Vec<u8>` contains bytes of JSON blob (patch) which comprises a list of
+     * exist. Returned `Vec<u8>` contains bytes of JSON blob (patch) which comprises a list of
      * (potentially nested) key-value pairs that are intended for customizing the default
      * runtime genesis config. The patch shall be merged (rfc7386) with the JSON representation
      * of the default `RuntimeGenesisConfig` to create a comprehensive genesis config that can