FT4 Library/lib.ft4.external.assets/transfer

transfer

@mount("ft4.transfer") operation transfer(recipient_id: byte_array, asset_id: byte_array, amount: big_integer)(source)

Transfers tokens to a certain recipient.

  • if the recipient exists, a normal transfer will take place;

  • otherwise:

    • if account creation on transfer is enabled, the account registration procedure will be started;

    • an error is thrown

Must be signed by an auth descriptor with accounts.auth_flags.TRANSFER

Throws if the required assets cannot be transferred. Common cases include:

  • the sender account's balance is lower than amount

  • the amount to transfer is not in the accepted range (0, 2^256) (exclusive)

  • some conditions added in development through transfer extensions (before_transfer or after_transfer) aren't met

Parameters

recipient_id

the account that should receive the transfer or be created

asset_id

id of the asset that should be sent

amount

the amount to transfer