testing

package
v0.3.39 Latest Latest
Warning

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

 Go to latest Published: Oct 11, 2024 License: Apache-2.0 Imports: 37 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	ICS20Version   = "ics20-1"
	MockAppVersion = "mockapp-1"
	TransferPort   = "transfer"
	MockPort       = "mock"

	RelayerKeyIndex uint32 = 0

	MockPacketData      = "mock packet data"
	MockFailPacketData  = "mock failed packet data"
	MockAsyncPacketData = "mock async packet data"
)

Variables

View Source 
var (
	DefaultPrefix = "ibc"

	BlockTime            uint64 = 1000 * 1000 * 1000 // 1[sec]
	DefaultDelayPeriod   uint64 = 0                  // sec
	DefaultTrustPeriod   uint64 = 5 * 60             // sec
	DefaultMaxClockDrift uint64 = 30                 // sec
)
View Source 
var IBCErrorsRepository client.ErrorsRepository

IBCErrorsRepository is a repository of custom errors defined in the ibc-solidity contracts.

Functions

func MarshalWithAny 

func MarshalWithAny(msg proto.Message) ([]byte, error)

func PackAny 

func PackAny(msg proto.Message) (*types.Any, error)

func PacketToCallData added in v0.3.12 

func PacketToCallData(packet ibchandler.Packet) ibchandler.Packet

func UnmarshalWithAny 

func UnmarshalWithAny(bz []byte, msg proto.Message) error

func UnpackAny 

func UnpackAny(bz []byte) (*types.Any, error)

Types

type BroadcastLog added in v0.3.5 

type BroadcastLog struct {
	Transactions []Transaction `json:"transactions"`
}

type Chain 

type Chain struct {
	ContractConfig ContractConfig

	// Core Modules
	IBCHandler ibchandler.Ibchandler

	// App Modules
	ERC20         erc20.Erc20
	ICS20Transfer ics20transfer.Ics20transfer
	IBCMockApp    ibcmockapp.Ibcmockapp

	// Input data for light client
	LatestLCInputData *LightClientInputData

	// IBC specific helpers
	ClientIDs   []string          // ClientID's used on this chain
	Connections []*TestConnection // track connectionID's created for this chain
	// contains filtered or unexported fields
}

func NewChain 

func NewChain(t *testing.T, client *client.ETHClient, lc *LightClient, isAutoMining bool) *Chain

func (*Chain) AddTestChannel 

func (chain *Chain) AddTestChannel(conn *TestConnection, portID string, version string) TestChannel

AddTestChannel appends a new TestChannel which contains references to the port and channel ID used for channel creation and interaction. See 'NextTestChannel' for channel ID naming format.

func (*Chain) AddTestConnection 

func (chain *Chain) AddTestConnection(clientID, counterpartyClientID string) *TestConnection

AddTestConnection appends a new TestConnection which contains references to the connection id, client id and counterparty client id.

func (*Chain) Address added in v0.3.39 

func (chain *Chain) Address(index uint32) common.Address

func (*Chain) AdvanceBlockNumber added in v0.3.12 

func (chain *Chain) AdvanceBlockNumber(
	ctx context.Context,
	toBlockNumber uint64,
) error

func (*Chain) CallOpts 

func (chain *Chain) CallOpts(ctx context.Context, index uint32) *bind.CallOpts

func (*Chain) ChainIDU256 added in v0.3.29 

func (chain *Chain) ChainIDU256() []byte

func (*Chain) ChannelCloseConfirm 

func (chain *Chain) ChannelCloseConfirm(
	ctx context.Context,
	counterparty *Chain,
	ch, counterpartyCh TestChannel,
) error

func (*Chain) ChannelCloseInit 

func (chain *Chain) ChannelCloseInit(
	ctx context.Context,
	ch TestChannel,
) error

func (*Chain) ChannelOpenAck 

func (chain *Chain) ChannelOpenAck(
	ctx context.Context,
	counterparty *Chain,
	ch, counterpartyCh TestChannel,
) error

