psffpp 1.0.1

package/test/unit/main-index-unit.js

@@ -0,0 +1,372 @@
+/*
+  Unit tests for the main index.js library file.
+*/
+
+// npm libraries
+const assert = require('chai').assert
+const sinon = require('sinon')
+const cloneDeep = require('lodash.clonedeep')
+const SlpWallet = require('minimal-slp-wallet')
+
+// Mocking data libraries.
+
+// Local libraries
+const MultisigApproval = require('../../index')
+const mockDataLib = require('./mocks/main-index-mocks')
+
+describe('#MultisigApproval.js', () => {
+  let sandbox
+  let mockData
+  let uut
+  let wallet
+
+  before(async () => {
+    wallet = new SlpWallet(undefined, { interface: 'consumer-api' })
+    await wallet.walletInfoPromise
+  })
+
+  beforeEach(() => {
+    // Restore the sandbox before each test.
+    sandbox = sinon.createSandbox()
+
+    // Clone the mock data.
+    mockData = cloneDeep(mockDataLib)
+
+    uut = new MultisigApproval({ wallet })
+  })
+
+  afterEach(() => sandbox.restore())
+
+  describe('#constructor', () => {
+    it('should throw an error if wallet is not passed', () => {
+      try {
+        uut = new MultisigApproval()
+
+        assert.fail('Unexpected result')
+      } catch (err) {
+        assert.include(err.message, 'Instance of minimal-slp-wallet must be passed in as a property called \'wallet\', when initializing the psf-multisig-approval library.')
+      }
+    })
+
+    it('should have encapsulated dependencies', () => {
+      assert.property(uut, 'nfts')
+    })
+  })
+
+  describe('#getNftHolderInfo', () => {
+    it('should get info about NFTs associated with a group token', async () => {
+      // Mock dependencies and force desired code path
+      sandbox.stub(uut.nfts, 'getNftsFromGroup').resolves()
+      sandbox.stub(uut.nfts, 'getAddrsFromNfts').resolves()
+      sandbox.stub(uut.nfts, 'findKeys').resolves({ keys: [], keysNotFound: [] })
+
+      const result = await uut.getNftHolderInfo()
+
+      assert.property(result, 'keys')
+      assert.property(result, 'keysNotFound')
+      assert.isArray(result.keys)
+      assert.isArray(result.keysNotFound)
+    })
+
+    it('should catch, report, and throw errors', async () => {
+      try {
+        // Mock dependencies and force desired code path
+        sandbox.stub(uut.nfts, 'getNftsFromGroup').rejects(new Error('test error'))
+
+        await uut.getNftHolderInfo()
+
+        assert.fail('Unexpected code path')
+      } catch (err) {
+        assert.include(err.message, 'test error')
+      }
+    })
+  })
+
+  describe('#createMultisigAddress', () => {
+    it('should generate a P2SH multisig address', async () => {
+      const result = await uut.createMultisigAddress({ keys: mockData.pubkeys01 })
+      // console.log('result: ', result)
+
+      // Assert that expected properties exist
+      assert.property(result, 'address')
+      assert.property(result, 'scriptHex')
+      assert.property(result, 'publicKeys')
+      assert.property(result, 'requiredSigners')
+
+      // Assert that expected address is generated
+      assert.equal(result.address, 'bitcoincash:pqntzt6wcp38h8ud68wjnwh437uek76lhvhlwcm4fj')
+    })
+
+    it('should catch, report, and throw errors', async () => {
+      try {
+        await uut.createMultisigAddress()
+
+        assert.fail('unexpected result')
+      } catch (err) {
+        assert.include(err.message, 'keys must be an array containing public keys')
+      }
+    })
+  })
+
+  describe('#getApprovalTx', () => {
+    it('should return object with update txid', async () => {
+      // Mock dependencies and force desired code path.
+      sandbox.stub(uut.wallet, 'getTransactions').resolves(mockData.txHistory01)
+      sandbox.stub(uut.util, 'getTxData').resolves(mockData.approvalTxDetails01)
+
+      const address = 'bitcoincash:fake-addr'
+
+      const result = await uut.getApprovalTx({ address })
+      // console.log('result: ', result)
+
+      // Assert that the returned object has the expected properties.
+      assert.property(result, 'approvalTxid')
+      assert.property(result, 'updateTxid')
+      assert.property(result, 'approvalTxDetails')
+      assert.property(result, 'opReturn')
+
+      // Assert that TXIDs are returned.
+      assert.equal(result.updateTxid.length, 64)
+      assert.equal(result.approvalTxid.length, 64)
+    })
+
+    it('should handle SLP addresses', async () => {
+      // Mock dependencies and force desired code path.
+      sandbox.stub(uut.wallet, 'getTransactions').resolves(mockData.txHistory01)
+      sandbox.stub(uut.util, 'getTxData').resolves(mockData.approvalTxDetails01)
+
+      const address = 'simpleledger:qpq4uxk6vc2hn3rw8tevpm570xgs22e6rskpzpenqg'
+
+      const result = await uut.getApprovalTx({ address })
+      // console.log('result: ', result)
+
+      // Assert that the returned object has the expected properties.
+      assert.property(result, 'approvalTxid')
+      assert.property(result, 'updateTxid')
+      assert.property(result, 'approvalTxDetails')
+      assert.property(result, 'opReturn')
+
+      // Assert that TXIDs are returned.
+      assert.equal(result.updateTxid.length, 64)
+      assert.equal(result.approvalTxid.length, 64)
+    })
+
+    it('should skip a TXID in the filter list', async () => {
+      // Mock dependencies and force desired code path.
+      sandbox.stub(uut.wallet, 'getTransactions').resolves(mockData.txHistory02)
+      sandbox.stub(uut.util, 'getTxData').resolves(mockData.approvalTxDetails01)
+
+      const address = 'bitcoincash:fake-addr'
+
+      const result = await uut.getApprovalTx({
+        address,
+        filterTxids: ['095b299da0be5bb2367e62a5628cef603c7d6e709dd72f532632e9c0acf665d3']
+      })
+      // console.log('result: ', result)
+
+      // Assert that the returned object has the expected properties.
+      assert.property(result, 'approvalTxid')
+      assert.property(result, 'updateTxid')
+      assert.property(result, 'approvalTxDetails')
+      assert.property(result, 'opReturn')
+
+      // Assert that TXIDs are returned.
+      assert.equal(result.updateTxid.length, 64)
+      assert.equal(result.approvalTxid.length, 64)
+    })
+
+    it('should skip a TXID if it does contain APPROVAL in the OP_RETURN', async () => {
+      // Mock dependencies and force desired code path.
+      sandbox.stub(uut.wallet, 'getTransactions').resolves(mockData.txHistory02)
+      sandbox.stub(uut.util, 'getTxData')
+        .onCall(0).resolves(mockData.updateTxDetails01)
+        .onCall(1).resolves(mockData.approvalTxDetails01)
+
+      const address = 'bitcoincash:fake-addr'
+
+      const result = await uut.getApprovalTx({
+        address
+      })
+      // console.log('result: ', result)
+
+      // Assert that the returned object has the expected properties.
+      assert.property(result, 'approvalTxid')
+      assert.property(result, 'updateTxid')
+      assert.property(result, 'approvalTxDetails')
+      assert.property(result, 'opReturn')
+
+      // Assert that TXIDs are returned.
+      assert.equal(result.updateTxid.length, 64)
+      assert.equal(result.approvalTxid.length, 64)
+    })
+
+    it('should return null if approval TX can not be found', async () => {
+      // Mock dependencies and force desired code path.
+      sandbox.stub(uut.wallet, 'getTransactions').resolves(mockData.txHistory01)
+      sandbox.stub(uut.util, 'getTxData').resolves(mockData.updateTxDetails01)
+
+      const address = 'bitcoincash:fake-addr'
+
+      const result = await uut.getApprovalTx({ address })
+      // console.log('result: ', result)
+
+      assert.equal(result, null)
+    })
+
+    it('should throw an error if invalid address format is used', async () => {
+      try {
+        const address = 'fake-addr'
+
+        await uut.getApprovalTx({ address })
+
+        assert.fail('Unexpected code path')
+      } catch (err) {
+        assert.include(err.message, 'Input address must start with bitcoincash: or simpleledger:')
+      }
+    })
+  })
+
+  describe('#getUpdateTx', () => {
+    it('should get data from an update transaction', async () => {
+      // Mock dependencies and force desired code path
+      sandbox.stub(uut.util, 'getTxData').resolves(mockData.updateTxDetails01)
+
+      const txid = 'f8ea1fcd4481adfd62c6251c6a4f63f3d5ac3d5fdcc38b350d321d93254df65f'
+
+      const result = await uut.getUpdateTx({ txid })
+      // console.log('result: ', result)
+
+      // Assert returned object has expected properties
+      assert.property(result, 'cid')
+      assert.property(result, 'ts')
+      assert.property(result, 'txid')
+      assert.property(result, 'txDetails')
+    })
+
+    it('should throw an error if a txid is given as input', async () => {
+      try {
+        await uut.getUpdateTx()
+
+        assert.fail('Unexpected result')
+      } catch (err) {
+        assert.include(err.message, 'txid required')
+      }
+    })
+
+    it('should throw an error if OP_RETURN can not be decoded', async () => {
+      try {
+        // Mock dependencies and force desired code path
+        mockData.updateTxDetails01.vout[0].scriptPubKey.hex = '0123456789abcdef'
+        sandbox.stub(uut.util, 'getTxData').resolves(mockData.updateTxDetails01)
+
+        const txid = 'f8ea1fcd4481adfd62c6251c6a4f63f3d5ac3d5fdcc38b350d321d93254df65f'
+
+        await uut.getUpdateTx({ txid })
+
+        assert.fail('Unexpected result')
+      } catch (err) {
+        assert.include(err.message, 'Could not parse JSON inside')
+      }
+    })
+  })
+
+  describe('#getCidData', () => {
+    it('should resolve CID data from an IPFS gateway', async () => {
+      // Mock dependencies and force desired code path
+      sandbox.stub(uut.axios, 'get').resolves({ data: mockData.updateData01 })
+
+      const cid = 'bafybeib5d6s6t3tq4lhwp2ocvz7y2ws4czgkrmhlhv5y5aeyh6bqrmsxxi'
+
+      const result = await uut.getCidData({ cid })
+      // console.log('result: ', result)
+
+      // Assert that expected properties exist
+      assert.property(result, 'groupId')
+      assert.property(result, 'keys')
+      assert.property(result, 'walletObj')
+      assert.property(result, 'multisigAddr')
+      assert.property(result, 'p2wdbWritePrice')
+    })
+
+    it('should throw an error if CID is not specified', async () => {
+      try {
+        await uut.getCidData()
+
+        assert.fail('Unexpected code path')
+      } catch (err) {
+        assert.include(err.message, 'cid a required input')
+      }
+    })
+  })
+
+  describe('#validateApproval', () => {
+    it('should validate a valid approval transaction', async () => {
+      // Mock dependencies and force desired code path
+      sandbox.stub(uut, 'getNftHolderInfo').resolves(mockData.tokenHolderInfo01)
+
+      const inObj = {
+        approvalObj: mockData.approvalObj01,
+        updateObj: mockData.updateObj01,
+        updateData: mockData.updateData01
+      }
+
+      const result = await uut.validateApproval(inObj)
+
+      assert.equal(result, true)
+    })
+
+    it('should throw an error if approvalObj is not specified', async () => {
+      try {
+        await uut.validateApproval()
+
+        assert.fail('Unexpected code path')
+      } catch (err) {
+        assert.include(err.message, 'Output object of getApprovalTx() is expected as input to this function, as \'approvalObj\'')
+      }
+    })
+
+    it('should throw an error if updateObj is not specified', async () => {
+      try {
+        const inObj = {
+          approvalObj: mockData.approvalObj01
+        }
+
+        await uut.validateApproval(inObj)
+
+        assert.fail('Unexpected code path')
+      } catch (err) {
+        assert.include(err.message, 'Output object of getUpdateTx() is expected as input to this function, as \'updateObj\'')
+      }
+    })
+
+    it('should throw an error if updateData is not specified', async () => {
+      try {
+        const inObj = {
+          approvalObj: mockData.approvalObj01,
+          updateObj: mockData.updateObj01
+        }
+
+        await uut.validateApproval(inObj)
+
+        assert.fail('Unexpected code path')
+      } catch (err) {
+        assert.include(err.message, 'Update CID JSON data is expected as input to this function, as \'updateData\'')
+      }
+    })
+
+    it('should return false if addresses do not match', async () => {
+      // Mock dependencies and force desired code path
+      mockData.approvalObj01.approvalTxDetails.vin[0].address = 'bitcoincash:fake-addr'
+
+      const inObj = {
+        approvalObj: mockData.approvalObj01,
+        updateObj: mockData.updateObj01,
+        updateData: mockData.updateData01
+      }
+
+      const result = await uut.validateApproval(inObj)
+
+      assert.equal(result, false)
+    })
+  })
+})

