resolveTransactionReferenceread-only

Resolve a stable transaction ID, a wallet-local identifier, or an external withdrawal reference to a stable transaction ID.

Request:

The request args must be a ResolveTransactionReferenceRequest object.

Response:

On success, the result is a ResolveTransactionReferenceResponse object.

Expected errors:

The caller can handle the following errors inline: WALLET_TRANSACTION_NOT_FOUND, WALLET_CORE_API_BAD_REQUEST.

Details:

Three kinds of references are accepted:

• a stable transaction ID (TransactionIdStr), which is returned unchanged;

• a wallet-local identifier of the form #<type>:<localIdent>, as reported in the transaction’s localTransactionId field. Local identifiers are deliberately not portable: importing or merging a wallet can assign different local identifiers;

• an external, bank-generated withdrawal reference (such as an LSD 0006 withdrawal-transfer-result reference) that contains the reserve public key of a withdrawal. The reference must match exactly one withdrawal transaction, otherwise the request fails with WALLET_TRANSACTION_NOT_FOUND.

interface ResolveTransactionReferenceRequest {
  transactionReference: string;
}

interface ResolveTransactionReferenceResponse {
  transactionId: TransactionIdStr;
}