sysgo

package
v1.13.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 11, 2025 License: MIT Imports: 111 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ConnectP2P added in v1.13.5

func ConnectP2P(ctx context.Context, require *testreq.Assertions, initiator RpcCaller, acceptor RpcCaller)

ConnectP2P creates a p2p peer connection between node1 and node2.

func DefaultInteropProofsSystem added in v1.13.4

func DefaultInteropProofsSystem(dest *DefaultInteropSystemIDs) stack.Option[*Orchestrator]

func DefaultInteropSystem

func DefaultInteropSystem(dest *DefaultInteropSystemIDs) stack.Option[*Orchestrator]

func DefaultMinimalSystem added in v1.13.4

func DefaultMinimalSystem(dest *DefaultMinimalSystemIDs) stack.Option[*Orchestrator]

func DefaultSingleChainInteropSystem added in v1.13.4

func DefaultSingleChainInteropSystem(dest *DefaultSingleChainInteropSystemIDs) stack.Option[*Orchestrator]

func DefaultSingleChainMultiNodeSystem added in v1.13.5

func DefaultSingleChainMultiNodeSystem(dest *DefaultSingleChainMultiNodeSystemIDs) stack.Option[*Orchestrator]

func GetP2PClient

func GetP2PClient(ctx context.Context, logger log.Logger, l2CLNode *L2CLNode) (*sources.P2PClient, error)

func GetPeerInfo

func GetPeerInfo(ctx context.Context, p2pClient *sources.P2PClient) (*apis.PeerInfo, error)

func GetPeers

func GetPeers(ctx context.Context, p2pClient *sources.P2PClient) (*apis.PeerDump, error)

func MultiSupervisorInteropSystem added in v1.13.4

func MultiSupervisorInteropSystem(dest *MultiSupervisorInteropSystemIDs) stack.Option[*Orchestrator]

func WithBatcher

func WithBatcher(batcherID stack.L2BatcherID, l1ELID stack.L1ELNodeID, l2CLID stack.L2CLNodeID, l2ELID stack.L2ELNodeID) stack.Option[*Orchestrator]

func WithBatcherOption added in v1.13.4

func WithBatcherOption(opt BatcherOption) stack.Option[*Orchestrator]

func WithDeployer

func WithDeployer() stack.Option[*Orchestrator]

func WithDeployerOptions

func WithDeployerOptions(opts ...DeployerOption) stack.Option[*Orchestrator]

func WithDeployerPipelineOption added in v1.13.4

func WithDeployerPipelineOption(opt DeployerPipelineOption) stack.Option[*Orchestrator]

func WithFaucets

func WithFaucets(l1ELs []stack.L1ELNodeID, l2ELs []stack.L2ELNodeID) stack.Option[*Orchestrator]

func WithL1Nodes

func WithL1Nodes(l1ELID stack.L1ELNodeID, l1CLID stack.L1CLNodeID) stack.Option[*Orchestrator]

func WithL2CLNode

func WithL2CLNode(l2CLID stack.L2CLNodeID, isSequencer bool, indexingMode bool, l1CLID stack.L1CLNodeID, l1ELID stack.L1ELNodeID, l2ELID stack.L2ELNodeID) stack.Option[*Orchestrator]

func WithL2CLOption added in v1.13.5

func WithL2CLOption(opt L2CLOption) stack.Option[*Orchestrator]

func WithL2CLP2PConnection

func WithL2CLP2PConnection(l2CL1ID, l2CL2ID stack.L2CLNodeID) stack.Option[*Orchestrator]

WithL2CLP2PConnection connects P2P between two L2CLs

func WithL2Challenger added in v1.13.4

func WithL2Challenger(challengerID stack.L2ChallengerID, l1ELID stack.L1ELNodeID, l1CLID stack.L1CLNodeID,
	supervisorID *stack.SupervisorID, clusterID *stack.ClusterID, l2CLID *stack.L2CLNodeID, l2ELIDs []stack.L2ELNodeID,
) stack.Option[*Orchestrator]

func WithL2ChallengerPostDeploy added in v1.13.4

