@bsv/wallet-toolbox 1.3.2 → 1.3.4

package/src/storage/methods/listOutputsIdb.ts

@@ -0,0 +1,199 @@
+import { Beef, ListOutputsResult, OriginatorDomainNameStringUnder250Bytes, WalletOutput } from '@bsv/sdk'
+import { TableOutput, TableOutputBasket, TableOutputTag } from '../index.client'
+import { asString, sdk, verifyId, verifyOne } from '../../index.client'
+import { getBasketToSpecOp, ListOutputsSpecOp } from './ListOutputsSpecOp'
+import { StorageIdb } from '../StorageIdb'
+import { TransactionStatus } from '../../sdk'
+
+export async function listOutputsIdb(
+  storage: StorageIdb,
+  auth: sdk.AuthId,
+  vargs: sdk.ValidListOutputsArgs,
+  originator?: OriginatorDomainNameStringUnder250Bytes
+): Promise<ListOutputsResult> {
+  const userId = verifyId(auth.userId)
+  const limit = vargs.limit
+  const offset = vargs.offset
+
+  const r: ListOutputsResult = {
+    totalOutputs: 0,
+    outputs: []
+  }
+
+  /*
+        ListOutputsArgs {
+            basket: BasketStringUnder300Bytes
+
+            tags?: OutputTagStringUnder300Bytes[]
+            tagQueryMode?: 'all' | 'any' // default any
+
+            limit?: PositiveIntegerDefault10Max10000
+            offset?: PositiveIntegerOrZero
+        }
+    */
+
+  let specOp: ListOutputsSpecOp | undefined = undefined
+  let basketId: number | undefined = undefined
+  const basketsById: Record<number, TableOutputBasket> = {}
+  if (vargs.basket) {
+    let b = vargs.basket
+    specOp = getBasketToSpecOp()[b]
+    b = specOp ? (specOp.useBasket ? specOp.useBasket : '') : b
+    if (b) {
+      const baskets = await storage.findOutputBaskets({
+        partial: { userId, name: b }
+      })
+      if (baskets.length !== 1) {
+        // If basket does not exist, result is no outputs.
+        return r
+      }
+      const basket = baskets[0]
+      basketId = basket.basketId!
+      basketsById[basketId!] = basket
+    }
+  }
+
+  let tags = [...vargs.tags]
+  const specOpTags: string[] = []
+  if (specOp && specOp.tagsParamsCount) {
+    specOpTags.push(...tags.splice(0, Math.min(tags.length, specOp.tagsParamsCount)))
+  }
+  if (specOp && specOp.tagsToIntercept) {
+    // Pull out tags used by current specOp
+    const ts = tags
+    tags = []
+    for (const t of ts) {
+      if (specOp.tagsToIntercept.length === 0 || specOp.tagsToIntercept.indexOf(t) >= 0) {
+        specOpTags.push(t)
+        if (t === 'all') {
+          basketId = undefined
+        }
+      } else {
+        tags.push(t)
+      }
+    }
+  }
+
+  if (specOp && specOp.resultFromTags) {
+    const r = await specOp.resultFromTags(storage, auth, vargs, specOpTags)
+    return r
+  }
+
+  let tagIds: number[] = []
+  if (tags && tags.length > 0) {
+    await storage.filterOutputTags({ partial: { userId, isDeleted: false } }, ot => {
+      if (tags.includes(ot.tag)) {
+        tagIds.push(ot.outputTagId)
+      }
+    })
+  }
+
+  const isQueryModeAll = vargs.tagQueryMode === 'all'
+  if (isQueryModeAll && tagIds.length < tags.length)
+    // all the required tags don't exist, impossible to satisfy.
+    return r
+
+  if (!isQueryModeAll && tagIds.length === 0 && tags.length > 0)
+    // any and only non-existing labels, impossible to satisfy.
+    return r
+
+  const noTags = tagIds.length === 0
+  const includeSpent = false
+
+  const stati: TransactionStatus[] = ['completed', 'unproven', 'nosend']
+
+  const args: sdk.FindOutputsArgs = {
+    partial: {
+      userId,
+      basketId,
+      spendable: !includeSpent ? true : undefined
+    },
+    txStatus: stati,
+    noScript: true
+  }
+  if (!specOp || !specOp.ignoreLimit) args.paged = { limit, offset }
+
+  let outputs = await storage.findOutputs(args, tagIds, isQueryModeAll)
+  if (outputs.length === vargs.limit) {
+    args.paged = undefined
+    r.totalOutputs = await storage.countOutputs(args, tagIds, isQueryModeAll)
+  } else {
+    r.totalOutputs = outputs.length
+  }
+
+  if (specOp) {
+    if (specOp.filterOutputs) outputs = await specOp.filterOutputs(storage, auth, vargs, specOpTags, outputs)
+    if (specOp.resultFromOutputs) {
+      const r = await specOp.resultFromOutputs(storage, auth, vargs, specOpTags, outputs)
+      return r
+    }
+  }
+
+  /*
+        ListOutputsArgs {
+            include?: 'locking scripts' | 'entire transactions'
+            includeCustomInstructions?: BooleanDefaultFalse
+            includeTags?: BooleanDefaultFalse
+            includeLabels?: BooleanDefaultFalse
+        }
+
+        ListOutputsResult {
+            totalOutputs: PositiveIntegerOrZero
+            BEEF?: BEEF
+            outputs: Array<WalletOutput>
+        }
+
+        WalletOutput {
+            satoshis: SatoshiValue
+            spendable: boolean
+            outpoint: OutpointString
+
+            customInstructions?: string
+            lockingScript?: HexString
+            tags?: OutputTagStringUnder300Bytes[]
+            labels?: LabelStringUnder300Bytes[]
+        }
+    */
+
+  const labelsByTxid: Record<string, string[]> = {}
+
+  const beef = new Beef()
+
+  for (const o of outputs) {
+    const wo: WalletOutput = {
+      satoshis: Number(o.satoshis),
+      spendable: !!o.spendable,
+      outpoint: `${o.txid}.${o.vout}`
+    }
+    r.outputs.push(wo)
+    //if (vargs.includeBasket && o.basketId) {
+    //    if (!basketsById[o.basketId]) {
+    //        basketsById[o.basketId] = verifyTruthy(await dsk.findOutputBasketId(o.basketId!, trx))
+    //    }
+    //    wo.basket = basketsById[o.basketId].name
+    //}
+    if (vargs.includeCustomInstructions && o.customInstructions) wo.customInstructions = o.customInstructions
+    if (vargs.includeLabels && o.txid) {
+      if (labelsByTxid[o.txid] === undefined) {
+        labelsByTxid[o.txid] = (await storage.getLabelsForTransactionId(o.transactionId)).map(l => l.label)
+      }
+      wo.labels = labelsByTxid[o.txid]
+    }
+    if (vargs.includeTags) {
+      wo.tags = (await storage.getTagsForOutputId(o.outputId)).map(t => t.tag)
+    }
+    if (vargs.includeLockingScripts) {
+      await storage.validateOutputScript(o)
+      if (o.lockingScript) wo.lockingScript = asString(o.lockingScript)
+    }
+    if (vargs.includeTransactions && !beef.findTxid(o.txid!)) {
+      await storage.getValidBeefForKnownTxid(o.txid!, beef, undefined, vargs.knownTxids)
+    }
+  }
+
+  if (vargs.includeTransactions) {
+    r.BEEF = beef.toBinary()
+  }
+
+  return r
+}

