cosmos-sdk/x/group/internal/orm/sequence.go
2024-02-13 13:51:26 +00:00

99 lines
2.7 KiB
Go

package orm
import (
"encoding/binary"
storetypes "cosmossdk.io/core/store"
errorsmod "cosmossdk.io/errors"
"cosmossdk.io/x/group/errors"
"cosmossdk.io/x/group/internal/orm/prefixstore"
)
// sequenceStorageKey is a fix key to read/ write data on the storage layer
var sequenceStorageKey = []byte{0x1}
// sequence is a persistent unique key generator based on a counter.
type Sequence struct {
prefix byte
}
func NewSequence(prefix byte) Sequence {
return Sequence{
prefix: prefix,
}
}
// NextVal increments and persists the counter by one and returns the value.
func (s Sequence) NextVal(store storetypes.KVStore) uint64 {
pStore := prefixstore.New(store, []byte{s.prefix})
v, err := pStore.Get(sequenceStorageKey)
if err != nil {
panic(err)
}
seq := DecodeSequence(v)
seq++
err = pStore.Set(sequenceStorageKey, EncodeSequence(seq))
if err != nil {
panic(err)
}
return seq
}
// CurVal returns the last value used. 0 if none.
func (s Sequence) CurVal(store storetypes.KVStore) uint64 {
pStore := prefixstore.New(store, []byte{s.prefix})
v, err := pStore.Get(sequenceStorageKey)
if err != nil {
panic(err)
}
return DecodeSequence(v)
}
// PeekNextVal returns the CurVal + increment step. Not persistent.
func (s Sequence) PeekNextVal(store storetypes.KVStore) uint64 {
pStore := prefixstore.New(store, []byte{s.prefix})
v, err := pStore.Get(sequenceStorageKey)
if err != nil {
panic(err)
}
return DecodeSequence(v) + 1
}
// InitVal sets the start value for the sequence. It must be called only once on an empty DB.
// Otherwise an error is returned when the key exists. The given start value is stored as current
// value.
//
// It is recommended to call this method only for a sequence start value other than `1` as the
// method consumes unnecessary gas otherwise. A scenario would be an import from genesis.
func (s Sequence) InitVal(store storetypes.KVStore, seq uint64) error {
pStore := prefixstore.New(store, []byte{s.prefix})
has, err := pStore.Has(sequenceStorageKey)
if err != nil {
return err
}
if has {
return errorsmod.Wrap(errors.ErrORMUniqueConstraint, "already initialized")
}
return pStore.Set(sequenceStorageKey, EncodeSequence(seq))
}
// DecodeSequence converts the binary representation into an Uint64 value.
func DecodeSequence(bz []byte) uint64 {
if bz == nil {
return 0
}
val := binary.BigEndian.Uint64(bz)
return val
}
// EncodedSeqLength number of bytes used for the binary representation of a sequence value.
const EncodedSeqLength = 8
// EncodeSequence converts the sequence value into the binary representation.
func EncodeSequence(val uint64) []byte {
bz := make([]byte, EncodedSeqLength)
binary.BigEndian.PutUint64(bz, val)
return bz
}