@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,999 @@
1
+ import { _tu, TestSetup1 } from '../../utils/TestUtilsWalletStorage'
2
+ import { sdk, StorageProvider, StorageProviderOptions, verifyOne } from '../../../src/index.client'
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
+ import { StorageIdb } from '../../../src/storage/StorageIdb'
23
+
24
+ import 'fake-indexeddb/auto'
25
+
26
+ setLogging(false)
27
+
28
+ describe('idb update tests', () => {
29
+ jest.setTimeout(99999999)
30
+
31
+ const chain: sdk.Chain = 'test'
32
+ const env = _tu.getEnv(chain)
33
+ let setups: { setup: TestSetup1; storage: StorageProvider }[] = []
34
+
35
+ beforeEach(async () => {
36
+ const options: StorageProviderOptions = StorageProvider.createStorageBaseOptions(chain)
37
+ const storage = new StorageIdb(options)
38
+ await storage.dropAllData()
39
+ await storage.migrate('idb update tests', '1'.repeat(64))
40
+ await storage.makeAvailable()
41
+ const setup = await _tu.createTestSetup1(storage)
42
+ setups = [{ setup, storage }]
43
+ })
44
+
45
+ afterEach(async () => {
46
+ for (const { storage } of setups) {
47
+ await storage.destroy()
48
+ }
49
+ })
50
+
51
+ test('0_update ProvenTx', async () => {
52
+ for (const { storage } of setups) {
53
+ const records = await storage.findProvenTxs({ partial: {} })
54
+ const time = new Date('2001-01-02T12:00:00.000Z')
55
+ for (const record of records) {
56
+ await storage.updateProvenTx(record.provenTxId, {
57
+ blockHash: 'fred',
58
+ updated_at: time
59
+ })
60
+ const t = verifyOne(
61
+ await storage.findProvenTxs({
62
+ partial: { provenTxId: record.provenTxId }
63
+ })
64
+ )
65
+ expect(t.provenTxId).toBe(record.provenTxId)
66
+ expect(t.blockHash).toBe('fred')
67
+ expect(t.updated_at.getTime()).toBe(time.getTime())
68
+ }
69
+ }
70
+ })
71
+
72
+ test('1_update ProvenTx', async () => {
73
+ const primaryKey = 'provenTxId'
74
+ for (const { storage } of setups) {
75
+ const referenceTime = new Date()
76
+ const records = await storage.findProvenTxs({ partial: {} })
77
+ for (const record of records) {
78
+ try {
79
+ const testValues: TableProvenTx = {
80
+ provenTxId: record.provenTxId,
81
+ txid: 'mockTxid',
82
+ created_at: new Date('2024-12-30T23:00:00Z'),
83
+ updated_at: new Date('2024-12-30T23:05:00Z'),
84
+ blockHash: 'mockBlockHash',
85
+ height: 12345,
86
+ index: 1,
87
+ merklePath: [1, 2, 3, 4],
88
+ merkleRoot: '1234',
89
+ rawTx: [4, 3, 2, 1]
90
+ }
91
+ await updateTable(storage.updateProvenTx.bind(storage), record[primaryKey], testValues)
92
+ const updatedTx = verifyOne(
93
+ await storage.findProvenTxs({
94
+ partial: { [primaryKey]: record[primaryKey] }
95
+ })
96
+ )
97
+ verifyValues(updatedTx, testValues, referenceTime)
98
+ for (const [key, value] of Object.entries(testValues)) {
99
+ if (key === primaryKey) {
100
+ continue
101
+ }
102
+ if (typeof value === 'string') {
103
+ const validString = `valid${key}`
104
+ const r1 = await storage.updateProvenTx(record[primaryKey], {
105
+ [key]: validString
106
+ })
107
+ expect(r1).toBe(1)
108
+ const updatedRow = verifyOne(
109
+ await storage.findProvenTxs({
110
+ partial: { [primaryKey]: record[primaryKey] }
111
+ })
112
+ )
113
+ expect(updatedRow[key]).toBe(validString)
114
+ }
115
+ if (typeof value === 'number') {
116
+ const validNumber = value + 1
117
+ const r1 = await storage.updateProvenTx(record[primaryKey], {
118
+ [key]: validNumber
119
+ })
120
+ expect(r1).toBe(1)
121
+ const updatedRow = verifyOne(
122
+ await storage.findProvenTxs({
123
+ partial: { [primaryKey]: record[primaryKey] }
124
+ })
125
+ )
126
+ expect(updatedRow[key]).toBe(validNumber)
127
+ }
128
+ if (value instanceof Date) {
129
+ const validDate = new Date('2024-12-31T00:00:00Z')
130
+ const r1 = await storage.updateProvenTx(record[primaryKey], {
131
+ [key]: validDate
132
+ })
133
+ expect(r1).toBe(1)
134
+ const updatedRow = verifyOne(
135
+ await storage.findProvenTxs({
136
+ partial: { [primaryKey]: record[primaryKey] }
137
+ })
138
+ )
139
+ expect(new Date(updatedRow[key]).toISOString()).toBe(validDate.toISOString())
140
+ }
141
+ if (Array.isArray(value)) {
142
+ const validArray = value.map(v => v + 1)
143
+ const r1 = await storage.updateProvenTx(record[primaryKey], {
144
+ [key]: validArray
145
+ })
146
+ expect(r1).toBe(1)
147
+ const updatedRow = verifyOne(
148
+ await storage.findProvenTxs({
149
+ partial: { [primaryKey]: record[primaryKey] }
150
+ })
151
+ )
152
+ expect(updatedRow[key]).toEqual(validArray)
153
+ }
154
+ }
155
+ } catch (error: any) {
156
+ console.error(
157
+ `Error updating or verifying ProvenTx record with ${primaryKey}=${record[primaryKey]}:`,
158
+ error.message
159
+ )
160
+ throw error
161
+ }
162
+ }
163
+ }
164
+ })
165
+
166
+ test('2_update ProvenTxReq', async () => {
167
+ const primaryKey = 'provenTxReqId'
168
+ for (const { storage } of setups) {
169
+ const records = await storage.findProvenTxReqs({ partial: {} })
170
+ for (const record of records) {
171
+ try {
172
+ const testValues: TableProvenTxReq = {
173
+ provenTxReqId: record.provenTxReqId,
174
+ provenTxId: 1,
175
+ batch: `batch-001`,
176
+ status: 'completed',
177
+ txid: `mockTxid-${Date.now()}`,
178
+ created_at: new Date('2024-12-30T23:00:00Z'),
179
+ updated_at: new Date('2024-12-30T23:05:00Z'),
180
+ attempts: 3,
181
+ history: JSON.stringify({ validated: true, timestamp: Date.now() }),
182
+ inputBEEF: [5, 6, 7, 8],
183
+ notified: true,
184
+ notify: JSON.stringify({ email: 'test@example.com', sent: true }),
185
+ rawTx: [1, 2, 3, 4]
186
+ }
187
+ const r1 = await storage.updateProvenTxReq(record[primaryKey], testValues)
188
+ expect(r1).toBe(1)
189
+ const updatedRow = verifyOne(
190
+ await storage.findProvenTxReqs({
191
+ partial: { [primaryKey]: record[primaryKey] }
192
+ })
193
+ )
194
+ for (const [key, value] of Object.entries(testValues)) {
195
+ const actualValue = updatedRow[key]
196
+ const normalizedActual = normalizeDate(actualValue)
197
+ const normalizedExpected = normalizeDate(value)
198
+ if (normalizedActual && normalizedExpected) {
199
+ expect(normalizedActual).toBe(normalizedExpected)
200
+ continue
201
+ }
202
+ if (typeof value === 'string' && value.startsWith('{') && value.endsWith('}')) {
203
+ expect(JSON.parse(actualValue)).toStrictEqual(JSON.parse(value))
204
+ continue
205
+ }
206
+ if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
207
+ expect(actualValue).toBe(value)
208
+ continue
209
+ }
210
+ if (typeof actualValue === 'object' && Array.isArray(actualValue)) {
211
+ const actualArray = actualValue
212
+ const expectedArray = value
213
+ expect(actualArray).toStrictEqual(expectedArray)
214
+ continue
215
+ }
216
+ expect(JSON.stringify(actualValue)).toStrictEqual(JSON.stringify(value))
217
+ }
218
+ } catch (error: any) {
219
+ console.error(
220
+ `Error updating or verifying ProvenTxReq record with ${primaryKey}=${record[primaryKey]}:`,
221
+ error.message
222
+ )
223
+ throw error
224
+ }
225
+ }
226
+ }
227
+ })
228
+
229
+ test('3_update User', async () => {
230
+ const primaryKey = 'userId'
231
+ for (const { storage } of setups) {
232
+ const records = await storage.findUsers({ partial: {} })
233
+ for (const record of records) {
234
+ try {
235
+ const testValues: TableUser = {
236
+ userId: record.userId,
237
+ identityKey: `mockUpdatedIdentityKey-${record[primaryKey]}`,
238
+ created_at: new Date('2024-12-30T23:00:00Z'),
239
+ updated_at: new Date('2024-12-30T23:05:00Z'),
240
+ activeStorage: storage.getSettings().storageIdentityKey
241
+ }
242
+ const updateResult = await storage.updateUser(record[primaryKey], testValues)
243
+ expect(updateResult).toBe(1)
244
+ const updatedRow = verifyOne(
245
+ await storage.findUsers({
246
+ partial: { [primaryKey]: record[primaryKey] }
247
+ })
248
+ )
249
+ for (const [key, value] of Object.entries(testValues)) {
250
+ const actualValue = updatedRow[key]
251
+ const normalizedActual = normalizeDate(actualValue)
252
+ const normalizedExpected = normalizeDate(value)
253
+ if (normalizedActual && normalizedExpected) {
254
+ expect(normalizedActual).toBe(normalizedExpected)
255
+ continue
256
+ }
257
+ expect(actualValue).toBe(value)
258
+ }
259
+ } catch (error: any) {
260
+ console.error(
261
+ `Error updating or verifying User record with ${primaryKey}=${record[primaryKey]}:`,
262
+ error.message
263
+ )
264
+ throw error
265
+ }
266
+ }
267
+ }
268
+ })
269
+
270
+ test('4_update Certificate', async () => {
271
+ for (const { storage } of setups) {
272
+ const primaryKey = 'certificateId'
273
+ const records = await storage.findCertificates({ partial: {} })
274
+ for (const record of records) {
275
+ try {
276
+ const testValues: TableCertificate = {
277
+ certificateId: record.certificateId,
278
+ userId: 1,
279
+ certifier: `mockCertifier${record.certificateId}`,
280
+ serialNumber: `mockSerialNumber${record.certificateId}`,
281
+ type: `mockType${record.certificateId}`,
282
+ created_at: new Date('2024-12-30T23:00:00Z'),
283
+ updated_at: new Date('2024-12-30T23:05:00Z'),
284
+ isDeleted: false,
285
+ revocationOutpoint: 'mockRevocationOutpoint',
286
+ signature: 'mockSignature',
287
+ subject: 'mockSubject'
288
+ }
289
+ const r1 = await storage.updateCertificate(record[primaryKey], testValues)
290
+ expect(r1).toBe(1)
291
+ const updatedRow = verifyOne(
292
+ await storage.findCertificates({
293
+ partial: { [primaryKey]: record[primaryKey] }
294
+ })
295
+ )
296
+ for (const [key, value] of Object.entries(testValues)) {
297
+ const actualValue = updatedRow[key]
298
+ const normalizedActual = normalizeDate(actualValue)
299
+ const normalizedExpected = normalizeDate(value)
300
+ if (normalizedActual && normalizedExpected) {
301
+ expect(normalizedActual).toBe(normalizedExpected)
302
+ continue
303
+ }
304
+ if (typeof value === 'string' && value.startsWith('{') && value.endsWith('}')) {
305
+ expect(JSON.parse(actualValue)).toStrictEqual(JSON.parse(value))
306
+ continue
307
+ }
308
+ if (typeof actualValue === 'boolean') {
309
+ if (value === 1 || value) {
310
+ expect(actualValue).toBe(true)
311
+ } else if (value === 0 || value === false) {
312
+ expect(actualValue).toBe(false)
313
+ } else {
314
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
315
+ }
316
+ continue
317
+ }
318
+ if (typeof value === 'string' || typeof value === 'number') {
319
+ expect(actualValue).toBe(value)
320
+ continue
321
+ }
322
+ if (typeof actualValue === 'object' && actualValue?.type === 'Buffer') {
323
+ const actualArray = actualValue.data || actualValue
324
+ const expectedArray =
325
+ Buffer.isBuffer(value) || Array.isArray(value) ? Array.from(value as ArrayLike<number>) : value
326
+ expect(actualArray).toStrictEqual(expectedArray)
327
+ continue
328
+ }
329
+ expect(JSON.stringify({ type: 'Buffer', data: actualValue })).toStrictEqual(JSON.stringify(value))
330
+ }
331
+ } catch (error: any) {
332
+ console.error(
333
+ `Error updating or verifying Certificate record with ${primaryKey}=${record[primaryKey]}:`,
334
+ error.message
335
+ )
336
+ throw error
337
+ }
338
+ }
339
+ }
340
+ })
341
+
342
+ test('5_update CertificateField', async () => {
343
+ const primaryKey = 'certificateId'
344
+ for (const { storage } of setups) {
345
+ const records = await storage.findCertificateFields({
346
+ partial: { fieldName: 'bob' }
347
+ })
348
+ for (const record of records) {
349
+ try {
350
+ const testValues: TableCertificateField = {
351
+ certificateId: record.certificateId,
352
+ userId: record.userId ?? 1,
353
+ created_at: new Date('2024-12-30T23:00:00Z'),
354
+ updated_at: new Date('2024-12-30T23:05:00Z'),
355
+ fieldName: record.fieldName || 'defaultFieldName',
356
+ fieldValue: 'your uncle',
357
+ masterKey: 'key'
358
+ }
359
+ const updateResult = await storage.updateCertificateField(
360
+ record.certificateId,
361
+ testValues.fieldName,
362
+ testValues
363
+ )
364
+ expect(updateResult).toBe(1)
365
+ const updatedRecords = await storage.findCertificateFields({
366
+ partial: {
367
+ certificateId: record.certificateId,
368
+ fieldName: testValues.fieldName
369
+ }
370
+ })
371
+ const updatedRow = verifyOne(
372
+ updatedRecords,
373
+ `Updated CertificateField with certificateId=${record.certificateId}, fieldName=${testValues.fieldName} was not unique or missing.`
374
+ )
375
+ for (const [key, value] of Object.entries(testValues)) {
376
+ const actualValue = updatedRow[key]
377
+ const normalizedActual = normalizeDate(actualValue)
378
+ const normalizedExpected = normalizeDate(value)
379
+ if (normalizedActual && normalizedExpected) {
380
+ expect(normalizedActual).toBe(normalizedExpected)
381
+ continue
382
+ }
383
+ expect(actualValue).toBe(value)
384
+ }
385
+ } catch (error: any) {
386
+ console.error(
387
+ `Error updating or verifying CertificateField record with certificateId=${record[primaryKey]}:`,
388
+ error.message
389
+ )
390
+ throw error
391
+ }
392
+ }
393
+ }
394
+ })
395
+
396
+ test('6_update OutputBasket', async () => {
397
+ const primaryKey = 'basketId'
398
+ for (const { storage } of setups) {
399
+ const records = await storage.findOutputBaskets({ partial: {} })
400
+ for (const record of records) {
401
+ try {
402
+ const testValues: TableOutputBasket = {
403
+ basketId: record.basketId,
404
+ userId: record.userId ?? 1,
405
+ created_at: new Date('2024-12-30T23:00:00Z'),
406
+ updated_at: new Date('2024-12-30T23:05:00Z'),
407
+ name: record.name || 'defaultName',
408
+ numberOfDesiredUTXOs: 99,
409
+ minimumDesiredUTXOValue: 5000,
410
+ isDeleted: false
411
+ }
412
+ const updateResult = await storage.updateOutputBasket(record.basketId, testValues)
413
+ expect(updateResult).toBe(1)
414
+ const updatedRecords = await storage.findOutputBaskets({
415
+ partial: { basketId: record.basketId, name: testValues.name }
416
+ })
417
+ const updatedRow = verifyOne(
418
+ updatedRecords,
419
+ `Updated OutputBasket with basketId=${record.basketId}, name=${testValues.name} was not unique or missing.`
420
+ )
421
+ for (const [key, value] of Object.entries(testValues)) {
422
+ const actualValue = updatedRow[key]
423
+ if (typeof actualValue === 'boolean') {
424
+ if (value === 1 || value === true) {
425
+ expect(actualValue).toBe(true)
426
+ } else if (value === 0 || value === false) {
427
+ expect(actualValue).toBe(false)
428
+ } else {
429
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
430
+ }
431
+ continue
432
+ }
433
+ const normalizedActual = normalizeDate(actualValue)
434
+ const normalizedExpected = normalizeDate(value)
435
+ if (normalizedActual && normalizedExpected) {
436
+ expect(normalizedActual).toBe(normalizedExpected)
437
+ continue
438
+ }
439
+ expect(actualValue).toBe(value)
440
+ }
441
+ } catch (error: any) {
442
+ console.error(
443
+ `Error updating or verifying OutputBasket record with basketId=${record[primaryKey]}:`,
444
+ error.message
445
+ )
446
+ throw error
447
+ }
448
+ }
449
+ }
450
+ })
451
+
452
+ test('7_update Transaction', async () => {
453
+ const primaryKey = 'transactionId'
454
+ for (const { storage } of setups) {
455
+ const records = await storage.findTransactions({ partial: {} })
456
+ for (const record of records) {
457
+ try {
458
+ const testValues: TableTransaction = {
459
+ transactionId: record.transactionId,
460
+ userId: record.userId ?? 1,
461
+ provenTxId: 1,
462
+ reference: `updated_reference_string_${record.transactionId}==`,
463
+ status: 'confirmed' as sdk.TransactionStatus,
464
+ txid: `updated_txid_example_${record.transactionId}`,
465
+ created_at: new Date('2024-12-30T23:00:00Z'),
466
+ updated_at: new Date('2024-12-30T23:05:00Z'),
467
+ description: 'Updated transaction description',
468
+ isOutgoing: false,
469
+ lockTime: 600000000,
470
+ satoshis: 20000,
471
+ version: 2
472
+ }
473
+ const updateResult = await storage.updateTransaction(record.transactionId, testValues)
474
+ expect(updateResult).toBe(1)
475
+ const updatedRecords = await storage.findTransactions({
476
+ partial: { transactionId: record.transactionId }
477
+ })
478
+ const updatedRow = verifyOne(
479
+ updatedRecords,
480
+ `Updated Transaction with transactionId=${record.transactionId} was not unique or missing.`
481
+ )
482
+ for (const [key, value] of Object.entries(testValues)) {
483
+ const actualValue = updatedRow[key]
484
+ const normalizedActual = normalizeDate(actualValue)
485
+ const normalizedExpected = normalizeDate(value)
486
+ if (normalizedActual && normalizedExpected) {
487
+ expect(normalizedActual).toBe(normalizedExpected)
488
+ continue
489
+ }
490
+ expect(actualValue).toBe(value)
491
+ }
492
+ } catch (error: any) {
493
+ console.error(
494
+ `Error updating or verifying Transaction record with transactionId=${record[primaryKey]}:`,
495
+ error.message
496
+ )
497
+ throw error
498
+ }
499
+ }
500
+ }
501
+ })
502
+
503
+ test('7a updateTransactionStatus', async () => {
504
+ const { activeStorage: storage } = await _tu.createLegacyWalletSQLiteCopy('idb_updateTransactionStatus7a')
505
+
506
+ let tx = verifyOne(
507
+ await storage.findTransactions({
508
+ partial: { status: 'unproven' },
509
+ paged: { limit: 1 }
510
+ })
511
+ )
512
+ expect(tx.status).toBe('unproven')
513
+ await storage.updateTransactionStatus('completed', tx.transactionId)
514
+ tx = verifyOne(
515
+ await storage.findTransactions({
516
+ partial: { transactionId: tx.transactionId }
517
+ })
518
+ )
519
+ expect(tx.status).toBe('completed')
520
+
521
+ await storage.destroy()
522
+ })
523
+
524
+ test('8_update Commission', async () => {
525
+ const primaryKey = 'commissionId'
526
+ for (const { storage } of setups) {
527
+ const records = await storage.findCommissions({ partial: {} })
528
+ for (const record of records) {
529
+ try {
530
+ const testValues: TableCommission = {
531
+ commissionId: record.commissionId,
532
+ userId: record.userId ?? 1,
533
+ transactionId: record.transactionId ?? 1,
534
+ created_at: new Date('2024-12-30T23:00:00Z'),
535
+ updated_at: new Date('2024-12-30T23:05:00Z'),
536
+ satoshis: 300,
537
+ keyOffset: `updated_key_offset_${record.commissionId}`,
538
+ isRedeemed: true,
539
+ lockingScript: [1, 2, 3, 4]
540
+ }
541
+ const updateResult = await storage.updateCommission(record.commissionId, testValues)
542
+ expect(updateResult).toBe(1)
543
+ const updatedRecords = await storage.findCommissions({
544
+ partial: { commissionId: record.commissionId }
545
+ })
546
+ const updatedRow = verifyOne(
547
+ updatedRecords,
548
+ `Updated Commission with commissionId=${record.commissionId} was not unique or missing.`
549
+ )
550
+ for (const [key, value] of Object.entries(testValues)) {
551
+ const actualValue = updatedRow[key]
552
+ const normalizedActual = normalizeDate(actualValue)
553
+ const normalizedExpected = normalizeDate(value)
554
+ if (normalizedActual && normalizedExpected) {
555
+ expect(normalizedActual).toBe(normalizedExpected)
556
+ continue
557
+ }
558
+ if (Array.isArray(actualValue)) {
559
+ expect(actualValue).toStrictEqual(value)
560
+ continue
561
+ }
562
+ expect(actualValue).toBe(value)
563
+ }
564
+ } catch (error: any) {
565
+ console.error(
566
+ `Error updating or verifying Commission record with commissionId=${record[primaryKey]}:`,
567
+ error.message
568
+ )
569
+ throw error
570
+ }
571
+ }
572
+ }
573
+ })
574
+
575
+ test('9_update Output', async () => {
576
+ const primaryKey = 'outputId'
577
+ for (const { storage } of setups) {
578
+ const records = await storage.findOutputs({ partial: {} })
579
+ for (const record of records) {
580
+ if (!record.transactionId) record.transactionId = 1
581
+ if (!record.basketId) record.basketId = 1
582
+ if (!record.userId || !record.transactionId || !record.basketId) {
583
+ throw new Error(`Missing required foreign keys for record ${JSON.stringify(record)}`)
584
+ }
585
+ }
586
+ for (const record of records) {
587
+ const existingRecords = await storage.findOutputs({ partial: {} })
588
+ const usedCombinations = new Set(existingRecords.map(r => `${r.transactionId}-${r.vout}-${r.userId}`))
589
+ let testTransactionId = record.transactionId
590
+ let testVout = record.vout + 1
591
+ let testUserId = record.userId
592
+ while (usedCombinations.has(`${testTransactionId}-${testVout}-${testUserId}`)) {
593
+ testVout += 1
594
+ }
595
+ try {
596
+ const testValues: TableOutput = {
597
+ outputId: record.outputId,
598
+ basketId: record.basketId ?? 1,
599
+ transactionId: testTransactionId,
600
+ userId: testUserId,
601
+ vout: testVout,
602
+ created_at: new Date('2024-12-30T23:00:00Z'),
603
+ updated_at: new Date('2024-12-30T23:05:00Z'),
604
+ change: true,
605
+ customInstructions: 'Updated instructions',
606
+ derivationPrefix: 'updated_prefix==',
607
+ derivationSuffix: 'updated_suffix==',
608
+ lockingScript: [0x01, 0x02, 0x03, 0x04],
609
+ providedBy: 'you',
610
+ purpose: 'updated_purpose',
611
+ satoshis: 3000,
612
+ scriptLength: 150,
613
+ scriptOffset: 5,
614
+ senderIdentityKey: 'updated_sender_key',
615
+ sequenceNumber: 10,
616
+ spendingDescription: 'Updated spending description',
617
+ spendable: false,
618
+ spentBy: 3,
619
+ txid: 'updated_txid',
620
+ type: 'updated_type',
621
+ outputDescription: 'outputDescription'
622
+ }
623
+ const updateResult = await storage.updateOutput(record.outputId, testValues)
624
+ expect(updateResult).toBe(1)
625
+ const updatedRecords = await storage.findOutputs({
626
+ partial: { outputId: record.outputId }
627
+ })
628
+ const updatedRow = verifyOne(
629
+ updatedRecords,
630
+ `Updated Output with outputId=${record.outputId} was not unique or missing.`
631
+ )
632
+ for (const [key, value] of Object.entries(testValues)) {
633
+ const actualValue = updatedRow[key]
634
+ const normalizedActual = normalizeDate(actualValue)
635
+ const normalizedExpected = normalizeDate(value)
636
+ if (normalizedActual && normalizedExpected) {
637
+ expect(normalizedActual).toBe(normalizedExpected)
638
+ continue
639
+ }
640
+ if (Array.isArray(actualValue)) {
641
+ expect(actualValue).toStrictEqual(value)
642
+ continue
643
+ }
644
+ expect(actualValue).toBe(value)
645
+ }
646
+ } catch (error: any) {
647
+ console.error(`Error updating or verifying Output record with outputId=${record[primaryKey]}:`, error.message)
648
+ throw error
649
+ }
650
+ }
651
+ }
652
+ })
653
+
654
+ test('10_update OutputTag', async () => {
655
+ const primaryKey = 'outputTagId'
656
+ for (const { storage } of setups) {
657
+ const records = await storage.findOutputTags({ partial: {} })
658
+ for (const record of records) {
659
+ if (!record.userId) record.userId = 1
660
+ if (!record.tag) record.tag = `default_tag_${record.outputTagId}`
661
+ if (!record.userId || !record.tag) {
662
+ throw new Error(`Missing required fields for record ${JSON.stringify(record)}`)
663
+ }
664
+ }
665
+ for (const record of records) {
666
+ const uniqueTag = `updated_tag_${record.outputTagId}`
667
+ const testValues: TableOutputTag = {
668
+ outputTagId: record.outputTagId,
669
+ userId: record.userId,
670
+ tag: uniqueTag,
671
+ created_at: new Date('2024-12-30T23:00:00Z'),
672
+ updated_at: new Date('2024-12-30T23:05:00Z'),
673
+ isDeleted: false
674
+ }
675
+ try {
676
+ const updateResult = await storage.updateOutputTag(record.outputTagId, testValues)
677
+ expect(updateResult).toBe(1)
678
+ const updatedRecords = await storage.findOutputTags({
679
+ partial: { outputTagId: record.outputTagId }
680
+ })
681
+ const updatedRow = verifyOne(
682
+ updatedRecords,
683
+ `Updated OutputTag with outputTagId=${record.outputTagId} was not unique or missing.`
684
+ )
685
+ for (const [key, value] of Object.entries(testValues)) {
686
+ const actualValue = updatedRow[key]
687
+ if (typeof actualValue === 'boolean') {
688
+ if (value === 1 || value === true) {
689
+ expect(actualValue).toBe(true)
690
+ } else if (value === 0 || value === false) {
691
+ expect(actualValue).toBe(false)
692
+ } else {
693
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
694
+ }
695
+ continue
696
+ }
697
+ const normalizedActual = normalizeDate(actualValue)
698
+ const normalizedExpected = normalizeDate(value)
699
+ if (normalizedActual && normalizedExpected) {
700
+ expect(normalizedActual).toBe(normalizedExpected)
701
+ continue
702
+ }
703
+ expect(actualValue).toBe(value)
704
+ }
705
+ } catch (error: any) {
706
+ console.error(
707
+ `Error updating or verifying OutputTag record with outputTagId=${record[primaryKey]}:`,
708
+ error.message
709
+ )
710
+ throw error
711
+ }
712
+ }
713
+ }
714
+ })
715
+
716
+ test('11_update OutputTagMap', async () => {
717
+ const primaryKey = ['outputTagId', 'outputId']
718
+ for (const { storage } of setups) {
719
+ const records = await storage.findOutputTagMaps({ partial: {} })
720
+ for (const record of records) {
721
+ if (!record.outputTagId) throw new Error(`Missing outputTagId for record: ${JSON.stringify(record)}`)
722
+ if (!record.outputId) throw new Error(`Missing outputId for record: ${JSON.stringify(record)}`)
723
+ try {
724
+ const testValues: TableOutputTagMap = {
725
+ outputTagId: record.outputTagId,
726
+ outputId: record.outputId,
727
+ created_at: new Date('2024-12-30T23:00:00Z'),
728
+ updated_at: new Date('2024-12-30T23:05:00Z'),
729
+ isDeleted: false
730
+ }
731
+ const updateResult = await storage.updateOutputTagMap(record.outputId, record.outputTagId, testValues)
732
+ expect(updateResult).toBe(1)
733
+ const updatedRecords = await storage.findOutputTagMaps({
734
+ partial: {
735
+ outputTagId: record.outputTagId,
736
+ outputId: record.outputId
737
+ }
738
+ })
739
+ const updatedRow = verifyOne(
740
+ updatedRecords,
741
+ `Updated OutputTagMap with outputTagId=${record.outputTagId} and outputId=${record.outputId} was not unique or missing.`
742
+ )
743
+ for (const [key, value] of Object.entries(testValues)) {
744
+ const actualValue = updatedRow[key]
745
+ if (typeof actualValue === 'boolean') {
746
+ if (value === 1 || value === true) {
747
+ expect(actualValue).toBe(true)
748
+ } else if (value === 0 || value === false) {
749
+ expect(actualValue).toBe(false)
750
+ } else {
751
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
752
+ }
753
+ continue
754
+ }
755
+ const normalizedActual = normalizeDate(actualValue)
756
+ const normalizedExpected = normalizeDate(value)
757
+ if (normalizedActual && normalizedExpected) {
758
+ expect(normalizedActual).toBe(normalizedExpected)
759
+ continue
760
+ }
761
+ expect(actualValue).toBe(value)
762
+ }
763
+ } catch (error: any) {
764
+ console.error(
765
+ `Error updating or verifying OutputTagMap record with outputTagId=${record.outputTagId} and outputId=${record.outputId}:`,
766
+ error.message
767
+ )
768
+ throw error
769
+ }
770
+ }
771
+ }
772
+ })
773
+
774
+ test('12_update TxLabel', async () => {
775
+ const primaryKey = 'txLabelId'
776
+ for (const { storage } of setups) {
777
+ const records = await storage.findTxLabels({ partial: {} })
778
+ for (const record of records) {
779
+ if (!record.userId) {
780
+ throw new Error(`Missing required foreign key userId for record ${JSON.stringify(record)}`)
781
+ }
782
+ }
783
+ for (const record of records) {
784
+ const uniqueLabel = `unique_label_${record.txLabelId}`
785
+ const testValues: TableTxLabel = {
786
+ txLabelId: record.txLabelId,
787
+ userId: record.userId,
788
+ label: uniqueLabel,
789
+ isDeleted: false,
790
+ created_at: new Date('2024-12-30T23:00:00Z'),
791
+ updated_at: new Date('2024-12-30T23:05:00Z')
792
+ }
793
+ const existingLabel = await storage.findTxLabels({
794
+ partial: { label: testValues.label, userId: testValues.userId }
795
+ })
796
+ if (existingLabel.length > 0) {
797
+ continue
798
+ }
799
+ const updateResult = await storage.updateTxLabel(record.txLabelId, testValues)
800
+ expect(updateResult).toBe(1)
801
+ const updatedRecords = await storage.findTxLabels({
802
+ partial: { txLabelId: record.txLabelId }
803
+ })
804
+ const updatedRow = verifyOne(
805
+ updatedRecords,
806
+ `Updated TxLabel with txLabelId=${record.txLabelId} was not unique or missing.`
807
+ )
808
+ for (const [key, value] of Object.entries(testValues)) {
809
+ const actualValue = updatedRow[key]
810
+ if (typeof actualValue === 'boolean') {
811
+ if (value === 1 || value === true) {
812
+ expect(actualValue).toBe(true)
813
+ } else if (value === 0 || value === false) {
814
+ expect(actualValue).toBe(false)
815
+ } else {
816
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
817
+ }
818
+ continue
819
+ }
820
+ const normalizedActual = normalizeDate(actualValue)
821
+ const normalizedExpected = normalizeDate(value)
822
+ if (normalizedActual && normalizedExpected) {
823
+ expect(normalizedActual).toBe(normalizedExpected)
824
+ continue
825
+ }
826
+ expect(actualValue).toBe(value)
827
+ }
828
+ }
829
+ }
830
+ })
831
+
832
+ test('13_update TxLabelMap', async () => {
833
+ const primaryKeyTransaction = 'transactionId'
834
+ const primaryKeyLabel = 'txLabelId'
835
+ for (const { storage, setup } of setups) {
836
+ const records = await storage.findTxLabelMaps({ partial: {} })
837
+ for (const record of records) {
838
+ if (!record.transactionId || !record.txLabelId) {
839
+ throw new Error(`Missing required foreign keys for record ${JSON.stringify(record)}`)
840
+ }
841
+ }
842
+ for (const record of records) {
843
+ const testValues: TableTxLabelMap = {
844
+ transactionId: record.transactionId,
845
+ txLabelId: record.txLabelId,
846
+ created_at: new Date('2024-12-30T23:00:00Z'),
847
+ updated_at: new Date('2024-12-30T23:05:00Z'),
848
+ isDeleted: false
849
+ }
850
+ const existingRecord = await storage.findTxLabelMaps({
851
+ partial: {
852
+ transactionId: testValues.transactionId,
853
+ txLabelId: testValues.txLabelId
854
+ }
855
+ })
856
+ if (existingRecord.length > 0) {
857
+ continue
858
+ }
859
+ try {
860
+ const updateResult = await storage.updateTxLabelMap(record.transactionId, record.txLabelId, testValues)
861
+ expect(updateResult).toBe(1)
862
+ const updatedRecords = await storage.findTxLabelMaps({
863
+ partial: {
864
+ transactionId: record.transactionId,
865
+ txLabelId: record.txLabelId
866
+ }
867
+ })
868
+ const updatedRow = verifyOne(
869
+ updatedRecords,
870
+ `Updated TxLabelMap with transactionId=${record[primaryKeyTransaction]} and txLabelId=${record[primaryKeyLabel]} was not unique or missing.`
871
+ )
872
+ for (const [key, value] of Object.entries(testValues)) {
873
+ const actualValue = updatedRow[key]
874
+ const normalizedActual = normalizeDate(actualValue)
875
+ const normalizedExpected = normalizeDate(value)
876
+ if (normalizedActual && normalizedExpected) {
877
+ expect(normalizedActual).toBe(normalizedExpected)
878
+ continue
879
+ }
880
+ expect(actualValue).toBe(value)
881
+ }
882
+ } catch (error: any) {
883
+ console.error(
884
+ `Error updating or verifying TxLabelMap record with transactionId=${record[primaryKeyTransaction]} and txLabelId=${record[primaryKeyLabel]}:`,
885
+ error.message
886
+ )
887
+ throw error
888
+ }
889
+ }
890
+ }
891
+ })
892
+
893
+ test('14_update MonitorEvent', async () => {
894
+ const primaryKey = 'id'
895
+ for (const { storage, setup } of setups) {
896
+ const records = await storage.findMonitorEvents({ partial: {} })
897
+ for (const record of records) {
898
+ try {
899
+ const testValues: TableMonitorEvent = {
900
+ id: record.id,
901
+ created_at: new Date('2024-12-30T23:00:00Z'),
902
+ updated_at: new Date('2024-12-30T23:05:00Z'),
903
+ event: 'updated_event',
904
+ details: 'Updated details'
905
+ }
906
+ const updateResult = await storage.updateMonitorEvent(record.id, testValues)
907
+ expect(updateResult).toBe(1)
908
+ const updatedRecords = await storage.findMonitorEvents({
909
+ partial: { id: record.id }
910
+ })
911
+ const updatedRow = verifyOne(
912
+ updatedRecords,
913
+ `Updated MonitorEvent with id=${record.id} was not unique or missing.`
914
+ )
915
+ for (const [key, value] of Object.entries(testValues)) {
916
+ const actualValue = updatedRow[key]
917
+ const normalizedActual = normalizeDate(actualValue)
918
+ const normalizedExpected = normalizeDate(value)
919
+ if (normalizedActual && normalizedExpected) {
920
+ expect(normalizedActual).toBe(normalizedExpected)
921
+ continue
922
+ }
923
+ expect(actualValue).toBe(value)
924
+ }
925
+ } catch (error: any) {
926
+ console.error(`Error updating or verifying MonitorEvent record with id=${record[primaryKey]}:`, error.message)
927
+ throw error
928
+ }
929
+ }
930
+ }
931
+ })
932
+
933
+ test('15_update SyncState', async () => {
934
+ const primaryKey = 'syncStateId'
935
+ for (const { storage } of setups) {
936
+ const records = await storage.findSyncStates({ partial: {} })
937
+ for (const record of records) {
938
+ if (!record.userId) {
939
+ throw new Error(`Missing required foreign key userId for record ${JSON.stringify(record)}`)
940
+ }
941
+ }
942
+ for (const record of records) {
943
+ const testValues: TableSyncState = {
944
+ syncStateId: record.syncStateId,
945
+ userId: record.userId,
946
+ refNum: 'test_refNum',
947
+ created_at: new Date('2025-01-01T00:00:00.000Z'),
948
+ updated_at: new Date('2025-01-01T00:00:00.000Z'),
949
+ errorLocal: 'Example local error',
950
+ errorOther: 'Example other error',
951
+ init: false,
952
+ satoshis: 1000,
953
+ status: 'success',
954
+ storageIdentityKey: 'test_identity_key',
955
+ storageName: 'test_storage',
956
+ syncMap: '{}',
957
+ when: new Date('2025-01-01T02:00:00.000Z')
958
+ }
959
+ const updateResult = await storage.updateSyncState(record.syncStateId, testValues)
960
+ expect(updateResult).toBe(1)
961
+ const updatedRecords = await storage.findSyncStates({
962
+ partial: { syncStateId: record.syncStateId }
963
+ })
964
+ const updatedRow = verifyOne(
965
+ updatedRecords,
966
+ `Updated SyncState with syncStateId=${record.syncStateId} was not unique or missing.`
967
+ )
968
+ for (const [key, value] of Object.entries(testValues)) {
969
+ const actualValue = updatedRow[key]
970
+ if (typeof actualValue === 'boolean') {
971
+ if (value === 1 || value === true) {
972
+ expect(actualValue).toBe(true)
973
+ } else if (value === 0 || value === false) {
974
+ expect(actualValue).toBe(false)
975
+ } else {
976
+ throw new Error(`Unexpected value for expectedValue: ${value}. Must be 0 or 1.`)
977
+ }
978
+ continue
979
+ }
980
+ if (typeof actualValue === 'object' && actualValue.constructor.name === 'Date') {
981
+ const actualDate = new Date(actualValue)
982
+ const expectedDate = new Date(value)
983
+ expect(actualDate.getTime()).toBe(expectedDate.getTime())
984
+ continue
985
+ }
986
+ if (value === undefined || value === null) {
987
+ expect(actualValue).toBeNull()
988
+ continue
989
+ }
990
+ if (key === 'refNum') {
991
+ expect(actualValue).toBe('test_refNum')
992
+ continue
993
+ }
994
+ expect(actualValue).toStrictEqual(value)
995
+ }
996
+ }
997
+ }
998
+ })
999
+ })