@atomiqlabs/sdk 8.8.3 → 8.8.4

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 (339) hide show
  1. package/LICENSE +201 -201
  2. package/README.md +1760 -1760
  3. package/dist/SmartChainAssets.d.ts +181 -181
  4. package/dist/SmartChainAssets.js +181 -181
  5. package/dist/bitcoin/coinselect2/accumulative.d.ts +7 -7
  6. package/dist/bitcoin/coinselect2/accumulative.js +52 -52
  7. package/dist/bitcoin/coinselect2/blackjack.d.ts +7 -7
  8. package/dist/bitcoin/coinselect2/blackjack.js +38 -38
  9. package/dist/bitcoin/coinselect2/index.d.ts +20 -20
  10. package/dist/bitcoin/coinselect2/index.js +69 -69
  11. package/dist/bitcoin/coinselect2/utils.d.ts +82 -82
  12. package/dist/bitcoin/coinselect2/utils.js +158 -158
  13. package/dist/bitcoin/wallet/BitcoinWallet.d.ts +113 -113
  14. package/dist/bitcoin/wallet/BitcoinWallet.js +335 -335
  15. package/dist/bitcoin/wallet/IBitcoinWallet.d.ts +116 -116
  16. package/dist/bitcoin/wallet/IBitcoinWallet.js +21 -21
  17. package/dist/bitcoin/wallet/SingleAddressBitcoinWallet.d.ts +106 -106
  18. package/dist/bitcoin/wallet/SingleAddressBitcoinWallet.js +196 -196
  19. package/dist/enums/FeeType.d.ts +15 -15
  20. package/dist/enums/FeeType.js +19 -19
  21. package/dist/enums/SwapAmountType.d.ts +15 -15
  22. package/dist/enums/SwapAmountType.js +19 -19
  23. package/dist/enums/SwapDirection.d.ts +15 -15
  24. package/dist/enums/SwapDirection.js +19 -19
  25. package/dist/enums/SwapSide.d.ts +15 -15
  26. package/dist/enums/SwapSide.js +19 -19
  27. package/dist/enums/SwapType.d.ts +75 -75
  28. package/dist/enums/SwapType.js +79 -79
  29. package/dist/errors/IntermediaryError.d.ts +13 -13
  30. package/dist/errors/IntermediaryError.js +27 -27
  31. package/dist/errors/RequestError.d.ts +32 -32
  32. package/dist/errors/RequestError.js +54 -54
  33. package/dist/errors/UserError.d.ts +8 -8
  34. package/dist/errors/UserError.js +16 -16
  35. package/dist/events/UnifiedSwapEventListener.d.ts +23 -23
  36. package/dist/events/UnifiedSwapEventListener.js +132 -132
  37. package/dist/http/HttpUtils.d.ts +27 -27
  38. package/dist/http/HttpUtils.js +91 -91
  39. package/dist/http/paramcoders/IParamReader.d.ts +8 -8
  40. package/dist/http/paramcoders/IParamReader.js +2 -2
  41. package/dist/http/paramcoders/ParamDecoder.d.ts +44 -44
  42. package/dist/http/paramcoders/ParamDecoder.js +137 -137
  43. package/dist/http/paramcoders/ParamEncoder.d.ts +20 -20
  44. package/dist/http/paramcoders/ParamEncoder.js +36 -36
  45. package/dist/http/paramcoders/SchemaVerifier.d.ts +26 -26
  46. package/dist/http/paramcoders/SchemaVerifier.js +145 -145
  47. package/dist/http/paramcoders/client/ResponseParamDecoder.d.ts +11 -11
  48. package/dist/http/paramcoders/client/ResponseParamDecoder.js +57 -57
  49. package/dist/http/paramcoders/client/StreamParamEncoder.d.ts +13 -13
  50. package/dist/http/paramcoders/client/StreamParamEncoder.js +26 -26
  51. package/dist/http/paramcoders/client/StreamingFetchPromise.d.ts +16 -16
  52. package/dist/http/paramcoders/client/StreamingFetchPromise.js +174 -174
  53. package/dist/index.d.ts +85 -85
  54. package/dist/index.js +158 -158
  55. package/dist/intermediaries/Intermediary.d.ts +178 -178
  56. package/dist/intermediaries/Intermediary.js +166 -166
  57. package/dist/intermediaries/IntermediaryDiscovery.d.ts +211 -211
  58. package/dist/intermediaries/IntermediaryDiscovery.js +424 -424
  59. package/dist/intermediaries/apis/IntermediaryAPI.d.ts +450 -450
  60. package/dist/intermediaries/apis/IntermediaryAPI.js +618 -618
  61. package/dist/intermediaries/apis/TrustedIntermediaryAPI.d.ts +155 -155
  62. package/dist/intermediaries/apis/TrustedIntermediaryAPI.js +137 -137
  63. package/dist/lnurl/LNURL.d.ts +102 -102
  64. package/dist/lnurl/LNURL.js +321 -321
  65. package/dist/prices/RedundantSwapPrice.d.ts +110 -110
  66. package/dist/prices/RedundantSwapPrice.js +222 -222
  67. package/dist/prices/SingleSwapPrice.d.ts +34 -34
  68. package/dist/prices/SingleSwapPrice.js +44 -44
  69. package/dist/prices/SwapPriceWithChain.d.ts +107 -107
  70. package/dist/prices/SwapPriceWithChain.js +128 -128
  71. package/dist/prices/abstract/ICachedSwapPrice.d.ts +28 -28
  72. package/dist/prices/abstract/ICachedSwapPrice.js +62 -62
  73. package/dist/prices/abstract/IPriceProvider.d.ts +81 -81
  74. package/dist/prices/abstract/IPriceProvider.js +74 -74
  75. package/dist/prices/abstract/ISwapPrice.d.ts +168 -168
  76. package/dist/prices/abstract/ISwapPrice.js +279 -279
  77. package/dist/prices/providers/BinancePriceProvider.d.ts +23 -23
  78. package/dist/prices/providers/BinancePriceProvider.js +30 -30
  79. package/dist/prices/providers/CoinGeckoPriceProvider.d.ts +23 -23
  80. package/dist/prices/providers/CoinGeckoPriceProvider.js +29 -29
  81. package/dist/prices/providers/CoinPaprikaPriceProvider.d.ts +25 -25
  82. package/dist/prices/providers/CoinPaprikaPriceProvider.js +29 -29
  83. package/dist/prices/providers/CustomPriceProvider.d.ts +24 -24
  84. package/dist/prices/providers/CustomPriceProvider.js +35 -35
  85. package/dist/prices/providers/KrakenPriceProvider.d.ts +38 -38
  86. package/dist/prices/providers/KrakenPriceProvider.js +45 -45
  87. package/dist/prices/providers/OKXPriceProvider.d.ts +34 -34
  88. package/dist/prices/providers/OKXPriceProvider.js +29 -29
  89. package/dist/prices/providers/abstract/ExchangePriceProvider.d.ts +17 -17
  90. package/dist/prices/providers/abstract/ExchangePriceProvider.js +21 -21
  91. package/dist/prices/providers/abstract/HttpPriceProvider.d.ts +7 -7
  92. package/dist/prices/providers/abstract/HttpPriceProvider.js +12 -12
  93. package/dist/storage/IUnifiedStorage.d.ts +85 -85
  94. package/dist/storage/IUnifiedStorage.js +2 -2
  95. package/dist/storage/UnifiedSwapStorage.d.ts +114 -114
  96. package/dist/storage/UnifiedSwapStorage.js +116 -116
  97. package/dist/storage-browser/IndexedDBUnifiedStorage.d.ts +63 -63
  98. package/dist/storage-browser/IndexedDBUnifiedStorage.js +298 -298
  99. package/dist/storage-browser/LocalStorageManager.d.ts +49 -49
  100. package/dist/storage-browser/LocalStorageManager.js +93 -93
  101. package/dist/swapper/Swapper.d.ts +732 -732
  102. package/dist/swapper/Swapper.js +1713 -1713
  103. package/dist/swapper/SwapperFactory.d.ts +135 -135
  104. package/dist/swapper/SwapperFactory.js +162 -162
  105. package/dist/swapper/SwapperUtils.d.ts +206 -206
  106. package/dist/swapper/SwapperUtils.js +481 -481
  107. package/dist/swapper/SwapperWithChain.d.ts +404 -404
  108. package/dist/swapper/SwapperWithChain.js +469 -469
  109. package/dist/swapper/SwapperWithSigner.d.ts +322 -322
  110. package/dist/swapper/SwapperWithSigner.js +318 -318
  111. package/dist/swaps/IAddressSwap.d.ts +22 -22
  112. package/dist/swaps/IAddressSwap.js +14 -14
  113. package/dist/swaps/IBTCWalletSwap.d.ts +73 -73
  114. package/dist/swaps/IBTCWalletSwap.js +18 -18
  115. package/dist/swaps/IClaimableSwap.d.ts +49 -49
  116. package/dist/swaps/IClaimableSwap.js +15 -15
  117. package/dist/swaps/IClaimableSwapWrapper.d.ts +15 -15
  118. package/dist/swaps/IClaimableSwapWrapper.js +2 -2
  119. package/dist/swaps/IRefundableSwap.d.ts +43 -43
  120. package/dist/swaps/IRefundableSwap.js +14 -14
  121. package/dist/swaps/ISwap.d.ts +392 -392
  122. package/dist/swaps/ISwap.js +349 -349
  123. package/dist/swaps/ISwapWithGasDrop.d.ts +21 -21
  124. package/dist/swaps/ISwapWithGasDrop.js +12 -12
  125. package/dist/swaps/ISwapWrapper.d.ts +285 -285
  126. package/dist/swaps/ISwapWrapper.js +353 -353
  127. package/dist/swaps/escrow_swaps/IEscrowSelfInitSwap.d.ts +98 -98
  128. package/dist/swaps/escrow_swaps/IEscrowSelfInitSwap.js +126 -126
  129. package/dist/swaps/escrow_swaps/IEscrowSwap.d.ts +139 -139
  130. package/dist/swaps/escrow_swaps/IEscrowSwap.js +170 -170
  131. package/dist/swaps/escrow_swaps/IEscrowSwapWrapper.d.ts +128 -128
  132. package/dist/swaps/escrow_swaps/IEscrowSwapWrapper.js +167 -167
  133. package/dist/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.d.ts +105 -105
  134. package/dist/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.js +129 -129
  135. package/dist/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.d.ts +162 -162
  136. package/dist/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.js +190 -190
  137. package/dist/swaps/escrow_swaps/frombtc/IFromBTCWrapper.d.ts +64 -64
  138. package/dist/swaps/escrow_swaps/frombtc/IFromBTCWrapper.js +82 -82
  139. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.d.ts +531 -531
  140. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.js +1285 -1285
  141. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.d.ts +190 -190
  142. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.js +432 -432
  143. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.d.ts +583 -583
  144. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.js +1371 -1371
  145. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.d.ts +235 -235
  146. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.js +525 -525
  147. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.d.ts +458 -458
  148. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.js +1126 -1126
  149. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.d.ts +202 -202
  150. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.js +406 -406
  151. package/dist/swaps/escrow_swaps/tobtc/IToBTCSwap.d.ts +403 -403
  152. package/dist/swaps/escrow_swaps/tobtc/IToBTCSwap.js +924 -924
  153. package/dist/swaps/escrow_swaps/tobtc/IToBTCWrapper.d.ts +68 -68
  154. package/dist/swaps/escrow_swaps/tobtc/IToBTCWrapper.js +117 -117
  155. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.d.ts +127 -127
  156. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.js +256 -256
  157. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.d.ts +251 -251
  158. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.js +536 -536
  159. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.d.ts +73 -73
  160. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.js +155 -155
  161. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.d.ts +132 -132
  162. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.js +286 -286
  163. package/dist/swaps/spv_swaps/SpvFromBTCSwap.d.ts +637 -637
  164. package/dist/swaps/spv_swaps/SpvFromBTCSwap.js +1448 -1448
  165. package/dist/swaps/spv_swaps/SpvFromBTCWrapper.d.ts +257 -257
  166. package/dist/swaps/spv_swaps/SpvFromBTCWrapper.js +947 -947
  167. package/dist/swaps/trusted/ln/LnForGasSwap.d.ts +261 -261
  168. package/dist/swaps/trusted/ln/LnForGasSwap.js +511 -511
  169. package/dist/swaps/trusted/ln/LnForGasWrapper.d.ts +40 -40
  170. package/dist/swaps/trusted/ln/LnForGasWrapper.js +83 -83
  171. package/dist/swaps/trusted/onchain/OnchainForGasSwap.d.ts +342 -342
  172. package/dist/swaps/trusted/onchain/OnchainForGasSwap.js +715 -715
  173. package/dist/swaps/trusted/onchain/OnchainForGasWrapper.d.ts +69 -69
  174. package/dist/swaps/trusted/onchain/OnchainForGasWrapper.js +93 -93
  175. package/dist/types/AmountData.d.ts +10 -10
  176. package/dist/types/AmountData.js +2 -2
  177. package/dist/types/CustomPriceFunction.d.ts +11 -11
  178. package/dist/types/CustomPriceFunction.js +2 -2
  179. package/dist/types/PriceInfoType.d.ts +28 -28
  180. package/dist/types/PriceInfoType.js +57 -57
  181. package/dist/types/SwapExecutionAction.d.ts +88 -88
  182. package/dist/types/SwapExecutionAction.js +2 -2
  183. package/dist/types/SwapStateInfo.d.ts +5 -5
  184. package/dist/types/SwapStateInfo.js +2 -2
  185. package/dist/types/SwapWithSigner.d.ts +17 -17
  186. package/dist/types/SwapWithSigner.js +43 -43
  187. package/dist/types/Token.d.ts +99 -99
  188. package/dist/types/Token.js +76 -76
  189. package/dist/types/TokenAmount.d.ts +69 -69
  190. package/dist/types/TokenAmount.js +60 -60
  191. package/dist/types/fees/Fee.d.ts +50 -50
  192. package/dist/types/fees/Fee.js +2 -2
  193. package/dist/types/fees/FeeBreakdown.d.ts +11 -11
  194. package/dist/types/fees/FeeBreakdown.js +2 -2
  195. package/dist/types/fees/PercentagePPM.d.ts +17 -17
  196. package/dist/types/fees/PercentagePPM.js +18 -18
  197. package/dist/types/lnurl/LNURLPay.d.ts +61 -61
  198. package/dist/types/lnurl/LNURLPay.js +31 -31
  199. package/dist/types/lnurl/LNURLWithdraw.d.ts +48 -48
  200. package/dist/types/lnurl/LNURLWithdraw.js +27 -27
  201. package/dist/types/wallets/LightningInvoiceCreateService.d.ts +24 -24
  202. package/dist/types/wallets/LightningInvoiceCreateService.js +15 -15
  203. package/dist/types/wallets/MinimalBitcoinWalletInterface.d.ts +23 -23
  204. package/dist/types/wallets/MinimalBitcoinWalletInterface.js +2 -2
  205. package/dist/types/wallets/MinimalLightningNetworkWalletInterface.d.ts +9 -9
  206. package/dist/types/wallets/MinimalLightningNetworkWalletInterface.js +2 -2
  207. package/dist/utils/AutomaticClockDriftCorrection.d.ts +1 -1
  208. package/dist/utils/AutomaticClockDriftCorrection.js +70 -70
  209. package/dist/utils/BitcoinUtils.d.ts +16 -16
  210. package/dist/utils/BitcoinUtils.js +141 -141
  211. package/dist/utils/BitcoinWalletUtils.d.ts +7 -7
  212. package/dist/utils/BitcoinWalletUtils.js +14 -14
  213. package/dist/utils/Logger.d.ts +7 -7
  214. package/dist/utils/Logger.js +12 -12
  215. package/dist/utils/RetryUtils.d.ts +22 -22
  216. package/dist/utils/RetryUtils.js +67 -67
  217. package/dist/utils/SwapUtils.d.ts +88 -88
  218. package/dist/utils/SwapUtils.js +72 -72
  219. package/dist/utils/TimeoutUtils.d.ts +17 -17
  220. package/dist/utils/TimeoutUtils.js +55 -55
  221. package/dist/utils/TokenUtils.d.ts +19 -19
  222. package/dist/utils/TokenUtils.js +37 -37
  223. package/dist/utils/TypeUtils.d.ts +7 -7
  224. package/dist/utils/TypeUtils.js +2 -2
  225. package/dist/utils/Utils.d.ts +67 -67
  226. package/dist/utils/Utils.js +208 -208
  227. package/package.json +43 -43
  228. package/src/SmartChainAssets.ts +186 -186
  229. package/src/bitcoin/coinselect2/accumulative.ts +69 -69
  230. package/src/bitcoin/coinselect2/blackjack.ts +50 -50
  231. package/src/bitcoin/coinselect2/index.ts +93 -93
  232. package/src/bitcoin/coinselect2/utils.ts +236 -236
  233. package/src/bitcoin/wallet/BitcoinWallet.ts +439 -439
  234. package/src/bitcoin/wallet/IBitcoinWallet.ts +140 -140
  235. package/src/bitcoin/wallet/SingleAddressBitcoinWallet.ts +225 -225
  236. package/src/enums/FeeType.ts +15 -15
  237. package/src/enums/SwapAmountType.ts +16 -16
  238. package/src/enums/SwapDirection.ts +15 -15
  239. package/src/enums/SwapSide.ts +16 -16
  240. package/src/enums/SwapType.ts +75 -75
  241. package/src/errors/IntermediaryError.ts +28 -28
  242. package/src/errors/RequestError.ts +64 -64
  243. package/src/errors/UserError.ts +15 -15
  244. package/src/events/UnifiedSwapEventListener.ts +173 -173
  245. package/src/http/HttpUtils.ts +91 -91
  246. package/src/http/paramcoders/IParamReader.ts +9 -9
  247. package/src/http/paramcoders/ParamDecoder.ts +145 -145
  248. package/src/http/paramcoders/ParamEncoder.ts +40 -40
  249. package/src/http/paramcoders/SchemaVerifier.ts +153 -153
  250. package/src/http/paramcoders/client/ResponseParamDecoder.ts +57 -57
  251. package/src/http/paramcoders/client/StreamParamEncoder.ts +28 -28
  252. package/src/http/paramcoders/client/StreamingFetchPromise.ts +192 -192
  253. package/src/index.ts +140 -140
  254. package/src/intermediaries/Intermediary.ts +280 -280
  255. package/src/intermediaries/IntermediaryDiscovery.ts +541 -541
  256. package/src/intermediaries/apis/IntermediaryAPI.ts +963 -963
  257. package/src/intermediaries/apis/TrustedIntermediaryAPI.ts +257 -257
  258. package/src/lnurl/LNURL.ts +402 -402
  259. package/src/prices/RedundantSwapPrice.ts +264 -264
  260. package/src/prices/SingleSwapPrice.ts +50 -50
  261. package/src/prices/SwapPriceWithChain.ts +194 -194
  262. package/src/prices/abstract/ICachedSwapPrice.ts +85 -85
  263. package/src/prices/abstract/IPriceProvider.ts +127 -127
  264. package/src/prices/abstract/ISwapPrice.ts +390 -390
  265. package/src/prices/providers/BinancePriceProvider.ts +48 -48
  266. package/src/prices/providers/CoinGeckoPriceProvider.ts +46 -46
  267. package/src/prices/providers/CoinPaprikaPriceProvider.ts +49 -49
  268. package/src/prices/providers/CustomPriceProvider.ts +40 -40
  269. package/src/prices/providers/KrakenPriceProvider.ts +83 -83
  270. package/src/prices/providers/OKXPriceProvider.ts +59 -59
  271. package/src/prices/providers/abstract/ExchangePriceProvider.ts +31 -31
  272. package/src/prices/providers/abstract/HttpPriceProvider.ts +14 -14
  273. package/src/storage/IUnifiedStorage.ts +95 -95
  274. package/src/storage/UnifiedSwapStorage.ts +141 -141
  275. package/src/storage-browser/IndexedDBUnifiedStorage.ts +350 -350
  276. package/src/storage-browser/LocalStorageManager.ts +106 -106
  277. package/src/swapper/Swapper.ts +2488 -2488
  278. package/src/swapper/SwapperFactory.ts +307 -307
  279. package/src/swapper/SwapperUtils.ts +570 -570
  280. package/src/swapper/SwapperWithChain.ts +707 -707
  281. package/src/swapper/SwapperWithSigner.ts +511 -511
  282. package/src/swaps/IAddressSwap.ts +30 -30
  283. package/src/swaps/IBTCWalletSwap.ts +92 -92
  284. package/src/swaps/IClaimableSwap.ts +65 -65
  285. package/src/swaps/IClaimableSwapWrapper.ts +17 -17
  286. package/src/swaps/IRefundableSwap.ts +58 -58
  287. package/src/swaps/ISwap.ts +703 -703
  288. package/src/swaps/ISwapWithGasDrop.ts +25 -25
  289. package/src/swaps/ISwapWrapper.ts +539 -539
  290. package/src/swaps/escrow_swaps/IEscrowSelfInitSwap.ts +217 -217
  291. package/src/swaps/escrow_swaps/IEscrowSwap.ts +269 -269
  292. package/src/swaps/escrow_swaps/IEscrowSwapWrapper.ts +282 -282
  293. package/src/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.ts +169 -169
  294. package/src/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.ts +300 -300
  295. package/src/swaps/escrow_swaps/frombtc/IFromBTCWrapper.ts +107 -107
  296. package/src/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.ts +1473 -1474
  297. package/src/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.ts +601 -601
  298. package/src/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.ts +1582 -1582
  299. package/src/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.ts +750 -750
  300. package/src/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.ts +1299 -1299
  301. package/src/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.ts +610 -610
  302. package/src/swaps/escrow_swaps/tobtc/IToBTCSwap.ts +1096 -1096
  303. package/src/swaps/escrow_swaps/tobtc/IToBTCWrapper.ts +138 -138
  304. package/src/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.ts +304 -304
  305. package/src/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.ts +786 -786
  306. package/src/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.ts +206 -206
  307. package/src/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.ts +401 -401
  308. package/src/swaps/spv_swaps/SpvFromBTCSwap.ts +1812 -1812
  309. package/src/swaps/spv_swaps/SpvFromBTCWrapper.ts +1236 -1236
  310. package/src/swaps/trusted/ln/LnForGasSwap.ts +589 -589
  311. package/src/swaps/trusted/ln/LnForGasWrapper.ts +91 -91
  312. package/src/swaps/trusted/onchain/OnchainForGasSwap.ts +862 -862
  313. package/src/swaps/trusted/onchain/OnchainForGasWrapper.ts +131 -131
  314. package/src/types/AmountData.ts +9 -9
  315. package/src/types/CustomPriceFunction.ts +11 -11
  316. package/src/types/PriceInfoType.ts +66 -66
  317. package/src/types/SwapExecutionAction.ts +99 -99
  318. package/src/types/SwapStateInfo.ts +6 -6
  319. package/src/types/SwapWithSigner.ts +61 -61
  320. package/src/types/Token.ts +163 -163
  321. package/src/types/TokenAmount.ts +132 -132
  322. package/src/types/fees/Fee.ts +56 -56
  323. package/src/types/fees/FeeBreakdown.ts +11 -11
  324. package/src/types/fees/PercentagePPM.ts +26 -26
  325. package/src/types/lnurl/LNURLPay.ts +79 -79
  326. package/src/types/lnurl/LNURLWithdraw.ts +61 -61
  327. package/src/types/wallets/LightningInvoiceCreateService.ts +30 -30
  328. package/src/types/wallets/MinimalBitcoinWalletInterface.ts +21 -21
  329. package/src/types/wallets/MinimalLightningNetworkWalletInterface.ts +9 -9
  330. package/src/utils/AutomaticClockDriftCorrection.ts +71 -71
  331. package/src/utils/BitcoinUtils.ts +132 -132
  332. package/src/utils/BitcoinWalletUtils.ts +15 -15
  333. package/src/utils/Logger.ts +14 -14
  334. package/src/utils/RetryUtils.ts +78 -78
  335. package/src/utils/SwapUtils.ts +99 -99
  336. package/src/utils/TimeoutUtils.ts +49 -49
  337. package/src/utils/TokenUtils.ts +33 -33
  338. package/src/utils/TypeUtils.ts +8 -8
  339. package/src/utils/Utils.ts +212 -212
