@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,458 +1,458 @@
1
- import { IFromBTCSelfInitSwap } from "../IFromBTCSelfInitSwap";
2
- import { SwapType } from "../../../../enums/SwapType";
3
- import { FromBTCDefinition, FromBTCWrapper } from "./FromBTCWrapper";
4
- import { ChainType, SwapCommitState, SwapData } from "@atomiqlabs/base";
5
- import { IBitcoinWallet } from "../../../../bitcoin/wallet/IBitcoinWallet";
6
- import { IBTCWalletSwap } from "../../../IBTCWalletSwap";
7
- import { Transaction } from "@scure/btc-signer";
8
- import { MinimalBitcoinWalletInterface, MinimalBitcoinWalletInterfaceWithSigner } from "../../../../types/wallets/MinimalBitcoinWalletInterface";
9
- import { IClaimableSwap } from "../../../IClaimableSwap";
10
- import { IEscrowSelfInitSwapInit } from "../../IEscrowSelfInitSwap";
11
- import { IAddressSwap } from "../../../IAddressSwap";
12
- import { TokenAmount } from "../../../../types/TokenAmount";
13
- import { BtcToken, SCToken } from "../../../../types/Token";
14
- import { LoggerType } from "../../../../utils/Logger";
15
- import { SwapExecutionAction } from "../../../../types/SwapExecutionAction";
16
- /**
17
- * State enum for legacy escrow based Bitcoin -> Smart chain swaps.
18
- *
19
- * @category Swaps/Legacy/Bitcoin → Smart chain
20
- */
21
- export declare enum FromBTCSwapState {
22
- /**
23
- * Bitcoin swap address has expired and the intermediary (LP) has already refunded
24
- * its funds. No BTC should be sent anymore!
25
- */
26
- FAILED = -4,
27
- /**
28
- * Bitcoin swap address has expired, user should not send any BTC anymore! Though
29
- * the intermediary (LP) hasn't refunded yet. So if there is a transaction already
30
- * in-flight the swap might still succeed.
31
- */
32
- EXPIRED = -3,
33
- /**
34
- * Swap has expired for good and there is no way how it can be executed anymore
35
- */
36
- QUOTE_EXPIRED = -2,
37
- /**
38
- * A swap is almost expired, and it should be presented to the user as expired, though
39
- * there is still a chance that it will be processed
40
- */
41
- QUOTE_SOFT_EXPIRED = -1,
42
- /**
43
- * Swap quote was created, use the {@link FromBTCSwap.commit} or {@link FromBTCSwap.txsCommit} functions
44
- * to initiate it by creating the swap escrow on the destination smart chain
45
- */
46
- PR_CREATED = 0,
47
- /**
48
- * Swap escrow was initiated (committed) on the destination chain, user can send the BTC to the
49
- * swap address with the {@link FromBTCSwap.getFundedPsbt}, {@link FromBTCSwap.getAddress} or
50
- * {@link FromBTCSwap.getHyperlink} functions.
51
- */
52
- CLAIM_COMMITED = 1,
53
- /**
54
- * Input bitcoin transaction was confirmed, wait for automatic settlement by the watchtowers
55
- * using the {@link FromBTCSwap.waitTillClaimed} function or settle manually using the {@link FromBTCSwap.claim}
56
- * or {@link FromBTCSwap.txsClaim} function.
57
- */
58
- BTC_TX_CONFIRMED = 2,
59
- /**
60
- * Swap successfully settled and funds received on the destination chain
61
- */
62
- CLAIM_CLAIMED = 3
63
- }
64
- export type FromBTCSwapInit<T extends SwapData> = IEscrowSelfInitSwapInit<T> & {
65
- data: T;
66
- address?: string;
67
- amount?: bigint;
68
- requiredConfirmations?: number;
69
- };
70
- export declare function isFromBTCSwapInit<T extends SwapData>(obj: any): obj is FromBTCSwapInit<T>;
71
- /**
72
- * Legacy escrow (PrTLC) based swap for Bitcoin -> Smart chains, requires manual initiation
73
- * of the swap escrow on the destination chain.
74
- *
75
- * @category Swaps/Legacy/Bitcoin → Smart chain
76
- */
77
- export declare class FromBTCSwap<T extends ChainType = ChainType> extends IFromBTCSelfInitSwap<T, FromBTCDefinition<T>, FromBTCSwapState> implements IBTCWalletSwap, IClaimableSwap<T, FromBTCDefinition<T>, FromBTCSwapState>, IAddressSwap {
78
- protected readonly TYPE: SwapType.FROM_BTC;
79
- /**
80
- * @internal
81
- */
82
- protected readonly swapStateName: (state: number) => string;
83
- /**
84
- * @internal
85
- */
86
- protected readonly swapStateDescription: {
87
- [-4]: string;
88
- [-3]: string;
89
- [-2]: string;
90
- [-1]: string;
91
- 0: string;
92
- 1: string;
93
- 2: string;
94
- 3: string;
95
- };
96
- /**
97
- * @internal
98
- */
99
- protected readonly logger: LoggerType;
100
- /**
101
- * @internal
102
- */
103
- protected readonly inputToken: BtcToken<false>;
104
- /**
105
- * @internal
106
- */
107
- protected readonly feeRate: string;
108
- /**
109
- * @internal
110
- */
111
- readonly _data: T["Data"];
112
- private address?;
113
- private amount?;
114
- private requiredConfirmations?;
115
- private senderAddress?;
116
- private txId?;
117
- private vout?;
118
- private btcTxConfirmedAt?;
119
- constructor(wrapper: FromBTCWrapper<T>, init: FromBTCSwapInit<T["Data"]>);
120
- constructor(wrapper: FromBTCWrapper<T>, obj: any);
121
- /**
122
- * @inheritDoc
123
- * @internal
124
- */
125
- protected getSwapData(): T["Data"];
126
- /**
127
- * @inheritDoc
128
- * @internal
129
- */
130
- protected upgradeVersion(): void;
131
- /**
132
- * Returns bitcoin address where the on-chain BTC should be sent to
133
- */
134
- getAddress(): string;
135
- /**
136
- * Unsafe bitcoin hyperlink getter, returns the address even before the swap is committed!
137
- *
138
- * @private
139
- */
140
- private _getHyperlink;
141
- /**
142
- * @inheritDoc
143
- */
144
- getHyperlink(): string;
145
- /**
146
- * @inheritDoc
147
- */
148
- getInputAddress(): string | null;
149
- /**
150
- * @inheritDoc
151
- */
152
- getInputTxId(): string | null;
153
- /**
154
- * Returns timeout time (in UNIX milliseconds) when the on-chain address will expire and no funds should be sent
155
- * to that address anymore
156
- */
157
- getTimeoutTime(): number;
158
- /**
159
- * @inheritDoc
160
- */
161
- requiresAction(): boolean;
162
- /**
163
- * @inheritDoc
164
- */
165
- isFinished(): boolean;
166
- /**
167
- * @inheritDoc
168
- */
169
- isClaimable(): boolean;
170
- /**
171
- * @inheritDoc
172
- */
173
- isSuccessful(): boolean;
174
- /**
175
- * @inheritDoc
176
- */
177
- isFailed(): boolean;
178
- /**
179
- * @inheritDoc
180
- */
181
- isInProgress(): boolean;
182
- /**
183
- * @inheritDoc
184
- */
185
- isQuoteExpired(): boolean;
186
- /**
187
- * @inheritDoc
188
- */
189
- isQuoteSoftExpired(): boolean;
190
- /**
191
- * @inheritDoc
192
- * @internal
193
- */
194
- protected canCommit(skipQuoteExpiryChecks?: boolean): boolean;
195
- /**
196
- * @inheritDoc
197
- */
198
- getInputToken(): BtcToken<false>;
199
- /**
200
- * @inheritDoc
201
- */
202
- getInput(): TokenAmount<BtcToken<false>>;
203
- /**
204
- * Returns claimer bounty, acting as a reward for watchtowers to claim the swap automatically,
205
- * this amount is pre-funded by the user on the destination chain when the swap escrow
206
- * is initiated. For total pre-funded deposit amount see {@link getTotalDeposit}.
207
- */
208
- getClaimerBounty(): TokenAmount<SCToken<T["ChainId"]>, true>;
209
- /**
210
- * If the required number of confirmations is not known, this function tries to infer it by looping through
211
- * possible confirmation targets and comparing the claim hashes
212
- *
213
- * @param btcTx Bitcoin transaction
214
- * @param vout Output index of the desired output in the bitcoin transaction
215
- *
216
- * @private
217
- */
218
- private inferRequiredConfirmationsCount;
219
- /**
220
- * @inheritDoc
221
- */
222
- getRequiredConfirmationsCount(): number;
223
- /**
224
- * Checks whether a bitcoin payment was already made, returns the payment or `null` when no payment has been made.
225
- *
226
- * @internal
227
- */
228
- protected getBitcoinPayment(): Promise<{
229
- txId: string;
230
- vout: number;
231
- confirmations: number;
232
- targetConfirmations: number;
233
- inputAddresses?: string[];
234
- } | null>;
235
- /**
236
- * Used to set the txId of the bitcoin payment from the on-chain events listener
237
- *
238
- * @param txId Transaction ID that settled the swap on the smart chain
239
- *
240
- * @internal
241
- */
242
- _setBitcoinTxId(txId: string): Promise<void>;
243
- /**
244
- * @inheritDoc
245
- *
246
- * @throws {Error} if in invalid state (must be {@link FromBTCSwapState.CLAIM_COMMITED})
247
- */
248
- waitForBitcoinTransaction(updateCallback?: (txId?: string, confirmations?: number, targetConfirmations?: number, txEtaMs?: number) => void, checkIntervalSeconds?: number, abortSignal?: AbortSignal): Promise<string>;
249
- /**
250
- * Private getter of the funded PSBT that doesn't check current state
251
- *
252
- * @param _bitcoinWallet Bitcoin wallet to fund the PSBT with
253
- * @param feeRate Optional bitcoin fee rate in sats/vB
254
- * @param additionalOutputs Optional additional outputs that should also be included in the generated PSBT
255
- *
256
- * @private
257
- */
258
- private _getFundedPsbt;
259
- /**
260
- * @inheritDoc
261
- */
262
- getFundedPsbt(_bitcoinWallet: IBitcoinWallet | MinimalBitcoinWalletInterface, feeRate?: number, additionalOutputs?: ({
263
- amount: bigint;
264
- outputScript: Uint8Array;
265
- } | {
266
- amount: bigint;
267
- address: string;
268
- })[]): Promise<{
269
- psbt: Transaction;
270
- psbtHex: string;
271
- psbtBase64: string;
272
- signInputs: number[];
273
- }>;
274
- /**
275
- * @inheritDoc
276
- *
277
- * @throws {Error} if the swap is in invalid state (not in {@link FromBTCSwapState.CLAIM_COMMITED}), or if
278
- * the swap bitcoin address already expired.
279
- */
280
- submitPsbt(_psbt: Transaction | string): Promise<string>;
281
- /**
282
- * @inheritDoc
283
- */
284
- estimateBitcoinFee(_bitcoinWallet: IBitcoinWallet | MinimalBitcoinWalletInterface, feeRate?: number): Promise<TokenAmount<BtcToken<false>, true> | null>;
285
- /**
286
- * @inheritDoc
287
- */
288
- sendBitcoinTransaction(wallet: IBitcoinWallet | MinimalBitcoinWalletInterfaceWithSigner, feeRate?: number): Promise<string>;
289
- /**
290
- * Executes the swap with the provided bitcoin wallet,
291
- *
292
- * @param dstSigner Signer on the destination network, needs to have the same address as the one specified when
293
- * quote was created, this is required for legacy swaps because the destination wallet needs to actively open
294
- * a bitcoin swap address to which the BTC is then sent, this means that the address also needs to have enough
295
- * native tokens to pay for gas on the destination network
296
- * @param wallet Bitcoin wallet to use to sign the bitcoin transaction, can also be null - then the execution waits
297
- * till a transaction is received from an external wallet
298
- * @param callbacks Callbacks to track the progress of the swap
299
- * @param options Optional options for the swap like feeRate, AbortSignal, and timeouts/intervals
300
- *
301
- * @returns {boolean} Whether a swap was settled automatically by swap watchtowers or requires manual claim by the
302
- * user, in case `false` is returned the user should call `swap.claim()` to settle the swap on the destination manually
303
- */
304
- execute(dstSigner: T["Signer"] | T["NativeSigner"], wallet?: IBitcoinWallet | MinimalBitcoinWalletInterfaceWithSigner | null | undefined, callbacks?: {
305
- onDestinationCommitSent?: (destinationCommitTxId: string) => void;
306
- onSourceTransactionSent?: (sourceTxId: string) => void;
307
- onSourceTransactionConfirmationStatus?: (sourceTxId?: string, confirmations?: number, targetConfirations?: number, etaMs?: number) => void;
308
- onSourceTransactionConfirmed?: (sourceTxId: string) => void;
309
- onSwapSettled?: (destinationTxId: string) => void;
310
- }, options?: {
311
- feeRate?: number;
312
- abortSignal?: AbortSignal;
313
- btcTxCheckIntervalSeconds?: number;
314
- maxWaitTillAutomaticSettlementSeconds?: number;
315
- }): Promise<boolean>;
316
- /**
317
- * @inheritDoc
318
- *
319
- * @param options.bitcoinFeeRate Optional fee rate to use for the created Bitcoin transaction
320
- * @param options.bitcoinWallet Bitcoin wallet to use, when provided the function returns a funded
321
- * psbt (`"FUNDED_PSBT"`), if not passed just a bitcoin receive address is returned (`"ADDRESS"`)
322
- * @param options.skipChecks Skip checks like making sure init signature is still valid and swap
323
- * wasn't commited yet (this is handled on swap creation, if you commit right after quoting, you
324
- * can use `skipChecks=true`)
325
- *
326
- * @throws {Error} if the swap or quote is expired, or if triggered in invalid state
327
- */
328
- txsExecute(options?: {
329
- bitcoinFeeRate?: number;
330
- bitcoinWallet?: MinimalBitcoinWalletInterface;
331
- skipChecks?: boolean;
332
- }): Promise<({
333
- name: "Commit";
334
- description: string;
335
- chain: T["ChainId"];
336
- txs: T["TX"][];
337
- } | {
338
- name: "Payment";
339
- description: string;
340
- chain: "BITCOIN";
341
- txs: ({
342
- address: string;
343
- amount: number;
344
- hyperlink: string;
345
- type: "ADDRESS";
346
- } | {
347
- type: "FUNDED_PSBT";
348
- psbt: Transaction;
349
- psbtHex: string;
350
- psbtBase64: string;
351
- signInputs: number[];
352
- address?: undefined;
353
- amount?: undefined;
354
- hyperlink?: undefined;
355
- })[];
356
- })[]>;
357
- /**
358
- * @inheritDoc
359
- *
360
- * @param options.bitcoinFeeRate Optional fee rate to use for the created Bitcoin transaction
361
- * @param options.bitcoinWallet Bitcoin wallet to use, when provided the function returns a funded
362
- * psbt (`"FUNDED_PSBT"`), if not passed just a bitcoin receive address is returned (`"ADDRESS"`)
363
- * @param options.skipChecks Skip checks like making sure init signature is still valid and swap
364
- * wasn't commited yet (this is handled on swap creation, if you commit right after quoting, you
365
- * can use `skipChecks=true`)
366
- * @param options.manualSettlementSmartChainSigner Optional smart chain signer to create a manual claim (settlement) transaction
367
- * @param options.maxWaitTillAutomaticSettlementSeconds Maximum time to wait for an automatic settlement after
368
- * the bitcoin transaction is confirmed (defaults to 60 seconds)
369
- */
370
- getCurrentActions(options?: {
371
- bitcoinFeeRate?: number;
372
- bitcoinWallet?: MinimalBitcoinWalletInterface;
373
- skipChecks?: boolean;
374
- manualSettlementSmartChainSigner?: string | T["Signer"] | T["NativeSigner"];
375
- maxWaitTillAutomaticSettlementSeconds?: number;
376
- }): Promise<SwapExecutionAction<T>[]>;
377
- /**
378
- * @inheritDoc
379
- *
380
- * @throws {Error} If invalid signer is provided that doesn't match the swap data
381
- */
382
- commit(_signer: T["Signer"] | T["NativeSigner"], abortSignal?: AbortSignal, skipChecks?: boolean, onBeforeTxSent?: (txId: string) => void): Promise<string>;
383
- /**
384
- * @inheritDoc
385
- */
386
- waitTillCommited(abortSignal?: AbortSignal): Promise<void>;
387
- /**
388
- * Returns transactions for settling (claiming) the swap if the swap requires manual settlement, you can check so
389
- * with isClaimable. After sending the transaction manually be sure to call the waitTillClaimed function to wait
390
- * till the claim transaction is observed, processed by the SDK and state of the swap properly updated.
391
- *
392
- * @remarks
393
- * Might also return transactions necessary to sync the bitcoin light client.
394
- *
395
- * @param _signer Address of the signer to create the claim transactions for
396
- *
397
- * @throws {Error} If the swap is in invalid state (must be {@link FromBTCSwapState.BTC_TX_CONFIRMED})
398
- */
399
- txsClaim(_signer?: string | T["Signer"] | T["NativeSigner"]): Promise<T["TX"][]>;
400
- /**
401
- * Settles the swap by claiming the funds on the destination chain if the swap requires manual settlement, you can
402
- * check so with isClaimable.
403
- *
404
- * @remarks
405
- * Might also sync the bitcoin light client during the process.
406
- *
407
- * @param _signer Signer to use for signing the settlement transactions, can also be different to the recipient
408
- * @param abortSignal Abort signal
409
- * @param onBeforeTxSent Optional callback triggered before the claim transaction is broadcasted
410
- *
411
- * @returns Transaction ID of the settlement (claim) transaction on the destination smart chain
412
- */
413
- claim(_signer: T["Signer"] | T["NativeSigner"], abortSignal?: AbortSignal, onBeforeTxSent?: (txId: string) => void): Promise<string>;
414
- /**
415
- * @inheritDoc
416
- *
417
- * @throws {Error} If swap is in invalid state (must be {@link FromBTCSwapState.BTC_TX_CONFIRMED})
418
- * @throws {Error} If the LP refunded sooner than we were able to claim
419
- */
420
- waitTillClaimed(maxWaitTimeSeconds?: number, abortSignal?: AbortSignal): Promise<boolean>;
421
- /**
422
- * @inheritDoc
423
- */
424
- serialize(): any;
425
- /**
426
- * Checks the swap's state on-chain and compares it to its internal state, updates/changes it according to on-chain
427
- * data
428
- *
429
- * @private
430
- */
431
- private syncStateFromChain;
432
- /**
433
- * @inheritDoc
434
- * @internal
435
- */
436
- _shouldFetchOnchainState(): boolean;
437
- /**
438
- * @inheritDoc
439
- * @internal
440
- */
441
- _shouldFetchExpiryStatus(): boolean;
442
- /**
443
- * @inheritDoc
444
- * @internal
445
- */
446
- _sync(save?: boolean, quoteDefinitelyExpired?: boolean, commitStatus?: SwapCommitState): Promise<boolean>;
447
- private btcTxLastChecked?;
448
- /**
449
- * @inheritDoc
450
- * @internal
451
- */
452
- _forciblySetOnchainState(status: SwapCommitState): Promise<boolean>;
453
- /**
454
- * @inheritDoc
455
- * @internal
456
- */
457
- _tick(save?: boolean): Promise<boolean>;
458
- }
1
+ import { IFromBTCSelfInitSwap } from "../IFromBTCSelfInitSwap";
2
+ import { SwapType } from "../../../../enums/SwapType";
3
+ import { FromBTCDefinition, FromBTCWrapper } from "./FromBTCWrapper";
4
+ import { ChainType, SwapCommitState, SwapData } from "@atomiqlabs/base";
5
+ import { IBitcoinWallet } from "../../../../bitcoin/wallet/IBitcoinWallet";
6
+ import { IBTCWalletSwap } from "../../../IBTCWalletSwap";
7
+ import { Transaction } from "@scure/btc-signer";
8
+ import { MinimalBitcoinWalletInterface, MinimalBitcoinWalletInterfaceWithSigner } from "../../../../types/wallets/MinimalBitcoinWalletInterface";
9
+ import { IClaimableSwap } from "../../../IClaimableSwap";
10
+ import { IEscrowSelfInitSwapInit } from "../../IEscrowSelfInitSwap";
11
+ import { IAddressSwap } from "../../../IAddressSwap";
12
+ import { TokenAmount } from "../../../../types/TokenAmount";
13
+ import { BtcToken, SCToken } from "../../../../types/Token";
14
+ import { LoggerType } from "../../../../utils/Logger";
15
+ import { SwapExecutionAction } from "../../../../types/SwapExecutionAction";
16
+ /**
17
+ * State enum for legacy escrow based Bitcoin -> Smart chain swaps.
18
+ *
19
+ * @category Swaps/Legacy/Bitcoin → Smart chain
20
+ */
21
+ export declare enum FromBTCSwapState {
22
+ /**
23
+ * Bitcoin swap address has expired and the intermediary (LP) has already refunded
24
+ * its funds. No BTC should be sent anymore!
25
+ */
26
+ FAILED = -4,
27
+ /**
28
+ * Bitcoin swap address has expired, user should not send any BTC anymore! Though
29
+ * the intermediary (LP) hasn't refunded yet. So if there is a transaction already
30
+ * in-flight the swap might still succeed.
31
+ */
32
+ EXPIRED = -3,
33
+ /**
34
+ * Swap has expired for good and there is no way how it can be executed anymore
35
+ */
36
+ QUOTE_EXPIRED = -2,
37
+ /**
38
+ * A swap is almost expired, and it should be presented to the user as expired, though
39
+ * there is still a chance that it will be processed
40
+ */
41
+ QUOTE_SOFT_EXPIRED = -1,
42
+ /**
43
+ * Swap quote was created, use the {@link FromBTCSwap.commit} or {@link FromBTCSwap.txsCommit} functions
44
+ * to initiate it by creating the swap escrow on the destination smart chain
45
+ */
46
+ PR_CREATED = 0,
47
+ /**
48
+ * Swap escrow was initiated (committed) on the destination chain, user can send the BTC to the
49
+ * swap address with the {@link FromBTCSwap.getFundedPsbt}, {@link FromBTCSwap.getAddress} or
50
+ * {@link FromBTCSwap.getHyperlink} functions.
51
+ */
52
+ CLAIM_COMMITED = 1,
53
+ /**
54
+ * Input bitcoin transaction was confirmed, wait for automatic settlement by the watchtowers
55
+ * using the {@link FromBTCSwap.waitTillClaimed} function or settle manually using the {@link FromBTCSwap.claim}
56
+ * or {@link FromBTCSwap.txsClaim} function.
57
+ */
58
+ BTC_TX_CONFIRMED = 2,
59
+ /**
60
+ * Swap successfully settled and funds received on the destination chain
61
+ */
62
+ CLAIM_CLAIMED = 3
63
+ }
64
+ export type FromBTCSwapInit<T extends SwapData> = IEscrowSelfInitSwapInit<T> & {
65
+ data: T;
66
+ address?: string;
67
+ amount?: bigint;
68
+ requiredConfirmations?: number;
69
+ };
70
+ export declare function isFromBTCSwapInit<T extends SwapData>(obj: any): obj is FromBTCSwapInit<T>;
71
+ /**
72
+ * Legacy escrow (PrTLC) based swap for Bitcoin -> Smart chains, requires manual initiation
73
+ * of the swap escrow on the destination chain.
74
+ *
75
+ * @category Swaps/Legacy/Bitcoin → Smart chain
76
+ */
77
+ export declare class FromBTCSwap<T extends ChainType = ChainType> extends IFromBTCSelfInitSwap<T, FromBTCDefinition<T>, FromBTCSwapState> implements IBTCWalletSwap, IClaimableSwap<T, FromBTCDefinition<T>, FromBTCSwapState>, IAddressSwap {
78
+ protected readonly TYPE: SwapType.FROM_BTC;
79
+ /**
80
+ * @internal
81
+ */
82
+ protected readonly swapStateName: (state: number) => string;
83
+ /**
84
+ * @internal
85
+ */
86
+ protected readonly swapStateDescription: {
87
+ [-4]: string;
88
+ [-3]: string;
89
+ [-2]: string;
90
+ [-1]: string;
91
+ 0: string;
92
+ 1: string;
93
+ 2: string;
94
+ 3: string;
95
+ };
96
+ /**
97
+ * @internal
98
+ */
99
+ protected readonly logger: LoggerType;
100
+ /**
101
+ * @internal
102
+ */
103
+ protected readonly inputToken: BtcToken<false>;
104
+ /**
105
+ * @internal
106
+ */
107
+ protected readonly feeRate: string;
108
+ /**
109
+ * @internal
110
+ */
111
+ readonly _data: T["Data"];
112
+ private address?;
113
+ private amount?;
114
+ private requiredConfirmations?;
115
+ private senderAddress?;
116
+ private txId?;
117
+ private vout?;
118
+ private btcTxConfirmedAt?;
119
+ constructor(wrapper: FromBTCWrapper<T>, init: FromBTCSwapInit<T["Data"]>);
120
+ constructor(wrapper: FromBTCWrapper<T>, obj: any);
121
+ /**
122
+ * @inheritDoc
123
+ * @internal
124
+ */
125
+ protected getSwapData(): T["Data"];
126
+ /**
127
+ * @inheritDoc
128
+ * @internal
129
+ */
130
+ protected upgradeVersion(): void;
131
+ /**
132
+ * Returns bitcoin address where the on-chain BTC should be sent to
133
+ */
134
+ getAddress(): string;
135
+ /**
136
+ * Unsafe bitcoin hyperlink getter, returns the address even before the swap is committed!
137
+ *
138
+ * @private
139
+ */
140
+ private _getHyperlink;
141
+ /**
142
+ * @inheritDoc
143
+ */
144
+ getHyperlink(): string;
145
+ /**
146
+ * @inheritDoc
147
+ */
148
+ getInputAddress(): string | null;
149
+ /**
150
+ * @inheritDoc
151
+ */
152
+ getInputTxId(): string | null;
153
+ /**
154
+ * Returns timeout time (in UNIX milliseconds) when the on-chain address will expire and no funds should be sent
155
+ * to that address anymore
156
+ */
157
+ getTimeoutTime(): number;
158
+ /**
159
+ * @inheritDoc
160
+ */
161
+ requiresAction(): boolean;
162
+ /**
163
+ * @inheritDoc
164
+ */
165
+ isFinished(): boolean;
166
+ /**
167
+ * @inheritDoc
168
+ */
169
+ isClaimable(): boolean;
170
+ /**
171
+ * @inheritDoc
172
+ */
173
+ isSuccessful(): boolean;
174
+ /**
175
+ * @inheritDoc
176
+ */
177
+ isFailed(): boolean;
178
+ /**
179
+ * @inheritDoc
180
+ */
181
+ isInProgress(): boolean;
182
+ /**
183
+ * @inheritDoc
184
+ */
185
+ isQuoteExpired(): boolean;
186
+ /**
187
+ * @inheritDoc
188
+ */
189
+ isQuoteSoftExpired(): boolean;
190
+ /**
191
+ * @inheritDoc
192
+ * @internal
193
+ */
194
+ protected canCommit(skipQuoteExpiryChecks?: boolean): boolean;
195
+ /**
196
+ * @inheritDoc
197
+ */
198
+ getInputToken(): BtcToken<false>;
199
+ /**
200
+ * @inheritDoc
201
+ */
202
+ getInput(): TokenAmount<BtcToken<false>>;
203
+ /**
204
+ * Returns claimer bounty, acting as a reward for watchtowers to claim the swap automatically,
205
+ * this amount is pre-funded by the user on the destination chain when the swap escrow
206
+ * is initiated. For total pre-funded deposit amount see {@link getTotalDeposit}.
207
+ */
208
+ getClaimerBounty(): TokenAmount<SCToken<T["ChainId"]>, true>;
209
+ /**
210
+ * If the required number of confirmations is not known, this function tries to infer it by looping through
211
+ * possible confirmation targets and comparing the claim hashes
212
+ *
213
+ * @param btcTx Bitcoin transaction
214
+ * @param vout Output index of the desired output in the bitcoin transaction
215
+ *
216
+ * @private
217
+ */
218
+ private inferRequiredConfirmationsCount;
219
+ /**
220
+ * @inheritDoc
221
+ */
222
+ getRequiredConfirmationsCount(): number;
223
+ /**
224
+ * Checks whether a bitcoin payment was already made, returns the payment or `null` when no payment has been made.
225
+ *
226
+ * @internal
227
+ */
228
+ protected getBitcoinPayment(): Promise<{
229
+ txId: string;
230
+ vout: number;
231
+ confirmations: number;
232
+ targetConfirmations: number;
233
+ inputAddresses?: string[];
234
+ } | null>;
235
+ /**
236
+ * Used to set the txId of the bitcoin payment from the on-chain events listener
237
+ *
238
+ * @param txId Transaction ID that settled the swap on the smart chain
239
+ *
240
+ * @internal
241
+ */
242
+ _setBitcoinTxId(txId: string): Promise<void>;
243
+ /**
244
+ * @inheritDoc
245
+ *
246
+ * @throws {Error} if in invalid state (must be {@link FromBTCSwapState.CLAIM_COMMITED})
247
+ */
248
+ waitForBitcoinTransaction(updateCallback?: (txId?: string, confirmations?: number, targetConfirmations?: number, txEtaMs?: number) => void, checkIntervalSeconds?: number, abortSignal?: AbortSignal): Promise<string>;
249
+ /**
250
+ * Private getter of the funded PSBT that doesn't check current state
251
+ *
252
+ * @param _bitcoinWallet Bitcoin wallet to fund the PSBT with
253
+ * @param feeRate Optional bitcoin fee rate in sats/vB
254
+ * @param additionalOutputs Optional additional outputs that should also be included in the generated PSBT
255
+ *
256
+ * @private
257
+ */
258
+ private _getFundedPsbt;
259
+ /**
260
+ * @inheritDoc
261
+ */
262
+ getFundedPsbt(_bitcoinWallet: IBitcoinWallet | MinimalBitcoinWalletInterface, feeRate?: number, additionalOutputs?: ({
263
+ amount: bigint;
264
+ outputScript: Uint8Array;
265
+ } | {
266
+ amount: bigint;
267
+ address: string;
268
+ })[]): Promise<{
269
+ psbt: Transaction;
270
+ psbtHex: string;
271
+ psbtBase64: string;
272
+ signInputs: number[];
273
+ }>;
274
+ /**
275
+ * @inheritDoc
276
+ *
277
+ * @throws {Error} if the swap is in invalid state (not in {@link FromBTCSwapState.CLAIM_COMMITED}), or if
278
+ * the swap bitcoin address already expired.
279
+ */
280
+ submitPsbt(_psbt: Transaction | string): Promise<string>;
281
+ /**
282
+ * @inheritDoc
283
+ */
284
+ estimateBitcoinFee(_bitcoinWallet: IBitcoinWallet | MinimalBitcoinWalletInterface, feeRate?: number): Promise<TokenAmount<BtcToken<false>, true> | null>;
285
+ /**
286
+ * @inheritDoc
287
+ */
288
+ sendBitcoinTransaction(wallet: IBitcoinWallet | MinimalBitcoinWalletInterfaceWithSigner, feeRate?: number): Promise<string>;
289
+ /**
290
+ * Executes the swap with the provided bitcoin wallet,
291
+ *
292
+ * @param dstSigner Signer on the destination network, needs to have the same address as the one specified when
293
+ * quote was created, this is required for legacy swaps because the destination wallet needs to actively open
294
+ * a bitcoin swap address to which the BTC is then sent, this means that the address also needs to have enough
295
+ * native tokens to pay for gas on the destination network
296
+ * @param wallet Bitcoin wallet to use to sign the bitcoin transaction, can also be null - then the execution waits
297
+ * till a transaction is received from an external wallet
298
+ * @param callbacks Callbacks to track the progress of the swap
299
+ * @param options Optional options for the swap like feeRate, AbortSignal, and timeouts/intervals
300
+ *
301
+ * @returns {boolean} Whether a swap was settled automatically by swap watchtowers or requires manual claim by the
302
+ * user, in case `false` is returned the user should call `swap.claim()` to settle the swap on the destination manually
303
+ */
304
+ execute(dstSigner: T["Signer"] | T["NativeSigner"], wallet?: IBitcoinWallet | MinimalBitcoinWalletInterfaceWithSigner | null | undefined, callbacks?: {
305
+ onDestinationCommitSent?: (destinationCommitTxId: string) => void;
306
+ onSourceTransactionSent?: (sourceTxId: string) => void;
307
+ onSourceTransactionConfirmationStatus?: (sourceTxId?: string, confirmations?: number, targetConfirations?: number, etaMs?: number) => void;
308
+ onSourceTransactionConfirmed?: (sourceTxId: string) => void;
309
+ onSwapSettled?: (destinationTxId: string) => void;
310
+ }, options?: {
311
+ feeRate?: number;
312
+ abortSignal?: AbortSignal;
313
+ btcTxCheckIntervalSeconds?: number;
314
+ maxWaitTillAutomaticSettlementSeconds?: number;
315
+ }): Promise<boolean>;
316
+ /**
317
+ * @inheritDoc
318
+ *
319
+ * @param options.bitcoinFeeRate Optional fee rate to use for the created Bitcoin transaction
320
+ * @param options.bitcoinWallet Bitcoin wallet to use, when provided the function returns a funded
321
+ * psbt (`"FUNDED_PSBT"`), if not passed just a bitcoin receive address is returned (`"ADDRESS"`)
322
+ * @param options.skipChecks Skip checks like making sure init signature is still valid and swap
323
+ * wasn't commited yet (this is handled on swap creation, if you commit right after quoting, you
324
+ * can use `skipChecks=true`)
325
+ *
326
+ * @throws {Error} if the swap or quote is expired, or if triggered in invalid state
327
+ */
328
+ txsExecute(options?: {
329
+ bitcoinFeeRate?: number;
330
+ bitcoinWallet?: MinimalBitcoinWalletInterface;
331
+ skipChecks?: boolean;
332
+ }): Promise<({
333
+ name: "Commit";
334
+ description: string;
335
+ chain: T["ChainId"];
336
+ txs: T["TX"][];
337
+ } | {
338
+ name: "Payment";
339
+ description: string;
340
+ chain: "BITCOIN";
341
+ txs: ({
342
+ address: string;
343
+ amount: number;
344
+ hyperlink: string;
345
+ type: "ADDRESS";
346
+ } | {
347
+ type: "FUNDED_PSBT";
348
+ psbt: Transaction;
349
+ psbtHex: string;
350
+ psbtBase64: string;
351
+ signInputs: number[];
352
+ address?: undefined;
353
+ amount?: undefined;
354
+ hyperlink?: undefined;
355
+ })[];
356
+ })[]>;
357
+ /**
358
+ * @inheritDoc
359
+ *
360
+ * @param options.bitcoinFeeRate Optional fee rate to use for the created Bitcoin transaction
361
+ * @param options.bitcoinWallet Bitcoin wallet to use, when provided the function returns a funded
362
+ * psbt (`"FUNDED_PSBT"`), if not passed just a bitcoin receive address is returned (`"ADDRESS"`)
363
+ * @param options.skipChecks Skip checks like making sure init signature is still valid and swap
364
+ * wasn't commited yet (this is handled on swap creation, if you commit right after quoting, you
365
+ * can use `skipChecks=true`)
366
+ * @param options.manualSettlementSmartChainSigner Optional smart chain signer to create a manual claim (settlement) transaction
367
+ * @param options.maxWaitTillAutomaticSettlementSeconds Maximum time to wait for an automatic settlement after
368
+ * the bitcoin transaction is confirmed (defaults to 60 seconds)
369
+ */
370
+ getCurrentActions(options?: {
371
+ bitcoinFeeRate?: number;
372
+ bitcoinWallet?: MinimalBitcoinWalletInterface;
373
+ skipChecks?: boolean;
374
+ manualSettlementSmartChainSigner?: string | T["Signer"] | T["NativeSigner"];
375
+ maxWaitTillAutomaticSettlementSeconds?: number;
376
+ }): Promise<SwapExecutionAction<T>[]>;
377
+ /**
378
+ * @inheritDoc
379
+ *
380
+ * @throws {Error} If invalid signer is provided that doesn't match the swap data
381
+ */
382
+ commit(_signer: T["Signer"] | T["NativeSigner"], abortSignal?: AbortSignal, skipChecks?: boolean, onBeforeTxSent?: (txId: string) => void): Promise<string>;
383
+ /**
384
+ * @inheritDoc
385
+ */
386
+ waitTillCommited(abortSignal?: AbortSignal): Promise<void>;
387
+ /**
388
+ * Returns transactions for settling (claiming) the swap if the swap requires manual settlement, you can check so
389
+ * with isClaimable. After sending the transaction manually be sure to call the waitTillClaimed function to wait
390
+ * till the claim transaction is observed, processed by the SDK and state of the swap properly updated.
391
+ *
392
+ * @remarks
393
+ * Might also return transactions necessary to sync the bitcoin light client.
394
+ *
395
+ * @param _signer Address of the signer to create the claim transactions for
396
+ *
397
+ * @throws {Error} If the swap is in invalid state (must be {@link FromBTCSwapState.BTC_TX_CONFIRMED})
398
+ */
399
+ txsClaim(_signer?: string | T["Signer"] | T["NativeSigner"]): Promise<T["TX"][]>;
400
+ /**
401
+ * Settles the swap by claiming the funds on the destination chain if the swap requires manual settlement, you can
402
+ * check so with isClaimable.
403
+ *
404
+ * @remarks
405
+ * Might also sync the bitcoin light client during the process.
406
+ *
407
+ * @param _signer Signer to use for signing the settlement transactions, can also be different to the recipient
408
+ * @param abortSignal Abort signal
409
+ * @param onBeforeTxSent Optional callback triggered before the claim transaction is broadcasted
410
+ *
411
+ * @returns Transaction ID of the settlement (claim) transaction on the destination smart chain
412
+ */
413
+ claim(_signer: T["Signer"] | T["NativeSigner"], abortSignal?: AbortSignal, onBeforeTxSent?: (txId: string) => void): Promise<string>;
414
+ /**
415
+ * @inheritDoc
416
+ *
417
+ * @throws {Error} If swap is in invalid state (must be {@link FromBTCSwapState.BTC_TX_CONFIRMED})
418
+ * @throws {Error} If the LP refunded sooner than we were able to claim
419
+ */
420
+ waitTillClaimed(maxWaitTimeSeconds?: number, abortSignal?: AbortSignal): Promise<boolean>;
421
+ /**
422
+ * @inheritDoc
423
+ */
424
+ serialize(): any;
425
+ /**
426
+ * Checks the swap's state on-chain and compares it to its internal state, updates/changes it according to on-chain
427
+ * data
428
+ *
429
+ * @private
430
+ */
431
+ private syncStateFromChain;
432
+ /**
433
+ * @inheritDoc
434
+ * @internal
435
+ */
436
+ _shouldFetchOnchainState(): boolean;
437
+ /**
438
+ * @inheritDoc
439
+ * @internal
440
+ */
441
+ _shouldFetchExpiryStatus(): boolean;
442
+ /**
443
+ * @inheritDoc
444
+ * @internal
445
+ */
446
+ _sync(save?: boolean, quoteDefinitelyExpired?: boolean, commitStatus?: SwapCommitState): Promise<boolean>;
447
+ private btcTxLastChecked?;
448
+ /**
449
+ * @inheritDoc
450
+ * @internal
451
+ */
452
+ _forciblySetOnchainState(status: SwapCommitState): Promise<boolean>;
453
+ /**
454
+ * @inheritDoc
455
+ * @internal
456
+ */
457
+ _tick(save?: boolean): Promise<boolean>;
458
+ }