package/src/storage/methods/{listOutputs.ts → listOutputsKnex.ts}

@@ -2,137 +2,7 @@ import { Beef, ListOutputsResult, OriginatorDomainNameStringUnder250Bytes, Walle
 import { TableOutput, TableOutputBasket, TableOutputTag } from '../index.client'
 import { asString, sdk, verifyId, verifyInteger, verifyOne } from '../../index.client'
 import { StorageKnex } from '../StorageKnex'
-import { ValidListOutputsArgs } from '../../sdk'
-import { spec } from 'node:test/reporters'
-
-interface ListOutputsSpecOp {
-  name: string
-  useBasket?: string
-  ignoreLimit?: boolean
-  includeSpent?: boolean
-  includeOutputScripts?: boolean
-  resultFromTags?: (
-    s: StorageKnex,
-    auth: sdk.AuthId,
-    vargs: ValidListOutputsArgs,
-    specOpTags: string[]
-  ) => Promise<ListOutputsResult>
-  resultFromOutputs?: (
-    s: StorageKnex,
-    auth: sdk.AuthId,
-    vargs: ValidListOutputsArgs,
-    specOpTags: string[],
-    outputs: TableOutput[]
-  ) => Promise<ListOutputsResult>
-  filterOutputs?: (
-    s: StorageKnex,
-    auth: sdk.AuthId,
-    vargs: ValidListOutputsArgs,
-    specOpTags: string[],
-    outputs: TableOutput[]
-  ) => Promise<TableOutput[]>
-  /**
-   * undefined to intercept no tags from vargs,
-   * empty array to intercept all tags,
-   * or an explicit array of tags to intercept.
-   */
-  tagsToIntercept?: string[]
-  /**
-   * How many positional tags to intercept.
-   */
-  tagsParamsCount?: number
-}
-
-const basketToSpecOp: Record<string, ListOutputsSpecOp> = {
-  [sdk.specOpWalletBalance]: {
-    name: 'totalOutputsIsWalletBalance',
-    useBasket: 'default',
-    ignoreLimit: true,
-    resultFromOutputs: async (
-      s: StorageKnex,
-      auth: sdk.AuthId,
-      vargs: ValidListOutputsArgs,
-      specOpTags: string[],
-      outputs: TableOutput[]
-    ): Promise<ListOutputsResult> => {
-      let totalOutputs = 0
-      for (const o of outputs) totalOutputs += o.satoshis
-      return { totalOutputs, outputs: [] }
-    }
-  },
-  [sdk.specOpInvalidChange]: {
-    name: 'invalidChangeOutputs',
-    useBasket: 'default',
-    ignoreLimit: true,
-    includeSpent: false,
-    includeOutputScripts: true,
-    tagsToIntercept: ['release', 'all'],
-    filterOutputs: async (
-      s: StorageKnex,
-      auth: sdk.AuthId,
-      vargs: ValidListOutputsArgs,
-      specOpTags: string[],
-      outputs: TableOutput[]
-    ): Promise<TableOutput[]> => {
-      const updateToSpent: TableOutput[] = []
-      const updateToSpendable: TableOutput[] = []
-      const services = s.getServices()
-      for (const o of outputs) {
-        await s.validateOutputScript(o)
-        let ok: boolean | undefined = false
-        let r: sdk.GetUtxoStatusResult
-        if (o.lockingScript && o.lockingScript.length > 0) {
-          const hash = services.hashOutputScript(asString(o.lockingScript))
-          r = await services.getUtxoStatus(hash, undefined, `${o.txid}.${o.vout}`)
-          ok = r.isUtxo
-        } else {
-          ok = undefined
-        }
-        if (ok === false && o.spendable) {
-          updateToSpent.push(o)
-        } else if (ok === true && !o.spendable) {
-          updateToSpendable.push(o)
-        }
-      }
-      if (specOpTags.indexOf('release') >= 0) {
-        for (const o of updateToSpent) {
-          await s.updateOutput(o.outputId, { spendable: false })
-          o.spendable = false
-        }
-        for (const o of updateToSpendable) {
-          await s.updateOutput(o.outputId, { spendable: true })
-          o.spendable = true
-        }
-      }
-      return updateToSpent.concat(updateToSpendable)
-    }
-  },
-  [sdk.specOpSetWalletChangeParams]: {
-    name: 'setWalletChangeParams',
-    tagsParamsCount: 2,
-    resultFromTags: async (
-      s: StorageKnex,
-      auth: sdk.AuthId,
-      vargs: ValidListOutputsArgs,
-      specOpTags: string[]
-    ): Promise<ListOutputsResult> => {
-      if (specOpTags.length !== 2)
-        throw new sdk.WERR_INVALID_PARAMETER('numberOfDesiredUTXOs and minimumDesiredUTXOValue', 'valid')
-      const numberOfDesiredUTXOs: number = verifyInteger(Number(specOpTags[0]))
-      const minimumDesiredUTXOValue: number = verifyInteger(Number(specOpTags[1]))
-      const basket = verifyOne(
-        await s.findOutputBaskets({
-          partial: { userId: verifyId(auth.userId), name: 'default' }
-        })
-      )
-      await s.updateOutputBasket(basket.basketId, {
-        numberOfDesiredUTXOs,
-        minimumDesiredUTXOValue
-      })
-      return { totalOutputs: 0, outputs: [] }
-    }
-  }
-}
+import { getBasketToSpecOp, ListOutputsSpecOp } from './ListOutputsSpecOp'
 
 export async function listOutputs(
   dsk: StorageKnex,
@@ -169,7 +39,7 @@ export async function listOutputs(
   const basketsById: Record<number, TableOutputBasket> = {}
   if (vargs.basket) {
     let b = vargs.basket
-    specOp = basketToSpecOp[b]
+    specOp = getBasketToSpecOp()[b]
     b = specOp ? (specOp.useBasket ? specOp.useBasket : '') : b
     if (b) {
       const baskets = await dsk.findOutputBaskets({
@@ -227,7 +97,13 @@ export async function listOutputs(
   }
 
   const isQueryModeAll = vargs.tagQueryMode === 'all'
-  if (isQueryModeAll && tagIds.length < tags.length) return r
+  if (isQueryModeAll && tagIds.length < tags.length)
+    // all the required tags don't exist, impossible to satisfy.
+    return r
+
+  if (!isQueryModeAll && tagIds.length === 0 && tags.length > 0)
+    // any and only non-existing labels, impossible to satisfy.
+    return r
 
   const columns: string[] = [
     'outputId',

package/src/storage/methods/purgeDataIdb.ts

@@ -0,0 +1,15 @@
+import { Beef } from '@bsv/sdk'
+import { Knex } from 'knex'
+import { TableCommission, TableOutput, TableOutputTagMap, TableTransaction, TableTxLabelMap } from '../index.client'
+import { sdk } from '../../index.client'
+import { StorageIdb } from '../StorageIdb'
+
+export async function purgeDataIdb(
+  storage: StorageIdb,
+  params: sdk.PurgeParams,
+  trx?: sdk.TrxToken
+): Promise<sdk.PurgeResults> {
+  const r: sdk.PurgeResults = { count: 0, log: '' }
+  // TODO: implement purgeDataIdb
+  return r
+}

package/src/storage/methods/reviewStatus.ts

@@ -4,6 +4,17 @@ import { TableOutput, TableTransaction } from '../index.client'
 import { sdk } from '../../index.client'
 import { StorageKnex } from '../StorageKnex'
 
+/**
+ * Looks for unpropagated state:
+ *
+ * 1. set transactions to 'failed' if not already failed and provenTxReq with matching txid has status of 'invalid'.
+ * 2. sets outputs to spendable true, spentBy undefined if spentBy is a transaction with status 'failed'.
+ * 3. sets transactions to 'completed' if provenTx with matching txid exists and current provenTxId is null.
+ *
+ * @param storage
+ * @param args
+ * @returns
+ */
 export async function reviewStatus(
   storage: StorageKnex,
   args: { agedLimit: Date; trx?: sdk.TrxToken }

package/src/storage/methods/reviewStatusIdb.ts

@@ -0,0 +1,43 @@
+import { Beef } from '@bsv/sdk'
+import { Knex } from 'knex'
+import { TableOutput, TableTransaction } from '../index.client'
+import { sdk } from '../../index.client'
+import { StorageIdb } from '../StorageIdb'
+
+/**
+ * Looks for unpropagated state:
+ *
+ * 1. set transactions to 'failed' if not already failed and provenTxReq with matching txid has status of 'invalid'.
+ * 2. sets transactions to 'completed' if provenTx with matching txid exists and current provenTxId is null.
+ * 3. sets outputs to spendable true, spentBy undefined if spentBy is a transaction with status 'failed'.
+ *
+ * @param storage
+ * @param args
+ * @returns
+ */
+export async function reviewStatusIdb(
+  storage: StorageIdb,
+  args: { agedLimit: Date; trx?: sdk.TrxToken }
+): Promise<{ log: string }> {
+  const r: { log: string } = { log: '' }
+
+  // 1. set transactions to 'failed' if not already failed and provenTxReq with matching txid has status of 'invalid'.
+  const invalidTxids: string[] = []
+  await storage.filterProvenTxReqs({ partial: { status: 'invalid' } }, txReq => {
+    invalidTxids.push(txReq.txid)
+  })
+  for (const txid of invalidTxids) {
+    const txs = await storage.findTransactions({ partial: { txid } })
+    for (const tx of txs) {
+      if (tx.status !== 'failed') {
+        r.log += `transaction ${tx.transactionId} updated to status of 'failed' was ${tx.status}\n`
+        await storage.updateTransactionStatus('failed', tx.transactionId)
+      }
+    }
+  }
+
+  // 2. sets transactions to 'completed' if provenTx with matching txid exists and current provenTxId is null.
+  // 3. sets outputs to spendable true, spentBy undefined if spentBy is a transaction with status 'failed'.
+
+  return r
+}

package/src/storage/schema/StorageIdbSchema.ts

@@ -0,0 +1,150 @@
+import { Base64String, PubKeyHex, HexString } from '@bsv/sdk'
+import { ProvenTxReqStatus, SyncStatus, TransactionStatus } from '../../sdk'
+import {
+  TableCertificate,
+  TableCertificateField,
+  TableCommission,
+  TableMonitorEvent,
+  TableOutput,
+  TableOutputBasket,
+  TableOutputTag,
+  TableOutputTagMap,
+  TableProvenTx,
+  TableProvenTxReq,
+  TableSyncState,
+  TableSettings,
+  TableTransaction,
+  TableTxLabel,
+  TableTxLabelMap,
+  TableUser
+} from '../index.client'
+
+export interface StorageIdbSchema {
+  certificates: {
+    key: number
+    value: TableCertificate
+    indexes: {
+      userId: number
+      userId_type_certifier_serialNumber: [number, Base64String, PubKeyHex, Base64String]
+    }
+  }
+  certificateFields: {
+    key: number
+    value: TableCertificateField
+    indexes: {
+      userId: number
+      certificateId: number
+    }
+  }
+  commissions: {
+    key: number
+    value: TableCommission
+    indexes: {
+      userId: number
+      transactionId: number
+    }
+  }
+  monitorEvents: {
+    key: number
+    value: TableMonitorEvent
+  }
+  outputs: {
+    key: number
+    value: TableOutput
+    indexes: {
+      userId: number
+      transactionId: number
+      basketId: number
+      spentBy: string
+      transactionId_vout_userId: [number, number, number]
+    }
+  }
+  outputBaskets: {
+    key: number
+    value: TableOutputBasket
+    indexes: {
+      userId: number
+      name_userId: [string, number]
+    }
+  }
+  outputTags: {
+    key: number
+    value: TableOutputTag
+    indexes: {
+      userId: number
+      tag_userId: [string, number]
+    }
+  }
+  outputTagMaps: {
+    key: number
+    value: TableOutputTagMap
+    indexes: {
+      outputTagId: number
+      outputId: number
+    }
+  }
+  provenTxs: {
+    key: number
+    value: TableProvenTx
+    indexes: {
+      txid: HexString
+    }
+  }
+  provenTxReqs: {
+    key: number
+    value: TableProvenTxReq
+    indexes: {
+      provenTxId: number
+      txid: HexString
+      status: ProvenTxReqStatus
+      batch: string
+    }
+  }
+  syncStates: {
+    key: number
+    value: TableSyncState
+    indexes: {
+      userId: number
+      refNum: string
+      status: SyncStatus
+    }
+  }
+  settings: {
+    key: number
+    value: TableSettings
+    indexes: Record<string, never>
+  }
+  transactions: {
+    key: number
+    value: TableTransaction
+    indexes: {
+      userId: number
+      provenTxId: number
+      reference: string
+      status: TransactionStatus
+    }
+  }
+  txLabels: {
+    key: number
+    value: TableTxLabel
+    indexes: {
+      userId: number
+      label_userId: [string, number]
+    }
+  }
+  txLabelMaps: {
+    key: number
+    value: TableTxLabelMap
+    indexes: {
+      transactionId: number
+      txLabelId: number
+    }
+  }
+  users: {
+    key: number
+    value: TableUser
+    indexes: {
+      identityKey: string
+    }
+  }
+}

package/src/storage/schema/entities/__tests/ProvenTxTests.test.ts

@@ -109,6 +109,8 @@ describe('ProvenTx class method tests', () => {
         results: []
       }),
 
+      isUtxo: async () => true,
+
       getUtxoStatus: async () => ({
         name: 'mock-service',
         status: 'success',

package/src/storage/schema/tables/TableSettings.ts

@@ -12,6 +12,6 @@ export interface TableSettings extends sdk.StorageIdentity, sdk.EntityTimeStamp
    */
   storageName: string
   chain: sdk.Chain
-  dbtype: 'SQLite' | 'MySQL'
+  dbtype: 'SQLite' | 'MySQL' | 'IndexedDB'
   maxOutputScript: number
 }

package/src/storage/schema/tables/index.ts

@@ -1,16 +1,16 @@
 export * from './TableSettings'
-export * from './ProvenTx'
-export * from './ProvenTxReq'
-export * from './User'
-export * from './Certificate'
-export * from './CertificateField'
-export * from './OutputBasket'
-export * from './Transaction'
-export * from './Commission'
-export * from './Output'
-export * from './OutputTag'
-export * from './OutputTagMap'
-export * from './TxLabel'
-export * from './TxLabelMap'
-export * from './MonitorEvent'
-export * from './SyncState'
+export * from './TableProvenTx'
+export * from './TableProvenTxReq'
+export * from './TableUser'
+export * from './TableCertificate'
+export * from './TableCertificateField'
+export * from './TableOutputBasket'
+export * from './TableTransaction'
+export * from './TableCommission'
+export * from './TableOutput'
+export * from './TableOutputTag'
+export * from './TableOutputTagMap'
+export * from './TableTxLabel'
+export * from './TableTxLabelMap'
+export * from './TableMonitorEvent'
+export * from './TableSyncState'

package/test/Wallet/local/localWallet2.man.test.ts

@@ -28,6 +28,8 @@ describe('localWallet2 tests', () => {
 
   test('0 monitor runOnce', async () => {
     const setup = await createSetup(chain, options)
+    const log = await setup.monitor.runTask('UnFail')
+    if (log) console.log(log)
     await setup.monitor.runOnce()
     await setup.wallet.destroy()
   })
@@ -244,3 +246,6 @@ const beefJackie = [
   154, 94, 189, 29, 53, 41, 220, 136, 142, 80, 136, 172, 208, 140, 0, 0, 0, 0, 0, 0, 25, 118, 169, 20, 217, 48, 110,
   108, 236, 100, 116, 90, 181, 114, 45, 176, 198, 216, 150, 134, 16, 251, 10, 177, 136, 172, 0, 0, 0, 0
 ]
+
+const brayden1 =
+  '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'