Contents

GET /wads/$WAD_ID#

Obtain information about a wad.

Request:

Response:

200 OK:

The operation succeeded, the exchange provides details about the wad. The response will include a WadDetails object.

404 Not found:

The wad is unknown to the exchange.

Details:

interface WadDetails {

 // Total transfer amount claimed by the exchange.
 total: Amount;

 // Indicative time by which the wad was given to the
 // bank to execute the wire transfer.
 wad_execution_time: Timestamp;

 // Transfers aggregated in the wad.
 items: WadItem[];

 // EdDSA signature of the exchange affirming the wad
 // data is correct, must be over TALER_WadDataSignaturePS
 // and of purpose TALER_SIGNATURE_WAD_DATA.
 exchange_sig: EddsaSignature;

 // public key used to create the signature.
 exchange_pub: EddsaPublicKey;
}

Objects in the wad item list have the following format:

interface WadItem {

  // Amount in the purse.
  amount: Amount;

  // Normalized payto URI of the account the purse is to be merged into.
  // Must be of the form: 'payto://taler/EXCHANGE_URL/RESERVE_PUB'.
  payto_uri: string;

  // Purse public key.
  purse_pub: EddsaPublicKey;

  // Hash of the contract.
  h_contract: HashCode;

  // Indicative time by which the purse should expire
  // if it has not been paid.
  purse_expiration: Timestamp;

  // Client-side timestamp of when the merge request was made.
  merge_timestamp: Timestamp;

  // Signature created with the reserve's private key.
  // Must be of purpose TALER_SIGNATURE_ACCOUNT_MERGE
  // and over TALER_AccountMergeSignaturePS.
  reserve_sig: EddsaSignature;

  // Signature created with the purse's private key.
  // Must be of purpose TALER_SIGNATURE_PURSE_MERGE
  // and over TALER_PurseMergeSignaturePS.
  purse_sig: EddsaSignature;

  // Deposit fees that were charged to the purse.
  deposit_fees: Amount;

  // Wad fees that was charged to the purse.
  wad_fees: Amount;
}