@btc-vision/transaction 1.0.59 → 1.0.61

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 (273) hide show
  1. package/.gitattributes +2 -2
  2. package/browser/_version.d.ts +1 -1
  3. package/browser/index.js +1 -1
  4. package/browser/transaction/builders/TapUnwarpTransaction.d.ts +40 -40
  5. package/browser/transaction/builders/UnwarpTransaction.d.ts +34 -34
  6. package/browser/utxo/UTXOManager.d.ts +7 -7
  7. package/build/Utils.d.ts +0 -0
  8. package/build/Utils.js +1 -0
  9. package/build/_version.d.ts +1 -1
  10. package/build/_version.js +1 -1
  11. package/build/consensus/metadata/RoswsellConsensus.d.ts +2 -0
  12. package/build/consensus/metadata/RoswsellConsensus.js +4 -0
  13. package/build/contracts/ContractMetadataManager.d.ts +0 -0
  14. package/build/contracts/ContractMetadataManager.js +1 -0
  15. package/build/generators/OPNetAddressGenerator.d.ts +0 -0
  16. package/build/generators/OPNetAddressGenerator.js +1 -0
  17. package/build/generators/builders/UnwrapGenerator.d.ts +8 -0
  18. package/build/generators/builders/UnwrapGenerator.js +79 -0
  19. package/build/keypair/interfaces/GeneratedWallet.d.ts +5 -0
  20. package/build/keypair/interfaces/GeneratedWallet.js +1 -0
  21. package/build/metadata/CommonContracts.d.ts +6 -0
  22. package/build/metadata/CommonContracts.js +5 -0
  23. package/build/metadata/ContractMetadataManager.d.ts +1 -0
  24. package/build/metadata/ContractMetadataManager.js +9 -0
  25. package/build/metadata/contracts/ContractBase.d.ts +9 -0
  26. package/build/metadata/contracts/ContractBase.js +13 -0
  27. package/build/metadata/contracts/ContractBaseMetadata.d.ts +9 -0
  28. package/build/metadata/contracts/ContractBaseMetadata.js +13 -0
  29. package/build/metadata/contracts/ContractMetadataManager.d.ts +0 -0
  30. package/build/metadata/contracts/ContractMetadataManager.js +1 -0
  31. package/build/network/NetworkConverter.d.ts +0 -0
  32. package/build/network/NetworkConverter.js +14 -0
  33. package/build/scripts/Regtest.d.ts +2 -0
  34. package/build/scripts/Regtest.js +15 -0
  35. package/build/scripts/test.d.ts +1 -0
  36. package/build/scripts/test.js +74 -0
  37. package/build/signer/Regtest.d.ts +2 -0
  38. package/build/signer/Regtest.js +15 -0
  39. package/build/tests/Regtest.d.ts +3 -0
  40. package/build/tests/Regtest.js +29 -0
  41. package/build/tests/adaptPSBT.d.ts +1 -0
  42. package/build/tests/adaptPSBT.js +44 -0
  43. package/build/tests/btc/send.d.ts +1 -0
  44. package/build/tests/btc/send.js +35 -0
  45. package/build/tests/btc/transfer.d.ts +1 -0
  46. package/build/tests/btc/transfer.js +35 -0
  47. package/build/tests/createPairReg.d.ts +1 -0
  48. package/build/tests/createPairReg.js +73 -0
  49. package/build/tests/deploy/deployMoto.d.ts +4 -0
  50. package/build/tests/deploy/deployMoto.js +89 -0
  51. package/build/tests/deploy/deployPool.d.ts +1 -0
  52. package/build/tests/deploy/deployPool.js +5 -0
  53. package/build/tests/deploy/deployStep1.d.ts +1 -0
  54. package/build/tests/deploy/deployStep1.js +5 -0
  55. package/build/tests/deploy/deployStep2.d.ts +1 -0
  56. package/build/tests/deploy/deployStep2.js +5 -0
  57. package/build/tests/deploy/deployStep3.d.ts +1 -0
  58. package/build/tests/deploy/deployStep3.js +5 -0
  59. package/build/tests/deploy.d.ts +1 -0
  60. package/build/tests/deploy.js +41 -0
  61. package/build/tests/deployMotoRegStep1.d.ts +1 -0
  62. package/build/tests/deployMotoRegStep1.js +85 -0
  63. package/build/tests/deployReg.d.ts +1 -0
  64. package/build/tests/deployReg.js +85 -0
  65. package/build/tests/factory/createPairReg.d.ts +1 -0
  66. package/build/tests/factory/createPairReg.js +13 -0
  67. package/build/tests/gen.d.ts +1 -0
  68. package/build/tests/gen.js +19 -0
  69. package/build/tests/interaction.d.ts +5 -0
  70. package/build/tests/interaction.js +62 -0
  71. package/build/tests/massWrapReg.d.ts +1 -0
  72. package/build/tests/massWrapReg.js +105 -0
  73. package/build/tests/mineReg.d.ts +1 -0
  74. package/build/tests/mineReg.js +19 -0
  75. package/build/tests/moto/airdropToken.d.ts +1 -0
  76. package/build/tests/moto/airdropToken.js +21 -0
  77. package/build/tests/moto/airdropTokens.d.ts +1 -0
  78. package/build/tests/moto/airdropTokens.js +60 -0
  79. package/build/tests/moto/allowance.d.ts +1 -0
  80. package/build/tests/moto/allowance.js +6 -0
  81. package/build/tests/moto/approve.d.ts +1 -0
  82. package/build/tests/moto/approve.js +10 -0
  83. package/build/tests/moto/approveWBTC.d.ts +1 -0
  84. package/build/tests/moto/approveWBTC.js +12 -0
  85. package/build/tests/moto/balanceOf.d.ts +1 -0
  86. package/build/tests/moto/balanceOf.js +12 -0
  87. package/build/tests/moto/transfer.d.ts +1 -0
  88. package/build/tests/moto/transfer.js +16 -0
  89. package/build/tests/motoswap/airdropToken.d.ts +11 -0
  90. package/build/tests/motoswap/airdropToken.js +36 -0
  91. package/build/tests/motoswap/deployMoto.d.ts +4 -0
  92. package/build/tests/motoswap/deployMoto.js +89 -0
  93. package/build/tests/motoswap/deployMotoRegStep1.d.ts +1 -0
  94. package/build/tests/motoswap/deployMotoRegStep1.js +91 -0
  95. package/build/tests/motoswap/deployMotoRegStep2.d.ts +1 -0
  96. package/build/tests/motoswap/deployMotoRegStep2.js +91 -0
  97. package/build/tests/motoswap/deployPool.d.ts +1 -0
  98. package/build/tests/motoswap/deployPool.js +5 -0
  99. package/build/tests/motoswap/deployStep1.d.ts +1 -0
  100. package/build/tests/motoswap/deployStep1.js +5 -0
  101. package/build/tests/motoswap/deployStep2.d.ts +1 -0
  102. package/build/tests/motoswap/deployStep2.js +5 -0
  103. package/build/tests/motoswap/deployStep3.d.ts +1 -0
  104. package/build/tests/motoswap/deployStep3.js +5 -0
  105. package/build/tests/motoswap/interaction.d.ts +3 -0
  106. package/build/tests/motoswap/interaction.js +63 -0
  107. package/build/tests/motoswap/routerAddLiquidity.d.ts +11 -0
  108. package/build/tests/motoswap/routerAddLiquidity.js +35 -0
  109. package/build/tests/motoswap-router/addLiquidity.d.ts +11 -0
  110. package/build/tests/motoswap-router/addLiquidity.js +36 -0
  111. package/build/tests/motoswap-router/deployMoto.d.ts +4 -0
  112. package/build/tests/motoswap-router/deployMoto.js +89 -0
  113. package/build/tests/motoswap-router/deployPool.d.ts +1 -0
  114. package/build/tests/motoswap-router/deployPool.js +5 -0
  115. package/build/tests/motoswap-router/deployStep1.d.ts +1 -0
  116. package/build/tests/motoswap-router/deployStep1.js +5 -0
  117. package/build/tests/motoswap-router/deployStep2.d.ts +1 -0
  118. package/build/tests/motoswap-router/deployStep2.js +5 -0
  119. package/build/tests/motoswap-router/deployStep3.d.ts +1 -0
  120. package/build/tests/motoswap-router/deployStep3.js +5 -0
  121. package/build/tests/motoswap-router/getAmountsOut.d.ts +5 -0
  122. package/build/tests/motoswap-router/getAmountsOut.js +34 -0
  123. package/build/tests/motoswap-router/routerAddLiquidity.d.ts +11 -0
  124. package/build/tests/motoswap-router/routerAddLiquidity.js +35 -0
  125. package/build/tests/motoswap-router/swap.d.ts +8 -0
  126. package/build/tests/motoswap-router/swap.js +24 -0
  127. package/build/tests/multisign.d.ts +1 -0
  128. package/build/tests/multisign.js +47 -0
  129. package/build/tests/multisign2.d.ts +1 -0
  130. package/build/tests/multisign2.js +27 -0
  131. package/build/tests/pool/DecodePoolAddress.d.ts +6 -0
  132. package/build/tests/pool/DecodePoolAddress.js +12 -0
  133. package/build/tests/pool/decodeReserves.d.ts +5 -0
  134. package/build/tests/pool/decodeReserves.js +13 -0
  135. package/build/tests/pool/reserves.d.ts +1 -0
  136. package/build/tests/pool/reserves.js +18 -0
  137. package/build/tests/shared/Utils.d.ts +2 -0
  138. package/build/tests/shared/Utils.js +14 -0
  139. package/build/tests/shared/interaction.d.ts +7 -0
  140. package/build/tests/shared/interaction.js +85 -0
  141. package/build/tests/shared/tokens.d.ts +6 -0
  142. package/build/tests/shared/tokens.js +5 -0
  143. package/build/tests/stakeReg.d.ts +1 -0
  144. package/build/tests/stakeReg.js +73 -0
  145. package/build/tests/stakedReg.d.ts +1 -0
  146. package/build/tests/stakedReg.js +28 -0
  147. package/build/tests/test.d.ts +1 -0
  148. package/build/tests/test.js +51 -0
  149. package/build/tests/test2.d.ts +1 -0
  150. package/build/tests/test2.js +73 -0
  151. package/build/tests/testReg.d.ts +1 -0
  152. package/build/tests/testReg.js +91 -0
  153. package/build/tests/tokens.d.ts +6 -0
  154. package/build/tests/tokens.js +5 -0
  155. package/build/tests/totalRewardReg.d.ts +1 -0
  156. package/build/tests/totalRewardReg.js +28 -0
  157. package/build/tests/transfer.d.ts +1 -0
  158. package/build/tests/transfer.js +74 -0
  159. package/build/tests/transferReg.d.ts +1 -0
  160. package/build/tests/transferReg.js +74 -0
  161. package/build/tests/unStakeReg.d.ts +1 -0
  162. package/build/tests/unStakeReg.js +72 -0
  163. package/build/tests/unwrapReg.d.ts +1 -0
  164. package/build/tests/unwrapReg.js +61 -0
  165. package/build/tests/unwrapReg2.d.ts +1 -0
  166. package/build/tests/unwrapReg2.js +56 -0
  167. package/build/tests/unwrapRegSegwit.d.ts +1 -0
  168. package/build/tests/unwrapRegSegwit.js +83 -0
  169. package/build/tests/wbtc/approve.d.ts +1 -0
  170. package/build/tests/wbtc/approve.js +6 -0
  171. package/build/tests/wbtc/approveWBTC.d.ts +1 -0
  172. package/build/tests/wbtc/approveWBTC.js +12 -0
  173. package/build/tests/wbtc/massWrapReg.d.ts +1 -0
  174. package/build/tests/wbtc/massWrapReg.js +105 -0
  175. package/build/tests/wbtc/transfer.d.ts +1 -0
  176. package/build/tests/wbtc/transfer.js +16 -0
  177. package/build/tests/wbtc/transferReg.d.ts +1 -0
  178. package/build/tests/wbtc/transferReg.js +16 -0
  179. package/build/tests/wbtc/unStakeReg.d.ts +1 -0
  180. package/build/tests/wbtc/unStakeReg.js +72 -0
  181. package/build/tests/wbtc/unwrapReg.d.ts +1 -0
  182. package/build/tests/wbtc/unwrapReg.js +60 -0
  183. package/build/tests/wbtc/unwrapRegSegwit.d.ts +1 -0
  184. package/build/tests/wbtc/unwrapRegSegwit.js +83 -0
  185. package/build/tests/wbtc/withdrawalRequestReg.d.ts +1 -0
  186. package/build/tests/wbtc/withdrawalRequestReg.js +71 -0
  187. package/build/tests/wbtc/wrapReg.d.ts +1 -0
  188. package/build/tests/wbtc/wrapReg.js +65 -0
  189. package/build/tests/wbtc/wrapTest.d.ts +1 -0
  190. package/build/tests/wbtc/wrapTest.js +66 -0
  191. package/build/tests/withdrawalRequestReg.d.ts +1 -0
  192. package/build/tests/withdrawalRequestReg.js +71 -0
  193. package/build/tests/wrap.d.ts +1 -0
  194. package/build/tests/wrap.js +65 -0
  195. package/build/tests/wrapReg.d.ts +1 -0
  196. package/build/tests/wrapReg.js +68 -0
  197. package/build/tests/wrapTest.d.ts +1 -0
  198. package/build/tests/wrapTest.js +66 -0
  199. package/build/tests/wrapTestg.d.ts +1 -0
  200. package/build/tests/wrapTestg.js +66 -0
  201. package/build/tests/writers/allowance.d.ts +3 -0
  202. package/build/tests/writers/allowance.js +10 -0
  203. package/build/tests/writers/approve.d.ts +4 -0
  204. package/build/tests/writers/approve.js +11 -0
  205. package/build/transaction/TransactionBuilder.d.ts +60 -0
  206. package/build/transaction/TransactionBuilder.js +244 -0
  207. package/build/transaction/TransactionFactory.js +3 -2
  208. package/build/transaction/browser/BrowserSigner.d.ts +11 -0
  209. package/build/transaction/browser/BrowserSigner.js +10 -0
  210. package/build/transaction/browser/extensions/Unisat.d.ts +54 -0
  211. package/build/transaction/browser/extensions/Unisat.js +11 -0
  212. package/build/transaction/builders/GenericTransaction.d.ts +11 -0
  213. package/build/transaction/builders/GenericTransaction.js +23 -0
  214. package/build/transaction/builders/TapUnwarpTransaction.d.ts +37 -0
  215. package/build/transaction/builders/TapUnwarpTransaction.js +201 -0
  216. package/build/transaction/builders/TransactionBuilder.js +1 -1
  217. package/build/transaction/builders/UnwarpSegwitTransaction.d.ts +34 -0
  218. package/build/transaction/builders/UnwarpSegwitTransaction.js +184 -0
  219. package/build/transaction/builders/UnwarpTransaction.d.ts +35 -0
  220. package/build/transaction/builders/UnwarpTransaction.js +199 -0
  221. package/build/transaction/interfaces/ITransactions.d.ts +32 -0
  222. package/build/transaction/interfaces/ITransactions.js +1 -0
  223. package/build/utxo/IUTXO.d.ts +0 -0
  224. package/build/utxo/IUTXO.js +1 -0
  225. package/build/utxo/OPNetUtils.d.ts +7 -0
  226. package/build/utxo/OPNetUtils.js +47 -0
  227. package/build/utxo/UTXOManager.d.ts +7 -0
  228. package/build/utxo/UTXOManager.js +47 -0
  229. package/build/wbtc/BroadcastResponse.d.ts +0 -0
  230. package/build/wbtc/BroadcastResponse.js +1 -0
  231. package/gulpfile.js +152 -152
  232. package/package.json +1 -1
  233. package/src/_version.ts +1 -1
  234. package/src/consensus/Consensus.ts +36 -36
  235. package/src/consensus/ConsensusConfig.ts +39 -39
  236. package/src/crypto/crypto-browser.js +75 -75
  237. package/src/generators/AddressGenerator.ts +24 -24
  238. package/src/generators/Features.ts +5 -5
  239. package/src/generators/Generator.ts +75 -75
  240. package/src/generators/builders/CalldataGenerator.ts +148 -148
  241. package/src/generators/builders/DeploymentGenerator.ts +66 -66
  242. package/src/index.ts +4 -4
  243. package/src/keypair/AddressVerificator.ts +40 -40
  244. package/src/keypair/EcKeyPair.ts +282 -282
  245. package/src/keypair/Wallet.ts +97 -97
  246. package/src/keypair/interfaces/IWallet.ts +19 -19
  247. package/src/metadata/ContractBaseMetadata.ts +23 -23
  248. package/src/network/NetworkInformation.ts +7 -7
  249. package/src/opnet.ts +84 -84
  250. package/src/transaction/TransactionFactory.ts +3 -2
  251. package/src/transaction/browser/BrowserSignerBase.ts +37 -37
  252. package/src/transaction/browser/Web3Provider.ts +46 -46
  253. package/src/transaction/browser/extensions/UnisatSigner.ts +218 -218
  254. package/src/transaction/browser/types/Unisat.ts +80 -80
  255. package/src/transaction/builders/FundingTransaction.ts +40 -40
  256. package/src/transaction/builders/InteractionTransaction.ts +38 -38
  257. package/src/transaction/builders/SharedInteractionTransaction.ts +368 -368
  258. package/src/transaction/builders/TransactionBuilder.ts +665 -665
  259. package/src/transaction/interfaces/Tap.ts +26 -26
  260. package/src/transaction/psbt/PSBTTypes.ts +3 -3
  261. package/src/transaction/shared/TweakedTransaction.ts +537 -537
  262. package/src/utxo/OPNetLimitedProvider.ts +244 -244
  263. package/src/utxo/interfaces/BroadcastResponse.ts +10 -10
  264. package/src/utxo/interfaces/IUTXO.ts +29 -29
  265. package/src/verification/TapscriptVerificator.ts +89 -89
  266. package/src/wbtc/Generate.ts +40 -40
  267. package/src/wbtc/UnwrapGeneration.ts +13 -13
  268. package/src/wbtc/WrappedGenerationParameters.ts +33 -33
  269. package/webpack.config.js +78 -78
  270. /package/build/generators/builders/{MultiSignGenerator.d.ts → MultisignGenerator.d.ts} +0 -0
  271. /package/build/generators/builders/{MultiSignGenerator.js → MultisignGenerator.js} +0 -0
  272. /package/build/generators/{Features.d.ts → features.d.ts} +0 -0
  273. /package/build/generators/{Features.js → features.js} +0 -0
