client

type Block struct {
	BlockID *types.BlockID `json:"block_id"`
	Block   *types.Block   `json:"block"`
}

type BlockResults struct {
	Height                int64                     `json:"height"`
	TxsResults            []*abci.ExecTxResult      `json:"txs_results"`
	FinalizeBlockEvents   []*abci.Event             `json:"finalize_block_events"`
	ValidatorUpdates      []*abci.ValidatorUpdate   `json:"validator_updates"`
	ConsensusParamUpdates *cmtproto.ConsensusParams `json:"consensus_param_updates"`
	AppHash               []byte                    `json:"app_hash"`
}

type BlockResultsServiceClient interface {
	GetBlockResults(ctx context.Context, height int64) (*BlockResults, error)
	GetLatestBlockResults(ctx context.Context) (*BlockResults, error)
}

type BlockServiceClient interface {
	// GetBlockByHeight attempts to retrieve the block associated with the
	// given height.
	GetBlockByHeight(ctx context.Context, height int64) (*Block, error)

	// GetLatestBlock attempts to retrieve the latest committed block.
	GetLatestBlock(ctx context.Context) (*Block, error)

	// GetLatestHeight provides sends the latest committed block height to the
	// resulting output channel as blocks are committed.
	GetLatestHeight(ctx context.Context, opts ...GetLatestHeightOption) (<-chan LatestHeightResult, error)
}

type Client interface {
	VersionServiceClient
	BlockServiceClient
	BlockResultsServiceClient

	// Close the connection to the server. Any subsequent requests will fail.
	Close() error
}

type GetLatestHeightOption func(*getLatestHeightConfig)

type LatestHeightResult struct {
	Height int64
	Error  error
}

type Option func(*clientBuilder)

type Version struct {
	Node  string // The semantic version of the node software (i.e. the version of CometBFT).
	ABCI  string // The version of the ABCI protocol used by the node.
	P2P   uint64 // The version of the P2P protocol used by the node.
	Block uint64 // The version of the block protocol used by the node.
}

type VersionServiceClient interface {
	GetVersion(ctx context.Context) (*Version, error)
}