testnode

Documentation

Index

• func DefaultAppConfig() *srvconfig.Config
• func DefaultGenesisState(fundedAccounts ...string) (map[string]json.RawMessage, keyring.Keyring, error)
• func DefaultParams() *tmproto.ConsensusParams
• func DefaultTendermintConfig() *config.Config
• type Context
  • func DefaultNetwork(t *testing.T, blockTime time.Duration) (cleanup func() error, accounts []string, cctx Context)
  • func New(t *testing.T, cparams *tmproto.ConsensusParams, tmCfg *config.Config, ...) (*node.Node, srvtypes.Application, Context, error)
  • func StartGRPCServer(app srvtypes.Application, appCfg *srvconfig.Config, cctx Context) (Context, func() error, error)
  • func StartNode(tmNode *node.Node, cctx Context) (Context, func() error, error)
  • func (c *Context) FillBlock(squareSize int, accounts []string, broadcastMode string) (*sdk.TxResponse, error)
  • func (c *Context) GoContext() context.Context
  • func (c *Context) LatestHeight() (int64, error)
  • func (c *Context) PostData(account, broadcastMode string, ns, msg []byte) (*sdk.TxResponse, error)
  • func (c *Context) WaitForHeight(h int64) (int64, error)
  • func (c *Context) WaitForHeightWithTimeout(h int64, t time.Duration) (int64, error)
  • func (c *Context) WaitForNextBlock() error

Functions

func DefaultAppConfig

func DefaultAppConfig() *srvconfig.Config

DefaultAppConfig wraps the default config described in the server

func DefaultGenesisState

func DefaultGenesisState(fundedAccounts ...string) (map[string]json.RawMessage, keyring.Keyring, error)

DefaultGenesisState returns a default genesis state and a keyring with accounts that have coins. The keyring accounts are based on the fundedAccounts parameter.

func DefaultParams

func DefaultParams() *tmproto.ConsensusParams

func DefaultTendermintConfig

func DefaultTendermintConfig() *config.Config

Types

type Context

type Context struct {
	client.Context
	// contains filtered or unexported fields
}

func DefaultNetwork

func DefaultNetwork(t *testing.T, blockTime time.Duration) (cleanup func() error, accounts []string, cctx Context)

DefaultNetwork creates an in-process single validator celestia-app network using test friendly defaults. These defaults include fast block times and funded accounts. The returned client.Context has a keyring with all of the funded keys stored in it.

func New

func New(
	t *testing.T,
	cparams *tmproto.ConsensusParams,
	tmCfg *config.Config,
	supressLog bool,
	genState map[string]json.RawMessage,
	kr keyring.Keyring,
) (*node.Node, srvtypes.Application, Context, error)

New creates a ready to use tendermint node that operates a single validator celestia-app network using the provided genesis state. The provided keyring is stored in the client.Context that is returned.

NOTE: the forced delay between blocks, TimeIotaMs in the consensus parameters, is set to the lowest possible value (1ms).

func StartGRPCServer

func StartGRPCServer(app srvtypes.Application, appCfg *srvconfig.Config, cctx Context) (Context, func() error, error)

StartGRPCServer starts the grpc server using the provided application and config. A grpc client connection to that server is also added to the client context. The returned function should be used to shutdown the server.

func StartNode

func StartNode(tmNode *node.Node, cctx Context) (Context, func() error, error)

StartNode starts the tendermint node along with a local core rpc client. The rpc is returned via the client.Context. The function returned should be called during cleanup to teardown the node, core client, along with canceling the internal context.Context in the returned Context.

func (*Context) FillBlock

func (c *Context) FillBlock(squareSize int, accounts []string, broadcastMode string) (*sdk.TxResponse, error)

FillBlock creates and submits a single transaction that is large enough to create a square of the desired size. broadcast mode indicates if the tx should be submitted async, sync, or block. (see flags.BroadcastModeSync). If broadcast mode is the string zero value, then it will be set to block.

func (*Context) GoContext

func (c *Context) GoContext() context.Context

func (*Context) LatestHeight

func (c *Context) LatestHeight() (int64, error)

LatestHeight returns the latest height of the network or an error if the query fails.

func (*Context) PostData

func (c *Context) PostData(account, broadcastMode string, ns, msg []byte) (*sdk.TxResponse, error)

PostData will create and submit PFB transaction containing the message and namespace. This function blocks until the PFB has been included in a block and returns an error if the transaction is invalid or is rejected by the mempool.

func (*Context) WaitForHeight

func (c *Context) WaitForHeight(h int64) (int64, error)

WaitForHeight performs a blocking check where it waits for a block to be committed after a given block. If that height is not reached within a timeout, an error is returned. Regardless, the latest height queried is returned.

func (*Context) WaitForHeightWithTimeout

func (c *Context) WaitForHeightWithTimeout(h int64, t time.Duration) (int64, error)

WaitForHeightWithTimeout is the same as WaitForHeight except the caller can provide a custom timeout.

func (*Context) WaitForNextBlock

func (c *Context) WaitForNextBlock() error

WaitForNextBlock waits for the next block to be committed, returning an error upon failure.