Documentation
¶
Overview ¶
e2e implements the e2e tests.
Index ¶
- Constants
- func AddEphemeralNode(network testnet.Network, flags testnet.FlagsMap) testnet.Node
- func CheckBootstrapIsPossible(network testnet.Network)
- func ContextWithTimeout(duration time.Duration) context.Context
- func DefaultContext() context.Context
- func DescribeCChain(text string, args ...interface{}) bool
- func DescribePChain(text string, args ...interface{}) bool
- func DescribeXChain(text string, args ...interface{}) bool
- func DescribeXChainSerial(text string, args ...interface{}) bool
- func Eventually(condition func() bool, waitFor time.Duration, tick time.Duration, msg string)
- func InitTestEnvironment(envBytes []byte)
- func NewEthClient(nodeURI testnet.NodeURI) ethclient.Client
- func NewWallet(keychain *secp256k1fx.Keychain, nodeURI testnet.NodeURI) primary.Wallet
- func SendEthTransaction(ethClient ethclient.Client, signedTx *types.Transaction) *types.Receipt
- func StartLocalNetwork(avalancheGoExecPath string, networkDir string) *local.LocalNetwork
- func SuggestGasPrice(ethClient ethclient.Client) *big.Int
- func WaitForHealthy(node testnet.Node)
- func WithDefaultContext() common.Option
- func WithSuggestedGasPrice(ethClient ethclient.Client) common.Option
- type TestEnvironment
- func (te *TestEnvironment) AllocateFundedKey() *secp256k1.PrivateKey
- func (te *TestEnvironment) AllocateFundedKeys(count int) []*secp256k1.PrivateKey
- func (te *TestEnvironment) GetNetwork() testnet.Network
- func (te *TestEnvironment) GetRandomNodeURI() testnet.NodeURI
- func (te *TestEnvironment) NewKeychain(count int) *secp256k1fx.Keychain
- func (te *TestEnvironment) NewPrivateNetwork() testnet.Network
Constants ¶
const ( // A long default timeout used to timeout failed operations but // unlikely to induce flaking due to unexpected resource // contention. DefaultTimeout = 2 * time.Minute // Interval appropriate for network operations that should be // retried periodically but not too often. DefaultPollingInterval = 500 * time.Millisecond // Setting this env will disable post-test bootstrap // checks. Useful for speeding up iteration during test // development. SkipBootstrapChecksEnvName = "E2E_SKIP_BOOTSTRAP_CHECKS" // Validator start time must be a minimum of SyncBound from the // current time for validator addition to succeed, and adding 20 // seconds provides a buffer in case of any delay in processing. DefaultValidatorStartTimeDiff = executor.SyncBound + 20*time.Second DefaultGasLimit = uint64(21000) // Standard gas limit // An empty string prompts the use of the default path which ensures a // predictable target for github's upload-artifact action. DefaultNetworkDir = "" // Directory used to store private networks (specific to a single test) // under the shared network dir. PrivateNetworksDirName = "private_networks" )
const ( // Label for filtering a test that is not primarily a C-Chain test // but nonentheless uses the C-Chain. Intended to support // execution of all C-Chain tests by the coreth repo in an e2e job. UsesCChainLabel = "uses-c" )
Variables ¶
This section is empty.
Functions ¶
func AddEphemeralNode ¶ added in v1.10.10
Add an ephemeral node that is only intended to be used by a single test. Its ID and URI are not intended to be returned from the Network instance to minimize accessibility from other tests.
func CheckBootstrapIsPossible ¶ added in v1.10.11
Verify that a new node can bootstrap into the network.
func ContextWithTimeout ¶ added in v1.10.10
Helper simplifying use of a timed context by canceling the context on ginkgo teardown.
func DefaultContext ¶ added in v1.10.10
Helper simplifying use of a timed context configured with the default timeout.
func DescribeCChain ¶ added in v1.10.10
DescribeCChain annotates the tests for C-Chain.
func DescribePChain ¶ added in v1.7.17
DescribePChain annotates the tests for P-Chain.
func DescribeXChain ¶
DescribeXChain annotates the tests for X-Chain.
func DescribeXChainSerial ¶ added in v1.10.9
DescribeXChainSerial annotates serial tests for X-Chain.
func Eventually ¶ added in v1.10.10
Re-implementation of testify/require.Eventually that is compatible with ginkgo. testify's version calls the condition function with a goroutine and ginkgo assertions don't work properly in goroutines.
func InitTestEnvironment ¶ added in v1.10.9
func InitTestEnvironment(envBytes []byte)
func NewEthClient ¶
Create a new eth client targeting the specified node URI.
func SendEthTransaction ¶ added in v1.10.10
Sends an eth transaction, waits for the transaction receipt to be issued and checks that the receipt indicates success.
func StartLocalNetwork ¶ added in v1.10.11
func StartLocalNetwork(avalancheGoExecPath string, networkDir string) *local.LocalNetwork
Start a local test-managed network with the provided avalanchego binary.
func SuggestGasPrice ¶ added in v1.10.10
Determines the suggested gas price for the configured client that will maximize the chances of transaction acceptance.
func WaitForHealthy ¶ added in v1.10.10
Wait for the given node to report healthy.
func WithDefaultContext ¶ added in v1.10.10
Helper simplifying use via an option of a timed context configured with the default timeout.
Types ¶
type TestEnvironment ¶ added in v1.9.9
type TestEnvironment struct { // The directory where the test network configuration is stored NetworkDir string // URIs used to access the API endpoints of nodes of the network URIs []testnet.NodeURI // The URI used to access the http server that allocates test data TestDataServerURI string // contains filtered or unexported fields }
var Env *TestEnvironment
Env is used to access shared test fixture. Intended to be initialized by SynchronizedBeforeSuite.
func (*TestEnvironment) AllocateFundedKey ¶ added in v1.10.9
func (te *TestEnvironment) AllocateFundedKey() *secp256k1.PrivateKey
Retrieve a funded key allocated for the caller's exclusive use.
func (*TestEnvironment) AllocateFundedKeys ¶ added in v1.10.9
func (te *TestEnvironment) AllocateFundedKeys(count int) []*secp256k1.PrivateKey
Retrieve the specified number of funded keys allocated for the caller's exclusive use.
func (*TestEnvironment) GetNetwork ¶ added in v1.10.9
func (te *TestEnvironment) GetNetwork() testnet.Network
Retrieve the network to target for testing.
func (*TestEnvironment) GetRandomNodeURI ¶ added in v1.10.9
func (te *TestEnvironment) GetRandomNodeURI() testnet.NodeURI
Retrieve a random URI to naively attempt to spread API load across nodes.
func (*TestEnvironment) NewKeychain ¶ added in v1.10.9
func (te *TestEnvironment) NewKeychain(count int) *secp256k1fx.Keychain
Create a new keychain with the specified number of test keys.
func (*TestEnvironment) NewPrivateNetwork ¶ added in v1.10.11
func (te *TestEnvironment) NewPrivateNetwork() testnet.Network
Create a new private network that is not shared with other tests.
Directories
¶
Path | Synopsis |
---|---|
Implements tests for the banff network upgrade.
|
Implements tests for the banff network upgrade. |
AUTOMATICALLY GENERATED.
|
AUTOMATICALLY GENERATED. |
Implements static handlers tests for avm and platformvm
|
Implements static handlers tests for avm and platformvm |
transfer
Implements X-chain transfer tests.
|
Implements X-chain transfer tests. |