Skip to content
EnabledTier ATokens

Clawback XLS-39

Issuers can recover tokens with clawback enabled for regulatory reasons. Clawback is enabled on the XRP Ledger. xrpscan reports Feb 8, 2024 (UTC) as its activation date and rippled 1.12.0 as its first version.

Sources reviewed Oct 5, 2026 · English page updated Oct 5, 2026 · Phil · CryptoTuts founder

Status
Enabled
XLS
XLS-39
Enabled
Feb 8, 2024 (UTC)

What does this amendment change?

Why does this amendment exist?

Regulated issuers may be required to recover issued assets from particular accounts.

How does the mechanism work?

The issuer enables lsfAllowTrustLineClawback once through AccountSet before its owner directory contains entries. A Clawback transaction can then debit an amount of its own trust line token from the specified counterparty. If the requested amount exceeds the balance, recovery is capped at the available balance.

What changes compared with the predecessor?

BeforeAfter
Freeze could stop further use of an issued token but could not remove units already held in an account.An appropriately configured issuer can recover its own issued assets from a trust line.

Who is this change relevant to?

XRP holders and users

Before acquiring a token, holders need to check its clawback configuration. For trust line tokens, enabling the account's clawback right is permanent. No such right exists for XRP.

Wallets and app developers

Wallets, explorers, and exchanges should show the applicable account flag or MPT issuance capability and distinguish clawback events from ordinary transfers.

Exchanges and issuers

Issuers gain a regulatory recovery tool. Enabling trust line clawback requires an empty owner directory, is irreversible, and is incompatible with NoFreeze. MPT clawback depends on the issuance's capability.

Node operators

Nodes check the issuer, trust line, amount, and account flags and cap recovery at the existing balance.

What limitations and risks remain?

  • Clawback applies only to issued assets and never to XRP.
  • Trust line clawback is disabled by default and must be enabled before trust lines, offers, escrows, payment channels, or checks populate the issuer's owner directory.
  • lsfAllowTrustLineClawback cannot be removed once set.
  • Clawback and the irreversible NoFreeze commitment are mutually exclusive.
  • XLS-39 covers only freely available trust line balances. Tokens in AMMs or escrows require separate extensions.
Technical details: transactions, fields, codes and invariants

Transactions

  • AccountSet
  • Clawback

Ledger objects

  • AccountRoot
  • RippleState

Fields and flags

  • Amount
  • Account
  • lsfAllowTrustLineClawback 0x80000000
  • lsfNoFreeze

Result codes

  • tecOWNERS
  • tecNO_PERMISSION
  • tecNO_LINE
  • temBAD_AMOUNT

How does this amendment relate to others?

Every direct relationship has a type, an explanation and a primary source.

What happens next for this amendment?

Clawback is enabled on the XRP Ledger. xrpscan reports Feb 8, 2024 (UTC) as its activation date and rippled 1.12.0 as its first version.

These rules are already part of Mainnet. Server operators need a compatible xrpld (formerly rippled) version; ordinary wallet users do not need to enable anything manually.

Where does it sit within its amendment family?

AMM and Clawback: protocol progression

  1. DeletableAccountsEnabled · from rippled 1.4.0
  2. TicketBatchEnabled · from rippled 1.7.0
  3. DisallowIncomingEnabled · from rippled 1.10.0
  4. AMMEnabled · from rippled 1.12.0
  5. ClawbackEnabled · from rippled 1.12.0
  6. fixDisallowIncomingV1Enabled · from rippled 2.0.0
  7. fixInnerObjTemplateEnabled · from rippled 2.1.0
  8. fixAMMOverflowOfferEnabled · from rippled 2.1.1
  9. fixAMMv1_1Enabled · from rippled 2.2.0
  10. fixPreviousTxnIDEnabled · from rippled 2.2.0
  11. AMMClawbackEnabled · from rippled 2.3.0
  12. fixAMMv1_2Enabled · from rippled 2.3.0
  13. fixInnerObjTemplate2Enabled · from rippled 2.3.0
  14. fixFrozenLPTokenTransferEnabled · from rippled 2.4.0
  15. DeepFreezeEnabled · from rippled 2.4.0
  16. PermissionedDEXEnabled · from rippled 2.5.0
  17. fixAMMv1_3Enabled · from rippled 2.5.0
  18. PermissionDelegationDeprecated · from rippled 2.5.0
  19. fixAMMClawbackRoundingEnabled · from rippled 3.0.0
  20. SponsorOpen for voting · from xrpld 3.3.0
  21. PermissionDelegationV1_1Enabled · from xrpld 3.3.0
  22. fixCleanup3_3_0Enabled · from xrpld 3.3.0
  23. fixCleanup3_4_0Enabled · from xrpld 3.4.0
  24. MPTokensV2In development

Which primary sources support this information?

← All XRPL amendments and XLS specifications