func (*Chain) ChannelOpenConfirm 

func (chain *Chain) ChannelOpenConfirm(
	ctx context.Context,
	counterparty *Chain,
	ch, counterpartyCh TestChannel,
) error

func (*Chain) ChannelOpenInit 

func (chain *Chain) ChannelOpenInit(
	ctx context.Context,
	ch, counterparty TestChannel,
	order channeltypes.Channel_Order,
	connectionID string,
) (string, error)

func (*Chain) ChannelOpenTry 

func (chain *Chain) ChannelOpenTry(
	ctx context.Context,
	counterparty *Chain,
	ch, counterpartyCh TestChannel,
	order channeltypes.Channel_Order,
	connectionID string,
) (string, error)

func (*Chain) Client 

func (chain *Chain) Client() *client.ETHClient

func (*Chain) ConnectionOpenAck 

func (chain *Chain) ConnectionOpenAck(
	ctx context.Context,
	counterparty *Chain,
	connection, counterpartyConnection *TestConnection,
) error

ConnectionOpenAck will construct and execute a MsgConnectionOpenAck.

func (*Chain) ConnectionOpenConfirm 

func (chain *Chain) ConnectionOpenConfirm(
	ctx context.Context,
	counterparty *Chain,
	connection, counterpartyConnection *TestConnection,
) error

func (*Chain) ConnectionOpenInit 

func (chain *Chain) ConnectionOpenInit(ctx context.Context, counterparty *Chain, connection, counterpartyConnection *TestConnection) (string, error)

func (*Chain) ConnectionOpenTry 

func (chain *Chain) ConnectionOpenTry(ctx context.Context, counterparty *Chain, connection, counterpartyConnection *TestConnection) (string, error)

func (*Chain) ConstructNextTestConnection 

func (chain *Chain) ConstructNextTestConnection(clientID, counterpartyClientID string) *TestConnection

ConstructNextTestConnection constructs the next test connection to be created given a clientID and counterparty clientID.

func (*Chain) ConstructQBFTMsgCreateClient added in v0.3.29 

func (chain *Chain) ConstructQBFTMsgCreateClient(counterparty *Chain) ibchandler.IIBCClientMsgCreateClient

func (*Chain) ConstructQBFTMsgUpdateClient added in v0.3.29 

func (chain *Chain) ConstructQBFTMsgUpdateClient(counterparty *Chain, clientID string) ibchandler.IIBCClientMsgUpdateClient

func (*Chain) CreateQBFTClient added in v0.3.29 

func (chain *Chain) CreateQBFTClient(ctx context.Context, counterparty *Chain) (string, error)

func (*Chain) EnsureChannelState added in v0.3.12 

func (chain *Chain) EnsureChannelState(
	ctx context.Context,
	portID string,
	channelID string,
	state channeltypes.Channel_State,
) error

func (*Chain) EnsurePacketCommitmentExistence added in v0.3.12 

func (chain *Chain) EnsurePacketCommitmentExistence(
	ctx context.Context,
	exists bool,
	portID string,
	channelID string,
	sequence uint64,
) error

func (*Chain) FindAcknowledgement added in v0.3.15 

func (chain *Chain) FindAcknowledgement(
	ctx context.Context,
	portID string,
	channelID string,
	sequence uint64,
) ([]byte, error)

func (*Chain) FindPacket 

func (chain *Chain) FindPacket(
	ctx context.Context,
	sourcePortID string,
	sourceChannel string,
	sequence uint64,
) (*ibchandler.Packet, error)

func (*Chain) GetCommitmentPrefix 

func (chain *Chain) GetCommitmentPrefix() []byte

func (*Chain) GetDelayPeriod added in v0.3.12 

func (chain *Chain) GetDelayPeriod() uint64

func (*Chain) GetLastGeneratedChannelID 

func (chain *Chain) GetLastGeneratedChannelID(
	ctx context.Context,
) (string, error)

func (*Chain) GetLastGeneratedClientID 

