@atomiqlabs/sdk 8.1.7 → 8.3.1

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 (253) hide show
  1. package/dist/bitcoin/wallet/BitcoinWallet.d.ts +41 -5
  2. package/dist/bitcoin/wallet/BitcoinWallet.js +36 -1
  3. package/dist/bitcoin/wallet/IBitcoinWallet.d.ts +52 -2
  4. package/dist/bitcoin/wallet/IBitcoinWallet.js +2 -1
  5. package/dist/bitcoin/wallet/SingleAddressBitcoinWallet.d.ts +42 -7
  6. package/dist/bitcoin/wallet/SingleAddressBitcoinWallet.js +36 -1
  7. package/dist/enums/FeeType.d.ts +7 -0
  8. package/dist/enums/FeeType.js +7 -0
  9. package/dist/enums/SwapAmountType.d.ts +7 -0
  10. package/dist/enums/SwapAmountType.js +7 -0
  11. package/dist/enums/SwapDirection.d.ts +7 -0
  12. package/dist/enums/SwapDirection.js +7 -0
  13. package/dist/enums/SwapType.d.ts +62 -1
  14. package/dist/enums/SwapType.js +62 -1
  15. package/dist/errors/IntermediaryError.d.ts +4 -0
  16. package/dist/errors/IntermediaryError.js +1 -0
  17. package/dist/errors/RequestError.d.ts +15 -1
  18. package/dist/errors/RequestError.js +8 -0
  19. package/dist/errors/UserError.d.ts +1 -0
  20. package/dist/errors/UserError.js +1 -0
  21. package/dist/index.d.ts +4 -5
  22. package/dist/index.js +3 -4
  23. package/dist/intermediaries/Intermediary.d.ts +57 -10
  24. package/dist/intermediaries/Intermediary.js +37 -10
  25. package/dist/intermediaries/IntermediaryDiscovery.d.ts +55 -22
  26. package/dist/intermediaries/IntermediaryDiscovery.js +35 -22
  27. package/dist/prices/RedundantSwapPrice.d.ts +24 -3
  28. package/dist/prices/RedundantSwapPrice.js +21 -1
  29. package/dist/prices/SingleSwapPrice.d.ts +9 -6
  30. package/dist/prices/SingleSwapPrice.js +10 -7
  31. package/dist/prices/SwapPriceWithChain.d.ts +54 -16
  32. package/dist/prices/SwapPriceWithChain.js +58 -20
  33. package/dist/prices/abstract/ISwapPrice.d.ts +94 -45
  34. package/dist/prices/abstract/ISwapPrice.js +103 -55
  35. package/dist/prices/providers/BinancePriceProvider.d.ts +7 -0
  36. package/dist/prices/providers/BinancePriceProvider.js +7 -0
  37. package/dist/prices/providers/CoinGeckoPriceProvider.d.ts +6 -0
  38. package/dist/prices/providers/CoinGeckoPriceProvider.js +6 -0
  39. package/dist/prices/providers/CoinPaprikaPriceProvider.d.ts +6 -0
  40. package/dist/prices/providers/CoinPaprikaPriceProvider.js +6 -0
  41. package/dist/prices/providers/CustomPriceProvider.d.ts +11 -0
  42. package/dist/prices/providers/CustomPriceProvider.js +11 -0
  43. package/dist/prices/providers/KrakenPriceProvider.d.ts +9 -0
  44. package/dist/prices/providers/KrakenPriceProvider.js +9 -0
  45. package/dist/prices/providers/OKXPriceProvider.d.ts +6 -0
  46. package/dist/prices/providers/OKXPriceProvider.js +6 -0
  47. package/dist/prices/providers/abstract/ExchangePriceProvider.d.ts +3 -0
  48. package/dist/prices/providers/abstract/ExchangePriceProvider.js +3 -0
  49. package/dist/storage/IUnifiedStorage.d.ts +19 -7
  50. package/dist/storage/UnifiedSwapStorage.d.ts +33 -3
  51. package/dist/storage/UnifiedSwapStorage.js +29 -1
  52. package/dist/storage-browser/IndexedDBUnifiedStorage.d.ts +31 -7
  53. package/dist/storage-browser/IndexedDBUnifiedStorage.js +29 -6
  54. package/dist/storage-browser/LocalStorageManager.d.ts +25 -1
  55. package/dist/storage-browser/LocalStorageManager.js +25 -1
  56. package/dist/swapper/Swapper.d.ts +303 -222
  57. package/dist/swapper/Swapper.js +376 -344
  58. package/dist/swapper/SwapperFactory.d.ts +41 -17
  59. package/dist/swapper/SwapperFactory.js +23 -2
  60. package/dist/swapper/SwapperUtils.d.ts +75 -28
  61. package/dist/swapper/SwapperUtils.js +107 -60
  62. package/dist/swapper/SwapperWithChain.d.ts +286 -91
  63. package/dist/swapper/SwapperWithChain.js +218 -64
  64. package/dist/swapper/SwapperWithSigner.d.ts +229 -80
  65. package/dist/swapper/SwapperWithSigner.js +190 -44
  66. package/dist/swaps/IAddressSwap.d.ts +10 -1
  67. package/dist/swaps/IAddressSwap.js +2 -1
  68. package/dist/swaps/IBTCWalletSwap.d.ts +24 -6
  69. package/dist/swaps/IBTCWalletSwap.js +2 -1
  70. package/dist/swaps/IClaimableSwap.d.ts +36 -4
  71. package/dist/swaps/IClaimableSwap.js +2 -1
  72. package/dist/swaps/IClaimableSwapWrapper.d.ts +11 -1
  73. package/dist/swaps/IRefundableSwap.d.ts +29 -3
  74. package/dist/swaps/IRefundableSwap.js +2 -1
  75. package/dist/swaps/ISwap.d.ts +159 -21
  76. package/dist/swaps/ISwap.js +90 -33
  77. package/dist/swaps/ISwapWithGasDrop.d.ts +6 -0
  78. package/dist/swaps/ISwapWithGasDrop.js +1 -0
  79. package/dist/swaps/ISwapWrapper.d.ts +157 -48
  80. package/dist/swaps/ISwapWrapper.js +130 -72
  81. package/dist/swaps/escrow_swaps/IEscrowSelfInitSwap.d.ts +49 -6
  82. package/dist/swaps/escrow_swaps/IEscrowSelfInitSwap.js +22 -12
  83. package/dist/swaps/escrow_swaps/IEscrowSwap.d.ts +65 -12
  84. package/dist/swaps/escrow_swaps/IEscrowSwap.js +38 -19
  85. package/dist/swaps/escrow_swaps/IEscrowSwapWrapper.d.ts +39 -9
  86. package/dist/swaps/escrow_swaps/IEscrowSwapWrapper.js +30 -21
  87. package/dist/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.d.ts +31 -15
  88. package/dist/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.js +33 -18
  89. package/dist/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.d.ts +94 -29
  90. package/dist/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.js +90 -27
  91. package/dist/swaps/escrow_swaps/frombtc/IFromBTCWrapper.d.ts +22 -9
  92. package/dist/swaps/escrow_swaps/frombtc/IFromBTCWrapper.js +24 -11
  93. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.d.ts +275 -58
  94. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.js +516 -239
  95. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.d.ts +76 -25
  96. package/dist/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.js +131 -49
  97. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.d.ts +311 -51
  98. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.js +542 -193
  99. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.d.ts +87 -26
  100. package/dist/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.js +147 -58
  101. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.d.ts +209 -53
  102. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.js +449 -242
  103. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.d.ts +77 -23
  104. package/dist/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.js +116 -46
  105. package/dist/swaps/escrow_swaps/tobtc/IToBTCSwap.d.ts +197 -56
  106. package/dist/swaps/escrow_swaps/tobtc/IToBTCSwap.js +326 -189
  107. package/dist/swaps/escrow_swaps/tobtc/IToBTCWrapper.d.ts +30 -5
  108. package/dist/swaps/escrow_swaps/tobtc/IToBTCWrapper.js +44 -19
  109. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.d.ts +60 -19
  110. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.js +74 -31
  111. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.d.ts +76 -50
  112. package/dist/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.js +106 -101
  113. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.d.ts +36 -13
  114. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.js +65 -19
  115. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.d.ts +46 -17
  116. package/dist/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.js +82 -27
  117. package/dist/swaps/spv_swaps/SpvFromBTCSwap.d.ts +328 -92
  118. package/dist/swaps/spv_swaps/SpvFromBTCSwap.js +460 -219
  119. package/dist/swaps/spv_swaps/SpvFromBTCWrapper.d.ts +76 -24
  120. package/dist/swaps/spv_swaps/SpvFromBTCWrapper.js +244 -124
  121. package/dist/swaps/trusted/ln/LnForGasSwap.d.ts +146 -18
  122. package/dist/swaps/trusted/ln/LnForGasSwap.js +173 -43
  123. package/dist/swaps/trusted/ln/LnForGasWrapper.d.ts +29 -10
  124. package/dist/swaps/trusted/ln/LnForGasWrapper.js +30 -11
  125. package/dist/swaps/trusted/onchain/OnchainForGasSwap.d.ts +200 -47
  126. package/dist/swaps/trusted/onchain/OnchainForGasSwap.js +230 -78
  127. package/dist/swaps/trusted/onchain/OnchainForGasWrapper.d.ts +34 -12
  128. package/dist/swaps/trusted/onchain/OnchainForGasWrapper.js +33 -14
  129. package/dist/types/AmountData.d.ts +2 -1
  130. package/dist/types/CustomPriceFunction.d.ts +7 -1
  131. package/dist/types/SwapExecutionAction.d.ts +74 -4
  132. package/dist/types/SwapWithSigner.d.ts +4 -1
  133. package/dist/types/SwapWithSigner.js +5 -2
  134. package/dist/types/Token.d.ts +11 -5
  135. package/dist/types/Token.js +6 -3
  136. package/dist/types/TokenAmount.d.ts +3 -0
  137. package/dist/types/TokenAmount.js +2 -0
  138. package/dist/types/fees/Fee.d.ts +2 -1
  139. package/dist/types/fees/FeeBreakdown.d.ts +2 -1
  140. package/dist/types/fees/PercentagePPM.d.ts +2 -0
  141. package/dist/types/fees/PercentagePPM.js +1 -0
  142. package/dist/types/lnurl/LNURLPay.d.ts +14 -6
  143. package/dist/types/lnurl/LNURLPay.js +6 -2
  144. package/dist/types/lnurl/LNURLWithdraw.d.ts +12 -5
  145. package/dist/types/lnurl/LNURLWithdraw.js +6 -2
  146. package/dist/types/wallets/LightningInvoiceCreateService.d.ts +20 -0
  147. package/dist/types/wallets/LightningInvoiceCreateService.js +15 -0
  148. package/dist/types/wallets/MinimalBitcoinWalletInterface.d.ts +3 -1
  149. package/dist/types/wallets/MinimalLightningNetworkWalletInterface.d.ts +3 -1
  150. package/dist/utils/BitcoinUtils.d.ts +1 -0
  151. package/dist/utils/BitcoinUtils.js +5 -1
  152. package/dist/utils/SwapUtils.d.ts +56 -1
  153. package/dist/utils/SwapUtils.js +53 -1
  154. package/dist/utils/TokenUtils.d.ts +10 -2
  155. package/dist/utils/TokenUtils.js +12 -4
  156. package/package.json +3 -3
  157. package/src/bitcoin/wallet/BitcoinWallet.ts +41 -5
  158. package/src/bitcoin/wallet/IBitcoinWallet.ts +57 -2
  159. package/src/bitcoin/wallet/SingleAddressBitcoinWallet.ts +42 -6
  160. package/src/enums/FeeType.ts +7 -0
  161. package/src/enums/SwapAmountType.ts +7 -0
  162. package/src/enums/SwapDirection.ts +7 -0
  163. package/src/enums/SwapType.ts +62 -2
  164. package/src/errors/IntermediaryError.ts +4 -0
  165. package/src/errors/RequestError.ts +15 -1
  166. package/src/errors/UserError.ts +1 -0
  167. package/src/index.ts +6 -5
  168. package/src/intermediaries/Intermediary.ts +57 -10
  169. package/src/intermediaries/IntermediaryDiscovery.ts +60 -27
  170. package/src/prices/RedundantSwapPrice.ts +24 -4
  171. package/src/prices/SingleSwapPrice.ts +10 -7
  172. package/src/prices/SwapPriceWithChain.ts +59 -21
  173. package/src/prices/abstract/ISwapPrice.ts +114 -65
  174. package/src/prices/providers/BinancePriceProvider.ts +7 -0
  175. package/src/prices/providers/CoinGeckoPriceProvider.ts +6 -0
  176. package/src/prices/providers/CoinPaprikaPriceProvider.ts +6 -0
  177. package/src/prices/providers/CustomPriceProvider.ts +11 -0
  178. package/src/prices/providers/KrakenPriceProvider.ts +9 -0
  179. package/src/prices/providers/OKXPriceProvider.ts +6 -0
  180. package/src/prices/providers/abstract/ExchangePriceProvider.ts +3 -0
  181. package/src/storage/IUnifiedStorage.ts +19 -7
  182. package/src/storage/UnifiedSwapStorage.ts +33 -3
  183. package/src/storage-browser/IndexedDBUnifiedStorage.ts +31 -8
  184. package/src/storage-browser/LocalStorageManager.ts +25 -1
  185. package/src/swapper/Swapper.ts +513 -379
  186. package/src/swapper/SwapperFactory.ts +44 -21
  187. package/src/swapper/SwapperUtils.ts +107 -60
  188. package/src/swapper/SwapperWithChain.ts +320 -81
  189. package/src/swapper/SwapperWithSigner.ts +263 -56
  190. package/src/swaps/IAddressSwap.ts +11 -1
  191. package/src/swaps/IBTCWalletSwap.ts +24 -8
  192. package/src/swaps/IClaimableSwap.ts +39 -4
  193. package/src/swaps/IClaimableSwapWrapper.ts +11 -2
  194. package/src/swaps/IRefundableSwap.ts +32 -3
  195. package/src/swaps/ISwap.ts +221 -82
  196. package/src/swaps/ISwapWithGasDrop.ts +6 -0
  197. package/src/swaps/ISwapWrapper.ts +212 -94
  198. package/src/swaps/escrow_swaps/IEscrowSelfInitSwap.ts +62 -18
  199. package/src/swaps/escrow_swaps/IEscrowSwap.ts +83 -37
  200. package/src/swaps/escrow_swaps/IEscrowSwapWrapper.ts +61 -30
  201. package/src/swaps/escrow_swaps/frombtc/IFromBTCLNWrapper.ts +37 -19
  202. package/src/swaps/escrow_swaps/frombtc/IFromBTCSelfInitSwap.ts +120 -51
  203. package/src/swaps/escrow_swaps/frombtc/IFromBTCWrapper.ts +24 -11
  204. package/src/swaps/escrow_swaps/frombtc/ln/FromBTCLNSwap.ts +559 -256
  205. package/src/swaps/escrow_swaps/frombtc/ln/FromBTCLNWrapper.ts +155 -61
  206. package/src/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoSwap.ts +590 -226
  207. package/src/swaps/escrow_swaps/frombtc/ln_auto/FromBTCLNAutoWrapper.ts +177 -74
  208. package/src/swaps/escrow_swaps/frombtc/onchain/FromBTCSwap.ts +470 -243
  209. package/src/swaps/escrow_swaps/frombtc/onchain/FromBTCWrapper.ts +141 -59
  210. package/src/swaps/escrow_swaps/tobtc/IToBTCSwap.ts +352 -193
  211. package/src/swaps/escrow_swaps/tobtc/IToBTCWrapper.ts +48 -23
  212. package/src/swaps/escrow_swaps/tobtc/ln/ToBTCLNSwap.ts +86 -39
  213. package/src/swaps/escrow_swaps/tobtc/ln/ToBTCLNWrapper.ts +110 -110
  214. package/src/swaps/escrow_swaps/tobtc/onchain/ToBTCSwap.ts +88 -33
  215. package/src/swaps/escrow_swaps/tobtc/onchain/ToBTCWrapper.ts +101 -31
  216. package/src/swaps/spv_swaps/SpvFromBTCSwap.ts +534 -263
  217. package/src/swaps/spv_swaps/SpvFromBTCWrapper.ts +289 -148
  218. package/src/swaps/trusted/ln/LnForGasSwap.ts +184 -45
  219. package/src/swaps/trusted/ln/LnForGasWrapper.ts +34 -15
  220. package/src/swaps/trusted/onchain/OnchainForGasSwap.ts +260 -86
  221. package/src/swaps/trusted/onchain/OnchainForGasWrapper.ts +41 -19
  222. package/src/types/AmountData.ts +2 -1
  223. package/src/types/CustomPriceFunction.ts +7 -1
  224. package/src/types/SwapExecutionAction.ts +84 -5
  225. package/src/types/SwapWithSigner.ts +7 -3
  226. package/src/types/Token.ts +12 -5
  227. package/src/types/TokenAmount.ts +3 -0
  228. package/src/types/fees/Fee.ts +2 -1
  229. package/src/types/fees/FeeBreakdown.ts +2 -1
  230. package/src/types/fees/PercentagePPM.ts +2 -0
  231. package/src/types/lnurl/LNURLPay.ts +14 -6
  232. package/src/types/lnurl/LNURLWithdraw.ts +12 -5
  233. package/src/types/wallets/LightningInvoiceCreateService.ts +26 -0
  234. package/src/types/wallets/MinimalBitcoinWalletInterface.ts +3 -1
  235. package/src/types/wallets/MinimalLightningNetworkWalletInterface.ts +3 -1
  236. package/src/utils/BitcoinUtils.ts +5 -0
  237. package/src/utils/SwapUtils.ts +61 -1
  238. package/src/utils/TokenUtils.ts +12 -4
  239. package/dist/bitcoin/BitcoinRpcWithAddressIndex.d.ts +0 -68
  240. package/dist/bitcoin/BitcoinRpcWithAddressIndex.js +0 -2
  241. package/dist/bitcoin/LightningNetworkApi.d.ts +0 -12
  242. package/dist/bitcoin/LightningNetworkApi.js +0 -2
  243. package/dist/bitcoin/mempool/MempoolApi.d.ts +0 -350
  244. package/dist/bitcoin/mempool/MempoolApi.js +0 -311
  245. package/dist/bitcoin/mempool/MempoolBitcoinBlock.d.ts +0 -44
  246. package/dist/bitcoin/mempool/MempoolBitcoinBlock.js +0 -48
  247. package/dist/bitcoin/mempool/MempoolBitcoinRpc.d.ts +0 -119
  248. package/dist/bitcoin/mempool/MempoolBitcoinRpc.js +0 -361
  249. package/dist/bitcoin/mempool/synchronizer/MempoolBtcRelaySynchronizer.d.ts +0 -22
  250. package/dist/bitcoin/mempool/synchronizer/MempoolBtcRelaySynchronizer.js +0 -105
  251. package/dist/errors/PaymentAuthError.d.ts +0 -11
  252. package/dist/errors/PaymentAuthError.js +0 -23
  253. package/src/errors/PaymentAuthError.ts +0 -26
