When is a history entry recorded?

Noumena Protocol Language
1

When is a history recorded? Is this on every action or only for actions which result in a change of state?

2

Hi Sandy,

An entry in the history is created when the protocol version changes.

  1. This is independent of any protocol retrieval call
  2. This is independent of any protocol permission that would only read data
@api
permission[innovator] doNothing()  {
    return otherProtocol.getName[innovator](); // return this.name
};
  1. An entry is create if there is an assignment or a state machine state change.
@api
permission[innovator] doTheSameThing()  {
    this.validNames = this.validNames;
};

Note that the protocol version is incremented on each assignment, regardless of the value change, possibly multiple times in a single permission.

The streaming endpoint /api/streams/current-archived-states will return those states. State notifications will also be emitted when listening to the /api/streams/states stream.

The same cannot be said for the commands which also include the non-altering requests to permission calls.