chain

Documentation

Index

• type Config
  • func New(t *testing.T, containerManager *containers.Manager, id string, ...) *Config
  • func (c *Config) CreateNode(initNode *initialization.Node) *NodeConfig
  • func (c *Config) GetDefaultNode() (*NodeConfig, error)
  • func (c *Config) GetPersistentPeers() []string
  • func (c *Config) RemoveNode(nodeName string) error
  • func (c *Config) SendIBC(dstChain *Config, recipient string, token sdk.Coin)
  • func (c *Config) WaitForNumHeights(heightsToWait int64)
  • func (c *Config) WaitUntilHeight(height int64)
• type NodeConfig
  • func NewNodeConfig(t *testing.T, initNode *initialization.Node, ...) *NodeConfig
  • func (n *NodeConfig) BankSend(amount string, sendAddress string, receiveAddress string)
  • func (n *NodeConfig) CreateWallet(walletName string) string
  • func (n *NodeConfig) DepositProposal(proposalNumber int, isExpedited bool)
  • func (n *NodeConfig) FailIBCTransfer(from, recipient, amount string)
  • func (n *NodeConfig) GetHostPort(portID string) (string, error)
  • func (n *NodeConfig) GetWallet(walletName string) string
  • func (n *NodeConfig) InstantiateWasmContract(codeID, initMsg, label, from, admin string)
  • func (n *NodeConfig) LogActionF(msg string, args ...interface{})
  • func (n *NodeConfig) QueryBalances(address string) (sdk.Coins, error)
  • func (n *NodeConfig) QueryContractsFromID(codeID int) ([]string, error)
  • func (n *NodeConfig) QueryCurrentHeight() (int64, error)
  • func (n *NodeConfig) QueryDenomsFromCreator(creator string) ([]string, error)
  • func (n *NodeConfig) QueryExchangeRates() (string, error)
  • func (n *NodeConfig) QueryGRPCGateway(path string, parameters ...string) ([]byte, error)
  • func (n *NodeConfig) QueryHashFromBlock(height int64) (string, error)
  • func (n *NodeConfig) QueryLatestBlockTime() time.Time
  • func (n *NodeConfig) QueryListSnapshots() ([]*tmabcitypes.Snapshot, error)
  • func (n *NodeConfig) QueryParams(subspace, key string, result any)
  • func (n *NodeConfig) QueryPropStatus(proposalNumber int) (string, error)
  • func (n *NodeConfig) QueryPropStatusTimed(proposalNumber int, desiredStatus string, totalTime chan time.Duration)
  • func (n *NodeConfig) QueryPropTally(proposalNumber int) (sdk.Int, sdk.Int, sdk.Int, sdk.Int, error)
  • func (n *NodeConfig) QueryTokenFactoryParams() (tokenfactorytypes.QueryParamsResponse, error)
  • func (n *NodeConfig) QueryTotalSupply() (sdk.Coins, error)
  • func (n *NodeConfig) Run() error
  • func (n *NodeConfig) Stop() error
  • func (n *NodeConfig) StoreWasmCode(wasmFile, from string)
  • func (n *NodeConfig) SubmitParamChangeProposal(proposalJSON, from string)
  • func (n *NodeConfig) SubmitTextProposal(text string, initialDeposit sdk.Coin)
  • func (n *NodeConfig) SubmitUpgradeProposal(upgradeVersion string, upgradeHeight int64, initialDeposit sdk.Coin)
  • func (n *NodeConfig) VoteNoProposal(from string, proposalNumber int)
  • func (n *NodeConfig) VoteYesProposal(from string, proposalNumber int)
  • func (n *NodeConfig) WaitUntil(doneCondition func(syncInfo coretypes.SyncInfo) bool)
  • func (n *NodeConfig) WasmExecute(contract, execMsg, from, amounts string, successString string)
  • func (n *NodeConfig) WithSetupTime(t time.Time) *NodeConfig

Types

type Config

type Config struct {
	initialization.ChainMeta

	ValidatorInitConfigs []*initialization.NodeConfig
	// voting period is number of blocks it takes to deposit, 1.2 seconds per validator to vote on the prop, and a buffer.
	VotingPeriod          float32
	ExpeditedVotingPeriod float32
	// upgrade proposal height for chain.
	UpgradePropHeight    int64
	LatestProposalNumber int
	LatestLockNumber     int
	NodeConfigs          []*NodeConfig

	LatestCodeID int
	// contains filtered or unexported fields
}

func New

func New(t *testing.T, containerManager *containers.Manager, id string, initValidatorConfigs []*initialization.NodeConfig) *Config

func (*Config) CreateNode

func (c *Config) CreateNode(initNode *initialization.Node) *NodeConfig

CreateNode returns new initialized NodeConfig.

func (*Config) GetDefaultNode

func (c *Config) GetDefaultNode() (*NodeConfig, error)

GetDefaultNode returns the default node of the chain. The default node is the first one created. Returns error if no ndoes created.

func (*Config) GetPersistentPeers

func (c *Config) GetPersistentPeers() []string

GetPersistentPeers returns persistent peers from every node associated with a chain.

func (*Config) RemoveNode

func (c *Config) RemoveNode(nodeName string) error

RemoveNode removes node and stops it from running.

func (*Config) SendIBC

func (c *Config) SendIBC(dstChain *Config, recipient string, token sdk.Coin)

func (*Config) WaitForNumHeights

func (c *Config) WaitForNumHeights(heightsToWait int64)

WaitForNumHeights waits for all nodes to go through a given number of heights.

func (*Config) WaitUntilHeight

func (c *Config) WaitUntilHeight(height int64)

WaitUntilHeight waits for all validators to reach the specified height at the minimum. returns error, if any.