@@ -1,68 +0,0 @@
1
- /// <reference types="node" />
2
- /// <reference types="node" />
3
- import { BitcoinRpc, BtcBlock, BtcTx } from "@atomiqlabs/base";
4
- import { Buffer } from "buffer";
5
- export type BtcTxWithBlockheight = BtcTx & {
6
- blockheight?: number;
7
- inputAddresses?: string[];
8
- };
9
- export type BtcAddressUtxo = {
10
- txid: string;
11
- vout: number;
12
- confirmed: boolean;
13
- block_height: number;
14
- block_hash: string;
15
- block_time: number;
16
- value: bigint;
17
- };
18
- export interface BitcoinRpcWithAddressIndex<T extends BtcBlock> extends BitcoinRpc<T> {
19
- getFeeRate(): Promise<number>;
20
- getAddressBalances(address: string): Promise<{
21
- confirmedBalance: bigint;
22
- unconfirmedBalance: bigint;
23
- }>;
24
- getAddressUTXOs(address: string): Promise<BtcAddressUtxo[]>;
25
- getCPFPData(txId: string): Promise<{
26
- effectiveFeePerVsize: number;
27
- adjustedVsize: number;
28
- }>;
29
- getTransaction(txId: string): Promise<BtcTxWithBlockheight | null>;
30
- waitForTransaction(txId: string, requiredConfirmations: number, stateUpdateCbk: (btcTx?: BtcTxWithBlockheight, txEtaMS?: number) => void, abortSignal?: AbortSignal, intervalSeconds?: number): Promise<BtcTxWithBlockheight>;
31
- /**
32
- * Returns an estimate after which time the tx will confirm with the required amount of confirmations,
33
- * confirmationDelay of -1 means the transaction won't confirm in the near future
34
- *
35
- * @param tx
36
- * @param requiredConfirmations
37
- * @private
38
- *
39
- * @returns estimated confirmation delay, -1 if the transaction won't confirm in the near future, null if the
40
- * transaction was replaced or was confirmed in the meantime
41
- */
42
- getConfirmationDelay(tx: BtcTx, requiredConfirmations: number): Promise<number | null>;
43
- /**
44
- * Checks if an address received the transaction with the required txoHash, returns info about that
45
- * specific transaction if found, or null if not found
46
- *
47
- * @param address Address that should receive the transaction
48
- * @param txoHash Required output txoHash
49
- */
50
- checkAddressTxos(address: string, txoHash: Buffer): Promise<{
51
- tx: Omit<BtcTxWithBlockheight, "hex" | "raw">;
52
- vout: number;
53
- } | null>;
54
- /**
55
- * Waits till the address receives a transaction containing a specific txoHash
56
- *
57
- * @param address Address that should receive the transaction
58
- * @param txoHash Required output txoHash
59
- * @param requiredConfirmations Required confirmations of the transaction
60
- * @param stateUpdateCbk Callback for transaction state updates
61
- * @param abortSignal Abort signal
62
- * @param intervalSeconds How often to check new transaction
63
- */
64
- waitForAddressTxo(address: string, txoHash: Buffer, requiredConfirmations: number, stateUpdateCbk: (btcTx?: Omit<BtcTxWithBlockheight, "hex" | "raw">, vout?: number, txEtaMS?: number) => void, abortSignal?: AbortSignal, intervalSeconds?: number): Promise<{
65
- tx: Omit<BtcTxWithBlockheight, "hex" | "raw">;
66
- vout: number;
67
- }>;
68
- }
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,12 +0,0 @@
1
- export type LNNodeLiquidity = {
2
- publicKey: string;
3
- capacity: bigint;
4
- numChannels: number;
5
- };
6
- export interface LightningNetworkApi {
7
- /**
8
- * Returns the lightning network's node liquidity as identified by an identity public key
9
- * @param pubkey
10
- */
11
- getLNNodeLiquidity(pubkey: string): Promise<LNNodeLiquidity | null>;
12
- }
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,350 +0,0 @@
1
- /// <reference types="node" />
2
- /// <reference types="node" />
3
- import { Buffer } from "buffer";
4
- /**
5
- * Bitcoin transaction confirmation status
6
- * @category Bitcoin
7
- */
8
- export type BitcoinTransactionStatus = {
9
- confirmed: boolean;
10
- block_height: number;
11
- block_hash: string;
12
- block_time: number;
13
- };
14
- /**
15
- * Bitcoin transaction output
16
- * @category Bitcoin
17
- */
18
- export type TxVout = {
19
- scriptpubkey: string;
20
- scriptpubkey_asm: string;
21
- scriptpubkey_type: string;
22
- scriptpubkey_address: string;
23
- value: number;
24
- };
25
- /**
26
- * Bitcoin transaction input
27
- * @category Bitcoin
28
- */
29
- export type TxVin = {
30
- txid: string;
31
- vout: number;
32
- prevout: TxVout;
33
- scriptsig: string;
34
- scriptsig_asm: string;
35
- witness: string[];
36
- is_coinbase: boolean;
37
- sequence: number;
38
- inner_witnessscript_asm: string;
39
- };
40
- /**
41
- * Full Bitcoin transaction data
42
- * @category Bitcoin
43
- */
44
- export type BitcoinTransaction = {
45
- txid: string;
46
- version: number;
47
- locktime: number;
48
- vin: TxVin[];
49
- vout: TxVout[];
50
- size: number;
51
- weight: number;
52
- fee: number;
53
- status: BitcoinTransactionStatus;
54
- };
55
- /**
56
- * Bitcoin block data
57
- * @category Bitcoin
58
- */
59
- export type BlockData = {
60
- bits: number;
61
- difficulty: number;
62
- extras: any;
63
- height: number;
64
- id: string;
65
- mediantime: number;
66
- merkle_root: string;
67
- nonce: number;
68
- previousblockhash: string;
69
- size: number;
70
- timestamp: number;
71
- tx_count: number;
72
- version: number;
73
- weight: number;
74
- };
75
- /**
76
- * Bitcoin block header data
77
- * @category Bitcoin
78
- */
79
- export type BitcoinBlockHeader = {
80
- id: string;
81
- height: number;
82
- version: number;
83
- timestamp: number;
84
- tx_count: number;
85
- size: number;
86
- weight: number;
87
- merkle_root: string;
88
- previousblockhash: string;
89
- mediantime: number;
90
- nonce: number;
91
- bits: number;
92
- difficulty: number;
93
- };
94
- export type LNNodeInfo = {
95
- public_key: string;
96
- alias: string;
97
- first_seen: number;
98
- updated_at: number;
99
- color: string;
100
- sockets: string;
101
- as_number: number;
102
- city_id: number;
103
- country_id: number;
104
- subdivision_id: number;
105
- longtitude: number;
106
- latitude: number;
107
- iso_code: string;
108
- as_organization: string;
109
- city: {
110
- [lang: string]: string;
111
- };
112
- country: {
113
- [lang: string]: string;
114
- };
115
- subdivision: {
116
- [lang: string]: string;
117
- };
118
- active_channel_count: number;
119
- capacity: string;
120
- opened_channel_count: number;
121
- closed_channel_count: number;
122
- };
123
- export type AddressInfo = {
124
- address: string;
125
- chain_stats: {
126
- funded_txo_count: number;
127
- funded_txo_sum: number;
128
- spent_txo_count: number;
129
- spent_txo_sum: number;
130
- tx_count: number;
131
- };
132
- mempool_stats: {
133
- funded_txo_count: number;
134
- funded_txo_sum: number;
135
- spent_txo_count: number;
136
- spent_txo_sum: number;
137
- tx_count: number;
138
- };
139
- };
140
- export type TransactionCPFPData = {
141
- ancestors: {
142
- txid: string;
143
- fee: number;
144
- weight: number;
145
- }[];
146
- descendants: {
147
- txid: string;
148
- fee: number;
149
- weight: number;
150
- }[];
151
- effectiveFeePerVsize: number;
152
- sigops: number;
153
- adjustedVsize: number;
154
- };
155
- export type BitcoinFees = {
156
- fastestFee: number;
157
- halfHourFee: number;
158
- hourFee: number;
159
- economyFee: number;
160
- minimumFee: number;
161
- };
162
- export type BitcoinPendingBlock = {
163
- blockSize: number;
164
- blockVSize: number;
165
- nTx: number;
166
- totalFees: number;
167
- medianFee: number;
168
- feeRange: number[];
169
- };
170
- export type BlockStatus = {
171
- in_best_chain: boolean;
172
- height: number;
173
- next_best: string;
174
- };
175
- export type TransactionProof = {
176
- block_height: number;
177
- merkle: string[];
178
- pos: number;
179
- };
180
- export type TransactionOutspend = {
181
- spent: boolean;
182
- txid: string;
183
- vin: number;
184
- status: BitcoinTransactionStatus;
185
- };
186
- /**
187
- * Mempool.space REST API client for Bitcoin blockchain data
188
- * @category Bitcoin
189
- */
190
- export declare class MempoolApi {
191
- backends: {
192
- url: string;
193
- operational: boolean | null;
194
- }[];
195
- timeout: number;
196
- /**
197
- * Returns api url that should be operational
198
- *
199
- * @private
200
- */
201
- private getOperationalApi;
202
- /**
203
- * Returns api urls that are maybe operational, in case none is considered operational returns all of the price
204
- * apis such that they can be tested again whether they are operational
205
- *
206
- * @private
207
- */
208
- private getMaybeOperationalApis;
209
- /**
210
- * Sends a GET or POST request to the mempool api, handling the non-200 responses as errors & throwing
211
- *
212
- * @param url
213
- * @param path
214
- * @param responseType
215
- * @param type
216
- * @param body
217
- */
218
- private _request;
219
- /**
220
- * Sends request in parallel to multiple maybe operational api urls
221
- *
222
- * @param path
223
- * @param responseType
224
- * @param type
225
- * @param body
226
- * @private
227
- */
228
- private requestFromMaybeOperationalUrls;
229
- /**
230
- * Sends a request to mempool API, first tries to use the operational API (if any) and if that fails it falls back
231
- * to using maybe operational price APIs
232
- *
233
- * @param path
234
- * @param responseType
235
- * @param type
236
- * @param body
237
- * @private
238
- */
239
- private request;
240
- constructor(url?: string | string[], timeout?: number);
241
- /**
242
- * Returns information about a specific lightning network node as identified by the public key (in hex encoding)
243
- *
244
- * @param pubkey
245
- */
246
- getLNNodeInfo(pubkey: string): Promise<LNNodeInfo | null>;
247
- /**
248
- * Returns on-chain transaction as identified by its txId
249
- *
250
- * @param txId
251
- */
252
- getTransaction(txId: string): Promise<BitcoinTransaction | null>;
253
- /**
254
- * Returns raw binary encoded bitcoin transaction, also strips the witness data from the transaction
255
- *
256
- * @param txId
257
- */
258
- getRawTransaction(txId: string): Promise<Buffer | null>;
259
- /**
260
- * Returns confirmed & unconfirmed balance of the specific bitcoin address
261
- *
262
- * @param address
263
- */
264
- getAddressBalances(address: string): Promise<{
265
- confirmedBalance: bigint;
266
- unconfirmedBalance: bigint;
267
- }>;
268
- /**
269
- * Returns CPFP (children pays for parent) data for a given transaction
270
- *
271
- * @param txId
272
- */
273
- getCPFPData(txId: string): Promise<TransactionCPFPData>;
274
- /**
275
- * Returns UTXOs (unspent transaction outputs) for a given address
276
- *
277
- * @param address
278
- */
279
- getAddressUTXOs(address: string): Promise<{
280
- txid: string;
281
- vout: number;
282
- status: {
283
- confirmed: boolean;
284
- block_height: number;
285
- block_hash: string;
286
- block_time: number;
287
- };
288
- value: bigint;
289
- }[]>;
290
- /**
291
- * Returns current on-chain bitcoin fees
292
- */
293
- getFees(): Promise<BitcoinFees>;
294
- /**
295
- * Returns all transactions for a given address
296
- *
297
- * @param address
298
- */
299
- getAddressTransactions(address: string): Promise<BitcoinTransaction[]>;
300
- /**
301
- * Returns expected pending (mempool) blocks
302
- */
303
- getPendingBlocks(): Promise<BitcoinPendingBlock[]>;
304
- /**
305
- * Returns the blockheight of the current bitcoin blockchain's tip
306
- */
307
- getTipBlockHeight(): Promise<number>;
308
- /**
309
- * Returns the bitcoin blockheader as identified by its blockhash
310
- *
311
- * @param blockhash
312
- */
313
- getBlockHeader(blockhash: string): Promise<BitcoinBlockHeader>;
314
- /**
315
- * Returns the block status
316
- *
317
- * @param blockhash
318
- */
319
- getBlockStatus(blockhash: string): Promise<BlockStatus>;
320
- /**
321
- * Returns the transaction's proof (merkle proof)
322
- *
323
- * @param txId
324
- */
325
- getTransactionProof(txId: string): Promise<TransactionProof>;
326
- /**
327
- * Returns the transaction's proof (merkle proof)
328
- *
329
- * @param txId
330
- */
331
- getOutspends(txId: string): Promise<TransactionOutspend[]>;
332
- /**
333
- * Returns blockhash of a block at a specific blockheight
334
- *
335
- * @param height
336
- */
337
- getBlockHash(height: number): Promise<string>;
338
- /**
339
- * Returns past 15 blockheaders before (and including) the specified height
340
- *
341
- * @param endHeight
342
- */
343
- getPast15BlockHeaders(endHeight: number): Promise<BlockData[]>;
344
- /**
345
- * Sends raw hex encoded bitcoin transaction
346
- *
347
- * @param transactionHex
348
- */
349
- sendTransaction(transactionHex: string): Promise<string>;
350
- }