FT4 Library/lib.ft4.core.accounts.strategies.transfer/recall_transfer

recall_transfer

function recall_transfer(sender_blockchain_rid: byte_array, sender_id: byte_array, transfer_tx_rid: byte_array, transfer_op_index: integer): (asset, big_integer)(source)

Marks a specific account_creation_transfer that has expired as recalled. It does not send the assets back to the sender.

Can only be called from an operation.

Throws "RECALL ERROR" if the transfer cannot be recalled. Common cases include:

  • no pending transfer is found with the specified details:

    • the transfer was already completed or recalled

    • the transfer was never created

  • too many transfers have the specified details. This should never happen, but it could be caused by one operation creating multiple account_creation_transfers

  • the transfer was found, but it has not yet timed out

Return

a tuple containing (asset, amount) for the account_creation_transfer that was cancelled

Parameters

sender_blockchain_rid

the RID of the blockchain this transfer came from, or this blockchain's RID if the transfer was internal

sender_id

the ID of the sender account

transfer_tx_rid

the ID of the transaction that brought the assets on this chain

transfer_op_index

the index of the operation that brought the assets on this chain in the transfer_tx. Generally, it will be the index of ft4.apply_transfer