@bopen-io/wallet-toolbox 1.7.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (390) hide show
  1. package/.claude/settings.local.json +10 -0
  2. package/.env.template +22 -0
  3. package/.github/ISSUE_TEMPLATE/bug_report.md +40 -0
  4. package/.github/ISSUE_TEMPLATE/discussion.md +24 -0
  5. package/.github/pull_request_template.md +22 -0
  6. package/.github/workflows/push.yaml +145 -0
  7. package/.prettierrc +10 -0
  8. package/CHANGELOG.md +280 -0
  9. package/CONTRIBUTING.md +89 -0
  10. package/README.md +43 -0
  11. package/docs/README.md +85 -0
  12. package/docs/client.md +19627 -0
  13. package/docs/monitor.md +953 -0
  14. package/docs/open-rpc/index.html +46 -0
  15. package/docs/services.md +6377 -0
  16. package/docs/setup.md +1268 -0
  17. package/docs/storage.md +5367 -0
  18. package/docs/wallet.md +19626 -0
  19. package/jest.config.ts +25 -0
  20. package/license.md +28 -0
  21. package/out/tsconfig.all.tsbuildinfo +1 -0
  22. package/package.json +63 -0
  23. package/src/CWIStyleWalletManager.ts +1999 -0
  24. package/src/Setup.ts +579 -0
  25. package/src/SetupClient.ts +322 -0
  26. package/src/SetupWallet.ts +108 -0
  27. package/src/SimpleWalletManager.ts +526 -0
  28. package/src/Wallet.ts +1169 -0
  29. package/src/WalletAuthenticationManager.ts +153 -0
  30. package/src/WalletLogger.ts +213 -0
  31. package/src/WalletPermissionsManager.ts +3660 -0
  32. package/src/WalletSettingsManager.ts +114 -0
  33. package/src/__tests/CWIStyleWalletManager.test.d.ts.map +1 -0
  34. package/src/__tests/CWIStyleWalletManager.test.js.map +1 -0
  35. package/src/__tests/CWIStyleWalletManager.test.ts +675 -0
  36. package/src/__tests/WalletPermissionsManager.callbacks.test.ts +323 -0
  37. package/src/__tests/WalletPermissionsManager.checks.test.ts +844 -0
  38. package/src/__tests/WalletPermissionsManager.encryption.test.ts +412 -0
  39. package/src/__tests/WalletPermissionsManager.fixtures.ts +307 -0
  40. package/src/__tests/WalletPermissionsManager.flows.test.ts +462 -0
  41. package/src/__tests/WalletPermissionsManager.initialization.test.ts +300 -0
  42. package/src/__tests/WalletPermissionsManager.pmodules.test.ts +798 -0
  43. package/src/__tests/WalletPermissionsManager.proxying.test.ts +724 -0
  44. package/src/__tests/WalletPermissionsManager.tokens.test.ts +503 -0
  45. package/src/index.all.ts +27 -0
  46. package/src/index.client.ts +25 -0
  47. package/src/index.mobile.ts +21 -0
  48. package/src/index.ts +1 -0
  49. package/src/monitor/Monitor.ts +412 -0
  50. package/src/monitor/MonitorDaemon.ts +188 -0
  51. package/src/monitor/README.md +3 -0
  52. package/src/monitor/__test/MonitorDaemon.man.test.ts +45 -0
  53. package/src/monitor/tasks/TaskCheckForProofs.ts +243 -0
  54. package/src/monitor/tasks/TaskCheckNoSends.ts +73 -0
  55. package/src/monitor/tasks/TaskClock.ts +33 -0
  56. package/src/monitor/tasks/TaskFailAbandoned.ts +54 -0
  57. package/src/monitor/tasks/TaskMonitorCallHistory.ts +26 -0
  58. package/src/monitor/tasks/TaskNewHeader.ts +93 -0
  59. package/src/monitor/tasks/TaskPurge.ts +68 -0
  60. package/src/monitor/tasks/TaskReorg.ts +89 -0
  61. package/src/monitor/tasks/TaskReviewStatus.ts +48 -0
  62. package/src/monitor/tasks/TaskSendWaiting.ts +122 -0
  63. package/src/monitor/tasks/TaskSyncWhenIdle.ts +26 -0
  64. package/src/monitor/tasks/TaskUnFail.ts +151 -0
  65. package/src/monitor/tasks/WalletMonitorTask.ts +47 -0
  66. package/src/sdk/CertOpsWallet.ts +18 -0
  67. package/src/sdk/PrivilegedKeyManager.ts +372 -0
  68. package/src/sdk/README.md +13 -0
  69. package/src/sdk/WERR_errors.ts +234 -0
  70. package/src/sdk/WalletError.ts +170 -0
  71. package/src/sdk/WalletErrorFromJson.ts +80 -0
  72. package/src/sdk/WalletServices.interfaces.ts +700 -0
  73. package/src/sdk/WalletSigner.interfaces.ts +11 -0
  74. package/src/sdk/WalletStorage.interfaces.ts +606 -0
  75. package/src/sdk/__test/CertificateLifeCycle.test.ts +131 -0
  76. package/src/sdk/__test/PrivilegedKeyManager.test.ts +738 -0
  77. package/src/sdk/__test/WalletError.test.ts +318 -0
  78. package/src/sdk/__test/validationHelpers.test.ts +21 -0
  79. package/src/sdk/index.ts +10 -0
  80. package/src/sdk/types.ts +226 -0
  81. package/src/services/README.md +11 -0
  82. package/src/services/ServiceCollection.ts +248 -0
  83. package/src/services/Services.ts +603 -0
  84. package/src/services/__tests/ARC.man.test.ts +123 -0
  85. package/src/services/__tests/ARC.timeout.man.test.ts +79 -0
  86. package/src/services/__tests/ArcGorillaPool.man.test.ts +108 -0
  87. package/src/services/__tests/arcServices.test.ts +8 -0
  88. package/src/services/__tests/bitrails.test.ts +56 -0
  89. package/src/services/__tests/getMerklePath.test.ts +15 -0
  90. package/src/services/__tests/getRawTx.test.ts +13 -0
  91. package/src/services/__tests/postBeef.test.ts +104 -0
  92. package/src/services/__tests/verifyBeef.test.ts +50 -0
  93. package/src/services/chaintracker/BHServiceClient.ts +212 -0
  94. package/src/services/chaintracker/ChaintracksChainTracker.ts +71 -0
  95. package/src/services/chaintracker/__tests/ChaintracksChainTracker.test.ts +33 -0
  96. package/src/services/chaintracker/__tests/ChaintracksServiceClient.test.ts +29 -0
  97. package/src/services/chaintracker/chaintracks/Api/BlockHeaderApi.ts +72 -0
  98. package/src/services/chaintracker/chaintracks/Api/BulkIngestorApi.ts +83 -0
  99. package/src/services/chaintracker/chaintracks/Api/BulkStorageApi.ts +92 -0
  100. package/src/services/chaintracker/chaintracks/Api/ChaintracksApi.ts +64 -0
  101. package/src/services/chaintracker/chaintracks/Api/ChaintracksClientApi.ts +189 -0
  102. package/src/services/chaintracker/chaintracks/Api/ChaintracksFetchApi.ts +18 -0
  103. package/src/services/chaintracker/chaintracks/Api/ChaintracksFsApi.ts +58 -0
  104. package/src/services/chaintracker/chaintracks/Api/ChaintracksStorageApi.ts +386 -0
  105. package/src/services/chaintracker/chaintracks/Api/LiveIngestorApi.ts +25 -0
  106. package/src/services/chaintracker/chaintracks/Chaintracks.ts +609 -0
  107. package/src/services/chaintracker/chaintracks/ChaintracksService.ts +199 -0
  108. package/src/services/chaintracker/chaintracks/ChaintracksServiceClient.ts +154 -0
  109. package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorBase.ts +176 -0
  110. package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDN.ts +174 -0
  111. package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorCDNBabbage.ts +18 -0
  112. package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainCdn.ts +113 -0
  113. package/src/services/chaintracker/chaintracks/Ingest/BulkIngestorWhatsOnChainWs.ts +81 -0
  114. package/src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.ts +86 -0
  115. package/src/services/chaintracker/chaintracks/Ingest/LiveIngestorTeranodeP2P.ts +59 -0
  116. package/src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.ts +104 -0
  117. package/src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainWs.ts +66 -0
  118. package/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainIngestorWs.ts +566 -0
  119. package/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainServices.ts +219 -0
  120. package/src/services/chaintracker/chaintracks/Ingest/__tests/BulkIngestorCDNBabbage.test.ts +54 -0
  121. package/src/services/chaintracker/chaintracks/Ingest/__tests/LiveIngestorWhatsOnChainPoll.test.ts +33 -0
  122. package/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.ts +124 -0
  123. package/src/services/chaintracker/chaintracks/Storage/BulkStorageBase.ts +92 -0
  124. package/src/services/chaintracker/chaintracks/Storage/ChaintracksKnexMigrations.ts +104 -0
  125. package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageBase.ts +382 -0
  126. package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageIdb.ts +574 -0
  127. package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageKnex.ts +438 -0
  128. package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageMemory.ts +29 -0
  129. package/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageNoDb.ts +304 -0
  130. package/src/services/chaintracker/chaintracks/Storage/__tests/ChaintracksStorageIdb.test.ts +102 -0
  131. package/src/services/chaintracker/chaintracks/Storage/__tests/ChaintracksStorageKnex.test.ts +45 -0
  132. package/src/services/chaintracker/chaintracks/__tests/Chaintracks.test.ts +77 -0
  133. package/src/services/chaintracker/chaintracks/__tests/ChaintracksClientApi.test.ts +192 -0
  134. package/src/services/chaintracker/chaintracks/__tests/LocalCdnServer.ts +75 -0
  135. package/src/services/chaintracker/chaintracks/__tests/createIdbChaintracks.test.ts +62 -0
  136. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNetBlockHeaders.json +1 -0
  137. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNet_0.headers +0 -0
  138. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNet_1.headers +0 -0
  139. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNet_2.headers +0 -0
  140. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest349/mainNet_3.headers +0 -0
  141. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNetBlockHeaders.json +1 -0
  142. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNet_0.headers +0 -0
  143. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNet_1.headers +0 -0
  144. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNet_2.headers +0 -0
  145. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest379/mainNet_3.headers +0 -0
  146. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNetBlockHeaders.json +1 -0
  147. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNet_0.headers +0 -0
  148. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNet_1.headers +0 -0
  149. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNet_2.headers +0 -0
  150. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest399/mainNet_3.headers +0 -0
  151. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNetBlockHeaders.json +1 -0
  152. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_0.headers +0 -0
  153. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_1.headers +0 -0
  154. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_2.headers +0 -0
  155. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_3.headers +0 -0
  156. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest402/mainNet_4.headers +0 -0
  157. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNetBlockHeaders.json +1 -0
  158. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_0.headers +0 -0
  159. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_1.headers +0 -0
  160. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_2.headers +0 -0
  161. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_3.headers +0 -0
  162. package/src/services/chaintracker/chaintracks/__tests/data/cdnTest499/mainNet_4.headers +0 -0
  163. package/src/services/chaintracker/chaintracks/createDefaultIdbChaintracksOptions.ts +92 -0
  164. package/src/services/chaintracker/chaintracks/createDefaultKnexChaintracksOptions.ts +111 -0
  165. package/src/services/chaintracker/chaintracks/createDefaultNoDbChaintracksOptions.ts +91 -0
  166. package/src/services/chaintracker/chaintracks/createIdbChaintracks.ts +60 -0
  167. package/src/services/chaintracker/chaintracks/createKnexChaintracks.ts +65 -0
  168. package/src/services/chaintracker/chaintracks/createNoDbChaintracks.ts +60 -0
  169. package/src/services/chaintracker/chaintracks/index.all.ts +12 -0
  170. package/src/services/chaintracker/chaintracks/index.client.ts +4 -0
  171. package/src/services/chaintracker/chaintracks/index.mobile.ts +37 -0
  172. package/src/services/chaintracker/chaintracks/util/BulkFileDataManager.ts +975 -0
  173. package/src/services/chaintracker/chaintracks/util/BulkFileDataReader.ts +60 -0
  174. package/src/services/chaintracker/chaintracks/util/BulkFilesReader.ts +336 -0
  175. package/src/services/chaintracker/chaintracks/util/BulkHeaderFile.ts +247 -0
  176. package/src/services/chaintracker/chaintracks/util/ChaintracksFetch.ts +69 -0
  177. package/src/services/chaintracker/chaintracks/util/ChaintracksFs.ts +141 -0
  178. package/src/services/chaintracker/chaintracks/util/HeightRange.ts +153 -0
  179. package/src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.ts +76 -0
  180. package/src/services/chaintracker/chaintracks/util/__tests/BulkFileDataManager.test.ts +304 -0
  181. package/src/services/chaintracker/chaintracks/util/__tests/ChaintracksFetch.test.ts +60 -0
  182. package/src/services/chaintracker/chaintracks/util/__tests/HeightRange.test.ts +67 -0
  183. package/src/services/chaintracker/chaintracks/util/__tests/SingleWriterMultiReaderLock.test.ts +49 -0
  184. package/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.ts +573 -0
  185. package/src/services/chaintracker/chaintracks/util/dirtyHashes.ts +29 -0
  186. package/src/services/chaintracker/chaintracks/util/validBulkHeaderFilesByFileHash.ts +432 -0
  187. package/src/services/chaintracker/index.all.ts +4 -0
  188. package/src/services/chaintracker/index.client.ts +4 -0
  189. package/src/services/chaintracker/index.mobile.ts +4 -0
  190. package/src/services/createDefaultWalletServicesOptions.ts +77 -0
  191. package/src/services/index.ts +1 -0
  192. package/src/services/processingErrors/arcSuccessError.json +76 -0
  193. package/src/services/providers/ARC.ts +350 -0
  194. package/src/services/providers/Bitails.ts +256 -0
  195. package/src/services/providers/SdkWhatsOnChain.ts +83 -0
  196. package/src/services/providers/WhatsOnChain.ts +883 -0
  197. package/src/services/providers/__tests/WhatsOnChain.test.ts +242 -0
  198. package/src/services/providers/__tests/exchangeRates.test.ts +18 -0
  199. package/src/services/providers/exchangeRates.ts +265 -0
  200. package/src/services/providers/getBeefForTxid.ts +369 -0
  201. package/src/signer/README.md +5 -0
  202. package/src/signer/WalletSigner.ts +17 -0
  203. package/src/signer/methods/acquireDirectCertificate.ts +52 -0
  204. package/src/signer/methods/buildSignableTransaction.ts +183 -0
  205. package/src/signer/methods/completeSignedTransaction.ts +117 -0
  206. package/src/signer/methods/createAction.ts +172 -0
  207. package/src/signer/methods/internalizeAction.ts +106 -0
  208. package/src/signer/methods/proveCertificate.ts +43 -0
  209. package/src/signer/methods/signAction.ts +54 -0
  210. package/src/storage/README.md +14 -0
  211. package/src/storage/StorageIdb.ts +2304 -0
  212. package/src/storage/StorageKnex.ts +1425 -0
  213. package/src/storage/StorageProvider.ts +810 -0
  214. package/src/storage/StorageReader.ts +194 -0
  215. package/src/storage/StorageReaderWriter.ts +432 -0
  216. package/src/storage/StorageSyncReader.ts +34 -0
  217. package/src/storage/WalletStorageManager.ts +943 -0
  218. package/src/storage/__test/StorageIdb.test.ts +43 -0
  219. package/src/storage/__test/WalletStorageManager.test.ts +275 -0
  220. package/src/storage/__test/adminStats.man.test.ts +89 -0
  221. package/src/storage/__test/getBeefForTransaction.test.ts +385 -0
  222. package/src/storage/index.all.ts +11 -0
  223. package/src/storage/index.client.ts +7 -0
  224. package/src/storage/index.mobile.ts +6 -0
  225. package/src/storage/methods/ListActionsSpecOp.ts +70 -0
  226. package/src/storage/methods/ListOutputsSpecOp.ts +129 -0
  227. package/src/storage/methods/__test/GenerateChange/generateChangeSdk.test.ts +1057 -0
  228. package/src/storage/methods/__test/GenerateChange/randomValsUsed1.ts +20 -0
  229. package/src/storage/methods/__test/offsetKey.test.ts +274 -0
  230. package/src/storage/methods/attemptToPostReqsToNetwork.ts +389 -0
  231. package/src/storage/methods/createAction.ts +947 -0
  232. package/src/storage/methods/generateChange.ts +556 -0
  233. package/src/storage/methods/getBeefForTransaction.ts +139 -0
  234. package/src/storage/methods/getSyncChunk.ts +293 -0
  235. package/src/storage/methods/internalizeAction.ts +562 -0
  236. package/src/storage/methods/listActionsIdb.ts +183 -0
  237. package/src/storage/methods/listActionsKnex.ts +226 -0
  238. package/src/storage/methods/listCertificates.ts +73 -0
  239. package/src/storage/methods/listOutputsIdb.ts +203 -0
  240. package/src/storage/methods/listOutputsKnex.ts +263 -0
  241. package/src/storage/methods/offsetKey.ts +89 -0
  242. package/src/storage/methods/processAction.ts +420 -0
  243. package/src/storage/methods/purgeData.ts +251 -0
  244. package/src/storage/methods/purgeDataIdb.ts +10 -0
  245. package/src/storage/methods/reviewStatus.ts +101 -0
  246. package/src/storage/methods/reviewStatusIdb.ts +43 -0
  247. package/src/storage/methods/utils.Buffer.ts +33 -0
  248. package/src/storage/methods/utils.ts +56 -0
  249. package/src/storage/remoting/StorageClient.ts +567 -0
  250. package/src/storage/remoting/StorageMobile.ts +544 -0
  251. package/src/storage/remoting/StorageServer.ts +291 -0
  252. package/src/storage/remoting/__test/StorageClient.test.ts +113 -0
  253. package/src/storage/schema/KnexMigrations.ts +489 -0
  254. package/src/storage/schema/StorageIdbSchema.ts +150 -0
  255. package/src/storage/schema/entities/EntityBase.ts +210 -0
  256. package/src/storage/schema/entities/EntityCertificate.ts +188 -0
  257. package/src/storage/schema/entities/EntityCertificateField.ts +136 -0
  258. package/src/storage/schema/entities/EntityCommission.ts +148 -0
  259. package/src/storage/schema/entities/EntityOutput.ts +290 -0
  260. package/src/storage/schema/entities/EntityOutputBasket.ts +153 -0
  261. package/src/storage/schema/entities/EntityOutputTag.ts +121 -0
  262. package/src/storage/schema/entities/EntityOutputTagMap.ts +123 -0
  263. package/src/storage/schema/entities/EntityProvenTx.ts +319 -0
  264. package/src/storage/schema/entities/EntityProvenTxReq.ts +580 -0
  265. package/src/storage/schema/entities/EntitySyncState.ts +389 -0
  266. package/src/storage/schema/entities/EntityTransaction.ts +306 -0
  267. package/src/storage/schema/entities/EntityTxLabel.ts +121 -0
  268. package/src/storage/schema/entities/EntityTxLabelMap.ts +123 -0
  269. package/src/storage/schema/entities/EntityUser.ts +112 -0
  270. package/src/storage/schema/entities/MergeEntity.ts +73 -0
  271. package/src/storage/schema/entities/__tests/CertificateFieldTests.test.ts +353 -0
  272. package/src/storage/schema/entities/__tests/CertificateTests.test.ts +354 -0
  273. package/src/storage/schema/entities/__tests/CommissionTests.test.ts +371 -0
  274. package/src/storage/schema/entities/__tests/OutputBasketTests.test.ts +278 -0
  275. package/src/storage/schema/entities/__tests/OutputTagMapTests.test.ts +242 -0
  276. package/src/storage/schema/entities/__tests/OutputTagTests.test.ts +288 -0
  277. package/src/storage/schema/entities/__tests/OutputTests.test.ts +464 -0
  278. package/src/storage/schema/entities/__tests/ProvenTxReqTests.test.ts +340 -0
  279. package/src/storage/schema/entities/__tests/ProvenTxTests.test.ts +504 -0
  280. package/src/storage/schema/entities/__tests/SyncStateTests.test.ts +288 -0
  281. package/src/storage/schema/entities/__tests/TransactionTests.test.ts +604 -0
  282. package/src/storage/schema/entities/__tests/TxLabelMapTests.test.ts +361 -0
  283. package/src/storage/schema/entities/__tests/TxLabelTests.test.ts +198 -0
  284. package/src/storage/schema/entities/__tests/stampLogTests.test.ts +90 -0
  285. package/src/storage/schema/entities/__tests/usersTests.test.ts +340 -0
  286. package/src/storage/schema/entities/index.ts +16 -0
  287. package/src/storage/schema/tables/TableCertificate.ts +21 -0
  288. package/src/storage/schema/tables/TableCertificateField.ts +12 -0
  289. package/src/storage/schema/tables/TableCommission.ts +13 -0
  290. package/src/storage/schema/tables/TableMonitorEvent.ts +9 -0
  291. package/src/storage/schema/tables/TableOutput.ts +64 -0
  292. package/src/storage/schema/tables/TableOutputBasket.ts +12 -0
  293. package/src/storage/schema/tables/TableOutputTag.ts +10 -0
  294. package/src/storage/schema/tables/TableOutputTagMap.ts +9 -0
  295. package/src/storage/schema/tables/TableProvenTx.ts +14 -0
  296. package/src/storage/schema/tables/TableProvenTxReq.ts +65 -0
  297. package/src/storage/schema/tables/TableSettings.ts +17 -0
  298. package/src/storage/schema/tables/TableSyncState.ts +18 -0
  299. package/src/storage/schema/tables/TableTransaction.ts +54 -0
  300. package/src/storage/schema/tables/TableTxLabel.ts +10 -0
  301. package/src/storage/schema/tables/TableTxLabelMap.ts +9 -0
  302. package/src/storage/schema/tables/TableUser.ts +16 -0
  303. package/src/storage/schema/tables/index.ts +16 -0
  304. package/src/storage/sync/StorageMySQLDojoReader.ts +696 -0
  305. package/src/storage/sync/index.ts +1 -0
  306. package/src/utility/Format.ts +133 -0
  307. package/src/utility/README.md +3 -0
  308. package/src/utility/ReaderUint8Array.ts +187 -0
  309. package/src/utility/ScriptTemplateBRC29.ts +73 -0
  310. package/src/utility/__tests/utilityHelpers.noBuffer.test.ts +109 -0
  311. package/src/utility/aggregateResults.ts +68 -0
  312. package/src/utility/identityUtils.ts +159 -0
  313. package/src/utility/index.all.ts +7 -0
  314. package/src/utility/index.client.ts +7 -0
  315. package/src/utility/parseTxScriptOffsets.ts +29 -0
  316. package/src/utility/stampLog.ts +69 -0
  317. package/src/utility/tscProofToMerklePath.ts +48 -0
  318. package/src/utility/utilityHelpers.buffer.ts +34 -0
  319. package/src/utility/utilityHelpers.noBuffer.ts +60 -0
  320. package/src/utility/utilityHelpers.ts +275 -0
  321. package/src/wab-client/WABClient.ts +94 -0
  322. package/src/wab-client/__tests/WABClient.man.test.ts +59 -0
  323. package/src/wab-client/auth-method-interactors/AuthMethodInteractor.ts +47 -0
  324. package/src/wab-client/auth-method-interactors/DevConsoleInteractor.ts +73 -0
  325. package/src/wab-client/auth-method-interactors/PersonaIDInteractor.ts +35 -0
  326. package/src/wab-client/auth-method-interactors/TwilioPhoneInteractor.ts +72 -0
  327. package/syncVersions.js +71 -0
  328. package/test/Wallet/StorageClient/storageClient.man.test.ts +75 -0
  329. package/test/Wallet/action/abortAction.test.ts +47 -0
  330. package/test/Wallet/action/createAction.test.ts +299 -0
  331. package/test/Wallet/action/createAction2.test.ts +1273 -0
  332. package/test/Wallet/action/createActionToGenerateBeefs.man.test.ts +293 -0
  333. package/test/Wallet/action/internalizeAction.a.test.ts +286 -0
  334. package/test/Wallet/action/internalizeAction.test.ts +682 -0
  335. package/test/Wallet/action/relinquishOutput.test.ts +37 -0
  336. package/test/Wallet/certificate/acquireCertificate.test.ts +298 -0
  337. package/test/Wallet/certificate/listCertificates.test.ts +346 -0
  338. package/test/Wallet/construct/Wallet.constructor.test.ts +57 -0
  339. package/test/Wallet/get/getHeaderForHeight.test.ts +82 -0
  340. package/test/Wallet/get/getHeight.test.ts +52 -0
  341. package/test/Wallet/get/getKnownTxids.test.ts +86 -0
  342. package/test/Wallet/get/getNetwork.test.ts +27 -0
  343. package/test/Wallet/get/getVersion.test.ts +27 -0
  344. package/test/Wallet/list/listActions.test.ts +279 -0
  345. package/test/Wallet/list/listActions2.test.ts +1381 -0
  346. package/test/Wallet/list/listCertificates.test.ts +118 -0
  347. package/test/Wallet/list/listOutputs.test.ts +447 -0
  348. package/test/Wallet/live/walletLive.man.test.ts +521 -0
  349. package/test/Wallet/local/localWallet.man.test.ts +93 -0
  350. package/test/Wallet/local/localWallet2.man.test.ts +277 -0
  351. package/test/Wallet/signAction/mountaintop.man.test.ts +130 -0
  352. package/test/Wallet/specOps/specOps.man.test.ts +220 -0
  353. package/test/Wallet/support/janitor.man.test.ts +40 -0
  354. package/test/Wallet/support/operations.man.test.ts +407 -0
  355. package/test/Wallet/support/reqErrorReview.2025.05.06.man.test.ts +347 -0
  356. package/test/Wallet/sync/Wallet.sync.test.ts +215 -0
  357. package/test/Wallet/sync/Wallet.updateWalletLegacyTestData.man.test.ts +203 -0
  358. package/test/Wallet/sync/setActive.test.ts +170 -0
  359. package/test/WalletClient/LocalKVStore.man.test.ts +114 -0
  360. package/test/WalletClient/WERR.man.test.ts +35 -0
  361. package/test/bsv-ts-sdk/LocalKVStore.test.ts +102 -0
  362. package/test/checkDB.ts +57 -0
  363. package/test/checkdb +0 -0
  364. package/test/examples/backup.man.test.ts +59 -0
  365. package/test/examples/pushdrop.test.ts +282 -0
  366. package/test/monitor/Monitor.test.ts +620 -0
  367. package/test/services/Services.test.ts +263 -0
  368. package/test/storage/KnexMigrations.test.ts +86 -0
  369. package/test/storage/StorageMySQLDojoReader.man.test.ts +60 -0
  370. package/test/storage/count.test.ts +177 -0
  371. package/test/storage/find.test.ts +195 -0
  372. package/test/storage/findLegacy.test.ts +67 -0
  373. package/test/storage/idb/allocateChange.test.ts +251 -0
  374. package/test/storage/idb/count.test.ts +158 -0
  375. package/test/storage/idb/find.test.ts +177 -0
  376. package/test/storage/idb/idbSpeed.test.ts +36 -0
  377. package/test/storage/idb/insert.test.ts +268 -0
  378. package/test/storage/idb/transactionAbort.test.ts +108 -0
  379. package/test/storage/idb/update.test.ts +999 -0
  380. package/test/storage/insert.test.ts +278 -0
  381. package/test/storage/update.test.ts +1021 -0
  382. package/test/storage/update2.test.ts +897 -0
  383. package/test/utils/TestUtilsWalletStorage.ts +2526 -0
  384. package/test/utils/localWalletMethods.ts +363 -0
  385. package/test/utils/removeFailedFromDatabase.sql +17 -0
  386. package/ts2md.json +44 -0
  387. package/tsconfig.all.json +31 -0
  388. package/tsconfig.client.json +29 -0
  389. package/tsconfig.json +17 -0
  390. package/tsconfig.mobile.json +28 -0
