Admin rippled Methods

Communicate directly with a rippled server using these admin API methods. Admin methods are meant only for trusted personnel in charge of keeping the server operational. Admin methods include commands for managing, monitoring, and debugging the server.

Admin commands are available only if you connect to rippled on a host and port that the rippled.cfg file identifies as admin. By default, the commandline client uses an admin connection. For more information on connecting to rippled, see Getting Started with the rippled API.

Key Generation Methods

Use these methods to generate and manage keys.

Logging and Data Management Methods

Use these methods to manage log levels and other data, such as ledgers.

  • can_delete - Allow online deletion of ledgers up to a specific ledger.
  • download_shard - Download a specific shard of ledger history.
  • ledger_cleaner - Configure the ledger cleaner service to check for corrupted data.
  • ledger_request - Query a peer server for a specific ledger version.
  • log_level - Get or modify log verbosity.
  • logrotate - Reopen the log file.

Server Control Methods

Use these methods to manage the rippled server.

  • connect - Force the rippled server to connect to a specific peer.
  • ledger_accept - Close and advance the ledger in stand-alone mode.
  • stop - Shut down the rippled server.
  • validation_seed - Temporarily set key to be used for validating.

Status and Debugging Methods

Use these methods to check the status of the network and server.

  • consensus_info - Get information about the state of consensus as it happens.
  • feature - Get information about protocol amendments.
  • fetch_info - Get information about the server's sync with the network.
  • get_counts - Get statistics about the server's internals and memory usage.
  • peers - Get information about the peer servers connected.
  • print - Get information about internal subsystems.
  • validators - Get information about the current validators.
  • validator_list_sites - Get information about sites that publish validator lists.

Deprecated Methods

The following admin commands are deprecated and may be removed without further notice:

  • ledger_header - Use the ledger method instead.
  • unl_add, unl_delete, unl_list, unl_load, unl_network, unl_reset, unl_score - Use the validators.txt config file for UNL management instead.
  • wallet_seed - Use the wallet_propose method instead.