01What
As an issuer, pulls your token back from a holder's account without their signature.
02Why you'd use it
Regulated issuers sometimes must recover assets — a court order, sanctions compliance, or tokens sent to a hacked account. Clawback is the legal-recovery tool, and it only exists if you enabled it before anyone held your token.
03How
- 1Confirm your issuer account set the asfAllowTrustLineClawback flag before any trust lines existed — otherwise this will never work.
- 2Enter the Holder Address the tokens are coming from.
- 3Enter the Currency Code and the Amount to Claw Back.
- 4Submit as the issuer and confirm tesSUCCESS.
Watch out
- The clawback flag must be enabled before your token has any trust lines, and it is permanent — decide at design time, not after launch.
- You can only claw back up to what the holder actually has; excess amounts just take everything available.
- Clawback works on your issued tokens only — no one can ever claw back XRP.
- Advertise the policy: holders deserve to know a token is clawback-enabled before they accept it.
For example
A court orders your company to recover 5,000 tokens from an account tied to a fraud case. Because you enabled clawback at launch, you retrieve them with one transaction and file the tx hash as evidence.