testutils

package
v0.38.0-preview.0.2 Latest Latest
Warning

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

 Go to latest Published: Nov 23, 2024 License: AGPL-3.0 Imports: 43 Imported by: 0

Documentation

Index

Constants

View Source 
const EOATestAccount1KeyHex = "9c647b8b7c4e7c3490668fb6c11473619db80c93704c70893d3813af4090c39c"

address: 658bdf435d810c91414ec09147daa6db62406379

Variables

View Source 
var TestComputationLimit = uint(100_000_000)
View Source 
var TestFlowEVMRootAddress = flow.Address{1, 2, 3, 4}

Functions

func AggregatedPrecompiledCallsFixture added in v0.36.3 

func AggregatedPrecompiledCallsFixture(t testing.TB) types.AggregatedPrecompiledCalls

func BlockEventToPayload added in v0.36.2 

func BlockEventToPayload(t testing.TB, event flow.Event, evmContract flow.Address) *events.BlockEventPayload

func COAOwnershipProofFixture added in v0.33.30 

func COAOwnershipProofFixture(t testing.TB) *types.COAOwnershipProof

func COAOwnershipProofInContextFixture added in v0.33.30 

func COAOwnershipProofInContextFixture(t testing.TB) *types.COAOwnershipProofInContext

func CheckCadenceEventTypes added in v0.33.30 

func CheckCadenceEventTypes(t testing.TB, events []cadence.Event, expectedTypes []string)

func ConvertToCadence 

func ConvertToCadence(data []byte) []cadence.Value

func DeployContract 

func DeployContract(t testing.TB, caller types.Address, tc *TestContract, led atree.Ledger, flowEVMRootAddress flow.Address)

func EncodeArgs 

func EncodeArgs(argValues []cadence.Value) [][]byte

func GetRandomLogFixture 

func GetRandomLogFixture(t testing.TB) *gethTypes.Log

func MakeCallData added in v0.33.30 

func MakeCallData(t testing.TB, abiString string, name string, args ...interface{}) []byte

func RandomAddress 

func RandomAddress(t testing.TB) types.Address

func RandomBigInt 

func RandomBigInt(limit int64) *big.Int

func RandomCommonAddress 

func RandomCommonAddress(t testing.TB) gethCommon.Address

func RandomCommonHash 

func RandomCommonHash(t testing.TB) gethCommon.Hash

func RandomData 

func RandomData(t testing.TB) []byte

func RandomGas 

func RandomGas(limit int64) uint64

func RandomResultFixture added in v0.36.2 

func RandomResultFixture(t testing.TB) *types.Result

func RandomUint256Int added in v0.36.2 

func RandomUint256Int(limit int64) *uint256.Int

func RunWithDeployedContract 

func RunWithDeployedContract(t testing.TB, tc *TestContract, led atree.Ledger, flowEVMRootAddress flow.Address, f func(*TestContract))

func RunWithEOATestAccount 

func RunWithEOATestAccount(t testing.TB, led atree.Ledger, flowEVMRootAddress flow.Address, f func(*EOATestAccount))

func RunWithTestBackend 

func RunWithTestBackend(t testing.TB, f func(*TestBackend))

func RunWithTestFlowEVMRootAddress 

func RunWithTestFlowEVMRootAddress(t testing.TB, backend atree.Ledger, f func(flow.Address))

func SetupHandler 

func SetupHandler(
	chainID flow.ChainID,
	backend types.Backend,
	rootAddr flow.Address,
) *handler.ContractHandler

func TxEventToPayload added in v0.36.2 

func TxEventToPayload(t testing.TB, event flow.Event, evmContract flow.Address) *events.TransactionEventPayload

Types

type EOATestAccount 

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

func FundAndGetEOATestAccount 

func FundAndGetEOATestAccount(t testing.TB, led atree.Ledger, flowEVMRootAddress flow.Address) *EOATestAccount

func GetTestEOAAccount 

func GetTestEOAAccount(t testing.TB, keyHex string) *EOATestAccount

func (*EOATestAccount) Address 

func (a *EOATestAccount) Address() types.Address

func (*EOATestAccount) Nonce added in v0.33.30 

func (a *EOATestAccount) Nonce() uint64

func (*EOATestAccount) PrepareAndSignTx 

func (a *EOATestAccount) PrepareAndSignTx(
	t testing.TB,
	to gethCommon.Address,
	data []byte,
	amount *big.Int,
	gasLimit uint64,
	gasPrice *big.Int,
) *gethTypes.Transaction

