# SLPJS

// Install BITBOX-SDK v8.1+ for blockchain access // For more information visit: https://www.npmjs.com/package/bitbox-sdk const BITBOXSDK = require('bitbox-sdk') const slpjs = require('slpjs'); // FOR MAINNET UNCOMMENT let addr = "simpleledger:qrhvcy5xlegs858fjqf8ssl6a4f7wpstaqnt0wauwu"; const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://rest.bitcoin.com/v2/' }); // FOR TESTNET UNCOMMENT // let addr = "slptest:qpwyc9jnwckntlpuslg7ncmhe2n423304ueqcyw80l"; // const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://trest.bitcoin.com/v2/' }); const bitboxNetwork = new slpjs.BitboxNetwork(BITBOX); let balances; (async function() { balances = await bitboxNetwork.getAllSlpBalancesAndUtxos(addr); console.log("balances: ", balances); })(); 

{ satoshis_available_bch: 190889, satoshis_locked_in_slp_baton: 546, satoshis_locked_in_slp_token: 1092, satoshis_in_invalid_token_dag: 0, satoshis_in_invalid_baton_dag: 0, slpTokenBalances: { '1cda254d0a995c713b7955298ed246822bee487458cd9747a91d9e81d9d28125': BigNumber { s: 1, e: 3, c: [ 1000 ] }, '047918c612e94cce03876f1ad2bd6c9da43b586026811d9b0d02c3c3e910f972': BigNumber { s: 1, e: 2, c: [ 100 ] } }, nftParentChildBalances: { 'parentId1': { 'childId1': BigNumber 'childId2': BigNumber }, 'parentId2': { 'childId1': BigNumber 'childId2': BigNumber } }, slpTokenUtxos: [ ... ], slpBatonUtxos: [ ... ], invalidTokenUtxos: [ ... ], invalidBatonUtxos: [ ... ], nonSlpUtxos: [ ... ], unknownTokenTypeUtxos: [ ... ] } 

// Install BITBOX-SDK v8.1+ for blockchain access // For more information visit: https://www.npmjs.com/package/bitbox-sdk const BITBOXSDK = require('bitbox-sdk') const BigNumber = require('bignumber.js'); const slpjs = require('slpjs'); // FOR MAINNET UNCOMMENT const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://rest.bitcoin.com/v2/' }); const fundingAddress = "simpleledger:qrhvcy5xlegs858fjqf8ssl6a4f7wpstaqnt0wauwu"; // <-- must be simpleledger format const fundingWif = "L3gngkDg1HW5P9v5GdWWiCi3DWwvw5XnzjSPwNwVPN5DSck3AaiF"; // <-- compressed WIF format const tokenReceiverAddress = "simpleledger:qrhvcy5xlegs858fjqf8ssl6a4f7wpstaqnt0wauwu"; // <-- must be simpleledger format const bchChangeReceiverAddress = "simpleledger:qrhvcy5xlegs858fjqf8ssl6a4f7wpstaqnt0wauwu"; // <-- cashAddr or slpAddr format // For unlimited issuance provide a "batonReceiverAddress" const batonReceiverAddress = "simpleledger:qrhvcy5xlegs858fjqf8ssl6a4f7wpstaqnt0wauwu"; // FOR TESTNET UNCOMMENT // const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://trest.bitcoin.com/v2/' }); // const fundingAddress = "slptest:qpwyc9jnwckntlpuslg7ncmhe2n423304ueqcyw80l"; // const fundingWif = "cVjzvdHGfQDtBEq7oddDRcpzpYuvNtPbWdi8tKQLcZae65G4zGgy"; // const tokenReceiverAddress = "slptest:qpwyc9jnwckntlpuslg7ncmhe2n423304ueqcyw80l"; // const bchChangeReceiverAddress = "slptest:qpwyc9jnwckntlpuslg7ncmhe2n423304ueqcyw80l"; // // For unlimited issuance provide a "batonReceiverAddress" // const batonReceiverAddress = "slptest:qpwyc9jnwckntlpuslg7ncmhe2n423304ueqcyw80l"; const bitboxNetwork = new slpjs.BitboxNetwork(BITBOX); // 1) Get all balances at the funding address. let balances; (async function() { balances = await bitboxNetwork.getAllSlpBalancesAndUtxos(fundingAddress); console.log("'balances' variable is set."); console.log('BCH balance:', balances.satoshis_available_bch); })(); // WAIT FOR NETWORK RESPONSE... // 2) Select decimal precision for this new token let decimals = 2; let name = "Awesome SLPJS README Token"; let ticker = "SLPJS"; let documentUri = "[email protected]"; let documentHash = null let initialTokenQty = 1000000 // 3) Calculate the token quantity with decimal precision included initialTokenQty = (new BigNumber(initialTokenQty)).times(10**decimals); // 4) Set private keys balances.nonSlpUtxos.forEach(txo => txo.wif = fundingWif) // 5) Use "simpleTokenGenesis()" helper method let genesisTxid; (async function(){ genesisTxid = await bitboxNetwork.simpleTokenGenesis( name, ticker, initialTokenQty, documentUri, documentHash, decimals, tokenReceiverAddress, batonReceiverAddress, bchChangeReceiverAddress, balances.nonSlpUtxos ) console.log("GENESIS txn complete:",genesisTxid) })(); 

