BitGo sdk-coin-xrp

SDK coins provide a modular approach to a monolithic architecture. This and all BitGoJS SDK coins allow developers to use only the coins needed for a given project.

Installation

All coins are loaded traditionally through the bitgo package. If you are using coins individually, you will be accessing the coin via the @bitgo/sdk-api package.

In your project install both @bitgo/sdk-api and @bitgo/sdk-coin-xrp.

npm i @bitgo/sdk-api @bitgo/sdk-coin-xrp

Next, you will be able to initialize an instance of "bitgo" through @bitgo/sdk-api instead of via bitgo.

import { BitGoAPI } from '@bitgo/sdk-api';
import { Xrp } from '@bitgo/sdk-coin-xrp';

const sdk = new BitGoAPI();

sdk.register('xrp', Xrp.createInstance);

Development

Most of the coin implementations are derived from @bitgo/sdk-core, @bitgo/statics, and coin specific packages. These implementations are used to interact with the BitGo API and BitGo platform services.

You will notice that the basic version of common class extensions have been provided to you and must be resolved before the package build will succeed. Upon initiation of a given SDK coin, you will need to verify that your coin has been included in the root tsconfig.packages.json and that the linting, formatting, and testing succeeds when run both within the coin and from the root of BitGoJS.

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

3.9.4 (2025-06-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.9.3 (2025-06-24)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.9.2 (2025-06-18)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.9.1 (2025-06-10)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.9.0 (2025-06-05)

Features

• root: support node 22 (c4ad6af)

3.8.0 (2025-06-02)

Features

• rename audit function naming and signature (1a885ab)

3.7.24 (2025-05-28)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.23 (2025-05-22)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.22 (2025-05-20)

Bug Fixes

• support memoid along with address for send transaction (6b6d25a)

3.7.21 (2025-05-07)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.20 (2025-04-29)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.19 (2025-04-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.18 (2025-04-15)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.17 (2025-04-04)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.16 (2025-04-02)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.15 (2025-03-28)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.14 (2025-03-20)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.13 (2025-03-18)

Bug Fixes

• sdk-core: set default multisig if empty (e2727df)

3.7.12 (2025-03-06)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.11 (2025-03-04)

Bug Fixes

• dependency fixes for secp256 lib (826db0b)

3.7.10 (2025-02-26)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.9 (2025-02-20)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.8 (2025-02-19)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.7 (2025-02-11)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.6 (2025-02-05)

Bug Fixes

• update xrpToken decimals (3c5cc96)

3.7.5 (2025-01-28)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.4 (2025-01-23)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.3 (2025-01-23)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.2 (2025-01-20)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.1 (2025-01-15)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.7.0 (2025-01-09)

Bug Fixes

• mock bitgo.post for "verifyAddress should work" test (eaa62ae)

Features

• destination tag validation in xrp isWalletAddress (436e08b)

3.6.10 (2025-01-03)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.9 (2024-12-24)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.8 (2024-12-19)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.7 (2024-12-17)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.6 (2024-12-17)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.5 (2024-12-12)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.4 (2024-12-11)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.3 (2024-12-03)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.2 (2024-11-26)

Bug Fixes

• sdk-coin-xrp: support recovery using issuer address and currency code (0123e85)

3.6.1 (2024-11-21)

Note: Version bump only for package @bitgo/sdk-coin-xrp

3.6.0 (2024-11-19)

Bug Fixes

• sdk-coin-xrp: verifyTransaction for token transfers (234a98d)

Features

• sdk-coin-xrp: add wrw support cold wallet xrpl token (095c408)

3.5.1 (2024-11-14)

Bug Fixes

• sdk-coin-xrp: verifyTransaction for token transfers (234a98d)

3.5.0 (2024-11-08)

Features

• sdk-coin-xrp: add support for token enablement (8972a6e)

3.4.0 (2024-11-07)

Features

• sdk-coin-xrp: add non-bitgo recovery for xrpl token (ef10edd)

3.3.0 (2024-11-01)

Features

• sdk-coin-xrp: add tokenTransferBuilder (ce6e142)
• sdk-coin-xrp: add trustsetBuilder (9c23193)

3.2.0 (2024-10-22)

Features

• sdk-coin-xrp: add transaction builder (392222b)

3.1.0 (2024-10-15)

Bug Fixes

• sdk-coin-xrp: fix xrp signing bug (a845372), closes #4990

Features

• statics: add xrp rlusd token (e3ba9f0)

3.0.0 (2024-10-08)

Build System

• sdk-coin-xrp: update ripple libs (be7b887)

Features

• sdk-coin-xrp: add Utils & KeyPair (e92eec5)
• sdk-coin-xrp: add xrpToken skeleton (441ec50)

BREAKING CHANGES

• sdk-coin-xrp: Move following functions from XRP to Utils,

• getAddressDetails

• normalizeAddress

• sdk-coin-xrp: explainTransaction for XRP transactions now computes a different transaction hash than previous versions. This is because xrpl 2.x uses different hash prefixes for computing signed and unsigned transaction hashes

Ticket: WIN-3541

2.1.20 (2024-10-04)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.19 (2024-09-24)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.18 (2024-09-19)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.17 (2024-09-16)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.16 (2024-09-10)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.15 (2024-09-03)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.14 (2024-08-29)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.13 (2024-08-27)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.12 (2024-08-20)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.11 (2024-08-13)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.10 (2024-08-07)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.9 (2024-07-30)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.8 (2024-07-24)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.7 (2024-07-16)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.6 (2024-07-04)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.5 (2024-07-02)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.4 (2024-06-27)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.3 (2024-06-26)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.2 (2024-06-21)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.1 (2024-06-20)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.1.0 (2024-06-14)

Bug Fixes

• sdk-coin-xrp: better error handling (dcf7de4)

Features

• sdk-coin-xrp: removing padding from recovery (ec58694)

2.0.18 (2024-06-11)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.17 (2024-06-05)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.16 (2024-05-31)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.15 (2024-05-28)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.14 (2024-05-22)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.13 (2024-05-17)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.12 (2024-05-13)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.11 (2024-05-08)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.10 (2024-05-01)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.9 (2024-04-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.8 (2024-04-24)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.7 (2024-04-22)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.6 (2024-04-17)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.5 (2024-04-12)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.4 (2024-04-10)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.3 (2024-04-09)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.2 (2024-04-08)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.1 (2024-04-05)

Note: Version bump only for package @bitgo/sdk-coin-xrp

2.0.0 (2024-03-28)

Features

• root: deprecate node 16 (d3ec624)

BREAKING CHANGES

• root: Node 16 is no longer supported in bitgojs. TICKET: WP-1100

1.8.5 (2024-03-19)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.8.4 (2024-03-11)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.8.3 (2024-02-28)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.8.2 (2024-02-22)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.8.1 (2024-02-19)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.30 (2024-01-30)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.29 (2024-01-26)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.28 (2024-01-26)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.27 (2024-01-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.26 (2024-01-22)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.25 (2024-01-09)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.24 (2024-01-03)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.23 (2023-12-18)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.22 (2023-12-12)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.21 (2023-12-09)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.20 (2023-12-05)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.19 (2023-11-28)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.18 (2023-11-24)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.17 (2023-11-17)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.16 (2023-11-13)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.15 (2023-11-13)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.14 (2023-11-13)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.13 (2023-10-20)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.12 (2023-10-18)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.11 (2023-09-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.10 (2023-09-09)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.9 (2023-09-09)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.8 (2023-09-07)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.7 (2023-09-05)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.6 (2023-09-01)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.5 (2023-08-29)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.4 (2023-08-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.3 (2023-08-24)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.2 (2023-08-16)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.1 (2023-08-16)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.7.0 (2023-08-04)

Features

• root: add node 18 to engines and CI (9cc6a70)
• root: remove node 14 from engines (6ec47cb)

1.6.0 (2023-07-28)

Features

• root: add node 18 to engines and CI (9cc6a70)
• root: remove node 14 from engines (6ec47cb)

1.5.7 (2023-07-18)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.5.6 (2023-06-21)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.5.5 (2023-06-14)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.5.4 (2023-06-13)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.5.3 (2023-06-07)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.5.2 (2023-06-05)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.5.1 (2023-05-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.5.0 (2023-05-17)

Features

• sdk-coin-xrp: add backup signing for xrp (3f2ff78)

1.4.2 (2023-05-10)

Bug Fixes

• sdk-coin-xrp: add coin field to xrp unsigned transaction (24ef876)

1.4.1 (2023-05-03)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.4.0 (2023-04-25)

Features

• sdk-coin-xrp: change xrp unsigned sweep recovery to return json body (936846f)

1.3.17 (2023-04-20)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.16 (2023-04-13)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.15 (2023-02-17)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.14 (2023-02-16)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.13 (2023-02-08)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.12 (2023-01-30)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.11 (2023-01-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.10 (2022-12-23)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.9 (2022-12-20)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.8 (2022-12-09)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.7 (2022-12-06)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.6 (2022-12-01)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.5 (2022-11-29)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.4 (2022-11-04)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.2 (2022-10-27)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.1 (2022-10-25)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.3.0 (2022-10-18)

Bug Fixes

• core: fix bip32/ecpair, API vs Interface (bec9c1e)

1.1.0 (2022-07-19)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.23 (2022-07-19)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.22 (2022-07-18)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.21 (2022-07-15)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.20 (2022-07-15)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.19 (2022-07-14)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.18 (2022-07-12)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.17 (2022-07-11)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.16 (2022-07-07)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.15 (2022-07-05)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.14 (2022-07-01)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.13 (2022-06-30)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.12 (2022-06-30)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.11 (2022-06-29)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.10 (2022-06-29)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.9 (2022-06-27)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.8 (2022-06-23)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.7 (2022-06-22)

Bug Fixes

• add dependency check to fix current and future dependency resolutions (3074335)

1.1.0-rc.6 (2022-06-21)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.5 (2022-06-16)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.4 (2022-06-15)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.3 (2022-06-14)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.2 (2022-06-14)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.1 (2022-06-13)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.1.0-rc.0 (2022-06-10)

Features

• move coinFactory from bitgo to sdk-core (fb7e902)

1.0.1-rc.3 (2022-06-07)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.0.1-rc.2 (2022-06-07)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.0.1-rc.1 (2022-06-02)

Note: Version bump only for package @bitgo/sdk-coin-xrp

1.0.1-rc.0 (2022-06-02)

Note: Version bump only for package @bitgo/sdk-coin-xrp