func (*EOATestAccount) PrepareSignAndEncodeTx 

func (a *EOATestAccount) PrepareSignAndEncodeTx(
	t testing.TB,
	to gethCommon.Address,
	data []byte,
	amount *big.Int,
	gasLimit uint64,
	gasPrice *big.Int,
) []byte

func (*EOATestAccount) SetNonce 

func (a *EOATestAccount) SetNonce(nonce uint64)

func (*EOATestAccount) SignTx 

func (a *EOATestAccount) SignTx(
	t testing.TB,
	tx *gethTypes.Transaction,
) *gethTypes.Transaction

type MockUploader added in v0.33.30 

type MockUploader struct {
	UploadFunc func(string, json.RawMessage) error
}

func (MockUploader) Upload added in v0.33.30 

func (m MockUploader) Upload(id string, data json.RawMessage) error

type TestBackend 

type TestBackend struct {
	*TestValueStore

	*TestBlockInfo
	*TestRandomGenerator
	*TestContractFunctionInvoker

	*TestTracer
	*TestMetricsReporter
	*TestLoggerProvider
	// contains filtered or unexported fields
}

func (TestBackend) ComputationAvailable 

func (m TestBackend) ComputationAvailable(
	kind common.ComputationKind,
	intensity uint,
) bool

func (TestBackend) ComputationIntensities 

func (m TestBackend) ComputationIntensities() meter.MeteredComputationIntensities

func (TestBackend) ComputationUsed 

func (m TestBackend) ComputationUsed() (uint64, error)

func (TestBackend) ConvertedServiceEvents 

func (vs TestBackend) ConvertedServiceEvents() flow.ServiceEventList

func (*TestBackend) DropEvents 

func (tb *TestBackend) DropEvents()

func (TestBackend) EmitEvent 

func (vs TestBackend) EmitEvent(event cadence.Event) error

func (TestBackend) Events 

func (vs TestBackend) Events() flow.EventsList

func (TestBackend) GenerateUUID added in v0.33.30 

func (t TestBackend) GenerateUUID() (uint64, error)

func (*TestBackend) Get added in v0.33.30 

func (tb *TestBackend) Get(id flow.RegisterID) (flow.RegisterValue, error)

func (TestBackend) InteractionUsed 

func (m TestBackend) InteractionUsed() (uint64, error)

func (TestBackend) MemoryUsed 

func (m TestBackend) MemoryUsed() (uint64, error)

func (TestBackend) MeterComputation 

func (m TestBackend) MeterComputation(
	kind common.ComputationKind,
	intensity uint,
) error

func (TestBackend) MeterEmittedEvent 

func (m TestBackend) MeterEmittedEvent(byteSize uint64) error

func (TestBackend) MeterMemory 

func (m TestBackend) MeterMemory(usage common.MemoryUsage) error

func (TestBackend) Reset 

func (vs TestBackend) Reset()

func (TestBackend) ServiceEvents 

func (vs TestBackend) ServiceEvents() flow.EventsList

func (TestBackend) TotalEmittedEventBytes 

func (m TestBackend) TotalEmittedEventBytes() uint64

func (*TestBackend) TotalStorageSize 

func (tb *TestBackend) TotalStorageSize() int

type TestBlockInfo added in v0.33.30 

type TestBlockInfo struct {
	GetCurrentBlockHeightFunc func() (uint64, error)
	GetBlockAtHeightFunc      func(height uint64) (runtime.Block, bool, error)
}

func (*TestBlockInfo) GetBlockAtHeight added in v0.33.30 

func (tb *TestBlockInfo) GetBlockAtHeight(height uint64) (runtime.Block, bool, error)

GetBlockAtHeight returns the block at the given height.

func (*TestBlockInfo) GetCurrentBlockHeight added in v0.33.30 

func (tb *TestBlockInfo) GetCurrentBlockHeight() (uint64, error)

GetCurrentBlockHeight returns the current block height.

type TestContract 

type TestContract struct {
	ABI        string
	ByteCode   []byte
	DeployedAt types.Address
}

func GetDummyKittyTestContract 

func GetDummyKittyTestContract(t testing.TB) *TestContract

func GetFactoryTestContract added in v0.37.1 

func GetFactoryTestContract(t testing.TB) *TestContract

func GetProxyContract added in v0.37.1 

func GetProxyContract(t testing.TB) *TestContract

func GetStorageTestContract 

