These docs are for v2.0. Click to read the latest docs for v3.0.

The main function of your hook

Concepts

Behaviour

  • hook is a user defined function called by xrpld in order to fire your hook.
  • Your hook function calls either accept or reject to pass or reject the originating transaction.
  • If execution reaches the end of the function it is implicitly an accept.

Definition

int64_t hook (
    uint32_t reserved
)

Example

int64_t hook(uint32_t reserved)
{
  return 0;
}

Parameters

NameTypeDescription
reserveduint32_tReserved for future use.

Return Code

TypeDescription
int64_tAn arbitrary return code you wish to return from your hook. This will be present in the metadata of the originating transaction.