74 lines
2.7 KiB
Go
74 lines
2.7 KiB
Go
package store
|
|
|
|
import (
|
|
"io"
|
|
|
|
corestore "cosmossdk.io/core/store"
|
|
"cosmossdk.io/store/v2/proof"
|
|
)
|
|
|
|
// VersionedDatabase defines an API for a versioned database that allows reads,
|
|
// writes, iteration and commitment over a series of versions.
|
|
type VersionedDatabase interface {
|
|
Has(storeKey []byte, version uint64, key []byte) (bool, error)
|
|
Get(storeKey []byte, version uint64, key []byte) ([]byte, error)
|
|
GetLatestVersion() (uint64, error)
|
|
SetLatestVersion(version uint64) error
|
|
|
|
Iterator(storeKey []byte, version uint64, start, end []byte) (corestore.Iterator, error)
|
|
ReverseIterator(storeKey []byte, version uint64, start, end []byte) (corestore.Iterator, error)
|
|
|
|
ApplyChangeset(version uint64, cs *corestore.Changeset) error
|
|
|
|
// Prune attempts to prune all versions up to and including the provided
|
|
// version argument. The operation should be idempotent. An error should be
|
|
// returned upon failure.
|
|
Prune(version uint64) error
|
|
|
|
// Close releases associated resources. It should NOT be idempotent. It must
|
|
// only be called once and any call after may panic.
|
|
io.Closer
|
|
}
|
|
|
|
// Committer defines an API for committing state.
|
|
type Committer interface {
|
|
// WriteBatch writes a batch of key-value pairs to the tree.
|
|
WriteBatch(cs *corestore.Changeset) error
|
|
|
|
// WorkingCommitInfo returns the CommitInfo for the working tree.
|
|
WorkingCommitInfo(version uint64) *proof.CommitInfo
|
|
|
|
// GetLatestVersion returns the latest version.
|
|
GetLatestVersion() (uint64, error)
|
|
|
|
// LoadVersion loads the tree at the given version.
|
|
LoadVersion(targetVersion uint64) error
|
|
|
|
// Commit commits the working tree to the database.
|
|
Commit(version uint64) (*proof.CommitInfo, error)
|
|
|
|
// GetProof returns the proof of existence or non-existence for the given key.
|
|
GetProof(storeKey []byte, version uint64, key []byte) ([]proof.CommitmentOp, error)
|
|
|
|
// Get returns the value for the given key at the given version.
|
|
//
|
|
// NOTE: This method only exists to support migration from IAVL v0/v1 to v2.
|
|
// Once migration is complete, this method should be removed and/or not used.
|
|
Get(storeKey []byte, version uint64, key []byte) ([]byte, error)
|
|
|
|
// SetInitialVersion sets the initial version of the tree.
|
|
SetInitialVersion(version uint64) error
|
|
|
|
// GetCommitInfo returns the CommitInfo for the given version.
|
|
GetCommitInfo(version uint64) (*proof.CommitInfo, error)
|
|
|
|
// Prune attempts to prune all versions up to and including the provided
|
|
// version argument. The operation should be idempotent. An error should be
|
|
// returned upon failure.
|
|
Prune(version uint64) error
|
|
|
|
// Close releases associated resources. It should NOT be idempotent. It must
|
|
// only be called once and any call after may panic.
|
|
io.Closer
|
|
}
|