func WithL2ChallengerPostDeploy(orch *Orchestrator, challengerID stack.L2ChallengerID, l1ELID stack.L1ELNodeID, l1CLID stack.L1CLNodeID,
	supervisorID *stack.SupervisorID, clusterID *stack.ClusterID, l2CLID *stack.L2CLNodeID, l2ELIDs []stack.L2ELNodeID,
)

func WithL2ELNode

func WithL2ELNode(id stack.L2ELNodeID, supervisorID *stack.SupervisorID) stack.Option[*Orchestrator]

func WithL2ELP2PConnection added in v1.13.5

func WithL2ELP2PConnection(l2EL1ID, l2EL2ID stack.L2ELNodeID) stack.Option[*Orchestrator]

func WithManagedBySupervisor

func WithManagedBySupervisor(l2CLID stack.L2CLNodeID, supervisorID stack.SupervisorID) stack.Option[*Orchestrator]

func WithMnemonicKeys

func WithMnemonicKeys(mnemonic string) stack.Option[*Orchestrator]

func WithProposer

func WithProposer(proposerID stack.L2ProposerID, l1ELID stack.L1ELNodeID,
	l2CLID *stack.L2CLNodeID, supervisorID *stack.SupervisorID) stack.Option[*Orchestrator]

func WithProposerOption added in v1.13.4

func WithProposerOption(opt ProposerOption) stack.Option[*Orchestrator]

func WithProposerPostDeploy added in v1.13.4

func WithProposerPostDeploy(orch *Orchestrator, proposerID stack.L2ProposerID, l1ELID stack.L1ELNodeID,
	l2CLID *stack.L2CLNodeID, supervisorID *stack.SupervisorID)

func WithSuperL2Challenger added in v1.13.4

func WithSuperL2Challenger(challengerID stack.L2ChallengerID, l1ELID stack.L1ELNodeID, l1CLID stack.L1CLNodeID,
	supervisorID *stack.SupervisorID, clusterID *stack.ClusterID, l2ELIDs []stack.L2ELNodeID,
) stack.Option[*Orchestrator]

func WithSuperProposer added in v1.13.4

func WithSuperProposer(proposerID stack.L2ProposerID, l1ELID stack.L1ELNodeID,
	supervisorID *stack.SupervisorID) stack.Option[*Orchestrator]

func WithSuperRoots added in v1.13.4

func WithSuperRoots(l1ChainID eth.ChainID, l1ELID stack.L1ELNodeID, l2CLID stack.L2CLNodeID, supervisorID stack.SupervisorID, primaryL2 eth.ChainID) stack.Option[*Orchestrator]

func WithSupervisor

func WithSupervisor(supervisorID stack.SupervisorID, clusterID stack.ClusterID, l1ELID stack.L1ELNodeID) stack.Option[*Orchestrator]

func WithTestSequencer added in v1.13.4

func WithTestSequencer(testSequencerID stack.TestSequencerID, l1CLID stack.L1CLNodeID, l2CLID stack.L2CLNodeID, l1ELID stack.L1ELNodeID, l2ELID stack.L2ELNodeID) stack.Option[*Orchestrator]

Types

type BatcherOption added in v1.13.4

type BatcherOption func(id stack.L2BatcherID, cfg *bss.CLIConfig)

type Cluster

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

func (*Cluster) DepSet added in v1.13.4

type ContractPaths

type ContractPaths struct {
	// must be absolute paths, without file:// prefix
	FoundryArtifacts string
	SourceMap        string
}

type ControlPlane

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

func (*ControlPlane) FakePoSState added in v1.13.4

func (c *ControlPlane) FakePoSState(id stack.L1CLNodeID, mode stack.ControlAction)

func (*ControlPlane) L2CLNodeState

func (c *ControlPlane) L2CLNodeState(id stack.L2CLNodeID, mode stack.ControlAction)

func (*ControlPlane) L2ELNodeState added in v1.13.5

func (c *ControlPlane) L2ELNodeState(id stack.L2ELNodeID, mode stack.ControlAction)

func (*ControlPlane) SupervisorState

func (c *ControlPlane) SupervisorState(id stack.SupervisorID, mode stack.ControlAction)

type DefaultInteropSystemIDs

