storage

Documentation

Index

• Constants
• Variables
• func EnableKeyNameTracking()
• type DebugBatch
  • func (b *DebugBatch) Begin(writable bool) KeyValueTxn
  • func (b *DebugBatch) Commit() error
  • func (b *DebugBatch) Discard()
  • func (b *DebugBatch) Get(key Key) (v []byte, err error)
  • func (b *DebugBatch) PretendWrite()
  • func (b *DebugBatch) Put(key Key, value []byte) error
  • func (b *DebugBatch) PutAll(values map[Key][]byte) error
• type Key
  • func MakeKey(keys ...interface{}) Key
  • func (k Key) Append(key ...interface{}) Key
  • func (k Key) MarshalJSON() ([]byte, error)
  • func (k Key) String() string
• type KeyValueStore
• type KeyValueTxn
• type Logger

Constants

const (
	KeyLength = 32 // Total bytes used for keys
)

Variables

var ErrNotFound = errors.StatusNotFound

ErrNotFound is returned by KeyValueDB.Get if the key is not found.

var ErrNotOpen = errors.New(errors.StatusInternalError, "not open")

ErrNotOpen is returned by KeyValueDB.Get, .Put, and .Close if the database is not open.

Functions

func EnableKeyNameTracking

func EnableKeyNameTracking()

Types

type DebugBatch

type DebugBatch struct {
	Batch  KeyValueTxn
	Logger Logger

	Writable bool
	// contains filtered or unexported fields
}

func (*DebugBatch) Begin

func (b *DebugBatch) Begin(writable bool) KeyValueTxn

func (*DebugBatch) Commit

func (b *DebugBatch) Commit() error

func (*DebugBatch) Discard

func (b *DebugBatch) Discard()

func (*DebugBatch) Get

func (b *DebugBatch) Get(key Key) (v []byte, err error)

func (*DebugBatch) PretendWrite

func (b *DebugBatch) PretendWrite()

func (*DebugBatch) Put

func (b *DebugBatch) Put(key Key, value []byte) error

func (*DebugBatch) PutAll

func (b *DebugBatch) PutAll(values map[Key][]byte) error

type Key

type Key [KeyLength]byte

func MakeKey

func MakeKey(keys ...interface{}) Key

func (Key) Append

func (k Key) Append(key ...interface{}) Key

func (Key) MarshalJSON

func (k Key) MarshalJSON() ([]byte, error)

MarshalJSON is implemented for JSON-based logging

func (Key) String

func (k Key) String() string

String hex encodes the key. If debugging is enabled, String looks up the original composite key.

type KeyValueStore

type KeyValueStore interface {
	// Close closes the store.
	Close() error
	// Begin begins a transaction.
	Begin(writable bool) KeyValueTxn
}

type KeyValueTxn

type KeyValueTxn interface {
	// Get gets a value.
	Get(key Key) ([]byte, error)
	// Put puts a value.
	Put(key Key, value []byte) error
	// PutAll puts many values.
	PutAll(map[Key][]byte) error
	// Commit commits the transaction.
	Commit() error
	// Discard discards the transaction.
	Discard()
	// Begin begins a sub-transaction.
	Begin(writable bool) KeyValueTxn
}

type Logger

type Logger interface {
	Debug(msg string, keyVals ...interface{})
	Info(msg string, keyVals ...interface{})
	Error(msg string, keyVals ...interface{})
}

Logger defines a generic logging interface compatible with Tendermint (stolen from Tendermint).