func (chain *Chain) GetLastGeneratedClientID(
	ctx context.Context,
) (string, error)

func (*Chain) GetLastGeneratedConnectionID 

func (chain *Chain) GetLastGeneratedConnectionID(
	ctx context.Context,
) (string, error)

func (*Chain) GetLastSentPacket 

func (chain *Chain) GetLastSentPacket(
	ctx context.Context,
	sourcePortID string,
	sourceChannel string,
) (*ibchandler.Packet, error)

func (*Chain) GetLightClientInputData added in v0.3.12 

func (chain *Chain) GetLightClientInputData(counterparty *Chain, counterpartyClientID string, storageKeys [][]byte, height *big.Int) (*LightClientInputData, error)

func (*Chain) GetQBFTClientState added in v0.3.29 

func (chain *Chain) GetQBFTClientState(clientID string) *qbftclienttypes.ClientState

func (*Chain) GetQBFTConsensusState added in v0.3.29 

func (chain *Chain) GetQBFTConsensusState(clientID string, height ibcclient.Height) *qbftclienttypes.ConsensusState

func (*Chain) HandlePacketAcknowledgement 

func (chain *Chain) HandlePacketAcknowledgement(
	ctx context.Context,
	counterparty *Chain,
	ch, counterpartyCh TestChannel,
	packet ibchandler.Packet,
	acknowledgement []byte,
) error

func (*Chain) HandlePacketRecv 

func (chain *Chain) HandlePacketRecv(
	ctx context.Context,
	counterparty *Chain,
	ch, counterpartyCh TestChannel,
	packet ibchandler.Packet,
) error

func (*Chain) LastHeader 

func (chain *Chain) LastHeader() *gethtypes.Header

func (*Chain) NextTestChannel 

func (chain *Chain) NextTestChannel(conn *TestConnection, portID string, version string) TestChannel

NextTestChannel returns the next test channel to be created on this connection, but does not add it to the list of created channels. This function is expected to be used when the caller has not created the associated channel in app state, but would still like to refer to the non-existent channel usually to test for its non-existence.

The port is passed in by the caller.

func (*Chain) QueryChannelProof 

func (chain *Chain) QueryChannelProof(counterparty *Chain, counterpartyClientID string, channel TestChannel, height *big.Int) (*Proof, error)

func (*Chain) QueryClientStateProof added in v0.3.22 

func (chain *Chain) QueryClientStateProof(counterparty *Chain, clientID, counterpartyClientID string, height *big.Int) ([]byte, ibcclient.Height, *Proof, error)

func (*Chain) QueryConnectionProof 

func (chain *Chain) QueryConnectionProof(counterparty *Chain, counterpartyClientID string, connectionID string, height *big.Int) (*Proof, error)

func (*Chain) QueryConsensusStateProof added in v0.3.22 

func (chain *Chain) QueryConsensusStateProof(counterparty *Chain, clientID, counterpartyClientID string, consensusHeight ibcclient.Height, height *big.Int) ([]byte, *Proof, error)

func (*Chain) QueryNextSequenceRecvProof added in v0.3.15 

func (chain *Chain) QueryNextSequenceRecvProof(counterparty *Chain, counterpartyClientID string, channel TestChannel, height *big.Int) (*Proof, error)

func (*Chain) QueryPacketReceiptProof added in v0.3.12 

func (chain *Chain) QueryPacketReceiptProof(counterparty *Chain, counterpartyClientID string, packetFromCounterparty ibchandler.Packet, counterpartyHeight *big.Int) (*Proof, error)

func (*Chain) QueryProof 

func (chain *Chain) QueryProof(counterparty *Chain, counterpartyClientID string, storageKey string, height *big.Int) (*Proof, error)

func (*Chain) SendPacket 

func (chain *Chain) SendPacket(
	ctx context.Context,
	packet ibchandler.Packet,
) error

func (*Chain) SetDelayPeriod added in v0.3.12 

