Blog
/
2025
/
Introducing XRP Ledger version 2.5.0
Last updated
Publication date: 2025-06-24

Introducing XRP Ledger version 2.5.0

Version 2.5.0 of rippled, the reference server implementation of the XRP Ledger protocol, is now available. This release adds new features and bug fixes, and introduces these amendments:

  • TokenEscrow
  • Batch
  • PermissionedDEX
  • PermissionDelegation
  • AMMv1_3
  • EnforceNFTokenTrustlineV2
  • PayChanCancelAfter

Action Required

If you run an XRP Ledger server, upgrade to version 2.5.0 as soon as possible to ensure service continuity.

Additionally, new amendments are now open for voting according to the XRP Ledger's amendment process, which enables protocol changes following two weeks of >80% support from trusted validators. The exact time that protocol changes take effect depends on the voting decisions of the decentralized network.

Install / Upgrade

On supported platforms, see the instructions on installing or updating rippled.

PackageSHA-256
RPM for Red Hat / CentOS (x86-64)7719be1889619a37a83795a9740d803bbc1c08b0bd8c755cbf266aeb68b875b6
DEB for Ubuntu / Debian (x86-64)d935f678624349e422dff1944a40acaf3e287b11244b4f5b5056cb343fc31e9d
Portable Builds (Linux x86-64)(Use signature verification)

For other platforms, please build from source. The most recent commit in the git log should be the change setting the version:

commit 1e01cd34f7a216092ed779f291b43324c167167a
Author: Michael Legleux <[email protected]>
Date:   Tue Jun 17 10:38:07 2025 -0700

    Set version to 2.5.0

Warning
After this release, we will no longer support GCC versions older than 12, Clang (including Apple Clang) versions older than 16, or Conan 1.

Full Changelog

Amendments

The following amendments are open for voting with this release:

  • TokenEscrow (XLS-85) - Enhances escrow functionality by enabling escrows to interact with trustline-based tokens (IOUs) and multi-purpose tokens (MPTs). (#5185)
  • Batch (XLS-56) - Adds the ability to group multiple transactions and execute them atomically, improving efficiency and enabling complex multistep operations. (#5060)
  • PermissionedDEX (XLS-81) - Adds permissioned decentralized exchanges that control who can participate, ensuring compliance with financial regulations. (#5404)
  • PermissionDelegation (XLS-75) - Enables account holders to delegate specific permissions to other accounts for flexible account management and automation. (#5354)
  • AMMv1_3 - Adds invariant checking to AMM-related transactions. (#5203)
  • EnforceNFTokenTrustlineV2 - Fixes issues with NFT interactions bypassing the trustline authorization requirement. (#5297)
  • PayChanCancelAfter - Fixes an issue that made it possible to create a payment channel when CancelAfter is in the past. (#4717)

New Features

  • Increased network I/O capacity to handle higher transaction loads. (#5464)
  • Enhanced transaction relay logic. (#4985)
  • Added XRPL Commons as a new Bootstrap Cluster in the rippled configuration. (#5263)
  • Improved how the simulate method handles transactions submitted from a multi-signing account. Also fixed an issue that allowed transactions when both single-signed and multi-signed keys were provided. (#5479)
  • Updated code reviewers for RPC changes. (#5266)

Bug Fixes

  • Fixed pseudo-account ID calculation to ensure correct account address generation. (#5447)
  • Fixed a unity build error. (#5459)
  • Fixed initializer list initialization issues for GCC-15 compatibility. (#5443)
  • Resolved slow test performance issues on macOS pipeline. (#5392)
  • Replaced the custom endpoint selection logic with sequential attempts to connect to available endpoints until one succeeds or all fail. (#5365)
  • Fixed coverage file generation to ensure atomic generation. (#5426)
  • Renamed deadlock crash error to stall in the event of severe CPU starvation. (#5341)
  • Fixed an inaccurate error message in the ledger_entry RPC method when the account specified is not a string. (#5344)
  • Fixed a crash that could occur when handling an invalid marker parameter in a gRPC call. (#5317)
  • Fixed an issue with trust lines setting behavior around the lsfDefaultRipple flag. (#5345)
  • Removed undefined behavior from LogicError to guarantee a stacktrace. (#5338)
  • Updated links to the ripple binary codec definitions. (#5355)
  • Fixed the consensus logic to prevent a consensus round taking too long to complete. (#5277)
  • Fixed undefined uint128_t type on non-unity Windows builds. (#5377)
  • Fixed a uint128 issue that broke MacOS unity builds. (#5386)
  • Fixed a memory ordering assertion failure. (#5381)
  • Disabled channel_authorize when signing_support is disabled. (#5385)
  • Fixed a webhook issue when using the subscribe admin RPC. (#5163)
  • Fixed issues with CTID. (#4738)
  • Temporarily disabled unit tests on macOS to investigate delays. (#5397)
  • Fixed CTID to use the correct ledger_index. (#5408)
  • Updated CODEOWNERS path configuration. (#5440)
  • Removed unused code. (#5475)

Other Improvements

  • Enabled passive squelching for validators to accept squelch messages from untrusted validators, reducing duplicate traffic they generate. (#5358)
  • Improved squelching configuration. (#5438)
  • Updated CPP reference source. (#5453)
  • Added codecov badge and raised coverage thresholds. (#5428)
  • Refactored codebase to use east const convention for code consistency. (#5409)
  • Updated build instructions for Ubuntu 22.04+. (#5292)
  • Updated build instructions to improve build times. (#5288)
  • Updated example keyserver host in SECURITY.md. (#5460)
  • Implemented transitive_headers when building with Conan 2. (#5462)
  • Renamed documentation CI job for clarity. (#5398)
  • Clarified the lsfDefaultRipple comment for better code documentation. (#5410)
  • Cleaned up missing and unused headers. (#5293)
  • Refactored code to update numFeatures automatically. (#5324)
  • Improved ordering of headers with clang format. (#5343)
  • Updated Conan dependencies. (#5335)
  • Added PR numbers to the payload of libXRPL compatibility check workflows. (#5310)
  • Updated TxQ unit tests to work with variable reference fees. (#5118, #5145)
  • Optimized SHAMap smart pointers for efficient memory use and lock-free synchronization. (#5152)
  • Moved integration tests to another folder to make their purpose clear. (#5367)
  • Enabled compile time parameter to change the reference fee value. (#5159)
  • Cleaned up test logging messages to make it easier to search. (#5396)
  • Improved CI jobs to only run on PRs that have a DraftRunCI label. (#5400)
  • Updated validators-example.txt to fix XRPLF example URL configuration. (#5384)
  • Changed ledger close in env.meta to be conditionally on, making it easier to debug issues if you closed the ledger outside of the meta function. (#5457)
  • Collapsed log messages for easier readability. (#5347)

Credits

The following people contributed directly to this release:

Bug Bounties and Responsible Disclosures

We welcome reviews of the rippled code and urge researchers to responsibly disclose any issues they may find.

To report a bug, please send a detailed report to: [email protected]