{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Updated Ledger Entries","siteUrl":"https://opensource.ripple.com/","meta":[{"name":"google-site-verification","content":"bLwyBi1imklcIuQxZ7JeI_kRF5Mg7yfr6arpEQV2nsE"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"updated-ledger-entries","__idx":0},"children":["Updated Ledger Entries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page describes changes to existing ledger entry types for Sponsored Fees and Reserves."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-ledger-entry-updates","__idx":1},"children":["Common Ledger Entry Updates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsor"]}," field is added to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/ledger-data/common-fields"},"children":["common ledger entry fields"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field Name"},"children":["Field Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"JSON Type"},"children":["JSON Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/binary-format/"},"children":["Internal Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required?"},"children":["Required?"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AccountID"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sponsor paying the owner reserve for this ledger object. When present, this indicates that the reserve burden for this object has shifted from the owner to the sponsor."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsor"]}," field may appear on the following ledger entry types:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AccountRoot"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Offer"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Escrow"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Check"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayChannel"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DepositPreauth"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ticket"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NFTokenPage"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NFTokenOffer"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AMM"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bridge"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XChainOwnedClaimID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XChainOwnedCreateAccountClaimID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any other ledger entry type that contributes to an account's owner reserve."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["NFTs are stored in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NFTokenPage"]}," objects, not as individual ledger entries. When sponsoring NFTs, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsor"]}," field applies to the entire ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NFTokenPage"]},", which can hold up to 32 NFTs. All NFTs within a sponsored page share the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["same"]}," sponsor."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accountroot-updates","__idx":2},"children":["AccountRoot Updates"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-json","__idx":3},"children":["Example JSON"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"LedgerEntryType\": \"AccountRoot\",\n  \"Account\": \"rfkDkFai4jUfCvAJiZ5Vm7XvvWjYvDqeYo\",\n  \"Balance\": \"100000000\", // 100 XRP in drops\n  \"OwnerCount\": 5,\n  \"Sponsor\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n  \"SponsoredOwnerCount\": 2,\n  \"SponsoringOwnerCount\": 1,\n  \"SponsoringAccountCount\": 1,\n  \"PreviousTxnID\": \"1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF\",\n  \"PreviousTxnLgrSeq\": 12345679\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"accountroot-fields","__idx":4},"children":["AccountRoot Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/ledger-data/ledger-entry-types/accountroot"},"children":["AccountRoot ledger entries"]}," can include the following new fields:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field Name"},"children":["Field Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"JSON Type"},"children":["JSON Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/binary-format/"},"children":["Internal Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required?"},"children":["Required?"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sponsor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AccountID"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sponsor paying the account reserve for this account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SponsoredOwnerCount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["UInt32"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The number of objects this account owns that are sponsored by another account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SponsoringOwnerCount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["UInt32"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The number of objects this account is sponsoring the reserve for."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SponsoringAccountCount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["UInt32"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The number of accounts this account is sponsoring the account reserve for."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ripplestate-updates","__idx":5},"children":["RippleState Updates"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-json-1","__idx":6},"children":["Example JSON"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"LedgerEntryType\": \"RippleState\",\n  \"Balance\": {\n    \"currency\": \"USD\",\n    \"issuer\": \"rLowAccountAddressXXXXXXXXXXXXXXX\",\n    \"value\": \"-10\"\n  },\n  \"HighLimit\": {\n    \"currency\": \"USD\",\n    \"issuer\": \"rHighAccountAddressXXXXXXXXXXXXXX\",\n    \"value\": \"100\"\n  },\n  \"LowLimit\": {\n    \"currency\": \"USD\",\n    \"issuer\": \"rLowAccountAddressXXXXXXXXXXXXXXX\",\n    \"value\": \"0\"\n  },\n  \"HighSponsor\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n  \"LowSponsor\": \"rN7n7otQDd6FczFgLdlqtyMVrn3HMfXpf\",\n  \"Flags\": 262144,\n  \"HighNode\": \"0000000000000000\",\n  \"LowNode\": \"0000000000000000\",\n  \"PreviousTxnID\": \"ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789\",\n  \"PreviousTxnLgrSeq\": 12345680\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ripplestate-fields","__idx":7},"children":["RippleState Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/ledger-data/ledger-entry-types/ripplestate"},"children":["RippleState ledger entries"]}," can include the following new fields:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field Name"},"children":["Field Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"JSON Type"},"children":["JSON Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/binary-format/"},"children":["Internal Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required?"},"children":["Required?"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HighSponsor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AccountID"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sponsor paying the reserve on behalf of the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["high account"]}," on the trust line."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LowSponsor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AccountID"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The sponsor paying the reserve on behalf of the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["low account"]}," on the trust line."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HighSponsor"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LowSponsor"]}," fields exist because bidirectional trust lines may have the reserve held by two accounts."]}]},"headings":[{"value":"Updated Ledger Entries","id":"updated-ledger-entries","depth":1},{"value":"Common Ledger Entry Updates","id":"common-ledger-entry-updates","depth":2},{"value":"AccountRoot Updates","id":"accountroot-updates","depth":2},{"value":"Example JSON","id":"example-json","depth":3},{"value":"AccountRoot Fields","id":"accountroot-fields","depth":3},{"value":"RippleState Updates","id":"ripplestate-updates","depth":2},{"value":"Example JSON","id":"example-json-1","depth":3},{"value":"RippleState Fields","id":"ripplestate-fields","depth":3}],"frontmatter":{"seo":{"title":"Updated Ledger Entries"}},"editPage":{"to":"https://github.com/ripple/opensource.ripple.com/tree/main/docs/xls-68-sponsored-fees-and-reserves/references/ledger-entries/updated-ledger-entries.md"},"lastModified":"2026-04-10T16:11:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/xls-68-sponsored-fees-and-reserves/references/ledger-entries/updated-ledger-entries","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}