func (chain *Chain) SetDelayPeriod(delayPeriod uint64)

func (*Chain) SetExpectedTimePerBlock added in v0.3.12 

func (chain *Chain) SetExpectedTimePerBlock(
	ctx context.Context,
	callerIndex uint32,
	duration uint64,
) error

func (*Chain) TimeoutOnClose added in v0.3.12 

func (chain *Chain) TimeoutOnClose(
	ctx context.Context,
	packet ibchandler.Packet,
	counterparty *Chain,
	channel TestChannel,
	counterpartyChannel TestChannel,
) error

func (*Chain) TimeoutPacket added in v0.3.12 

func (chain *Chain) TimeoutPacket(
	ctx context.Context,
	packet ibchandler.Packet,
	counterparty *Chain,
	channel TestChannel,
	counterpartyChannel TestChannel,
) error

func (*Chain) TxOpts 

func (chain *Chain) TxOpts(ctx context.Context, index uint32) *bind.TransactOpts

func (*Chain) UpdateLCInputData added in v0.3.12 

func (chain *Chain) UpdateLCInputData()

func (*Chain) UpdateQBFTClient added in v0.3.29 

func (chain *Chain) UpdateQBFTClient(ctx context.Context, counterparty *Chain, clientID string, updateCommitment bool) error

func (*Chain) WaitForReceiptAndGet 

func (chain *Chain) WaitForReceiptAndGet(ctx context.Context, tx *gethtypes.Transaction, txName string) error

func (*Chain) WaitIfNoError 

func (chain *Chain) WaitIfNoError(ctx context.Context, txName string) func(tx *gethtypes.Transaction, err error) error

type ContractConfig 

type ContractConfig struct {
	ICS20TransferAddress common.Address
	ERC20TokenAddress    common.Address
	IBCMockAppAddress    common.Address
	// contains filtered or unexported fields
}

func (*ContractConfig) GetIBCHandlerAddress 

func (cc *ContractConfig) GetIBCHandlerAddress() common.Address

func (*ContractConfig) IsUpgradeable added in v0.3.37 

func (cc *ContractConfig) IsUpgradeable() bool

func (*ContractConfig) Validate added in v0.3.5 

func (cc *ContractConfig) Validate() error

type Coordinator 

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

func NewCoordinator 

func NewCoordinator(t *testing.T, chains ...*Chain) Coordinator

func (*Coordinator) Approve added in v0.3.39 

func (c *Coordinator) Approve(
	ctx context.Context,
	chain *Chain,
	senderIndex uint32,
	amount uint64,
) error

func (*Coordinator) ChanCloseConfirm 

func (c *Coordinator) ChanCloseConfirm(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel, counterpartyChannel TestChannel,
) error

ChanCloseConfirm confirms closing of a channel on chain A to chain B, after which the channel is closed on both chains (this code is executed on chain B).

func (*Coordinator) ChanCloseInit 

func (c *Coordinator) ChanCloseInit(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel TestChannel,
) error

ChanCloseInit closes a channel on chain A to chain B (this code is executed on chain A).

func (*Coordinator) ChanOpenAck 

func (c *Coordinator) ChanOpenAck(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel, counterpartyChannel TestChannel,
) error

ChanOpenAck relays acceptance of a channel open attempt from chain B back to chain A (this code is executed on chain A).

func (*Coordinator) ChanOpenConfirm 

func (c *Coordinator) ChanOpenConfirm(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel, counterpartyChannel TestChannel,
) error

ChanOpenConfirm confirms opening of a channel on chain A to chain B, after which the channel is open on both chains (this code is executed on chain B).

func (*Coordinator) ChanOpenInit 

func (c *Coordinator) ChanOpenInit(
	ctx context.Context,
	source, counterparty *Chain,
	connection, counterpartyConnection *TestConnection,
	sourcePortID, counterpartyPortID string,
	order channeltypes.Channel_Order,
	version string,
) (TestChannel, TestChannel, error)

ChanOpenInit initializes a channel on the source chain with the state INIT using the OpenInit handshake call.

NOTE: The counterparty testing channel will be created even if it is not created in the application state.

func (*Coordinator) ChanOpenTry 

func (c *Coordinator) ChanOpenTry(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel, counterpartyChannel *TestChannel,
	connection *TestConnection,
	order channeltypes.Channel_Order,
) error

ChanOpenTry relays notice of a channel open attempt on chain A to chain B (this code is executed on chain B).

func (*Coordinator) CloseChannel 

func (c *Coordinator) CloseChannel(
	ctx context.Context,
	chainA, chainB *Chain,
	chanA, chanB TestChannel,
)

CloseChannel constructs and executes channel closing messages in order to transition the channel to the CLOSED state on chainA and chainB. The function expects the channels to be successfully closed otherwise testing will fail.

func (*Coordinator) ConnOpenAck 

func (c *Coordinator) ConnOpenAck(
	ctx context.Context,
	source, counterparty *Chain,
	sourceConnection, counterpartyConnection *TestConnection,
) error

ConnOpenAck initializes a connection on the source chain with the state OPEN using the OpenAck handshake call.

func (*Coordinator) ConnOpenConfirm 

func (c *Coordinator) ConnOpenConfirm(
	ctx context.Context,
	source, counterparty *Chain,
	sourceConnection, counterpartyConnection *TestConnection,
) error

ConnOpenConfirm initializes a connection on the source chain with the state OPEN using the OpenConfirm handshake call.

func (Coordinator) ConnOpenInit 

func (c Coordinator) ConnOpenInit(
	ctx context.Context,
	source, counterparty *Chain,
	clientID, counterpartyClientID string,
) (*TestConnection, *TestConnection, error)

ConnOpenInit initializes a connection on the source chain with the state INIT using the OpenInit handshake call.

NOTE: The counterparty testing connection will be created even if it is not created in the application state.

func (*Coordinator) ConnOpenTry 

func (c *Coordinator) ConnOpenTry(
	ctx context.Context,
	source, counterparty *Chain,
	sourceConnection, counterpartyConnection *TestConnection,
) error

ConnOpenTry initializes a connection on the source chain with the state TRYOPEN using the OpenTry handshake call.

func (*Coordinator) CreateChannel 

func (c *Coordinator) CreateChannel(
	ctx context.Context,
	chainA, chainB *Chain,
	connA, connB *TestConnection,
	sourcePortID, counterpartyPortID string,
	order channeltypes.Channel_Order,
	version string,
) (TestChannel, TestChannel)

CreateChannel constructs and executes channel handshake messages in order to create OPEN channels on chainA and chainB. The function expects the channels to be successfully opened otherwise testing will fail.

func (Coordinator) CreateClient 

func (c Coordinator) CreateClient(
	ctx context.Context,
	source, counterparty *Chain,
) (clientID string, err error)

func (*Coordinator) CreateConnection 

func (c *Coordinator) CreateConnection(
	ctx context.Context,
	chainA, chainB *Chain,
	clientA, clientB string,
) (*TestConnection, *TestConnection)

CreateConnection constructs and executes connection handshake messages in order to create OPEN channels on chainA and chainB. The connection information of for chainA and chainB are returned within a TestConnection struct. The function expects the connections to be successfully opened otherwise testing will fail.

func (Coordinator) GetChain 

func (c Coordinator) GetChain(idx int) *Chain

func (*Coordinator) HandlePacketAcknowledgement 

func (c *Coordinator) HandlePacketAcknowledgement(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel, counterpartyChannel TestChannel,
	packet ibchandler.Packet,
	acknowledgement []byte,
) error

func (*Coordinator) HandlePacketRecv 

func (c *Coordinator) HandlePacketRecv(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel, counterpartyChannel TestChannel,
	packet ibchandler.Packet,
) error

func (*Coordinator) RelayLastSentPacket added in v0.3.12 

