@bopen-io/wallet-toolbox 1.7.18

package/test/Wallet/sync/Wallet.updateWalletLegacyTestData.man.test.ts

@@ -0,0 +1,203 @@
+import { Setup } from '../../../src'
+import { sdk, StorageSyncReader, wait } from '../../../src/index.client'
+import { TaskCheckForProofs } from '../../../src/monitor/tasks/TaskCheckForProofs'
+import { TaskClock } from '../../../src/monitor/tasks/TaskClock'
+import { TaskNewHeader } from '../../../src/monitor/tasks/TaskNewHeader'
+import { TaskPurge } from '../../../src/monitor/tasks/TaskPurge'
+import { StorageMySQLDojoReader } from '../../../src/storage/sync'
+import { _tu, TestSetup1Wallet } from '../../utils/TestUtilsWalletStorage'
+
+import * as dotenv from 'dotenv'
+dotenv.config()
+const main_satoshi_shop = process.env.SATOSHI_SHOP_MAIN_IDENTITY || ''
+
+/**
+ * NOTICE: These tests are designed to chain one after the other.
+ * Disable the "await WaitFor*()" lines to run them individually.
+ *
+ * The inital import from staging dojo takes around 100 seconds... be patient.
+ */
+describe('Wallet sync tests', () => {
+  jest.setTimeout(99999999)
+
+  beforeAll(async () => {})
+
+  afterAll(async () => {})
+
+  let doWait = false
+  let done0 = false
+  const waitFor0 = async () => {
+    while (doWait && !done0) await wait(100)
+  }
+  let done1 = false
+  const waitFor1 = async () => {
+    while (doWait && !done1) await wait(100)
+  }
+  let done2 = false
+  const waitFor2 = async () => {
+    while (doWait && !done2) await wait(100)
+  }
+
+  const env = _tu.getEnv('test')
+  const identityKeyTone = '03ac2d10bdb0023f4145cc2eba2fcd2ad3070cb2107b0b48170c46a9440e4cc3fe'
+  const rootKeyHex = env.devKeys[identityKeyTone]
+
+  test('0 sync staging dojo to local MySQL', async () => {
+    console.log('Importing from staging dojo to local MySQL stagingdojotone')
+    const chain: sdk.Chain = 'test'
+    const connection = JSON.parse(process.env.TEST_DOJO_CONNECTION || '')
+    const readerKnex = _tu.createMySQLFromConnection(connection)
+    const reader = new StorageMySQLDojoReader({ chain, knex: readerKnex })
+    const writer = await _tu.createMySQLTestWallet({
+      databaseName: 'stagingdojotone',
+      chain: 'test',
+      rootKeyHex,
+      dropAll: true
+    })
+
+    const identityKey = writer.identityKey
+    await writer.storage.syncFromReader(identityKey, new StorageSyncReader({ identityKey }, reader))
+
+    await reader.destroy()
+    await writer.activeStorage.destroy()
+    done0 = true
+  })
+
+  test.skip('0a sync production dojo to local MySQL', async () => {
+    const chain: sdk.Chain = 'main'
+    const env = _tu.getEnv(chain)
+    console.log('Importing from production dojo to local MySQL productiondojotone')
+    const identityKey = main_satoshi_shop
+    const rootKeyHex = env.devKeys[identityKey]
+    const connection = JSON.parse(process.env.MAIN_DOJO_CONNECTION || '')
+    const readerKnex = _tu.createMySQLFromConnection(connection)
+    const reader = new StorageMySQLDojoReader({ chain, knex: readerKnex })
+    const writer = await _tu.createMySQLTestWallet({
+      databaseName: 'main_satoshi_shop',
+      chain: 'main',
+      rootKeyHex,
+      dropAll: true
+    })
+
+    await writer.storage.syncFromReader(identityKey, new StorageSyncReader({ identityKey }, reader))
+
+    await reader.destroy()
+    await writer.activeStorage.destroy()
+  })
+
+  test.skip('0b sweep mysql dojo sync to another wallet', async () => {
+    const chain: sdk.Chain = 'main'
+    const env = _tu.getEnv(chain)
+    // const prod_faucet = '030b78da8101cd8929ec355c694c275fbaf4f73d4eaa104873463779cac69a2a01' // prod faucet
+    // const identityKeyTone = process.env.MY_MAIN_IDENTITY || ''
+    const identityKey = main_satoshi_shop
+    const rootKeyHex = env.devKeys[identityKey]
+
+    const sweepFrom = await _tu.createMySQLTestWallet({
+      databaseName: 'main_satoshi_shop',
+      chain,
+      rootKeyHex
+    })
+
+    const sweepTo = await _tu.createTestWalletWithStorageClient({
+      rootKeyHex: env.devKeys[env.identityKey],
+      chain
+    })
+
+    //await sweepTo.activeStorage.updateProvenTxReq(2, { status: 'invalid' })
+    //await sweepTo.activeStorage.updateTransactionStatus('failed', 2)
+
+    await sweepFrom.wallet.sweepTo(sweepTo.wallet)
+
+    await sweepTo.wallet.destroy()
+    await sweepFrom.wallet.destroy()
+  })
+
+  test.skip('1 aggressively purge records from MySQL stagingdojotone', async () => {
+    await waitFor0()
+
+    const { monitor, activeStorage } = await _tu.createMySQLTestWallet({
+      databaseName: 'stagingdojotone',
+      chain: 'test',
+      rootKeyHex
+    })
+
+    {
+      const task = new TaskPurge(monitor, {
+        purgeCompleted: true,
+        purgeFailed: true,
+        purgeSpent: true,
+        purgeCompletedAge: 1,
+        purgeFailedAge: 1,
+        purgeSpentAge: 1
+      })
+      TaskPurge.checkNow = true
+      monitor._tasks.push(task)
+      await monitor.runTask('Purge')
+    }
+
+    await activeStorage.destroy()
+
+    done1 = true
+  })
+
+  test.skip('2 sync pruned MySQL stagingdojotone to SQLite walletLegacyTestData', async () => {
+    await waitFor1()
+    console.log('syncing local MySQL stagingdojotone to local SQLite walletLegacyTestData in tmp folder')
+    const reader = await _tu.createMySQLTestWallet({
+      databaseName: 'stagingdojotone',
+      chain: 'test',
+      rootKeyHex
+    })
+    const writer = await _tu.createSQLiteTestWallet({
+      databaseName: 'walletLegacyTestData',
+      chain: 'test',
+      rootKeyHex,
+      dropAll: true
+    })
+
+    const identityKey = writer.identityKey
+    await writer.storage.syncFromReader(identityKey, new StorageSyncReader({ identityKey }, reader.activeStorage))
+
+    await reader.activeStorage.destroy()
+    await writer.activeStorage.destroy()
+
+    console.log('REMEMBER: copy walletLegacyTestData.sqlite from tmp up to data!')
+    done2 = true
+  })
+
+  test.skip('3 sync pruned MySQL stagingdojotone to MySQL walletLegacyTestData', async () => {
+    await waitFor2()
+    console.log('syncing local MySQL stagingdojotone to local SQLite walletLegacyTestData in tmp folder')
+    const reader = await _tu.createMySQLTestWallet({
+      databaseName: 'stagingdojotone',
+      chain: 'test',
+      rootKeyHex
+    })
+    const writer = await _tu.createMySQLTestWallet({
+      databaseName: 'walletLegacyTestData',
+      chain: 'test',
+      rootKeyHex,
+      dropAll: true
+    })
+
+    const identityKey = writer.identityKey
+    await writer.storage.syncFromReader(identityKey, new StorageSyncReader({ identityKey }, reader.activeStorage))
+
+    await reader.activeStorage.destroy()
+    await writer.activeStorage.destroy()
+  })
+
+  test('8b run monitor mainnet', async () => {
+    if (Setup.noEnv('main')) return
+    if (!Setup.getEnv('main').filePath) return
+
+    // Only run if `Setup` style .env is present with a sqlite filePath...
+
+    const c = await _tu.createWalletSetupEnv('main')
+
+    await c.monitor.runOnce()
+
+    await c.wallet.destroy()
+  })
+})

