activity

type Activity interface {
	Name() string
	// Reset is called when a chain container resets due to an invalidated block.
	// Activities should clean up any cached state for that chain at or after the timestamp.
	// The invalidatedBlock is the block that was is the target of the reset
	// This is a no-op for activities that don't maintain chain-specific state.
	Reset(chainID eth.ChainID, timestamp uint64, invalidatedBlock eth.BlockRef)
}

type RPCActivity interface {
	Activity
	RPCNamespace() string
	RPCService() interface{}
}

type RunnableActivity interface {
	Activity
	Start(ctx context.Context) error
	Stop(ctx context.Context) error
}

type VerificationActivity interface {
	Activity

	// Reset resets the activity's state.
	Reset(chainID eth.ChainID, timestamp uint64, invalidatedBlock eth.BlockRef)

	// CurrentL1 returns the current L1 block ID.
	CurrentL1() eth.BlockID

	// VerifiedAtTimestamp returns true if the activity has verified the data at the given timestamp.
	VerifiedAtTimestamp(ts uint64) (bool, error)

	// LatestVerifiedL2Block returns the latest L2 block which has been verified,
	// along with the timestamp at which it was verified.
	LatestVerifiedL2Block(chainID eth.ChainID) (eth.BlockID, uint64)

	// VerifiedBlockAtL1 returns the verified L2 block and timestamp
	// which guarantees that the verified data at that timestamp
	// originates from or before the supplied L1 block.
	VerifiedBlockAtL1(chainID eth.ChainID, l1Block eth.L1BlockRef) (eth.BlockID, uint64)
}