// Install BITBOX-SDK v8.1+ for blockchain access // For more information visit: https://www.npmjs.com/package/bitbox-sdk const BITBOXSDK = require('bitbox-sdk'); const BigNumber = require('bignumber.js'); const slpjs = require('slpjs'); // FOR MAINNET UNCOMMENT const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://rest.bitcoin.com/v2/' }); const fundingAddress = "simpleledger:qrhvcy5xlegs858fjqf8ssl6a4f7wpstaqnt0wauwu"; // <-- must be simpleledger format const fundingWif = "L3gngkDg1HW5P9v5GdWWiCi3DWwvw5XnzjSPwNwVPN5DSck3AaiF"; // <-- compressed WIF format const tokenReceiverAddress = [ "simpleledger:qplrqmjgpug2qrfx4epuknvwaf7vxpnuevyswakrq9" ]; // <-- must be simpleledger format const bchChangeReceiverAddress = "simpleledger:qrhvcy5xlegs858fjqf8ssl6a4f7wpstaqnt0wauwu"; // <-- must be simpleledger format let tokenId = "d32b4191d3f78909f43a3f5853ba59e9f2d137925f28e7780e717f4b4bfd4a3f"; let sendAmounts = [ 1 ]; // FOR TESTNET UNCOMMENT // const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://trest.bitcoin.com/v2/' }); // const fundingAddress = "slptest:qpwyc9jnwckntlpuslg7ncmhe2n423304ueqcyw80l"; // <-- must be simpleledger format // const fundingWif = "cVjzvdHGfQDtBEq7oddDRcpzpYuvNtPbWdi8tKQLcZae65G4zGgy"; // <-- compressed WIF format // const tokenReceiverAddress = "slptest:qpwyc9jnwckntlpuslg7ncmhe2n423304ueqcyw80l"; // <-- must be simpleledger format // const bchChangeReceiverAddress = "slptest:qpwyc9jnwckntlpuslg7ncmhe2n423304ueqcyw80l"; // <-- must be simpleledger format // let tokenId = "78d57a82a0dd9930cc17843d9d06677f267777dd6b25055bad0ae43f1b884091"; // let sendAmounts = [ 10 ]; const bitboxNetwork = new slpjs.BitboxNetwork(BITBOX); // 1) Fetch critical token information let tokenDecimals; (async function() { const tokenInfo = await bitboxNetwork.getTokenInformation(tokenId); tokenDecimals = tokenInfo.decimals; console.log("Token precision: " + tokenDecimals.toString()); })(); // Wait for network responses... // 2) Check that token balance is greater than our desired sendAmount let balances; (async function() { balances = await bitboxNetwork.getAllSlpBalancesAndUtxos(fundingAddress); console.log("'balances' variable is set."); console.log(balances); if(balances.slpTokenBalances[tokenId] === undefined) console.log("You need to fund the addresses provided in this example with tokens and BCH. Change the tokenId as required.") console.log("Token balance:", balances.slpTokenBalances[tokenId].toFixed() / 10**tokenDecimals); })(); // Wait for network responses... // 3) Calculate send amount in "Token Satoshis". In this example we want to just send 1 token unit to someone... sendAmounts = sendAmounts.map(a => (new BigNumber(a)).times(10**tokenDecimals)); // Don't forget to account for token precision // 4) Get all of our token's UTXOs let inputUtxos = balances.slpTokenUtxos[tokenId]; // 5) Simply sweep our BCH utxos to fuel the transaction inputUtxos = inputUtxos.concat(balances.nonSlpUtxos); // 6) Set the proper private key for each Utxo inputUtxos.forEach(txo => txo.wif = fundingWif); // 7) Send token let sendTxid; (async function(){ sendTxid = await bitboxNetwork.simpleTokenSend( tokenId, sendAmounts, inputUtxos, tokenReceiverAddress, bchChangeReceiverAddress ) console.log("SEND txn complete:", sendTxid); })(); 