package/test/Wallet/sync/setActive.test.ts

@@ -0,0 +1,170 @@
+import knex from 'knex'
+import { sdk, Setup, StorageKnex, wait } from '../../../src'
+import { _tu, logger, TestWalletNoSetup } from '../../utils/TestUtilsWalletStorage'
+
+let done0 = false
+const waitFor0 = async () => {
+  while (!done0) await wait(100)
+}
+let done1 = false
+const waitFor1 = async () => {
+  while (!done1) await wait(100)
+}
+let done2 = false
+const waitFor2 = async () => {
+  while (!done2) await wait(100)
+}
+
+describe('setActive tests', () => {
+  jest.setTimeout(99999999)
+
+  const env = _tu.getEnv('test')
+  const chain = env.chain
+  const rootKeyHex = env.devKeys[env.identityKey]
+  let setup: {
+    a: TestWalletNoSetup
+    b: TestWalletNoSetup
+    c: TestWalletNoSetup
+  }
+  let store: { a: StorageKnex; b: StorageKnex; c: StorageKnex }
+  let storeKey: { a: string; b: string; c: string }
+  const testName = () => expect.getState().currentTestName || 'test'
+
+  beforeEach(async () => {
+    const a = await _tu.createSQLiteTestWallet({
+      databaseName: `${testName()}_a`,
+      chain,
+      rootKeyHex,
+      dropAll: true
+    })
+    const b = await _tu.createSQLiteTestWallet({
+      databaseName: `${testName()}_b`,
+      chain,
+      rootKeyHex,
+      dropAll: true
+    })
+    const c = await _tu.createSQLiteTestWallet({
+      databaseName: `${testName()}_c`,
+      chain,
+      rootKeyHex,
+      dropAll: true
+    })
+    setup = { a, b, c }
+    store = { a: a.activeStorage, b: b.activeStorage, c: c.activeStorage }
+    storeKey = {
+      a: store.a._settings!.storageIdentityKey,
+      b: store.b._settings!.storageIdentityKey,
+      c: store.c._settings!.storageIdentityKey
+    }
+  })
+
+  afterEach(async () => {
+    await setup.a.wallet.destroy()
+    await setup.b.wallet.destroy()
+    await setup.c.wallet.destroy()
+  })
+
+  test('0 cycle active over three new sqlite wallets', async () => {
+    const s = await _tu.createWalletOnly({
+      chain,
+      rootKeyHex,
+      active: store.a,
+      backups: [store.b, store.c]
+    })
+    let first: boolean = true
+    for (const active of [storeKey.b, storeKey.c, storeKey.a]) {
+      expect(s.storage.isAvailable() === true)
+      expect(s.storage.isActiveEnabled === !first)
+      const log = await s.storage.setActive(active)
+      logger(log)
+      expect(s.storage.getActiveStore()).toBe(active)
+      expect(s.storage.isActiveEnabled === true)
+      first = false
+    }
+  })
+
+  test.skip('1 setActive on main storage wallet with local backup', async () => {
+    const chain: sdk.Chain = 'main'
+    if (Setup.noEnv(chain)) return
+    const env = _tu.getEnv(chain)
+    if (!env.filePath) return
+
+    try {
+      const s = await _tu.createTestWallet({
+        chain,
+        rootKeyHex: env.devKeys[env.identityKey],
+        filePath: env.filePath,
+        setActiveClient: true,
+        addLocalBackup: false,
+        useMySQLConnectionForClient: true
+      })
+
+      {
+        const log = await s.storage.setActive(s.clientStorageIdentityKey!)
+        logger(log)
+      }
+      {
+        const log = await s.storage.setActive(s.localStorageIdentityKey!)
+        logger(log)
+      }
+      {
+        const log = await s.storage.setActive(s.clientStorageIdentityKey!)
+        logger(log)
+      }
+      expect(s.storage.isActiveEnabled)
+
+      await s.wallet.destroy()
+    } finally {
+      done1 = true
+    }
+  })
+
+  test.skip('2 setActive between two local backups', async () => {
+    await waitFor1()
+    try {
+      if (Setup.noEnv('main')) return
+      const env = _tu.getEnv('main')
+      const s = await _tu.createKnexTestWallet({
+        knex: _tu.createLocalSQLite(env.filePath!),
+        databaseName: `envFilePath for ${env.identityKey}`,
+        chain: env.chain
+      })
+      const envStorageIdentityKey = s.storage.getActiveStore()
+      const filePath = '/Users/tone/Kz/tone42_backup.sqlite'
+      const localStore = (
+        await _tu.createKnexTestWallet({
+          knex: _tu.createLocalSQLite(filePath),
+          databaseName: `sqlite for ${env.identityKey}`,
+          chain: env.chain
+        })
+      ).activeStorage
+      await s.storage.addWalletStorageProvider(localStore)
+      {
+        const log = await s.storage.setActive(envStorageIdentityKey)
+        logger(log)
+      }
+      {
+        const log = await s.storage.setActive(localStore._settings!.storageIdentityKey)
+        logger(log)
+      }
+      {
+        const log = await s.storage.setActive(envStorageIdentityKey)
+        logger(log)
+      }
+      expect(s.storage.isActiveEnabled)
+      await s.wallet.destroy()
+    } finally {
+      done2 = true
+    }
+  })
+
+  test.skip('3 compare wallet balances', async () => {
+    await waitFor2()
+    const chain: sdk.Chain = 'test'
+    if (Setup.noEnv(chain)) return
+
+    const s = await _tu.createTestWallet(chain)
+
+    await s.wallet.destroy()
+  })
+})