type DefaultInteropSystemIDs struct {
	DefaultSingleChainInteropSystemIDs

	L2B   stack.L2NetworkID
	L2BCL stack.L2CLNodeID
	L2BEL stack.L2ELNodeID

	L2BBatcher    stack.L2BatcherID
	L2BProposer   stack.L2ProposerID
	L2ChallengerB stack.L2ChallengerID
}

struct of the services, so we can access them later and do not have to guess their IDs.

func NewDefaultInteropSystemIDs

func NewDefaultInteropSystemIDs(l1ID, l2AID, l2BID eth.ChainID) DefaultInteropSystemIDs

type DefaultMinimalSystemIDs added in v1.13.4

type DefaultMinimalSystemIDs struct {
	L1   stack.L1NetworkID
	L1EL stack.L1ELNodeID
	L1CL stack.L1CLNodeID

	L2   stack.L2NetworkID
	L2CL stack.L2CLNodeID
	L2EL stack.L2ELNodeID

	L2Batcher    stack.L2BatcherID
	L2Proposer   stack.L2ProposerID
	L2Challenger stack.L2ChallengerID

	TestSequencer stack.TestSequencerID
}

func NewDefaultMinimalSystemIDs added in v1.13.4

func NewDefaultMinimalSystemIDs(l1ID, l2ID eth.ChainID) DefaultMinimalSystemIDs

type DefaultSingleChainInteropSystemIDs added in v1.13.4

type DefaultSingleChainInteropSystemIDs struct {
	L1   stack.L1NetworkID
	L1EL stack.L1ELNodeID
	L1CL stack.L1CLNodeID

	Superchain stack.SuperchainID
	Cluster    stack.ClusterID

	Supervisor    stack.SupervisorID
	TestSequencer stack.TestSequencerID

	L2A   stack.L2NetworkID
	L2ACL stack.L2CLNodeID
	L2AEL stack.L2ELNodeID

	L2ABatcher    stack.L2BatcherID
	L2AProposer   stack.L2ProposerID
	L2ChallengerA stack.L2ChallengerID
}

func NewDefaultSingleChainInteropSystemIDs added in v1.13.4

func NewDefaultSingleChainInteropSystemIDs(l1ID, l2AID eth.ChainID) DefaultSingleChainInteropSystemIDs

type DefaultSingleChainMultiNodeSystemIDs added in v1.13.5

type DefaultSingleChainMultiNodeSystemIDs struct {
	DefaultMinimalSystemIDs

	L2CLB stack.L2CLNodeID
	L2ELB stack.L2ELNodeID
}

func NewDefaultSingleChainMultiNodeSystemIDs added in v1.13.5

func NewDefaultSingleChainMultiNodeSystemIDs(l1ID, l2ID eth.ChainID) DefaultSingleChainMultiNodeSystemIDs

type DeployerOption

type DeployerOption func(p devtest.P, keys devkeys.Keys, builder intentbuilder.Builder)

func WithAdditionalDisputeGames added in v1.13.4

func WithAdditionalDisputeGames(games []state.AdditionalDisputeGame) DeployerOption

WithAdditionalDisputeGames adds additional dispute games to all L2s.

func WithCommons

func WithCommons(l1ChainID eth.ChainID) DeployerOption

func WithDisputeGameFinalityDelaySeconds added in v1.13.4

func WithDisputeGameFinalityDelaySeconds(seconds uint64) DeployerOption

func WithFinalizationPeriodSeconds added in v1.13.4

func WithFinalizationPeriodSeconds(n uint64) DeployerOption

WithFinalizationPeriodSeconds overrides the number of L1 blocks in a sequencing window, applied to all L2s.

func WithGuardianMatchL1PAO added in v1.13.4

func WithGuardianMatchL1PAO() DeployerOption

func WithInteropAtGenesis

func WithInteropAtGenesis() DeployerOption

WithInteropAtGenesis activates interop at genesis for all known L2s

func WithLocalContractSources

func WithLocalContractSources() DeployerOption

func WithPrefundedL2

func WithPrefundedL2(l1ChainID, l2ChainID eth.ChainID) DeployerOption

func WithProofMaturityDelaySeconds added in v1.13.4

