Struct TipsetResolver 

pub struct TipsetResolver<'a, DB>
where
    DB: Blockstore + Send + Sync + 'static,
{
    ctx: &'a Arc<RPCState<DB>>,
    api_version: ApiPaths,
}

Fields

ctx: &'a Arc<RPCState<DB>>

api_version: ApiPaths

Implementations

impl<'a, DB> TipsetResolver<'a, DB>

where DB: Blockstore + Send + Sync + 'static,

pub fn new(ctx: &'a Arc<RPCState<DB>>, api_version: ApiPaths) -> Self

Creates a TipsetResolver that holds a reference to the given chain context and the API version to use for tipset resolution.

pub async fn tipset_by_block_number_or_hash( &self, block_param: impl Into<BlockNumberOrHash>, resolve: ResolveNullTipset, ) -> Result<Tipset>

Resolve a tipset from a block identifier that may be a predefined tag, block height, or block hash.

Attempts to resolve the provided block_param into a concrete Tipset. The parameter may be:

• a predefined tag (e.g., Predefined::Latest, Predefined::Safe, Predefined::Finalized),
• a block height (number or object form), or
• a block hash (raw hash or object form that can require canonicalization).

Parameters

• block_param — block identifier to resolve; accepts any type convertible to BlockNumberOrHash.
• resolve — rule for how to treat null/unknown tipsets when resolving by height/hash.

Returns

The resolved Tipset on success.

async fn resolve_predefined_tipset(&self, tag: Predefined) -> Result<Tipset>

Resolve a predefined tipset according to the resolver’s API version.

Returns

The resolved Tipset, or an error if resolution fails.

async fn resolve_predefined_tipset_v1(&self, tag: Predefined) -> Result<Tipset>

Resolves a predefined tipset using the V1 resolution policy, or delegates to the V2 resolver when the V1 finality-resolution override is not enabled.

If the environment variable FOREST_ETH_V1_DISABLE_F3_FINALITY_RESOLUTION is set to a truthy value, this function first attempts common predefined tag resolution (e.g., Pending, Latest). If that yields no result, the function uses expected-consensus finality to resolve the “safe” or “finalized” tipset for the corresponding Predefined tag. When the environment variable is not set or is falsy, resolution is delegated to the V2 resolver.

Errors

Returns an error if the requested predefined tag is unknown or if tipset resolution fails.

async fn resolve_predefined_tipset_v2(&self, tag: Predefined) -> Result<Tipset>

Resolves a predefined tipset according to the v2 API behavior.

Uses a common predefined-tipset lookup first; if that yields no result, resolves Safe and Finalized tags via the v2 chain getters. Returns an error for unknown tags or on underlying resolution failures.

Returns

The resolved Tipset on success.

fn resolve_common_predefined_tipset( &self, tag: Predefined, ) -> Result<Option<Tipset>>

Attempt to resolve a predefined block tag to a commonly-handled tipset.

Returns Some(Tipset) for Predefined::Pending (current head) and Predefined::Latest (the tipset at the head’s parents). Returns Ok(None) when the tag is not handled by this common-resolution path (caller should try other resolution strategies). Resolving Predefined::Earliest fails with an error.

pub fn get_ec_safe_tipset(&self) -> Result<Tipset>

Returns the tipset considered “safe” relative to the current heaviest tipset.

The safe tipset is the tipset at height max(head.epoch() - SAFE_HEIGHT_DISTANCE, 0).

pub fn get_ec_finalized_tipset(&self) -> Result<Tipset>

Returns the tipset considered finalized by expected-consensus finality.

The finalized epoch is computed as head.epoch() minus the chain’s policy.chain_finality, clamped to zero. The tipset at that epoch is returned; when the exact height is unavailable, an older tipset is selected.