- 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; }