e2e

Documentation

Overview

Package e2e implements the Oasis e2e test scenarios.

Index

• Variables
• func RegisterScenarios() error
• type E2E
  • func NewE2E(name string) *E2E
  • func (sc *E2E) Clone() E2E
  • func (sc *E2E) DumpRestoreNetwork(childEnv *env.Env, fixture *oasis.NetworkFixture, doDbDump bool) error
  • func (sc *E2E) Fixture() (*oasis.NetworkFixture, error)
  • func (sc *E2E) Init(childEnv *env.Env, net *oasis.Network) error
  • func (sc *E2E) Name() string
  • func (sc *E2E) Parameters() *env.ParameterFlagSet
  • func (sc *E2E) PreInit(childEnv *env.Env) error
  • func (sc *E2E) ResetConsensusState(childEnv *env.Env) error

Variables

var (
	// GasFeesStaking is the staking gas fees scenario.
	GasFeesStaking scenario.Scenario = &gasFeesImpl{
		E2E: *NewE2E("gas-fees/staking"),
	}

	// GasFeesStakingDumpRestore is the staking gas fees scenario with
	// dump-restore.
	GasFeesStakingDumpRestore scenario.Scenario = &gasFeesImpl{
		E2E:         *NewE2E("gas-fees/staking-dump-restore"),
		dumpRestore: true,
	}
)

var (
	EntityAccount = stakingTests.AddressFromString("oasis1qq7us2p22udg2t24u6ry4m29wzql005pjsske8gt")
	LockupAccount = stakingTests.AddressFromString("oasis1qpt202cf6t0s5ugkk34p83yf0c30gpjkny92u7dh")

	MysteryAccount0 = stakingTests.AddressFromString("oasis1qryg8qf3ydzcphr328l8psz007fms9dxeuy8lgzq")
	MysteryAccount1 = stakingTests.AddressFromString("oasis1qz74khszg55gfnmpxut3t3gdymn76hfchu9nhtd0")
	MysteryAccount8 = stakingTests.AddressFromString("oasis1qqkspsglt3quhpkghr837trfwm048srjuv8g92jj")

	MysteryAccount2 = stakingTests.AddressFromString("oasis1qp6tl30ljsrrqnw2awxxu2mtxk0qxyy2nymtsy90")
	MysteryAccount3 = stakingTests.AddressFromString("oasis1qr77y0cqdzcqgz2wqkv59yz0j4vfvyryfv8vxllt")
	MysteryAccount4 = stakingTests.AddressFromString("oasis1qzyw75ds6nw0af98xfmmpl3z8sgf3mdslvtzzcn6")
	MysteryAccount9 = stakingTests.AddressFromString("oasis1qrp7l53vn6h2z7p242ldtkqtttz2jf9dwsgu05aa")

	MysteryAccount5 = stakingTests.AddressFromString("oasis1qrhp36j49ncpaac0aufwyuvtk04nfxcj2yq7y4my")
	MysteryAccount6 = stakingTests.AddressFromString("oasis1qzc2fexm30puzq2cmlm832fvpnyaxrq33cx4zukj")

	MysteryAccount7  = stakingTests.AddressFromString("oasis1qpx0k28va6n0r25qd2j4jdh9f42n5vex6s9lp780")
	MysteryAccount10 = stakingTests.AddressFromString("oasis1qz30d8mqzrsrsu7fr0e6nxk0ze7ffdkj8ur7sqp0")
)

The people that made all the test staking genesis documents neglected to really add comments where these accounts came from. Presumably they are deterministically generated identities of various things. Someone can go back and derive these at a later date.

Ordering of the mystery accounts replicates what was in the txsource and gas fees JSON documents.

WARNING: Adding more MysteryAccounts is cause for immediate rejection of future proposed changes. This list should shrink, not grow.

var ConsensusStateSync scenario.Scenario = &consensusStateSyncImpl{
	E2E: *NewE2E("consensus-state-sync"),
}

ConsensusStateSync is the consensus state sync scenario.

var Debond scenario.Scenario = &debondImpl{
	E2E: *NewE2E("debond"),
}

Debond tests debonding records created in the genesis document.

var EarlyQuery scenario.Scenario = &earlyQueryImpl{
	E2E: *NewE2E("early-query"),
}

EarlyQuery is the early query scenario where we query a validator node before the network has started and there are no committed blocks.

var IdentityCLI scenario.Scenario = &identityCLIImpl{
	E2E: *NewE2E("identity-cli"),
}

IdentityCLI is the identity CLI scenario.

var (
	// NodeUpgrade is the node upgrade scenario.
	NodeUpgrade scenario.Scenario = newNodeUpgradeImpl()
)

var (
	// NodeUpgradeCancel is the node upgrade scenario.
	NodeUpgradeCancel scenario.Scenario = newNodeUpgradeCancelImpl()
)

var RegistryCLI scenario.Scenario = &registryCLIImpl{
	E2E: *NewE2E("registry-cli"),
}

RegistryCLI is the registry CLI test scenario.

var (

	// StakeCLI is the staking scenario.
	StakeCLI scenario.Scenario = &stakeCLIImpl{
		E2E: *NewE2E("stake-cli"),
	}
)

Functions

func RegisterScenarios

func RegisterScenarios() error

RegisterScenarios registers all end-to-end scenarios.

Types

type E2E

type E2E struct {
	Net    *oasis.Network
	Flags  *env.ParameterFlagSet
	Logger *logging.Logger
	// contains filtered or unexported fields
}

E2E is a base scenario for oasis-node end-to-end tests.

var E2eParamsDummy *E2E = NewE2E("")

E2eParamsDummy is a dummy instance of E2E used to register global e2e flags.

func NewE2E

func NewE2E(name string) *E2E

NewE2E creates a new base scenario for oasis-node end-to-end tests.

func (*E2E) Clone

func (sc *E2E) Clone() E2E

Implements scenario.Scenario.

func (*E2E) DumpRestoreNetwork

func (sc *E2E) DumpRestoreNetwork(childEnv *env.Env, fixture *oasis.NetworkFixture, doDbDump bool) error

DumpRestoreNetwork first dumps the current network state and then attempts to restore it.

func (*E2E) Fixture

func (sc *E2E) Fixture() (*oasis.NetworkFixture, error)

Implements scenario.Scenario.

func (*E2E) Init

func (sc *E2E) Init(childEnv *env.Env, net *oasis.Network) error

Implements scenario.Scenario.

func (*E2E) Name

func (sc *E2E) Name() string

Implements scenario.Scenario.

func (*E2E) Parameters

func (sc *E2E) Parameters() *env.ParameterFlagSet

Implements scenario.Scenario.

func (*E2E) PreInit

func (sc *E2E) PreInit(childEnv *env.Env) error

Implements scenario.Scenario.

func (*E2E) ResetConsensusState

func (sc *E2E) ResetConsensusState(childEnv *env.Env) error

ResetConsensusState removes all consensus state, preserving runtime storage and node-local storage databases.