interop

package

Go to main page

Versions in this module

v1

v1.18.1

May 14, 2026

Changes in this version

+ var ErrBeforeVerifiedDB = errors.New("timestamp below verified-db start")

+ var ErrExecutedTooEarly = errors.New("interop is not active for at least one block on the executing chain")

+ var ErrInitiatedTooEarly = errors.New("interop is not active for at least one block on the initiating chain")

+ var ErrNotActive = errors.New("interop not active for timestamp")

+ var ErrNotStarted = errors.New("interop activity not started")

type Interop

+ func (i *Interop) VerifiedResultAtTimestamp(ts uint64) (VerifiedResult, eth.BlockID, error)

+ type NoopVerifiedResultReader struct

+ func (NoopVerifiedResultReader) VerifiedResultAtTimestamp(uint64) (VerifiedResult, eth.BlockID, error)

type RoundObservation

+ L1NeedsRewind bool

+ type VerifiedResultReader interface

+ VerifiedResultAtTimestamp func(ts uint64) (result VerifiedResult, currentL1 eth.BlockID, err error)

v1.18.0

May 6, 2026

Changes in this version

type VerifiedDB

+ func (v *VerifiedDB) FirstTimestamp() (uint64, bool)

v1.17.0

Apr 28, 2026

v1.16.13

Apr 16, 2026

v1.16.12

Apr 9, 2026

v1.16.11

Apr 1, 2026

v1.16.10

Mar 25, 2026

v1.16.9

Mar 18, 2026

v1.16.7

Feb 19, 2026

Changes in this version

+ const ExpiryTime

type Result

+ L1Head eth.BlockID

type VerifiedDB

+ func (v *VerifiedDB) RewindAfter(timestamp uint64) (bool, error)

type VerifiedResult

+ L1Head eth.BlockID

v0

v0.32.0

Apr 27, 2026

Changes in this version

+ var ErrAlreadyCommitted = errors.New("timestamp already committed")

+ var ErrCycle = errors.New("cycle detected in same-timestamp messages")

+ var ErrMessageExpired = errors.New("initiating message has expired")

+ var ErrNonSequential = errors.New("timestamps must be committed sequentially with no gaps")

+ var ErrNotFound = errors.New("timestamp not found")

+ var ErrParentHashMismatch = errors.New("block parent hash does not match logsDB")

+ var ErrPreviousTimestampNotSealed = errors.New("previous timestamp not sealed in logsDB")

+ var ErrStaleLogsDB = errors.New("logsDB has stale block data from a reorg")

+ var ErrTimestampViolation = errors.New(...)

+ var ErrUnknownChain = errors.New("unknown chain")

+ var InteropActivationTimestampFlag = &cli.Uint64Flag

+ var InteropLogBackfillDepthFlag = &cli.DurationFlag

+ type Decision int

+ const DecisionAdvance

+ const DecisionInvalidate

+ const DecisionRewind

+ const DecisionWait

+ func (d *Decision) UnmarshalJSON(data []byte) error

+ func (d Decision) MarshalJSON() ([]byte, error)

+ func (d Decision) String() string

+ type Interop struct

+ func New(log log.Logger, activationTimestamp uint64, messageExpiryWindow uint64, ...) *Interop

+ func (i *Interop) ActivationTimestamp() uint64

+ func (i *Interop) BackfillAttempts() int32

+ func (i *Interop) BackfillCompleted() bool

+ func (i *Interop) BackfillEndTimestamp() uint64

+ func (i *Interop) CurrentL1() eth.BlockID

+ func (i *Interop) FirstSealedBlock(chainID eth.ChainID) (suptypes.BlockSeal, error)

+ func (i *Interop) FirstVerifiableTimestamp() uint64

+ func (i *Interop) IsActiveAt(ts uint64) bool

+ func (i *Interop) LatestSealedBlock(chainID eth.ChainID) (suptypes.BlockSeal, bool, error)

