A TypeScript/JavaScript API for interacting with the XRP Ledger in Node.js and the browser
npm install @ledhed2222/ripple-libA JavaScript/TypeScript library for interacting with the XRP Ledger
This is the recommended library for integrating a JavaScript/TypeScript app with the XRP Ledger, especially if you intend to use advanced functionality such as IOUs, payment paths, the decentralized exchange, account settings, payment channels, escrows, multi-signing, and more.
See the full reference documentation on the XRP Ledger Dev Portal.
What is xrpl.js used for? The applications on the list linked above use xrpl.js. Open a PR to add your app or project to the list!
+ Connect to a rippled server from Node.js or a web browser
+ Helpers for creating requests and parsing responses for the rippled API
+ Listen to events on the XRP Ledger (transactions, ledger, validations, etc.)
+ Sign and submit transactions to the XRP Ledger
+ Type definitions for TypeScript
+ Node.js v14 is recommended. Other versions may work but are not frequently tested.
+ npm is recommended. yarn may work but we use package-lock.json.
See also: RippleAPI Beginners Guide
In an existing project (with package.json), install xrpl.js:
``
$ npm install xrpl@beta
Then see the documentation.
If you want to use xrpl.js with React Native you will need to have some of the NodeJS modules available. To help with this you can use a module like rn-nodeify.
1. Install dependencies (you can use npm as well):
`shell`
npm install react-native-crypto
npm install xrpl@beta
# install peer deps
npm install react-native-randombytes
# install latest rn-nodeify
npm install rn-nodeify@latest --dev
2. After that, run the following command:
`shell`
# install node core shims and recursively hack package.json files
# in ./node_modules to add/update the "browser"/"react-native" field with relevant mappings
./node_modules/.bin/rn-nodeify --hack --install
3. Enable crypto:
rn-nodeify will create a shim.js file in the project root directory.
Open it and uncomment the line that requires the crypto module:
`javascript`
// If using the crypto shim, uncomment the following line to ensure
// crypto is loaded first, so it can populate global.crypto
require('crypto')
4. Import shim in your project (it must be the first line):
`javascript`
import './shim'
...
Until official support for Deno is added, you can use the following work-around to use xrpl.js with Deno:
`javascript
import xrpl from 'https://dev.jspm.io/npm:xrpl';
(async () => {
const api = new (xrpl as any).RippleAPI({ server: 'wss://s.altnet.rippletest.net:51233' });
const address = 'rH8NxV12EuV...khfJ5uw9kT';
api.connect().then(() => {
api.getBalances(address).then((balances: any) => {
console.log(JSON.stringify(balances, null, 2));
});
});
})();
`
+ RippleAPI Beginners Guide
+ RippleAPI Full Reference Documentation (in this repo)
+ Code Samples
We have a low-traffic mailing list for announcements of new xrpl.js releases. (About 1 email per week)
If you're using the XRP Ledger in production, you should run a rippled server and subscribe to the ripple-server mailing list as well.
To build the library for Node.js and the browser:
`
$ npm run build
The TypeScript compiler will output the resulting JS files in ./dist/npm/.
webpack will output the resulting JS files in ./build/.
For details, see the scripts in package.json.
1. Clone the repository
2. cd into the repository and install dependencies with npm install
3.
Run npm run lint to lint the code with eslint.
Update the documentation by running npm run docgen`.
+ xrpl-announce mailing list - subscribe for release announcements
+ RippleAPI Reference - XRP Ledger Dev Portal
+ XRP Ledger Dev Portal