@@ -0,0 +1,201 @@
1
+ import { TransactionType } from '../enums/TransactionType.js';
2
+ import { SharedInteractionTransaction } from './SharedInteractionTransaction.js';
3
+ import { TransactionBuilder } from './TransactionBuilder.js';
4
+ import { ABICoder, BinaryWriter } from '@btc-vision/bsi-binary';
5
+ import { wBTC } from '../../metadata/contracts/wBTC.js';
6
+ import { payments } from 'bitcoinjs-lib';
7
+ import { EcKeyPair } from '../../keypair/EcKeyPair.js';
8
+ import { PsbtTransaction } from '../processor/PsbtTransaction.js';
9
+ import { MultiSignGenerator } from '../../generators/builders/MultiSignGenerator.js';
10
+ import { MultiSignTransaction } from './MultiSignTransaction.js';
11
+ import { toXOnly } from 'bitcoinjs-lib/src/psbt/bip371.js';
12
+ import { CalldataGenerator } from '../../generators/builders/CalldataGenerator.js';
13
+ const abiCoder = new ABICoder();
14
+ const numsPoint = Buffer.from('50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0', 'hex');
15
+ export class TapUnwrapTransaction extends SharedInteractionTransaction {
16
+ static UNWRAP_SELECTOR = Number('0x' + abiCoder.encodeSelector('burn'));
17
+ type = TransactionType.WBTC_UNWRAP;
18
+ amount;
19
+ compiledTargetScript;
20
+ scriptTree;
21
+ sighashTypes = [];
22
+ contractSecret;
23
+ vaultUTXOs;
24
+ wbtc;
25
+ calculatedSignHash = PsbtTransaction.calculateSignHash(this.sighashTypes);
26
+ constructor(parameters) {
27
+ if (parameters.amount < TransactionBuilder.MINIMUM_DUST) {
28
+ throw new Error('Amount is below dust limit');
29
+ }
30
+ parameters.disableAutoRefund = true;
31
+ parameters.calldata = TapUnwrapTransaction.generateBurnCalldata(parameters.amount);
32
+ super(parameters);
33
+ this.wbtc = new wBTC(parameters.network);
34
+ this.to = this.wbtc.getAddress();
35
+ this.vaultUTXOs = parameters.unwrapUTXOs;
36
+ this.amount = parameters.amount;
37
+ this.contractSecret = this.generateSecret();
38
+ this.calldataGenerator = new CalldataGenerator(toXOnly(this.signer.publicKey), this.scriptSignerXOnlyPubKey(), this.network);
39
+ this.compiledTargetScript = this.calldataGenerator.compile(this.calldata, this.contractSecret);
40
+ this.scriptTree = this.getScriptTree();
41
+ this.internalInit();
42
+ }
43
+ static generateBurnCalldata(amount) {
44
+ if (!amount)
45
+ throw new Error('Amount is required');
46
+ const bufWriter = new BinaryWriter();
47
+ bufWriter.writeSelector(TapUnwrapTransaction.UNWRAP_SELECTOR);
48
+ bufWriter.writeU256(amount);
49
+ return Buffer.from(bufWriter.getBuffer());
50
+ }
51
+ signPSBT() {
52
+ if (this.to && !EcKeyPair.verifyContractAddress(this.to, this.network)) {
53
+ throw new Error('Invalid contract address. The contract address must be a taproot address.');
54
+ }
55
+ if (!this.vaultUTXOs.length) {
56
+ throw new Error('No vault UTXOs provided');
57
+ }
58
+ this.buildTransaction();
59
+ this.ignoreSignatureError();
60
+ this.mergeVaults(this.vaultUTXOs);
61
+ const builtTx = this.internalBuildTransaction(this.transaction);
62
+ if (builtTx) {
63
+ return this.transaction;
64
+ }
65
+ throw new Error('Could not sign transaction');
66
+ }
67
+ mergeVaults(input) {
68
+ const firstVault = input[0];
69
+ if (!firstVault) {
70
+ throw new Error('No vaults provided');
71
+ }
72
+ const outputLeftAmount = this.calculateOutputLeftAmountFromVaults(input);
73
+ if (outputLeftAmount < 0) {
74
+ throw new Error(`Output left amount is negative ${outputLeftAmount} for vault ${firstVault.vault}`);
75
+ }
76
+ this.addOutput({
77
+ address: firstVault.vault,
78
+ value: Number(outputLeftAmount),
79
+ });
80
+ this.addOutput({
81
+ address: this.from,
82
+ value: Number(this.amount),
83
+ });
84
+ for (const vault of input) {
85
+ this.addVaultInputs(vault);
86
+ }
87
+ }
88
+ internalPubKeyToXOnly() {
89
+ return toXOnly(numsPoint);
90
+ }
91
+ generateTapDataForInput(pubkeys, minimumSignatures) {
92
+ const compiledTargetScript = MultiSignGenerator.compile(pubkeys, minimumSignatures);
93
+ const scriptTree = [
94
+ {
95
+ output: compiledTargetScript,
96
+ version: 192,
97
+ },
98
+ {
99
+ output: MultiSignTransaction.LOCK_LEAF_SCRIPT,
100
+ version: 192,
101
+ },
102
+ ];
103
+ const redeem = {
104
+ output: compiledTargetScript,
105
+ redeemVersion: 192,
106
+ };
107
+ return {
108
+ internalPubkey: this.internalPubKeyToXOnly(),
109
+ network: this.network,
110
+ scriptTree: scriptTree,
111
+ redeem: redeem,
112
+ };
113
+ }
114
+ getScriptSolution(input) {
115
+ if (!input.tapScriptSig) {
116
+ throw new Error('Tap script signature is required');
117
+ }
118
+ return [
119
+ this.contractSecret,
120
+ toXOnly(this.signer.publicKey),
121
+ input.tapScriptSig[0].signature,
122
+ input.tapScriptSig[1].signature,
123
+ ];
124
+ }
125
+ internalBuildTransaction(transaction) {
126
+ if (transaction.data.inputs.length === 0) {
127
+ const inputs = this.getInputs();
128
+ const outputs = this.getOutputs();
129
+ transaction.setMaximumFeeRate(this._maximumFeeRate);
130
+ transaction.addInputs(inputs);
131
+ for (let i = 0; i < this.updateInputs.length; i++) {
132
+ transaction.updateInput(i, this.updateInputs[i]);
133
+ }
134
+ transaction.addOutputs(outputs);
135
+ }
136
+ try {
137
+ this.signInput(transaction, transaction.data.inputs[0], 0, this.scriptSigner);
138
+ this.signInput(transaction, transaction.data.inputs[0], 0);
139
+ try {
140
+ transaction.finalizeInput(0, this.customFinalizer);
141
+ }
142
+ catch (e) {
143
+ console.log(e);
144
+ }
145
+ if (this.finalized) {
146
+ this.transactionFee = BigInt(transaction.getFee());
147
+ }
148
+ return true;
149
+ }
150
+ catch (e) {
151
+ const err = e;
152
+ this.error(`[internalBuildTransaction] Something went wrong while getting building the transaction: ${err.stack}`);
153
+ }
154
+ return false;
155
+ }
156
+ addVaultUTXO(utxo, pubkeys, minimumSignatures) {
157
+ const tapInput = this.generateTapDataForInput(pubkeys, minimumSignatures);
158
+ const tap = payments.p2tr(tapInput);
159
+ if (!tap.witness)
160
+ throw new Error('Failed to generate taproot witness');
161
+ this.disableRBF();
162
+ const controlBlock = tap.witness[tap.witness.length - 1];
163
+ const input = {
164
+ hash: utxo.hash,
165
+ index: utxo.outputIndex,
166
+ witnessUtxo: {
167
+ script: Buffer.from(utxo.output, 'base64'),
168
+ value: Number(utxo.value),
169
+ },
170
+ tapInternalKey: tapInput.internalPubkey,
171
+ sequence: this.sequence,
172
+ tapLeafScript: [
173
+ {
174
+ leafVersion: tapInput.redeem.redeemVersion,
175
+ script: tapInput.redeem.output,
176
+ controlBlock: controlBlock,
177
+ },
178
+ ],
179
+ };
180
+ this.addInput(input);
181
+ }
182
+ addVaultInputs(vault) {
183
+ const pubKeys = vault.publicKeys.map((key) => Buffer.from(key, 'base64'));
184
+ for (const utxo of vault.utxos) {
185
+ this.addVaultUTXO(utxo, pubKeys, vault.minimum);
186
+ }
187
+ }
188
+ calculateOutputLeftAmountFromVaults(vaults) {
189
+ const total = this.getVaultTotalOutputAmount(vaults);
190
+ return total - this.amount;
191
+ }
192
+ getVaultTotalOutputAmount(vaults) {
193
+ let total = BigInt(0);
194
+ for (const vault of vaults) {
195
+ for (const utxo of vault.utxos) {
196
+ total += BigInt(utxo.value);
197
+ }
198
+ }
199
+ return total;
200
+ }
201
+ }
@@ -158,7 +158,7 @@ export class TransactionBuilder extends TweakedTransaction {
158
158
  });
