virtual_node

package

v1.18.1 Latest Latest Go to latest Published: May 14, 2026 License: MIT Imports: 12 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/ethereum-optimism/optimism

Links

Documentation ¶

Index ¶

Constants
Variables
func NewVirtualNode(cfg *opnodecfg.Config, log gethlog.Logger, ...) *simpleVirtualNode
type VNState
type VirtualNode

Constants ¶

View Source

const VIRTUAL_NODE_CHAIN_ID_LABEL = "virtual_node_chain_id"

VIRTUAL_NODE_CHAIN_ID_LABEL is the name of the label used to differentiate metrics registered by virtual nodes.

Variables ¶

View Source

var (
	ErrVirtualNodeConfigNil      = errors.New("virtual node config is nil")
	ErrVirtualNodeAlreadyRunning = errors.New("virtual node already running")
	ErrVirtualNodeNotRunning     = errors.New("virtual node not running")
	ErrVirtualNodeCantStart      = errors.New("virtual node cannot be started in this state")
)

View Source

var ErrL1AtSafeHeadNotFound = errors.New("l1 at safe head not found")

ErrL1AtSafeHeadNotFound: transient — SafeDB hasn't observed the answer yet (target ahead of latest, or DB empty at startup). Retry.

View Source

var ErrL1AtSafeHeadUnavailable = errors.New("l1 at safe head history unavailable")

ErrL1AtSafeHeadUnavailable: permanent on this node — the crossing happened before SafeDB started recording (snap/CL-sync bootstrap), or the walkback reached the genesis bound. Retrying won't help; operator must intervene.

Functions ¶

func NewVirtualNode ¶

func NewVirtualNode(cfg *opnodecfg.Config, log gethlog.Logger, initOverload *rollupNode.InitializationOverrides, appVersion string) *simpleVirtualNode

Types ¶

type VNState ¶

type VNState int

const (
	VNStateNotStarted VNState = iota
	VNStateRunning
	VNStateStopped
)

type VirtualNode ¶

type VirtualNode interface {
	Start(ctx context.Context) error
	Stop(ctx context.Context) error

	SafeHeadAtL1(ctx context.Context, l1BlockNum uint64) (eth.BlockID, eth.BlockID, error)
	// L1AtSafeHead returns the earliest L1 block at which the given L2 block became safe.
	L1AtSafeHead(ctx context.Context, target eth.BlockID) (eth.BlockID, error)
	SyncStatus(ctx context.Context) (*eth.SyncStatus, error)
}

Source Files ¶

View all Source files

virtual_node.go

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