// Install BITBOX-SDK v8.1+ for blockchain access // For more information visit: https://www.npmjs.com/package/bitbox-sdk const BITBOXSDK = require('bitbox-sdk'); const BigNumber = require('bignumber.js'); const slpjs = require('slpjs'); // FOR MAINNET const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://rest.bitcoin.com/v2/' }); const fundingAddress = "bitcoincash:qzq6g2dzadew2ctt6cfhthwcc2q9m60mj56ld2hj5l"; // <-- must be CashAddr format // can use BITBOX.HDNode.toWIF() to generate this const fundingWif = "KzzMBS6twjSLAjH3a1wkd7rWs3PpiHq4eQzqSEfHuxbXfxYFUBiL"; // <-- compressed WIF format const bchReceiverAddress = [ "bitcoincash:qz42xz5y2hfltsa94mwm36pnl3ew8u72cc9l038x8m" ]; // <-- must be CashAddr format const bchChangeReceiverAddress = "bitcoincash:qzd5hqnlu2gprdxphqt6jvft33s3m2hegcqtu6mktg"; // <-- must be CashAddr format let sendAmountsInSatoshi = 1000; const bitboxNetwork = new slpjs.BitboxNetwork(BITBOX); // 1) Check that token balance is greater than our desired sendAmount let balances; (async function() { balances = await bitboxNetwork.getAllSlpBalancesAndUtxos(fundingAddress); console.log("'balances' variable is set.", balances); if (balances.satoshis_available_bch < sendAmountsInSatoshi) { throw new Error("You need to fund the addresses provided in this example with BCH."); } console.log("BCH balance in sats:", balances.satoshis_available_bch); })(); // Wait for network responses... // 2) construct sendAmounts as an array of BigInt let sendAmounts = [ new BigInt(sendAmountsInSatoshi) ]; // 3) Get all of non-SLP UTXOs let inputUtxos = balances.nonSlpUtxos; // 4) Set the proper private key for each Utxo inputUtxos = inputUtxos.map(utxo => ({ ...utxo, wif: fundingWif })); // 5) Send token let sendTxId; (async () => { sendTxId = await bitboxNetwork.simpleBchSend( sendAmounts, inputUtxos, bchReceiverAddress, bchChangeReceiverAddress ); console.log("SEND txn complete:", sendTxId); })(); 