func GetStorageTestContract(tb testing.TB) *TestContract

func (*TestContract) MakeCallData 

func (tc *TestContract) MakeCallData(t testing.TB, name string, args ...interface{}) []byte

func (*TestContract) SetDeployedAt 

func (tc *TestContract) SetDeployedAt(deployedAt types.Address)

type TestContractFunctionInvoker added in v0.33.30 

type TestContractFunctionInvoker struct {
	InvokeFunc func(
		spec environment.ContractFunctionSpec,
		arguments []cadence.Value,
	) (
		cadence.Value,
		error,
	)
}

func (*TestContractFunctionInvoker) Invoke added in v0.33.30 

func (t *TestContractFunctionInvoker) Invoke(
	spec environment.ContractFunctionSpec,
	arguments []cadence.Value,
) (
	cadence.Value,
	error,
)

type TestEmulator 

type TestEmulator struct {
	BalanceOfFunc           func(address types.Address) (*big.Int, error)
	NonceOfFunc             func(address types.Address) (uint64, error)
	CodeOfFunc              func(address types.Address) (types.Code, error)
	CodeHashOfFunc          func(address types.Address) ([]byte, error)
	DirectCallFunc          func(call *types.DirectCall) (*types.Result, error)
	RunTransactionFunc      func(tx *gethTypes.Transaction) (*types.Result, error)
	DryRunTransactionFunc   func(tx *gethTypes.Transaction, address gethCommon.Address) (*types.Result, error)
	BatchRunTransactionFunc func(txs []*gethTypes.Transaction) ([]*types.Result, error)
}

func (*TestEmulator) BalanceOf 

func (em *TestEmulator) BalanceOf(address types.Address) (*big.Int, error)

BalanceOf returns the balance of this address

func (*TestEmulator) BatchRunTransactions added in v0.33.30 

func (em *TestEmulator) BatchRunTransactions(txs []*gethTypes.Transaction) ([]*types.Result, error)

BatchRunTransactions batch runs transactions and collect gas fees to the coinbase account

func (*TestEmulator) CodeHashOf added in v0.33.30 

func (em *TestEmulator) CodeHashOf(address types.Address) ([]byte, error)

CodeHashOf returns the code hash for this address

func (*TestEmulator) CodeOf 

func (em *TestEmulator) CodeOf(address types.Address) (types.Code, error)

CodeOf returns the code for this address

func (*TestEmulator) DirectCall 

func (em *TestEmulator) DirectCall(call *types.DirectCall) (*types.Result, error)

DirectCall executes a direct call

func (*TestEmulator) DryRunTransaction added in v0.33.30 

func (em *TestEmulator) DryRunTransaction(tx *gethTypes.Transaction, address gethCommon.Address) (*types.Result, error)

DryRunTransaction simulates transaction execution

func (*TestEmulator) NewBlockView 

func (em *TestEmulator) NewBlockView(_ types.BlockContext) (types.BlockView, error)

NewBlock returns a new block

func (*TestEmulator) NewReadOnlyBlockView 

func (em *TestEmulator) NewReadOnlyBlockView(_ types.BlockContext) (types.ReadOnlyBlockView, error)

NewBlock returns a new block view

func (*TestEmulator) NonceOf 

func (em *TestEmulator) NonceOf(address types.Address) (uint64, error)

NonceOfFunc returns the nonce for this address

func (*TestEmulator) RunTransaction 

func (em *TestEmulator) RunTransaction(tx *gethTypes.Transaction) (*types.Result, error)

RunTransaction runs a transaction and collect gas fees to the coinbase account

type TestLoggerProvider added in v0.37.5 

type TestLoggerProvider struct {
	LoggerFunc func() zerolog.Logger
}

func (*TestLoggerProvider) Logger added in v0.37.5 

func (tlp *TestLoggerProvider) Logger() zerolog.Logger

type TestMetricsReporter added in v0.36.3 

type TestMetricsReporter struct {
	SetNumberOfDeployedCOAsFunc func(uint64)
	EVMTransactionExecutedFunc  func(uint64, bool, bool)
	EVMBlockExecutedFunc        func(int, uint64, float64)
}

func (*TestMetricsReporter) EVMBlockExecuted added in v0.36.3 

func (tmr *TestMetricsReporter) EVMBlockExecuted(txCount int, totalGasUsed uint64, totalSupplyInFlow float64)

func (*TestMetricsReporter) EVMTransactionExecuted added in v0.36.3 

