github.com/intfoundation/intchain@v0.0.0-20220727031208-4316ad31ca73/intdb/database.go (about)

     1  // Copyright 2018 The go-ethereum Authors
     2  // This file is part of the go-ethereum library.
     3  //
     4  // The go-ethereum library is free software: you can redistribute it and/or modify
     5  // it under the terms of the GNU Lesser General Public License as published by
     6  // the Free Software Foundation, either version 3 of the License, or
     7  // (at your option) any later version.
     8  //
     9  // The go-ethereum library is distributed in the hope that it will be useful,
    10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
    11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    12  // GNU Lesser General Public License for more details.
    13  //
    14  // You should have received a copy of the GNU Lesser General Public License
    15  // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
    16  
    17  // Package intdb defines the interfaces for an INT Chain data store.
    18  package intdb
    19  
    20  import "io"
    21  
    22  // Reader wraps the Has and Get method of a backing data store.
    23  type Reader interface {
    24  	// Has retrieves if a key is present in the key-value data store.
    25  	Has(key []byte) (bool, error)
    26  
    27  	// Get retrieves the given key if it's present in the key-value data store.
    28  	Get(key []byte) ([]byte, error)
    29  }
    30  
    31  // Writer wraps the Put method of a backing data store.
    32  type Writer interface {
    33  	// Put inserts the given value into the key-value data store.
    34  	Put(key []byte, value []byte) error
    35  
    36  	// Delete removes the key from the key-value data store.
    37  	Delete(key []byte) error
    38  }
    39  
    40  // Stater wraps the Stat method of a backing data store.
    41  type Stater interface {
    42  	// Stat returns a particular internal stat of the database.
    43  	Stat(property string) (string, error)
    44  }
    45  
    46  // Compacter wraps the Compact method of a backing data store.
    47  type Compacter interface {
    48  	// Compact flattens the underlying data store for the given key range. In essence,
    49  	// deleted and overwritten versions are discarded, and the data is rearranged to
    50  	// reduce the cost of operations needed to access them.
    51  	//
    52  	// A nil start is treated as a key before all keys in the data store; a nil limit
    53  	// is treated as a key after all keys in the data store. If both is nil then it
    54  	// will compact entire data store.
    55  	Compact(start []byte, limit []byte) error
    56  }
    57  
    58  // KeyValueStore contains all the methods required to allow handling different
    59  // key-value data stores backing the high level database.
    60  type KeyValueStore interface {
    61  	Reader
    62  	Writer
    63  	Batcher
    64  	Iteratee
    65  	Stater
    66  	Compacter
    67  	io.Closer
    68  }
    69  
    70  // Database contains all the methods required by the high level database to not
    71  // only access the key-value data store but also the chain freezer.
    72  type Database interface {
    73  	Reader
    74  	Writer
    75  	Batcher
    76  	Iteratee
    77  	Stater
    78  	Compacter
    79  	io.Closer
    80  }