const BITBOXSDK = require('bitbox-sdk'); const BigNumber = require('bignumber.js'); const slpjs = require('slpjs'); const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://trest.bitcoin.com/v2/' }); const slp = new slpjs.Slp(BITBOX); const helpers = new slpjs.TransactionHelpers(slp); const opcodes = BITBOX.Script.opcodes; const pubkey = "0286d74c6fb92cb7b70b817094f48bf8fd398e64663bc3ddd7acc0a709212b9f69"; const wif = "cPamRLmPyuuwgRAbB6JHhXvrGwvHtmw9LpVi8QnUZYBubCeyjgs1"; const tokenReceiverAddress = [ "slptest:prk685k6r508xkj7u9g8v9p3f97hrmgr2qp7r4safs" ]; // <-- must be simpleledger format const bchChangeReceiverAddress = "slptest:prk685k6r508xkj7u9g8v9p3f97hrmgr2qp7r4safs"; // <-- must be simpleledger format let tokenId = "f0c7a8a7addc29edbc193212057d91c3eb004678e15e4662773146bdd51f8d7a"; let sendAmounts = [ 1 ]; // Set our BIP-113 time lock (subtract an hour to acount for MTP-11) const time_delay_seconds = 0; // let's just set it to 0 so we can redeem it immediately. let locktime, locktimeBip62; (async function(){ locktime = (await BITBOX.Blockchain.getBlockchainInfo()).mediantime + time_delay_seconds - 3600; // NOTE: the following locktime is hard-coded so that we can reuse the same P2SH address. locktimeBip62 = 'c808f05c' //slpjs.Utils.get_BIP62_locktime_hex(locktime);  })(); // Wait for network response... let redeemScript = BITBOX.Script.encode([ Buffer.from(locktimeBip62, 'hex'), opcodes.OP_CHECKLOCKTIMEVERIFY, opcodes.OP_DROP, Buffer.from(pubkey, 'hex'), opcodes.OP_CHECKSIG ]) // Calculate the address for this script contract  // We need to send some token and BCH to it before we can spend it! let fundingAddress = slpjs.Utils.slpAddressFromHash160( BITBOX.Crypto.hash160(redeemScript), 'testnet', 'p2sh' ); // gives us: slptest:prk685k6r508xkj7u9g8v9p3f97hrmgr2qp7r4safs const bitboxNetwork = new slpjs.BitboxNetwork(BITBOX); // Fetch critical token information let tokenDecimals; (async function() { const tokenInfo = await bitboxNetwork.getTokenInformation(tokenId); tokenDecimals = tokenInfo.decimals; console.log("Token precision: " + tokenDecimals.toString()); })(); // Wait for network response... // Check that token balance is greater than our desired sendAmount let balances; (async function() { balances = await bitboxNetwork.getAllSlpBalancesAndUtxos(fundingAddress); console.log("'balances' variable is set."); console.log(balances); if(balances.slpTokenBalances[tokenId] === undefined) console.log("You need to fund the addresses provided in this example with tokens and BCH. Change the tokenId as required.") console.log("Token balance:", balances.slpTokenBalances[tokenId].toFixed() / 10**tokenDecimals); })(); // Wait for network response... // Calculate send amount in "Token Satoshis". In this example we want to just send 1 token unit to someone... sendAmounts = sendAmounts.map(a => (new BigNumber(a)).times(10**tokenDecimals)); // Don't forget to account for token precision // Get all of our token's UTXOs let inputUtxos = balances.slpTokenUtxos[tokenId]; // Simply sweep our BCH utxos to fuel the transaction inputUtxos = inputUtxos.concat(balances.nonSlpUtxos); // Estimate the additional fee for our larger p2sh scriptSigs let extraFee = (8) * // for OP_CTLV and timelock data push inputUtxos.length // this many times since we swept inputs from p2sh address // Build an unsigned transaction let unsignedTxnHex = helpers.simpleTokenSend(tokenId, sendAmounts, inputUtxos, tokenReceiverAddress, bchChangeReceiverAddress, [], extraFee); unsignedTxnHex = helpers.enableInputsCLTV(unsignedTxnHex); unsignedTxnHex = helpers.setTxnLocktime(unsignedTxnHex, locktime); // Build scriptSigs  let scriptSigs = inputUtxos.map((txo, i) => { let sigObj = helpers.get_transaction_sig_p2sh(unsignedTxnHex, wif, i, txo.satoshis, redeemScript) return { index: i, lockingScriptBuf: redeemScript, unlockingScriptBufArray: [ sigObj.signatureBuf ] } }) let signedTxn = helpers.addScriptSigs(unsignedTxnHex, scriptSigs); // 11) Send token let sendTxid; (async function(){ sendTxid = await bitboxNetwork.sendTx(signedTxn) console.log("SEND txn complete:", sendTxid); })(); 

