@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,242 @@
1
+ import { _tu } from '../../../../test/utils/TestUtilsWalletStorage'
2
+ import { WhatsOnChain } from '../WhatsOnChain'
3
+ import { Services } from '../../Services'
4
+ import { Setup } from '../../../Setup'
5
+ import { wait } from '../../../utility/utilityHelpers'
6
+ import { WalletError } from '../../../sdk/WalletError'
7
+ import { StorageKnex } from '../../../storage/StorageKnex'
8
+ import { StorageClient } from '../../../storage/remoting/StorageClient'
9
+
10
+ describe('whatsonchain tests', () => {
11
+ jest.setTimeout(99999999)
12
+
13
+ test('00', () => {})
14
+ if (_tu.noTestEnv('test')) return
15
+
16
+ const envTest = _tu.getEnv('test')
17
+ const wocTest = new WhatsOnChain(envTest.chain, {
18
+ apiKey: envTest.taalApiKey
19
+ })
20
+ const envMain = _tu.getEnv('main')
21
+ const wocMain = new WhatsOnChain(envMain.chain, {
22
+ apiKey: envMain.taalApiKey
23
+ })
24
+
25
+ test('0 getRawTx testnet', async () => {
26
+ const rawTx = await wocTest.getRawTx('7e5b797b86abd31a654bf296900d6cb14d04ef0811568ff4675494af2d92166b')
27
+ expect(
28
+ rawTx ===
29
+ '010000000158EED5DBBB7E2F7D70C79A11B9B61AABEECFA5A7CEC679BEDD00F42C48A4BD45010000006B483045022100AE8BB45498A40E2AC797775C405C108168804CD84E8C09A9D42D280D18EDDB6D022024863BFAAC5FF3C24CA65E2F3677EDA092BC3CC5D2EFABA73264B8FF55CF416B412102094AAF520E14E1C4D68496822800BCC7D3B3B26CA368E004A2CB70B398D82FACFFFFFFFF0203000000000000007421020A624B72B34BC192851C5D8890926BBB70B31BC10FDD4E3BC6534E41B1C81B93AC03010203030405064630440220013B4984F4054C2FBCD2F448AB896CCA5C4E234BF765B0C7FB27EDE572A7F7DA02201A5C8D0D023F94C209046B9A2B96B2882C5E43B72D8115561DF8C07442010EEA6D7592090000000000001976A9146511FCE2F7EF785A2102142FBF381AD1291C918688AC00000000'
30
+ )
31
+
32
+ expect(await wocTest.getRawTx('1'.repeat(64))).toBeUndefined()
33
+ })
34
+
35
+ test('1 getRawTx mainnet', async () => {
36
+ const rawTx = await wocMain.getRawTx('d9978ffc6676523208f7b33bebf1b176388bbeace2c7ef67ce35c2eababa1805')
37
+ expect(
38
+ rawTx ===
39
+ '0100000001026A66A5F724EB490A55E0E08553286F08AD57E92C4BF34B5C44EA6BC0A49828020000006B483045022100C3D9A5ACA30C1F2E1A54532162E7AFE5AA69150E4C06D760414A16D1EA1BABD602205E0D9191838B0911A1E7328554A2B22EFAA80CF52B15FBA37C3046A0996C7AAD412103FA3CF488CA98D9F2DB91843F36BAF6BE39F6C947976C02394602D09FBC5F4CF4FFFFFFFF0210270000000000001976A91444C04354E88975C4BEF30CFE89D300CC7659F7E588AC96BC0000000000001976A9149A53E5CF5F1876924D98A8B35CA0BC693618682488AC00000000'
40
+ )
41
+
42
+ expect(await wocMain.getRawTx('1'.repeat(64))).toBeUndefined()
43
+ })
44
+
45
+ test('2 getMerklePath testnet', async () => {
46
+ const services = new Services(envTest.chain)
47
+ {
48
+ const r = await wocTest.getMerklePath(
49
+ '7e5b797b86abd31a654bf296900d6cb14d04ef0811568ff4675494af2d92166b',
50
+ services
51
+ )
52
+ const s = JSON.stringify(r)
53
+ expect(s).toBe(
54
+ '{"name":"WoCTsc","notes":[{"what":"getMerklePathSuccess","name":"WoCTsc","status":200,"statusText":"OK"}],"merklePath":{"blockHeight":1661398,"path":[[{"offset":6,"hash":"7e5b797b86abd31a654bf296900d6cb14d04ef0811568ff4675494af2d92166b","txid":true},{"offset":7,"hash":"97dd9d9080394d52338588732d9f84e1debca93f171f674ac3beac1e75495568"}],[{"offset":2,"hash":"81beedcd219d9e03255bde2ee479db34b9fed04d30373ba8bc264a64af2515b9"}],[{"offset":0,"hash":"9965f9aaeea33f6878335e6f7e6bdb544c3a8550c84e2f0daca54e9cd912111c"}]]},"header":{"version":536870912,"previousHash":"000000000688340a14b77e49bb0fca5ac7b624f7f79a5517583d1aae61c4e658","merkleRoot":"edbc07082ca0a31d5ec89d1f503a9cd41112c0d8f3221a96acfb8a9d16f8e82b","time":1739624725,"bits":486604799,"nonce":1437884974,"height":1661398,"hash":"00000000d8a73bf9a37272a71886ea92a25376bed1c1916f2b5cfbec4d6f6a25"}}'
55
+ )
56
+ }
57
+
58
+ {
59
+ const r = await wocTest.getMerklePath('1'.repeat(64), services)
60
+ const s = JSON.stringify(r)
61
+ expect(s).toBe(
62
+ '{"name":"WoCTsc","notes":[{"what":"getMerklePathNoData","name":"WoCTsc","status":200,"statusText":"OK"}]}'
63
+ )
64
+ }
65
+ })
66
+
67
+ test('3 getMerklePath mainnet', async () => {
68
+ const services = new Services(envMain.chain)
69
+ {
70
+ const r = await wocMain.getMerklePath(
71
+ 'd9978ffc6676523208f7b33bebf1b176388bbeace2c7ef67ce35c2eababa1805',
72
+ services
73
+ )
74
+ const s = JSON.stringify(r)
75
+ expect(s).toBe(
76
+ '{"name":"WoCTsc","notes":[{"what":"getMerklePathSuccess","name":"WoCTsc","status":200,"statusText":"OK"}],"merklePath":{"blockHeight":883637,"path":[[{"offset":46,"hash":"d9978ffc6676523208f7b33bebf1b176388bbeace2c7ef67ce35c2eababa1805","txid":true},{"offset":47,"hash":"066f6fa6fa988f2e3a9d6fe35fa0d3666c652dac35cabaeebff3738a4e67f68f"}],[{"offset":22,"hash":"232089a6f77c566151bc4701fda394b5cc5bf17073140d46a73c4c3ed0a7b911"}],[{"offset":10,"hash":"c639b3a6ce127f67dbd01c7331a6fca62a4b429830387bd68ac6ac05e162116d"}],[{"offset":4,"hash":"730cec44be97881530947d782bb328d25f1122fdae206296937fffb03e936d48"}],[{"offset":3,"hash":"28b681f8ab8db0fa4d5d20cb1532b95184a155346b0b8447bde580b2406d51e6"}],[{"offset":0,"hash":"c49a18028e230dd1439b26794c08c339506f24a450f067c4facd4e0d5a346490"}],[{"offset":1,"hash":"0ba57d1b1fad6874de3640c01088e3dedad3507e5b3a3102b9a8a8055f3df88b"}],[{"offset":1,"hash":"c830edebe5565c19ba584ec73d49129344d17539f322509b7c314ae641c2fcdb"}],[{"offset":1,"hash":"ff62d5ed2a94eb93a2b7d084b8f15b12083573896b6a58cf871507e3352c75f5"}]]},"header":{"version":1040187392,"previousHash":"00000000000000000d9f6889dd6743500adee204ea25d8a57225ecd48b111769","merkleRoot":"59c1efd79fae0d9c29dd8da63f8eeec0aadde048f4491c6bfa324fcfd537156d","time":1739329877,"bits":403818359,"nonce":596827153,"height":883637,"hash":"0000000000000000060ac8d63b78d41f58c9aba0b09f81db7d51fa4905a47263"}}'
77
+ )
78
+ }
79
+
80
+ {
81
+ const r = await wocMain.getMerklePath('1'.repeat(64), services)
82
+ const s = JSON.stringify(r)
83
+ expect(s).toBe(
84
+ '{"name":"WoCTsc","notes":[{"what":"getMerklePathNoData","name":"WoCTsc","status":200,"statusText":"OK"}]}'
85
+ )
86
+ }
87
+ })
88
+
89
+ test('4 updateBsvExchangeRate', async () => {
90
+ {
91
+ const r = await wocMain.updateBsvExchangeRate()
92
+ expect(r.base).toBe('USD')
93
+ expect(r.rate).toBeGreaterThan(0)
94
+ expect(r.timestamp).toBeTruthy()
95
+ }
96
+ })
97
+
98
+ test('5 getTxPropagation testnet', async () => {
99
+ return
100
+ // throwing internal server error 500 when tested.
101
+ const count = await wocTest.getTxPropagation('7e5b797b86abd31a654bf296900d6cb14d04ef0811568ff4675494af2d92166b')
102
+ expect(count > 0)
103
+
104
+ expect((await wocTest.getTxPropagation('1'.repeat(64))) === 0)
105
+ })
106
+
107
+ test('6 getTxPropagation mainnet', async () => {})
108
+
109
+ test.skip('7 postRawTx testnet', async () => {
110
+ if (Setup.noEnv('test')) return
111
+ const woc = wocTest
112
+ const c = await _tu.createNoSendTxPair('test')
113
+
114
+ const rawTxDo = c.beef.findTxid(c.txidDo)!.tx!.toHex()
115
+ const rawTxUndo = c.beef.findTxid(c.txidUndo)!.tx!.toHex()
116
+
117
+ const txidDo = await woc.postRawTx(rawTxDo)
118
+ expect(txidDo).toBe(c.txidDo)
119
+
120
+ await wait(1000)
121
+
122
+ const txidUndo = await woc.postRawTx(rawTxUndo)
123
+ expect(txidUndo).toBe(c.txidUndo)
124
+ })
125
+
126
+ test.skip('7a nosend cleanup testnet', async () => {
127
+ const c = await _tu.createWalletSetupEnv('test')
128
+
129
+ const actions = await c.wallet.listActions({ labels: [], limit: 1000 })
130
+ const nosends = actions.actions.filter(a => a.status === 'nosend')
131
+
132
+ const refs = ['yUfgNVaFcBNyP2Xv']
133
+ for (const ref of refs) {
134
+ try {
135
+ await c.wallet.abortAction({ reference: ref })
136
+ } catch (eu: unknown) {
137
+ const e = WalletError.fromUnknown(eu)
138
+ }
139
+ }
140
+ })
141
+
142
+ test.skip('8 postRawTx mainnet', async () => {
143
+ if (Setup.noEnv('main')) return
144
+ const woc = wocMain
145
+ const c = await _tu.createNoSendTxPair('main')
146
+
147
+ const rawTxDo = c.beef.findTxid(c.txidDo)!.tx!.toHex()
148
+ const rawTxUndo = c.beef.findTxid(c.txidUndo)!.tx!.toHex()
149
+
150
+ const txidDo = await woc.postRawTx(rawTxDo)
151
+ expect(txidDo).toBe(c.txidDo)
152
+
153
+ /*
154
+ try {
155
+ // This method is broken as of 2025-02-16
156
+ const count = await woc.getTxPropagation(txidDo)
157
+ } catch {}
158
+ // getRawTx returns undefined for unmined transactions, sometimes.
159
+ let rawTx = await woc.getRawTx(txidDo)
160
+ let i = 0
161
+ while (!rawTx) {
162
+ console.log(`${i++} waiting for WhatsOnChain to acknowledge new transaction exists.`)
163
+ await wait(5000)
164
+ rawTx = await woc.getRawTx(txidDo)
165
+ }
166
+ expect(rawTx).toBe(rawTxDo)
167
+ */
168
+
169
+ // allow for propagation...
170
+ await wait(1000)
171
+
172
+ const txidUndo = await woc.postRawTx(rawTxUndo)
173
+ expect(txidUndo).toBe(c.txidUndo)
174
+
175
+ await wait(1000)
176
+
177
+ // Confirm double spend detection.
178
+ // 'The rawTx parameter must be valid. unexpected response code 500: 258: txn-mempool-conflict'
179
+ // 'The rawTx parameter must be valid. unexpected response code 500: Missing inputs'
180
+ try {
181
+ await woc.postRawTx(c.doubleSpendTx.toHex())
182
+ expect(false)
183
+ } catch (eu: unknown) {
184
+ const e = WalletError.fromUnknown(eu)
185
+ expect(
186
+ e.message === 'The rawTx parameter must be valid. unexpected response code 500: 258: txn-mempool-conflict' ||
187
+ 'The rawTx parameter must be valid. unexpected response code 500: Missing inputs'
188
+ )
189
+ }
190
+ })
191
+
192
+ test.skip('8a nosend cleanup mainnet', async () => {
193
+ const c = await _tu.createWalletSetupEnv('main')
194
+
195
+ const actions = await c.wallet.listActions({ labels: [], limit: 1000 })
196
+ const nosends = actions.actions.filter(a => a.status === 'nosend')
197
+ // No way to get from actions to reference string values for use with abortAction...
198
+
199
+ if (c['activeStorage']) {
200
+ const s = c['activeStorage'] as StorageKnex
201
+ const userId = c['userId'] as number
202
+ const txs = await s.findTransactions({
203
+ partial: { userId, status: 'nosend' }
204
+ })
205
+ const refs = txs.map(tx => tx.reference)
206
+ for (const ref of refs) {
207
+ try {
208
+ await c.wallet.abortAction({ reference: ref })
209
+ } catch (eu: unknown) {
210
+ const e = WalletError.fromUnknown(eu)
211
+ }
212
+ }
213
+ }
214
+
215
+ await c.wallet.destroy()
216
+ })
217
+
218
+ test.skip('8b run monitor mainnet', async () => {
219
+ if (Setup.noEnv('main')) return
220
+ if (!Setup.getEnv('main').filePath) return
221
+
222
+ // Only run if `Setup` style .env is present with a sqlite filePath...
223
+
224
+ const c = await _tu.createWalletSetupEnv('main')
225
+
226
+ await c.monitor.runOnce()
227
+
228
+ await c.wallet.destroy()
229
+ })
230
+
231
+ test.skip('8c backup to cloud', async () => {
232
+ if (Setup.noEnv('main')) return
233
+ if (!Setup.getEnv('main').filePath) return
234
+
235
+ const c = await _tu.createWalletSetupEnv('main')
236
+ const client = new StorageClient(c.wallet, 'https://storage.babbage.systems')
237
+ await c.storage.addWalletStorageProvider(client)
238
+ await c.storage.updateBackups()
239
+
240
+ await c.wallet.destroy()
241
+ })
242
+ })
@@ -0,0 +1,18 @@
1
+ import { _tu } from '../../../../test/utils/TestUtilsWalletStorage'
2
+ import { WalletServicesOptions } from '../../../sdk/WalletServices.interfaces'
3
+ import { createDefaultWalletServicesOptions } from '../../createDefaultWalletServicesOptions'
4
+ import { updateExchangeratesapi } from '../exchangeRates'
5
+
6
+ describe('exchangeRates tests', () => {
7
+ jest.setTimeout(99999999)
8
+
9
+ test('0', async () => {
10
+ if (_tu.noEnv('main')) return
11
+ const o = createDefaultWalletServicesOptions('main')
12
+ // The default api key for this service is severely use limited,
13
+ // do not run this test aggressively. Without substituting your own key.
14
+ // o.exchangeratesapiKey = 'YOUR_API_KEY'
15
+ const r = await updateExchangeratesapi(['EUR', 'GBP', 'USD'], o)
16
+ expect(r).toBeDefined()
17
+ })
18
+ })
@@ -0,0 +1,265 @@
1
+ import { FiatExchangeRates, WalletServicesOptions } from '../../sdk/WalletServices.interfaces'
2
+ import { WERR_BAD_REQUEST, WERR_MISSING_PARAMETER } from '../../sdk/WERR_errors'
3
+
4
+ export async function updateChaintracksFiatExchangeRates(
5
+ targetCurrencies: string[],
6
+ options: WalletServicesOptions
7
+ ): Promise<FiatExchangeRates> {
8
+ const url = options.chaintracksFiatExchangeRatesUrl
9
+
10
+ if (!url) throw new WERR_MISSING_PARAMETER('options.chaintracksFiatExchangeRatesUrl')
11
+
12
+ const response = await fetch(url)
13
+ const data = await response.json()
14
+ const r = { status: response.status, data }
15
+
16
+ if (r.status !== 200 || !r.data || r.data.status != 'success') {
17
+ throw new WERR_BAD_REQUEST(`${url} returned status ${r.status}`)
18
+ }
19
+
20
+ const rates = <FiatExchangeRates>r.data.value
21
+ rates.timestamp = new Date(rates.timestamp)
22
+
23
+ return rates
24
+ }
25
+
26
+ export async function updateExchangeratesapi(
27
+ targetCurrencies: string[],
28
+ options: WalletServicesOptions
29
+ ): Promise<FiatExchangeRates> {
30
+ if (!options.exchangeratesapiKey) throw new WERR_MISSING_PARAMETER('options.exchangeratesapiKey')
31
+
32
+ const iorates = await getExchangeRatesIo(options.exchangeratesapiKey)
33
+
34
+ if (!iorates.success) throw new WERR_BAD_REQUEST(`getExchangeRatesIo returned success ${iorates.success}`)
35
+
36
+ if (!iorates.rates['USD'] || !iorates.rates[iorates.base])
37
+ throw new WERR_BAD_REQUEST(`getExchangeRatesIo missing rates for 'USD' or base`)
38
+
39
+ const r: FiatExchangeRates = {
40
+ timestamp: new Date(iorates.timestamp * 1000),
41
+ base: 'USD',
42
+ rates: {}
43
+ }
44
+
45
+ const basePerUsd = iorates.rates[iorates.base] / iorates.rates['USD']
46
+
47
+ let updates = 0
48
+ for (const [key, value] of Object.entries(iorates.rates)) {
49
+ if (targetCurrencies.indexOf(key) > -1) {
50
+ r.rates[key] = value * basePerUsd
51
+ updates++
52
+ }
53
+ }
54
+
55
+ if (updates !== targetCurrencies.length)
56
+ throw new WERR_BAD_REQUEST(`getExchangeRatesIo failed to update all target currencies`)
57
+
58
+ //console.log(`new fiat rates=${JSON.stringify(r)}`)
59
+
60
+ return r
61
+ }
62
+
63
+ export interface ExchangeRatesIoApi {
64
+ success: boolean
65
+ timestamp: number
66
+ base: 'EUR' | 'USD'
67
+ date: string
68
+ rates: Record<string, number>
69
+ }
70
+
71
+ export async function getExchangeRatesIo(key: string): Promise<ExchangeRatesIoApi> {
72
+ const url = `http://api.exchangeratesapi.io/v1/latest?access_key=${key}`
73
+
74
+ const response = await fetch(url)
75
+ const data = await response.json()
76
+ const r = { status: response.status, data }
77
+
78
+ if (r.status !== 200 || !r.data) {
79
+ throw new WERR_BAD_REQUEST(`getExchangeRatesIo returned status ${r.status}`)
80
+ }
81
+
82
+ const rates = <ExchangeRatesIoApi>r.data
83
+
84
+ return rates
85
+ }
86
+
87
+ /*
88
+ {
89
+ "success": true,
90
+ "timestamp": 1702405384,
91
+ "base": "EUR",
92
+ "date": "2023-12-12",
93
+ "rates": {
94
+ "AED": 3.96261,
95
+ "AFN": 74.453362,
96
+ "ALL": 101.807155,
97
+ "AMD": 435.489459,
98
+ "ANG": 1.944069,
99
+ "AOA": 897.226337,
100
+ "ARS": 395.468082,
101
+ "AUD": 1.646886,
102
+ "AWG": 1.942271,
103
+ "AZN": 1.832044,
104
+ "BAM": 1.95407,
105
+ "BBD": 2.177971,
106
+ "BDT": 118.654929,
107
+ "BGN": 1.956827,
108
+ "BHD": 0.406753,
109
+ "BIF": 3078.499675,
110
+ "BMD": 1.079039,
111
+ "BND": 1.446102,
112
+ "BOB": 7.4534,
113
+ "BRL": 5.35741,
114
+ "BSD": 1.07874,
115
+ "BTC": 0.000026145469,
116
+ "BTN": 89.916078,
117
+ "BWP": 14.715901,
118
+ "BYN": 3.553337,
119
+ "BYR": 21149.174075,
120
+ "BZD": 2.174364,
121
+ "CAD": 1.468287,
122
+ "CDF": 2875.640503,
123
+ "CHF": 0.945353,
124
+ "CLF": 0.034313,
125
+ "CLP": 948.09775,
126
+ "CNY": 7.743512,
127
+ "COP": 4307.525658,
128
+ "CRC": 569.093422,
129
+ "CUC": 1.079039,
130
+ "CUP": 28.594547,
131
+ "CVE": 110.978933,
132
+ "CZK": 24.507795,
133
+ "DJF": 191.766554,
134
+ "DKK": 7.457544,
135
+ "DOP": 61.505535,
136
+ "DZD": 145.236415,
137
+ "EGP": 33.367028,
138
+ "ERN": 16.185592,
139
+ "ETB": 60.199033,
140
+ "EUR": 1,
141
+ "FJD": 2.416779,
142
+ "FKP": 0.859886,
143
+ "GBP": 0.859574,
144
+ "GEL": 2.880527,
145
+ "GGP": 0.859886,
146
+ "GHS": 12.980915,
147
+ "GIP": 0.859886,
148
+ "GMD": 72.726644,
149
+ "GNF": 9285.134874,
150
+ "GTQ": 8.443457,
151
+ "GYD": 225.859997,
152
+ "HKD": 8.426031,
153
+ "HNL": 26.685156,
154
+ "HRK": 7.598132,
155
+ "HTG": 142.513142,
156
+ "HUF": 382.707793,
157
+ "IDR": 16801.292339,
158
+ "ILS": 4.007585,
159
+ "IMP": 0.859886,
160
+ "INR": 89.987955,
161
+ "IQD": 1414.081256,
162
+ "IRR": 45602.907562,
163
+ "ISK": 151.109018,
164
+ "JEP": 0.859886,
165
+ "JMD": 167.700721,
166
+ "JOD": 0.765366,
167
+ "JPY": 157.115675,
168
+ "KES": 165.523229,
169
+ "KGS": 96.379362,
170
+ "KHR": 4440.24707,
171
+ "KMF": 493.571281,
172
+ "KPW": 971.097551,
173
+ "KRW": 1417.685123,
174
+ "KWD": 0.332733,
175
+ "KYD": 0.8989,
176
+ "KZT": 493.04112,
177
+ "LAK": 22368.488843,
178
+ "LBP": 16154.243871,
179
+ "LKR": 352.747636,
180
+ "LRD": 203.02122,
181
+ "LSL": 20.582684,
182
+ "LTL": 3.186123,
183
+ "LVL": 0.6527,
184
+ "LYD": 5.211954,
185
+ "MAD": 10.976529,
186
+ "MDL": 19.340873,
187
+ "MGA": 4939.301335,
188
+ "MKD": 61.507276,
189
+ "MMK": 2265.283559,
190
+ "MNT": 3705.780074,
191
+ "MOP": 8.676817,
192
+ "MRU": 42.727878,
193
+ "MUR": 47.690625,
194
+ "MVR": 16.584924,
195
+ "MWK": 1816.023037,
196
+ "MXN": 18.69803,
197
+ "MYR": 5.052606,
198
+ "MZN": 68.249194,
199
+ "NAD": 20.588506,
200
+ "NGN": 865.924709,
201
+ "NIO": 39.6024,
202
+ "NOK": 11.848426,
203
+ "NPR": 143.865605,
204
+ "NZD": 1.761931,
205
+ "OMR": 0.415394,
206
+ "PAB": 1.07864,
207
+ "PEN": 4.073376,
208
+ "PGK": 4.025102,
209
+ "PHP": 59.974075,
210
+ "PKR": 306.446851,
211
+ "PLN": 4.334063,
212
+ "PYG": 7963.910929,
213
+ "QAR": 3.928776,
214
+ "RON": 4.973399,
215
+ "RSD": 117.196649,
216
+ "RUB": 97.248412,
217
+ "RWF": 1351.496966,
218
+ "SAR": 4.047186,
219
+ "SBD": 9.12268,
220
+ "SCR": 14.561036,
221
+ "SDG": 648.5028,
222
+ "SEK": 11.285032,
223
+ "SGD": 1.449037,
224
+ "SHP": 1.312921,
225
+ "SLE": 24.488188,
226
+ "SLL": 21311.029931,
227
+ "SOS": 616.131981,
228
+ "SRD": 40.655509,
229
+ "STD": 22333.938945,
230
+ "SYP": 14029.21897,
231
+ "SZL": 20.587826,
232
+ "THB": 38.597298,
233
+ "TJS": 11.757734,
234
+ "TMT": 3.776638,
235
+ "TND": 3.377493,
236
+ "TOP": 2.551714,
237
+ "TRY": 31.312865,
238
+ "TTD": 7.321483,
239
+ "TWD": 34.012943,
240
+ "TZS": 2697.598652,
241
+ "UAH": 39.917867,
242
+ "UGX": 4102.367289,
243
+ "USD": 1.079039,
244
+ "UYU": 42.422631,
245
+ "UZS": 13299.161683,
246
+ "VEF": 3838024.202021,
247
+ "VES": 38.392542,
248
+ "VND": 26188.28851,
249
+ "VUV": 129.693288,
250
+ "WST": 2.964402,
251
+ "XAF": 655.37362,
252
+ "XAG": 0.047456,
253
+ "XAU": 0.000545,
254
+ "XCD": 2.916158,
255
+ "XDR": 0.811478,
256
+ "XOF": 657.134976,
257
+ "XPF": 119.331742,
258
+ "YER": 270.110528,
259
+ "ZAR": 20.470755,
260
+ "ZMK": 9712.646776,
261
+ "ZMW": 26.319693,
262
+ "ZWL": 347.450277
263
+ }
264
+ }
265
+ */