Introducing XRP Ledger version 2.4.0

Version 2.4.0 of rippled, the reference server implementation of the XRP Ledger protocol, is now available. This release includes 8 new amendments, including Multi-Purpose Tokens (MPTs), Credentials, Clawback support for AMMs, and the ability to make offers as part of minting NFTs. Additionally, this release includes important fixes for stability, so server operators are encouraged to upgrade as soon as possible.

Additional Announcement

New UNL pub keys will be published on ...

Action Required

If you run an XRP Ledger server, upgrade to version 2.3.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.

Package	SHA-256
RPM for Red Hat / CentOS (x86-64)	`fb74f401e5ba121bbc37e6188aa064488ad78ffef549a1e19bc8b71316d08031`
DEB for Ubuntu / Debian (x86-64)	`5d616d53218b47a2f0803c1d37d410f72d19b57cdb9cabdf77b1cf0134cce3ca`
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 f64cf9187affd69650907d0d92e097eb29693945
Author: Elliot Lee <github.public@intelliot.com>
Date:   Mon Nov 25 12:27:17 2024 -0800

    Set version to 2.3.0

Full Changelog

Amendments

The following amendments are open for voting with this release:

XLS-46 DynamicNFT - Adds the ability to update the URI of NFToken objects. (#5048) TODO: doc update NFToken object
XLS-80 Permissioned Domains - Adds Permissioned Domains, which act as part of broader systems on the XRP Ledger to restrict access to satisfy compliance rules. (#5161) TODO: move docs from opensource
XLS-77 Deep Freeze - Adds the ability to deep freeze trust lines, enabling token issuers to block the transfer of assets for holders who have been deep frozen. (#5187) TODO: move docs from opensource
fixFrozenLPTokenTransfer - Prohibits the transfer of LP tokens when the associated liquidity pool contains at least one frozen asset. (#5227) TODO: upate docs

New Features

Added the ability to specify MPTs when defining assets in transactions. (#5200) TODO: doc new mpt_issuance_id field
Refactored LedgerEntry.cpp to make it easier to read. Also added a state alias for ripple_state in the ledger_entry API method. (#5199) TODO: doc update ledger_entry method
Improved UNL security by enabling validators to set a minimum number of UNL publishers to agree on validators. (#5112) TODO: doc UNL config
Added a new simulate API method to execute dry runs of transactions and see the simulated metadata. (#5069, #5265) TODO: doc new API method
Updated the XRPL Foundation UNL keys. (#5289)
Added support to filter ledger entry types by their canonical names in the ledger, ledger_data, and account_objects API methods. (#5271) TODO: doc updates for API methods
Added detailed logging for each validation and proposal received from the network. (#5291)
Improved git commit hash lookups when checking the version of a rippled debug build. Also added git commit hash info when using the server_info API method on an admin connection. (#5225) TODO: update server_info docs

Bug fixes

Fixed an issue with overlapping data types in the Expected class. (#5218)
Fixed an issue that prevented rippled from building on Windows with VS2022. (#5197)
Fixed server_definitions prefixes. (#5231)
Added missing dependency installations for generic MasOS runners. (#5233)
Updated deprecated Github actions. (#5241)
Fixed a failing assert scenario when submitting the connect admin RPC. (#5235)
Fixed the levelization script to ignore single-line comments during dependency analysis. (#5194)
Fixed the assert name used in PermissionedDomainDelete. (#5245)
Fixed MacOS unit tests. (#5196)
Fixed an issue with validators not accurately reflecting amendment votes. Also added debug logging of amendment votes. (#5173)
Fixed a potential issue with double-charging fees. (#5269)

Other Improvements

Added unit tests for AccountID handling. (#5174)
Added enforced levelization in libxrpl with CMake. (#5199)
Updated libxrpl and all submodules to use the same compiler options. (#5228)
Added Antithesis instrumentation. (#5042, #5213)
Added rpcName to the LEDGER_ENTRY macro to help prevent future bugs. (#5202)
Updated the contribution guidelines to introduce a new workflow that avoids code freezes. Also added scripts that can be used by maintainers in branch management, and a CI job to check that code is consistent across the three main branches: master, release, and develop. (#5215)
Added unit tests to check for caching issues fixed in rippled 2.3.0. (#5242)
Cleaned up the API changelog. (#5207)
Improved logs readability. (#5251)
Updated Visual Studio CI to VS 2022, and added VS Debug builds. (#5240)
Updated the secp256k1 library to version 0.6.0. (#5254)
Changed the [port_peer] parameter in rippled example config back to 51235; also added the recommendation to use the default port of 2459 for new deployments. (#5299)
Improved CI management. (#5268)
Updated the git commit message rules for contributors. (#5283)
Fixed unnecessary setCurrentThreadName calls. (#5280)
Added transaction flag checking for CredentialCreate, CredentialAccept, and CredentialDelete transactions. (#5250)
Added a check to prevent permissioned domains from being created in the event the Permissioned Domains amendement is enabled before the Credentials amendement. (#5275)
Updated Conan dependencies. (#5256)

Credits

The following people contributed directly to this release:

Ed Hennis ed@ripple.com
JoelKatz DavidJoelSchwartz@GMail.com
Sophia Xie 106177003+sophiax851@users.noreply.github.com
Valentin Balaschenko 13349202+vlntb@users.noreply.github.com

@rrmanukyan made their first contribution in #5233 @kuznetsss made their first contribution in #5252

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: bugs@xrpl.org

9.1 KiB Raw Blame History