slp-light

slp-light is a lightweight library for creating a slp-token transaction. It has few exposed methods to make sure it is as easy as possible to create a token transaction, hiding all complexity from the user.

Installation

npm install slp-light

Examples

Fetching utxos

To fetch utxos use the method retrieveUtxos() which lets the user select the source of the utxos. Here is an example using public available apis from Bitcoin.com.

Using BitcoinComRetrieverImpl

import{Utxo}from'./src/Utxo';import{retrieveBchUtxos,retrieveSlpUtxos}from'./src/index';import{BitcoinComBchRetriever,BitcoinComSlpRetriever}from'./src/facade/bitcoincom/';letbch: Utxo[]=awaitretrieveBchUtxos({cashAddress: "bitcoincash:qzm4u38umtw6ak4was24r6ucerkzzxqr5s2328xm0r",wif: "WIF"},newBitcoinComBchRetriever());letslp: Utxo[]=awaitretrieveSlpUtxos({cashAddress: "bitcoincash:qzm4u38umtw6ak4was24r6ucerkzzxqr5s2328xm0r",wif: "WIF"},newBitcoinComSlpRetriever());

Using custom UtxoRetrieverFacade. When using a custom retriever make sure the source only allows valid slp-transactions. Since the library does not have its own validation it relies on the utxo source for validation.

import{retrieveBchUtxos,retrieveSlpUtxos}from'./src/index';import{Address,Utxo}from'./src/Utxo';import{BchUtxoRetrieverFacade}from'./src/facade/UtxoRetrieverFacade';constretriever: BchUtxoRetrieverFacade={getBchUtxosFromAddress(address: Address): Promise<Utxo[]>{// Custom utxo retriever code goes herereturnPromise.resolve([]);}}constutxos: Utxo[]=awaitretrieveBchUtxos({cashAddress: "bitcoincash:qzm4u38umtw6ak4was24r6ucerkzzxqr5s2328xm0r",wif: "WIF"},retriever);

Selecting utxos

import{selectUtxos}from'./src/index';import{SelectedUtxos}from'./src/index';importBigNumberfrom'bignumber.js';import{Utxo}from'./src/Utxo';constutxos: Utxo[]=[];constselectUtxo: SelectedUtxos=selectUtxos(newBigNumber("5"),"323437d4c86b00874c3b00cd454ab6ffb3226130fde09747009cf270caedddcf",utxos);

Creating transaction

import{createRawTx}from'./src/index';importBigNumberfrom'bignumber.js';import{SelectedUtxos}from'./src/utxo';constmySelectedUtxos: SelectedUtxos=null;constrawTx=createRawTx(newBigNumber("5"),"dcf128f7f836f369d339963685e91b105cf7982d8977d09f6a776329a6e290e7","bitcoincash:qrve2j5h2f8hy9hlptu7ejltzf4m7fwees60qss5f4","bitcoincash:qzm4u38umtw6ak4was24r6ucerkzzxqr5s2328xm0r",mySelectedUtxos);

Broadcast Transaction

You can either use one of the premade broadcasting facades implementing the interface or implement your own as shown below.

import{broadcastTransaction}from'./src/index';import{BroadcastFacade}from'./src/facade/BroadcastFacade';constbroadcastFacade: BroadcastFacade={broadcastTransaction(raw: string): Promise<string>{returnPromise.resolve('BROADCAST REQUEST GOES HERE');}}constrawTx=broadcastTransaction("TX_RAW",broadcastFacade);

Using simpleSend

If you just want to broadcast a transaction using Bitcoin.com apis then you can use the simpleSend() function from simple.ts. This method is an abstraction on top of the other methods for simplicity. If you want more control use the other methods in combination with each other.

import{simpleSend}from'./src/simple';importBigNumberfrom'bignumber.js';consttxId=awaitsimpleSend("Kzm1oz8sLSvuQLEgu99xixSkhNj7kyBZe6TpqTfdgKGhXUeSLSR","simpleledger:qp2mdqc4r8ylsrnu9f4j5xu8r47m722f6uyfsz4zr6","323437d4c86b00874c3b00cd454ab6ffb3226130fde09747009cf270caedddcf",newBigNumber(300));

Build & Test

Build

npm run build

Test

npm run test:npx

Authors

• Andreas Larsson - AndreasLarssons
• Jt Freeman - blockparty-sh