GetDeal

From The Contingency Market

Jump to: navigation, search

Contents

GetDeal(ulSessionID,uSequenceID,sIntegrity,sDealID)

Retrieves a specific, registered deal.

PARAMETERS

ulong ulSessionID 
ID of authenticated session.
uint uSequenceID 
Sequence number.
string sIntegrity 
md5("ipaddr(sid,seq)->GetDeal(sDealID)/secret")
sDealID 
ID of deal required.

RETURNS

SDealData {sID,sOfferIDMade,sOfferIDTaken,nOnDeal,nOnSuccess,nOnFailure,dLimit,uSecondsToLive,sTimeOfDeal,dFund,sTimeDetermined,bMakerCanClose,bTakerCanClose,bIsExpired,bIsDetermined,bIsAccepted,bIsRejected}

string sID 
ID of registered offer.
string sOfferIDMade 
ID of offer being made.
string sOfferIDTaken 
ID of compatible counter-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 transferrable funds. Zero if unlimited.
uint uSecondsToLive 
Lifetime of this offer from registration time in seconds. 0 if indefinite.
string sTimeOfDeal 
Time deal was registered.
double dFund 
Amount of funds actually transferred. Zero if if not yet determined, rejected or expired.
string sTimeDetermined 
Time at which the outcome of this deal was determined. Blank if not yet determined.
bool bMakerCanClose 
True if the maker's acceptance is all that's necessary to make this deal jointly accepted.
bool bTakerCanClose 
True if the taker's acceptance is all that's necessary to make this deal jointly accepted.
bool bIsExpired 
Whether deal has already expired.
bool bIsDetermined 
Whether the deal has been determined yet.
bool bIsAccepted 
Whether the deal has been jointly accepted.
bool bIsRejected 
Whether the deal has been rejected by either party.

FAULTS

Session. Deal.

TEST

GetDeal() according to the respective template currently returns 'Null ID invalid'.

Views
Personal tools