Skip to content

Invoke

[Source]

(Added by the [Hooks amendment][].)

{
"TransactionType": "Invoke",
"Account": "rWYkbWkCeg8dP6rXALnjgZSjjLyih5NXm",
"Blob": "697066733A2F2F4445414442454546",
"Destination": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
}
FieldJSON Type[Internal Type][]Description
AccountStringAccountIDThe address of the account that is invoking the hook.
BlobStringBlob(Optional) A blob of data that is passed to the hook. (512 byte max)
DestinationStringAccountID(Optional) The address of the account that is the target of the hook.
InvoiceIDStringHash256(Optional) Arbitrary 256-bit hash representing a specific reason or identifier for this payment.

The Invoke transaction has a standard transaction cost, plus an additional cost based on the size of the Blob and HookParameters fields.

Besides errors that can occur for all transactions, Invoke transactions can result in the following transaction result codes:

Error CodeDescription
temDISABLEDOccurs if the Hooks amendment is not enabled.
temMALFORMEDOccurs if the Blob field is larger than 128 KiB.
terNO_ACCOUNTOccurs if the sending account or the destination account does not exist.