// Install BITBOX-SDK v8.1+ for blockchain access // For more information visit: https://www.npmjs.com/package/bitbox-sdk const BITBOXSDK = require('bitbox-sdk'); const BigNumber = require('bignumber.js'); const slpjs = require('slpjs'); const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://rest.bitcoin.com/v2/' }); const slp = new slpjs.Slp(BITBOX); const helpers = new slpjs.TransactionHelpers(slp); const pubkey_signer_1 = "02471e07bcf7d47afd40e0bf4f806347f9e8af4dfbbb3c45691bbaefd4ea926307"; // Signer #1 const pubkey_signer_2 = "03472cfca5da3bf06a85c5fd860ffe911ef374cf2a9b754fd861d1ead668b15a32"; // Signer #2 // we have two signers for this 2-of-2 multisig address (so for the missing key we just put "null") const wifs = [ null, "L2AdfmxwsYu3KnRASZ51C3UEnduUDy1b21sSF9JbLNVEPzsxEZib"] //[ "Ky6iiLSL2K9stMd4G5dLeXfpVKu5YRB6dhjCsHyof3eaB2cDngSr", null ]; // to keep this example alive we will just send everything to the same address const tokenReceiverAddress = [ "simpleledger:pphnuh7dx24rcwjkj0sl6xqfyfzf23aj7udr0837gn" ]; // <-- must be simpleledger format const bchChangeReceiverAddress = "simpleledger:pphnuh7dx24rcwjkj0sl6xqfyfzf23aj7udr0837gn"; // <-- must be simpleledger format let tokenId = "497291b8a1dfe69c8daea50677a3d31a5ef0e9484d8bebb610dac64bbc202fb7"; let sendAmounts = [ 1 ]; const bitboxNetwork = new slpjs.BitboxNetwork(BITBOX); // 1) Fetch critical token information let tokenDecimals; (async function() { const tokenInfo = await bitboxNetwork.getTokenInformation(tokenId); tokenDecimals = tokenInfo.decimals; console.log("Token precision: " + tokenDecimals.toString()); })(); // Wait for network responses... // 2) Check that token balance is greater than our desired sendAmount let fundingAddress = "simpleledger:pphnuh7dx24rcwjkj0sl6xqfyfzf23aj7udr0837gn"; let balances; (async function() { balances = await bitboxNetwork.getAllSlpBalancesAndUtxos(fundingAddress); console.log("'balances' variable is set."); console.log(balances); if(balances.slpTokenBalances[tokenId] === undefined) console.log("You need to fund the addresses provided in this example with tokens and BCH. Change the tokenId as required.") console.log("Token balance:", balances.slpTokenBalances[tokenId].toFixed() / 10**tokenDecimals); })(); // Wait for network responses... // 3) Calculate send amount in "Token Satoshis". In this example we want to just send 1 token unit to someone... sendAmounts = sendAmounts.map(a => (new BigNumber(a)).times(10**tokenDecimals)); // Don't forget to account for token precision // 4) Get all of our token's UTXOs let inputUtxos = balances.slpTokenUtxos[tokenId]; // 5) Simply sweep our BCH utxos to fuel the transaction inputUtxos = inputUtxos.concat(balances.nonSlpUtxos); // 6) Estimate the additional fee for our larger p2sh scriptSigs let extraFee = (2 * 33 + // two pub keys in each redeemScript 2 * 72 + // two signatures in scriptSig 10) * // for OP_CMS and various length bytes inputUtxos.length // this many times since we swept inputs from p2sh address // 7) Build an unsigned transaction let unsignedTxnHex = helpers.simpleTokenSend(tokenId, sendAmounts, inputUtxos, tokenReceiverAddress, bchChangeReceiverAddress, [], extraFee); // 8) Build scriptSigs for all intputs let redeemData = helpers.build_P2SH_multisig_redeem_data(2, [pubkey_signer_1, pubkey_signer_2]); let scriptSigs = inputUtxos.map((txo, i) => { let sigData = redeemData.pubKeys.map((pk, j) => { if(wifs[j]) { return helpers.get_transaction_sig_p2sh(unsignedTxnHex, wifs[j], i, txo.satoshis, redeemData.lockingScript) } else { return helpers.get_transaction_sig_filler(i, pk) } }) return helpers.build_P2SH_multisig_scriptSig(redeemData, i, sigData) }) // 9) apply our scriptSigs to the unsigned transaction let signedTxn = helpers.addScriptSigs(unsignedTxnHex, scriptSigs); // 10) Update transaction hex with input values to allow for our second signer who is using Electron Cash SLP edition (https://simpleledger.cash/project/electron-cash-slp-edition/) let input_values = inputUtxos.map(txo => txo.satoshis) signedTxn = helpers.insert_input_values_for_EC_signers(signedTxn, input_values) // 11) Send token let sendTxid; (async function(){ sendTxid = await bitboxNetwork.sendTx(signedTxn) console.log("SEND txn complete:", sendTxid); })(); 

