[#TxRequestTracker-RequestedTx]
= xref:TxRequestTracker.adoc[TxRequestTracker]::RequestedTx
:relfileprefix: ../
:mrdocs:

Marks a transaction as requested, with a specified expiry&period;

== Synopsis

Declared in `&lt;txrequest&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
RequestedTx(
    xref:NodeId-08.adoc[NodeId] peer,
    xref:uint256.adoc[uint256] const& txhash,
    std::chrono::microseconds expiry);
----

== Description

If no CANDIDATE announcement for the provided peer and txhash exists, this call has no effect&period; Otherwise&colon;

* That announcement is converted to REQUESTED&period;
* If any other REQUESTED announcement for the same txhash already existed, it means an unexpected request was made (GetRequestable will never advise doing so)&period; In this case it is converted to COMPLETED, as we&apos;re no longer waiting for a response to it&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *peer*
| Peer the transaction is requested from&period;
| *txhash*
| Transaction hash being requested&period;
| *expiry*
| Time at which the pending request times out&period;
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#
