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

Introduction

Hooks add smart contract functionality to the XRP Ledger: layer one custom code to influence the behaviour and flow of transactions. Hooks are small, efficient pieces of code being defined on an XRPL account, allowing logic to be executed before and/or after XRPL transactions.

📘

Please note: you're reading the technical documentation of Hooks. This documentation is highly technical & assumes prior knowledge of programming and the XRP Ledger. If you are looking for examples on what Hooks are, will bring to the XRP Ledger and what they could do, please check this page.

The XRP ledger is known and is being appreciated for its transaction throughput, speed and the low fees. Combined with available advanced transaction types like multi sign, escrows, payment channels and even a decentralized exchange (all on ledger, out of the box, without requiring smart contracts) the XRPL has a lot to offer businesses and (creative) developers.

Hooks add smart contract functionality to the XRP Ledger: layer one custom code to influence the behaviour and flow of transactions. Hooks are small, efficient pieces of code being defined on an XRPL account, allowing logic to be executed before and/or after XRPL transactions. These Hooks can be really simple, like: “reject payments < 10 XRP”, or “for all outgoing payments, send 10% to my savings account” or more advanced.

2487

Hooks high level concept

By allowing Hooks to not only execute efficient logic but also to store small, simple data objects, one could define a Hook like: “for incoming payments transactions, check if the sending account is in a list maintained by another Hook, and if present: reject the transaction”.

Hooks are deliberately not Turing-Complete. While often touted as the holy grail of smart contracts, Turing-Completeness is actually inappropriate for smart contracts. (See Blog 2.)

Hooks are currently live on a public testnet. It's time for testing, coding, having fun & breaking things, so a future amendment to add Hooks to the XRP Ledger livenet can be drafted with confidence.

Resources