@@ -1,424 +1,424 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.IntermediaryDiscovery = exports.SwapHandlerType = void 0;
4
- const Intermediary_1 = require("./Intermediary");
5
- const SwapType_1 = require("../enums/SwapType");
6
- const events_1 = require("events");
7
- const buffer_1 = require("buffer");
8
- const Utils_1 = require("../utils/Utils");
9
- const IntermediaryAPI_1 = require("./apis/IntermediaryAPI");
10
- const Logger_1 = require("../utils/Logger");
11
- const HttpUtils_1 = require("../http/HttpUtils");
12
- const RetryUtils_1 = require("../utils/RetryUtils");
13
- /**
14
- * Swap handler type mapping for intermediary communication
15
- *
16
- * @category LPs
17
- */
18
- var SwapHandlerType;
19
- (function (SwapHandlerType) {
20
- SwapHandlerType["TO_BTC"] = "TO_BTC";
21
- SwapHandlerType["FROM_BTC"] = "FROM_BTC";
22
- SwapHandlerType["TO_BTCLN"] = "TO_BTCLN";
23
- SwapHandlerType["FROM_BTCLN"] = "FROM_BTCLN";
24
- SwapHandlerType["FROM_BTC_TRUSTED"] = "FROM_BTC_TRUSTED";
25
- SwapHandlerType["FROM_BTCLN_TRUSTED"] = "FROM_BTCLN_TRUSTED";
26
- SwapHandlerType["FROM_BTC_SPV"] = "FROM_BTC_SPV";
27
- SwapHandlerType["FROM_BTCLN_AUTO"] = "FROM_BTCLN_AUTO";
28
- })(SwapHandlerType = exports.SwapHandlerType || (exports.SwapHandlerType = {}));
29
- /**
30
- * Converts SwapHandlerType (represented as string & used in REST API communication with intermediaries) to regular
31
- * {@link SwapType}
32
- *
33
- * @param swapHandlerType
34
- */
35
- function swapHandlerTypeToSwapType(swapHandlerType) {
36
- switch (swapHandlerType) {
37
- case SwapHandlerType.FROM_BTC:
38
- return SwapType_1.SwapType.FROM_BTC;
39
- case SwapHandlerType.TO_BTC:
40
- return SwapType_1.SwapType.TO_BTC;
41
- case SwapHandlerType.FROM_BTCLN:
42
- return SwapType_1.SwapType.FROM_BTCLN;
43
- case SwapHandlerType.TO_BTCLN:
44
- return SwapType_1.SwapType.TO_BTCLN;
45
- case SwapHandlerType.FROM_BTC_TRUSTED:
46
- return SwapType_1.SwapType.TRUSTED_FROM_BTC;
47
- case SwapHandlerType.FROM_BTCLN_TRUSTED:
48
- return SwapType_1.SwapType.TRUSTED_FROM_BTCLN;
49
- case SwapHandlerType.FROM_BTC_SPV:
50
- return SwapType_1.SwapType.SPV_VAULT_FROM_BTC;
51
- case SwapHandlerType.FROM_BTCLN_AUTO:
52
- return SwapType_1.SwapType.FROM_BTCLN_AUTO;
53
- default:
54
- return SwapType_1.SwapType.TRUSTED_FROM_BTCLN;
55
- }
56
- }
57
- /**
58
- * A default intermediary comparator, only takes the announced fee into consideration
59
- *
60
- * @param swapType
61
- * @param tokenAddress
62
- * @param swapAmount
63
- */
64
- function getIntermediaryComparator(swapType, tokenAddress, swapAmount) {
65
- if (swapType === SwapType_1.SwapType.TO_BTC) {
66
- //TODO: Also take reputation into account
67
- }
68
- return (a, b) => {
69
- const aService = a.services[swapType];
70
- const bService = b.services[swapType];
71
- if (aService == null && bService == null)
72
- return 0;
73
- if (aService == null)
74
- return 1;
75
- if (bService == null)
76
- return -1;
77
- if (swapAmount == null) {
78
- return aService.swapFeePPM - bService.swapFeePPM;
79
- }
80
- else {
81
- const feeA = BigInt(aService.swapBaseFee) + (swapAmount * BigInt(aService.swapFeePPM) / 1000000n);
82
- const feeB = BigInt(bService.swapBaseFee) + (swapAmount * BigInt(bService.swapFeePPM) / 1000000n);
83
- return feeA - feeB > 0n ? 1 : feeA === feeB ? 0 : -1;
84
- }
85
- };
86
- }
87
- const logger = (0, Logger_1.getLogger)("IntermediaryDiscovery: ");
88
- const REGISTRY_URL = "https://api.github.com/repos/adambor/SolLightning-registry/contents/registry.json?ref=main";
89
- //To allow for legacy responses from not-yet updated LPs
90
- const DEFAULT_CHAIN = "SOLANA";
91
- /**
92
- * Discovery service for available intermediaries (liquidity providers)
93
- *
94
- * @category LPs
95
- */
96
- class IntermediaryDiscovery extends events_1.EventEmitter {
97
- constructor(swapContracts, registryUrl = REGISTRY_URL, nodeUrls, httpRequestTimeout, maxWaitForOthersTimeout) {
98
- super();
99
- /**
100
- * A current list of active intermediaries
101
- */
102
- this.intermediaries = [];
103
- this.swapContracts = swapContracts;
104
- this.registryUrl = registryUrl;
105
- this.overrideNodeUrls = nodeUrls;
106
- this.httpRequestTimeout = httpRequestTimeout;
107
- this.maxWaitForOthersTimeout = maxWaitForOthersTimeout;
108
- }
109
- /**
110
- * Fetches the URLs of swap intermediaries from registry or from a pre-defined array of node urls
111
- *
112
- * @param abortSignal
113
- */
114
- async getIntermediaryUrls(abortSignal) {
115
- if (this.overrideNodeUrls != null && this.overrideNodeUrls.length > 0) {
116
- return this.overrideNodeUrls;
117
- }
118
- const response = await (0, RetryUtils_1.tryWithRetries)(() => (0, HttpUtils_1.httpGet)(this.registryUrl, this.httpRequestTimeout, abortSignal), { maxRetries: 3, delay: 100, exponential: true });
119
- const content = response.content.replace(new RegExp("\\n", "g"), "");
120
- return JSON.parse(buffer_1.Buffer.from(content, "base64").toString());
121
- }
122
- /**
123
- * Returns data as reported by a specific node (as identified by its URL). This function is specifically made
124
- * in a way, that in case the abortSignal fires AFTER the LP response was received (and during signature checking),
125
- * it proceeds with the addresses it was able to verify already. Hence after calling abort, this function is guaranteed
126
- * to either reject or resolve instantly.
127
- *
128
- * @param url
129
- * @param abortSignal
130
- */
131
- async getNodeInfo(url, abortSignal) {
132
- const response = await (0, RetryUtils_1.tryWithRetries)(() => IntermediaryAPI_1.IntermediaryAPI.getIntermediaryInfo(url, this.httpRequestTimeout, abortSignal), { maxRetries: 3, delay: 100, exponential: true }, undefined, abortSignal, "debug");
133
- abortSignal?.throwIfAborted();
134
- const promises = [];
135
- const addresses = {};
136
- const contractVersions = {};
137
- for (let chain in response.chains) {
138
- if (this.swapContracts[chain] != null) {
139
- const { signature, address, contractVersion } = response.chains[chain];
140
- const _contractVersion = contractVersion ?? "v1";
141
- const contract = this.swapContracts[chain][_contractVersion];
142
- if (contract == null) {
143
- logger.warn("getNodeInfo(): Unknown chain contract version " + _contractVersion + " for " + chain + " reported by intermediary: " + url);
144
- continue;
145
- }
146
- promises.push((async () => {
147
- try {
148
- await contract.swapContract.isValidDataSignature(buffer_1.Buffer.from(response.envelope), signature, address);
149
- addresses[chain] = address;
150
- contractVersions[chain] = _contractVersion;
151
- }
152
- catch (e) {
153
- logger.warn("getNodeInfo(): Failed to verify " + chain + " signature for intermediary: " + url);
154
- }
155
- })());
156
- }
157
- }
158
- if (abortSignal != null) {
159
- await Promise.race([
160
- Promise.all(promises),
161
- new Promise(resolve => abortSignal.addEventListener("abort", resolve))
162
- ]);
163
- }
164
- else {
165
- await Promise.all(promises);
166
- }
167
- //Handle legacy responses
168
- const info = JSON.parse(response.envelope);
169
- for (let swapType in info.services) {
170
- const serviceData = info.services[swapType];
171
- if (serviceData.chainTokens == null)
172
- serviceData.chainTokens = {
173
- [DEFAULT_CHAIN]: serviceData.tokens
174
- };
175
- for (let chain in serviceData.chainTokens) {
176
- if (addresses[chain] == null)
177
- delete serviceData.chainTokens[chain];
178
- }
179
- }
180
- return {
181
- addresses,
182
- contractVersions,
183
- info
184
- };
185
- }
186
- /**
187
- * Inherits abort signal logic from `getNodeInfo()`, check those function docs to better understand
188
- *
189
- * @param url
190
- * @param abortSignal
191
- * @private
192
- */
193
- async loadIntermediary(url, abortSignal) {
194
- try {
195
- const nodeInfo = await this.getNodeInfo(url, abortSignal);
196
- const services = {};
197
- for (let key in nodeInfo.info.services) {
198
- services[swapHandlerTypeToSwapType(key)] = nodeInfo.info.services[key];
199
- }
200
- return new Intermediary_1.Intermediary(url, nodeInfo.addresses, services, undefined, nodeInfo.contractVersions);
201
- }
202
- catch (e) {
203
- logger.warn("fetchIntermediaries(): Intermediary " + url + ` is unreachable due to ${e.name ?? e.message} error, skipping...`);
204
- logger.debug("fetchIntermediaries(): Error contacting intermediary " + url + ": ", e);
205
- return null;
206
- }
207
- }
208
- /**
209
- * Returns the intermediary at the provided URL, either from the already fetched list of LPs
210
- * or fetches the data on-demand, by sending the handshake HTTP request (/info) to the LP.
211
- *
212
- * Doesn't save the fetched intermediary to the list of intermediaries if it isn't already
213
- * part of the known intermediaries
214
- *
215
- * @param url Base URL of the intermediary, which accepts HTTP requests
216
- * @param abortSignal
217
- */
218
- getIntermediary(url, abortSignal) {
219
- const foundLp = this.intermediaries.find(lp => lp.url === url);
220
- if (foundLp != null)
221
- return Promise.resolve(foundLp);
222
- return this.loadIntermediary(url, abortSignal);
223
- }
224
- /**
225
- * Reloads the saves a list of intermediaries
226
- *
227
- * @param abortSignal
228
- */
229
- async reloadIntermediaries(abortSignal) {
230
- //Get LP urls
231
- const urls = await this.getIntermediaryUrls(abortSignal);
232
- logger.debug("reloadIntermediaries(): Pinging intermediaries: ", urls.join());
233
- const abortController = (0, Utils_1.extendAbortController)(abortSignal);
234
- let timer;
235
- const intermediaries = await Promise.all(urls.map(url => this.loadIntermediary(url, abortController.signal).then(lp => {
236
- if (lp != null && timer == null)
237
- timer = setTimeout(() => {
238
- //Trigger abort through the abort controller, such that all underlying promises resolve instantly
239
- abortController.abort();
240
- }, this.maxWaitForOthersTimeout ?? 5 * 1000);
241
- return lp;
242
- })));
243
- if (timer != null)
244
- clearTimeout(timer);
245
- const activeNodes = intermediaries.filter(intermediary => intermediary != null);
246
- if (activeNodes.length === 0)
247
- logger.error("reloadIntermediaries(): No online intermediary found! Swaps might not be possible!");
248
- this.intermediaries = activeNodes;
249
- this.emit("added", activeNodes);
250
- logger.info("reloadIntermediaries(): Using active intermediaries: ", activeNodes.map(lp => lp.url).join());
251
- }
252
- /**
253
- * Initializes the discovery by fetching/reloading intermediaries
254
- *
255
- * @param abortSignal
256
- */
257
- init(abortSignal) {
258
- logger.info("init(): Initializing with registryUrl: " + this.registryUrl + " intermediary array: " + (this.overrideNodeUrls || []).join());
259
- return this.reloadIntermediaries(abortSignal);
260
- }
261
- /**
262
- * Returns known swap bounds (in satoshis - BTC) by aggregating values from all known intermediaries
263
- */
264
- getMultichainSwapBounds() {
265
- const bounds = {};
266
- this.intermediaries.forEach(intermediary => {
267
- for (let _swapType in intermediary.services) {
268
- const swapType = parseInt(_swapType);
269
- const swapService = intermediary.services[swapType];
270
- const multichainBounds = (bounds[swapType] ??= {});
271
- for (let chainId in swapService.chainTokens) {
272
- multichainBounds[chainId] ??= {};
273
- const tokenBounds = multichainBounds[chainId];
274
- for (let token of swapService.chainTokens[chainId]) {
275
- const tokenMinMax = tokenBounds[token];
276
- if (tokenMinMax == null) {
277
- tokenBounds[token] = {
278
- min: BigInt(swapService.min),
279
- max: BigInt(swapService.max)
280
- };
281
- }
282
- else {
283
- tokenMinMax.min = (0, Utils_1.bigIntMin)(tokenMinMax.min, BigInt(swapService.min));
284
- tokenMinMax.max = (0, Utils_1.bigIntMax)(tokenMinMax.max, BigInt(swapService.max));
285
- }
286
- }
287
- }
288
- }
289
- });
290
- return bounds;
291
- }
292
- /**
293
- * Returns aggregate swap bounds (in satoshis - BTC) as indicated by the intermediaries
294
- */
295
- getSwapBounds(chainIdentifier) {
296
- const bounds = {};
297
- this.intermediaries.forEach(intermediary => {
298
- for (let _swapType in intermediary.services) {
299
- const swapType = parseInt(_swapType);
300
- const swapService = intermediary.services[swapType];
301
- const tokenBounds = (bounds[swapType] ??= {});
302
- if (swapService.chainTokens != null && swapService.chainTokens[chainIdentifier] != null) {
303
- for (let token of swapService.chainTokens[chainIdentifier]) {
304
- const tokenMinMax = tokenBounds[token];
305
- if (tokenMinMax == null) {
306
- tokenBounds[token] = {
307
- min: BigInt(swapService.min),
308
- max: BigInt(swapService.max)
309
- };
310
- }
311
- else {
312
- tokenMinMax.min = (0, Utils_1.bigIntMin)(tokenMinMax.min, BigInt(swapService.min));
313
- tokenMinMax.max = (0, Utils_1.bigIntMax)(tokenMinMax.max, BigInt(swapService.max));
314
- }
315
- }
316
- }
317
- }
318
- });
319
- return bounds;
320
- }
321
- /**
322
- * Returns the aggregate swap minimum (in satoshis - BTC) for a specific swap type & token
323
- * as indicated by the intermediaries
324
- *
325
- * @param chainIdentifier Chain identifier of the smart chain
326
- * @param swapType Swap protocol type
327
- * @param tokenAddress Token address
328
- */
329
- getSwapMinimum(chainIdentifier, swapType, tokenAddress) {
330
- const tokenStr = tokenAddress.toString();
331
- return this.intermediaries.reduce((prevMin, intermediary) => {
332
- const swapService = intermediary.services[swapType];
333
- if (swapService == null)
334
- return prevMin;
335
- const chainTokens = swapService.chainTokens?.[chainIdentifier];
336
- if (chainTokens == null)
337
- return prevMin;
338
- if (!chainTokens.includes(tokenStr))
339
- return prevMin;
340
- return prevMin == null ? swapService.min : Math.min(prevMin, swapService.min);
341
- }, null);
342
- }
343
- /**
344
- * Returns the aggregate swap maximum (in satoshis - BTC) for a specific swap type & token
345
- * as indicated by the intermediaries
346
- *
347
- * @param chainIdentifier Chain identifier of the smart chain
348
- * @param swapType Swap protocol type
349
- * @param tokenAddress Token address
350
- */
351
- getSwapMaximum(chainIdentifier, swapType, tokenAddress) {
352
- const tokenStr = tokenAddress.toString();
353
- return this.intermediaries.reduce((prevMax, intermediary) => {
354
- const swapService = intermediary.services[swapType];
355
- if (swapService == null)
356
- return prevMax;
357
- const chainTokens = swapService.chainTokens?.[chainIdentifier];
358
- if (chainTokens == null)
359
- return prevMax;
360
- if (!chainTokens.includes(tokenStr))
361
- return prevMax;
362
- return prevMax == null ? swapService.max : Math.max(prevMax, swapService.max);
363
- }, null);
364
- }
365
- /**
366
- * Returns swap candidates for a specific swap type & token address
367
- *
368
- * @remark Also filters the LPs based on supported swap versions
369
- *
370
- * @param chainIdentifier Chain identifier of the smart chain
371
- * @param swapType Swap protocol type
372
- * @param tokenAddress Token address
373
- * @param amount Amount to be swapped in sats - BTC
374
- * @param count How many intermediaries to return at most
375
- */
376
- getSwapCandidates(chainIdentifier, swapType, tokenAddress, amount, count) {
377
- const candidates = this.intermediaries.filter(e => {
378
- const swapService = e.services[swapType];
379
- if (swapService == null)
380
- return false;
381
- if (amount != null && amount < BigInt(swapService.min))
382
- return false;
383
- if (amount != null && amount > BigInt(swapService.max))
384
- return false;
385
- if (swapService.chainTokens == null)
386
- return false;
387
- if (swapService.chainTokens[chainIdentifier] == null)
388
- return false;
389
- if (!swapService.chainTokens[chainIdentifier].includes(tokenAddress.toString()))
390
- return false;
391
- const contracts = this.swapContracts[chainIdentifier][e.getContractVersion(chainIdentifier) ?? "v1"];
392
- if (contracts == null)
393
- return false;
394
- if (swapType === SwapType_1.SwapType.FROM_BTCLN_AUTO && !contracts.swapContract?.supportsInitWithoutClaimer)
395
- return false;
396
- if (swapType === SwapType_1.SwapType.SPV_VAULT_FROM_BTC && contracts.spvVaultContract == null)
397
- return false;
398
- return true;
399
- });
400
- candidates.sort(getIntermediaryComparator(swapType, tokenAddress, amount));
401
- if (count == null) {
402
- return candidates;
403
- }
404
- else {
405
- return candidates.slice(0, count);
406
- }
407
- }
408
- /**
409
- * Removes a specific intermediary from the list of active intermediaries (used for blacklisting)
410
- *
411
- * @param intermediary
412
- */
413
- removeIntermediary(intermediary) {
414
- const index = this.intermediaries.indexOf(intermediary);
415
- if (index >= 0) {
416
- logger.info("removeIntermediary(): Removing intermediary: " + intermediary.url);
417
- this.intermediaries.splice(index, 1);
418
- this.emit("removed", [intermediary]);
419
- return true;
420
- }
421
- return false;
422
- }
423
- }
424
- exports.IntermediaryDiscovery = IntermediaryDiscovery;
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.IntermediaryDiscovery = exports.SwapHandlerType = void 0;
4
+ const Intermediary_1 = require("./Intermediary");
5
+ const SwapType_1 = require("../enums/SwapType");
6
+ const events_1 = require("events");
7
+ const buffer_1 = require("buffer");
8
+ const Utils_1 = require("../utils/Utils");
9
+ const IntermediaryAPI_1 = require("./apis/IntermediaryAPI");
10
+ const Logger_1 = require("../utils/Logger");
11
+ const HttpUtils_1 = require("../http/HttpUtils");
12
+ const RetryUtils_1 = require("../utils/RetryUtils");
13
+ /**
14
+ * Swap handler type mapping for intermediary communication
15
+ *
16
+ * @category LPs
17
+ */
18
+ var SwapHandlerType;
19
+ (function (SwapHandlerType) {
20
+ SwapHandlerType["TO_BTC"] = "TO_BTC";
21
+ SwapHandlerType["FROM_BTC"] = "FROM_BTC";
22
+ SwapHandlerType["TO_BTCLN"] = "TO_BTCLN";
23
+ SwapHandlerType["FROM_BTCLN"] = "FROM_BTCLN";
24
+ SwapHandlerType["FROM_BTC_TRUSTED"] = "FROM_BTC_TRUSTED";
25
+ SwapHandlerType["FROM_BTCLN_TRUSTED"] = "FROM_BTCLN_TRUSTED";
26
+ SwapHandlerType["FROM_BTC_SPV"] = "FROM_BTC_SPV";
27
+ SwapHandlerType["FROM_BTCLN_AUTO"] = "FROM_BTCLN_AUTO";
28
+ })(SwapHandlerType = exports.SwapHandlerType || (exports.SwapHandlerType = {}));
29
+ /**
30
+ * Converts SwapHandlerType (represented as string & used in REST API communication with intermediaries) to regular
31
+ * {@link SwapType}
32
+ *
33
+ * @param swapHandlerType
34
+ */
35
+ function swapHandlerTypeToSwapType(swapHandlerType) {
36
+ switch (swapHandlerType) {
37
+ case SwapHandlerType.FROM_BTC:
38
+ return SwapType_1.SwapType.FROM_BTC;
39
+ case SwapHandlerType.TO_BTC:
40
+ return SwapType_1.SwapType.TO_BTC;
41
+ case SwapHandlerType.FROM_BTCLN:
42
+ return SwapType_1.SwapType.FROM_BTCLN;
43
+ case SwapHandlerType.TO_BTCLN:
44
+ return SwapType_1.SwapType.TO_BTCLN;
45
+ case SwapHandlerType.FROM_BTC_TRUSTED:
46
+ return SwapType_1.SwapType.TRUSTED_FROM_BTC;
47
+ case SwapHandlerType.FROM_BTCLN_TRUSTED:
48
+ return SwapType_1.SwapType.TRUSTED_FROM_BTCLN;
49
+ case SwapHandlerType.FROM_BTC_SPV:
50
+ return SwapType_1.SwapType.SPV_VAULT_FROM_BTC;
51
+ case SwapHandlerType.FROM_BTCLN_AUTO:
52
+ return SwapType_1.SwapType.FROM_BTCLN_AUTO;
53
+ default:
54
+ return SwapType_1.SwapType.TRUSTED_FROM_BTCLN;
55
+ }
56
+ }
57
+ /**
58
+ * A default intermediary comparator, only takes the announced fee into consideration
59
+ *
60
+ * @param swapType
61
+ * @param tokenAddress
62
+ * @param swapAmount
63
+ */
64
+ function getIntermediaryComparator(swapType, tokenAddress, swapAmount) {
65
+ if (swapType === SwapType_1.SwapType.TO_BTC) {
66
+ //TODO: Also take reputation into account
67
+ }
68
+ return (a, b) => {
69
+ const aService = a.services[swapType];
70
+ const bService = b.services[swapType];
71
+ if (aService == null && bService == null)
72
+ return 0;
73
+ if (aService == null)
74
+ return 1;
75
+ if (bService == null)
76
+ return -1;
77
+ if (swapAmount == null) {
78
+ return aService.swapFeePPM - bService.swapFeePPM;
79
+ }
80
+ else {
81
+ const feeA = BigInt(aService.swapBaseFee) + (swapAmount * BigInt(aService.swapFeePPM) / 1000000n);
82
+ const feeB = BigInt(bService.swapBaseFee) + (swapAmount * BigInt(bService.swapFeePPM) / 1000000n);
83
+ return feeA - feeB > 0n ? 1 : feeA === feeB ? 0 : -1;
84
+ }
85
+ };
86
+ }
87
+ const logger = (0, Logger_1.getLogger)("IntermediaryDiscovery: ");
88
+ const REGISTRY_URL = "https://api.github.com/repos/adambor/SolLightning-registry/contents/registry.json?ref=main";
89
+ //To allow for legacy responses from not-yet updated LPs
90
+ const DEFAULT_CHAIN = "SOLANA";
91
+ /**
92
+ * Discovery service for available intermediaries (liquidity providers)
93
+ *
94
+ * @category LPs
95
+ */
96
+ class IntermediaryDiscovery extends events_1.EventEmitter {
97
+ constructor(swapContracts, registryUrl = REGISTRY_URL, nodeUrls, httpRequestTimeout, maxWaitForOthersTimeout) {
98
+ super();
99
+ /**
100
+ * A current list of active intermediaries
101
+ */
102
+ this.intermediaries = [];
103
+ this.swapContracts = swapContracts;
104
+ this.registryUrl = registryUrl;
105
+ this.overrideNodeUrls = nodeUrls;
106
+ this.httpRequestTimeout = httpRequestTimeout;
107
+ this.maxWaitForOthersTimeout = maxWaitForOthersTimeout;
108
+ }
109
+ /**
110
+ * Fetches the URLs of swap intermediaries from registry or from a pre-defined array of node urls
111
+ *
112
+ * @param abortSignal
113
+ */
114
+ async getIntermediaryUrls(abortSignal) {
115
+ if (this.overrideNodeUrls != null && this.overrideNodeUrls.length > 0) {
116
+ return this.overrideNodeUrls;
117
+ }
118
+ const response = await (0, RetryUtils_1.tryWithRetries)(() => (0, HttpUtils_1.httpGet)(this.registryUrl, this.httpRequestTimeout, abortSignal), { maxRetries: 3, delay: 100, exponential: true });
119
+ const content = response.content.replace(new RegExp("\\n", "g"), "");
120
+ return JSON.parse(buffer_1.Buffer.from(content, "base64").toString());
121
+ }
122
+ /**
123
+ * Returns data as reported by a specific node (as identified by its URL). This function is specifically made
124
+ * in a way, that in case the abortSignal fires AFTER the LP response was received (and during signature checking),
125
+ * it proceeds with the addresses it was able to verify already. Hence after calling abort, this function is guaranteed
126
+ * to either reject or resolve instantly.
127
+ *
128
+ * @param url
129
+ * @param abortSignal
130
+ */
131
+ async getNodeInfo(url, abortSignal) {
132
+ const response = await (0, RetryUtils_1.tryWithRetries)(() => IntermediaryAPI_1.IntermediaryAPI.getIntermediaryInfo(url, this.httpRequestTimeout, abortSignal), { maxRetries: 3, delay: 100, exponential: true }, undefined, abortSignal, "debug");
133
+ abortSignal?.throwIfAborted();
134
+ const promises = [];
135
+ const addresses = {};
136
+ const contractVersions = {};
137
+ for (let chain in response.chains) {
138
+ if (this.swapContracts[chain] != null) {
139
+ const { signature, address, contractVersion } = response.chains[chain];
140
+ const _contractVersion = contractVersion ?? "v1";
141
+ const contract = this.swapContracts[chain][_contractVersion];
142
+ if (contract == null) {
143
+ logger.warn("getNodeInfo(): Unknown chain contract version " + _contractVersion + " for " + chain + " reported by intermediary: " + url);
144
+ continue;
145
+ }
146
+ promises.push((async () => {
147
+ try {
148
+ await contract.swapContract.isValidDataSignature(buffer_1.Buffer.from(response.envelope), signature, address);
149
+ addresses[chain] = address;
150
+ contractVersions[chain] = _contractVersion;
151
+ }
152
+ catch (e) {
153
+ logger.warn("getNodeInfo(): Failed to verify " + chain + " signature for intermediary: " + url);
154
+ }
155
+ })());
156
+ }
157
+ }
158
+ if (abortSignal != null) {
159
+ await Promise.race([
160
+ Promise.all(promises),
161
+ new Promise(resolve => abortSignal.addEventListener("abort", resolve))
162
+ ]);
163
+ }
164
+ else {
165
+ await Promise.all(promises);
166
+ }
167
+ //Handle legacy responses
168
+ const info = JSON.parse(response.envelope);
169
+ for (let swapType in info.services) {
170
+ const serviceData = info.services[swapType];
171
+ if (serviceData.chainTokens == null)
172
+ serviceData.chainTokens = {
173
+ [DEFAULT_CHAIN]: serviceData.tokens
174
+ };
175
+ for (let chain in serviceData.chainTokens) {
176
+ if (addresses[chain] == null)
177
+ delete serviceData.chainTokens[chain];
178
+ }
179
+ }
180
+ return {
181
+ addresses,
182
+ contractVersions,
183
+ info
184
+ };
185
+ }
186
+ /**
187
+ * Inherits abort signal logic from `getNodeInfo()`, check those function docs to better understand
188
+ *
189
+ * @param url
190
+ * @param abortSignal
191
+ * @private
192
+ */
193
+ async loadIntermediary(url, abortSignal) {
194
+ try {
195
+ const nodeInfo = await this.getNodeInfo(url, abortSignal);
196
+ const services = {};
197
+ for (let key in nodeInfo.info.services) {
198
+ services[swapHandlerTypeToSwapType(key)] = nodeInfo.info.services[key];
199
+ }
200
+ return new Intermediary_1.Intermediary(url, nodeInfo.addresses, services, undefined, nodeInfo.contractVersions);
201
+ }
202
+ catch (e) {
203
+ logger.warn("fetchIntermediaries(): Intermediary " + url + ` is unreachable due to ${e.name ?? e.message} error, skipping...`);
204
+ logger.debug("fetchIntermediaries(): Error contacting intermediary " + url + ": ", e);
205
+ return null;
206
+ }
207
+ }
208
+ /**
209
+ * Returns the intermediary at the provided URL, either from the already fetched list of LPs
210
+ * or fetches the data on-demand, by sending the handshake HTTP request (/info) to the LP.
211
+ *
212
+ * Doesn't save the fetched intermediary to the list of intermediaries if it isn't already
213
+ * part of the known intermediaries
214
+ *
215
+ * @param url Base URL of the intermediary, which accepts HTTP requests
216
+ * @param abortSignal
217
+ */
218
+ getIntermediary(url, abortSignal) {
219
+ const foundLp = this.intermediaries.find(lp => lp.url === url);
220
+ if (foundLp != null)
221
+ return Promise.resolve(foundLp);
222
+ return this.loadIntermediary(url, abortSignal);
223
+ }
224
+ /**
225
+ * Reloads the saves a list of intermediaries
226
+ *
227
+ * @param abortSignal
228
+ */
229
+ async reloadIntermediaries(abortSignal) {
230
+ //Get LP urls
231
+ const urls = await this.getIntermediaryUrls(abortSignal);
232
+ logger.debug("reloadIntermediaries(): Pinging intermediaries: ", urls.join());
233
+ const abortController = (0, Utils_1.extendAbortController)(abortSignal);
234
+ let timer;
235
+ const intermediaries = await Promise.all(urls.map(url => this.loadIntermediary(url, abortController.signal).then(lp => {
236
+ if (lp != null && timer == null)
237
+ timer = setTimeout(() => {
238
+ //Trigger abort through the abort controller, such that all underlying promises resolve instantly
239
+ abortController.abort();
240
+ }, this.maxWaitForOthersTimeout ?? 5 * 1000);
241
+ return lp;
242
+ })));
243
+ if (timer != null)
244
+ clearTimeout(timer);
245
+ const activeNodes = intermediaries.filter(intermediary => intermediary != null);
246
+ if (activeNodes.length === 0)
247
+ logger.error("reloadIntermediaries(): No online intermediary found! Swaps might not be possible!");
248
+ this.intermediaries = activeNodes;
249
+ this.emit("added", activeNodes);
250
+ logger.info("reloadIntermediaries(): Using active intermediaries: ", activeNodes.map(lp => lp.url).join());
251
+ }
252
+ /**
253
+ * Initializes the discovery by fetching/reloading intermediaries
254
+ *
255
+ * @param abortSignal
256
+ */
257
+ init(abortSignal) {
258
+ logger.info("init(): Initializing with registryUrl: " + this.registryUrl + " intermediary array: " + (this.overrideNodeUrls || []).join());
259
+ return this.reloadIntermediaries(abortSignal);
260
+ }
261
+ /**
262
+ * Returns known swap bounds (in satoshis - BTC) by aggregating values from all known intermediaries
263
+ */
264
+ getMultichainSwapBounds() {
265
+ const bounds = {};
266
+ this.intermediaries.forEach(intermediary => {
267
+ for (let _swapType in intermediary.services) {
268
+ const swapType = parseInt(_swapType);
269
+ const swapService = intermediary.services[swapType];
270
+ const multichainBounds = (bounds[swapType] ??= {});
271
+ for (let chainId in swapService.chainTokens) {
272
+ multichainBounds[chainId] ??= {};
273
+ const tokenBounds = multichainBounds[chainId];
274
+ for (let token of swapService.chainTokens[chainId]) {
275
+ const tokenMinMax = tokenBounds[token];
276
+ if (tokenMinMax == null) {
277
+ tokenBounds[token] = {
278
+ min: BigInt(swapService.min),
279
+ max: BigInt(swapService.max)
280
+ };
281
+ }
282
+ else {
283
+ tokenMinMax.min = (0, Utils_1.bigIntMin)(tokenMinMax.min, BigInt(swapService.min));
284
+ tokenMinMax.max = (0, Utils_1.bigIntMax)(tokenMinMax.max, BigInt(swapService.max));
285
+ }
286
+ }
287
+ }
288
+ }
289
+ });
290
+ return bounds;
291
+ }
292
+ /**
293
+ * Returns aggregate swap bounds (in satoshis - BTC) as indicated by the intermediaries
294
+ */
295
+ getSwapBounds(chainIdentifier) {
296
+ const bounds = {};
297
+ this.intermediaries.forEach(intermediary => {
298
+ for (let _swapType in intermediary.services) {
299
+ const swapType = parseInt(_swapType);
300
+ const swapService = intermediary.services[swapType];
301
+ const tokenBounds = (bounds[swapType] ??= {});
302
+ if (swapService.chainTokens != null && swapService.chainTokens[chainIdentifier] != null) {
303
+ for (let token of swapService.chainTokens[chainIdentifier]) {
304
+ const tokenMinMax = tokenBounds[token];
305
+ if (tokenMinMax == null) {
306
+ tokenBounds[token] = {
307
+ min: BigInt(swapService.min),
308
+ max: BigInt(swapService.max)
309
+ };
310
+ }
311
+ else {
312
+ tokenMinMax.min = (0, Utils_1.bigIntMin)(tokenMinMax.min, BigInt(swapService.min));
313
+ tokenMinMax.max = (0, Utils_1.bigIntMax)(tokenMinMax.max, BigInt(swapService.max));
314
+ }
315
+ }
316
+ }
317
+ }
318
+ });
319
+ return bounds;
320
+ }
321
+ /**
322
+ * Returns the aggregate swap minimum (in satoshis - BTC) for a specific swap type & token
323
+ * as indicated by the intermediaries
324
+ *
325
+ * @param chainIdentifier Chain identifier of the smart chain
326
+ * @param swapType Swap protocol type
327
+ * @param tokenAddress Token address
328
+ */
329
+ getSwapMinimum(chainIdentifier, swapType, tokenAddress) {
330
+ const tokenStr = tokenAddress.toString();
331
+ return this.intermediaries.reduce((prevMin, intermediary) => {
332
+ const swapService = intermediary.services[swapType];
333
+ if (swapService == null)
334
+ return prevMin;
335
+ const chainTokens = swapService.chainTokens?.[chainIdentifier];
336
+ if (chainTokens == null)
337
+ return prevMin;
338
+ if (!chainTokens.includes(tokenStr))
339
+ return prevMin;
340
+ return prevMin == null ? swapService.min : Math.min(prevMin, swapService.min);
341
+ }, null);
342
+ }
343
+ /**
344
+ * Returns the aggregate swap maximum (in satoshis - BTC) for a specific swap type & token
345
+ * as indicated by the intermediaries
346
+ *
347
+ * @param chainIdentifier Chain identifier of the smart chain
348
+ * @param swapType Swap protocol type
349
+ * @param tokenAddress Token address
350
+ */
351
+ getSwapMaximum(chainIdentifier, swapType, tokenAddress) {
352
+ const tokenStr = tokenAddress.toString();
353
+ return this.intermediaries.reduce((prevMax, intermediary) => {
354
+ const swapService = intermediary.services[swapType];
355
+ if (swapService == null)
356
+ return prevMax;
357
+ const chainTokens = swapService.chainTokens?.[chainIdentifier];
358
+ if (chainTokens == null)
359
+ return prevMax;
360
+ if (!chainTokens.includes(tokenStr))
361
+ return prevMax;
362
+ return prevMax == null ? swapService.max : Math.max(prevMax, swapService.max);
363
+ }, null);
364
+ }
365
+ /**
366
+ * Returns swap candidates for a specific swap type & token address
367
+ *
368
+ * @remark Also filters the LPs based on supported swap versions
369
+ *
370
+ * @param chainIdentifier Chain identifier of the smart chain
371
+ * @param swapType Swap protocol type
372
+ * @param tokenAddress Token address
373
+ * @param amount Amount to be swapped in sats - BTC
374
+ * @param count How many intermediaries to return at most
375
+ */
376
+ getSwapCandidates(chainIdentifier, swapType, tokenAddress, amount, count) {
377
+ const candidates = this.intermediaries.filter(e => {
378
+ const swapService = e.services[swapType];
379
+ if (swapService == null)
380
+ return false;
381
+ if (amount != null && amount < BigInt(swapService.min))
382
+ return false;
383
+ if (amount != null && amount > BigInt(swapService.max))
384
+ return false;
385
+ if (swapService.chainTokens == null)
386
+ return false;
387
+ if (swapService.chainTokens[chainIdentifier] == null)
388
+ return false;
389
+ if (!swapService.chainTokens[chainIdentifier].includes(tokenAddress.toString()))
390
+ return false;
391
+ const contracts = this.swapContracts[chainIdentifier][e.getContractVersion(chainIdentifier) ?? "v1"];
392
+ if (contracts == null)
393
+ return false;
394
+ if (swapType === SwapType_1.SwapType.FROM_BTCLN_AUTO && !contracts.swapContract?.supportsInitWithoutClaimer)
395
+ return false;
396
+ if (swapType === SwapType_1.SwapType.SPV_VAULT_FROM_BTC && contracts.spvVaultContract == null)
397
+ return false;
398
+ return true;
399
+ });
400
+ candidates.sort(getIntermediaryComparator(swapType, tokenAddress, amount));
401
+ if (count == null) {
402
+ return candidates;
403
+ }
404
+ else {
405
+ return candidates.slice(0, count);
406
+ }
407
+ }
408
+ /**
409
+ * Removes a specific intermediary from the list of active intermediaries (used for blacklisting)
410
+ *
411
+ * @param intermediary
412
+ */
413
+ removeIntermediary(intermediary) {
414
+ const index = this.intermediaries.indexOf(intermediary);
415
+ if (index >= 0) {
416
+ logger.info("removeIntermediary(): Removing intermediary: " + intermediary.url);
417
+ this.intermediaries.splice(index, 1);
418
+ this.emit("removed", [intermediary]);
419
+ return true;
420
+ }
421
+ return false;
422
+ }
423
+ }
424
+ exports.IntermediaryDiscovery = IntermediaryDiscovery;