alpen_getBlockStatus

Returns the finalization status of a given Alpen (execution-layer) block hash, abstracting Strata's checkpoint progress on Bitcoin. Alpen state commitments are periodically checkpointed to Bitcoin through Strata, the orchestration layer; a block's reported status reflects how far the Strata checkpoint covering it has advanced.

Status values:

• pending: the Alpen block is not yet covered by any confirmed or finalized Strata checkpoint.

• confirmed: the Alpen block is covered by a confirmed Strata checkpoint.

• finalized: the Alpen block is covered by a finalized Strata checkpoint. A finalized block cannot be reorganized without reorging the Bitcoin block its checkpoint was confirmed in.

When status is confirmed or finalized, the response also includes checkpoint_epoch, the Strata checkpoint epoch number that covers the block. That value can be passed to Strata RPC methods such as strata_getCheckpointInfo to inspect the checkpoint itself. When status is pending, checkpoint_epoch is omitted.

The block hash must resolve to a canonical Alpen block on the serving node. Unknown or non-canonical block hashes return an "invalid params" error with the message block not found. The genesis block is always reported as finalized.

See the Alpen RPC endpoints reference for upstream documentation.