@@ -0,0 +1,1021 @@
1
+ import { _tu, TestSetup1 } from '../utils/TestUtilsWalletStorage'
2
+ import { sdk, StorageProvider, StorageKnex, verifyOne } from '../../src/index.all'
3
+ import { normalizeDate, setLogging, updateTable, verifyValues } from '../utils/TestUtilsWalletStorage'
4
+ import {
5
+ TableProvenTx,
6
+ TableProvenTxReq,
7
+ TableUser,
8
+ TableCertificate,
9
+ TableCertificateField,
10
+ TableOutputBasket,
11
+ TableTransaction,
12
+ TableCommission,
13
+ TableOutput,
14
+ TableOutputTag,
15
+ TableOutputTagMap,
16
+ TableTxLabel,
17
+ TableTxLabelMap,
18
+ TableMonitorEvent,
19
+ TableSyncState
20
+ } from '../../src/storage/schema/tables'
21
+
22
+ setLogging(false)
23
+
24
+ describe('update tests', () => {
25
+ jest.setTimeout(99999999)
26
+
27
+ const chain: sdk.Chain = 'test'
28
+ const env = _tu.getEnvFlags(chain)
29
+ const testName = () => expect.getState().currentTestName || 'test'
30
+
31
+ let storages: StorageProvider[]
32
+ let setups: { setup: TestSetup1; storage: StorageProvider }[]
33
+
34
+ beforeEach(async () => {
35
+ setups = []
36
+ storages = []
37
+ const databaseName = testName()
38
+
39
+ const localSQLiteFile = await _tu.newTmpFile(`${databaseName}.sqlite`, false, false, true)
40
+ const knexSQLite = _tu.createLocalSQLite(localSQLiteFile)
41
+ storages.push(
42
+ new StorageKnex({
43
+ ...StorageKnex.defaultOptions(),
44
+ chain,
45
+ knex: knexSQLite
46
+ })
47
+ )
48
+ if (env.runMySQL) {
49
+ const knexMySQL = _tu.createLocalMySQL(`${databaseName}.mysql`)
50
+ storages.push(
51
+ new StorageKnex({
52
+ ...StorageKnex.defaultOptions(),
53
+ chain,
54
+ knex: knexMySQL
55
+ })
56
+ )
57
+ }
58
+ for (const storage of storages) {
59
+ await storage.dropAllData()
60
+ await storage.migrate('update tests', '1'.repeat(64))
61
+ await storage.makeAvailable()
62
+ setups.push({ storage, setup: await _tu.createTestSetup1(storage) })
63
+ }
64
+ })
65
+
66
+ afterEach(async () => {
67
+ for (const storage of storages) {
68
+ await storage.destroy()
69
+ }
70
+ })
71
+
72
+ test('0_update ProvenTx', async () => {
73
+ for (const { storage } of setups) {
74
+ const records = await storage.findProvenTxs({ partial: {} })
75
+ const time = new Date('2001-01-02T12:00:00.000Z')
76
+ for (const record of records) {
77
+ await storage.updateProvenTx(record.provenTxId, {
78
+ blockHash: 'fred',
79
+ updated_at: time
80
+ })
81
+ const t = verifyOne(
82
+ await storage.findProvenTxs({
83
+ partial: { provenTxId: record.provenTxId }
84
+ })
85
+ )
86
+ expect(t.provenTxId).toBe(record.provenTxId)
87
+ expect(t.blockHash).toBe('fred')
88
+ expect(t.updated_at.getTime()).toBe(time.getTime())
89
+ }
90
+ }
91
+ })
92
+
93
+ test('1_update ProvenTx', async () => {
94
+ const primaryKey = 'provenTxId'
95
+ for (const { storage } of setups) {
96
+ const referenceTime = new Date()
97
+ const records = await storage.findProvenTxs({ partial: {} })
98
+ for (const record of records) {
99
+ try {
100
+ const testValues: TableProvenTx = {
101
+ provenTxId: record.provenTxId,
102
+ txid: 'mockTxid',
103
+ created_at: new Date('2024-12-30T23:00:00Z'),
104
+ updated_at: new Date('2024-12-30T23:05:00Z'),
105
+ blockHash: 'mockBlockHash',
106
+ height: 12345,
107
+ index: 1,
108
+ merklePath: [1, 2, 3, 4],
109
+ merkleRoot: '1234',
110
+ rawTx: [4, 3, 2, 1]
111
+ }
112
+ await updateTable(storage.updateProvenTx.bind(storage), record[primaryKey], testValues)
113
+ const updatedTx = verifyOne(
114
+ await storage.findProvenTxs({
115
+ partial: { [primaryKey]: record[primaryKey] }
116
+ })
117
+ )
118
+ verifyValues(updatedTx, testValues, referenceTime)
119
+ for (const [key, value] of Object.entries(testValues)) {
120
+ if (key === primaryKey) {
121
+ continue
122
+ }
123
+ if (typeof value === 'string') {
124
+ const validString = `valid${key}`
125
+ const r1 = await storage.updateProvenTx(record[primaryKey], {
126
+ [key]: validString
127
+ })
128
+ expect(r1).toBe(1)
129
+ const updatedRow = verifyOne(
130
+ await storage.findProvenTxs({
131
+ partial: { [primaryKey]: record[primaryKey] }
132
+ })
133
+ )
134
+ expect(updatedRow[key]).toBe(validString)
135
+ }
136
+ if (typeof value === 'number') {
137
+ const validNumber = value + 1
138
+ const r1 = await storage.updateProvenTx(record[primaryKey], {
139
+ [key]: validNumber
140
+ })
141
+ expect(r1).toBe(1)
142
+ const updatedRow = verifyOne(
143
+ await storage.findProvenTxs({
144
+ partial: { [primaryKey]: record[primaryKey] }
145
+ })
146
+ )
147
+ expect(updatedRow[key]).toBe(validNumber)
148
+ }
149
+ if (value instanceof Date) {
150
+ const validDate = new Date('2024-12-31T00:00:00Z')
151
+ const r1 = await storage.updateProvenTx(record[primaryKey], {
152
+ [key]: validDate
153
+ })
154
+ expect(r1).toBe(1)
155
+ const updatedRow = verifyOne(
156
+ await storage.findProvenTxs({
157
+ partial: { [primaryKey]: record[primaryKey] }
158
+ })
159
+ )
160
+ expect(new Date(updatedRow[key]).toISOString()).toBe(validDate.toISOString())
161
+ }
162
+ if (Array.isArray(value)) {
163
+ const validArray = value.map(v => v + 1)
164
+ const r1 = await storage.updateProvenTx(record[primaryKey], {
165
+ [key]: validArray
166
+ })
167
+ expect(r1).toBe(1)
168
+ const updatedRow = verifyOne(
169
+ await storage.findProvenTxs({
170
+ partial: { [primaryKey]: record[primaryKey] }
171
+ })
172
+ )
173
+ expect(updatedRow[key]).toEqual(validArray)
174
+ }
175
+ }
176
+ } catch (error: any) {
177
+ console.error(
178
+ `Error updating or verifying ProvenTx record with ${primaryKey}=${record[primaryKey]}:`,
179
+ error.message
180
+ )
181
+ throw error
182
+ }
183
+ }
184
+ }
185
+ })
186
+
187
+ test('2_update ProvenTxReq', async () => {
188
+ const primaryKey = 'provenTxReqId'
189
+ for (const { storage } of setups) {
190
+ const records = await storage.findProvenTxReqs({ partial: {} })
191
+ for (const record of records) {
192
+ try {
193
+ const testValues: TableProvenTxReq = {
194
+ provenTxReqId: record.provenTxReqId,
195
+ provenTxId: 1,
196
+ batch: `batch-001`,
197
+ status: 'completed',
198
+ txid: `mockTxid-${Date.now()}`,
199
+ created_at: new Date('2024-12-30T23:00:00Z'),
200
+ updated_at: new Date('2024-12-30T23:05:00Z'),
201
+ attempts: 3,
202
+ history: JSON.stringify({ validated: true, timestamp: Date.now() }),
203
+ inputBEEF: [5, 6, 7, 8],
204
+ notified: true,
205
+ notify: JSON.stringify({ email: 'test@example.com', sent: true }),
206
+ rawTx: [1, 2, 3, 4]
207
+ }
208
+ const r1 = await storage.updateProvenTxReq(record[primaryKey], testValues)
209
+ expect(r1).toBe(1)
210
+ const updatedRow = verifyOne(
211
+ await storage.findProvenTxReqs({
212
+ partial: { [primaryKey]: record[primaryKey] }
213
+ })
214
+ )
215
+ for (const [key, value] of Object.entries(testValues)) {
216
+ const actualValue = updatedRow[key]
217
+ const normalizedActual = normalizeDate(actualValue)
218
+ const normalizedExpected = normalizeDate(value)
219
+ if (normalizedActual && normalizedExpected) {
220
+ expect(normalizedActual).toBe(normalizedExpected)
221
+ continue
222
+ }
223
+ if (typeof value === 'string' && value.startsWith('{') && value.endsWith('}')) {
224
+ expect(JSON.parse(actualValue)).toStrictEqual(JSON.parse(value))
225
+ continue
226
+ }
227
+ if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
228
+ expect(actualValue).toBe(value)
229
+ continue
230
+ }
231
+ if (typeof actualValue === 'object' && actualValue?.type === 'Buffer') {
232
+ const actualArray = actualValue.data || actualValue
233
+ const expectedArray =
234
+ Buffer.isBuffer(value) || Array.isArray(value) ? Array.from(value as ArrayLike<number>) : value
235
+ expect(actualArray).toStrictEqual(expectedArray)
236
+ continue
237
+ }
238
+ expect(JSON.stringify({ type: 'Buffer', data: actualValue })).toStrictEqual(JSON.stringify(value))
239
+ }
240
+ } catch (error: any) {
241
+ console.error(
242
+ `Error updating or verifying ProvenTxReq record with ${primaryKey}=${record[primaryKey]}:`,
243
+ error.message
244
+ )
245
+ throw error
246
+ }
247
+ }
248
+ }
249
+ })
250
+
251
+ test('3_update User', async () => {
252
+ const primaryKey = 'userId'
253
+ for (const { storage } of setups) {
254
+ const records = await storage.findUsers({ partial: {} })
255
+ for (const record of records) {
256
+ try {
257
+ const testValues: TableUser = {
258
+ userId: record.userId,
259
+ identityKey: `mockUpdatedIdentityKey-${record[primaryKey]}`,
260
+ created_at: new Date('2024-12-30T23:00:00Z'),
261
+ updated_at: new Date('2024-12-30T23:05:00Z'),
262
+ activeStorage: storage.getSettings().storageIdentityKey
263
+ }
264
+ const updateResult = await storage.updateUser(record[primaryKey], testValues)
265
+ expect(updateResult).toBe(1)
266
+ const updatedRow = verifyOne(
267
+ await storage.findUsers({
268
+ partial: { [primaryKey]: record[primaryKey] }
269
+ })
270
+ )
271
+ for (const [key, value] of Object.entries(testValues)) {
272
+ const actualValue = updatedRow[key]
273
+ const normalizedActual = normalizeDate(actualValue)
274
+ const normalizedExpected = normalizeDate(value)
275
+ if (normalizedActual && normalizedExpected) {
276
+ expect(normalizedActual).toBe(normalizedExpected)
277
+ continue
278
+ }
279
+ expect(actualValue).toBe(value)
280
+ }
281
+ } catch (error: any) {
282
+ console.error(
283
+ `Error updating or verifying User record with ${primaryKey}=${record[primaryKey]}:`,
284
+ error.message
285
+ )
286
+ throw error
287
+ }
288
+ }
289
+ }
290
+ })
291
+
292
+ test('4_update Certificate', async () => {
293
+ for (const { storage } of setups) {
294
+ const primaryKey = 'certificateId'
295
+ const records = await storage.findCertificates({ partial: {} })
296
+ for (const record of records) {
297
+ try {
298
+ const testValues: TableCertificate = {
299
+ certificateId: record.certificateId,
300
+ userId: 1,
301
+ certifier: `mockCertifier${record.certificateId}`,
302
+ serialNumber: `mockSerialNumber${record.certificateId}`,
303
+ type: `mockType${record.certificateId}`,
304
+ created_at: new Date('2024-12-30T23:00:00Z'),
305
+ updated_at: new Date('2024-12-30T23:05:00Z'),
306
+ isDeleted: false,
307
+ revocationOutpoint: 'mockRevocationOutpoint',
308
+ signature: 'mockSignature',
309
+ subject: 'mockSubject'
310
+ }
311
+ const r1 = await storage.updateCertificate(record[primaryKey], testValues)
312
+ expect(r1).toBe(1)
313
+ const updatedRow = verifyOne(
314
+ await storage.findCertificates({
315
+ partial: { [primaryKey]: record[primaryKey] }
316
+ })
317
+ )
318
+ for (const [key, value] of Object.entries(testValues)) {
319
+ const actualValue = updatedRow[key]
320
+ const normalizedActual = normalizeDate(actualValue)
321
+ const normalizedExpected = normalizeDate(value)
322
+ if (normalizedActual && normalizedExpected) {
323
+ expect(normalizedActual).toBe(normalizedExpected)
324
+ continue
325
+ }
326
+ if (typeof value === 'string' && value.startsWith('{') && value.endsWith('}')) {
327
+ expect(JSON.parse(actualValue)).toStrictEqual(JSON.parse(value))
328
+ continue
329
+ }
330
+ if (typeof actualValue === 'boolean') {
331
+ if (value === 1) {
332
+ expect(actualValue).toBe(true)
333
+ } else if (value === 0) {
334
+ expect(actualValue).toBe(false)
335
+ } else {
336
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
337
+ }
338
+ continue
339
+ }
340
+ if (typeof value === 'string' || typeof value === 'number') {
341
+ expect(actualValue).toBe(value)
342
+ continue
343
+ }
344
+ if (typeof actualValue === 'object' && actualValue?.type === 'Buffer') {
345
+ const actualArray = actualValue.data || actualValue
346
+ const expectedArray =
347
+ Buffer.isBuffer(value) || Array.isArray(value) ? Array.from(value as ArrayLike<number>) : value
348
+ expect(actualArray).toStrictEqual(expectedArray)
349
+ continue
350
+ }
351
+ expect(JSON.stringify({ type: 'Buffer', data: actualValue })).toStrictEqual(JSON.stringify(value))
352
+ }
353
+ } catch (error: any) {
354
+ console.error(
355
+ `Error updating or verifying Certificate record with ${primaryKey}=${record[primaryKey]}:`,
356
+ error.message
357
+ )
358
+ throw error
359
+ }
360
+ }
361
+ }
362
+ })
363
+
364
+ test('5_update CertificateField', async () => {
365
+ const primaryKey = 'certificateId'
366
+ for (const { storage } of setups) {
367
+ const records = await storage.findCertificateFields({
368
+ partial: { fieldName: 'bob' }
369
+ })
370
+ for (const record of records) {
371
+ try {
372
+ const testValues: TableCertificateField = {
373
+ certificateId: record.certificateId,
374
+ userId: record.userId ?? 1,
375
+ created_at: new Date('2024-12-30T23:00:00Z'),
376
+ updated_at: new Date('2024-12-30T23:05:00Z'),
377
+ fieldName: record.fieldName || 'defaultFieldName',
378
+ fieldValue: 'your uncle',
379
+ masterKey: 'key'
380
+ }
381
+ const updateResult = await storage.updateCertificateField(
382
+ record.certificateId,
383
+ testValues.fieldName,
384
+ testValues
385
+ )
386
+ expect(updateResult).toBe(1)
387
+ const updatedRecords = await storage.findCertificateFields({
388
+ partial: {
389
+ certificateId: record.certificateId,
390
+ fieldName: testValues.fieldName
391
+ }
392
+ })
393
+ const updatedRow = verifyOne(
394
+ updatedRecords,
395
+ `Updated CertificateField with certificateId=${record.certificateId}, fieldName=${testValues.fieldName} was not unique or missing.`
396
+ )
397
+ for (const [key, value] of Object.entries(testValues)) {
398
+ const actualValue = updatedRow[key]
399
+ const normalizedActual = normalizeDate(actualValue)
400
+ const normalizedExpected = normalizeDate(value)
401
+ if (normalizedActual && normalizedExpected) {
402
+ expect(normalizedActual).toBe(normalizedExpected)
403
+ continue
404
+ }
405
+ expect(actualValue).toBe(value)
406
+ }
407
+ } catch (error: any) {
408
+ console.error(
409
+ `Error updating or verifying CertificateField record with certificateId=${record[primaryKey]}:`,
410
+ error.message
411
+ )
412
+ throw error
413
+ }
414
+ }
415
+ }
416
+ })
417
+
418
+ test('6_update OutputBasket', async () => {
419
+ const primaryKey = 'basketId'
420
+ for (const { storage } of setups) {
421
+ const records = await storage.findOutputBaskets({ partial: {} })
422
+ for (const record of records) {
423
+ try {
424
+ const testValues: TableOutputBasket = {
425
+ basketId: record.basketId,
426
+ userId: record.userId ?? 1,
427
+ created_at: new Date('2024-12-30T23:00:00Z'),
428
+ updated_at: new Date('2024-12-30T23:05:00Z'),
429
+ name: record.name || 'defaultName',
430
+ numberOfDesiredUTXOs: 99,
431
+ minimumDesiredUTXOValue: 5000,
432
+ isDeleted: false
433
+ }
434
+ const updateResult = await storage.updateOutputBasket(record.basketId, testValues)
435
+ expect(updateResult).toBe(1)
436
+ const updatedRecords = await storage.findOutputBaskets({
437
+ partial: { basketId: record.basketId, name: testValues.name }
438
+ })
439
+ const updatedRow = verifyOne(
440
+ updatedRecords,
441
+ `Updated OutputBasket with basketId=${record.basketId}, name=${testValues.name} was not unique or missing.`
442
+ )
443
+ for (const [key, value] of Object.entries(testValues)) {
444
+ const actualValue = updatedRow[key]
445
+ if (typeof actualValue === 'boolean') {
446
+ if (value === 1) {
447
+ expect(actualValue).toBe(true)
448
+ } else if (value === 0) {
449
+ expect(actualValue).toBe(false)
450
+ } else {
451
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
452
+ }
453
+ continue
454
+ }
455
+ const normalizedActual = normalizeDate(actualValue)
456
+ const normalizedExpected = normalizeDate(value)
457
+ if (normalizedActual && normalizedExpected) {
458
+ expect(normalizedActual).toBe(normalizedExpected)
459
+ continue
460
+ }
461
+ expect(actualValue).toBe(value)
462
+ }
463
+ } catch (error: any) {
464
+ console.error(
465
+ `Error updating or verifying OutputBasket record with basketId=${record[primaryKey]}:`,
466
+ error.message
467
+ )
468
+ throw error
469
+ }
470
+ }
471
+ }
472
+ })
473
+
474
+ test('7_update Transaction', async () => {
475
+ const primaryKey = 'transactionId'
476
+ for (const { storage } of setups) {
477
+ const records = await storage.findTransactions({ partial: {} })
478
+ for (const record of records) {
479
+ try {
480
+ const testValues: TableTransaction = {
481
+ transactionId: record.transactionId,
482
+ userId: record.userId ?? 1,
483
+ provenTxId: 1,
484
+ reference: `updated_reference_string_${record.transactionId}==`,
485
+ status: 'confirmed' as sdk.TransactionStatus,
486
+ txid: `updated_txid_example_${record.transactionId}`,
487
+ created_at: new Date('2024-12-30T23:00:00Z'),
488
+ updated_at: new Date('2024-12-30T23:05:00Z'),
489
+ description: 'Updated transaction description',
490
+ isOutgoing: false,
491
+ lockTime: 600000000,
492
+ satoshis: 20000,
493
+ version: 2
494
+ }
495
+ const updateResult = await storage.updateTransaction(record.transactionId, testValues)
496
+ expect(updateResult).toBe(1)
497
+ const updatedRecords = await storage.findTransactions({
498
+ partial: { transactionId: record.transactionId }
499
+ })
500
+ const updatedRow = verifyOne(
501
+ updatedRecords,
502
+ `Updated Transaction with transactionId=${record.transactionId} was not unique or missing.`
503
+ )
504
+ for (const [key, value] of Object.entries(testValues)) {
505
+ const actualValue = updatedRow[key]
506
+ const normalizedActual = normalizeDate(actualValue)
507
+ const normalizedExpected = normalizeDate(value)
508
+ if (normalizedActual && normalizedExpected) {
509
+ expect(normalizedActual).toBe(normalizedExpected)
510
+ continue
511
+ }
512
+ expect(actualValue).toBe(value)
513
+ }
514
+ } catch (error: any) {
515
+ console.error(
516
+ `Error updating or verifying Transaction record with transactionId=${record[primaryKey]}:`,
517
+ error.message
518
+ )
519
+ throw error
520
+ }
521
+ }
522
+ }
523
+ })
524
+
525
+ test('7a updateTransactionStatus', async () => {
526
+ const { activeStorage: storage } = await _tu.createLegacyWalletSQLiteCopy('updateTransactionStatus7a')
527
+
528
+ let tx = verifyOne(
529
+ await storage.findTransactions({
530
+ partial: { status: 'unproven' },
531
+ paged: { limit: 1 }
532
+ })
533
+ )
534
+ expect(tx.status).toBe('unproven')
535
+ await storage.updateTransactionStatus('completed', tx.transactionId)
536
+ tx = verifyOne(
537
+ await storage.findTransactions({
538
+ partial: { transactionId: tx.transactionId }
539
+ })
540
+ )
541
+ expect(tx.status).toBe('completed')
542
+
543
+ await storage.destroy()
544
+ })
545
+
546
+ test('8_update Commission', async () => {
547
+ const primaryKey = 'commissionId'
548
+ for (const { storage } of setups) {
549
+ const records = await storage.findCommissions({ partial: {} })
550
+ for (const record of records) {
551
+ try {
552
+ const testValues: TableCommission = {
553
+ commissionId: record.commissionId,
554
+ userId: record.userId ?? 1,
555
+ transactionId: record.transactionId ?? 1,
556
+ created_at: new Date('2024-12-30T23:00:00Z'),
557
+ updated_at: new Date('2024-12-30T23:05:00Z'),
558
+ satoshis: 300,
559
+ keyOffset: `updated_key_offset_${record.commissionId}`,
560
+ isRedeemed: true,
561
+ lockingScript: [1, 2, 3, 4]
562
+ }
563
+ const updateResult = await storage.updateCommission(record.commissionId, testValues)
564
+ expect(updateResult).toBe(1)
565
+ const updatedRecords = await storage.findCommissions({
566
+ partial: { commissionId: record.commissionId }
567
+ })
568
+ const updatedRow = verifyOne(
569
+ updatedRecords,
570
+ `Updated Commission with commissionId=${record.commissionId} was not unique or missing.`
571
+ )
572
+ for (const [key, value] of Object.entries(testValues)) {
573
+ const actualValue = updatedRow[key]
574
+ const normalizedActual = normalizeDate(actualValue)
575
+ const normalizedExpected = normalizeDate(value)
576
+ if (normalizedActual && normalizedExpected) {
577
+ expect(normalizedActual).toBe(normalizedExpected)
578
+ continue
579
+ }
580
+ if (Buffer.isBuffer(actualValue) || Array.isArray(actualValue)) {
581
+ expect(JSON.stringify({ type: 'Buffer', data: actualValue })).toStrictEqual(JSON.stringify(value))
582
+ continue
583
+ }
584
+ expect(actualValue).toBe(value)
585
+ }
586
+ } catch (error: any) {
587
+ console.error(
588
+ `Error updating or verifying Commission record with commissionId=${record[primaryKey]}:`,
589
+ error.message
590
+ )
591
+ throw error
592
+ }
593
+ }
594
+ }
595
+ })
596
+
597
+ test('9_update Output', async () => {
598
+ const primaryKey = 'outputId'
599
+ for (const { storage } of setups) {
600
+ const records = await storage.findOutputs({ partial: {} })
601
+ for (const record of records) {
602
+ if (!record.transactionId) record.transactionId = 1
603
+ if (!record.basketId) record.basketId = 1
604
+ if (!record.userId || !record.transactionId || !record.basketId) {
605
+ throw new Error(`Missing required foreign keys for record ${JSON.stringify(record)}`)
606
+ }
607
+ }
608
+ for (const record of records) {
609
+ const existingRecords = await storage.findOutputs({ partial: {} })
610
+ const usedCombinations = new Set(existingRecords.map(r => `${r.transactionId}-${r.vout}-${r.userId}`))
611
+ let testTransactionId = record.transactionId
612
+ let testVout = record.vout + 1
613
+ let testUserId = record.userId
614
+ while (usedCombinations.has(`${testTransactionId}-${testVout}-${testUserId}`)) {
615
+ testVout += 1
616
+ }
617
+ try {
618
+ const testValues: TableOutput = {
619
+ outputId: record.outputId,
620
+ basketId: record.basketId ?? 1,
621
+ transactionId: testTransactionId,
622
+ userId: testUserId,
623
+ vout: testVout,
624
+ created_at: new Date('2024-12-30T23:00:00Z'),
625
+ updated_at: new Date('2024-12-30T23:05:00Z'),
626
+ change: true,
627
+ customInstructions: 'Updated instructions',
628
+ derivationPrefix: 'updated_prefix==',
629
+ derivationSuffix: 'updated_suffix==',
630
+ lockingScript: [0x01, 0x02, 0x03, 0x04],
631
+ providedBy: 'you',
632
+ purpose: 'updated_purpose',
633
+ satoshis: 3000,
634
+ scriptLength: 150,
635
+ scriptOffset: 5,
636
+ senderIdentityKey: 'updated_sender_key',
637
+ sequenceNumber: 10,
638
+ spendingDescription: 'Updated spending description',
639
+ spendable: false,
640
+ spentBy: 3,
641
+ txid: 'updated_txid',
642
+ type: 'updated_type',
643
+ outputDescription: 'outputDescription'
644
+ }
645
+ const updateResult = await storage.updateOutput(record.outputId, testValues)
646
+ expect(updateResult).toBe(1)
647
+ const updatedRecords = await storage.findOutputs({
648
+ partial: { outputId: record.outputId }
649
+ })
650
+ const updatedRow = verifyOne(
651
+ updatedRecords,
652
+ `Updated Output with outputId=${record.outputId} was not unique or missing.`
653
+ )
654
+ for (const [key, value] of Object.entries(testValues)) {
655
+ const actualValue = updatedRow[key]
656
+ const normalizedActual = normalizeDate(actualValue)
657
+ const normalizedExpected = normalizeDate(value)
658
+ if (normalizedActual && normalizedExpected) {
659
+ expect(normalizedActual).toBe(normalizedExpected)
660
+ continue
661
+ }
662
+ if (Buffer.isBuffer(actualValue) || Array.isArray(actualValue)) {
663
+ expect(JSON.stringify({ type: 'Buffer', data: actualValue })).toStrictEqual(JSON.stringify(value))
664
+ continue
665
+ }
666
+ expect(actualValue).toBe(value)
667
+ }
668
+ } catch (error: any) {
669
+ console.error(`Error updating or verifying Output record with outputId=${record[primaryKey]}:`, error.message)
670
+ throw error
671
+ }
672
+ }
673
+ }
674
+ })
675
+
676
+ test('10_update OutputTag', async () => {
677
+ const primaryKey = 'outputTagId'
678
+ for (const { storage } of setups) {
679
+ const records = await storage.findOutputTags({ partial: {} })
680
+ for (const record of records) {
681
+ if (!record.userId) record.userId = 1
682
+ if (!record.tag) record.tag = `default_tag_${record.outputTagId}`
683
+ if (!record.userId || !record.tag) {
684
+ throw new Error(`Missing required fields for record ${JSON.stringify(record)}`)
685
+ }
686
+ }
687
+ for (const record of records) {
688
+ const uniqueTag = `updated_tag_${record.outputTagId}`
689
+ const testValues: TableOutputTag = {
690
+ outputTagId: record.outputTagId,
691
+ userId: record.userId,
692
+ tag: uniqueTag,
693
+ created_at: new Date('2024-12-30T23:00:00Z'),
694
+ updated_at: new Date('2024-12-30T23:05:00Z'),
695
+ isDeleted: false
696
+ }
697
+ try {
698
+ const updateResult = await storage.updateOutputTag(record.outputTagId, testValues)
699
+ expect(updateResult).toBe(1)
700
+ const updatedRecords = await storage.findOutputTags({
701
+ partial: { outputTagId: record.outputTagId }
702
+ })
703
+ const updatedRow = verifyOne(
704
+ updatedRecords,
705
+ `Updated OutputTag with outputTagId=${record.outputTagId} was not unique or missing.`
706
+ )
707
+ for (const [key, value] of Object.entries(testValues)) {
708
+ const actualValue = updatedRow[key]
709
+ if (typeof actualValue === 'boolean') {
710
+ if (value === 1) {
711
+ expect(actualValue).toBe(true)
712
+ } else if (value === 0) {
713
+ expect(actualValue).toBe(false)
714
+ } else {
715
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
716
+ }
717
+ continue
718
+ }
719
+ const normalizedActual = normalizeDate(actualValue)
720
+ const normalizedExpected = normalizeDate(value)
721
+ if (normalizedActual && normalizedExpected) {
722
+ expect(normalizedActual).toBe(normalizedExpected)
723
+ continue
724
+ }
725
+ expect(actualValue).toBe(value)
726
+ }
727
+ } catch (error: any) {
728
+ console.error(
729
+ `Error updating or verifying OutputTag record with outputTagId=${record[primaryKey]}:`,
730
+ error.message
731
+ )
732
+ throw error
733
+ }
734
+ }
735
+ }
736
+ })
737
+
738
+ test('11_update OutputTagMap', async () => {
739
+ const primaryKey = ['outputTagId', 'outputId']
740
+ for (const { storage } of setups) {
741
+ const records = await storage.findOutputTagMaps({ partial: {} })
742
+ for (const record of records) {
743
+ if (!record.outputTagId) throw new Error(`Missing outputTagId for record: ${JSON.stringify(record)}`)
744
+ if (!record.outputId) throw new Error(`Missing outputId for record: ${JSON.stringify(record)}`)
745
+ try {
746
+ const testValues: TableOutputTagMap = {
747
+ outputTagId: record.outputTagId,
748
+ outputId: record.outputId,
749
+ created_at: new Date('2024-12-30T23:00:00Z'),
750
+ updated_at: new Date('2024-12-30T23:05:00Z'),
751
+ isDeleted: false
752
+ }
753
+ const updateResult = await storage.updateOutputTagMap(record.outputId, record.outputTagId, testValues)
754
+ expect(updateResult).toBe(1)
755
+ const updatedRecords = await storage.findOutputTagMaps({
756
+ partial: {
757
+ outputTagId: record.outputTagId,
758
+ outputId: record.outputId
759
+ }
760
+ })
761
+ const updatedRow = verifyOne(
762
+ updatedRecords,
763
+ `Updated OutputTagMap with outputTagId=${record.outputTagId} and outputId=${record.outputId} was not unique or missing.`
764
+ )
765
+ for (const [key, value] of Object.entries(testValues)) {
766
+ const actualValue = updatedRow[key]
767
+ if (typeof actualValue === 'boolean') {
768
+ if (value === 1) {
769
+ expect(actualValue).toBe(true)
770
+ } else if (value === 0) {
771
+ expect(actualValue).toBe(false)
772
+ } else {
773
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
774
+ }
775
+ continue
776
+ }
777
+ const normalizedActual = normalizeDate(actualValue)
778
+ const normalizedExpected = normalizeDate(value)
779
+ if (normalizedActual && normalizedExpected) {
780
+ expect(normalizedActual).toBe(normalizedExpected)
781
+ continue
782
+ }
783
+ expect(actualValue).toBe(value)
784
+ }
785
+ } catch (error: any) {
786
+ console.error(
787
+ `Error updating or verifying OutputTagMap record with outputTagId=${record.outputTagId} and outputId=${record.outputId}:`,
788
+ error.message
789
+ )
790
+ throw error
791
+ }
792
+ }
793
+ }
794
+ })
795
+
796
+ test('12_update TxLabel', async () => {
797
+ const primaryKey = 'txLabelId'
798
+ for (const { storage } of setups) {
799
+ const records = await storage.findTxLabels({ partial: {} })
800
+ for (const record of records) {
801
+ if (!record.userId) {
802
+ throw new Error(`Missing required foreign key userId for record ${JSON.stringify(record)}`)
803
+ }
804
+ }
805
+ for (const record of records) {
806
+ const uniqueLabel = `unique_label_${record.txLabelId}`
807
+ const testValues: TableTxLabel = {
808
+ txLabelId: record.txLabelId,
809
+ userId: record.userId,
810
+ label: uniqueLabel,
811
+ isDeleted: false,
812
+ created_at: new Date('2024-12-30T23:00:00Z'),
813
+ updated_at: new Date('2024-12-30T23:05:00Z')
814
+ }
815
+ const existingLabel = await storage.findTxLabels({
816
+ partial: { label: testValues.label, userId: testValues.userId }
817
+ })
818
+ if (existingLabel.length > 0) {
819
+ continue
820
+ }
821
+ const updateResult = await storage.updateTxLabel(record.txLabelId, testValues)
822
+ expect(updateResult).toBe(1)
823
+ const updatedRecords = await storage.findTxLabels({
824
+ partial: { txLabelId: record.txLabelId }
825
+ })
826
+ const updatedRow = verifyOne(
827
+ updatedRecords,
828
+ `Updated TxLabel with txLabelId=${record.txLabelId} was not unique or missing.`
829
+ )
830
+ for (const [key, value] of Object.entries(testValues)) {
831
+ const actualValue = updatedRow[key]
832
+ if (typeof actualValue === 'boolean') {
833
+ if (value === 1) {
834
+ expect(actualValue).toBe(true)
835
+ } else if (value === 0) {
836
+ expect(actualValue).toBe(false)
837
+ } else {
838
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
839
+ }
840
+ continue
841
+ }
842
+ const normalizedActual = normalizeDate(actualValue)
843
+ const normalizedExpected = normalizeDate(value)
844
+ if (normalizedActual && normalizedExpected) {
845
+ expect(normalizedActual).toBe(normalizedExpected)
846
+ continue
847
+ }
848
+ expect(actualValue).toBe(value)
849
+ }
850
+ }
851
+ }
852
+ })
853
+
854
+ test('13_update TxLabelMap', async () => {
855
+ const primaryKeyTransaction = 'transactionId'
856
+ const primaryKeyLabel = 'txLabelId'
857
+ for (const { storage, setup } of setups) {
858
+ const records = await storage.findTxLabelMaps({ partial: {} })
859
+ for (const record of records) {
860
+ if (!record.transactionId || !record.txLabelId) {
861
+ throw new Error(`Missing required foreign keys for record ${JSON.stringify(record)}`)
862
+ }
863
+ }
864
+ for (const record of records) {
865
+ const testValues: TableTxLabelMap = {
866
+ transactionId: record.transactionId,
867
+ txLabelId: record.txLabelId,
868
+ created_at: new Date('2024-12-30T23:00:00Z'),
869
+ updated_at: new Date('2024-12-30T23:05:00Z'),
870
+ isDeleted: false
871
+ }
872
+ const existingRecord = await storage.findTxLabelMaps({
873
+ partial: {
874
+ transactionId: testValues.transactionId,
875
+ txLabelId: testValues.txLabelId
876
+ }
877
+ })
878
+ if (existingRecord.length > 0) {
879
+ continue
880
+ }
881
+ try {
882
+ const updateResult = await storage.updateTxLabelMap(record.transactionId, record.txLabelId, testValues)
883
+ expect(updateResult).toBe(1)
884
+ const updatedRecords = await storage.findTxLabelMaps({
885
+ partial: {
886
+ transactionId: record.transactionId,
887
+ txLabelId: record.txLabelId
888
+ }
889
+ })
890
+ const updatedRow = verifyOne(
891
+ updatedRecords,
892
+ `Updated TxLabelMap with transactionId=${record[primaryKeyTransaction]} and txLabelId=${record[primaryKeyLabel]} was not unique or missing.`
893
+ )
894
+ for (const [key, value] of Object.entries(testValues)) {
895
+ const actualValue = updatedRow[key]
896
+ const normalizedActual = normalizeDate(actualValue)
897
+ const normalizedExpected = normalizeDate(value)
898
+ if (normalizedActual && normalizedExpected) {
899
+ expect(normalizedActual).toBe(normalizedExpected)
900
+ continue
901
+ }
902
+ expect(actualValue).toBe(value)
903
+ }
904
+ } catch (error: any) {
905
+ console.error(
906
+ `Error updating or verifying TxLabelMap record with transactionId=${record[primaryKeyTransaction]} and txLabelId=${record[primaryKeyLabel]}:`,
907
+ error.message
908
+ )
909
+ throw error
910
+ }
911
+ }
912
+ }
913
+ })
914
+
915
+ test('14_update MonitorEvent', async () => {
916
+ const primaryKey = 'id'
917
+ for (const { storage, setup } of setups) {
918
+ const records = await storage.findMonitorEvents({ partial: {} })
919
+ for (const record of records) {
920
+ try {
921
+ const testValues: TableMonitorEvent = {
922
+ id: record.id,
923
+ created_at: new Date('2024-12-30T23:00:00Z'),
924
+ updated_at: new Date('2024-12-30T23:05:00Z'),
925
+ event: 'updated_event',
926
+ details: 'Updated details'
927
+ }
928
+ const updateResult = await storage.updateMonitorEvent(record.id, testValues)
929
+ expect(updateResult).toBe(1)
930
+ const updatedRecords = await storage.findMonitorEvents({
931
+ partial: { id: record.id }
932
+ })
933
+ const updatedRow = verifyOne(
934
+ updatedRecords,
935
+ `Updated MonitorEvent with id=${record.id} was not unique or missing.`
936
+ )
937
+ for (const [key, value] of Object.entries(testValues)) {
938
+ const actualValue = updatedRow[key]
939
+ const normalizedActual = normalizeDate(actualValue)
940
+ const normalizedExpected = normalizeDate(value)
941
+ if (normalizedActual && normalizedExpected) {
942
+ expect(normalizedActual).toBe(normalizedExpected)
943
+ continue
944
+ }
945
+ expect(actualValue).toBe(value)
946
+ }
947
+ } catch (error: any) {
948
+ console.error(`Error updating or verifying MonitorEvent record with id=${record[primaryKey]}:`, error.message)
949
+ throw error
950
+ }
951
+ }
952
+ }
953
+ })
954
+
955
+ test('15_update SyncState', async () => {
956
+ const primaryKey = 'syncStateId'
957
+ for (const { storage } of setups) {
958
+ const records = await storage.findSyncStates({ partial: {} })
959
+ for (const record of records) {
960
+ if (!record.userId) {
961
+ throw new Error(`Missing required foreign key userId for record ${JSON.stringify(record)}`)
962
+ }
963
+ }
964
+ for (const record of records) {
965
+ const testValues: TableSyncState = {
966
+ syncStateId: record.syncStateId,
967
+ userId: record.userId,
968
+ refNum: 'test_refNum',
969
+ created_at: new Date('2025-01-01T00:00:00.000Z'),
970
+ updated_at: new Date('2025-01-01T00:00:00.000Z'),
971
+ errorLocal: 'Example local error',
972
+ errorOther: 'Example other error',
973
+ init: false,
974
+ satoshis: 1000,
975
+ status: 'success',
976
+ storageIdentityKey: 'test_identity_key',
977
+ storageName: 'test_storage',
978
+ syncMap: '{}',
979
+ when: new Date('2025-01-01T02:00:00.000Z')
980
+ }
981
+ const updateResult = await storage.updateSyncState(record.syncStateId, testValues)
982
+ expect(updateResult).toBe(1)
983
+ const updatedRecords = await storage.findSyncStates({
984
+ partial: { syncStateId: record.syncStateId }
985
+ })
986
+ const updatedRow = verifyOne(
987
+ updatedRecords,
988
+ `Updated SyncState with syncStateId=${record.syncStateId} was not unique or missing.`
989
+ )
990
+ for (const [key, value] of Object.entries(testValues)) {
991
+ const actualValue = updatedRow[key]
992
+ if (typeof actualValue === 'boolean') {
993
+ if (value === 1) {
994
+ expect(actualValue).toBe(true)
995
+ } else if (value === 0) {
996
+ expect(actualValue).toBe(false)
997
+ } else {
998
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
999
+ }
1000
+ continue
1001
+ }
1002
+ if (actualValue instanceof Date) {
1003
+ const actualDate = new Date(actualValue)
1004
+ const expectedDate = new Date(value)
1005
+ expect(actualDate.getTime()).toBe(expectedDate.getTime())
1006
+ continue
1007
+ }
1008
+ if (value === undefined || value === null) {
1009
+ expect(actualValue).toBeNull()
1010
+ continue
1011
+ }
1012
+ if (key === 'refNum') {
1013
+ expect(actualValue).toBe('test_refNum')
1014
+ continue
1015
+ }
1016
+ expect(actualValue).toStrictEqual(value)
1017
+ }
1018
+ }
1019
+ }
1020
+ })
1021
+ })