type NodeConfig

type NodeConfig struct {
	initialization.Node

	OperatorAddress  string
	SnapshotInterval uint64
	// contains filtered or unexported fields
}

func NewNodeConfig

func NewNodeConfig(t *testing.T, initNode *initialization.Node, initConfig *initialization.NodeConfig, chainID string, containerManager *containers.Manager) *NodeConfig

NewNodeConfig returens new initialized NodeConfig.

func (*NodeConfig) BankSend

func (n *NodeConfig) BankSend(amount string, sendAddress string, receiveAddress string)

func (*NodeConfig) CreateWallet

func (n *NodeConfig) CreateWallet(walletName string) string

func (*NodeConfig) DepositProposal

func (n *NodeConfig) DepositProposal(proposalNumber int, isExpedited bool)

func (*NodeConfig) FailIBCTransfer

func (n *NodeConfig) FailIBCTransfer(from, recipient, amount string)

func (*NodeConfig) GetHostPort

func (n *NodeConfig) GetHostPort(portID string) (string, error)

func (*NodeConfig) GetWallet

func (n *NodeConfig) GetWallet(walletName string) string

func (*NodeConfig) InstantiateWasmContract

func (n *NodeConfig) InstantiateWasmContract(codeID, initMsg, label, from, admin string)

func (*NodeConfig) LogActionF

func (n *NodeConfig) LogActionF(msg string, args ...interface{})

func (*NodeConfig) QueryBalances

func (n *NodeConfig) QueryBalances(address string) (sdk.Coins, error)

QueryBalancer returns balances at the address.

func (*NodeConfig) QueryContractsFromID

func (n *NodeConfig) QueryContractsFromID(codeID int) ([]string, error)

func (*NodeConfig) QueryCurrentHeight

func (n *NodeConfig) QueryCurrentHeight() (int64, error)

QueryCurrentHeight returns the current block height of the node or error.

func (*NodeConfig) QueryDenomsFromCreator

func (n *NodeConfig) QueryDenomsFromCreator(creator string) ([]string, error)

func (*NodeConfig) QueryExchangeRates

func (n *NodeConfig) QueryExchangeRates() (string, error)

func (*NodeConfig) QueryGRPCGateway

func (n *NodeConfig) QueryGRPCGateway(path string, parameters ...string) ([]byte, error)

func (*NodeConfig) QueryHashFromBlock

func (n *NodeConfig) QueryHashFromBlock(height int64) (string, error)

QueryHashFromBlock gets block hash at a specific height. Otherwise, error.

func (*NodeConfig) QueryLatestBlockTime

func (n *NodeConfig) QueryLatestBlockTime() time.Time

QueryLatestBlockTime returns the latest block time.

func (*NodeConfig) QueryListSnapshots

func (n *NodeConfig) QueryListSnapshots() ([]*tmabcitypes.Snapshot, error)

QueryListSnapshots gets all snapshots currently created for a node.

func (*NodeConfig) QueryParams

func (n *NodeConfig) QueryParams(subspace, key string, result any)

QueryParams extracts the params for a given subspace and key. This is done generically via json to avoid having to specify the QueryParamResponse type (which may not exist for all params).

func (*NodeConfig) QueryPropStatus

func (n *NodeConfig) QueryPropStatus(proposalNumber int) (string, error)

func (*NodeConfig) QueryPropStatusTimed

func (n *NodeConfig) QueryPropStatusTimed(proposalNumber int, desiredStatus string, totalTime chan time.Duration)

func (*NodeConfig) QueryPropTally

func (n *NodeConfig) QueryPropTally(proposalNumber int) (sdk.Int, sdk.Int, sdk.Int, sdk.Int, error)

func (*NodeConfig) QueryTokenFactoryParams

func (n *NodeConfig) QueryTokenFactoryParams() (tokenfactorytypes.QueryParamsResponse, error)

func (*NodeConfig) QueryTotalSupply

func (n *NodeConfig) QueryTotalSupply() (sdk.Coins, error)

func (*NodeConfig) Run

func (n *NodeConfig) Run() error

Run runs a node container for the given nodeIndex. The node configuration must be already added to the chain config prior to calling this method.

func (*NodeConfig) Stop

func (n *NodeConfig) Stop() error

Stop stops the node from running and removes its container.

func (*NodeConfig) StoreWasmCode

func (n *NodeConfig) StoreWasmCode(wasmFile, from string)

func (*NodeConfig) SubmitParamChangeProposal

func (n *NodeConfig) SubmitParamChangeProposal(proposalJSON, from string)

func (*NodeConfig) SubmitTextProposal

func (n *NodeConfig) SubmitTextProposal(text string, initialDeposit sdk.Coin)

func (*NodeConfig) SubmitUpgradeProposal

func (n *NodeConfig) SubmitUpgradeProposal(upgradeVersion string, upgradeHeight int64, initialDeposit sdk.Coin)

func (*NodeConfig) VoteNoProposal

func (n *NodeConfig) VoteNoProposal(from string, proposalNumber int)

func (*NodeConfig) VoteYesProposal

func (n *NodeConfig) VoteYesProposal(from string, proposalNumber int)

func (*NodeConfig) WaitUntil

func (n *NodeConfig) WaitUntil(doneCondition func(syncInfo coretypes.SyncInfo) bool)

WaitUntil waits until node reaches doneCondition. Return nil if reached, error otherwise.

func (*NodeConfig) WasmExecute

func (n *NodeConfig) WasmExecute(contract, execMsg, from, amounts string, successString string)

func (*NodeConfig) WithSetupTime

func (n *NodeConfig) WithSetupTime(t time.Time) *NodeConfig