package/test/WalletClient/LocalKVStore.man.test.ts

@@ -0,0 +1,114 @@
+import { LocalKVStore, WalletClient } from '@bsv/sdk'
+import { Chain } from '../../src/sdk/types'
+import { createSetup, LocalWalletTestOptions } from '../utils/localWalletMethods'
+
+const chain: Chain = 'main'
+
+const options: LocalWalletTestOptions = {
+  setActiveClient: true,
+  useMySQLConnectionForClient: true,
+  useTestIdentityKey: false,
+  useIdentityKey2: false
+}
+
+describe('LocalKVStore tests', () => {
+  jest.setTimeout(99999999)
+
+  test('0 unencrypted Wallet', async () => {
+    const originator = 'wallet-toolbox.tests'
+    const setup = await createSetup(chain, options)
+    const { wallet } = setup
+
+    const basket = 'kvstoretest5'
+    const kv = new LocalKVStore(wallet, basket, false, originator)
+
+    const r1 = await kv.set('a', 'apple')
+    expect(r1).toBeTruthy() // the outpoint of the new stored value
+    const r1a = await kv.set('a', 'apple')
+    expect(r1a).toBe(r1) // same value must return same outpoint
+    const r2 = await kv.get('a')
+    expect(r2).toBe('apple')
+    const r3 = await kv.get('b', 'banana')
+    expect(r3).toBe('banana')
+    const r4 = await kv.remove('b')
+    expect(r4.length).toBe(0)
+    const r5 = await kv.remove('a')
+    expect(r5.length).toBe(1)
+    const lor = await wallet.listOutputs({ basket })
+    expect(lor.totalOutputs).toBe(0)
+
+    await wallet.destroy()
+  })
+
+  test('1 unencrypted Wallet', async () => {
+    const originator = 'wallet-toolbox.tests'
+    const setup = await createSetup(chain, options)
+    const { wallet } = setup
+
+    const basket = 'kvstoretest6'
+    const kv = new LocalKVStore(wallet, basket, true, originator)
+
+    const r1 = await kv.set('a', 'apple')
+    expect(r1).toBeTruthy() // the outpoint of the new stored value
+    const r1a = await kv.set('a', 'apple')
+    expect(r1a).toBe(r1) // same value must return same outpoint
+    const r2 = await kv.get('a')
+    expect(r2).toBe('apple')
+    const r3 = await kv.get('b', 'banana')
+    expect(r3).toBe('banana')
+    const r4 = await kv.remove('b')
+    expect(r4.length).toBe(0)
+    const r5 = await kv.remove('a')
+    expect(r5.length).toBe(1)
+    const lor = await wallet.listOutputs({ basket })
+    expect(lor.totalOutputs).toBe(0)
+
+    await wallet.destroy()
+  })
+
+  test('0a unencrypted WalletClient', async () => {
+    const originator = 'wallet-toolbox.tests'
+    const wallet = new WalletClient(undefined, originator)
+
+    const basket = 'kvstoretest7'
+    const kv = new LocalKVStore(wallet, basket, false, originator)
+
+    const r1 = await kv.set('a', 'apple')
+    expect(r1).toBeTruthy() // the outpoint of the new stored value
+    const r1a = await kv.set('a', 'apple')
+    expect(r1a).toBe(r1) // same value must return same outpoint
+    const r2 = await kv.get('a')
+    expect(r2).toBe('apple')
+    const r3 = await kv.get('b', 'banana')
+    expect(r3).toBe('banana')
+    const r4 = await kv.remove('b')
+    expect(r4.length).toBe(0)
+    const r5 = await kv.remove('a')
+    expect(r5.length).toBe(1)
+    const lor = await wallet.listOutputs({ basket })
+    expect(lor.totalOutputs).toBe(0)
+  })
+
+  test('1a unencrypted WalletClient', async () => {
+    const originator = 'wallet-toolbox.tests'
+    const wallet = new WalletClient(undefined, originator)
+
+    const basket = 'kvstoretest8'
+    const kv = new LocalKVStore(wallet, basket, true, originator)
+
+    const r1 = await kv.set('a', 'apple')
+    expect(r1).toBeTruthy() // the outpoint of the new stored value
+    const r1a = await kv.set('a', 'apple')
+    expect(r1a).toBe(r1) // same value must return same outpoint
+    const r2 = await kv.get('a')
+    expect(r2).toBe('apple')
+    const r3 = await kv.get('b', 'banana')
+    expect(r3).toBe('banana')
+    const r4 = await kv.remove('b')
+    expect(r4.length).toBe(0)
+    const r5 = await kv.remove('a')
+    expect(r5.length).toBe(1)
+    const lor = await wallet.listOutputs({ basket })
+    expect(lor.totalOutputs).toBe(0)
+  })
+})

