@coolwallet/xrp
TypeScript icon, indicating that this package has built-in type declarations

1.1.3 • Public • Published

CoolWallet Ripple (XRP) SDK

Version

Typescript library with support for the integration of Ripple for third party application, include the functionalities of generation of addresses and signed transactions.

Install

npm i @coolwallet/xrp

Usage

import XRP from '@coolwallet/xrp'
const xrp = new XRP();

const address = await xrp.getAddress(transport, appPrivateKey, appId, 0);
// rEoA7FTruU4SMdG99yuuUbUPxp1bh9aZjR

const payment = {
  Sequence: 1566719,
  DestinationTag: 1882298635,
  LastLedgerSequence: 47914574,
  Amount: "100000", // in drops
  Fee: "1000",      // in drops
  SigningPubKey: "027f033c29de4bc02096492da93e00d55d2851f74dc0b5ab58c9b83b3e8067b4af",  // optional
  Account: "rEoA7FTruU4SMdG99yuuUbUPxp1bh9aZjR",  // optional
  Destination: "rp6ENYKqYfT5qJqQiN2Y9AnZmFEWv9hRpq"
}

const signTxData = {
    transport,
    appPrivateKey,
    appId,
    payment,
    addressIndex
}

const transaction = await xrp.signTransaction(signTxData)

You might already know the public key of the source account (by calling .getPublicKey() before ). if that's the case, put it in the Payment object as SigningPubKey. Otherwise we would need another bluetooth command to derive the key again.

Methods

getAddress

Description

Get address by address index.

The XRP address generated is compatible to BIP44 with account and change set to 0, which means calling getAddress with addressIndex = i will get the address of folllowing path:

m/44'/144'/0'/0/{i}

In the design of current hardware, we only support path m/44'/144'/0'/0/{i} for speed optimization. This might change in the future and we will then open a more general interface to deal with custom path.

async getAddress(
    transport: Transport, 
    appPrivateKey: string, 
    appId: string, 
    addressIndex: number
    ): Promise<string> 

Arguments

Arg Description Type Required
transport Object to communicate with CoolWallet device Transport TRUE
appPrivateKey Private key for the connected application string TRUE
appId ID for the connected application string TRUE
addressIndex The from address index in BIP44 derivation number TRUE

signTransaction

Description

Sign Ripple Transaction.

async signTransaction(signTxData: signTxType):Promise<string>

signTxType Arguments

Arg Description Type Required
transport Object to communicate with CoolWallet device Transport TRUE
appPrivateKey Private key for the connected application string TRUE
appId ID for the connected application string TRUE
payment Essential information/property for XRP Transaction Payment TRUE
addressIndex The from address index in BIP44 derivation number TRUE
confirmCB Callback of confirmation data to the connected application Function FALSE
authorizedCB Callback of authorized transaction data to the connected application Function FALSE

Package Sidebar

Install

npm i @coolwallet/xrp

Weekly Downloads

2

Version

1.1.3

License

ISC

Unpacked Size

62 kB

Total Files

28

Last publish

Collaborators

  • coolwallet-team