Files
xrpl-dev-portal/content/references/http-websocket-apis/admin-api-methods/server-control-methods/ledger_accept.md
mDuo13 554a3732d4 Migrate content syntax via script
The changes in this commit were auto-generated by running

tool/migrate.sh

Following this commit, the Dactyl build no longer works but the Redocly
build (mostly) should.
2024-01-31 16:09:41 -08:00

2.0 KiB

html, parent, blurb, labels
html parent blurb labels
ledger_accept.html server-control-methods.html Close and advance the ledger in stand-alone mode.
Core Server

ledger_accept

[Source]

The ledger_accept method forces the server to close the current-working ledger and move to the next ledger number. This method is intended for testing purposes only, and is only available when the rippled server is running stand-alone mode.

The ledger_accept method is an admin method that cannot be run by unprivileged users!

Request Format

An example of the request format:

{% tabs %}

{% tab label="WebSocket" %}

{
   "id": "Accept my ledger!",
   "command": "ledger_accept"
}

{% /tab %}

{% tab label="Commandline" %}

#Syntax: ledger_accept
rippled ledger_accept

{% /tab %}

{% /tabs %}

The request accepts no parameters.

Response Format

An example of a successful response:

{
  "id": "Accept my ledger!",
  "status": "success",
  "type": "response",
  "result": {
    "ledger_current_index": 6643240
  }
}

The response follows the [standard format][], with a successful result containing the following field:

Field Type Description
ledger_current_index Unsigned Integer - [Ledger Index][] Ledger index of the newly created 'current' ledger

Note: When you close a ledger, rippled determines the canonical order of transactions in that ledger and replays them. This can change the outcome of transactions that were provisionally applied to the current ledger.

Possible Errors

  • Any of the [universal error types][].
  • notStandAlone - If the rippled server is not currently running in stand-alone mode.

{% raw-partial file="/_snippets/common-links.md" /%}