package/test/WalletClient/WERR.man.test.ts

@@ -0,0 +1,35 @@
+import { Validation as V, CreateActionArgs, WalletClient } from '@bsv/sdk'
+import { specOpThrowReviewActions } from '../../src/sdk/types'
+import { WalletError } from '../../src/sdk/WalletError'
+import { WERR_REVIEW_ACTIONS } from '../../src/sdk/WERR_errors'
+import { WalletErrorFromJson } from '../../src/sdk'
+
+describe('WERR.man tests', () => {
+  jest.setTimeout(99999999)
+
+  test('0 WERR_REVIEW_ACTIONS via WalletClient', async () => {
+    const wallet = new WalletClient('auto', '0.WERR.man.test')
+
+    const args: CreateActionArgs = {
+      labels: [specOpThrowReviewActions],
+      description: 'must throw'
+    }
+    const vargs = V.validateCreateActionArgs(args)
+
+    try {
+      const r = await wallet.createAction(args)
+      expect(true).toBe(false)
+    } catch (eu: unknown) {
+      const e = WalletError.fromUnknown(eu) as WERR_REVIEW_ACTIONS
+      expect(e.code).toBe('WERR_REVIEW_ACTIONS')
+      expect(e.reviewActionResults).toBeTruthy()
+    }
+  })
+
+  test('1', async () => {
+    const s = `{\"isError\":true,\"name\":\"WERR_REVIEW_ACTIONS\",\"reviewActionResults\":[{\"txid\":\"344556f1c428367689e09e29aa4dc7cfe755db1fab5cf7c1cf8d1f99b507004b\",\"status\":\"doubleSpend\",\"competingTxs\":[\"344556f1c428367689e09e29aa4dc7cfe755db1fab5cf7c1cf8d1f99b507004b\"],\"competingBeef\":[1,0,190,239,1,254,12,52,25,0,3,2,2,2,13,153,15,202,45,179,254,102,34,161,222,144,207,214,224,219,57,76,176,248,213,137,238,7,63,67,204,253,45,62,70,190,3,0,206,69,142,120,152,200,85,221,140,68,16,34,144,39,29,181,67,66,245,76,24,46,209,253,246,204,133,193,175,188,98,241,2,0,0,119,165,81,236,153,173,143,252,69,138,209,229,97,189,36,123,84,160,234,127,63,185,82,5,26,106,157,73,26,107,32,100,1,0,143,243,215,201,227,2,63,39,103,57,216,42,131,190,76,56,216,43,104,59,7,4,174,137,191,49,49,128,249,252,45,42,2,0,0,25,6,223,99,50,23,119,231,67,155,160,205,224,45,74,194,190,202,18,106,135,17,234,165,66,245,89,135,90,255,10,227,1,0,35,96,209,29,146,83,58,174,231,36,40,57,137,94,136,75,149,86,89,160,195,121,92,180,37,191,31,187,23,71,219,209,2,1,0,0,0,2,1,247,147,92,34,59,244,55,220,70,138,231,75,160,174,137,68,202,34,151,142,102,170,47,246,106,0,25,152,90,245,197,0,0,0,0,106,71,48,68,2,32,23,143,242,5,200,252,85,12,167,137,194,54,96,107,40,141,240,219,145,62,182,133,119,224,94,146,94,249,214,213,212,121,2,32,15,130,24,137,152,12,86,54,141,67,39,178,80,29,110,48,77,114,212,69,237,139,89,152,246,124,138,91,19,32,71,43,65,33,3,16,229,154,223,195,210,19,58,106,26,124,66,99,139,137,43,164,213,109,60,35,235,32,30,122,36,252,12,131,190,69,63,255,255,255,255,1,247,147,92,34,59,244,55,220,70,138,231,75,160,174,137,68,202,34,151,142,102,170,47,246,106,0,25,152,90,245,197,2,0,0,0,107,72,48,69,2,33,0,154,55,50,224,237,75,147,58,95,164,173,104,149,13,24,125,198,35,126,194,134,91,150,238,179,25,192,213,136,196,51,66,2,32,98,84,153,139,248,106,241,122,65,180,241,124,30,233,140,74,172,74,217,165,129,143,127,156,49,230,34,46,188,15,28,52,65,33,2,146,89,63,53,57,196,48,37,118,17,182,193,201,75,44,105,67,181,136,23,25,104,127,48,146,231,88,99,197,53,56,239,255,255,255,255,2,225,3,0,0,0,0,0,0,25,118,169,20,255,161,196,19,38,201,6,21,136,26,207,151,137,162,75,232,58,201,53,88,136,172,1,0,0,0,0,0,0,0,25,118,169,20,39,140,42,205,54,197,3,247,165,173,16,224,138,193,127,34,191,29,126,7,136,172,0,0,0,0,1,0,1,0,0,0,1,13,153,15,202,45,179,254,102,34,161,222,144,207,214,224,219,57,76,176,248,213,137,238,7,63,67,204,253,45,62,70,190,0,0,0,0,106,71,48,68,2,32,113,14,233,125,141,249,154,234,138,195,178,164,149,171,255,63,165,28,128,191,230,247,66,128,150,223,65,199,233,39,23,251,2,32,80,77,229,88,242,236,59,27,87,164,79,120,131,240,100,247,182,28,231,200,43,86,4,88,118,214,123,86,89,234,15,220,65,33,2,126,31,155,113,109,251,248,50,61,159,13,216,133,12,125,72,157,20,95,38,54,244,202,14,140,141,176,184,127,210,62,36,255,255,255,255,3,42,0,0,0,0,0,0,0,25,118,169,20,56,12,202,72,139,24,243,136,130,254,20,130,110,109,96,207,112,30,168,123,136,172,1,0,0,0,0,0,0,0,25,118,169,20,70,66,47,177,97,74,57,246,237,66,211,206,113,253,228,175,14,128,182,53,136,172,181,3,0,0,0,0,0,0,25,118,169,20,168,166,193,185,78,43,31,133,215,58,172,227,98,32,56,171,116,85,185,171,136,172,0,0,0,0,0]}],\"sendWithResults\":[{\"txid\":\"344556f1c428367689e09e29aa4dc7cfe755db1fab5cf7c1cf8d1f99b507004b\",\"status\":\"failed\"}],\"txid\":\"344556f1c428367689e09e29aa4dc7cfe755db1fab5cf7c1cf8d1f99b507004b\",\"tx\":[1,1,1,1,75,0,7,181,153,31,141,207,193,247,92,171,31,219,85,231,207,199,77,170,41,158,224,137,118,54,40,196,241,86,69,52,1,0,190,239,1,254,12,52,25,0,3,2,2,2,13,153,15,202,45,179,254,102,34,161,222,144,207,214,224,219,57,76,176,248,213,137,238,7,63,67,204,253,45,62,70,190,3,0,206,69,142,120,152,200,85,221,140,68,16,34,144,39,29,181,67,66,245,76,24,46,209,253,246,204,133,193,175,188,98,241,2,0,0,119,165,81,236,153,173,143,252,69,138,209,229,97,189,36,123,84,160,234,127,63,185,82,5,26,106,157,73,26,107,32,100,1,0,143,243,215,201,227,2,63,39,103,57,216,42,131,190,76,56,216,43,104,59,7,4,174,137,191,49,49,128,249,252,45,42,2,0,0,25,6,223,99,50,23,119,231,67,155,160,205,224,45,74,194,190,202,18,106,135,17,234,165,66,245,89,135,90,255,10,227,1,0,35,96,209,29,146,83,58,174,231,36,40,57,137,94,136,75,149,86,89,160,195,121,92,180,37,191,31,187,23,71,219,209,2,1,0,0,0,2,1,247,147,92,34,59,244,55,220,70,138,231,75,160,174,137,68,202,34,151,142,102,170,47,246,106,0,25,152,90,245,197,0,0,0,0,106,71,48,68,2,32,23,143,242,5,200,252,85,12,167,137,194,54,96,107,40,141,240,219,145,62,182,133,119,224,94,146,94,249,214,213,212,121,2,32,15,130,24,137,152,12,86,54,141,67,39,178,80,29,110,48,77,114,212,69,237,139,89,152,246,124,138,91,19,32,71,43,65,33,3,16,229,154,223,195,210,19,58,106,26,124,66,99,139,137,43,164,213,109,60,35,235,32,30,122,36,252,12,131,190,69,63,255,255,255,255,1,247,147,92,34,59,244,55,220,70,138,231,75,160,174,137,68,202,34,151,142,102,170,47,246,106,0,25,152,90,245,197,2,0,0,0,107,72,48,69,2,33,0,154,55,50,224,237,75,147,58,95,164,173,104,149,13,24,125,198,35,126,194,134,91,150,238,179,25,192,213,136,196,51,66,2,32,98,84,153,139,248,106,241,122,65,180,241,124,30,233,140,74,172,74,217,165,129,143,127,156,49,230,34,46,188,15,28,52,65,33,2,146,89,63,53,57,196,48,37,118,17,182,193,201,75,44,105,67,181,136,23,25,104,127,48,146,231,88,99,197,53,56,239,255,255,255,255,2,225,3,0,0,0,0,0,0,25,118,169,20,255,161,196,19,38,201,6,21,136,26,207,151,137,162,75,232,58,201,53,88,136,172,1,0,0,0,0,0,0,0,25,118,169,20,39,140,42,205,54,197,3,247,165,173,16,224,138,193,127,34,191,29,126,7,136,172,0,0,0,0,1,0,1,0,0,0,1,13,153,15,202,45,179,254,102,34,161,222,144,207,214,224,219,57,76,176,248,213,137,238,7,63,67,204,253,45,62,70,190,0,0,0,0,106,71,48,68,2,32,113,14,233,125,141,249,154,234,138,195,178,164,149,171,255,63,165,28,128,191,230,247,66,128,150,223,65,199,233,39,23,251,2,32,80,77,229,88,242,236,59,27,87,164,79,120,131,240,100,247,182,28,231,200,43,86,4,88,118,214,123,86,89,234,15,220,65,33,2,126,31,155,113,109,251,248,50,61,159,13,216,133,12,125,72,157,20,95,38,54,244,202,14,140,141,176,184,127,210,62,36,255,255,255,255,3,42,0,0,0,0,0,0,0,25,118,169,20,56,12,202,72,139,24,243,136,130,254,20,130,110,109,96,207,112,30,168,123,136,172,1,0,0,0,0,0,0,0,25,118,169,20,70,66,47,177,97,74,57,246,237,66,211,206,113,253,228,175,14,128,182,53,136,172,181,3,0,0,0,0,0,0,25,118,169,20,168,166,193,185,78,43,31,133,215,58,172,227,98,32,56,171,116,85,185,171,136,172,0,0,0,0,0],\"noSendChange\":[\"344556f1c428367689e09e29aa4dc7cfe755db1fab5cf7c1cf8d1f99b507004b.0\"]}`
+    const o = JSON.parse(s)
+    const e = WalletErrorFromJson(o)
+    expect(e instanceof WERR_REVIEW_ACTIONS).toBe(true)
+  })
+})

