Class ActionEvaluator

Class responsible for handling of IAction evaluations.

Inheritance

Object

ActionEvaluator

Implements

IActionEvaluator

Inherited Members

Object.Equals(Object)

Object.Equals(Object, Object)

Object.GetHashCode()

System.Object.GetType()

Object.MemberwiseClone()

Object.ReferenceEquals(Object, Object)

System.Object.ToString()

Namespace: Libplanet.Action

Assembly: Libplanet.Action.dll

Syntax

public class ActionEvaluator : IActionEvaluator

Constructors

ActionEvaluator(PolicyBlockActionGetter, IStateStore, IActionLoader)

Creates a new ActionEvaluator.

Declaration

public ActionEvaluator(PolicyBlockActionGetter policyBlockActionGetter, IStateStore stateStore, IActionLoader actionTypeLoader)

Parameters

Type	Name	Description
PolicyBlockActionGetter	policyBlockActionGetter	A delegator to get policy block action to evaluate at the end for each IPreEvaluationBlock that gets evaluated.
IStateStore	stateStore	The IStateStore to use to retrieve the states for a provided HashDigest<T>.
IActionLoader	actionTypeLoader	A IActionLoader implementation using action type lookup.

Properties

ActionLoader

The IActionLoader used by this IActionEvaluator when evaluating Blocks.

Declaration

[Pure]
public IActionLoader ActionLoader { get; }

Property Value

Type	Description
IActionLoader

Methods

Evaluate(IPreEvaluationBlock, Nullable<HashDigest<SHA256>>)

The main entry point for evaluating a IPreEvaluationBlock.

Declaration

[Pure]
public IReadOnlyList<ICommittedActionEvaluation> Evaluate(IPreEvaluationBlock block, HashDigest<SHA256>? baseStateRootHash)

Parameters

Type	Name	Description
IPreEvaluationBlock	block	The block to evaluate.
Nullable<HashDigest<SHA256>>	baseStateRootHash	The base state to use when evaluating block.

Returns

Type	Description
IReadOnlyList<ICommittedActionEvaluation>	The result of evaluating every IAction related to block as an IReadOnlyList<T> of ICommittedActionEvaluations.

Remarks

This has a side-effect of writing data to internally held IStateStore.

First evaluates all IActions in Transactions of block and appends the evaluation of the held by the instance at the end.

GenerateRandomSeed(Byte[], Byte[], Int32)

Creates a random seed.

Declaration

[Pure]
public static int GenerateRandomSeed(byte[] preEvaluationHashBytes, byte[] signature, int actionOffset)

Parameters

Type	Name	Description
System.Byte[]	preEvaluationHashBytes	The pre-evaluation hash as bytes.
System.Byte[]	signature	The signature of the Transaction the target IAction belongs to. Must be empty if the target IAction is a block action.
Int32	actionOffset	The offset of the target IAction.

Returns

Type	Description
Int32	An integer of the random seed.

Exceptions

Type	Condition
ArgumentException	Thrown when preEvaluationHashBytes is empty.

Implements

IActionEvaluator