A Bithomp JavaScript/TypeScript library for interacting with the XRP Ledger
npm install @bithomp/xrpl-apiA Bithomp JavaScript/TypeScript library for interacting with the XRP Ledger
Library designed to be a single point of access to the XRP Ledger. It uses multiple connections to the XRP Ledger and selects the best one for the request. If the connection is lost, the library will automatically reconnect.
The library also supports the creation of a validator list.
In an existing project (with package.json), install @bithomp/xrpl-api:
``Shell`install package
$ npm install --save @bithomp/xrpl-api
`JS
const BithompXRPL = require("@bithomp/xrpl-api");
// setup connection
const config = [
{
"url": "wss://xrplcluster.com",
"type": "regular,history,gateway_balances,last_close,manifest,payment,submit",
"connectionTimeout": 10000
},
{
"url": "wss://s1.ripple.com",
"type": "regular,history,payment,submit",
"connectionTimeout": 10000
},,
{
"url": "wss://s2.ripple.com",
"type": "regular,history,payment,submit",
"connectionTimeout": 10000
},
{
"url": "wss://s2-clio.ripple.com",
"type": "clio,account_objects",
"connectionTimeout": 10000
}
];
// Global setup for all connections, if you have multiple connections, like in example, the library will use them by type and(or) by better response time
BithompXRPL.Client.setup(config);
// connect to all servers
await BithompXRPL.Client.connect();
// send request
const accountInfo = await BithompXRPL.Client.getAccountInfo("rsuUjfWxrACCAwGQDsNeZUhpzXf1n1NK5Z");
// when complete, disconnect
BithompXRPL.Client.disconnect();
`
_Setup connection_, it is required to get validators details from the ledger.
`JS
const BithompXRPL = require("@bithomp/xrpl-api");
// setup connection
const config = [
{
// this connection will be used to get validators details from the ledger, use web socket with connection to network you are building list for (mainnet, testnet, devnet, etc.)
"url": "wss://xrplcluster.com",
"connectionTimeout": 10000
}
];
BithompXRPL.Client.setup(config);
// connect
await BithompXRPL.Client.connect();
// validator(master) secrets, should not belong to any validators keys.
// can be any ed25519 (publicKey starts on ED) or secp256k1 could be used,
// can ne generated with BithompXRPL.Validator.generateSecrets() or by generateSeed from ripple-keypairs
const vk = {
privateKey: "p__________________________",
publicKey: "ED________________________________",
};
// signing secrets, should not belong to any validators keys and should be different from vk.
// can be any ed25519 (publicKey starts on ED) or secp256k1 could be used,
// can ne generated with BithompXRPL.Validator.generateSecrets() or by generateSeed from ripple-keypairs
const sk = {
privateKey: "p__________________________",
publicKey: "ED_______________________________",
};
// validator list, public addresses, they have to be available on the ledger
// for accessing to manifest data (it will be stored in a blob),
// the address should start with n
const validators = ["nHB8QMKGt9VB4Vg71VszjBVQnDW3v3QudM4DwFaJfy96bj4Pv9fA"];
const sequence = 1; // sequence number
const expiration = 1696508603; // in unixtime (seconds)
const vl = await BithompXRPL.Client.createVL(vk, sk, sequence, expiration, validators);
// vl will contain the signed validator list with
// {
// "blob": "...",
// "manifest": "...", // signed with vk.privateKey and sk.privateKey
// "signature": "...", // signed with sk.privateKey
// "version": 1,
// "public_key": "..." // vk.publicKey
// }
// NOTE: to be able rippled to accept the validator list, you have to add validator(master) public key
// to [validator_list_keys] in rippled.cfg
// disconnect
BithompXRPL.Client.disconnect();
`
_Setup connection_, it is required to get validators details from the ledger.
`JS
const BithompXRPL = require("@bithomp/xrpl-api");
// setup connection
const config = [
{
// this connection will be used to get validators details from the ledger, use web socket with connection to network you are building list for (mainnet, testnet, devnet, etc.)
"url": "wss://xrplcluster.com",
"connectionTimeout": 10000
}
];
BithompXRPL.Client.setup(config);
// connect
await BithompXRPL.Client.connect();
// validator(master) secrets, should not belong to any validators keys.
// can be any ed25519 (publicKey starts on ED) or secp256k1 could be used,
// can ne generated with BithompXRPL.Validator.generateSecrets() or by generateSeed from ripple-keypairs
const vk = {
privateKey: "p__________________________",
publicKey: "ED________________________________",
};
// signing secrets, should not belong to any validators keys and should be different from vk.
// can be any ed25519 (publicKey starts on ED) or secp256k1 could be used,
// can ne generated with BithompXRPL.Validator.generateSecrets() or by generateSeed from ripple-keypairs
const sk = {
privateKey: "p__________________________",
publicKey: "ED_______________________________",
};
// validator list, public addresses, they have to be available on the ledger
// for accessing to manifest data (it will be stored in a blob),
// the address should start with n
const publishBlobCurrent = {
sequence: 1, // sequence number
expiration: 1696508603,
validatorsPublicKeys: ["nHUFE9prPXPrHcG3SkwP1UzAQbSphqyQkQK9ATXLZsfkezhhda3p"],
};
const publishBlobFuture = {
sequence: 2, // sequence number
effective: 1696508603, // optional in unixtime (seconds)
expiration: 1723620871, // in unixtime (seconds)
validatorsPublicKeys: ["nHB8QMKGt9VB4Vg71VszjBVQnDW3v3QudM4DwFaJfy96bj4Pv9fA"],
};
const vl = await BithompXRPL.Client.createVLv2(vk, sk, [publishBlob, publishBlobFuture]);
// vl will contain the signed validator list with
// {
// "blobs_v2": "...",
// "manifest": "...", // signed with vk.privateKey and sk.privateKey
// "version": 2,
// "public_key": "..." // vk.publicKey
// }
// NOTE: to be able rippled to accept the validator list, you have to add validator(master) public key
// to [validator_list_keys] in rippled.cfg
// disconnect
BithompXRPL.Client.disconnect();
`
`JS
const BithompXRPL = require("@bithomp/xrpl-api");
const nftokenID = "000861A8A7C507A12088BF6A6BB62BAFEE9CDAABA2961DB216E5DA9C00000001";
const decoded = BithompXRPL.Models.parseNFTokenID(nftokenID);
// decoded will contain
// {
// "NFTokenID: "000861A8A7C507A12088BF6A6BB62BAFEE9CDAABA2961DB216E5DA9C00000001",
// "Flags": 8,
// "TransferFee": 25000,
// "Issuer": "rGJn1uZxDX4ksxRPYuj2smP7ZshdwjeSTG",
// "NFTokenTaxon": 0,
// "Sequence": 1,
// }
`
`JS
const BithompXRPL = require("@bithomp/xrpl-api");
const flags = 11;
const transferFee = 3140;
const issuer = "rNCFjv8Ek5oDrNiMJ3pw6eLLFtMjZLJnf2";
const nftokenTaxon = 146999694;
const sequence = 3429;
// NOTE: This function is not minting NFTokenID, it is just encoding it from the data provided,
// can be used if you want to test something, check if the NFTokenID is valid, or predict the NFTokenID before minting
const result = BithompXRPL.Models.buildNFTokenID(flags, transferFee, issuer, nftokenTaxon, sequence);
// result will contain NFTokenID
// "000B0C4495F14B0E44F78A264E41713C64B5F89242540EE2BC8B858E00000D65"
``