api

type BlockStore interface {
	PeerLedgerExtension
	AddBlock(block *common.Block) error
	GetBlockchainInfo() (*common.BlockchainInfo, error)
	RetrieveBlocks(startNum uint64) (ledger.ResultsIterator, error)
	RetrieveBlockByHash(blockHash []byte) (*common.Block, error)
	RetrieveBlockByNumber(blockNum uint64) (*common.Block, error) // blockNum of  math.MaxUint64 will return last block
	RetrieveTxByID(txID string) (*common.Envelope, error)
	RetrieveTxByBlockNumTranNum(blockNum uint64, tranNum uint64) (*common.Envelope, error)
	RetrieveBlockByTxID(txID string) (*common.Block, error)
	RetrieveTxValidationCodeByTxID(txID string) (peer.TxValidationCode, error)
	ExportTxIds(dir string, newHashFunc snapshot.NewHashFunc) (map[string][]byte, error)
	Shutdown()
}

type BlockStoreProvider interface {
	Open(ledgerid string) (BlockStore, error)
	Close()
}

type PeerLedgerExtension interface {
	// CheckpointBlock updates checkpoint info of underlying blockstore with given block
	// and invokes the given notifier before the checkpoint is broadcast
	CheckpointBlock(block *common.Block, notify func()) error
}

type SnapshotInfo struct {
	LedgerID          string
	LastBlockNum      uint64
	LastBlockHash     []byte
	PreviousBlockHash []byte
}