func (c *Coordinator) RelayLastSentPacket(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel, counterpartyChannel TestChannel,
	packetCb func([]byte),
	ackCb func([]byte),
)

func (*Coordinator) RelayLastSentPacketWithDelay added in v0.3.12 

func (c *Coordinator) RelayLastSentPacketWithDelay(
	ctx context.Context,
	source, counterparty *Chain,
	sourceChannel, counterpartyChannel TestChannel,
	sourceDelayPeriodExtension, counterpartyDelayPeriodExtension uint64,
	delayStartTimeForRecv time.Time,
)

func (*Coordinator) SendPacket 

func (c *Coordinator) SendPacket(
	ctx context.Context,
	source, counterparty *Chain,
	packet ibchandler.Packet,
	counterpartyClientID string,
) error

SendPacket sends a packet through the channel keeper on the source chain and updates the counterparty client for the source chain.

func (*Coordinator) SetupClientConnections 

func (coord *Coordinator) SetupClientConnections(
	ctx context.Context,
	chainA, chainB *Chain,
) (string, string, *TestConnection, *TestConnection)

SetupClientConnections is a helper function to create clients and the appropriate connections on both the source and counterparty chain. It assumes the caller does not anticipate any errors.

func (*Coordinator) SetupClients 

func (coord *Coordinator) SetupClients(
	ctx context.Context,
	chainA, chainB *Chain,
) (string, string)

SetupClients is a helper function to create clients on both chains. It assumes the caller does not anticipate any errors.

func (Coordinator) UpdateClient 

func (c Coordinator) UpdateClient(
	ctx context.Context,
	source, counterparty *Chain,
	clientID string,
	updateCommitment bool,
) error

func (*Coordinator) UpdateLCInputData added in v0.3.12 

func (coord *Coordinator) UpdateLCInputData()

type LightClient added in v0.2.0 

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

func NewLightClient added in v0.2.0 

func NewLightClient(cl *client.ETHClient, consensusType chains.ConsensusType) *LightClient

func (LightClient) GenerateInputData added in v0.3.12 

func (lc LightClient) GenerateInputData(ctx context.Context, address common.Address, storageKeys [][]byte, bn *big.Int) (*LightClientInputData, error)

type LightClientInputData added in v0.3.12 

type LightClientInputData struct {
	ParsedHeader *chains.ParsedHeader
	StateProof   *client.StateProof
	CommitSeals  [][]byte
}

func (LightClientInputData) GetCommitSeals added in v0.3.29 

func (cs LightClientInputData) GetCommitSeals() [][]byte

func (LightClientInputData) Header added in v0.3.12 

func (cs LightClientInputData) Header() *gethtypes.Header

func (LightClientInputData) MembershipProof added in v0.3.12 

func (cs LightClientInputData) MembershipProof() *client.StateProof

func (LightClientInputData) SealingHeaderRLP added in v0.3.29 

func (cs LightClientInputData) SealingHeaderRLP(consensusType chains.ConsensusType) []byte

func (LightClientInputData) Validators added in v0.3.29 

func (cs LightClientInputData) Validators() [][]byte

type Proof 

type Proof struct {
	Height ibcclient.Height
	Data   []byte
}

type TestChannel 

type TestChannel struct {
	PortID               string
	ID                   string
	ClientID             string
	CounterpartyClientID string
	Version              string
}

TestChannel is a testing helper struct to keep track of the portID and channelID used in creating and interacting with a channel. The clientID and counterparty client ID are also tracked to cut down on querying and argument passing.

type TestConnection 

type TestConnection struct {
	ID                   string
	ClientID             string
	CounterpartyClientID string
	Channels             []TestChannel
}

TestConnection is a testing helper struct to keep track of the connectionID, source clientID, , and counterparty clientID used in creating and interacting with a connection.

type Transaction added in v0.3.5 

type Transaction struct {
	TransactionType string         `json:"transactionType"`
	ContractName    string         `json:"contractName"`
	ContractAddress common.Address `json:"contractAddress"`
}

Source Files

View all Source files

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.