RegisterOffer

From The Contingency Market

Jump to: navigation, search

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.

Views
Personal tools