const BITBOXSDK = require('bitbox-sdk') const BITBOX = new BITBOXSDK.BITBOX(); const slpjs = require('slpjs'); const logger = console; const RpcClient = require('bitcoin-rpc-promise'); const connectionString = 'http://bitcoin:password@localhost:8332' const rpc = new RpcClient(connectionString); const slpValidator = new slpjs.LocalValidator(BITBOX, async (txids) => [ await rpc.getRawTransaction(txids[0]) ], logger) // Result = false //let txid = "903432f451049357d51c19eb529478621272e7572b05179f89bcb7be31e55aa7"; // Result = true let txid = "4a3829d6da924a16bbc0cc43d5d62b40996648a0c8f74725c15ec56ee930d0fa"; let isValid; (async function() { console.log("Validating:", txid); console.log("This may take a several seconds..."); isValid = await slpValidator.isValidSlpTxid(txid); console.log("Final Result:", isValid); })(); 

const BITBOXSDK = require('bitbox-sdk') const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://rest.bitcoin.com/v2/' }); const slpjs = require('slpjs'); const logger = console; const getRawTransactions = async function(txids) { return await BITBOX.RawTransactions.getRawTransaction(txids) } const slpValidator = new slpjs.LocalValidator(BITBOX, getRawTransactions, logger); // Result = false //let txid = "903432f451049357d51c19eb529478621272e7572b05179f89bcb7be31e55aa7"; // Result = true let txid = "4a3829d6da924a16bbc0cc43d5d62b40996648a0c8f74725c15ec56ee930d0fa"; let isValid; (async function() { console.log("Validating:", txid); console.log("This may take a several seconds..."); isValid = await slpValidator.isValidSlpTxid(txid); console.log("Final Result:", isValid); })(); 

const BITBOXSDK = require('bitbox-sdk') const BITBOX = new BITBOXSDK.BITBOX({ restURL: 'https://rest.bitcoin.com/v2/' }); const slpjs = require('slpjs'); const logger = console; const slpValidator = new slpjs.BitboxNetwork(BITBOX, undefined, logger); // Result = false //let txid = "903432f451049357d51c19eb529478621272e7572b05179f89bcb7be31e55aa7"; // Result = true let txid = "ab1550876e217d68bfac55e50b4a82535bb20842f976bdfbc07cca19e8028f13"; let isValid; (async function() { console.log("Validating:", txid); console.log("This may take a several seconds..."); isValid = await slpValidator.isValidSlpTxid(txid); console.log("Final Result:", isValid); })();