AccountDelete

[Source]

Requires the DeletableAccounts amendment

An AccountDelete transaction deletes an account and any objects it owns in the XRP Ledger, if possible, sending the account's remaining XRP to a specified destination account. See Deletion of Accounts for the requirements to delete an account.

Example AccountDelete JSON

{
    "TransactionType": "AccountDelete",
    "Account": "rWYkbWkCeg8dP6rXALnjgZSjjLyih5NXm",
    "Destination": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
    "DestinationTag": 13,
    "Fee": "5000000",
    "Sequence": 2470665,
    "Flags": 2147483648
}

AccountDelete Fields

In addition to the common fields, a AccountDelete transaction uses the following fields:

Field JSON Type Internal Type Description
Destination String - Address Account The address of an account to receive any leftover XRP after deleting the sending account. Must be a funded account in the ledger, and must not be the sending account.
DestinationTag Number UInt32 (Optional) Arbitrary destination tag that identifies a hosted recipient or other information for the recipient of the deleted account's leftover XRP.

Error Cases

In addition to errors that can occur for all transactions, AccountDelete transactions can result in the following transaction result codes:

Error Code Description
temDISABLED Occurs if the DeletableAccounts amendment is not enabled.
temDST_IS_SRC Occurs if the Destination matches the sender of the transaction (Account field).
tecDST_TAG_NEEDED Occurs if the Destination account requires a destination tag, but the DestinationTag field was not provided.
tecNO_DST Occurs if the Destination account is not a funded account in the ledger.
tecNO_PERMISSION Occurs if the Destination account requires deposit authorization and the sender is not preauthorized.
tecTOO_SOON Occurs if the sender's Sequence number is too high. The transaction's Sequence number plus 256 must be less than the current Ledger Index.
tecHAS_OBLIGATIONS Occurs if the account to be deleted is connected to objects that cannot be deleted in the ledger. (This includes objects created by other accounts, such as escrows.)
tefTOO_BIG Occurs if the sending account is linked to more than 1000 objects in the ledger. The transaction could succeed on retry if some of those objects were deleted separately first.