@atomiqlabs/sdk 8.6.6 → 8.6.8

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 (226) hide show
  1. package/dist/SmartChainAssets.d.ts +181 -181
  2. package/dist/SmartChainAssets.js +181 -181
  3. package/dist/bitcoin/coinselect2/accumulative.d.ts +6 -6
  4. package/dist/bitcoin/coinselect2/accumulative.js +52 -51
  5. package/dist/bitcoin/coinselect2/blackjack.d.ts +6 -6
  6. package/dist/bitcoin/coinselect2/blackjack.js +38 -37
  7. package/dist/bitcoin/coinselect2/index.d.ts +19 -17
  8. package/dist/bitcoin/coinselect2/index.js +69 -69
  9. package/dist/bitcoin/coinselect2/utils.d.ts +77 -75
  10. package/dist/bitcoin/coinselect2/utils.js +123 -123
  11. package/dist/bitcoin/wallet/BitcoinWallet.d.ts +130 -128
  12. package/dist/bitcoin/wallet/BitcoinWallet.js +322 -322
  13. package/dist/bitcoin/wallet/IBitcoinWallet.d.ts +78 -78
  14. package/dist/bitcoin/wallet/IBitcoinWallet.js +21 -20
  15. package/dist/bitcoin/wallet/SingleAddressBitcoinWallet.d.ts +101 -99
  16. package/dist/bitcoin/wallet/SingleAddressBitcoinWallet.js +190 -176
  17. package/dist/enums/FeeType.d.ts +15 -15
  18. package/dist/enums/FeeType.js +19 -19
  19. package/dist/enums/SwapAmountType.d.ts +15 -15
  20. package/dist/enums/SwapAmountType.js +19 -19
  21. package/dist/enums/SwapDirection.d.ts +15 -15
  22. package/dist/enums/SwapDirection.js +19 -19
  23. package/dist/enums/SwapSide.d.ts +15 -15
  24. package/dist/enums/SwapSide.js +19 -19
  25. package/dist/enums/SwapType.d.ts +75 -75
  26. package/dist/enums/SwapType.js +79 -79
  27. package/dist/errors/IntermediaryError.d.ts +13 -13
  28. package/dist/errors/IntermediaryError.js +27 -27
  29. package/dist/errors/RequestError.d.ts +32 -32
  30. package/dist/errors/RequestError.js +54 -54
  31. package/dist/errors/UserError.d.ts +8 -8
  32. package/dist/errors/UserError.js +16 -16
  33. package/dist/events/UnifiedSwapEventListener.d.ts +23 -23
  34. package/dist/events/UnifiedSwapEventListener.js +130 -130
  35. package/dist/http/HttpUtils.d.ts +27 -27
  36. package/dist/http/HttpUtils.js +91 -90
  37. package/dist/http/paramcoders/IParamReader.d.ts +8 -8
  38. package/dist/http/paramcoders/IParamReader.js +2 -2
  39. package/dist/http/paramcoders/ParamDecoder.d.ts +44 -42
  40. package/dist/http/paramcoders/ParamDecoder.js +137 -137
  41. package/dist/http/paramcoders/ParamEncoder.d.ts +20 -18
  42. package/dist/http/paramcoders/ParamEncoder.js +36 -36
  43. package/dist/http/paramcoders/SchemaVerifier.d.ts +26 -26
  44. package/dist/http/paramcoders/SchemaVerifier.js +145 -145
  45. package/dist/http/paramcoders/client/ResponseParamDecoder.d.ts +11 -11
  46. package/dist/http/paramcoders/client/ResponseParamDecoder.js +57 -57
  47. package/dist/http/paramcoders/client/StreamParamEncoder.d.ts +13 -11
  48. package/dist/http/paramcoders/client/StreamParamEncoder.js +26 -26
  49. package/dist/http/paramcoders/client/StreamingFetchPromise.d.ts +16 -16
  50. package/dist/http/paramcoders/client/StreamingFetchPromise.js +174 -173
  51. package/dist/index.d.ts +85 -85
  52. package/dist/index.js +158 -158
  53. package/dist/intermediaries/Intermediary.d.ts +157 -157
  54. package/dist/intermediaries/Intermediary.js +142 -142
  55. package/dist/intermediaries/IntermediaryDiscovery.d.ts +199 -198
  56. package/dist/intermediaries/IntermediaryDiscovery.js +406 -406
  57. package/dist/intermediaries/apis/IntermediaryAPI.d.ts +439 -437
  58. package/dist/intermediaries/apis/IntermediaryAPI.js +603 -603
  59. package/dist/intermediaries/apis/TrustedIntermediaryAPI.d.ts +155 -155
  60. package/dist/intermediaries/apis/TrustedIntermediaryAPI.js +137 -137
  61. package/dist/lnurl/LNURL.d.ts +102 -102
  62. package/dist/lnurl/LNURL.js +321 -321
  63. package/dist/prices/RedundantSwapPrice.d.ts +110 -110
  64. package/dist/prices/RedundantSwapPrice.js +222 -222
  65. package/dist/prices/SingleSwapPrice.d.ts +34 -34
  66. package/dist/prices/SingleSwapPrice.js +44 -44
  67. package/dist/prices/SwapPriceWithChain.d.ts +107 -107
  68. package/dist/prices/SwapPriceWithChain.js +128 -128
  69. package/dist/prices/abstract/ICachedSwapPrice.d.ts +28 -28
  70. package/dist/prices/abstract/ICachedSwapPrice.js +62 -62
  71. package/dist/prices/abstract/IPriceProvider.d.ts +81 -81
  72. package/dist/prices/abstract/IPriceProvider.js +74 -74
  73. package/dist/prices/abstract/ISwapPrice.d.ts +168 -168
  74. package/dist/prices/abstract/ISwapPrice.js +279 -279
  75. package/dist/prices/providers/BinancePriceProvider.d.ts +23 -23
  76. package/dist/prices/providers/BinancePriceProvider.js +30 -30
  77. package/dist/prices/providers/CoinGeckoPriceProvider.d.ts +23 -23
  78. package/dist/prices/providers/CoinGeckoPriceProvider.js +29 -29
  79. package/dist/prices/providers/CoinPaprikaPriceProvider.d.ts +25 -25
  80. package/dist/prices/providers/CoinPaprikaPriceProvider.js +29 -29
  81. package/dist/prices/providers/CustomPriceProvider.d.ts +24 -24
  82. package/dist/prices/providers/CustomPriceProvider.js +35 -35
  83. package/dist/prices/providers/KrakenPriceProvider.d.ts +38 -38
  84. package/dist/prices/providers/KrakenPriceProvider.js +45 -45
  85. package/dist/prices/providers/OKXPriceProvider.d.ts +34 -34
  86. package/dist/prices/providers/OKXPriceProvider.js +29 -29
  87. package/dist/prices/providers/abstract/ExchangePriceProvider.d.ts +17 -17
  88. package/dist/prices/providers/abstract/ExchangePriceProvider.js +21 -21
  89. package/dist/prices/providers/abstract/HttpPriceProvider.d.ts +7 -7
  90. package/dist/prices/providers/abstract/HttpPriceProvider.js +12 -12
  91. package/dist/storage/IUnifiedStorage.d.ts +85 -85
  92. package/dist/storage/IUnifiedStorage.js +2 -2
  93. package/dist/storage/UnifiedSwapStorage.d.ts +114 -114
  94. package/dist/storage/UnifiedSwapStorage.js +116 -116
  95. package/dist/storage-browser/IndexedDBUnifiedStorage.d.ts +63 -63
  96. package/dist/storage-browser/IndexedDBUnifiedStorage.js +298 -298
  97. package/dist/storage-browser/LocalStorageManager.d.ts +49 -49
  98. package/dist/storage-browser/LocalStorageManager.js +93 -93
  99. package/dist/swapper/Swapper.d.ts +687 -686
  100. package/dist/swapper/Swapper.js +1603 -1603
  101. package/dist/swapper/SwapperFactory.d.ts +135 -135
  102. package/dist/swapper/SwapperFactory.js +162 -162
  103. package/dist/swapper/SwapperUtils.d.ts +200 -200
  104. package/dist/swapper/SwapperUtils.js +467 -467
  105. package/dist/swapper/SwapperWithChain.d.ts +404 -404
  106. package/dist/swapper/SwapperWithChain.js +469 -469
  107. package/dist/swapper/SwapperWithSigner.d.ts +322 -322
  108. package/dist/swapper/SwapperWithSigner.js +318 -318
  109. package/dist/swaps/IAddressSwap.d.ts +22 -22
  110. package/dist/swaps/IAddressSwap.js +14 -13
  111. package/dist/swaps/IBTCWalletSwap.d.ts +73 -73
  112. package/dist/swaps/IBTCWalletSwap.js +18 -17
  113. package/dist/swaps/IClaimableSwap.d.ts +49 -49
  114. package/dist/swaps/IClaimableSwap.js +15 -14
  115. package/dist/swaps/IClaimableSwapWrapper.d.ts +15 -15
  116. package/dist/swaps/IClaimableSwapWrapper.js +2 -2
  117. package/dist/swaps/IRefundableSwap.d.ts +43 -43
  118. package/dist/swaps/IRefundableSwap.js +14 -13
  119. package/dist/swaps/ISwap.d.ts +387 -386
  120. package/dist/swaps/ISwap.js +346 -346
  121. package/dist/swaps/ISwapWithGasDrop.d.ts +21 -21
  122. package/dist/swaps/ISwapWithGasDrop.js +12 -11
  123. package/dist/swaps/ISwapWrapper.d.ts +285 -283
  124. package/dist/swaps/ISwapWrapper.js +353 -353
  125. package/dist/swaps/escrow_swaps/IEscrowSelfInitSwap.d.ts +98 -98
  126. package/dist/swaps/escrow_swaps/IEscrowSelfInitSwap.js +126 -126
  127. package/dist/swaps/escrow_swaps/IEscrowSwap.d.ts +135 -133
  128. package/dist/swaps/escrow_swaps/IEscrowSwap.js +169 -169
  129. package/dist/swaps/escrow_swaps/IEscrowSwapWrapper.d.ts +115 -114
  130. package/dist/swaps/escrow_swaps/IEscrowSwapWrapper.js +134 -134
  131. package/dist/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.d.ts +101 -98
  132. package/dist/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.js +130 -130
  133. package/dist/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.d.ts +162 -162
  134. package/dist/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.js +190 -190
  135. package/dist/swaps/escrow_swaps/frombtc/IFromBTCWrapper.d.ts +58 -58
  136. package/dist/swaps/escrow_swaps/frombtc/IFromBTCWrapper.js +78 -78
  137. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.d.ts +531 -529
  138. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.js +1285 -1285
  139. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.d.ts +184 -181
  140. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.js +418 -418
  141. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.d.ts +583 -581
  142. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.js +1371 -1371
  143. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.d.ts +228 -225
  144. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.js +506 -506
  145. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.d.ts +458 -458
  146. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.js +1126 -1126
  147. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.d.ts +191 -190
  148. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.js +378 -378
  149. package/dist/swaps/escrow_swaps/tobtc/IToBTCSwap.d.ts +403 -403
  150. package/dist/swaps/escrow_swaps/tobtc/IToBTCSwap.js +924 -924
  151. package/dist/swaps/escrow_swaps/tobtc/IToBTCWrapper.d.ts +62 -62
  152. package/dist/swaps/escrow_swaps/tobtc/IToBTCWrapper.js +112 -112
  153. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.d.ts +127 -125
  154. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.js +256 -256
  155. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.d.ts +242 -241
  156. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.js +520 -520
  157. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.d.ts +73 -73
  158. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.js +155 -155
  159. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.d.ts +128 -127
  160. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.js +278 -278
  161. package/dist/swaps/spv_swaps/SpvFromBTCSwap.d.ts +630 -630
  162. package/dist/swaps/spv_swaps/SpvFromBTCSwap.js +1443 -1443
  163. package/dist/swaps/spv_swaps/SpvFromBTCWrapper.d.ts +214 -213
  164. package/dist/swaps/spv_swaps/SpvFromBTCWrapper.js +756 -756
  165. package/dist/swaps/trusted/ln/LnForGasSwap.d.ts +261 -261
  166. package/dist/swaps/trusted/ln/LnForGasSwap.js +511 -511
  167. package/dist/swaps/trusted/ln/LnForGasWrapper.d.ts +40 -40
  168. package/dist/swaps/trusted/ln/LnForGasWrapper.js +82 -82
  169. package/dist/swaps/trusted/onchain/OnchainForGasSwap.d.ts +342 -342
  170. package/dist/swaps/trusted/onchain/OnchainForGasSwap.js +715 -715
  171. package/dist/swaps/trusted/onchain/OnchainForGasWrapper.d.ts +69 -68
  172. package/dist/swaps/trusted/onchain/OnchainForGasWrapper.js +92 -92
  173. package/dist/types/AmountData.d.ts +10 -10
  174. package/dist/types/AmountData.js +2 -2
  175. package/dist/types/CustomPriceFunction.d.ts +11 -11
  176. package/dist/types/CustomPriceFunction.js +2 -2
  177. package/dist/types/PriceInfoType.d.ts +28 -28
  178. package/dist/types/PriceInfoType.js +57 -56
  179. package/dist/types/SwapExecutionAction.d.ts +88 -88
  180. package/dist/types/SwapExecutionAction.js +2 -2
  181. package/dist/types/SwapStateInfo.d.ts +5 -5
  182. package/dist/types/SwapStateInfo.js +2 -2
  183. package/dist/types/SwapWithSigner.d.ts +17 -17
  184. package/dist/types/SwapWithSigner.js +43 -42
  185. package/dist/types/Token.d.ts +99 -99
  186. package/dist/types/Token.js +76 -76
  187. package/dist/types/TokenAmount.d.ts +69 -69
  188. package/dist/types/TokenAmount.js +60 -59
  189. package/dist/types/fees/Fee.d.ts +50 -50
  190. package/dist/types/fees/Fee.js +2 -2
  191. package/dist/types/fees/FeeBreakdown.d.ts +11 -11
  192. package/dist/types/fees/FeeBreakdown.js +2 -2
  193. package/dist/types/fees/PercentagePPM.d.ts +17 -17
  194. package/dist/types/fees/PercentagePPM.js +18 -17
  195. package/dist/types/lnurl/LNURLPay.d.ts +61 -61
  196. package/dist/types/lnurl/LNURLPay.js +31 -30
  197. package/dist/types/lnurl/LNURLWithdraw.d.ts +48 -48
  198. package/dist/types/lnurl/LNURLWithdraw.js +27 -26
  199. package/dist/types/wallets/LightningInvoiceCreateService.d.ts +24 -24
  200. package/dist/types/wallets/LightningInvoiceCreateService.js +15 -14
  201. package/dist/types/wallets/MinimalBitcoinWalletInterface.d.ts +23 -23
  202. package/dist/types/wallets/MinimalBitcoinWalletInterface.js +2 -2
  203. package/dist/types/wallets/MinimalLightningNetworkWalletInterface.d.ts +9 -9
  204. package/dist/types/wallets/MinimalLightningNetworkWalletInterface.js +2 -2
  205. package/dist/utils/AutomaticClockDriftCorrection.d.ts +1 -1
  206. package/dist/utils/AutomaticClockDriftCorrection.js +70 -69
  207. package/dist/utils/BitcoinUtils.d.ts +14 -12
  208. package/dist/utils/BitcoinUtils.js +102 -101
  209. package/dist/utils/BitcoinWalletUtils.d.ts +7 -7
  210. package/dist/utils/BitcoinWalletUtils.js +14 -13
  211. package/dist/utils/Logger.d.ts +7 -7
  212. package/dist/utils/Logger.js +12 -11
  213. package/dist/utils/RetryUtils.d.ts +22 -22
  214. package/dist/utils/RetryUtils.js +67 -66
  215. package/dist/utils/SwapUtils.d.ts +88 -88
  216. package/dist/utils/SwapUtils.js +72 -72
  217. package/dist/utils/TimeoutUtils.d.ts +17 -17
  218. package/dist/utils/TimeoutUtils.js +55 -54
  219. package/dist/utils/TokenUtils.d.ts +19 -19
  220. package/dist/utils/TokenUtils.js +37 -36
  221. package/dist/utils/TypeUtils.d.ts +7 -7
  222. package/dist/utils/TypeUtils.js +2 -2
  223. package/dist/utils/Utils.d.ts +58 -56
  224. package/dist/utils/Utils.js +194 -193
  225. package/package.json +1 -1
  226. package/src/bitcoin/wallet/SingleAddressBitcoinWallet.ts +14 -2
