{"templateId":"markdown","versions":[{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/operations-and-maintenance/troubleshooting/common-errors","default":true,"active":true,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/operations-and-maintenance/troubleshooting/common-errors","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/operations-and-maintenance/troubleshooting/common-errors","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/operations-and-maintenance/troubleshooting/common-errors","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/operations-and-maintenance/troubleshooting/common-errors","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/operations-and-maintenance/troubleshooting/common-errors","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Error management","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","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":"error-management","__idx":0},"children":["Error management"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a transaction is prepared in the ","Ripple Custody"," UI, the system automatically executes a dry-run of the operation. As a result, if an anomaly impacts the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/overview/security/data-integrity-and-audit-trail#trusted-vs-untrusted-components"},"children":["indexers"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/overview/security/data-integrity-and-audit-trail#trusted-vs-untrusted-components"},"children":["(blockchain) nodes"]},", you may encounter errors."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple can't prevent these types of errors because they usually happen when you make updates to a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/overview/security/data-integrity-and-audit-trail#trusted-vs-untrusted-components"},"children":["component"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table gives you an overview of these errors, their root causes, and consequences. However, this list isn't exhaustive and doesn't list all possible errors."]},{"$$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":{"data-label":"Error message"},"children":["Error message"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Possible  root cause"},"children":["Possible",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"root cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Consequence"},"children":["Consequence"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payload has validation issues preventing the execution of the dry-run, refer to the errors list for more details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The indexer isn't available."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/overview/security/data-integrity-and-audit-trail#trusted-vs-untrusted-components"},"children":["ledger accounting service"]}," isn't available."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can't broadcast a transaction because the system can neither prepare nor detect transactions. The accounts' balance may differ from the on-chain balance."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tracker identification failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The indexer is unable to establish a connection to the node."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can't broadcast a transaction because of the missing connection between the indexer and the node; no accounting operation (such as transactions, balances, address generation) will be performed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tracker not in sync"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The indexer was unavailable for a period of time."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can still broadcast a transaction, but a delay in the detection of both inbound and outbound transactions, which impacts the accounts' balance, is expected."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tracker not in sync"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The node was unavailable for a period of time."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Depending on the ledger, you can still broadcast a transaction, but a delay in the detection of both inbound and outbound transactions, which impacts the accounts' balance, is expected."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Tip"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you run into an error where the indexer and node are out of sync, Ripple recommends that you don't broadcast a transaction. However, if you must make an urgent transaction, make sure you manually verify the transaction."]}]}]},"headings":[{"value":"Error management","id":"error-management","depth":1}],"frontmatter":{"seo":{"title":"Error management"}},"lastModified":"2026-08-04T20:25:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/operations-and-maintenance/troubleshooting/common-errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}