@atomiqlabs/lp-lib 14.0.0-dev.13 → 14.0.0-dev.16
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/LICENSE +201 -201
- package/dist/fees/IBtcFeeEstimator.d.ts +3 -3
- package/dist/fees/IBtcFeeEstimator.js +2 -2
- package/dist/index.d.ts +42 -42
- package/dist/index.js +58 -58
- package/dist/info/InfoHandler.d.ts +17 -17
- package/dist/info/InfoHandler.js +61 -61
- package/dist/plugins/IPlugin.d.ts +143 -143
- package/dist/plugins/IPlugin.js +34 -34
- package/dist/plugins/PluginManager.d.ts +112 -112
- package/dist/plugins/PluginManager.js +259 -259
- package/dist/prices/BinanceSwapPrice.d.ts +26 -26
- package/dist/prices/BinanceSwapPrice.js +92 -92
- package/dist/prices/CoinGeckoSwapPrice.d.ts +30 -30
- package/dist/prices/CoinGeckoSwapPrice.js +64 -64
- package/dist/prices/ISwapPrice.d.ts +43 -43
- package/dist/prices/ISwapPrice.js +55 -55
- package/dist/prices/OKXSwapPrice.d.ts +26 -26
- package/dist/prices/OKXSwapPrice.js +92 -92
- package/dist/storage/IIntermediaryStorage.d.ts +18 -18
- package/dist/storage/IIntermediaryStorage.js +2 -2
- package/dist/storagemanager/IntermediaryStorageManager.d.ts +19 -19
- package/dist/storagemanager/IntermediaryStorageManager.js +111 -111
- package/dist/storagemanager/StorageManager.d.ts +13 -13
- package/dist/storagemanager/StorageManager.js +64 -64
- package/dist/swaps/SwapHandler.d.ts +153 -153
- package/dist/swaps/SwapHandler.js +160 -160
- package/dist/swaps/SwapHandlerSwap.d.ts +79 -79
- package/dist/swaps/SwapHandlerSwap.js +78 -78
- package/dist/swaps/assertions/AmountAssertions.d.ts +28 -28
- package/dist/swaps/assertions/AmountAssertions.js +72 -72
- package/dist/swaps/assertions/FromBtcAmountAssertions.d.ts +76 -76
- package/dist/swaps/assertions/FromBtcAmountAssertions.js +180 -172
- package/dist/swaps/assertions/LightningAssertions.d.ts +44 -44
- package/dist/swaps/assertions/LightningAssertions.js +86 -86
- package/dist/swaps/assertions/ToBtcAmountAssertions.d.ts +53 -53
- package/dist/swaps/assertions/ToBtcAmountAssertions.js +150 -150
- package/dist/swaps/escrow/EscrowHandler.d.ts +51 -51
- package/dist/swaps/escrow/EscrowHandler.js +158 -158
- package/dist/swaps/escrow/EscrowHandlerSwap.d.ts +35 -35
- package/dist/swaps/escrow/EscrowHandlerSwap.js +69 -69
- package/dist/swaps/escrow/FromBtcBaseSwap.d.ts +14 -14
- package/dist/swaps/escrow/FromBtcBaseSwap.js +32 -32
- package/dist/swaps/escrow/FromBtcBaseSwapHandler.d.ts +102 -102
- package/dist/swaps/escrow/FromBtcBaseSwapHandler.js +210 -210
- package/dist/swaps/escrow/ToBtcBaseSwap.d.ts +36 -36
- package/dist/swaps/escrow/ToBtcBaseSwap.js +67 -67
- package/dist/swaps/escrow/ToBtcBaseSwapHandler.d.ts +53 -53
- package/dist/swaps/escrow/ToBtcBaseSwapHandler.js +81 -81
- package/dist/swaps/escrow/frombtc_abstract/FromBtcAbs.d.ts +83 -83
- package/dist/swaps/escrow/frombtc_abstract/FromBtcAbs.js +318 -318
- package/dist/swaps/escrow/frombtc_abstract/FromBtcSwapAbs.d.ts +21 -21
- package/dist/swaps/escrow/frombtc_abstract/FromBtcSwapAbs.js +50 -50
- package/dist/swaps/escrow/frombtcln_abstract/FromBtcLnAbs.d.ts +107 -107
- package/dist/swaps/escrow/frombtcln_abstract/FromBtcLnAbs.js +675 -675
- package/dist/swaps/escrow/frombtcln_abstract/FromBtcLnSwapAbs.d.ts +33 -33
- package/dist/swaps/escrow/frombtcln_abstract/FromBtcLnSwapAbs.js +91 -91
- package/dist/swaps/escrow/frombtcln_autoinit/FromBtcLnAuto.d.ts +104 -104
- package/dist/swaps/escrow/frombtcln_autoinit/FromBtcLnAuto.js +659 -659
- package/dist/swaps/escrow/frombtcln_autoinit/FromBtcLnAutoSwap.d.ts +55 -55
- package/dist/swaps/escrow/frombtcln_autoinit/FromBtcLnAutoSwap.js +120 -120
- package/dist/swaps/escrow/tobtc_abstract/ToBtcAbs.d.ts +171 -171
- package/dist/swaps/escrow/tobtc_abstract/ToBtcAbs.js +706 -706
- package/dist/swaps/escrow/tobtc_abstract/ToBtcSwapAbs.d.ts +26 -26
- package/dist/swaps/escrow/tobtc_abstract/ToBtcSwapAbs.js +62 -62
- package/dist/swaps/escrow/tobtcln_abstract/ToBtcLnAbs.d.ts +177 -177
- package/dist/swaps/escrow/tobtcln_abstract/ToBtcLnAbs.js +861 -861
- package/dist/swaps/escrow/tobtcln_abstract/ToBtcLnSwapAbs.d.ts +23 -23
- package/dist/swaps/escrow/tobtcln_abstract/ToBtcLnSwapAbs.js +56 -56
- package/dist/swaps/spv_vault_swap/SpvVault.d.ts +41 -41
- package/dist/swaps/spv_vault_swap/SpvVault.js +111 -111
- package/dist/swaps/spv_vault_swap/SpvVaultSwap.d.ts +67 -67
- package/dist/swaps/spv_vault_swap/SpvVaultSwap.js +158 -158
- package/dist/swaps/spv_vault_swap/SpvVaultSwapHandler.d.ts +68 -68
- package/dist/swaps/spv_vault_swap/SpvVaultSwapHandler.js +491 -491
- package/dist/swaps/spv_vault_swap/SpvVaults.d.ts +52 -52
- package/dist/swaps/spv_vault_swap/SpvVaults.js +364 -364
- package/dist/swaps/trusted/frombtc_trusted/FromBtcTrusted.d.ts +51 -51
- package/dist/swaps/trusted/frombtc_trusted/FromBtcTrusted.js +650 -650
- package/dist/swaps/trusted/frombtc_trusted/FromBtcTrustedSwap.d.ts +52 -52
- package/dist/swaps/trusted/frombtc_trusted/FromBtcTrustedSwap.js +118 -118
- package/dist/swaps/trusted/frombtcln_trusted/FromBtcLnTrusted.d.ts +76 -76
- package/dist/swaps/trusted/frombtcln_trusted/FromBtcLnTrusted.js +494 -494
- package/dist/swaps/trusted/frombtcln_trusted/FromBtcLnTrustedSwap.d.ts +34 -34
- package/dist/swaps/trusted/frombtcln_trusted/FromBtcLnTrustedSwap.js +81 -81
- package/dist/utils/Utils.d.ts +29 -29
- package/dist/utils/Utils.js +89 -89
- package/dist/utils/paramcoders/IParamReader.d.ts +5 -5
- package/dist/utils/paramcoders/IParamReader.js +2 -2
- package/dist/utils/paramcoders/IParamWriter.d.ts +4 -4
- package/dist/utils/paramcoders/IParamWriter.js +2 -2
- package/dist/utils/paramcoders/LegacyParamEncoder.d.ts +10 -10
- package/dist/utils/paramcoders/LegacyParamEncoder.js +22 -22
- package/dist/utils/paramcoders/ParamDecoder.d.ts +25 -25
- package/dist/utils/paramcoders/ParamDecoder.js +222 -222
- package/dist/utils/paramcoders/ParamEncoder.d.ts +9 -9
- package/dist/utils/paramcoders/ParamEncoder.js +22 -22
- package/dist/utils/paramcoders/SchemaVerifier.d.ts +21 -21
- package/dist/utils/paramcoders/SchemaVerifier.js +84 -84
- package/dist/utils/paramcoders/server/ServerParamDecoder.d.ts +8 -8
- package/dist/utils/paramcoders/server/ServerParamDecoder.js +107 -107
- package/dist/utils/paramcoders/server/ServerParamEncoder.d.ts +11 -11
- package/dist/utils/paramcoders/server/ServerParamEncoder.js +65 -65
- package/dist/wallets/IBitcoinWallet.d.ts +67 -67
- package/dist/wallets/IBitcoinWallet.js +2 -2
- package/dist/wallets/ILightningWallet.d.ts +117 -117
- package/dist/wallets/ILightningWallet.js +37 -37
- package/dist/wallets/ISpvVaultSigner.d.ts +7 -7
- package/dist/wallets/ISpvVaultSigner.js +2 -2
- package/package.json +36 -36
- package/src/fees/IBtcFeeEstimator.ts +6 -6
- package/src/index.ts +53 -53
- package/src/info/InfoHandler.ts +106 -106
- package/src/plugins/IPlugin.ts +168 -168
- package/src/plugins/PluginManager.ts +336 -336
- package/src/prices/BinanceSwapPrice.ts +113 -113
- package/src/prices/CoinGeckoSwapPrice.ts +87 -87
- package/src/prices/ISwapPrice.ts +88 -88
- package/src/prices/OKXSwapPrice.ts +113 -113
- package/src/storage/IIntermediaryStorage.ts +19 -19
- package/src/storagemanager/IntermediaryStorageManager.ts +118 -118
- package/src/storagemanager/StorageManager.ts +78 -78
- package/src/swaps/SwapHandler.ts +277 -277
- package/src/swaps/SwapHandlerSwap.ts +141 -141
- package/src/swaps/assertions/AmountAssertions.ts +76 -76
- package/src/swaps/assertions/FromBtcAmountAssertions.ts +246 -238
- package/src/swaps/assertions/LightningAssertions.ts +103 -103
- package/src/swaps/assertions/ToBtcAmountAssertions.ts +203 -203
- package/src/swaps/escrow/EscrowHandler.ts +179 -179
- package/src/swaps/escrow/EscrowHandlerSwap.ts +86 -86
- package/src/swaps/escrow/FromBtcBaseSwap.ts +38 -38
- package/src/swaps/escrow/FromBtcBaseSwapHandler.ts +286 -286
- package/src/swaps/escrow/ToBtcBaseSwap.ts +85 -85
- package/src/swaps/escrow/ToBtcBaseSwapHandler.ts +129 -129
- package/src/swaps/escrow/frombtc_abstract/FromBtcAbs.ts +452 -452
- package/src/swaps/escrow/frombtc_abstract/FromBtcSwapAbs.ts +61 -61
- package/src/swaps/escrow/frombtcln_abstract/FromBtcLnAbs.ts +856 -856
- package/src/swaps/escrow/frombtcln_abstract/FromBtcLnSwapAbs.ts +141 -141
- package/src/swaps/escrow/frombtcln_autoinit/FromBtcLnAuto.ts +822 -822
- package/src/swaps/escrow/frombtcln_autoinit/FromBtcLnAutoSwap.ts +196 -196
- package/src/swaps/escrow/tobtc_abstract/ToBtcAbs.ts +879 -879
- package/src/swaps/escrow/tobtc_abstract/ToBtcSwapAbs.ts +102 -102
- package/src/swaps/escrow/tobtcln_abstract/ToBtcLnAbs.ts +1110 -1110
- package/src/swaps/escrow/tobtcln_abstract/ToBtcLnSwapAbs.ts +77 -77
- package/src/swaps/spv_vault_swap/SpvVault.ts +143 -143
- package/src/swaps/spv_vault_swap/SpvVaultSwap.ts +225 -225
- package/src/swaps/spv_vault_swap/SpvVaultSwapHandler.ts +627 -627
- package/src/swaps/spv_vault_swap/SpvVaults.ts +435 -435
- package/src/swaps/trusted/frombtc_trusted/FromBtcTrusted.ts +747 -747
- package/src/swaps/trusted/frombtc_trusted/FromBtcTrustedSwap.ts +185 -185
- package/src/swaps/trusted/frombtcln_trusted/FromBtcLnTrusted.ts +590 -590
- package/src/swaps/trusted/frombtcln_trusted/FromBtcLnTrustedSwap.ts +121 -121
- package/src/utils/Utils.ts +104 -104
- package/src/utils/paramcoders/IParamReader.ts +7 -7
- package/src/utils/paramcoders/IParamWriter.ts +8 -8
- package/src/utils/paramcoders/LegacyParamEncoder.ts +27 -27
- package/src/utils/paramcoders/ParamDecoder.ts +218 -218
- package/src/utils/paramcoders/ParamEncoder.ts +29 -29
- package/src/utils/paramcoders/SchemaVerifier.ts +96 -96
- package/src/utils/paramcoders/server/ServerParamDecoder.ts +118 -118
- package/src/utils/paramcoders/server/ServerParamEncoder.ts +75 -75
- package/src/wallets/IBitcoinWallet.ts +68 -68
- package/src/wallets/ILightningWallet.ts +178 -178
- package/src/wallets/ISpvVaultSigner.ts +10 -10
|
@@ -1,171 +1,171 @@
|
|
|
1
|
-
import { Express } from "express";
|
|
2
|
-
import { ToBtcSwapAbs, ToBtcSwapState } from "./ToBtcSwapAbs";
|
|
3
|
-
import { MultichainData, SwapHandlerType } from "../../SwapHandler";
|
|
4
|
-
import { ISwapPrice } from "../../../prices/ISwapPrice";
|
|
5
|
-
import { BtcTx, ChainSwapType, ClaimEvent, InitializeEvent, RefundEvent, SwapData, BitcoinRpc, BtcBlock } from "@atomiqlabs/base";
|
|
6
|
-
import { IIntermediaryStorage } from "../../../storage/IIntermediaryStorage";
|
|
7
|
-
import { ToBtcBaseConfig, ToBtcBaseSwapHandler } from "../ToBtcBaseSwapHandler";
|
|
8
|
-
import { PromiseQueue } from "promise-queue-ts";
|
|
9
|
-
import { IBitcoinWallet } from "../../../wallets/IBitcoinWallet";
|
|
10
|
-
export type ToBtcConfig = ToBtcBaseConfig & {
|
|
11
|
-
sendSafetyFactor: bigint;
|
|
12
|
-
minChainCltv: bigint;
|
|
13
|
-
networkFeeMultiplier: number;
|
|
14
|
-
minConfirmations: number;
|
|
15
|
-
maxConfirmations: number;
|
|
16
|
-
maxConfTarget: number;
|
|
17
|
-
minConfTarget: number;
|
|
18
|
-
txCheckInterval: number;
|
|
19
|
-
};
|
|
20
|
-
export type ToBtcRequestType = {
|
|
21
|
-
address: string;
|
|
22
|
-
amount: bigint;
|
|
23
|
-
confirmationTarget: number;
|
|
24
|
-
confirmations: number;
|
|
25
|
-
nonce: bigint;
|
|
26
|
-
token: string;
|
|
27
|
-
offerer: string;
|
|
28
|
-
exactIn?: boolean;
|
|
29
|
-
};
|
|
30
|
-
/**
|
|
31
|
-
* Handler for to BTC swaps, utilizing PTLCs (proof-time locked contracts) using btc relay (on-chain bitcoin SPV)
|
|
32
|
-
*/
|
|
33
|
-
export declare class ToBtcAbs extends ToBtcBaseSwapHandler<ToBtcSwapAbs, ToBtcSwapState> {
|
|
34
|
-
readonly type = SwapHandlerType.TO_BTC;
|
|
35
|
-
readonly swapType = ChainSwapType.CHAIN_NONCED;
|
|
36
|
-
activeSubscriptions: {
|
|
37
|
-
[txId: string]: ToBtcSwapAbs;
|
|
38
|
-
};
|
|
39
|
-
bitcoinRpc: BitcoinRpc<BtcBlock>;
|
|
40
|
-
bitcoin: IBitcoinWallet;
|
|
41
|
-
sendBtcQueue: PromiseQueue;
|
|
42
|
-
readonly config: ToBtcConfig;
|
|
43
|
-
constructor(storageDirectory: IIntermediaryStorage<ToBtcSwapAbs>, path: string, chainData: MultichainData, bitcoin: IBitcoinWallet, swapPricing: ISwapPrice, bitcoinRpc: BitcoinRpc<BtcBlock>, config: ToBtcConfig);
|
|
44
|
-
/**
|
|
45
|
-
* Returns the payment hash of the swap, takes swap nonce into account. Payment hash is chain-specific.
|
|
46
|
-
*
|
|
47
|
-
* @param chainIdentifier
|
|
48
|
-
* @param address
|
|
49
|
-
* @param confirmations
|
|
50
|
-
* @param nonce
|
|
51
|
-
* @param amount
|
|
52
|
-
*/
|
|
53
|
-
private getHash;
|
|
54
|
-
/**
|
|
55
|
-
* Tries to claim the swap after our transaction was confirmed
|
|
56
|
-
*
|
|
57
|
-
* @param tx
|
|
58
|
-
* @param swap
|
|
59
|
-
* @param vout
|
|
60
|
-
*/
|
|
61
|
-
private tryClaimSwap;
|
|
62
|
-
protected processPastSwap(swap: ToBtcSwapAbs): Promise<void>;
|
|
63
|
-
/**
|
|
64
|
-
* Checks past swaps, deletes ones that are already expired.
|
|
65
|
-
*/
|
|
66
|
-
protected processPastSwaps(): Promise<void>;
|
|
67
|
-
protected processBtcTx(swap: ToBtcSwapAbs, tx: BtcTx): Promise<boolean>;
|
|
68
|
-
/**
|
|
69
|
-
* Checks active sent out bitcoin transactions
|
|
70
|
-
*/
|
|
71
|
-
private processBtcTxs;
|
|
72
|
-
/**
|
|
73
|
-
* Subscribes to and periodically checks txId used to send out funds for the swap for enough confirmations
|
|
74
|
-
*
|
|
75
|
-
* @param payment
|
|
76
|
-
*/
|
|
77
|
-
protected subscribeToPayment(payment: ToBtcSwapAbs): void;
|
|
78
|
-
protected unsubscribePayment(payment: ToBtcSwapAbs): void;
|
|
79
|
-
/**
|
|
80
|
-
* Checks if expiry time on the swap leaves us enough room to send a transaction and for the transaction to confirm
|
|
81
|
-
*
|
|
82
|
-
* @param swap
|
|
83
|
-
* @private
|
|
84
|
-
* @throws DefinedRuntimeError will throw an error in case there isn't enough time for us to send a BTC payout tx
|
|
85
|
-
*/
|
|
86
|
-
protected checkExpiresTooSoon(swap: ToBtcSwapAbs): void;
|
|
87
|
-
/**
|
|
88
|
-
* Checks if the actual fee for the swap is no higher than the quoted estimate
|
|
89
|
-
*
|
|
90
|
-
* @param quotedSatsPerVbyte
|
|
91
|
-
* @param actualSatsPerVbyte
|
|
92
|
-
* @private
|
|
93
|
-
* @throws DefinedRuntimeError will throw an error in case the actual fee is higher than quoted fee
|
|
94
|
-
*/
|
|
95
|
-
protected checkCalculatedTxFee(quotedSatsPerVbyte: bigint, actualSatsPerVbyte: bigint): void;
|
|
96
|
-
/**
|
|
97
|
-
* Sends a bitcoin transaction to payout BTC for a swap
|
|
98
|
-
*
|
|
99
|
-
* @param swap
|
|
100
|
-
* @private
|
|
101
|
-
* @throws DefinedRuntimeError will throw an error in case the payment cannot be initiated
|
|
102
|
-
*/
|
|
103
|
-
private sendBitcoinPayment;
|
|
104
|
-
/**
|
|
105
|
-
* Called after swap was successfully committed, will check if bitcoin tx is already sent, if not tries to send it and subscribes to it
|
|
106
|
-
*
|
|
107
|
-
* @param swap
|
|
108
|
-
*/
|
|
109
|
-
private processInitialized;
|
|
110
|
-
protected processInitializeEvent(chainIdentifier: string, swap: ToBtcSwapAbs, event: InitializeEvent<SwapData>): Promise<void>;
|
|
111
|
-
protected processClaimEvent(chainIdentifier: string, swap: ToBtcSwapAbs, event: ClaimEvent<SwapData>): Promise<void>;
|
|
112
|
-
protected processRefundEvent(chainIdentifier: string, swap: ToBtcSwapAbs, event: RefundEvent<SwapData>): Promise<void>;
|
|
113
|
-
/**
|
|
114
|
-
* Returns required expiry delta for swap params
|
|
115
|
-
*
|
|
116
|
-
* @param confirmationTarget
|
|
117
|
-
* @param confirmations
|
|
118
|
-
*/
|
|
119
|
-
protected getExpiryFromCLTV(confirmationTarget: number, confirmations: number): bigint;
|
|
120
|
-
/**
|
|
121
|
-
* Checks if the requested nonce is valid
|
|
122
|
-
*
|
|
123
|
-
* @param nonce
|
|
124
|
-
* @throws {DefinedRuntimeError} will throw an error if the nonce is invalid
|
|
125
|
-
*/
|
|
126
|
-
private checkNonceValid;
|
|
127
|
-
/**
|
|
128
|
-
* Checks if confirmation target is within configured bounds
|
|
129
|
-
*
|
|
130
|
-
* @param confirmationTarget
|
|
131
|
-
* @throws {DefinedRuntimeError} will throw an error if the confirmationTarget is out of bounds
|
|
132
|
-
*/
|
|
133
|
-
protected checkConfirmationTarget(confirmationTarget: number): void;
|
|
134
|
-
/**
|
|
135
|
-
* Checks if the required confirmations are within configured bounds
|
|
136
|
-
*
|
|
137
|
-
* @param confirmations
|
|
138
|
-
* @throws {DefinedRuntimeError} will throw an error if the confirmations are out of bounds
|
|
139
|
-
*/
|
|
140
|
-
protected checkRequiredConfirmations(confirmations: number): void;
|
|
141
|
-
/**
|
|
142
|
-
* Checks the validity of the provided address, also checks if the resulting output script isn't too large
|
|
143
|
-
*
|
|
144
|
-
* @param address
|
|
145
|
-
* @throws {DefinedRuntimeError} will throw an error if the address is invalid
|
|
146
|
-
*/
|
|
147
|
-
protected checkAddress(address: string): void;
|
|
148
|
-
/**
|
|
149
|
-
* Checks if the swap is expired, taking into consideration on-chain time skew
|
|
150
|
-
*
|
|
151
|
-
* @param swap
|
|
152
|
-
* @throws {DefinedRuntimeError} will throw an error if the swap is expired
|
|
153
|
-
*/
|
|
154
|
-
protected checkExpired(swap: ToBtcSwapAbs): Promise<void>;
|
|
155
|
-
/**
|
|
156
|
-
* Checks & returns the network fee needed for a transaction
|
|
157
|
-
*
|
|
158
|
-
* @param address
|
|
159
|
-
* @param amount
|
|
160
|
-
* @throws {DefinedRuntimeError} will throw an error if there are not enough BTC funds
|
|
161
|
-
*/
|
|
162
|
-
private checkAndGetNetworkFee;
|
|
163
|
-
startRestServer(restServer: Express): void;
|
|
164
|
-
/**
|
|
165
|
-
* Starts watchdog checking sent bitcoin transactions
|
|
166
|
-
*/
|
|
167
|
-
protected startTxTimer(): Promise<void>;
|
|
168
|
-
startWatchdog(): Promise<void>;
|
|
169
|
-
init(): Promise<void>;
|
|
170
|
-
getInfoData(): any;
|
|
171
|
-
}
|
|
1
|
+
import { Express } from "express";
|
|
2
|
+
import { ToBtcSwapAbs, ToBtcSwapState } from "./ToBtcSwapAbs";
|
|
3
|
+
import { MultichainData, SwapHandlerType } from "../../SwapHandler";
|
|
4
|
+
import { ISwapPrice } from "../../../prices/ISwapPrice";
|
|
5
|
+
import { BtcTx, ChainSwapType, ClaimEvent, InitializeEvent, RefundEvent, SwapData, BitcoinRpc, BtcBlock } from "@atomiqlabs/base";
|
|
6
|
+
import { IIntermediaryStorage } from "../../../storage/IIntermediaryStorage";
|
|
7
|
+
import { ToBtcBaseConfig, ToBtcBaseSwapHandler } from "../ToBtcBaseSwapHandler";
|
|
8
|
+
import { PromiseQueue } from "promise-queue-ts";
|
|
9
|
+
import { IBitcoinWallet } from "../../../wallets/IBitcoinWallet";
|
|
10
|
+
export type ToBtcConfig = ToBtcBaseConfig & {
|
|
11
|
+
sendSafetyFactor: bigint;
|
|
12
|
+
minChainCltv: bigint;
|
|
13
|
+
networkFeeMultiplier: number;
|
|
14
|
+
minConfirmations: number;
|
|
15
|
+
maxConfirmations: number;
|
|
16
|
+
maxConfTarget: number;
|
|
17
|
+
minConfTarget: number;
|
|
18
|
+
txCheckInterval: number;
|
|
19
|
+
};
|
|
20
|
+
export type ToBtcRequestType = {
|
|
21
|
+
address: string;
|
|
22
|
+
amount: bigint;
|
|
23
|
+
confirmationTarget: number;
|
|
24
|
+
confirmations: number;
|
|
25
|
+
nonce: bigint;
|
|
26
|
+
token: string;
|
|
27
|
+
offerer: string;
|
|
28
|
+
exactIn?: boolean;
|
|
29
|
+
};
|
|
30
|
+
/**
|
|
31
|
+
* Handler for to BTC swaps, utilizing PTLCs (proof-time locked contracts) using btc relay (on-chain bitcoin SPV)
|
|
32
|
+
*/
|
|
33
|
+
export declare class ToBtcAbs extends ToBtcBaseSwapHandler<ToBtcSwapAbs, ToBtcSwapState> {
|
|
34
|
+
readonly type = SwapHandlerType.TO_BTC;
|
|
35
|
+
readonly swapType = ChainSwapType.CHAIN_NONCED;
|
|
36
|
+
activeSubscriptions: {
|
|
37
|
+
[txId: string]: ToBtcSwapAbs;
|
|
38
|
+
};
|
|
39
|
+
bitcoinRpc: BitcoinRpc<BtcBlock>;
|
|
40
|
+
bitcoin: IBitcoinWallet;
|
|
41
|
+
sendBtcQueue: PromiseQueue;
|
|
42
|
+
readonly config: ToBtcConfig;
|
|
43
|
+
constructor(storageDirectory: IIntermediaryStorage<ToBtcSwapAbs>, path: string, chainData: MultichainData, bitcoin: IBitcoinWallet, swapPricing: ISwapPrice, bitcoinRpc: BitcoinRpc<BtcBlock>, config: ToBtcConfig);
|
|
44
|
+
/**
|
|
45
|
+
* Returns the payment hash of the swap, takes swap nonce into account. Payment hash is chain-specific.
|
|
46
|
+
*
|
|
47
|
+
* @param chainIdentifier
|
|
48
|
+
* @param address
|
|
49
|
+
* @param confirmations
|
|
50
|
+
* @param nonce
|
|
51
|
+
* @param amount
|
|
52
|
+
*/
|
|
53
|
+
private getHash;
|
|
54
|
+
/**
|
|
55
|
+
* Tries to claim the swap after our transaction was confirmed
|
|
56
|
+
*
|
|
57
|
+
* @param tx
|
|
58
|
+
* @param swap
|
|
59
|
+
* @param vout
|
|
60
|
+
*/
|
|
61
|
+
private tryClaimSwap;
|
|
62
|
+
protected processPastSwap(swap: ToBtcSwapAbs): Promise<void>;
|
|
63
|
+
/**
|
|
64
|
+
* Checks past swaps, deletes ones that are already expired.
|
|
65
|
+
*/
|
|
66
|
+
protected processPastSwaps(): Promise<void>;
|
|
67
|
+
protected processBtcTx(swap: ToBtcSwapAbs, tx: BtcTx): Promise<boolean>;
|
|
68
|
+
/**
|
|
69
|
+
* Checks active sent out bitcoin transactions
|
|
70
|
+
*/
|
|
71
|
+
private processBtcTxs;
|
|
72
|
+
/**
|
|
73
|
+
* Subscribes to and periodically checks txId used to send out funds for the swap for enough confirmations
|
|
74
|
+
*
|
|
75
|
+
* @param payment
|
|
76
|
+
*/
|
|
77
|
+
protected subscribeToPayment(payment: ToBtcSwapAbs): void;
|
|
78
|
+
protected unsubscribePayment(payment: ToBtcSwapAbs): void;
|
|
79
|
+
/**
|
|
80
|
+
* Checks if expiry time on the swap leaves us enough room to send a transaction and for the transaction to confirm
|
|
81
|
+
*
|
|
82
|
+
* @param swap
|
|
83
|
+
* @private
|
|
84
|
+
* @throws DefinedRuntimeError will throw an error in case there isn't enough time for us to send a BTC payout tx
|
|
85
|
+
*/
|
|
86
|
+
protected checkExpiresTooSoon(swap: ToBtcSwapAbs): void;
|
|
87
|
+
/**
|
|
88
|
+
* Checks if the actual fee for the swap is no higher than the quoted estimate
|
|
89
|
+
*
|
|
90
|
+
* @param quotedSatsPerVbyte
|
|
91
|
+
* @param actualSatsPerVbyte
|
|
92
|
+
* @private
|
|
93
|
+
* @throws DefinedRuntimeError will throw an error in case the actual fee is higher than quoted fee
|
|
94
|
+
*/
|
|
95
|
+
protected checkCalculatedTxFee(quotedSatsPerVbyte: bigint, actualSatsPerVbyte: bigint): void;
|
|
96
|
+
/**
|
|
97
|
+
* Sends a bitcoin transaction to payout BTC for a swap
|
|
98
|
+
*
|
|
99
|
+
* @param swap
|
|
100
|
+
* @private
|
|
101
|
+
* @throws DefinedRuntimeError will throw an error in case the payment cannot be initiated
|
|
102
|
+
*/
|
|
103
|
+
private sendBitcoinPayment;
|
|
104
|
+
/**
|
|
105
|
+
* Called after swap was successfully committed, will check if bitcoin tx is already sent, if not tries to send it and subscribes to it
|
|
106
|
+
*
|
|
107
|
+
* @param swap
|
|
108
|
+
*/
|
|
109
|
+
private processInitialized;
|
|
110
|
+
protected processInitializeEvent(chainIdentifier: string, swap: ToBtcSwapAbs, event: InitializeEvent<SwapData>): Promise<void>;
|
|
111
|
+
protected processClaimEvent(chainIdentifier: string, swap: ToBtcSwapAbs, event: ClaimEvent<SwapData>): Promise<void>;
|
|
112
|
+
protected processRefundEvent(chainIdentifier: string, swap: ToBtcSwapAbs, event: RefundEvent<SwapData>): Promise<void>;
|
|
113
|
+
/**
|
|
114
|
+
* Returns required expiry delta for swap params
|
|
115
|
+
*
|
|
116
|
+
* @param confirmationTarget
|
|
117
|
+
* @param confirmations
|
|
118
|
+
*/
|
|
119
|
+
protected getExpiryFromCLTV(confirmationTarget: number, confirmations: number): bigint;
|
|
120
|
+
/**
|
|
121
|
+
* Checks if the requested nonce is valid
|
|
122
|
+
*
|
|
123
|
+
* @param nonce
|
|
124
|
+
* @throws {DefinedRuntimeError} will throw an error if the nonce is invalid
|
|
125
|
+
*/
|
|
126
|
+
private checkNonceValid;
|
|
127
|
+
/**
|
|
128
|
+
* Checks if confirmation target is within configured bounds
|
|
129
|
+
*
|
|
130
|
+
* @param confirmationTarget
|
|
131
|
+
* @throws {DefinedRuntimeError} will throw an error if the confirmationTarget is out of bounds
|
|
132
|
+
*/
|
|
133
|
+
protected checkConfirmationTarget(confirmationTarget: number): void;
|
|
134
|
+
/**
|
|
135
|
+
* Checks if the required confirmations are within configured bounds
|
|
136
|
+
*
|
|
137
|
+
* @param confirmations
|
|
138
|
+
* @throws {DefinedRuntimeError} will throw an error if the confirmations are out of bounds
|
|
139
|
+
*/
|
|
140
|
+
protected checkRequiredConfirmations(confirmations: number): void;
|
|
141
|
+
/**
|
|
142
|
+
* Checks the validity of the provided address, also checks if the resulting output script isn't too large
|
|
143
|
+
*
|
|
144
|
+
* @param address
|
|
145
|
+
* @throws {DefinedRuntimeError} will throw an error if the address is invalid
|
|
146
|
+
*/
|
|
147
|
+
protected checkAddress(address: string): void;
|
|
148
|
+
/**
|
|
149
|
+
* Checks if the swap is expired, taking into consideration on-chain time skew
|
|
150
|
+
*
|
|
151
|
+
* @param swap
|
|
152
|
+
* @throws {DefinedRuntimeError} will throw an error if the swap is expired
|
|
153
|
+
*/
|
|
154
|
+
protected checkExpired(swap: ToBtcSwapAbs): Promise<void>;
|
|
155
|
+
/**
|
|
156
|
+
* Checks & returns the network fee needed for a transaction
|
|
157
|
+
*
|
|
158
|
+
* @param address
|
|
159
|
+
* @param amount
|
|
160
|
+
* @throws {DefinedRuntimeError} will throw an error if there are not enough BTC funds
|
|
161
|
+
*/
|
|
162
|
+
private checkAndGetNetworkFee;
|
|
163
|
+
startRestServer(restServer: Express): void;
|
|
164
|
+
/**
|
|
165
|
+
* Starts watchdog checking sent bitcoin transactions
|
|
166
|
+
*/
|
|
167
|
+
protected startTxTimer(): Promise<void>;
|
|
168
|
+
startWatchdog(): Promise<void>;
|
|
169
|
+
init(): Promise<void>;
|
|
170
|
+
getInfoData(): any;
|
|
171
|
+
}
|