@atomiqlabs/sdk 8.6.4 → 8.6.6
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.
- package/dist/SmartChainAssets.d.ts +181 -181
- package/dist/SmartChainAssets.js +181 -181
- package/dist/bitcoin/coinselect2/accumulative.d.ts +6 -6
- package/dist/bitcoin/coinselect2/accumulative.js +51 -52
- package/dist/bitcoin/coinselect2/blackjack.d.ts +6 -6
- package/dist/bitcoin/coinselect2/blackjack.js +37 -38
- package/dist/bitcoin/coinselect2/index.d.ts +17 -19
- package/dist/bitcoin/coinselect2/index.js +69 -69
- package/dist/bitcoin/coinselect2/utils.d.ts +75 -77
- package/dist/bitcoin/coinselect2/utils.js +123 -123
- package/dist/bitcoin/wallet/BitcoinWallet.d.ts +128 -130
- package/dist/bitcoin/wallet/BitcoinWallet.js +322 -322
- package/dist/bitcoin/wallet/IBitcoinWallet.d.ts +78 -78
- package/dist/bitcoin/wallet/IBitcoinWallet.js +20 -21
- package/dist/bitcoin/wallet/SingleAddressBitcoinWallet.d.ts +99 -101
- package/dist/bitcoin/wallet/SingleAddressBitcoinWallet.js +176 -176
- package/dist/enums/FeeType.d.ts +15 -15
- package/dist/enums/FeeType.js +19 -19
- package/dist/enums/SwapAmountType.d.ts +15 -15
- package/dist/enums/SwapAmountType.js +19 -19
- package/dist/enums/SwapDirection.d.ts +15 -15
- package/dist/enums/SwapDirection.js +19 -19
- package/dist/enums/SwapSide.d.ts +15 -15
- package/dist/enums/SwapSide.js +19 -19
- package/dist/enums/SwapType.d.ts +75 -75
- package/dist/enums/SwapType.js +79 -79
- package/dist/errors/IntermediaryError.d.ts +13 -13
- package/dist/errors/IntermediaryError.js +27 -27
- package/dist/errors/RequestError.d.ts +32 -32
- package/dist/errors/RequestError.js +54 -54
- package/dist/errors/UserError.d.ts +8 -8
- package/dist/errors/UserError.js +16 -16
- package/dist/events/UnifiedSwapEventListener.d.ts +23 -23
- package/dist/events/UnifiedSwapEventListener.js +130 -130
- package/dist/http/HttpUtils.d.ts +27 -27
- package/dist/http/HttpUtils.js +90 -91
- package/dist/http/paramcoders/IParamReader.d.ts +8 -8
- package/dist/http/paramcoders/IParamReader.js +2 -2
- package/dist/http/paramcoders/ParamDecoder.d.ts +42 -44
- package/dist/http/paramcoders/ParamDecoder.js +137 -137
- package/dist/http/paramcoders/ParamEncoder.d.ts +18 -20
- package/dist/http/paramcoders/ParamEncoder.js +36 -36
- package/dist/http/paramcoders/SchemaVerifier.d.ts +26 -26
- package/dist/http/paramcoders/SchemaVerifier.js +145 -145
- package/dist/http/paramcoders/client/ResponseParamDecoder.d.ts +11 -11
- package/dist/http/paramcoders/client/ResponseParamDecoder.js +57 -57
- package/dist/http/paramcoders/client/StreamParamEncoder.d.ts +11 -13
- package/dist/http/paramcoders/client/StreamParamEncoder.js +26 -26
- package/dist/http/paramcoders/client/StreamingFetchPromise.d.ts +16 -16
- package/dist/http/paramcoders/client/StreamingFetchPromise.js +173 -174
- package/dist/index.d.ts +85 -85
- package/dist/index.js +158 -158
- package/dist/intermediaries/Intermediary.d.ts +157 -157
- package/dist/intermediaries/Intermediary.js +142 -142
- package/dist/intermediaries/IntermediaryDiscovery.d.ts +198 -199
- package/dist/intermediaries/IntermediaryDiscovery.js +406 -406
- package/dist/intermediaries/apis/IntermediaryAPI.d.ts +437 -438
- package/dist/intermediaries/apis/IntermediaryAPI.js +603 -602
- package/dist/intermediaries/apis/TrustedIntermediaryAPI.d.ts +155 -155
- package/dist/intermediaries/apis/TrustedIntermediaryAPI.js +137 -137
- package/dist/lnurl/LNURL.d.ts +102 -102
- package/dist/lnurl/LNURL.js +321 -321
- package/dist/prices/RedundantSwapPrice.d.ts +110 -110
- package/dist/prices/RedundantSwapPrice.js +222 -222
- package/dist/prices/SingleSwapPrice.d.ts +34 -34
- package/dist/prices/SingleSwapPrice.js +44 -44
- package/dist/prices/SwapPriceWithChain.d.ts +107 -107
- package/dist/prices/SwapPriceWithChain.js +128 -128
- package/dist/prices/abstract/ICachedSwapPrice.d.ts +28 -28
- package/dist/prices/abstract/ICachedSwapPrice.js +62 -62
- package/dist/prices/abstract/IPriceProvider.d.ts +81 -81
- package/dist/prices/abstract/IPriceProvider.js +74 -74
- package/dist/prices/abstract/ISwapPrice.d.ts +168 -166
- package/dist/prices/abstract/ISwapPrice.js +279 -267
- package/dist/prices/providers/BinancePriceProvider.d.ts +23 -23
- package/dist/prices/providers/BinancePriceProvider.js +30 -30
- package/dist/prices/providers/CoinGeckoPriceProvider.d.ts +23 -23
- package/dist/prices/providers/CoinGeckoPriceProvider.js +29 -29
- package/dist/prices/providers/CoinPaprikaPriceProvider.d.ts +25 -25
- package/dist/prices/providers/CoinPaprikaPriceProvider.js +29 -29
- package/dist/prices/providers/CustomPriceProvider.d.ts +24 -24
- package/dist/prices/providers/CustomPriceProvider.js +35 -35
- package/dist/prices/providers/KrakenPriceProvider.d.ts +38 -38
- package/dist/prices/providers/KrakenPriceProvider.js +45 -45
- package/dist/prices/providers/OKXPriceProvider.d.ts +34 -34
- package/dist/prices/providers/OKXPriceProvider.js +29 -29
- package/dist/prices/providers/abstract/ExchangePriceProvider.d.ts +17 -17
- package/dist/prices/providers/abstract/ExchangePriceProvider.js +21 -21
- package/dist/prices/providers/abstract/HttpPriceProvider.d.ts +7 -7
- package/dist/prices/providers/abstract/HttpPriceProvider.js +12 -12
- package/dist/storage/IUnifiedStorage.d.ts +85 -85
- package/dist/storage/IUnifiedStorage.js +2 -2
- package/dist/storage/UnifiedSwapStorage.d.ts +114 -114
- package/dist/storage/UnifiedSwapStorage.js +116 -116
- package/dist/storage-browser/IndexedDBUnifiedStorage.d.ts +63 -63
- package/dist/storage-browser/IndexedDBUnifiedStorage.js +298 -298
- package/dist/storage-browser/LocalStorageManager.d.ts +49 -49
- package/dist/storage-browser/LocalStorageManager.js +93 -93
- package/dist/swapper/Swapper.d.ts +686 -687
- package/dist/swapper/Swapper.js +1603 -1603
- package/dist/swapper/SwapperFactory.d.ts +135 -135
- package/dist/swapper/SwapperFactory.js +162 -162
- package/dist/swapper/SwapperUtils.d.ts +200 -200
- package/dist/swapper/SwapperUtils.js +467 -467
- package/dist/swapper/SwapperWithChain.d.ts +404 -404
- package/dist/swapper/SwapperWithChain.js +469 -469
- package/dist/swapper/SwapperWithSigner.d.ts +322 -322
- package/dist/swapper/SwapperWithSigner.js +318 -318
- package/dist/swaps/IAddressSwap.d.ts +22 -22
- package/dist/swaps/IAddressSwap.js +13 -14
- package/dist/swaps/IBTCWalletSwap.d.ts +73 -73
- package/dist/swaps/IBTCWalletSwap.js +17 -18
- package/dist/swaps/IClaimableSwap.d.ts +49 -49
- package/dist/swaps/IClaimableSwap.js +14 -15
- package/dist/swaps/IClaimableSwapWrapper.d.ts +15 -15
- package/dist/swaps/IClaimableSwapWrapper.js +2 -2
- package/dist/swaps/IRefundableSwap.d.ts +43 -43
- package/dist/swaps/IRefundableSwap.js +13 -14
- package/dist/swaps/ISwap.d.ts +386 -387
- package/dist/swaps/ISwap.js +346 -341
- package/dist/swaps/ISwapWithGasDrop.d.ts +21 -21
- package/dist/swaps/ISwapWithGasDrop.js +11 -12
- package/dist/swaps/ISwapWrapper.d.ts +283 -284
- package/dist/swaps/ISwapWrapper.js +353 -353
- package/dist/swaps/escrow_swaps/IEscrowSelfInitSwap.d.ts +98 -98
- package/dist/swaps/escrow_swaps/IEscrowSelfInitSwap.js +126 -126
- package/dist/swaps/escrow_swaps/IEscrowSwap.d.ts +133 -135
- package/dist/swaps/escrow_swaps/IEscrowSwap.js +169 -169
- package/dist/swaps/escrow_swaps/IEscrowSwapWrapper.d.ts +114 -115
- package/dist/swaps/escrow_swaps/IEscrowSwapWrapper.js +134 -134
- package/dist/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.d.ts +98 -101
- package/dist/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.js +130 -130
- package/dist/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.d.ts +162 -162
- package/dist/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.js +190 -190
- package/dist/swaps/escrow_swaps/frombtc/IFromBTCWrapper.d.ts +58 -58
- package/dist/swaps/escrow_swaps/frombtc/IFromBTCWrapper.js +78 -78
- package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.d.ts +529 -531
- package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.js +1285 -1285
- package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.d.ts +181 -184
- package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.js +418 -417
- package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.d.ts +581 -583
- package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.js +1371 -1371
- package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.d.ts +225 -228
- package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.js +506 -506
- package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.d.ts +458 -458
- package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.js +1126 -1126
- package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.d.ts +190 -191
- package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.js +378 -377
- package/dist/swaps/escrow_swaps/tobtc/IToBTCSwap.d.ts +403 -403
- package/dist/swaps/escrow_swaps/tobtc/IToBTCSwap.js +924 -924
- package/dist/swaps/escrow_swaps/tobtc/IToBTCWrapper.d.ts +62 -62
- package/dist/swaps/escrow_swaps/tobtc/IToBTCWrapper.js +112 -112
- package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.d.ts +125 -127
- package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.js +256 -256
- package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.d.ts +241 -242
- package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.js +520 -520
- package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.d.ts +73 -73
- package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.js +155 -155
- package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.d.ts +127 -128
- package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.js +278 -278
- package/dist/swaps/spv_swaps/SpvFromBTCSwap.d.ts +630 -630
- package/dist/swaps/spv_swaps/SpvFromBTCSwap.js +1443 -1443
- package/dist/swaps/spv_swaps/SpvFromBTCWrapper.d.ts +213 -207
- package/dist/swaps/spv_swaps/SpvFromBTCWrapper.js +756 -755
- package/dist/swaps/trusted/ln/LnForGasSwap.d.ts +261 -261
- package/dist/swaps/trusted/ln/LnForGasSwap.js +511 -511
- package/dist/swaps/trusted/ln/LnForGasWrapper.d.ts +40 -40
- package/dist/swaps/trusted/ln/LnForGasWrapper.js +82 -82
- package/dist/swaps/trusted/onchain/OnchainForGasSwap.d.ts +342 -342
- package/dist/swaps/trusted/onchain/OnchainForGasSwap.js +715 -715
- package/dist/swaps/trusted/onchain/OnchainForGasWrapper.d.ts +68 -69
- package/dist/swaps/trusted/onchain/OnchainForGasWrapper.js +92 -92
- package/dist/types/AmountData.d.ts +10 -10
- package/dist/types/AmountData.js +2 -2
- package/dist/types/CustomPriceFunction.d.ts +11 -11
- package/dist/types/CustomPriceFunction.js +2 -2
- package/dist/types/PriceInfoType.d.ts +28 -28
- package/dist/types/PriceInfoType.js +56 -57
- package/dist/types/SwapExecutionAction.d.ts +88 -88
- package/dist/types/SwapExecutionAction.js +2 -2
- package/dist/types/SwapStateInfo.d.ts +5 -5
- package/dist/types/SwapStateInfo.js +2 -2
- package/dist/types/SwapWithSigner.d.ts +17 -17
- package/dist/types/SwapWithSigner.js +42 -43
- package/dist/types/Token.d.ts +99 -99
- package/dist/types/Token.js +76 -76
- package/dist/types/TokenAmount.d.ts +69 -69
- package/dist/types/TokenAmount.js +59 -60
- package/dist/types/fees/Fee.d.ts +50 -50
- package/dist/types/fees/Fee.js +2 -2
- package/dist/types/fees/FeeBreakdown.d.ts +11 -11
- package/dist/types/fees/FeeBreakdown.js +2 -2
- package/dist/types/fees/PercentagePPM.d.ts +17 -17
- package/dist/types/fees/PercentagePPM.js +17 -18
- package/dist/types/lnurl/LNURLPay.d.ts +61 -61
- package/dist/types/lnurl/LNURLPay.js +30 -31
- package/dist/types/lnurl/LNURLWithdraw.d.ts +48 -48
- package/dist/types/lnurl/LNURLWithdraw.js +26 -27
- package/dist/types/wallets/LightningInvoiceCreateService.d.ts +24 -24
- package/dist/types/wallets/LightningInvoiceCreateService.js +14 -15
- package/dist/types/wallets/MinimalBitcoinWalletInterface.d.ts +23 -23
- package/dist/types/wallets/MinimalBitcoinWalletInterface.js +2 -2
- package/dist/types/wallets/MinimalLightningNetworkWalletInterface.d.ts +9 -9
- package/dist/types/wallets/MinimalLightningNetworkWalletInterface.js +2 -2
- package/dist/utils/AutomaticClockDriftCorrection.d.ts +1 -1
- package/dist/utils/AutomaticClockDriftCorrection.js +69 -70
- package/dist/utils/BitcoinUtils.d.ts +12 -14
- package/dist/utils/BitcoinUtils.js +101 -102
- package/dist/utils/BitcoinWalletUtils.d.ts +7 -7
- package/dist/utils/BitcoinWalletUtils.js +13 -14
- package/dist/utils/Logger.d.ts +7 -7
- package/dist/utils/Logger.js +11 -12
- package/dist/utils/RetryUtils.d.ts +22 -22
- package/dist/utils/RetryUtils.js +66 -67
- package/dist/utils/SwapUtils.d.ts +88 -88
- package/dist/utils/SwapUtils.js +72 -72
- package/dist/utils/TimeoutUtils.d.ts +17 -17
- package/dist/utils/TimeoutUtils.js +54 -55
- package/dist/utils/TokenUtils.d.ts +19 -19
- package/dist/utils/TokenUtils.js +36 -37
- package/dist/utils/TypeUtils.d.ts +7 -7
- package/dist/utils/TypeUtils.js +2 -2
- package/dist/utils/Utils.d.ts +56 -58
- package/dist/utils/Utils.js +193 -194
- package/package.json +1 -1
- package/src/intermediaries/apis/IntermediaryAPI.ts +4 -2
- package/src/prices/abstract/ISwapPrice.ts +19 -6
- package/src/swaps/ISwap.ts +17 -6
- package/src/swaps/ISwapWrapper.ts +4 -3
- package/src/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.ts +4 -2
- package/src/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.ts +4 -1
- package/src/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.ts +2 -2
- package/src/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.ts +4 -2
- package/src/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.ts +6 -6
- package/src/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.ts +5 -5
- package/src/swaps/spv_swaps/SpvFromBTCSwap.ts +4 -1
- package/src/swaps/spv_swaps/SpvFromBTCWrapper.ts +10 -2
- package/src/swaps/trusted/ln/LnForGasWrapper.ts +1 -1
- package/src/swaps/trusted/onchain/OnchainForGasWrapper.ts +1 -1
|
@@ -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
|
+
}
|