+ func (i *Interop) LatestVerifiedL2Block(chainID eth.ChainID) (eth.BlockID, uint64)

+ func (i *Interop) Name() string

+ func (i *Interop) PauseAt(ts uint64)

+ func (i *Interop) Reset(chainID eth.ChainID, timestamp uint64, invalidatedBlock eth.BlockRef)

+ func (i *Interop) Resume()

+ func (i *Interop) Start(ctx context.Context) error

+ func (i *Interop) Stop(ctx context.Context) error

+ func (i *Interop) VerifiedAtTimestamp(ts uint64) (bool, error)

+ func (i *Interop) VerifiedBlockAtL1(chainID eth.ChainID, l1Block eth.L1BlockRef) (eth.BlockID, uint64)

+ type InvalidHead struct

+ MessagePasserStorageRoot eth.Bytes32

+ StateRoot eth.Bytes32

+ type LogsDB interface

+ AddLog func(logHash common.Hash, parentBlock eth.BlockID, logIdx uint32, ...) error

+ Clear func(inv reads.Invalidator) error

+ Close func() error

+ Contains func(query types.ContainsQuery) (types.BlockSeal, error)

+ FindSealedBlock func(number uint64) (types.BlockSeal, error)

+ FirstSealedBlock func() (types.BlockSeal, error)

+ LatestSealedBlock func() (eth.BlockID, bool)

+ OpenBlock func(blockNum uint64) (ref eth.BlockRef, logCount uint32, execMsgs map[uint32]*types.ExecutingMessage, ...)

+ Rewind func(inv reads.Invalidator, newHead eth.BlockID) error

+ SealBlock func(parentHash common.Hash, block eth.BlockID, timestamp uint64) error

+ type PendingInvalidation struct

+ BlockID eth.BlockID

+ ChainID eth.ChainID

+ MessagePasserStorageRoot eth.Bytes32

+ StateRoot eth.Bytes32

+ Timestamp uint64

+ type PendingTransition struct

+ Decision Decision

+ Result *Result

+ Rewind *RewindPlan

+ type Result struct

+ InvalidHeads map[eth.ChainID]InvalidHead

+ L1Inclusion eth.BlockID

+ L2Heads map[eth.ChainID]eth.BlockID

+ Timestamp uint64

+ func (r *Result) IsEmpty() bool

+ func (r *Result) IsValid() bool

+ func (r *Result) ToVerifiedResult() VerifiedResult

+ type RewindPlan struct

+ ResetAllChainsTo *uint64

+ RewindAtOrAfter uint64

+ TargetHeads map[eth.ChainID]eth.BlockID

+ type RoundObservation struct

+ BlocksAtTS map[eth.ChainID]eth.BlockID

+ ChainsReady bool

+ L1Consistent bool

+ L1Heads map[eth.ChainID]eth.BlockID

+ LastVerified *VerifiedResult

+ LastVerifiedTS *uint64

+ NextTimestamp uint64

+ Paused bool

+ type StepOutput struct

+ Decision Decision

+ Result Result

+ type VerifiedDB struct

+ func OpenVerifiedDB(dataDir string) (*VerifiedDB, error)

+ func (v *VerifiedDB) ClearPendingTransition() error

+ func (v *VerifiedDB) Close() error

+ func (v *VerifiedDB) Commit(result VerifiedResult) error

+ func (v *VerifiedDB) Get(ts uint64) (VerifiedResult, error)

+ func (v *VerifiedDB) GetPendingTransition() (*PendingTransition, error)

+ func (v *VerifiedDB) Has(ts uint64) (bool, error)

+ func (v *VerifiedDB) LastTimestamp() (uint64, bool)

+ func (v *VerifiedDB) Rewind(timestamp uint64) (bool, error)

+ func (v *VerifiedDB) SetPendingTransition(pending PendingTransition) error

+ type VerifiedResult struct

+ L1Inclusion eth.BlockID

+ L2Heads map[eth.ChainID]eth.BlockID

+ Timestamp uint64

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL