finality

type AltDABackend interface {
	// Finalize notifies the L1 finalized head so AltDA finality is always behind L1.
	Finalize(ref eth.L1BlockRef)
	// OnFinalizedHeadSignal sets the engine finalization signal callback.
	OnFinalizedHeadSignal(f altda.HeadSignalFn)
}

type AltDAFinalizer struct {
	*Finalizer
	// contains filtered or unexported fields
}

type Config struct {
	// FinalityLookback specifies the number of L1 blocks to look back for finality verification.
	// When nil, uses the default finality lookback calculation (which considers both
	// the default lookback and alt-DA challenge/resolve windows if applicable).
	FinalityLookback *uint64

	// FinalityDelay specifies the number of L1 blocks to traverse before trying to finalize L2 blocks again.
	// When nil, defaults to 64 blocks.
	FinalityDelay *uint64
}

type EngineController interface {
	PromoteFinalized(context.Context, eth.L2BlockRef)
}

type FinalityData struct {
	// The last L2 block that was fully derived and inserted into the L2 engine while processing this L1 block.
	L2Block eth.L2BlockRef
	// The L1 block this stage was at when inserting the L2 block.
	// When this L1 block is finalized, the L2 chain up to this block can be fully reproduced from finalized L1 data.
	L1Block eth.BlockID
}

type Finalizer struct {
	// contains filtered or unexported fields
}

type FinalizerEngine interface {
	Finalized() eth.L2BlockRef
	SetFinalizedHead(eth.L2BlockRef)
}

type FinalizerL1Interface interface {
	L1BlockRefByNumber(context.Context, uint64) (eth.L1BlockRef, error)
}

type TryFinalizeEvent struct {
}