{"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":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/resources/known-amendments#lendingprotocolv1_1"},"children":["LendingProtocolV1_1 amendment"]}," updates the following ledger entries:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"vault","__idx":1},"children":["Vault"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"new-fields","__idx":2},"children":["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":"Name"},"children":["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":["LEVersion"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["UInt8"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Indicates what type of accounting the vault uses. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}," indicates the vault uses cash-basis accounting. If this field is ommitted, the vault uses whole-life accounting."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VaultKind"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["UInt8"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Indicates the kind of vault. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}," is a closed-ended vault. If this field is omitted, it's an open-ended vault."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubscriptionDate"]}]},{"$$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":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Closed-ended vaults only)"]}," The time, in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/data-types/basic-data-types#specifying-time"},"children":["seconds since the Ripple Epoch"]},", when the vault's subscription window closes and its investment period begins."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RedemptionDate"]}]},{"$$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":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Closed-ended vaults only)"]}," The time, in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/data-types/basic-data-types#specifying-time"},"children":["seconds since the Ripple Epoch"]},", when the vault's investment period ends and depositors can redeem their shares."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VaultKind"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubscriptionDate"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RedemptionDate"]}," are set using the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/transactions/types/vaultcreate"},"children":["VaultCreate transaction"]}," and can't be changed afterwards. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LEVersion"]}," is also set by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VaultCreate"]},", but the value is determined by if the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LendingProtocolV1_1"]}," amendment is enabled."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changed-fields","__idx":3},"children":["Changed 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":"Name"},"children":["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":["AssetsTotal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The total value of the vault. Calculated as: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["assets available + assets on loan"]},".",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Cash-basis vaults"]},": Potential interest from scheduled, unpaid loans ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["doesn't"]}," count toward the total."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Whole-life vaults"]},": Potential interest from scheduled, unpaid loans ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["does"]}," count toward the total."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LossUnrealized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The potential loss amount that is not yet realized, expressed as the vault's asset. Only a protocol connected to the vault can modify this attribute.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Cash-basis vaults"]},": Unrealized losses from interest ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["aren't"]}," included in this value."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Whole-life vaults"]},": Unrealized losses from interest ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["are"]}," included in this value."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-closed-ended-vault-json","__idx":4},"children":["Example Closed-Ended Vault JSON"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"LedgerEntryType\": \"Vault\",\n  \"Account\": \"rwCNM7SeUHTajEBQDiNqxDG8p1Mreizw85\",\n  \"Asset\": {\n      \"currency\": \"USD\",\n      \"issuer\": \"rXJSJiZMxaLuH3kQBUV5DLipnYtrE6iVb\"\n  },\n  \"AssetsAvailable\": \"0\",\n  \"AssetsMaximum\": \"1000000\",\n  \"AssetsTotal\": \"0\",\n  \"Data\": \"5661756C74206D65746164617461\",\n  \"Flags\": 0,\n  \"LEVersion\": 1,\n  \"LossUnrealized\": \"0\",\n  \"Owner\": \"rNGHoQwNG753zyfDrib4qDvvswbrtmV8Es\",\n  \"OwnerNode\": \"0\",\n  \"RedemptionDate\": 883008000,\n  \"Scale\": 6,\n  \"Sequence\": 200370,\n  \"ShareMPTID\": \"0000000169F415C9F1AB6796AB9224CE635818AFD74F8175\",\n  \"SubscriptionDate\": 851472000,\n  \"VaultKind\": 1,\n  \"WithdrawalPolicy\": 1\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"loanbroker","__idx":5},"children":["LoanBroker"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changed-fields-1","__idx":6},"children":["Changed 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":"Name"},"children":["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":["DebtTotal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The principal asset amount the protocol owes the vault."]}]}]}]}]}]},"headings":[{"value":"Updated Ledger Entries","id":"updated-ledger-entries","depth":1},{"value":"Vault","id":"vault","depth":2},{"value":"New Fields","id":"new-fields","depth":3},{"value":"Changed Fields","id":"changed-fields","depth":3},{"value":"Example Closed-Ended Vault JSON","id":"example-closed-ended-vault-json","depth":3},{"value":"LoanBroker","id":"loanbroker","depth":2},{"value":"Changed Fields","id":"changed-fields-1","depth":3}],"frontmatter":{"seo":{"title":"Updated Ledger Entries"}},"editPage":{"to":"https://github.com/ripple/opensource.ripple.com/tree/main/docs/lending-protocol-v1-1/updated-ledger-entries.md"},"lastModified":"2026-09-04T20:19:06.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/lending-protocol-v1-1/updated-ledger-entries","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}