Files
rippled/.github/scripts/rename
Pratik Mankawde 21dad9a17d docs(telemetry): sync runbook, dashboards, and configs with code
- Add 14 missing spans to runbook (6 TxQ + 8 consensus)
- Fix tx.receive attributes and config table in runbook
- Document dispute.resolve and tx.included span events
- Add spanmetrics dimensions for close_time_correct and tx.suppressed
- Fix Close Time Agreement and TX Receive vs Suppressed panel PromQL
- Wire $consensus_mode template variable to all consensus panels
- Add 10 Tempo search filters for operational attributes
- Apply rename script artifacts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-29 12:29:53 +01:00
..

Renaming ripple(d) to xrpl(d)

In the initial phases of development of the XRPL, the open source codebase was called "xrpld" and it remains with that name even today. Today, over 1000 nodes run the application, and code contributions have been submitted by developers located around the world. The XRPL community is larger than ever. In light of the decentralized and diversified nature of XRPL, we will rename any references to ripple and xrpld to xrpl and xrpld, when appropriate.

See here for more information.

Scripts

To facilitate this transition, there will be multiple scripts that developers can run on their own PRs and forks to minimize conflicts. Each script should be run from the repository root.

  1. .github/scripts/rename/definitions.sh: This script will rename all definitions, such as include guards, from RIPPLE_XXX and RIPPLED_XXX to XRPL_XXX.
  2. .github/scripts/rename/copyright.sh: This script will remove superfluous copyright notices.
  3. .github/scripts/rename/cmake.sh: This script will rename all CMake files from RippleXXX.cmake or XrpldXXX.cmake to XrplXXX.cmake, and any references to ripple and xrpld (with or without capital letters) to xrpl and xrpld, respectively. The name of the binary will remain as-is, and will only be renamed to xrpld by a later script.
  4. .github/scripts/rename/binary.sh: This script will rename the binary from xrpld to xrpld, and reverses the symlink so that xrpld points to the xrpld binary.
  5. .github/scripts/rename/namespace.sh: This script will rename the C++ namespaces from ripple to xrpl.
  6. .github/scripts/rename/config.sh: This script will rename the config from xrpld.cfg to xrpld.cfg, and updating the code accordingly. The old filename will still be accepted.
  7. .github/scripts/rename/docs.sh: This script will rename any lingering references of ripple(d) to xrpl(d) in code, comments, and documentation.

You can run all these scripts from the repository root as follows:

./.github/scripts/rename/definitions.sh .
./.github/scripts/rename/copyright.sh .
./.github/scripts/rename/cmake.sh .
./.github/scripts/rename/binary.sh .
./.github/scripts/rename/namespace.sh .
./.github/scripts/rename/config.sh .
./.github/scripts/rename/docs.sh .