types

type ABCI interface {

	// Info returns application info
	Info(*abci.InfoRequest) (*abci.InfoResponse, error)
	// Query  returns application state
	Query(context.Context, *abci.QueryRequest) (*abci.QueryResponse, error)

	// CheckTx validate a tx for the mempool
	CheckTx(*abci.CheckTxRequest) (*abci.CheckTxResponse, error)

	// InitChain Initialize blockchain w validators/other info from CometBFT
	InitChain(*abci.InitChainRequest) (*abci.InitChainResponse, error)
	PrepareProposal(*abci.PrepareProposalRequest) (*abci.PrepareProposalResponse, error)
	ProcessProposal(*abci.ProcessProposalRequest) (*abci.ProcessProposalResponse, error)
	// FinalizeBlock deliver the decided block with its txs to the Application
	FinalizeBlock(*abci.FinalizeBlockRequest) (*abci.FinalizeBlockResponse, error)
	// ExtendVote create application specific vote extension
	ExtendVote(context.Context, *abci.ExtendVoteRequest) (*abci.ExtendVoteResponse, error)
	// VerifyVoteExtension verify application's vote extension data
	VerifyVoteExtension(*abci.VerifyVoteExtensionRequest) (*abci.VerifyVoteExtensionResponse, error)
	// Commit the state and return the application Merkle root hash
	Commit() (*abci.CommitResponse, error)

	// ListSnapshots list available snapshots
	ListSnapshots(*abci.ListSnapshotsRequest) (*abci.ListSnapshotsResponse, error)
	// OfferSnapshot offer a snapshot to the application
	OfferSnapshot(*abci.OfferSnapshotRequest) (*abci.OfferSnapshotResponse, error)
	// LoadSnapshotChunk load a snapshot chunk
	LoadSnapshotChunk(*abci.LoadSnapshotChunkRequest) (*abci.LoadSnapshotChunkResponse, error)
	// ApplySnapshotChunk apply a snapshot chunk
	ApplySnapshotChunk(*abci.ApplySnapshotChunkRequest) (*abci.ApplySnapshotChunkResponse, error)
}

type AppCreator[T Application] func(log.Logger, corestore.KVStoreWithBatch, io.Writer, AppOptions) T

type AppExporter func(
	logger log.Logger,
	db corestore.KVStoreWithBatch,
	traceWriter io.Writer,
	height int64,
	forZeroHeight bool,
	jailAllowedAddrs []string,
	opts AppOptions,
	modulesToExport []string,
) (ExportedApp, error)

type AppOptions = server.DynamicConfig

type Application interface {
	ABCI

	RegisterAPIRoutes(*api.Server, config.APIConfig)

	// RegisterGRPCServerWithSkipCheckHeader registers gRPC services directly with the gRPC
	// server and bypass check header flag.
	RegisterGRPCServerWithSkipCheckHeader(grpc.Server, bool)

	// RegisterTxService registers the gRPC Query service for tx (such as tx
	// simulation, fetching txs by hash...).
	RegisterTxService(client.Context)

	// RegisterTendermintService registers the gRPC Query service for CometBFT queries.
	RegisterTendermintService(client.Context)

	// RegisterNodeService registers the node gRPC Query service.
	RegisterNodeService(client.Context, config.Config)

	// CommitMultiStore return the multistore instance
	CommitMultiStore() storetypes.CommitMultiStore

	// SnapshotManager return the snapshot manager
	SnapshotManager() *snapshots.Manager

	// ValidatorKeyProvider returns a function that generates a validator key
	ValidatorKeyProvider() func() (cmtcrypto.PrivKey, error)

	// Close is called in start cmd to gracefully cleanup resources.
	// Must be safe to be called multiple times.
	Close() error
}

type ExportedApp struct {
	// AppState is the application state as JSON.
	AppState json.RawMessage
	// Validators is the exported validator set.
	Validators []sdk.GenesisValidator
	// Height is the app's latest block height.
	Height int64
	// ConsensusParams are the exported consensus params for ABCI.
	ConsensusParams cmtproto.ConsensusParams
}