mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-20 11:45:50 +00:00
For better URLs, the content folder has been renamed 'docs' and all other files have been moved up a level. Also, non-docs images have been moved to the static folder at the top level where they belong. Many relative paths had to be fixed to make this work.
26 lines
2.0 KiB
Markdown
26 lines
2.0 KiB
Markdown
---
|
|
html: rippled-server-states.html
|
|
parent: api-conventions.html
|
|
seo:
|
|
description: Definitions of state information reported in some API methods.
|
|
labels:
|
|
- Core Server
|
|
---
|
|
# rippled Server States
|
|
|
|
Depending on how the `rippled` server is configured, how long it has been running, and other factors, a server may be participating in the global XRP Ledger peer-to-peer network to different degrees. This is represented as the `server_state` field in the responses to the [server_info method][] and [server_state method][]. The possible responses follow a range of ascending interaction, with each later value superseding the previous one. Their definitions are as follows (in order of increasing priority):
|
|
|
|
| `Value` | Description |
|
|
|:---------------|:------------------------------------------------------------|
|
|
| `disconnected` | The server is not connected to the XRP Ledger peer-to-peer network whatsoever. It may be running in offline mode, or it may not be able to access the network for whatever reason. |
|
|
| `connected` | The server believes it is connected to the network. |
|
|
| `syncing` | The server is currently behind on ledger versions. (It is normal for a server to spend a few minutes catching up after you start it.) |
|
|
| `tracking` | The server is in agreement with the network |
|
|
| `full` | The server is fully caught-up with the network and could participate in validation, but is not doing so (possibly because it has not been configured as a validator). |
|
|
| `validating` | The server is currently participating in validation of the ledger |
|
|
| `proposing` | The server is participating in validation of the ledger and currently proposing its own version. |
|
|
|
|
**Note:** The distinction between `full`, `validating`, and `proposing` is based on synchronization with the rest of the global network, and it is normal for a server to fluctuate between these states as a course of general operation.
|
|
|
|
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|