package/test/bsv-ts-sdk/LocalKVStore.test.ts

@@ -0,0 +1,102 @@
+import { _tu, logger, TestWalletNoSetup } from '../utils/TestUtilsWalletStorage'
+import { LocalKVStore } from '@bsv/sdk'
+
+const includeTestChaintracks = false
+
+describe('LocalKVStore tests', () => {
+  jest.setTimeout(99999999)
+
+  const testName = () => expect.getState().currentTestName || 'test'
+  let ctxs: TestWalletNoSetup[] = []
+  const context = 'test kv store'
+  const key1 = 'key1'
+  const key2 = 'key2'
+
+  beforeEach(async () => {
+    ctxs = [await _tu.createLegacyWalletSQLiteCopy(`${testName()}`)]
+  })
+
+  afterEach(async () => {
+    for (const ctx of ctxs) {
+      await ctx.storage.destroy()
+    }
+  })
+
+  test('0 get non-existent', async () => {
+    for (const { storage, wallet } of ctxs) {
+      const kvStore = new LocalKVStore(wallet, context, false, undefined, true)
+      const value = await kvStore.get(key1)
+      expect(value).toBeUndefined()
+    }
+  })
+
+  test('1 set get', async () => {
+    if (!includeTestChaintracks) return
+    for (const { storage, wallet } of ctxs) {
+      const kvStore = new LocalKVStore(wallet, context, false, undefined, true)
+      await kvStore.set(key1, 'value1')
+      const value = await kvStore.get(key1)
+      expect(value).toBe('value1')
+    }
+  })
+
+  test('3 set x 4 get', async () => {
+    if (!includeTestChaintracks) return
+    for (const { storage, wallet } of ctxs) {
+      const kvStore = new LocalKVStore(wallet, context, false, undefined, true)
+      const promises = [
+        kvStore.set(key1, 'value1'),
+        kvStore.set(key1, 'value2'),
+        kvStore.set(key1, 'value3'),
+        kvStore.set(key1, 'value4')
+      ]
+      await Promise.all(promises)
+      const value = await kvStore.get(key1)
+      expect(value).toBe('value4')
+    }
+  })
+
+  test('4 promise test', async () => {
+    jest.useFakeTimers()
+    let resolveNewLock: () => void = () => {}
+    const newLock = new Promise<void>(resolve => {
+      resolveNewLock = resolve
+    })
+    const t = Date.now()
+    setTimeout(() => {
+      resolveNewLock()
+    }, 1000)
+    jest.advanceTimersByTime(1000)
+    await newLock
+    const elapsed = Date.now() - t
+    logger(`Elapsed time: ${elapsed} ms`)
+    expect(elapsed).toBeGreaterThanOrEqual(1000)
+    jest.useRealTimers()
+  })
+
+  test('5 set x 4 get set x 4 get', async () => {
+    if (!includeTestChaintracks) return
+    for (const { storage, wallet } of ctxs) {
+      const kvStore = new LocalKVStore(wallet, context, false, undefined, true)
+      let v4: string | undefined
+      async function captureValue(): Promise<void> {
+        v4 = await kvStore.get(key1)
+      }
+      const promises = [
+        kvStore.set(key1, 'value1'),
+        kvStore.set(key1, 'value2'),
+        kvStore.set(key1, 'value3'),
+        kvStore.set(key1, 'value4'),
+        captureValue(),
+        kvStore.set(key1, 'value5'),
+        kvStore.set(key1, 'value6'),
+        kvStore.set(key1, 'value7'),
+        kvStore.set(key1, 'value8')
+      ]
+      await Promise.all(promises)
+      const v8 = await kvStore.get(key1)
+      expect(v4).toBe('value4')
+      expect(v8).toBe('value8')
+    }
+  })
+})

