state

type Batch interface {
	ForEach(func(uint16, StateUpdate) bool)
	StateIndex() uint32
	WithStateIndex(uint32) Batch
	StateTransactionId() valuetransaction.ID
	WithStateTransaction(valuetransaction.ID) Batch
	Timestamp() int64
	Size() uint16
	RequestIds() []*sctransaction.RequestId
	EssenceHash() *hashing.HashValue // except state transaction id
	String() string
	Write(io.Writer) error
	Read(io.Reader) error
}

type StateUpdate interface {
	// request which resulted in this state update
	RequestId() *sctransaction.RequestId
	Timestamp() int64
	WithTimestamp(int64) StateUpdate
	// the payload of variables/values
	String() string
	Mutations() kv.MutationSequence
	Clear()
	Write(io.Writer) error
	Read(io.Reader) error
}

type VirtualState interface {
	// index of the current state. AccessState index is incremented when state transition occurs
	// index 0 means origin state
	StateIndex() uint32
	ApplyStateIndex(uint32)
	// check if state contains record with the given owner address
	InitiatedBy(*address.Address) bool
	// timestamp
	Timestamp() int64
	// updates state without changing state index
	ApplyStateUpdate(stateUpd StateUpdate)
	// applies batch of state updates, state index and timestamp
	ApplyBatch(Batch) error
	// commit means saving virtual state to sc db, making it persistent (solid)
	CommitToDb(batch Batch) error
	// return hash of the variable state. It is a root of the Merkle chain of all
	// state updates starting from the origin
	Hash() *hashing.HashValue
	// the storage of variable/value pairs
	Variables() kv.BufferedKVStore
	Clone() VirtualState
	DangerouslyConvertToString() string
}