vm

Documentation

Index

• func BatchHash(reqids []sctransaction.RequestId, ts int64, leaderIndex uint16) hashing.HashValue
• type VMContext
• type VMTask

Functions

func BatchHash

func BatchHash(reqids []sctransaction.RequestId, ts int64, leaderIndex uint16) hashing.HashValue

BatchHash is used to uniquely identify the VM task

Types

type VMContext

type VMContext struct {
	// invariant through the batch
	// address of the smart contract
	Address address.Address
	// programHash
	ProgramHash hashing.HashValue
	// owner address
	OwnerAddress address.Address
	// reward address
	RewardAddress address.Address
	// minimum reward
	MinimumReward int64
	// are node rewards enabled
	NodeRewardsEnabled bool
	// deterministic source of entropy. Equal the the hash of the previous
	Entropy hashing.HashValue
	// tx builder to build the final transaction
	TxBuilder *txbuilder.Builder
	// timestamp of the batch
	Timestamp int64
	// initial state of the call
	VirtualState state.VirtualState
	// set for each call
	RequestRef sctransaction.RequestRef
	// IsEmpty state update upon call, result of the call.
	StateUpdate state.StateUpdate
	// log
	Log *logger.Logger
}

context of one VM call (for one request)

type VMTask

type VMTask struct {
	// inputs (immutable)
	LeaderPeerIndex uint16
	ProgramHash     hashing.HashValue
	Address         address.Address
	Color           balance.Color
	// deterministic source of entropy (pseudorandom, unpredictable for parties)
	Entropy       hashing.HashValue
	Balances      map[valuetransaction.ID][]*balance.Balance
	OwnerAddress  address.Address
	RewardAddress address.Address
	MinimumReward int64
	Requests      []sctransaction.RequestRef
	Timestamp     int64
	VirtualState  state.VirtualState // input immutable
	Log           *logger.Logger
	// call when finished
	OnFinish func(error)
	// outputs
	ResultTransaction *sctransaction.Transaction
	ResultBatch       state.Batch
}

task context (for batch of requests)