ARCHIVE/rippled
1
0
Fork 0
mirror of https://github.com/XRPLF/rippled.git synced 2026-02-05 06:25:36 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
c121d3d720ea4d0be11a28457cfbdfa96fe0d4e8
rippled/API-VERSION-3.md
Mayukha Vadari 6d369e0f02 docs: Update API changelog, add APIv2+APIv3 version documentation (#6308) 
This change cleans up the `API-CHANGELOG.md` file. It moves the version-specific documentation to other files and fleshes out the changelog with all the API-related changes in each version.
2026-02-03 02:12:26 +00:00

1.9 KiB
Raw Blame History

API Version 3

API version 3 is currently a beta API. It requires enabling [beta_rpc_api] in the rippled configuration to use. To use this API, clients specify "api_version" : 3 in each request.

For info about how API versioning works, including examples, please view the XLS-22d spec. For details about the implementation of API versioning, view the implementation PR. API versioning ensures existing integrations and users continue to receive existing behavior, while those that request a higher API version will experience new behavior.

Breaking Changes

Modifications to amm_info

The order of error checks has been changed to provide more specific error messages. (#4924)

  • Before (API v2): When sending an invalid account or asset to amm_info while other parameters are not set as expected, the method returns a generic rpcINVALID_PARAMS error.
  • After (API v3): The same scenario returns a more specific error: rpcISSUE_MALFORMED for malformed assets or rpcACT_MALFORMED for malformed accounts.

Modifications to ledger_entry

Added support for string shortcuts to look up fixed-location ledger entries using the "index" parameter. (#5644)

In API version 3, the following string values can be used with the "index" parameter:

  • "index": "amendments" - Returns the Amendments ledger entry
  • "index": "fee" - Returns the FeeSettings ledger entry
  • "index": "nunl" - Returns the NegativeUNL ledger entry
  • "index": "hashes" - Returns the "short" LedgerHashes ledger entry (recent ledger hashes)

These shortcuts are only available in API version 3 and later. In API versions 1 and 2, these string values would result in an error.