XRP Tokens

Instantiate Cryptum SDK first:

const sdk = new CryptumSdk({
  environment: 'testnet',
  apiKey: 'YOUR-API-KEY'
})

Transfer tokens

Transfer tokens in XRPL blockchain.

sdk.token.transfer(opts)

  • opts.protocol (string)(required) - blockchain protocol must be RIPPLE.

  • opts.wallet (Wallet)(required) - wallet to sign the transaction with.

  • opts.token (string)(required) - token symbol to transfer or XRP if you're transferring the native token.

  • opts.issuer (string)(optional) - token issuer account. Required only if you're not transferring the native token.

  • opts.amount (string)(required) - token amount to be transferred.

  • opts.destination (string)(required) - destination address.

  • opts.memo (string)(optional) - memo string.

This function returns the transaction hash.

const { hash } = await sdk.token.transfer({
  protocol: 'RIPPLE',
  wallet,
  token: 'FOO',
  issuer: 'rPT1Sjq2YGr...jKu9dyfzbpAYe'
  destination: 'rmpvgigZ4p...sbK8pyV45WtP',
  amount: '7.5',
  memo: ''
})

Establish trustline in Ripple

sdk.token.setTrustline(opts)

Create a trustline transaction in XRPL blockchain. It is used to create or delete tokens (trustline).

  • opts.protocol (Wallet)(required) - blockchain protocol must be RIPPLE.

  • opts.wallet (Wallet)(required) - wallet to sign the transaction with.

  • opts.symbol (string)(required) - asset to transfer.

  • opts.issuer (string) - required if you are transferring a custom asset so this is the issuer account, otherwise leave undefined.

  • opts.limit (string)(required) - limit for the trustline. To create the trustline this limit should be bigger than 0 and to delete the trustline it should be 0.

  • opts.memo (string)(optional) - message to be attached with this transaction, otherwise leave it undefined.

This function returns the hash of the transaction.

Example:

// Ripple
const { hash } = await sdk.token.setTrustline({
  protocol: 'RIPPLE',
  wallet,
  symbol: 'FOO',
  issuer: 'rPT1Sjq2YGr...jKu9dyfzbpAYe',
  limit: '100000000',
  memo: 'create-trustline',
})

Last updated