159
159
  const builtTx = await this.internalBuildTransaction(fakeTx);
160
160
  if (builtTx) {
161
- const tx = fakeTx.extractTransaction(false, true);
161
+ const tx = fakeTx.extractTransaction(true, true);
162
162
  const size = tx.virtualSize();
163
163
  const fee = this.feeRate * size;
164
164
  this.estimatedFees = BigInt(Math.ceil(fee) + 1);
@@ -0,0 +1,34 @@
1
+ /// <reference types="node" />
2
+ import { Taptree } from 'bitcoinjs-lib/src/types.js';
3
+ import { TransactionType } from '../enums/TransactionType.js';
4
+ import { IUnwrapParameters } from '../interfaces/ITransactionParameters.js';
5
+ import { SharedInteractionTransaction } from './SharedInteractionTransaction.js';
6
+ import { Psbt } from 'bitcoinjs-lib';
7
+ import { VaultUTXOs } from '../processor/PsbtTransaction.js';
8
+ export declare class UnwrapTransaction extends SharedInteractionTransaction<TransactionType.WBTC_UNWRAP> {
9
+ static readonly MINIMUM_CONSOLIDATION_AMOUNT: bigint;
10
+ private static readonly UNWRAP_SELECTOR;
11
+ type: TransactionType.WBTC_UNWRAP;
12
+ readonly amount: bigint;
13
+ protected readonly compiledTargetScript: Buffer;
14
+ protected readonly scriptTree: Taptree;
15
+ protected sighashTypes: number[];
16
+ protected readonly contractSecret: Buffer;
17
+ protected readonly vaultUTXOs: VaultUTXOs[];
18
+ private readonly wbtc;
19
+ private readonly calculatedSignHash;
20
+ constructor(parameters: IUnwrapParameters);
21
+ static generateBurnCalldata(amount: bigint): Buffer;
22
+ signPSBT(): Psbt;
23
+ mergeVaults(input: VaultUTXOs[]): void;
24
+ protected internalBuildTransaction(transaction: Psbt): boolean;
25
+ protected generateMultiSignRedeemScript(publicKeys: string[], minimum: number): {
26
+ witnessUtxo: Buffer;
27
+ redeemScript: Buffer;
28
+ witnessScript: Buffer;
29
+ };
30
+ private addVaultUTXO;
31
+ private addVaultInputs;
32
+ private calculateOutputLeftAmountFromVaults;
33
+ private getVaultTotalOutputAmount;
34
+ }
@@ -0,0 +1,184 @@
1
+ import { TransactionType } from '../enums/TransactionType.js';
2
+ import { SharedInteractionTransaction } from './SharedInteractionTransaction.js';
3
+ import { TransactionBuilder } from './TransactionBuilder.js';
4
+ import { ABICoder, BinaryWriter } from '@btc-vision/bsi-binary';
5
+ import { wBTC } from '../../metadata/contracts/wBTC.js';
6
+ import { payments } from 'bitcoinjs-lib';
7
+ import { EcKeyPair } from '../../keypair/EcKeyPair.js';
8
+ import { PsbtTransaction } from '../processor/PsbtTransaction.js';
9
+ const abiCoder = new ABICoder();
10
+ export class UnwrapTransaction extends SharedInteractionTransaction {
11
+ static MINIMUM_CONSOLIDATION_AMOUNT = 200000n;
12
+ static UNWRAP_SELECTOR = Number('0x' + abiCoder.encodeSelector('burn'));
13
+ type = TransactionType.WBTC_UNWRAP;
14
+ amount;
15
+ compiledTargetScript;
16
+ scriptTree;
17
+ sighashTypes = [];
18
+ contractSecret;
19
+ vaultUTXOs;
20
+ wbtc;
21
+ calculatedSignHash = PsbtTransaction.calculateSignHash(this.sighashTypes);
22
+ constructor(parameters) {
23
+ if (parameters.amount < TransactionBuilder.MINIMUM_DUST) {
24
+ throw new Error('Amount is below dust limit');
25
+ }
26
+ parameters.disableAutoRefund = true;
27
+ parameters.calldata = UnwrapTransaction.generateBurnCalldata(parameters.amount);
28
+ super(parameters);
29
+ this.wbtc = new wBTC(parameters.network);
30
+ this.to = this.wbtc.getAddress();
31
+ this.vaultUTXOs = parameters.unwrapUTXOs;
32
+ this.amount = parameters.amount;
33
+ this.contractSecret = this.generateSecret();
34
+ this.compiledTargetScript = this.calldataGenerator.compile(this.calldata, this.contractSecret);
35
+ this.scriptTree = this.getScriptTree();
36
+ this.internalInit();
37
+ }
38
+ static generateBurnCalldata(amount) {
39
+ if (!amount)
40
+ throw new Error('Amount is required');
41
+ const bufWriter = new BinaryWriter();
42
+ bufWriter.writeSelector(UnwrapTransaction.UNWRAP_SELECTOR);
43
+ bufWriter.writeU256(amount);
44
+ return Buffer.from(bufWriter.getBuffer());
45
+ }
46
+ signPSBT() {
47
+ if (this.to && !EcKeyPair.verifyContractAddress(this.to, this.network)) {
48
+ throw new Error('Invalid contract address. The contract address must be a taproot address.');
49
+ }
50
+ if (!this.vaultUTXOs.length) {
51
+ throw new Error('No vault UTXOs provided');
52
+ }
53
+ if (this.signed)
54
+ throw new Error('Transaction is already signed');
55
+ this.signed = true;
56
+ this.buildTransaction();
57
+ this.ignoreSignatureError();
58
+ this.mergeVaults(this.vaultUTXOs);
59
+ const builtTx = this.internalBuildTransaction(this.transaction);
60
+ if (builtTx) {
61
+ return this.transaction;
62
+ }
63
+ throw new Error('Could not sign transaction');
64
+ }
65
+ mergeVaults(input) {
66
+ const firstVault = input[0];
67
+ if (!firstVault) {
68
+ throw new Error('No vaults provided');
69
+ }
70
+ const total = this.getVaultTotalOutputAmount(input);
71
+ if (total < this.amount) {
72
+ throw new Error(`Total vault amount (${total} sat) is less than the amount to unwrap (${this.amount} sat)`);
73
+ }
74
+ const outputLeftAmount = this.calculateOutputLeftAmountFromVaults(input);
75
+ if (outputLeftAmount < UnwrapTransaction.MINIMUM_CONSOLIDATION_AMOUNT) {
76
+ throw new Error(`Output left amount is below minimum consolidation (${UnwrapTransaction.MINIMUM_CONSOLIDATION_AMOUNT} sat) amount ${outputLeftAmount} for vault ${firstVault.vault}`);
77
+ }
78
+ this.addOutput({
79
+ address: firstVault.vault,
80
+ value: Number(outputLeftAmount),
81
+ });
82
+ this.addOutput({
83
+ address: this.from,
84
+ value: Number(this.amount),
85
+ });
86
+ for (const vault of input) {
87
+ this.addVaultInputs(vault);
88
+ }
89
+ }
90
+ internalBuildTransaction(transaction) {
91
+ if (transaction.data.inputs.length === 0) {
92
+ const inputs = this.getInputs();
93
+ const outputs = this.getOutputs();
94
+ transaction.setMaximumFeeRate(this._maximumFeeRate);
95
+ transaction.addInputs(inputs);
96
+ for (let i = 0; i < this.updateInputs.length; i++) {
97
+ transaction.updateInput(i, this.updateInputs[i]);
98
+ }
99
+ transaction.addOutputs(outputs);
100
+ }
101
+ try {
102
+ this.signInputs(transaction);
103
+ if (this.finalized) {
104
+ this.transactionFee = BigInt(transaction.getFee());
105
+ }
106
+ return true;
107
+ }
108
+ catch (e) {
109
+ const err = e;
110
+ this.error(`[internalBuildTransaction] Something went wrong while getting building the transaction: ${err.stack}`);
111
+ }
112
+ return false;
113
+ }
114
+ generateMultiSignRedeemScript(publicKeys, minimum) {
115
+ const p2ms = payments.p2ms({
116
+ m: minimum,
117
+ pubkeys: publicKeys.map((key) => Buffer.from(key, 'base64')),
118
+ network: this.network,
119
+ });
120
+ const p2wsh = payments.p2wsh({
121
+ redeem: p2ms,
122
+ network: this.network,
123
+ });
124
+ const witnessUtxo = p2wsh.output;
125
+ const redeemScript = p2wsh.redeem?.output;
126
+ const witnessScript = p2ms.output;
127
+ if (!witnessUtxo || !redeemScript || !witnessScript) {
128
+ throw new Error('Failed to generate redeem script');
129
+ }
130
+ return {
131
+ witnessUtxo,
132
+ redeemScript,
133
+ witnessScript,
134
+ };
135
+ }
136
+ addVaultUTXO(utxo, witness) {
137
+ const input = {
138
+ hash: utxo.hash,
139
+ index: utxo.outputIndex,
140
+ witnessUtxo: {
141
+ script: Buffer.from(utxo.output, 'base64'),
142
+ value: Number(utxo.value),
143
+ },
144
+ witnessScript: witness.witnessScript,
145
+ sequence: this.sequence,
146
+ };
147
+ if (this.calculatedSignHash) {
148
+ input.sighashType = this.calculatedSignHash;
149
+ }
150
+ this.addInput(input);
151
+ }
152
+ addVaultInputs(vault, firstSigner = this.signer) {
153
+ const p2wshOutput = this.generateMultiSignRedeemScript(vault.publicKeys, vault.minimum);
154
+ for (const utxo of vault.utxos) {
155
+ const inputIndex = this.transaction.inputCount;
156
+ this.addVaultUTXO(utxo, p2wshOutput);
157
+ if (firstSigner) {
158
+ this.log(`Signing input ${inputIndex} with ${firstSigner.publicKey.toString('hex')}`);
159
+ try {
160
+ this.signInput(this.transaction, this.transaction.data.inputs[inputIndex], inputIndex, this.signer);
161
+ this.log(`Signed input ${inputIndex} with ${firstSigner.publicKey.toString('hex')}`);
162
+ }
163
+ catch (e) {
164
+ if (!this.ignoreSignatureErrors) {
165
+ this.warn(`Failed to sign input ${inputIndex} with ${firstSigner.publicKey.toString('hex')} ${e.message}`);
166
+ }
167
+ }
168
+ }
169
+ }
170
+ }
171
+ calculateOutputLeftAmountFromVaults(vaults) {
172
+ const total = this.getVaultTotalOutputAmount(vaults);
173
+ return total - this.amount;
174
+ }
175
+ getVaultTotalOutputAmount(vaults) {
176
+ let total = BigInt(0);
177
+ for (const vault of vaults) {
178
+ for (const utxo of vault.utxos) {
179
+ total += BigInt(utxo.value);
180
+ }
181
+ }
182
+ return total;
183
+ }
184
+ }
@@ -0,0 +1,35 @@
1
+ /// <reference types="node" />
2
+ import { Taptree } from 'bitcoinjs-lib/src/types.js';
3
+ import { TransactionType } from '../enums/TransactionType.js';
4
+ import { IUnwrapParameters } from '../interfaces/ITransactionParameters.js';
5
+ import { SharedInteractionTransaction } from './SharedInteractionTransaction.js';
6
+ import { Psbt } from 'bitcoinjs-lib';
7
+ import { VaultUTXOs } from '../processor/PsbtTransaction.js';
8
+ export declare class UnwrapTransaction extends SharedInteractionTransaction<TransactionType.WBTC_UNWRAP> {
9
+ static readonly MINIMUM_CONSOLIDATION_AMOUNT: bigint;
10
+ private static readonly UNWRAP_SELECTOR;
11
+ type: TransactionType.WBTC_UNWRAP;
12
+ readonly amount: bigint;
13
+ protected readonly compiledTargetScript: Buffer;
14
+ protected readonly scriptTree: Taptree;
15
+ protected sighashTypes: number[];
16
+ protected readonly contractSecret: Buffer;
17
+ protected readonly vaultUTXOs: VaultUTXOs[];
18
+ private readonly wbtc;
19
+ private readonly calculatedSignHash;
20
+ constructor(parameters: IUnwrapParameters);
21
+ static generateBurnCalldata(amount: bigint): Buffer;
22
+ signPSBT(): Psbt;
23
+ mergeVaults(input: VaultUTXOs[]): void;
24
+ estimateVaultFees(feeRate: bigint, numInputs: bigint, numOutputs: bigint, numSignatures: bigint, numPubkeys: bigint): bigint;
25
+ protected internalBuildTransaction(transaction: Psbt): boolean;
26
+ protected generateMultiSignRedeemScript(publicKeys: string[], minimum: number): {
27
+ witnessUtxo: Buffer;
28
+ redeemScript: Buffer;
29
+ witnessScript: Buffer;
30
+ };
31
+ private addVaultUTXO;
32
+ private addVaultInputs;
33
+ private calculateOutputLeftAmountFromVaults;
34
+ private getVaultTotalOutputAmount;
35
+ }
@@ -0,0 +1,199 @@
1
+ import { TransactionType } from '../enums/TransactionType.js';
2
+ import { SharedInteractionTransaction } from './SharedInteractionTransaction.js';
3
+ import { TransactionBuilder } from './TransactionBuilder.js';
4
+ import { ABICoder, BinaryWriter } from '@btc-vision/bsi-binary';
5
+ import { wBTC } from '../../metadata/contracts/wBTC.js';
6
+ import { payments } from 'bitcoinjs-lib';
7
+ import { EcKeyPair } from '../../keypair/EcKeyPair.js';
8
+ import { PsbtTransaction } from '../processor/PsbtTransaction.js';
9
+ const abiCoder = new ABICoder();
10
+ export class UnwrapTransaction extends SharedInteractionTransaction {
11
+ static MINIMUM_CONSOLIDATION_AMOUNT = 200000n;
12
+ static UNWRAP_SELECTOR = Number('0x' + abiCoder.encodeSelector('burn'));
13
+ type = TransactionType.WBTC_UNWRAP;
14
+ amount;
15
+ compiledTargetScript;
16
+ scriptTree;
17
+ sighashTypes = [];
18
+ contractSecret;
19
+ vaultUTXOs;
20
+ wbtc;
21
+ calculatedSignHash = PsbtTransaction.calculateSignHash(this.sighashTypes);
22
+ constructor(parameters) {
23
+ if (parameters.amount < TransactionBuilder.MINIMUM_DUST) {
24
+ throw new Error('Amount is below dust limit');
25
+ }
26
+ parameters.disableAutoRefund = true;
27
+ parameters.calldata = UnwrapTransaction.generateBurnCalldata(parameters.amount);
28
+ super(parameters);
29
+ this.wbtc = new wBTC(parameters.network);
30
+ this.to = this.wbtc.getAddress();
31
+ this.vaultUTXOs = parameters.unwrapUTXOs;
32
+ this.amount = parameters.amount;
33
+ this.contractSecret = this.generateSecret();
34
+ this.compiledTargetScript = this.calldataGenerator.compile(this.calldata, this.contractSecret);
35
+ this.scriptTree = this.getScriptTree();
36
+ this.internalInit();
37
+ }
38
+ static generateBurnCalldata(amount) {
39
+ if (!amount)
40
+ throw new Error('Amount is required');
41
+ const bufWriter = new BinaryWriter();
42
+ bufWriter.writeSelector(UnwrapTransaction.UNWRAP_SELECTOR);
43
+ bufWriter.writeU256(amount);
44
+ return Buffer.from(bufWriter.getBuffer());
45
+ }
46
+ signPSBT() {
47
+ if (this.to && !EcKeyPair.verifyContractAddress(this.to, this.network)) {
48
+ throw new Error('Invalid contract address. The contract address must be a taproot address.');
49
+ }
50
+ if (!this.vaultUTXOs.length) {
51
+ throw new Error('No vault UTXOs provided');
52
+ }
53
+ if (this.signed)
54
+ throw new Error('Transaction is already signed');
55
+ this.signed = true;
56
+ this.buildTransaction();
57
+ this.ignoreSignatureError();
58
+ this.mergeVaults(this.vaultUTXOs);
59
+ const builtTx = this.internalBuildTransaction(this.transaction);
60
+ if (builtTx) {
61
+ return this.transaction;
62
+ }
63
+ throw new Error('Could not sign transaction');
64
+ }
65
+ mergeVaults(input) {
66
+ const firstVault = input[0];
67
+ if (!firstVault) {
68
+ throw new Error('No vaults provided');
69
+ }
70
+ const total = this.getVaultTotalOutputAmount(input);
71
+ if (total < this.amount) {
72
+ throw new Error(`Total vault amount (${total} sat) is less than the amount to unwrap (${this.amount} sat)`);
73
+ }
74
+ const outputLeftAmount = this.calculateOutputLeftAmountFromVaults(input);
75
+ console.log('outputLeftAmount', outputLeftAmount, this.amount);
76
+ if (outputLeftAmount < UnwrapTransaction.MINIMUM_CONSOLIDATION_AMOUNT) {
77
+ throw new Error(`Output left amount is below minimum consolidation (${UnwrapTransaction.MINIMUM_CONSOLIDATION_AMOUNT} sat) amount ${outputLeftAmount} for vault ${firstVault.vault}`);
78
+ }
79
+ this.addOutput({
80
+ address: firstVault.vault,
81
+ value: Number(outputLeftAmount),
82
+ });
83
+ this.addOutput({
84
+ address: this.from,
85
+ value: Number(this.amount),
86
+ });
87
+ for (const vault of input) {
88
+ this.addVaultInputs(vault);
89
+ }
90
+ }
91
+ estimateVaultFees(feeRate, numInputs, numOutputs, numSignatures, numPubkeys) {
92
+ const txHeaderSize = 10n;
93
+ const inputBaseSize = 41n;
94
+ const outputSize = 68n;
95
+ const signatureSize = 144n;
96
+ const pubkeySize = 34n;
97
+ const baseTxSize = txHeaderSize + inputBaseSize * numInputs + outputSize * numOutputs;
98
+ const redeemScriptSize = 1n + numPubkeys * (1n + pubkeySize) + 1n + numSignatures;
99
+ const witnessSize = numSignatures * signatureSize + numPubkeys * pubkeySize + redeemScriptSize;
100
+ const weight = baseTxSize * 3n + (baseTxSize + witnessSize);
101
+ const vSize = weight / 4n;
102
+ return vSize * feeRate;
103
+ }
104
+ internalBuildTransaction(transaction) {
105
+ if (transaction.data.inputs.length === 0) {
106
+ const inputs = this.getInputs();
107
+ const outputs = this.getOutputs();
108
+ transaction.setMaximumFeeRate(this._maximumFeeRate);
109
+ transaction.addInputs(inputs);
110
+ for (let i = 0; i < this.updateInputs.length; i++) {
111
+ transaction.updateInput(i, this.updateInputs[i]);
112
+ }
113
+ transaction.addOutputs(outputs);
114
+ }
115
+ try {
116
+ this.signInputs(transaction);
117
+ if (this.finalized) {
118
+ this.transactionFee = BigInt(transaction.getFee());
119
+ }
120
+ return true;
121
+ }
122
+ catch (e) {
123
+ const err = e;
124
+ this.error(`[internalBuildTransaction] Something went wrong while getting building the transaction: ${err.stack}`);
125
+ }
126
+ return false;
127
+ }
128
+ generateMultiSignRedeemScript(publicKeys, minimum) {
129
+ const p2ms = payments.p2ms({
130
+ m: minimum,
131
+ pubkeys: publicKeys.map((key) => Buffer.from(key, 'base64')),
132
+ network: this.network,
133
+ });
134
+ const p2wsh = payments.p2wsh({
135
+ redeem: p2ms,
136
+ network: this.network,
137
+ });
138
+ const witnessUtxo = p2wsh.output;
139
+ const redeemScript = p2wsh.redeem?.output;
140
+ const witnessScript = p2ms.output;
141
+ if (!witnessUtxo || !redeemScript || !witnessScript) {
142
+ throw new Error('Failed to generate redeem script');
143
+ }
144
+ return {
145
+ witnessUtxo,
146
+ redeemScript,
147
+ witnessScript,
148
+ };
149
+ }
150
+ addVaultUTXO(utxo, witness) {
151
+ console.log(Number(utxo.value), utxo.hash, utxo.outputIndex);
152
+ const input = {
153
+ hash: utxo.hash,
154
+ index: utxo.outputIndex,
155
+ witnessUtxo: {
156
+ script: Buffer.from(utxo.output, 'base64'),
157
+ value: Number(utxo.value),
158
+ },
159
+ witnessScript: witness.witnessScript,
160
+ sequence: this.sequence,
161
+ };
162
+ if (this.calculatedSignHash) {
163
+ input.sighashType = this.calculatedSignHash;
164
+ }
165
+ this.addInput(input);
166
+ }
167
+ addVaultInputs(vault, firstSigner = this.signer) {
168
+ const p2wshOutput = this.generateMultiSignRedeemScript(vault.publicKeys, vault.minimum);
169
+ for (const utxo of vault.utxos) {
170
+ const inputIndex = this.transaction.inputCount;
171
+ this.addVaultUTXO(utxo, p2wshOutput);
172
+ if (firstSigner) {
173
+ this.log(`Signing input ${inputIndex} with ${firstSigner.publicKey.toString('hex')}`);
174
+ try {
175
+ this.signInput(this.transaction, this.transaction.data.inputs[inputIndex], inputIndex, this.signer);
176
+ this.log(`Signed input ${inputIndex} with ${firstSigner.publicKey.toString('hex')}`);
177
+ }
178
+ catch (e) {
179
+ if (!this.ignoreSignatureErrors) {
180
+ this.warn(`Failed to sign input ${inputIndex} with ${firstSigner.publicKey.toString('hex')} ${e.message}`);
181
+ }
182
+ }
183
+ }
184
+ }
185
+ }
186
+ calculateOutputLeftAmountFromVaults(vaults) {
187
+ const total = this.getVaultTotalOutputAmount(vaults);
188
+ return total - this.amount;
189
+ }
190
+ getVaultTotalOutputAmount(vaults) {
191
+ let total = BigInt(0);
192
+ for (const vault of vaults) {
193
+ for (const utxo of vault.utxos) {
194
+ total += BigInt(utxo.value);
195
+ }
196
+ }
197
+ return total;
198
+ }
199
+ }