package/test/checkDB.ts

@@ -0,0 +1,57 @@
+const sqlite3 = require('sqlite3').verbose()
+
+const dbPath = 'test/data/tmp/updatetest.sqlite' // Path to your SQLite database file
+
+const runTest = async () => {
+  // Open the database
+  const db = new sqlite3.Database(dbPath, err => {
+    if (err) {
+      console.error('Error opening database:', err.message)
+      process.exit(1)
+    }
+    console.log(`Connected to the SQLite database at ${dbPath}`)
+  })
+
+  // Check if foreign key enforcement is enabled
+  db.get('PRAGMA foreign_keys;', (err, row) => {
+    if (err) {
+      console.error('Error running PRAGMA foreign_keys:', err.message)
+    } else {
+      console.log('Foreign key enforcement:', row.foreign_keys === 1 ? 'Enabled' : 'Disabled')
+    }
+  })
+
+  // List foreign key constraints for a specific table
+  const tables = ['certificates', 'commissions', 'output_baskets', 'outputs']
+  for (const table of tables) {
+    db.all(`PRAGMA foreign_key_list('${table}');`, (err, rows) => {
+      if (err) {
+        console.error(`Error querying foreign key list for table '${table}':`, err.message)
+      } else {
+        console.log(`Foreign key constraints for table '${table}':`)
+        if (rows.length === 0) {
+          console.log('  No foreign key constraints defined.')
+        } else {
+          rows.forEach(fk => {
+            console.log(
+              `  Column '${fk.from}' references '${fk.table}(${fk.to})' ` +
+                `ON UPDATE ${fk.on_update} ON DELETE ${fk.on_delete}`
+            )
+          })
+        }
+      }
+    })
+  }
+
+  // Close the database
+  db.close(err => {
+    if (err) {
+      console.error('Error closing database:', err.message)
+    } else {
+      console.log('Database connection closed.')
+    }
+  })
+}
+
+// Run the test
+runTest()