func (tmr *TestMetricsReporter) EVMTransactionExecuted(gasUsed uint64, isDirectCall bool, failed bool)

func (*TestMetricsReporter) SetNumberOfDeployedCOAs added in v0.36.3 

func (tmr *TestMetricsReporter) SetNumberOfDeployedCOAs(count uint64)

type TestPrecompiledContract 

type TestPrecompiledContract struct {
	RequiredGasFunc func(input []byte) uint64
	RunFunc         func(input []byte) ([]byte, error)
	AddressFunc     func() types.Address
}

func (*TestPrecompiledContract) Address 

func (pc *TestPrecompiledContract) Address() types.Address

Address returns the address that this contract is deployed to

func (*TestPrecompiledContract) RequiredGas 

func (pc *TestPrecompiledContract) RequiredGas(input []byte) uint64

RequiredGas returns the contract gas use

func (*TestPrecompiledContract) Run 

func (pc *TestPrecompiledContract) Run(input []byte) ([]byte, error)

Run runs the precompiled contract

type TestRandomGenerator added in v0.33.30 

type TestRandomGenerator struct {
	ReadRandomFunc func([]byte) error
}

func (*TestRandomGenerator) ReadRandom added in v0.33.30 

func (t *TestRandomGenerator) ReadRandom(buffer []byte) error

type TestStorageProvider 

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

TestStorageProvider constructs a new storage provider that only provides storage for an specific height

func NewTestStorageProvider 

func NewTestStorageProvider(
	initSnapshot types.BackendStorageSnapshot,
	height uint64,
) *TestStorageProvider

NewTestStorageProvider constructs a new TestStorageProvider

func (*TestStorageProvider) GetSnapshotAt 

func (sp *TestStorageProvider) GetSnapshotAt(height uint64) (types.BackendStorageSnapshot, error)

GetSnapshotAt returns the snapshot at specific block height

type TestTracer added in v0.35.17 

type TestTracer struct {
	StartChildSpanFunc func(trace.SpanName, ...otelTrace.SpanStartOption) tracing.TracerSpan
}

func (*TestTracer) ExpectedSpan added in v0.35.17 

func (tt *TestTracer) ExpectedSpan(t *testing.T, expected trace.SpanName)

func (*TestTracer) StartChildSpan added in v0.35.17 

func (tt *TestTracer) StartChildSpan(
	name trace.SpanName,
	options ...otelTrace.SpanStartOption,
) tracing.TracerSpan

type TestValueStore 

type TestValueStore struct {
	GetValueFunc          func(owner, key []byte) ([]byte, error)
	SetValueFunc          func(owner, key, value []byte) error
	ValueExistsFunc       func(owner, key []byte) (bool, error)
	AllocateSlabIndexFunc func(owner []byte) (atree.SlabIndex, error)
	TotalStorageSizeFunc  func() int
	TotalBytesReadFunc    func() int
	TotalBytesWrittenFunc func() int
	TotalStorageItemsFunc func() int
	ResetStatsFunc        func()
	CloneFunc             func() *TestValueStore
}

func GetSimpleValueStore 

func GetSimpleValueStore() *TestValueStore

func GetSimpleValueStorePopulated 

func GetSimpleValueStorePopulated(
	data map[string][]byte,
	allocator map[string]uint64,
) *TestValueStore

func (*TestValueStore) AllocateSlabIndex added in v0.37.1 

func (vs *TestValueStore) AllocateSlabIndex(owner []byte) (atree.SlabIndex, error)

func (*TestValueStore) Clone 

func (vs *TestValueStore) Clone() *TestValueStore

func (*TestValueStore) GetValue 

func (vs *TestValueStore) GetValue(owner, key []byte) ([]byte, error)

func (*TestValueStore) ResetStats 

func (vs *TestValueStore) ResetStats()

func (*TestValueStore) SetValue 

func (vs *TestValueStore) SetValue(owner, key, value []byte) error

func (*TestValueStore) TotalBytesRead 

func (vs *TestValueStore) TotalBytesRead() int

func (*TestValueStore) TotalBytesWritten 

func (vs *TestValueStore) TotalBytesWritten() int

func (*TestValueStore) TotalStorageItems 

func (vs *TestValueStore) TotalStorageItems() int

func (*TestValueStore) TotalStorageSize 

func (vs *TestValueStore) TotalStorageSize() int

func (*TestValueStore) ValueExists 

func (vs *TestValueStore) ValueExists(owner, key []byte) (bool, error)

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.