RegisterOffer
From The Contingency Market
Contents |
RegisterOffer(ulSessionID,uSequenceID,sIntegrity,sContingencyID,nOnDeal,nOnSuccess,nOnFailure,dLimit,uSecondsToLive,bAutoAccept,sAgentIDCommissioner,fCommission,bEnsure)
Registers a contingent offer.
PARAMETERS
-
ulong ulSessionID - ID of authenticated session.
-
uint uSequenceID - Sequence number.
-
string sIntegrity -
md5("ipaddr(sid,seq)->RegisterOffer(sContingencyID,nOnDeal,nOnSuccess,nOnFailure,dLimit,uSecondsToLive,bAutoAccept,sAgentIDCommissioner,fCommission,bEnsure)/secret") -
string sContingencyID - Contingency on which this offer is contingent.
-
int nOnDeal - Parts of any fund to be received by this agent from the agent taking this offer when a deal is struck.
-
int nOnSuccess - Parts of any fund to be received by this agent from the agent taking this offer when the deal succeeds.
-
int nOnFailure - Parts of any fund to be received by this agent from the agent taking this offer when the deal fails.
-
double dLimit - Maximum amount of funds offered. Zero if unlimited.
-
uint uSecondsToLive - Lifetime of this offer from registration time in seconds. 0 if indefinite.
-
bool bAutoAccept - Whether any acceptable counter-offer should be automatically accepted.
-
string sAgentIDCommissioner - Whether another agent should receive a proportion of positive funds transferred. null if not.
-
float fCommission - Proportion. 0.5 means 50%.
-
bool bEnsure - Whether an existing, unexpired offer should be returned if matching (all but uSecondsToLive).
RETURNS
SOfferData {sID,sContingencyID,sAgentID,nOnDeal,nOnSuccess,nOnFailure,dLimit,uSecondsToLive,bAutoAccept,sAgentIDCommissioner,fCommission,sTimeOfOffer,bIsExpired}
-
string sID - ID of registered offer.
-
string sContingencyID - Contingency on which this offer is contingent.
-
string sAgentID - Agent making this offer.
-
int nOnDeal - Parts of any fund to be received by this agent from the agent taking this offer when a deal is struck.
-
int nOnSuccess - Parts of any fund to be received by this agent from the agent taking this offer when the deal succeeds.
-
int nOnFailure - Parts of any fund to be received by this agent from the agent taking this offer when the deal fails.
-
double dLimit - Maximum amount of funds offered. Zero if unlimited.
-
uint uSecondsToLive - Lifetime of this offer from registration time in seconds. 0 if indefinite.
-
bool bAutoAccept - Whether any acceptable counter-offer should be automatically accepted.
-
string sAgentIDCommissioner - Whether another agent should receive a proportion of positive funds transferred. null if not.
-
float fCommission - Proportion. 0.5 means 50%.
-
string sTimeOfOffer - Time offer was registered.
-
bool bIsExpired - Whether offer has already expired.
FAULTS
Session. Event, Contingency.

