testutil

Documentation

Index

• Variables
• func BatchSignAndSend(t *testing.T, wallet *sequence.Wallet, to common.Address, data [][]byte) error
• func ContractCall(provider *ethrpc.Provider, contractAddress common.Address, contractABI abi.ABI, ...) ([]byte, error)
• func ContractQuery(provider *ethrpc.Provider, contractAddress common.Address, ...) ([]string, error)
• func ContractTransact(signer *ethwallet.Wallet, contractAddress common.Address, contractABI abi.ABI, ...) (*types.Receipt, error)
• func DummyAddr() common.Address
• func DummyPrivateKey(seed uint64) string
• func RandomSeed() uint64
• func SequenceContext() sequence.WalletContext
• func SignAndSend(t *testing.T, wallet *sequence.Wallet, to common.Address, data []byte) error
• func SignAndSendRawTransaction(t *testing.T, wallet *sequence.Wallet, stx *sequence.Transaction) error
• type TestChain
  • func NewTestChain(opts ...TestChainOptions) (*TestChain, error)
  • func (c *TestChain) ChainID() *big.Int
  • func (c *TestChain) Deploy(t *testing.T, contractName string, contractConstructorArgs ...interface{}) (*ethcontract.Contract, *types.Receipt)
  • func (c *TestChain) DeploySequenceContext() (sequence.WalletContext, error)
  • func (c *TestChain) DeploySequenceWallet(wallet *sequence.Wallet) error
  • func (c *TestChain) DummySequenceWallet(seed uint64, optSkipDeploy ...bool) (*sequence.Wallet, error)
  • func (c *TestChain) DummySequenceWallets(nWallets uint64, startingSeed uint64) ([]*sequence.Wallet, error)
  • func (c *TestChain) GetDeployTransactor() (*bind.TransactOpts, error)
  • func (c *TestChain) GetDeployWallet() *ethwallet.Wallet
  • func (c *TestChain) GetRelayerWallet() *ethwallet.Wallet
  • func (c *TestChain) MustDeploySequenceContext() sequence.WalletContext
  • func (c *TestChain) MustFundAddress(addr common.Address) error
  • func (c *TestChain) MustWallet(optAccountIndex ...uint32) *ethwallet.Wallet
  • func (c *TestChain) RandomNonce() *big.Int
  • func (c *TestChain) SequenceContext() sequence.WalletContext
  • func (c *TestChain) SetRpcRelayer(relayerURL string) error
  • func (c *TestChain) UniDeploy(t *testing.T, contractName string, contractInstanceNum uint, ...) *ethcontract.Contract
  • func (c *TestChain) WaitMined(txn common.Hash) error
  • func (c *TestChain) Wallet() (*ethwallet.Wallet, error)
• type TestChainOptions

Variables

var (
	Contracts = ethartifact.NewContractRegistry()
)

var DefaultTestChainOptions = TestChainOptions{
	NodeURL: "http://localhost:8545",
}

Functions

func BatchSignAndSend

func BatchSignAndSend(t *testing.T, wallet *sequence.Wallet, to common.Address, data [][]byte) error

func ContractCall

func ContractCall(provider *ethrpc.Provider, contractAddress common.Address, contractABI abi.ABI, result interface{}, method string, args ...interface{}) ([]byte, error)

func ContractQuery

func ContractQuery(provider *ethrpc.Provider, contractAddress common.Address, inputExpr, outputExpr string, args []string) ([]string, error)

func ContractTransact

func ContractTransact(signer *ethwallet.Wallet, contractAddress common.Address, contractABI abi.ABI, method string, args ...interface{}) (*types.Receipt, error)

func DummyAddr

func DummyAddr() common.Address

DummyAddr returns a dummy address

func DummyPrivateKey

func DummyPrivateKey(seed uint64) string

DummyPrivateKey returns random private key in hex used with ethwallet

func RandomSeed

func RandomSeed() uint64

RandomSeed will generate a random seed

func SequenceContext

func SequenceContext() sequence.WalletContext

func SignAndSend

func SignAndSend(t *testing.T, wallet *sequence.Wallet, to common.Address, data []byte) error

func SignAndSendRawTransaction

func SignAndSendRawTransaction(t *testing.T, wallet *sequence.Wallet, stx *sequence.Transaction) error

Types

type TestChain

type TestChain struct {
	Provider *ethrpc.Provider // provider rpc to the test chain

	RpcRelayer *relayer.RpcRelayer // helper to track RpcRelayer client
	// contains filtered or unexported fields
}

func NewTestChain

func NewTestChain(opts ...TestChainOptions) (*TestChain, error)

func (*TestChain) ChainID

func (c *TestChain) ChainID() *big.Int

func (*TestChain) Deploy

func (c *TestChain) Deploy(t *testing.T, contractName string, contractConstructorArgs ...interface{}) (*ethcontract.Contract, *types.Receipt)

Deploy will deploy a contract registered in `Contracts` registry using the standard deployment method. Each Deploy call will instanitate a new contract on the test chain.

func (*TestChain) DeploySequenceContext

func (c *TestChain) DeploySequenceContext() (sequence.WalletContext, error)

func (*TestChain) DeploySequenceWallet

func (c *TestChain) DeploySequenceWallet(wallet *sequence.Wallet) error

func (*TestChain) DummySequenceWallet

func (c *TestChain) DummySequenceWallet(seed uint64, optSkipDeploy ...bool) (*sequence.Wallet, error)

func (*TestChain) DummySequenceWallets

func (c *TestChain) DummySequenceWallets(nWallets uint64, startingSeed uint64) ([]*sequence.Wallet, error)

func (*TestChain) GetDeployTransactor

func (c *TestChain) GetDeployTransactor() (*bind.TransactOpts, error)

GetDeployTransactor returns a account transactor typically used for deploying contracts

func (*TestChain) GetDeployWallet

func (c *TestChain) GetDeployWallet() *ethwallet.Wallet

func (*TestChain) GetRelayerWallet

func (c *TestChain) GetRelayerWallet() *ethwallet.Wallet

GetRelayerWallet is the wallet dedicated EOA wallet to relaying transactions

func (*TestChain) MustDeploySequenceContext

func (c *TestChain) MustDeploySequenceContext() sequence.WalletContext

func (*TestChain) MustFundAddress

func (c *TestChain) MustFundAddress(addr common.Address) error

func (*TestChain) MustWallet

func (c *TestChain) MustWallet(optAccountIndex ...uint32) *ethwallet.Wallet

func (*TestChain) RandomNonce

func (c *TestChain) RandomNonce() *big.Int

func (*TestChain) SequenceContext

func (c *TestChain) SequenceContext() sequence.WalletContext

func (*TestChain) SetRpcRelayer

func (c *TestChain) SetRpcRelayer(relayerURL string) error

func (*TestChain) UniDeploy

func (c *TestChain) UniDeploy(t *testing.T, contractName string, contractInstanceNum uint, contractConstructorArgs ...interface{}) *ethcontract.Contract

UniDeploy will deploy a contract registered in `Contracts` registry using the universal deployer. Multiple calls to UniDeploy will instantiate just a single instance for the same contract with the same `contractInstanceNum`.

func (*TestChain) WaitMined

func (c *TestChain) WaitMined(txn common.Hash) error

func (*TestChain) Wallet

func (c *TestChain) Wallet() (*ethwallet.Wallet, error)

type TestChainOptions

type TestChainOptions struct {
	NodeURL string
}