xrpl-dev-portal/docs/references/http-websocket-apis/admin-api-methods/server-control-methods/ledger_accept.md

html, parent, seo, labels

html	parent	seo	labels
ledger_accept.html	server-control-methods.html	description 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

{% admonition type="info" name="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.{% /admonition %}

Possible Errors

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

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