@@ -1,322 +1,322 @@
1
- import { IntermediaryDiscovery } from "../intermediaries/IntermediaryDiscovery";
2
- import { SwapType } from "../enums/SwapType";
3
- import { LnForGasSwap } from "../swaps/trusted/ln/LnForGasSwap";
4
- import { ISwap } from "../swaps/ISwap";
5
- import { IToBTCSwap } from "../swaps/escrow_swaps/tobtc/IToBTCSwap";
6
- import { ChainIds, MultiChain, SupportsSwapType } from "./Swapper";
7
- import { FromBTCLNSwap } from "../swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap";
8
- import { FromBTCSwap } from "../swaps/escrow_swaps/frombtc/onchain/FromBTCSwap";
9
- import { ToBTCLNSwap } from "../swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap";
10
- import { ToBTCSwap } from "../swaps/escrow_swaps/tobtc/onchain/ToBTCSwap";
11
- import { SwapPriceWithChain } from "../prices/SwapPriceWithChain";
12
- import { ToBTCOptions } from "../swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper";
13
- import { ToBTCLNOptions } from "../swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper";
14
- import { FromBTCOptions } from "../swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper";
15
- import { FromBTCLNOptions } from "../swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper";
16
- import { SwapperUtils } from "./SwapperUtils";
17
- import { SpvFromBTCSwap } from "../swaps/spv_swaps/SpvFromBTCSwap";
18
- import { SwapperWithChain } from "./SwapperWithChain";
19
- import { SwapWithSigner } from "../types/SwapWithSigner";
20
- import { OnchainForGasSwap } from "../swaps/trusted/onchain/OnchainForGasSwap";
21
- import { FromBTCLNAutoSwap } from "../swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap";
22
- import { FromBTCLNAutoOptions } from "../swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper";
23
- import { TokenAmount } from "../types/TokenAmount";
24
- import { BtcToken, SCToken, Token } from "../types/Token";
25
- import { LNURLWithdraw } from "../types/lnurl/LNURLWithdraw";
26
- import { LNURLPay } from "../types/lnurl/LNURLPay";
27
- import { LightningInvoiceCreateService } from "../types/wallets/LightningInvoiceCreateService";
28
- import { Intermediary } from "../intermediaries/Intermediary";
29
- import { SpvFromBTCOptions } from "../swaps/spv_swaps/SpvFromBTCWrapper";
30
- import { SwapTypeMapping } from "../utils/SwapUtils";
31
- import { SwapSide } from "../enums/SwapSide";
32
- /**
33
- * Chain and signer-specific wrapper for automatic signer injection into swap methods
34
- * @category Core
35
- */
36
- export declare class SwapperWithSigner<T extends MultiChain, ChainIdentifier extends ChainIds<T>> {
37
- private readonly signer;
38
- /**
39
- * Underlying single chain swapper instance
40
- */
41
- private readonly swapper;
42
- /**
43
- * Smart chain identifier of this swapper with chain and signer
44
- */
45
- readonly chainIdentifier: ChainIdentifier;
46
- /**
47
- * Pricing API used by the SDK
48
- */
49
- get prices(): SwapPriceWithChain<T, ChainIdentifier>;
50
- /**
51
- * Intermediary discovery instance
52
- */
53
- get intermediaryDiscovery(): IntermediaryDiscovery;
54
- /**
55
- * Miscellaneous utility functions
56
- */
57
- get Utils(): SwapperUtils<T>;
58
- /**
59
- * Helper information about various swap protocol and their features:
60
- * - `requiresInputWallet`: Whether a swap requires a connected wallet on the input chain able to sign
61
- * arbitrary transaction
62
- * - `requiresOutputWallet`: Whether a swap requires a connected wallet on the output chain able to sign
63
- * arbitrary transactions
64
- * - `supportsGasDrop`: Whether a swap supports the "gas drop" feature, allowing to user to receive a small
65
- * amount of native token as part of the swap when swapping to smart chains
66
- *
67
- * Uses a `Record` type here, use the {@link SwapProtocolInfo} import for a literal readonly type, with
68
- * pre-filled exact values in the type.
69
- */
70
- get SwapTypeInfo(): Record<SwapType, {
71
- requiresInputWallet: boolean;
72
- requiresOutputWallet: boolean;
73
- supportsGasDrop: boolean;
74
- }>;
75
- constructor(swapper: SwapperWithChain<T, ChainIdentifier>, signer: T[ChainIdentifier]["Signer"]);
76
- /**
77
- * Creates Smart chain -> Bitcoin ({@link SwapType.TO_BTC}) swap
78
- *
79
- * @param tokenAddress Token address to pay with
80
- * @param address Recipient's bitcoin address
81
- * @param amount Amount to send in token based units (if `exactIn=true`) or receive in satoshis (if `exactIn=false`)
82
- * @param exactIn Whether to use exact in instead of exact out
83
- * @param additionalParams Additional parameters sent to the LP when creating the swap
84
- * @param options Additional options for the swap
85
- */
86
- createToBTCSwap(tokenAddress: string, address: string, amount: bigint, exactIn?: boolean, additionalParams?: Record<string, any>, options?: ToBTCOptions): Promise<SwapWithSigner<ToBTCSwap<T[ChainIdentifier]>>>;
87
- /**
88
- * Creates Smart chain -> Bitcoin Lightning ({@link SwapType.TO_BTCLN}) swap
89
- *
90
- * @param tokenAddress Token address to pay with
91
- * @param paymentRequest BOLT11 lightning network invoice to be paid (needs to have a fixed amount), and the swap
92
- * amount is taken from this fixed amount, hence only exact output swaps are supported
93
- * @param additionalParams Additional parameters sent to the LP when creating the swap
94
- * @param options Additional options for the swap
95
- */
96
- createToBTCLNSwap(tokenAddress: string, paymentRequest: string, additionalParams?: Record<string, any>, options?: ToBTCLNOptions & {
97
- comment?: string;
98
- }): Promise<SwapWithSigner<ToBTCLNSwap<T[ChainIdentifier]>>>;
99
- /**
100
- * Creates Smart chain -> Bitcoin Lightning ({@link SwapType.TO_BTCLN}) swap via LNURL-pay link
101
- *
102
- * @param tokenAddress Token address to pay with
103
- * @param lnurlPay LNURL-pay link to use for the payment
104
- * @param amount Amount to send in token based units (if `exactIn=true`) or receive in satoshis (if `exactIn=false`)
105
- * @param exactIn Whether to do an exact in swap instead of exact out
106
- * @param additionalParams Additional parameters sent to the LP when creating the swap
107
- * @param options Additional options for the swap
108
- */
109
- createToBTCLNSwapViaLNURL(tokenAddress: string, lnurlPay: string | LNURLPay, amount: bigint, exactIn?: boolean, additionalParams?: Record<string, any>, options?: ToBTCLNOptions): Promise<SwapWithSigner<ToBTCLNSwap<T[ChainIdentifier]>>>;
110
- /**
111
- * Creates Smart chain -> Bitcoin Lightning ({@link SwapType.TO_BTCLN}) swap via {@link LightningInvoiceCreateService}
112
- *
113
- * @param tokenAddress Token address to pay with
114
- * @param service Invoice create service object which facilitates the creation of fixed amount LN invoices
115
- * @param amount Amount to send in token based units (if `exactIn=true`) or receive in satoshis (if `exactIn=false`)
116
- * @param exactIn Whether to do an exact in swap instead of exact out
117
- * @param additionalParams Additional parameters sent to the LP when creating the swap
118
- * @param options Additional options for the swap
119
- */
120
- createToBTCLNSwapViaInvoiceCreateService(tokenAddress: string, service: LightningInvoiceCreateService, amount: bigint, exactIn?: boolean, additionalParams?: Record<string, any>, options?: ToBTCLNOptions): Promise<SwapWithSigner<ToBTCLNSwap<T[ChainIdentifier]>>>;
121
- /**
122
- * Creates Bitcoin -> Smart chain ({@link SwapType.SPV_VAULT_FROM_BTC}) swap
123
- *
124
- * @param tokenAddress Token address to receive
125
- * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
126
- * @param exactOut Whether to use a exact out instead of exact in
127
- * @param additionalParams Additional parameters sent to the LP when creating the swap
128
- * @param options Additional options for the swap
129
- */
130
- createFromBTCSwapNew(tokenAddress: string, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: SpvFromBTCOptions): Promise<SwapWithSigner<SpvFromBTCSwap<T[ChainIdentifier]>>>;
131
- /**
132
- * Creates LEGACY Bitcoin -> Smart chain ({@link SwapType.FROM_BTC}) swap
133
- *
134
- * @param tokenAddress Token address to receive
135
- * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
136
- * @param exactOut Whether to use a exact out instead of exact in
137
- * @param additionalParams Additional parameters sent to the LP when creating the swap
138
- * @param options Additional options for the swap
139
- */
140
- createFromBTCSwap(tokenAddress: string, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: FromBTCOptions): Promise<SwapWithSigner<FromBTCSwap<T[ChainIdentifier]>>>;
141
- /**
142
- * Creates LEGACY Bitcoin Lightning -> Smart chain ({@link SwapType.FROM_BTCLN}) swap
143
- *
144
- * @param tokenAddress Token address to receive
145
- * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
146
- * @param exactOut Whether to use a exact out instead of exact in
147
- * @param additionalParams Additional parameters sent to the LP when creating the swap
148
- * @param options Additional options for the swap
149
- */
150
- createFromBTCLNSwap(tokenAddress: string, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: FromBTCLNOptions): Promise<SwapWithSigner<FromBTCLNSwap<T[ChainIdentifier]>>>;
151
- /**
152
- * Creates LEGACY Bitcoin Lightning -> Smart chain ({@link SwapType.FROM_BTCLN}) swap, withdrawing from
153
- * an LNURL-withdraw link
154
- *
155
- * @param tokenAddress Token address to receive
156
- * @param lnurl LNURL-withdraw link to pull the funds from
157
- * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
158
- * @param exactOut Whether to use a exact out instead of exact in
159
- * @param additionalParams Additional parameters sent to the LP when creating the swap
160
- */
161
- createFromBTCLNSwapViaLNURL(tokenAddress: string, lnurl: string | LNURLWithdraw, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>): Promise<SwapWithSigner<FromBTCLNSwap<T[ChainIdentifier]>>>;
162
- /**
163
- * Creates Bitcoin Lightning -> Smart chain ({@link SwapType.FROM_BTCLN_AUTO}) swap
164
- *
165
- * @param tokenAddress Token address to receive
166
- * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
167
- * @param exactOut Whether to use a exact out instead of exact in
168
- * @param additionalParams Additional parameters sent to the LP when creating the swap
169
- * @param options Additional options for the swap
170
- */
171
- createFromBTCLNSwapNew(tokenAddress: string, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: FromBTCLNAutoOptions): Promise<SwapWithSigner<FromBTCLNAutoSwap<T[ChainIdentifier]>>>;
172
- /**
173
- * Creates Bitcoin Lightning -> Smart chain ({@link SwapType.FROM_BTCLN_AUTO}) swap, withdrawing from
174
- * an LNURL-withdraw link
175
- *
176
- * @param tokenAddress Token address to receive
177
- * @param lnurl LNURL-withdraw link to pull the funds from
178
- * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
179
- * @param exactOut Whether to use a exact out instead of exact in
180
- * @param additionalParams Additional parameters sent to the LP when creating the swap
181
- * @param options Additional options for the swap
182
- */
183
- createFromBTCLNSwapNewViaLNURL(tokenAddress: string, lnurl: string | LNURLWithdraw, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: FromBTCLNAutoOptions): Promise<SwapWithSigner<FromBTCLNAutoSwap<T[ChainIdentifier]>>>;
184
- /**
185
- * Creates a trusted Bitcoin Lightning -> Smart chain ({@link SwapType.TRUSTED_FROM_BTCLN}) gas swap
186
- *
187
- * @param amount Amount of native token to receive, in base units
188
- * @param trustedIntermediaryOrUrl URL or Intermediary object of the trusted intermediary to use, otherwise uses default
189
- * @throws {Error} If no trusted intermediary specified
190
- */
191
- createTrustedLNForGasSwap(amount: bigint, trustedIntermediaryOrUrl?: Intermediary | string): Promise<LnForGasSwap<T[ChainIdentifier]>>;
192
- /**
193
- * Creates a trusted Bitcoin -> Smart chain ({@link SwapType.TRUSTED_FROM_BTC}) gas swap
194
- *
195
- * @param amount Amount of native token to receive, in base units
196
- * @param refundAddress Bitcoin refund address, in case the swap fails the funds are refunded here
197
- * @param trustedIntermediaryOrUrl URL or Intermediary object of the trusted intermediary to use, otherwise uses default
198
- * @throws {Error} If no trusted intermediary specified
199
- */
200
- createTrustedOnchainForGasSwap(amount: bigint, refundAddress?: string, trustedIntermediaryOrUrl?: Intermediary | string): Promise<OnchainForGasSwap<T[ChainIdentifier]>>;
201
- /**
202
- * @internal
203
- */
204
- create(srcToken: BtcToken<true>, dstToken: SCToken<ChainIdentifier>, amount: bigint, exactIn: boolean, lnurlWithdraw?: string | LNURLWithdraw): Promise<(SupportsSwapType<T[ChainIdentifier], SwapType.FROM_BTCLN_AUTO> extends true ? FromBTCLNAutoSwap<T[ChainIdentifier]> : FromBTCLNSwap<T[ChainIdentifier]>)>;
205
- /**
206
- * @internal
207
- */
208
- create(srcToken: BtcToken<false>, dstToken: SCToken<ChainIdentifier>, amount: bigint, exactIn: boolean): Promise<(SupportsSwapType<T[ChainIdentifier], SwapType.SPV_VAULT_FROM_BTC> extends true ? SpvFromBTCSwap<T[ChainIdentifier]> : FromBTCSwap<T[ChainIdentifier]>)>;
209
- /**
210
- * @internal
211
- */
212
- create(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<false>, amount: bigint, exactIn: boolean, address: string): Promise<ToBTCSwap<T[ChainIdentifier]>>;
213
- /**
214
- * @internal
215
- */
216
- create(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<true>, amount: bigint, exactIn: boolean, lnurlPay: string | LNURLPay): Promise<ToBTCLNSwap<T[ChainIdentifier]>>;
217
- /**
218
- * Creates a swap from srcToken to dstToken, of a specific token amount, either specifying input amount (exactIn=true)
219
- * or output amount (exactIn=false), NOTE: For regular -> BTC-LN (lightning) swaps the passed amount is ignored and
220
- * invoice's pre-set amount is used instead.
221
- *
222
- * @param srcToken Source token of the swap, user pays this token
223
- * @param dstToken Destination token of the swap, user receives this token
224
- * @param amount Amount of the swap
225
- * @param exactIn Whether the amount specified is an input amount (exactIn=true) or an output amount (exactIn=false)
226
- * @param addressLnurlLightningInvoice Bitcoin on-chain address, lightning invoice, LNURL-pay to pay or
227
- * LNURL-withdrawal to withdraw money from
228
- */
229
- create(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<true>, amount: undefined, exactIn: false, addressLnurlLightningInvoice: string): Promise<ToBTCLNSwap<T[ChainIdentifier]>>;
230
- /**
231
- * Returns swaps that are in-progress and are claimable for the specific chain, optionally also for a specific signer's address
232
- */
233
- getAllSwaps(): Promise<ISwap<T[ChainIdentifier]>[]>;
234
- /**
235
- * Returns swaps that are in-progress and are claimable for the specific chain, optionally also for a specific signer's address
236
- */
237
- getActionableSwaps(): Promise<ISwap<T[ChainIdentifier]>[]>;
238
- /**
239
- * Returns swaps that are refundable for the specific chain, optionally also for a specific signer's address
240
- */
241
- getRefundableSwaps(): Promise<IToBTCSwap<T[ChainIdentifier]>[]>;
242
- /**
243
- * Returns swap with a specific id (identifier) on a specific chain and optionally with a signer
244
- */
245
- getSwapById(id: string): Promise<ISwap<T[ChainIdentifier]>>;
246
- /**
247
- * Returns the swap with a proper return type, or `undefined` if not found or has wrong type
248
- *
249
- * @param id An ID of the swap ({@link ISwap.getId})
250
- * @param swapType Type of the swap
251
- */
252
- getTypedSwapById<S extends SwapType>(id: string, swapType: S): Promise<SwapTypeMapping<T[ChainIdentifier]>[S] | undefined>;
253
- /**
254
- * Synchronizes swaps from chain, this is usually ran when SDK is initialized, deletes expired quotes
255
- */
256
- _syncSwaps(): Promise<void>;
257
- /**
258
- * Recovers swaps from on-chain historical data.
259
- *
260
- * Please note that the recovered swaps might not be complete (i.e. missing amounts or addresses), as some
261
- * of the swap data is purely off-chain and can never be recovered purely from on-chain data. This
262
- * functions tries to recover as much swap data as possible.
263
- *
264
- * @param startBlockheight Optional starting blockheight for swap data recovery, will only check swaps
265
- * initiated after this blockheight
266
- */
267
- recoverSwaps(startBlockheight?: number): Promise<ISwap<T[ChainIdentifier]>[]>;
268
- getToken(ticker: "BTC" | "BITCOIN-BTC"): BtcToken<false>;
269
- getToken(ticker: "BTCLN" | "BTC-LN" | "LIGHTNING-BTC"): BtcToken<true>;
270
- getToken(ticker: `${ChainIdentifier}-${string}`): SCToken<ChainIdentifier>;
271
- getToken(tickerOrAddress: string): Token<ChainIdentifier>;
272
- /**
273
- * Returns whether the SDK supports a given swap type on this chain based on currently known LPs
274
- *
275
- * @param swapType Swap protocol type
276
- */
277
- supportsSwapType<Type extends SwapType>(swapType: Type): SupportsSwapType<T[ChainIdentifier], Type>;
278
- /**
279
- * @internal
280
- */
281
- getSwapType(srcToken: BtcToken<true>, dstToken: SCToken<ChainIdentifier>): (SupportsSwapType<T[ChainIdentifier], SwapType.FROM_BTCLN_AUTO> extends true ? SwapType.FROM_BTCLN_AUTO : SwapType.FROM_BTCLN);
282
- /**
283
- * @internal
284
- */
285
- getSwapType(srcToken: BtcToken<false>, dstToken: SCToken<ChainIdentifier>): (SupportsSwapType<T[ChainIdentifier], SwapType.SPV_VAULT_FROM_BTC> extends true ? SwapType.SPV_VAULT_FROM_BTC : SwapType.FROM_BTC);
286
- /**
287
- * @internal
288
- */
289
- getSwapType(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<false>): SwapType.TO_BTC;
290
- /**
291
- * @internal
292
- */
293
- getSwapType(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<true>): SwapType.TO_BTCLN;
294
- /**
295
- * Returns type of the swap based on input and output tokens specified
296
- *
297
- * @param srcToken Source token
298
- * @param dstToken Destination token
299
- */
300
- getSwapType(srcToken: Token<ChainIdentifier>, dstToken: Token<ChainIdentifier>): SwapType.FROM_BTCLN_AUTO | SwapType.FROM_BTCLN | SwapType.SPV_VAULT_FROM_BTC | SwapType.FROM_BTC | SwapType.TO_BTC | SwapType.TO_BTCLN;
301
- /**
302
- * Returns minimum/maximum limits for inputs and outputs for a swap between given tokens
303
- *
304
- * @param srcToken Source token
305
- * @param dstToken Destination token
306
- */
307
- getSwapLimits<A extends Token<ChainIdentifier>, B extends Token<ChainIdentifier>>(srcToken: A, dstToken: B): {
308
- input: {
309
- min: TokenAmount<A>;
310
- max?: TokenAmount<A>;
311
- };
312
- output: {
313
- min: TokenAmount<B>;
314
- max?: TokenAmount<B>;
315
- };
316
- };
317
- /**
318
- * Returns tokens that you can swap to (if input=true) from a given token,
319
- * or tokens that you can swap from (if input=false) to a given token
320
- */
321
- getSwapCounterTokens(token: Token, input: SwapSide | boolean): Token<ChainIdentifier>[];
322
- }
1
+ import { IntermediaryDiscovery } from "../intermediaries/IntermediaryDiscovery";
2
+ import { SwapType } from "../enums/SwapType";
3
+ import { LnForGasSwap } from "../swaps/trusted/ln/LnForGasSwap";
4
+ import { ISwap } from "../swaps/ISwap";
5
+ import { IToBTCSwap } from "../swaps/escrow_swaps/tobtc/IToBTCSwap";
6
+ import { ChainIds, MultiChain, SupportsSwapType } from "./Swapper";
7
+ import { FromBTCLNSwap } from "../swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap";
8
+ import { FromBTCSwap } from "../swaps/escrow_swaps/frombtc/onchain/FromBTCSwap";
9
+ import { ToBTCLNSwap } from "../swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap";
10
+ import { ToBTCSwap } from "../swaps/escrow_swaps/tobtc/onchain/ToBTCSwap";
11
+ import { SwapPriceWithChain } from "../prices/SwapPriceWithChain";
12
+ import { ToBTCOptions } from "../swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper";
13
+ import { ToBTCLNOptions } from "../swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper";
14
+ import { FromBTCOptions } from "../swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper";
15
+ import { FromBTCLNOptions } from "../swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper";
16
+ import { SwapperUtils } from "./SwapperUtils";
17
+ import { SpvFromBTCSwap } from "../swaps/spv_swaps/SpvFromBTCSwap";
18
+ import { SwapperWithChain } from "./SwapperWithChain";
19
+ import { SwapWithSigner } from "../types/SwapWithSigner";
20
+ import { OnchainForGasSwap } from "../swaps/trusted/onchain/OnchainForGasSwap";
21
+ import { FromBTCLNAutoSwap } from "../swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap";
22
+ import { FromBTCLNAutoOptions } from "../swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper";
23
+ import { TokenAmount } from "../types/TokenAmount";
24
+ import { BtcToken, SCToken, Token } from "../types/Token";
25
+ import { LNURLWithdraw } from "../types/lnurl/LNURLWithdraw";
26
+ import { LNURLPay } from "../types/lnurl/LNURLPay";
27
+ import { LightningInvoiceCreateService } from "../types/wallets/LightningInvoiceCreateService";
28
+ import { Intermediary } from "../intermediaries/Intermediary";
29
+ import { SpvFromBTCOptions } from "../swaps/spv_swaps/SpvFromBTCWrapper";
30
+ import { SwapTypeMapping } from "../utils/SwapUtils";
31
+ import { SwapSide } from "../enums/SwapSide";
32
+ /**
33
+ * Chain and signer-specific wrapper for automatic signer injection into swap methods
34
+ * @category Core
35
+ */
36
+ export declare class SwapperWithSigner<T extends MultiChain, ChainIdentifier extends ChainIds<T>> {
37
+ private readonly signer;
38
+ /**
39
+ * Underlying single chain swapper instance
40
+ */
41
+ private readonly swapper;
42
+ /**
43
+ * Smart chain identifier of this swapper with chain and signer
44
+ */
45
+ readonly chainIdentifier: ChainIdentifier;
46
+ /**
47
+ * Pricing API used by the SDK
48
+ */
49
+ get prices(): SwapPriceWithChain<T, ChainIdentifier>;
50
+ /**
51
+ * Intermediary discovery instance
52
+ */
53
+ get intermediaryDiscovery(): IntermediaryDiscovery;
54
+ /**
55
+ * Miscellaneous utility functions
56
+ */
57
+ get Utils(): SwapperUtils<T>;
58
+ /**
59
+ * Helper information about various swap protocol and their features:
60
+ * - `requiresInputWallet`: Whether a swap requires a connected wallet on the input chain able to sign
61
+ * arbitrary transaction
62
+ * - `requiresOutputWallet`: Whether a swap requires a connected wallet on the output chain able to sign
63
+ * arbitrary transactions
64
+ * - `supportsGasDrop`: Whether a swap supports the "gas drop" feature, allowing to user to receive a small
65
+ * amount of native token as part of the swap when swapping to smart chains
66
+ *
67
+ * Uses a `Record` type here, use the {@link SwapProtocolInfo} import for a literal readonly type, with
68
+ * pre-filled exact values in the type.
69
+ */
70
+ get SwapTypeInfo(): Record<SwapType, {
71
+ requiresInputWallet: boolean;
72
+ requiresOutputWallet: boolean;
73
+ supportsGasDrop: boolean;
74
+ }>;
75
+ constructor(swapper: SwapperWithChain<T, ChainIdentifier>, signer: T[ChainIdentifier]["Signer"]);
76
+ /**
77
+ * Creates Smart chain -> Bitcoin ({@link SwapType.TO_BTC}) swap
78
+ *
79
+ * @param tokenAddress Token address to pay with
80
+ * @param address Recipient's bitcoin address
81
+ * @param amount Amount to send in token based units (if `exactIn=true`) or receive in satoshis (if `exactIn=false`)
82
+ * @param exactIn Whether to use exact in instead of exact out
83
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
84
+ * @param options Additional options for the swap
85
+ */
86
+ createToBTCSwap(tokenAddress: string, address: string, amount: bigint, exactIn?: boolean, additionalParams?: Record<string, any>, options?: ToBTCOptions): Promise<SwapWithSigner<ToBTCSwap<T[ChainIdentifier]>>>;
87
+ /**
88
+ * Creates Smart chain -> Bitcoin Lightning ({@link SwapType.TO_BTCLN}) swap
89
+ *
90
+ * @param tokenAddress Token address to pay with
91
+ * @param paymentRequest BOLT11 lightning network invoice to be paid (needs to have a fixed amount), and the swap
92
+ * amount is taken from this fixed amount, hence only exact output swaps are supported
93
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
94
+ * @param options Additional options for the swap
95
+ */
96
+ createToBTCLNSwap(tokenAddress: string, paymentRequest: string, additionalParams?: Record<string, any>, options?: ToBTCLNOptions & {
97
+ comment?: string;
98
+ }): Promise<SwapWithSigner<ToBTCLNSwap<T[ChainIdentifier]>>>;
99
+ /**
100
+ * Creates Smart chain -> Bitcoin Lightning ({@link SwapType.TO_BTCLN}) swap via LNURL-pay link
101
+ *
102
+ * @param tokenAddress Token address to pay with
103
+ * @param lnurlPay LNURL-pay link to use for the payment
104
+ * @param amount Amount to send in token based units (if `exactIn=true`) or receive in satoshis (if `exactIn=false`)
105
+ * @param exactIn Whether to do an exact in swap instead of exact out
106
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
107
+ * @param options Additional options for the swap
108
+ */
109
+ createToBTCLNSwapViaLNURL(tokenAddress: string, lnurlPay: string | LNURLPay, amount: bigint, exactIn?: boolean, additionalParams?: Record<string, any>, options?: ToBTCLNOptions): Promise<SwapWithSigner<ToBTCLNSwap<T[ChainIdentifier]>>>;
110
+ /**
111
+ * Creates Smart chain -> Bitcoin Lightning ({@link SwapType.TO_BTCLN}) swap via {@link LightningInvoiceCreateService}
112
+ *
113
+ * @param tokenAddress Token address to pay with
114
+ * @param service Invoice create service object which facilitates the creation of fixed amount LN invoices
115
+ * @param amount Amount to send in token based units (if `exactIn=true`) or receive in satoshis (if `exactIn=false`)
116
+ * @param exactIn Whether to do an exact in swap instead of exact out
117
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
118
+ * @param options Additional options for the swap
119
+ */
120
+ createToBTCLNSwapViaInvoiceCreateService(tokenAddress: string, service: LightningInvoiceCreateService, amount: bigint, exactIn?: boolean, additionalParams?: Record<string, any>, options?: ToBTCLNOptions): Promise<SwapWithSigner<ToBTCLNSwap<T[ChainIdentifier]>>>;
121
+ /**
122
+ * Creates Bitcoin -> Smart chain ({@link SwapType.SPV_VAULT_FROM_BTC}) swap
123
+ *
124
+ * @param tokenAddress Token address to receive
125
+ * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
126
+ * @param exactOut Whether to use a exact out instead of exact in
127
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
128
+ * @param options Additional options for the swap
129
+ */
130
+ createFromBTCSwapNew(tokenAddress: string, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: SpvFromBTCOptions): Promise<SwapWithSigner<SpvFromBTCSwap<T[ChainIdentifier]>>>;
131
+ /**
132
+ * Creates LEGACY Bitcoin -> Smart chain ({@link SwapType.FROM_BTC}) swap
133
+ *
134
+ * @param tokenAddress Token address to receive
135
+ * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
136
+ * @param exactOut Whether to use a exact out instead of exact in
137
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
138
+ * @param options Additional options for the swap
139
+ */
140
+ createFromBTCSwap(tokenAddress: string, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: FromBTCOptions): Promise<SwapWithSigner<FromBTCSwap<T[ChainIdentifier]>>>;
141
+ /**
142
+ * Creates LEGACY Bitcoin Lightning -> Smart chain ({@link SwapType.FROM_BTCLN}) swap
143
+ *
144
+ * @param tokenAddress Token address to receive
145
+ * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
146
+ * @param exactOut Whether to use a exact out instead of exact in
147
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
148
+ * @param options Additional options for the swap
149
+ */
150
+ createFromBTCLNSwap(tokenAddress: string, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: FromBTCLNOptions): Promise<SwapWithSigner<FromBTCLNSwap<T[ChainIdentifier]>>>;
151
+ /**
152
+ * Creates LEGACY Bitcoin Lightning -> Smart chain ({@link SwapType.FROM_BTCLN}) swap, withdrawing from
153
+ * an LNURL-withdraw link
154
+ *
155
+ * @param tokenAddress Token address to receive
156
+ * @param lnurl LNURL-withdraw link to pull the funds from
157
+ * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
158
+ * @param exactOut Whether to use a exact out instead of exact in
159
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
160
+ */
161
+ createFromBTCLNSwapViaLNURL(tokenAddress: string, lnurl: string | LNURLWithdraw, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>): Promise<SwapWithSigner<FromBTCLNSwap<T[ChainIdentifier]>>>;
162
+ /**
163
+ * Creates Bitcoin Lightning -> Smart chain ({@link SwapType.FROM_BTCLN_AUTO}) swap
164
+ *
165
+ * @param tokenAddress Token address to receive
166
+ * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
167
+ * @param exactOut Whether to use a exact out instead of exact in
168
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
169
+ * @param options Additional options for the swap
170
+ */
171
+ createFromBTCLNSwapNew(tokenAddress: string, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: FromBTCLNAutoOptions): Promise<SwapWithSigner<FromBTCLNAutoSwap<T[ChainIdentifier]>>>;
172
+ /**
173
+ * Creates Bitcoin Lightning -> Smart chain ({@link SwapType.FROM_BTCLN_AUTO}) swap, withdrawing from
174
+ * an LNURL-withdraw link
175
+ *
176
+ * @param tokenAddress Token address to receive
177
+ * @param lnurl LNURL-withdraw link to pull the funds from
178
+ * @param amount Amount to send in satoshis (if `exactOut=false`) or receive in token based units (if `exactOut=true`)
179
+ * @param exactOut Whether to use a exact out instead of exact in
180
+ * @param additionalParams Additional parameters sent to the LP when creating the swap
181
+ * @param options Additional options for the swap
182
+ */
183
+ createFromBTCLNSwapNewViaLNURL(tokenAddress: string, lnurl: string | LNURLWithdraw, amount: bigint, exactOut?: boolean, additionalParams?: Record<string, any>, options?: FromBTCLNAutoOptions): Promise<SwapWithSigner<FromBTCLNAutoSwap<T[ChainIdentifier]>>>;
184
+ /**
185
+ * Creates a trusted Bitcoin Lightning -> Smart chain ({@link SwapType.TRUSTED_FROM_BTCLN}) gas swap
186
+ *
187
+ * @param amount Amount of native token to receive, in base units
188
+ * @param trustedIntermediaryOrUrl URL or Intermediary object of the trusted intermediary to use, otherwise uses default
189
+ * @throws {Error} If no trusted intermediary specified
190
+ */
191
+ createTrustedLNForGasSwap(amount: bigint, trustedIntermediaryOrUrl?: Intermediary | string): Promise<LnForGasSwap<T[ChainIdentifier]>>;
192
+ /**
193
+ * Creates a trusted Bitcoin -> Smart chain ({@link SwapType.TRUSTED_FROM_BTC}) gas swap
194
+ *
195
+ * @param amount Amount of native token to receive, in base units
196
+ * @param refundAddress Bitcoin refund address, in case the swap fails the funds are refunded here
197
+ * @param trustedIntermediaryOrUrl URL or Intermediary object of the trusted intermediary to use, otherwise uses default
198
+ * @throws {Error} If no trusted intermediary specified
199
+ */
200
+ createTrustedOnchainForGasSwap(amount: bigint, refundAddress?: string, trustedIntermediaryOrUrl?: Intermediary | string): Promise<OnchainForGasSwap<T[ChainIdentifier]>>;
201
+ /**
202
+ * @internal
203
+ */
204
+ create(srcToken: BtcToken<true>, dstToken: SCToken<ChainIdentifier>, amount: bigint, exactIn: boolean, lnurlWithdraw?: string | LNURLWithdraw): Promise<(SupportsSwapType<T[ChainIdentifier], SwapType.FROM_BTCLN_AUTO> extends true ? FromBTCLNAutoSwap<T[ChainIdentifier]> : FromBTCLNSwap<T[ChainIdentifier]>)>;
205
+ /**
206
+ * @internal
207
+ */
208
+ create(srcToken: BtcToken<false>, dstToken: SCToken<ChainIdentifier>, amount: bigint, exactIn: boolean): Promise<(SupportsSwapType<T[ChainIdentifier], SwapType.SPV_VAULT_FROM_BTC> extends true ? SpvFromBTCSwap<T[ChainIdentifier]> : FromBTCSwap<T[ChainIdentifier]>)>;
209
+ /**
210
+ * @internal
211
+ */
212
+ create(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<false>, amount: bigint, exactIn: boolean, address: string): Promise<ToBTCSwap<T[ChainIdentifier]>>;
213
+ /**
214
+ * @internal
215
+ */
216
+ create(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<true>, amount: bigint, exactIn: boolean, lnurlPay: string | LNURLPay): Promise<ToBTCLNSwap<T[ChainIdentifier]>>;
217
+ /**
218
+ * Creates a swap from srcToken to dstToken, of a specific token amount, either specifying input amount (exactIn=true)
219
+ * or output amount (exactIn=false), NOTE: For regular -> BTC-LN (lightning) swaps the passed amount is ignored and
220
+ * invoice's pre-set amount is used instead.
221
+ *
222
+ * @param srcToken Source token of the swap, user pays this token
223
+ * @param dstToken Destination token of the swap, user receives this token
224
+ * @param amount Amount of the swap
225
+ * @param exactIn Whether the amount specified is an input amount (exactIn=true) or an output amount (exactIn=false)
226
+ * @param addressLnurlLightningInvoice Bitcoin on-chain address, lightning invoice, LNURL-pay to pay or
227
+ * LNURL-withdrawal to withdraw money from
228
+ */
229
+ create(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<true>, amount: undefined, exactIn: false, addressLnurlLightningInvoice: string): Promise<ToBTCLNSwap<T[ChainIdentifier]>>;
230
+ /**
231
+ * Returns swaps that are in-progress and are claimable for the specific chain, optionally also for a specific signer's address
232
+ */
233
+ getAllSwaps(): Promise<ISwap<T[ChainIdentifier]>[]>;
234
+ /**
235
+ * Returns swaps that are in-progress and are claimable for the specific chain, optionally also for a specific signer's address
236
+ */
237
+ getActionableSwaps(): Promise<ISwap<T[ChainIdentifier]>[]>;
238
+ /**
239
+ * Returns swaps that are refundable for the specific chain, optionally also for a specific signer's address
240
+ */
241
+ getRefundableSwaps(): Promise<IToBTCSwap<T[ChainIdentifier]>[]>;
242
+ /**
243
+ * Returns swap with a specific id (identifier) on a specific chain and optionally with a signer
244
+ */
245
+ getSwapById(id: string): Promise<ISwap<T[ChainIdentifier]>>;
246
+ /**
247
+ * Returns the swap with a proper return type, or `undefined` if not found or has wrong type
248
+ *
249
+ * @param id An ID of the swap ({@link ISwap.getId})
250
+ * @param swapType Type of the swap
251
+ */
252
+ getTypedSwapById<S extends SwapType>(id: string, swapType: S): Promise<SwapTypeMapping<T[ChainIdentifier]>[S] | undefined>;
253
+ /**
254
+ * Synchronizes swaps from chain, this is usually ran when SDK is initialized, deletes expired quotes
255
+ */
256
+ _syncSwaps(): Promise<void>;
257
+ /**
258
+ * Recovers swaps from on-chain historical data.
259
+ *
260
+ * Please note that the recovered swaps might not be complete (i.e. missing amounts or addresses), as some
261
+ * of the swap data is purely off-chain and can never be recovered purely from on-chain data. This
262
+ * functions tries to recover as much swap data as possible.
263
+ *
264
+ * @param startBlockheight Optional starting blockheight for swap data recovery, will only check swaps
265
+ * initiated after this blockheight
266
+ */
267
+ recoverSwaps(startBlockheight?: number): Promise<ISwap<T[ChainIdentifier]>[]>;
268
+ getToken(ticker: "BTC" | "BITCOIN-BTC"): BtcToken<false>;
269
+ getToken(ticker: "BTCLN" | "BTC-LN" | "LIGHTNING-BTC"): BtcToken<true>;
270
+ getToken(ticker: `${ChainIdentifier}-${string}`): SCToken<ChainIdentifier>;
271
+ getToken(tickerOrAddress: string): Token<ChainIdentifier>;
272
+ /**
273
+ * Returns whether the SDK supports a given swap type on this chain based on currently known LPs
274
+ *
275
+ * @param swapType Swap protocol type
276
+ */
277
+ supportsSwapType<Type extends SwapType>(swapType: Type): SupportsSwapType<T[ChainIdentifier], Type>;
278
+ /**
279
+ * @internal
280
+ */
281
+ getSwapType(srcToken: BtcToken<true>, dstToken: SCToken<ChainIdentifier>): (SupportsSwapType<T[ChainIdentifier], SwapType.FROM_BTCLN_AUTO> extends true ? SwapType.FROM_BTCLN_AUTO : SwapType.FROM_BTCLN);
282
+ /**
283
+ * @internal
284
+ */
285
+ getSwapType(srcToken: BtcToken<false>, dstToken: SCToken<ChainIdentifier>): (SupportsSwapType<T[ChainIdentifier], SwapType.SPV_VAULT_FROM_BTC> extends true ? SwapType.SPV_VAULT_FROM_BTC : SwapType.FROM_BTC);
286
+ /**
287
+ * @internal
288
+ */
289
+ getSwapType(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<false>): SwapType.TO_BTC;
290
+ /**
291
+ * @internal
292
+ */
293
+ getSwapType(srcToken: SCToken<ChainIdentifier>, dstToken: BtcToken<true>): SwapType.TO_BTCLN;
294
+ /**
295
+ * Returns type of the swap based on input and output tokens specified
296
+ *
297
+ * @param srcToken Source token
298
+ * @param dstToken Destination token
299
+ */
300
+ getSwapType(srcToken: Token<ChainIdentifier>, dstToken: Token<ChainIdentifier>): SwapType.FROM_BTCLN_AUTO | SwapType.FROM_BTCLN | SwapType.SPV_VAULT_FROM_BTC | SwapType.FROM_BTC | SwapType.TO_BTC | SwapType.TO_BTCLN;
301
+ /**
302
+ * Returns minimum/maximum limits for inputs and outputs for a swap between given tokens
303
+ *
304
+ * @param srcToken Source token
305
+ * @param dstToken Destination token
306
+ */
307
+ getSwapLimits<A extends Token<ChainIdentifier>, B extends Token<ChainIdentifier>>(srcToken: A, dstToken: B): {
308
+ input: {
309
+ min: TokenAmount<A>;
310
+ max?: TokenAmount<A>;
311
+ };
312
+ output: {
313
+ min: TokenAmount<B>;
314
+ max?: TokenAmount<B>;
315
+ };
316
+ };
317
+ /**
318
+ * Returns tokens that you can swap to (if input=true) from a given token,
319
+ * or tokens that you can swap from (if input=false) to a given token
320
+ */
321
+ getSwapCounterTokens(token: Token, input: SwapSide | boolean): Token<ChainIdentifier>[];
322
+ }