@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,43 @@
1
+ import { PrivateKey } from '@bsv/sdk'
2
+ import { Setup } from '../../Setup'
3
+ import { SetupClient } from '../../SetupClient'
4
+ import { StorageIdb } from '../StorageIdb'
5
+ import { StorageProvider, StorageProviderOptions } from '../StorageProvider'
6
+ import 'fake-indexeddb/auto'
7
+
8
+ describe('StorageIdb tests', () => {
9
+ jest.setTimeout(99999999)
10
+
11
+ test('0', async () => {
12
+ const options: StorageProviderOptions = StorageProvider.createStorageBaseOptions('main')
13
+ const storage = new StorageIdb(options)
14
+ const r = await storage.migrate('storageIdbTest', `42`.repeat(32))
15
+ const db = storage.db!
16
+ expect(db).toBeTruthy()
17
+ })
18
+
19
+ test.skip('1', async () => {
20
+ // TODO: THIS TEST PASSES WHEN Describe is run alone, but fails to exit cleanly when run with `npm run test`
21
+ if (Setup.noEnv('test')) return
22
+ const env = Setup.getEnv('test')
23
+ const wallet = await SetupClient.createWalletClientNoEnv({
24
+ chain: env.chain,
25
+ rootKeyHex: env.devKeys[env.identityKey]
26
+ })
27
+ const stores = wallet.storage.getStores()
28
+ const options = StorageIdb.createStorageBaseOptions(wallet.chain)
29
+ const store = new StorageIdb(options)
30
+ await store.migrate(store.dbName, PrivateKey.fromRandom().toHex())
31
+ await store.makeAvailable()
32
+ await wallet.storage.addWalletStorageProvider(store)
33
+ await wallet.storage.setActive(stores[0].storageIdentityKey, s => {
34
+ console.log(s)
35
+ return s
36
+ })
37
+ await wallet.storage.updateBackups(undefined, s => {
38
+ console.log(s)
39
+ return s
40
+ })
41
+ await wallet.destroy()
42
+ })
43
+ })
@@ -0,0 +1,275 @@
1
+ import * as bsv from '@bsv/sdk'
2
+ import { StorageKnex, wait, WalletStorageManager } from '../..'
3
+ import { _tu, TestWalletNoSetup } from '../../../test/utils/TestUtilsWalletStorage'
4
+
5
+ import * as dotenv from 'dotenv'
6
+
7
+ dotenv.config()
8
+ describe('WalletStorageManager tests', () => {
9
+ jest.setTimeout(99999999)
10
+
11
+ const env = _tu.getEnvFlags('test')
12
+ const ctxs: TestWalletNoSetup[] = []
13
+
14
+ beforeAll(async () => {
15
+ if (env.runMySQL) ctxs.push(await _tu.createLegacyWalletMySQLCopy('walletStorageManagerTestSource'))
16
+ ctxs.push(await _tu.createLegacyWalletSQLiteCopy('walletStorageManagerTestSource'))
17
+ })
18
+
19
+ afterAll(async () => {
20
+ for (const ctx of ctxs) {
21
+ await ctx.storage.destroy()
22
+ }
23
+ })
24
+
25
+ const root = '02135476'
26
+ const kp = _tu.getKeyPair(root.repeat(8))
27
+ const fredsAddress = kp.address
28
+
29
+ test('1_runAsReader runAsWriter runAsSync interlock correctly', async () => {
30
+ const { storage } = await _tu.createSQLiteTestSetup1Wallet({
31
+ databaseName: 'syncTest1'
32
+ })
33
+
34
+ interface Result {
35
+ i: Number
36
+ t: 'reader' | 'writer' | 'sync'
37
+ start: number
38
+ end: number
39
+ }
40
+ const result: Result[] = []
41
+ const promises: Promise<Result>[] = []
42
+
43
+ const now = Date.now()
44
+
45
+ const makeReader = (i: number, duration: number): void => {
46
+ promises.push(
47
+ storage.runAsReader(async reader => {
48
+ const start = Date.now() - now
49
+ await wait(duration)
50
+ const end = Date.now() - now
51
+ const r: Result = { start, end, t: 'reader', i }
52
+ result.push(r)
53
+ return r
54
+ })
55
+ )
56
+ }
57
+
58
+ const makeWriter = (i: number, duration: number): void => {
59
+ promises.push(
60
+ storage.runAsWriter(async sync => {
61
+ const start = Date.now() - now
62
+ await wait(duration)
63
+ const end = Date.now() - now
64
+ const r: Result = { start, end, t: 'writer', i }
65
+ result.push(r)
66
+ return r
67
+ })
68
+ )
69
+ }
70
+
71
+ const makeSync = (i: number, duration: number): void => {
72
+ promises.push(
73
+ storage.runAsSync(async sync => {
74
+ const start = Date.now() - now
75
+ await wait(duration)
76
+ const end = Date.now() - now
77
+ const r: Result = { start, end, t: 'sync', i }
78
+ result.push(r)
79
+ return r
80
+ })
81
+ )
82
+ }
83
+
84
+ let i = 0
85
+ for (let j = 0; j < 5; j++) makeReader(i++, 10 + j * 10)
86
+ makeSync(i++, 5000)
87
+ for (let j = 0; j < 5; j++) {
88
+ makeReader(i++, 10 + j * 10)
89
+ makeWriter(i++, 30 + j * 500)
90
+ }
91
+ makeSync(i++, 5000)
92
+ for (let j = 0; j < 5; j++) makeReader(i++, 10 + j * 10)
93
+
94
+ await Promise.all(promises)
95
+ expect(result).toBeTruthy()
96
+
97
+ let log = ''
98
+ for (const r of result) {
99
+ const overlaps = result.filter(
100
+ r2 => r2.i != r.i && (r2.t != 'reader' || r.t != 'reader') && r.start > r2.start && r.start < r2.end
101
+ )
102
+ if (overlaps.length > 0) {
103
+ log += `${r.i} ${r.t} ${r.start} overlaps:\n`
104
+ for (const o of overlaps) log += ` ${o.i} ${o.t} ${o.start} ${o.end}\n`
105
+ }
106
+ }
107
+
108
+ if (log.length > 0) {
109
+ console.log(log)
110
+ expect(log.length).toBe(0)
111
+ }
112
+
113
+ await storage.destroy()
114
+ })
115
+
116
+ test('1a_runAsReader runAsWriter runAsSync interlock correctly with low durations', async () => {
117
+ const { storage } = await _tu.createSQLiteTestSetup1Wallet({
118
+ databaseName: 'syncTest1a'
119
+ })
120
+
121
+ interface Result {
122
+ i: Number
123
+ t: 'reader' | 'writer' | 'sync'
124
+ start: number
125
+ end: number
126
+ }
127
+ const result: Result[] = []
128
+ const promises: Promise<Result>[] = []
129
+
130
+ const now = Date.now()
131
+
132
+ const makeReader = (i: number, duration: number): void => {
133
+ promises.push(
134
+ storage.runAsReader(async reader => {
135
+ const start = Date.now() - now
136
+ await wait(duration)
137
+ const end = Date.now() - now
138
+ const r: Result = { start, end, t: 'reader', i }
139
+ result.push(r)
140
+ return r
141
+ })
142
+ )
143
+ }
144
+
145
+ const makeWriter = (i: number, duration: number): void => {
146
+ promises.push(
147
+ storage.runAsWriter(async sync => {
148
+ const start = Date.now() - now
149
+ await wait(duration)
150
+ const end = Date.now() - now
151
+ const r: Result = { start, end, t: 'writer', i }
152
+ result.push(r)
153
+ return r
154
+ })
155
+ )
156
+ }
157
+
158
+ const makeSync = (i: number, duration: number): void => {
159
+ promises.push(
160
+ storage.runAsSync(async sync => {
161
+ const start = Date.now() - now
162
+ await wait(duration)
163
+ const end = Date.now() - now
164
+ const r: Result = { start, end, t: 'sync', i }
165
+ result.push(r)
166
+ return r
167
+ })
168
+ )
169
+ }
170
+
171
+ let i = 0
172
+ for (let j = 0; j < 5; j++) makeReader(i++, j)
173
+ makeSync(i++, 5000)
174
+ for (let j = 0; j < 5; j++) {
175
+ makeReader(i++, j)
176
+ makeWriter(i++, j)
177
+ }
178
+ makeSync(i++, 5000)
179
+ for (let j = 0; j < 5; j++) makeReader(i++, j)
180
+
181
+ await Promise.all(promises)
182
+ expect(result).toBeTruthy()
183
+
184
+ let log = ''
185
+ for (const r of result) {
186
+ const overlaps = result.filter(
187
+ r2 => r2.i != r.i && (r2.t != 'reader' || r.t != 'reader') && r.start > r2.start && r.start < r2.end
188
+ )
189
+ if (overlaps.length > 0) {
190
+ log += `${r.i} ${r.t} ${r.start} overlaps:\n`
191
+ for (const o of overlaps) log += ` ${o.i} ${o.t} ${o.start} ${o.end}\n`
192
+ }
193
+ }
194
+
195
+ if (log.length > 0) {
196
+ console.log(log)
197
+ expect(log.length).toBe(0)
198
+ }
199
+
200
+ await storage.destroy()
201
+ })
202
+
203
+ test.skip('2_TODOTONE - AtomicBEEF error', async () => {
204
+ for (const { wallet } of ctxs) {
205
+ const fred = await _tu.createSQLiteTestWallet({
206
+ chain: 'test',
207
+ databaseName: 'syncTest2Fred',
208
+ rootKeyHex: '2'.repeat(64),
209
+ dropAll: true
210
+ })
211
+ const promises: Promise<number>[] = []
212
+ const result: { i: number; r: any }[] = []
213
+ const crs1: bsv.CreateActionResult[] = []
214
+ /*** maxI = 6 test PASS ***/
215
+ const maxI = 7
216
+
217
+ const makeWriter2 = async (
218
+ fred: TestWalletNoSetup,
219
+ cr: bsv.CreateActionResult,
220
+ i: number,
221
+ result: { i: number; r: any }[]
222
+ ): Promise<number> => {
223
+ logger(`writer${i}`)
224
+ const internalizeArgs: bsv.InternalizeActionArgs = {
225
+ tx: cr.tx!,
226
+ outputs: [
227
+ {
228
+ outputIndex: 0,
229
+ protocol: 'basket insertion',
230
+ insertionRemittance: {
231
+ basket: 'payments',
232
+ customInstructions: JSON.stringify({ root, repeat: 8 }),
233
+ tags: ['test', 'again']
234
+ }
235
+ }
236
+ ],
237
+ description: `paid ${i}`
238
+ }
239
+ const r = await fred.wallet.internalizeAction(internalizeArgs)
240
+ expect(r.accepted).toBe(true)
241
+ result.push({ r, i })
242
+ return i
243
+ }
244
+
245
+ for (let i = 0; i < maxI; i++) {
246
+ const createArgs: bsv.CreateActionArgs = {
247
+ description: `${kp.address} of ${root}`,
248
+ outputs: [
249
+ {
250
+ satoshis: 1,
251
+ lockingScript: _tu.getLockP2PKH(fredsAddress).toHex(),
252
+ outputDescription: 'pay fred'
253
+ }
254
+ ],
255
+ options: {
256
+ returnTXIDOnly: false,
257
+ randomizeOutputs: false,
258
+ signAndProcess: true,
259
+ noSend: true
260
+ }
261
+ }
262
+ const cr = await wallet.createAction(createArgs)
263
+ expect(cr.tx).toBeTruthy()
264
+ crs1.push(cr)
265
+ }
266
+ let j = 0
267
+ for (let i = 0; i < maxI; i++) promises.push(makeWriter2(fred, crs1[j++], i, result))
268
+ await Promise.all(promises)
269
+ expect(result).toBeTruthy()
270
+ }
271
+ })
272
+ })
273
+ function logger(s: string) {
274
+ process.stdout.write(`${s}\n`)
275
+ }
@@ -0,0 +1,89 @@
1
+ import { _tu, TestWalletOnly } from '../../../test/utils/TestUtilsWalletStorage'
2
+ import { Setup } from '../../Setup'
3
+ import { StorageKnex } from '../StorageKnex'
4
+ import { AuthFetch } from '@bsv/sdk'
5
+ import { StorageAdminStats } from '../index.client'
6
+ import { Format } from '../../utility/Format'
7
+
8
+ describe('storage adminStats tests', () => {
9
+ jest.setTimeout(99999999)
10
+
11
+ const env = _tu.getEnv('main')
12
+ const knex = Setup.createMySQLKnex(process.env.MAIN_CLOUD_MYSQL_CONNECTION!)
13
+ const storage = new StorageKnex({
14
+ chain: env.chain,
15
+ knex: knex,
16
+ commissionSatoshis: 0,
17
+ commissionPubKeyHex: undefined,
18
+ feeModel: { model: 'sat/kb', value: 1 }
19
+ })
20
+
21
+ let setup: TestWalletOnly
22
+ let nextId = 0
23
+
24
+ beforeAll(async () => {
25
+ await storage.makeAvailable()
26
+
27
+ setup = await _tu.createTestWalletWithStorageClient({
28
+ chain: 'main',
29
+ rootKeyHex: env.devKeys[env.identityKey]
30
+ })
31
+ })
32
+ afterAll(async () => {
33
+ await storage.destroy()
34
+ await setup.wallet.destroy()
35
+ })
36
+
37
+ test('0 adminStats StorageKnex', async () => {
38
+ storage.setServices(setup.services)
39
+ const r = await storage.adminStats(env.identityKey)
40
+ console.log(Format.toLogStringAdminStats(r))
41
+ expect(r.requestedBy).toBe(env.identityKey)
42
+ expect(r.usersTotal).toBeGreaterThan(0)
43
+ await storage.destroy()
44
+ })
45
+
46
+ test('1 adminStats StorageServer via RPC', async () => {
47
+ const authFetch = new AuthFetch(setup.wallet)
48
+ const endpointUrl =
49
+ setup.chain === 'main' ? 'https://storage.babbage.systems' : 'https://staging-storage.babbage.systems'
50
+
51
+ const id = nextId++
52
+ const body = {
53
+ jsonrpc: '2.0',
54
+ method: 'adminStats',
55
+ params: [env.identityKey],
56
+ id
57
+ }
58
+
59
+ let response: Response
60
+ try {
61
+ response = await authFetch.fetch(endpointUrl, {
62
+ method: 'POST',
63
+ headers: { 'Content-Type': 'application/json' },
64
+ body: JSON.stringify(body)
65
+ })
66
+ } catch (eu: unknown) {
67
+ throw eu
68
+ }
69
+
70
+ if (!response.ok) {
71
+ throw new Error(`WalletStorageClient rpcCall: network error ${response.status} ${response.statusText}`)
72
+ }
73
+
74
+ const json = await response.json()
75
+ if (json.error) {
76
+ const { code, message, data } = json.error
77
+ const err = new Error(`RPC Error: ${message}`)
78
+ // You could attach more info here if you like:
79
+ ;(err as any).code = code
80
+ ;(err as any).data = data
81
+ throw err
82
+ }
83
+
84
+ const r = json.result as StorageAdminStats
85
+ console.log(Format.toLogStringAdminStats(r))
86
+ expect(r.requestedBy).toBe(env.identityKey)
87
+ expect(r.usersTotal).toBeGreaterThan(0)
88
+ })
89
+ })