LedgerStateFix

[Source]

LedgerStateFix is a general purpose transaction used to fix specific issues affecting the XRP ledger. You submit the transaction with the LedgerFixType value set to indicate the particular error state to correct.

(Added by the fixNFTokenPageLinks amendment)

Example LedgerStateFix JSON

{
   "Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
   "Fee" : "2000000",
   "LedgerFixType" : 1,
   "Owner" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
   "Sequence" : 2,
   "TransactionType" : "LedgerStateFix"
}

LedgerStateFix Fields

In addition to the common fields, LedgerStateFix transactions use the following fields:

LedgerFixType

LedgerStateFix transactions are targeted solutions for rare and specific issues. They can only be used to fix a specific type of ledger corruption, described below.

Type 1

Corrupt NFT directories resulting from these conditions:

• At least two NFToken pages were in the directory.
• The next-to-last page was completely full, holding 32 NFTokens.
• The last page of the directory contained only one NFToken.
• A transaction removed the last remaining token from the last page, causing the directory to delete the page.

When these conditions were met, the NFToken directory didn't properly update page links, causing holes in the directory when new last pages were created for additional NFTokens.

The fixNFTokenPageLinks amendment prevents new instances of this type of ledger corruption from happening.

Special Transaction Cost

The LedgerStateFix transaction is rare and potentially compute intensive, so the transaction must pay a special transaction cost equal to at least the owner reserve for one item (currently 0.2 XRP).

The transaction cost always applies when a transaction is included in a validated ledger, even if the transaction fails. (See Error Cases.) To greatly reduce the chances of paying the high transaction cost if the transaction fails, submit the transaction with fail_hard enabled.

Error Cases

Besides errors that can occur for all transactions, LedgerStateFix transactions can result in the following transaction result codes: