ObserveEvent
From The Contingency Market
Contents |
ObserveEvent(ulSessionID,uSequenceID,sIntegrity,sEventID,sEventParameterValue,sTime)
Observe that the specified event has occurred, optionally specifying the observed value and the time it occurred. Events can change from possibilities to occurrences through observation. This unofficial observation enables reputable observers to provide an informative service until such time as official observers can establish the official historical record. A contingency cannot be determined until all the events it depends upon have been officially determined.
PARAMETERS
-
ulong ulSessionID - ID of authenticated session.
-
uint uSequenceID - Sequence number.
-
string sIntegrity -
md5("ipaddr(sid,seq)->ObserveEvent(sEventID,sEventParameterValue,sTime)/secret") -
string sEventID - Unique ID of parent event. Cannot specify root (official history).
-
string sEventParameterValue - The value the event parameter is observed to have (blank if unknown).
-
string sTime - Time at which observed value occurred (leave blank for current time).
RETURNS
SEventRecordData {sEventID,sParameterValue,sParameterType,sAgentIDObserver,bOccurred,sTimeOccurred,sTimeObserved}
-
string sEventID - ID of event observed to occur.
-
string sParameterValue - The value the event parameter is observed to have (blank if unknown).
-
string sParameterType - Type of the parameter.
-
string sAgentIDObserver - Empty if official, otherwise ID of most recent observer.
-
bool bOccurred - True if this is a record of the event occurring, False if a record of the event becoming impossible.
-
string sTimeOccurred - Time at which the event occurred/or not.
-
string sTimeObserved - Time this event record was originally submitted - Blank for official observations.
FAULTS
Session. Event. Time format.