func WithProofMaturityDelaySeconds(n uint64) DeployerOption

func WithSequencingWindow added in v1.13.4

func WithSequencingWindow(n uint64) DeployerOption

WithSequencingWindow overrides the number of L1 blocks in a sequencing window, applied to all L2s.

type DeployerPipelineOption added in v1.13.4

type DeployerPipelineOption func(wb *worldBuilder, intent *state.Intent, cfg *deployer.ApplyPipelineOpts)

func WithDeployerMatchL1PAO added in v1.13.4

func WithDeployerMatchL1PAO() DeployerPipelineOption

type FakePoS added in v1.13.4

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

func (*FakePoS) Start added in v1.13.4

func (f *FakePoS) Start()

func (*FakePoS) Stop added in v1.13.4

func (f *FakePoS) Stop()

type FaucetService

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

type InteropMigration added in v1.13.4

type InteropMigration struct {
	DisputeGameFactory common.Address
}

type L1CLNode

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

type L1ELNode

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

type L1Network

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

type L2Batcher

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

type L2CLNode

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

func (*L2CLNode) Start

func (n *L2CLNode) Start()

func (*L2CLNode) Stop

func (n *L2CLNode) Stop()

type L2CLOption added in v1.13.5

type L2CLOption func(p devtest.P, id stack.L2CLNodeID, cfg *config.Config)

type L2Challenger added in v1.13.4

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

type L2Deployment

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

func (*L2Deployment) DisputeGameFactoryProxyAddr

func (d *L2Deployment) DisputeGameFactoryProxyAddr() common.Address

func (*L2Deployment) SystemConfigProxyAddr

func (d *L2Deployment) SystemConfigProxyAddr() common.Address

type L2ELNode

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

func (*L2ELNode) Start added in v1.13.5

func (n *L2ELNode) Start()

func (*L2ELNode) Stop added in v1.13.5

func (n *L2ELNode) Stop()

type L2Network

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

type L2Proposer

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

type MultiSupervisorInteropSystemIDs added in v1.13.4

type MultiSupervisorInteropSystemIDs struct {
	DefaultInteropSystemIDs

	// Supervisor does not support multinode so need a additional supervisor for verifier nodes
	SupervisorSecondary stack.SupervisorID

	L2A2CL stack.L2CLNodeID
	L2A2EL stack.L2ELNodeID
	L2B2CL stack.L2CLNodeID
	L2B2EL stack.L2ELNodeID
}

type Orchestrator

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

func NewOrchestrator

func NewOrchestrator(p devtest.P, hook stack.SystemHook) *Orchestrator

func (*Orchestrator) ClusterForL2 added in v1.13.4

func (o *Orchestrator) ClusterForL2(chainID eth.ChainID) (*Cluster, bool)

func (*Orchestrator) ControlPlane

func (o *Orchestrator) ControlPlane() stack.ControlPlane

func (*Orchestrator) EnableTimeTravel added in v1.13.4

func (o *Orchestrator) EnableTimeTravel()

func (*Orchestrator) Hydrate

func (o *Orchestrator) Hydrate(sys stack.ExtensibleSystem)

func (*Orchestrator) P

func (o *Orchestrator) P() devtest.P

func (*Orchestrator) Type added in v1.13.4

func (o *Orchestrator) Type() compat.Type

type ProposerOption added in v1.13.4

type ProposerOption func(id stack.L2ProposerID, cfg *ps.CLIConfig)

type RpcCaller added in v1.13.5

type RpcCaller interface {
	CallContext(ctx context.Context, result interface{}, method string, args ...interface{}) error
}

type Superchain

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

type SuperchainDeployment

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

func (*SuperchainDeployment) ProtocolVersionsAddr

func (d *SuperchainDeployment) ProtocolVersionsAddr() common.Address

func (*SuperchainDeployment) SuperchainConfigAddr

func (d *SuperchainDeployment) SuperchainConfigAddr() common.Address

type Supervisor

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

func (*Supervisor) Start

func (s *Supervisor) Start()

func (*Supervisor) Stop

func (s *Supervisor) Stop()

type TestSequencer added in v1.13.4

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

Jump to

Keyboard shortcuts

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