package/test/unit/mocks/main-index-mocks.js

@@ -0,0 +1,290 @@
+/*
+  Mock data for the main-index-unit.js unit test library.
+*/
+
+const approvalTxDetails01 = {
+  txid: 'a63f9fbcc901316e6e89f5a8caaad6b2ab268278b29866c6c22088bd3ab93900',
+  hash: 'a63f9fbcc901316e6e89f5a8caaad6b2ab268278b29866c6c22088bd3ab93900',
+  version: 2,
+  size: 595,
+  locktime: 0,
+  vin: [
+    {
+      txid: 'f630f4db4b88c604e0670558782dfcfe7ad4b3d06c033dafa36f1505c3dbc58d',
+      vout: 0,
+      scriptSig: {
+        asm: '0 304402201474f95ab0e5fa3b5d6bd5f83d904c23a448f11c51a4b007b759663e76856e72022008b209df76b75e15422436f893b1b9f9f0671d65f41d0d419313f651e408c596[ALL|FORKID] 304402205ccff79c16a58da52ced457d6e898857df8fca650c7a4501406c95659c81f1e202201f79ab6615e75ae519ba8ee9d19718892dc07f3f307673149cafc5f487eb0ac0[ALL|FORKID] 3045022100dd9c0445509ada78622ae4551503c7bd84505bacfdb13994104e86e1c615a39f02205b895941fdd2a8082d27801904979992c4a6eaac3c85dd056c3c1b32865cff40[ALL|FORKID] 5321021ca211a04a1d489ae77e01c28c97b02e733893890fda00a359ca8956c2e0d25921024be54accec310c2636140336ae548d610ba9b7ce300b3f42494b4a6f2963731f21033c930d4cff4ba68a70f7a21443e20ad4176173380d21f8c3ce27f7ce947f3246210361fd21512b9072e8f6b984d9b04c57e5779867c2ad002999372268770fcb26742103b9bdc40c478ab0536be29c368b26c48a5e8d6867fc34b77c727ab690365aae9155ae',
+        hex: '0047304402201474f95ab0e5fa3b5d6bd5f83d904c23a448f11c51a4b007b759663e76856e72022008b209df76b75e15422436f893b1b9f9f0671d65f41d0d419313f651e408c5964147304402205ccff79c16a58da52ced457d6e898857df8fca650c7a4501406c95659c81f1e202201f79ab6615e75ae519ba8ee9d19718892dc07f3f307673149cafc5f487eb0ac041483045022100dd9c0445509ada78622ae4551503c7bd84505bacfdb13994104e86e1c615a39f02205b895941fdd2a8082d27801904979992c4a6eaac3c85dd056c3c1b32865cff40414cad5321021ca211a04a1d489ae77e01c28c97b02e733893890fda00a359ca8956c2e0d25921024be54accec310c2636140336ae548d610ba9b7ce300b3f42494b4a6f2963731f21033c930d4cff4ba68a70f7a21443e20ad4176173380d21f8c3ce27f7ce947f3246210361fd21512b9072e8f6b984d9b04c57e5779867c2ad002999372268770fcb26742103b9bdc40c478ab0536be29c368b26c48a5e8d6867fc34b77c727ab690365aae9155ae'
+      },
+      sequence: 4294967295,
+      address: 'bitcoincash:pqntzt6wcp38h8ud68wjnwh437uek76lhvhlwcm4fj',
+      value: 0.000756
+    }
+  ],
+  vout: [
+    {
+      value: 0,
+      n: 0,
+      scriptPubKey: {
+        asm: 'OP_RETURN 19516672076435521 66386561316663643434383161646664363263363235316336613466363366336435616333643566646363333862333530643332316439333235346466363566',
+        hex: '6a07415050524f56454066386561316663643434383161646664363263363235316336613466363366336435616333643566646363333862333530643332316439333235346466363566',
+        type: 'nulldata'
+      }
+    },
+    {
+      value: 0.00001,
+      n: 1,
+      scriptPubKey: {
+        asm: 'OP_DUP OP_HASH160 dd9d58d7672be6675262069534b173c113f59e85 OP_EQUALVERIFY OP_CHECKSIG',
+        hex: '76a914dd9d58d7672be6675262069534b173c113f59e8588ac',
+        reqSigs: 1,
+        type: 'pubkeyhash',
+        addresses: [
+          'bitcoincash:qrwe6kxhvu47ve6jvgrf2d93w0q38av7s5xm9xfehr'
+        ]
+      }
+    },
+    {
+      value: 0.00072671,
+      n: 2,
+      scriptPubKey: {
+        asm: 'OP_HASH160 26b12f4ec0627b9f8dd1dd29baf58fb99b7b5fbb OP_EQUAL',
+        hex: 'a91426b12f4ec0627b9f8dd1dd29baf58fb99b7b5fbb87',
+        reqSigs: 1,
+        type: 'scripthash',
+        addresses: [
+          'bitcoincash:pqntzt6wcp38h8ud68wjnwh437uek76lhvhlwcm4fj'
+        ]
+      }
+    }
+  ],
+  hex: '02000000018dc5dbc305156fa3af3d036cd0b3d47afefc2d78580567e004c6884bdbf430f600000000fd89010047304402201474f95ab0e5fa3b5d6bd5f83d904c23a448f11c51a4b007b759663e76856e72022008b209df76b75e15422436f893b1b9f9f0671d65f41d0d419313f651e408c5964147304402205ccff79c16a58da52ced457d6e898857df8fca650c7a4501406c95659c81f1e202201f79ab6615e75ae519ba8ee9d19718892dc07f3f307673149cafc5f487eb0ac041483045022100dd9c0445509ada78622ae4551503c7bd84505bacfdb13994104e86e1c615a39f02205b895941fdd2a8082d27801904979992c4a6eaac3c85dd056c3c1b32865cff40414cad5321021ca211a04a1d489ae77e01c28c97b02e733893890fda00a359ca8956c2e0d25921024be54accec310c2636140336ae548d610ba9b7ce300b3f42494b4a6f2963731f21033c930d4cff4ba68a70f7a21443e20ad4176173380d21f8c3ce27f7ce947f3246210361fd21512b9072e8f6b984d9b04c57e5779867c2ad002999372268770fcb26742103b9bdc40c478ab0536be29c368b26c48a5e8d6867fc34b77c727ab690365aae9155aeffffffff0300000000000000004a6a07415050524f56454066386561316663643434383161646664363263363235316336613466363366336435616333643566646363333862333530643332316439333235346466363566e8030000000000001976a914dd9d58d7672be6675262069534b173c113f59e8588acdf1b01000000000017a91426b12f4ec0627b9f8dd1dd29baf58fb99b7b5fbb8700000000',
+  blockhash: '000000000000000003e90bff17eeb147b0fb532abeddd5ba5a7ec23347e300ee',
+  confirmations: 6450,
+  time: 1677006961,
+  blocktime: 1677006961,
+  isValidSlp: false
+}
+
+const updateTxDetails01 = {
+  txid: 'f8ea1fcd4481adfd62c6251c6a4f63f3d5ac3d5fdcc38b350d321d93254df65f',
+  hash: 'f8ea1fcd4481adfd62c6251c6a4f63f3d5ac3d5fdcc38b350d321d93254df65f',
+  version: 2,
+  size: 361,
+  locktime: 0,
+  vin: [
+    {
+      txid: '2879a62158f0c3953750688e439d87737face939b5493b213f2e7d3bf505ddc4',
+      vout: 2,
+      scriptSig: {
+        asm: '3045022100919192436273a7b53994e151d6e2359934fcdb17f60f37954fab06f5012fccea02207c329deb48b0eaff25651360ac71d159b8b0bb49072aea3a6d4b657e61f24c30[ALL|FORKID] 02239ca86fcc2910aefb3bd06419c15bd542a7ce4e1c34c48ca9d398640cf94a3e',
+        hex: '483045022100919192436273a7b53994e151d6e2359934fcdb17f60f37954fab06f5012fccea02207c329deb48b0eaff25651360ac71d159b8b0bb49072aea3a6d4b657e61f24c30412102239ca86fcc2910aefb3bd06419c15bd542a7ce4e1c34c48ca9d398640cf94a3e'
+      },
+      sequence: 4294967295,
+      address: 'bitcoincash:qz4mn3ayguhyylz50zsg953yzs8ay3akrg3wle6qj6',
+      value: 0.00710985
+    }
+  ],
+  vout: [
+    {
+      value: 0,
+      n: 0,
+      scriptPubKey: {
+        asm: 'OP_RETURN 0 7b22636964223a226261667962656962356436733674337471346c687770326f63767a377932777334637a676b726d686c687635793561657968366271726d73787869222c227473223a313637363536303234373136387d',
+        hex: '6a004c587b22636964223a226261667962656962356436733674337471346c687770326f63767a377932777334637a676b726d686c687635793561657968366271726d73787869222c227473223a313637363536303234373136387d',
+        type: 'nulldata'
+      }
+    },
+    {
+      value: 0.00002,
+      n: 1,
+      scriptPubKey: {
+        asm: 'OP_DUP OP_HASH160 203b64bfbaa9e58333295b621159ddebc591ecb1 OP_EQUALVERIFY OP_CHECKSIG',
+        hex: '76a914203b64bfbaa9e58333295b621159ddebc591ecb188ac',
+        reqSigs: 1,
+        type: 'pubkeyhash',
+        addresses: [
+          'bitcoincash:qqsrke9lh257tqen99dkyy2emh4uty0vky9y0z0lsr'
+        ]
+      }
+    },
+    {
+      value: 0.00708077,
+      n: 2,
+      scriptPubKey: {
+        asm: 'OP_DUP OP_HASH160 abb9c7a4472e427c5478a082d224140fd247b61a OP_EQUALVERIFY OP_CHECKSIG',
+        hex: '76a914abb9c7a4472e427c5478a082d224140fd247b61a88ac',
+        reqSigs: 1,
+        type: 'pubkeyhash',
+        addresses: [
+          'bitcoincash:qz4mn3ayguhyylz50zsg953yzs8ay3akrg3wle6qj6'
+        ]
+      }
+    },
+    {
+      value: 0.00000546,
+      n: 3,
+      scriptPubKey: {
+        asm: 'OP_DUP OP_HASH160 dd9d58d7672be6675262069534b173c113f59e85 OP_EQUALVERIFY OP_CHECKSIG',
+        hex: '76a914dd9d58d7672be6675262069534b173c113f59e8588ac',
+        reqSigs: 1,
+        type: 'pubkeyhash',
+        addresses: [
+          'bitcoincash:qrwe6kxhvu47ve6jvgrf2d93w0q38av7s5xm9xfehr'
+        ]
+      }
+    }
+  ],
+  hex: '0200000001c4dd05f53b7d2e3f213b49b539e9ac7f73879d438e68503795c3f05821a67928020000006b483045022100919192436273a7b53994e151d6e2359934fcdb17f60f37954fab06f5012fccea02207c329deb48b0eaff25651360ac71d159b8b0bb49072aea3a6d4b657e61f24c30412102239ca86fcc2910aefb3bd06419c15bd542a7ce4e1c34c48ca9d398640cf94a3effffffff0400000000000000005c6a004c587b22636964223a226261667962656962356436733674337471346c687770326f63767a377932777334637a676b726d686c687635793561657968366271726d73787869222c227473223a313637363536303234373136387dd0070000000000001976a914203b64bfbaa9e58333295b621159ddebc591ecb188acedcd0a00000000001976a914abb9c7a4472e427c5478a082d224140fd247b61a88ac22020000000000001976a914dd9d58d7672be6675262069534b173c113f59e8588ac00000000',
+  blockhash: '000000000000000001a1b31a8ec4a683a13fbe287209949e4dd54045860f776e',
+  confirmations: 7239,
+  time: 1676561115,
+  blocktime: 1676561115,
+  isValidSlp: false
+}
+
+const pubkeys01 = [
+  {
+    addr: 'bitcoincash:qz4zsa22glal5c4jqm748xge657gwuw2d5t9nvg64p',
+    pubKey: '021ca211a04a1d489ae77e01c28c97b02e733893890fda00a359ca8956c2e0d259',
+    nft: 'e86164aaa06efac1d6453951f67beafe042f0bceb9312845a95355b1e93aa846'
+  },
+  {
+    addr: 'bitcoincash:qpfvh07mdt7yq5czndaz5qq4g9q3m87qpspy7xaxgu',
+    pubKey: '0361fd21512b9072e8f6b984d9b04c57e5779867c2ad002999372268770fcb2674',
+    nft: 'da7ccbd5e24e468c9e7402489ca9148b5e76e588b73cc4aa4bbf1ca41d5808ab'
+  },
+  {
+    addr: 'bitcoincash:qpsxtzaa7rg677akcc2znpenpsy5jr2ygywmfd45p2',
+    pubKey: '03b9bdc40c478ab0536be29c368b26c48a5e8d6867fc34b77c727ab690365aae91',
+    nft: '0ec318bede8c2f229db840a24cb63d662ad91e8e6c840e46e6a8ff2d173049ce'
+  },
+  {
+    addr: 'bitcoincash:qqk3aczzggvxnfm7rwm0f9yz20yr00dmpv2f3tasdr',
+    pubKey: '033c930d4cff4ba68a70f7a21443e20ad4176173380d21f8c3ce27f7ce947f3246',
+    nft: '51624e772adafd7c6a9da38774e4f654282199bd5402e049ee087fc2bd900882'
+  },
+  {
+    addr: 'bitcoincash:qpszha37cjn6n83hpxn7zz5ndaa35vygtcgslxhpuc',
+    pubKey: '024be54accec310c2636140336ae548d610ba9b7ce300b3f42494b4a6f2963731f',
+    nft: 'e70cc72eeb15c82e96b1f8127d3b138b2fc8ea101fe9c62302ec641c05d4b97d'
+  }
+]
+
+const txHistory01 = [{
+  height: 780917,
+  tx_hash: 'a63f9fbcc901316e6e89f5a8caaad6b2ab268278b29866c6c22088bd3ab93900'
+}]
+
+const txHistory02 = [
+  {
+    height: 781137,
+    tx_hash: '095b299da0be5bb2367e62a5628cef603c7d6e709dd72f532632e9c0acf665d3'
+  },
+  {
+    height: 780917,
+    tx_hash: 'a63f9fbcc901316e6e89f5a8caaad6b2ab268278b29866c6c22088bd3ab93900'
+  }
+]
+
+const tokenHolderInfo01 = {
+  keys: [
+    {
+      addr: 'bitcoincash:qz4zsa22glal5c4jqm748xge657gwuw2d5t9nvg64p',
+      pubKey: '021ca211a04a1d489ae77e01c28c97b02e733893890fda00a359ca8956c2e0d259',
+      nft: 'e86164aaa06efac1d6453951f67beafe042f0bceb9312845a95355b1e93aa846'
+    },
+    {
+      addr: 'bitcoincash:qpfvh07mdt7yq5czndaz5qq4g9q3m87qpspy7xaxgu',
+      pubKey: '0361fd21512b9072e8f6b984d9b04c57e5779867c2ad002999372268770fcb2674',
+      nft: 'da7ccbd5e24e468c9e7402489ca9148b5e76e588b73cc4aa4bbf1ca41d5808ab'
+    },
+    {
+      addr: 'bitcoincash:qpsxtzaa7rg677akcc2znpenpsy5jr2ygywmfd45p2',
+      pubKey: '03b9bdc40c478ab0536be29c368b26c48a5e8d6867fc34b77c727ab690365aae91',
+      nft: '0ec318bede8c2f229db840a24cb63d662ad91e8e6c840e46e6a8ff2d173049ce'
+    },
+    {
+      addr: 'bitcoincash:qqk3aczzggvxnfm7rwm0f9yz20yr00dmpv2f3tasdr',
+      pubKey: '033c930d4cff4ba68a70f7a21443e20ad4176173380d21f8c3ce27f7ce947f3246',
+      nft: '51624e772adafd7c6a9da38774e4f654282199bd5402e049ee087fc2bd900882'
+    },
+    {
+      addr: 'bitcoincash:qpszha37cjn6n83hpxn7zz5ndaa35vygtcgslxhpuc',
+      pubKey: '024be54accec310c2636140336ae548d610ba9b7ce300b3f42494b4a6f2963731f',
+      nft: 'e70cc72eeb15c82e96b1f8127d3b138b2fc8ea101fe9c62302ec641c05d4b97d'
+    }
+  ],
+  keysNotFound: []
+}
+
+const updateData01 = {
+  groupId: '8e8d90ebdb1791d58eba7acd428ff3b1e21c47fb7aba2ba3b5b815aa0fe7d6d5',
+  keys: [
+    {
+      addr: 'bitcoincash:qz4zsa22glal5c4jqm748xge657gwuw2d5t9nvg64p',
+      pubKey: '021ca211a04a1d489ae77e01c28c97b02e733893890fda00a359ca8956c2e0d259',
+      nft: 'e86164aaa06efac1d6453951f67beafe042f0bceb9312845a95355b1e93aa846'
+    },
+    {
+      addr: 'bitcoincash:qpfvh07mdt7yq5czndaz5qq4g9q3m87qpspy7xaxgu',
+      pubKey: '0361fd21512b9072e8f6b984d9b04c57e5779867c2ad002999372268770fcb2674',
+      nft: 'da7ccbd5e24e468c9e7402489ca9148b5e76e588b73cc4aa4bbf1ca41d5808ab'
+    },
+    {
+      addr: 'bitcoincash:qpsxtzaa7rg677akcc2znpenpsy5jr2ygywmfd45p2',
+      pubKey: '03b9bdc40c478ab0536be29c368b26c48a5e8d6867fc34b77c727ab690365aae91',
+      nft: '0ec318bede8c2f229db840a24cb63d662ad91e8e6c840e46e6a8ff2d173049ce'
+    },
+    {
+      addr: 'bitcoincash:qqk3aczzggvxnfm7rwm0f9yz20yr00dmpv2f3tasdr',
+      pubKey: '033c930d4cff4ba68a70f7a21443e20ad4176173380d21f8c3ce27f7ce947f3246',
+      nft: '51624e772adafd7c6a9da38774e4f654282199bd5402e049ee087fc2bd900882'
+    },
+    {
+      addr: 'bitcoincash:qpszha37cjn6n83hpxn7zz5ndaa35vygtcgslxhpuc',
+      pubKey: '024be54accec310c2636140336ae548d610ba9b7ce300b3f42494b4a6f2963731f',
+      nft: 'e70cc72eeb15c82e96b1f8127d3b138b2fc8ea101fe9c62302ec641c05d4b97d'
+    }
+  ],
+  walletObj: {
+    address: 'bitcoincash:pqntzt6wcp38h8ud68wjnwh437uek76lhvhlwcm4fj',
+    scriptHex: 'a91426b12f4ec0627b9f8dd1dd29baf58fb99b7b5fbb87',
+    publicKeys: [
+      '021ca211a04a1d489ae77e01c28c97b02e733893890fda00a359ca8956c2e0d259',
+      '0361fd21512b9072e8f6b984d9b04c57e5779867c2ad002999372268770fcb2674',
+      '03b9bdc40c478ab0536be29c368b26c48a5e8d6867fc34b77c727ab690365aae91',
+      '033c930d4cff4ba68a70f7a21443e20ad4176173380d21f8c3ce27f7ce947f3246',
+      '024be54accec310c2636140336ae548d610ba9b7ce300b3f42494b4a6f2963731f'
+    ],
+    requiredSigners: 3
+  },
+  multisigAddr: 'bitcoincash:pqntzt6wcp38h8ud68wjnwh437uek76lhvhlwcm4fj',
+  p2wdbWritePrice: 0.08335233
+}
+
+const approvalObj01 = {
+  approvalTxid: 'a63f9fbcc901316e6e89f5a8caaad6b2ab268278b29866c6c22088bd3ab93900',
+  updateTxid: 'f8ea1fcd4481adfd62c6251c6a4f63f3d5ac3d5fdcc38b350d321d93254df65f',
+  approvalTxDetails: approvalTxDetails01,
+  opReturn: 'j\x07APPROVE@f8ea1fcd4481adfd62c6251c6a4f63f3d5ac3d5fdcc38b350d321d93254df65f'
+}
+
+const updateObj01 = {
+  cid: 'bafybeib5d6s6t3tq4lhwp2ocvz7y2ws4czgkrmhlhv5y5aeyh6bqrmsxxi',
+  ts: 1676560247168,
+  txid: 'f8ea1fcd4481adfd62c6251c6a4f63f3d5ac3d5fdcc38b350d321d93254df65f',
+  txDetails: updateTxDetails01
+}
+
+module.exports = {
+  pubkeys01,
+  txHistory01,
+  txHistory02,
+  approvalTxDetails01,
+  updateTxDetails01,
+  tokenHolderInfo01,
+  updateData01,
+  approvalObj01,
+  updateObj01
+}

package/test/unit/mocks/util-mocks.js

@@ -0,0 +1,32 @@
+/*
+  A mocking library for util.js unit tests.
+  A mocking library contains data to use in place of the data that would come
+  from an external dependency.
+*/
+
+'use strict'
+
+const mockBalance = {
+  success: true,
+  balance: {
+    confirmed: 1000,
+    unconfirmed: 0
+  }
+}
+
+const mockUtxos = {
+  success: true,
+  utxos: [
+    {
+      height: 601861,
+      tx_hash: '6181c669614fa18039a19b23eb06806bfece1f7514ab457c3bb82a40fe171a6d',
+      tx_pos: 0,
+      value: 1000
+    }
+  ]
+}
+
+module.exports = {
+  mockBalance,
+  mockUtxos
+}