@btc-vision/bitcoin 6.4.9 → 6.4.11

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 (230) hide show
  1. package/.babelrc +4 -4
  2. package/.mocharc.json +13 -13
  3. package/.prettierrc.json +12 -12
  4. package/CHANGELOG.md +403 -403
  5. package/CONTRIBUTING.md +83 -83
  6. package/LICENSE +21 -21
  7. package/README.md +201 -201
  8. package/browser/index.d.ts +1 -1
  9. package/browser/index.js +1 -1
  10. package/browser/{ops.d.ts → opcodes.d.ts} +2 -3
  11. package/browser/script.d.ts +2 -2
  12. package/build/address.js +2 -1
  13. package/build/index.d.ts +1 -1
  14. package/build/index.js +1 -1
  15. package/build/{ops.d.ts → opcodes.d.ts} +2 -3
  16. package/build/{ops.js → opcodes.js} +4 -5
  17. package/build/payments/embed.js +1 -1
  18. package/build/payments/p2ms.js +1 -1
  19. package/build/payments/p2op.js +1 -1
  20. package/build/payments/p2pk.js +1 -1
  21. package/build/payments/p2pkh.js +1 -1
  22. package/build/payments/p2sh.js +3 -3
  23. package/build/payments/p2tr.js +1 -1
  24. package/build/payments/p2wpkh.js +2 -2
  25. package/build/payments/p2wsh.js +2 -2
  26. package/build/push_data.js +9 -9
  27. package/build/script.d.ts +2 -2
  28. package/build/script.js +12 -12
  29. package/build/transaction.js +1 -1
  30. package/cjs/package.json +3 -3
  31. package/gulpfile.js +42 -42
  32. package/package.json +150 -150
  33. package/src/address.ts +304 -303
  34. package/src/bip66.ts +107 -107
  35. package/src/block.ts +233 -233
  36. package/src/bufferutils.ts +188 -188
  37. package/src/crypto.ts +108 -108
  38. package/src/ecc_lib.ts +94 -94
  39. package/src/hooks/AdvancedSignatureManager.ts +104 -104
  40. package/src/hooks/SignatureManager.ts +84 -84
  41. package/src/index.ts +105 -105
  42. package/src/merkle.ts +31 -31
  43. package/src/{ops.ts → opcodes.ts} +280 -282
  44. package/src/payments/bip341.ts +140 -140
  45. package/src/payments/embed.ts +61 -61
  46. package/src/payments/index.ts +172 -172
  47. package/src/payments/lazy.ts +28 -28
  48. package/src/payments/p2ms.ts +156 -156
  49. package/src/payments/p2op.ts +195 -195
  50. package/src/payments/p2pk.ts +93 -93
  51. package/src/payments/p2pkh.ts +214 -214
  52. package/src/payments/p2sh.ts +210 -210
  53. package/src/payments/p2tr.ts +309 -309
  54. package/src/payments/p2wpkh.ts +144 -144
  55. package/src/payments/p2wsh.ts +217 -217
  56. package/src/psbt/bip371.ts +441 -441
  57. package/src/push_data.ts +97 -97
  58. package/src/script.ts +247 -247
  59. package/src/script_number.ts +72 -72
  60. package/src/script_signature.ts +91 -91
  61. package/src/transaction.ts +656 -656
  62. package/test/address.spec.ts +155 -155
  63. package/test/bitcoin.core.spec.ts +212 -212
  64. package/test/block.spec.ts +171 -171
  65. package/test/bufferutils.spec.ts +450 -450
  66. package/test/crypto.spec.ts +49 -49
  67. package/test/fixtures/address.json +329 -329
  68. package/test/fixtures/block.json +148 -148
  69. package/test/fixtures/bufferutils.json +102 -102
  70. package/test/fixtures/core/README.md +26 -26
  71. package/test/fixtures/core/base58_encode_decode.json +50 -50
  72. package/test/fixtures/core/base58_keys_invalid.json +152 -152
  73. package/test/fixtures/core/base58_keys_valid.json +452 -452
  74. package/test/fixtures/core/blocks.json +27 -27
  75. package/test/fixtures/core/sig_canonical.json +7 -7
  76. package/test/fixtures/core/sig_noncanonical.json +33 -33
  77. package/test/fixtures/core/sighash.json +3505 -3505
  78. package/test/fixtures/core/tx_valid.json +2023 -2023
  79. package/test/fixtures/crypto.json +43 -43
  80. package/test/fixtures/ecdsa.json +217 -217
  81. package/test/fixtures/ecpair.json +141 -141
  82. package/test/fixtures/embed.json +108 -108
  83. package/test/fixtures/p2ms.json +434 -434
  84. package/test/fixtures/p2pk.json +179 -179
  85. package/test/fixtures/p2pkh.json +276 -276
  86. package/test/fixtures/p2sh.json +508 -508
  87. package/test/fixtures/p2tr.json +1198 -1198
  88. package/test/fixtures/p2wpkh.json +290 -290
  89. package/test/fixtures/p2wsh.json +489 -489
  90. package/test/fixtures/psbt.json +924 -924
  91. package/test/fixtures/script.json +465 -465
  92. package/test/fixtures/script_number.json +225 -225
  93. package/test/fixtures/signature.json +140 -140
  94. package/test/fixtures/transaction.json +916 -916
  95. package/test/integration/_regtest.ts +6 -6
  96. package/test/integration/addresses.spec.ts +142 -142
  97. package/test/integration/bip32.spec.ts +130 -130
  98. package/test/integration/blocks.spec.ts +28 -28
  99. package/test/integration/cltv.spec.ts +241 -241
  100. package/test/integration/csv.spec.ts +452 -452
  101. package/test/integration/payments.spec.ts +110 -110
  102. package/test/integration/taproot.spec.ts +663 -663
  103. package/test/integration/transactions.spec.ts +668 -668
  104. package/test/payments.spec.ts +114 -114
  105. package/test/payments.utils.ts +165 -165
  106. package/test/psbt.spec.ts +1285 -1285
  107. package/test/script.spec.ts +186 -186
  108. package/test/script_number.spec.ts +26 -26
  109. package/test/script_signature.spec.ts +66 -66
  110. package/test/transaction.spec.ts +337 -337
  111. package/test/ts-node-register.js +7 -7
  112. package/test/tsconfig.json +48 -48
  113. package/test/types.spec.ts +53 -53
  114. package/tsconfig.base.json +27 -27
  115. package/tsconfig.json +19 -19
  116. package/tsconfig.webpack.json +18 -18
  117. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/.ready +0 -0
  118. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/.release-please-manifest.json +0 -3
  119. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/CHANGELOG.md +0 -962
  120. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/CONTRIBUTING.md +0 -34
  121. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/LICENSE +0 -24
  122. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/README.md +0 -273
  123. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/SECURITY.md +0 -2
  124. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/addon.gypi +0 -204
  125. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/bin/node-gyp.js +0 -138
  126. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/.release-please-manifest.json +0 -3
  127. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/LICENSE +0 -28
  128. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/data/ninja/build.ninja +0 -4
  129. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/data/win/large-pdb-shim.cc +0 -12
  130. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/GypVsCMake.md +0 -116
  131. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/Hacking.md +0 -46
  132. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/InputFormatReference.md +0 -1080
  133. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/LanguageSpecification.md +0 -430
  134. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/README.md +0 -27
  135. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/Testing.md +0 -450
  136. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/docs/UserDocumentation.md +0 -965
  137. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/gyp +0 -8
  138. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/gyp.bat +0 -5
  139. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/gyp_main.py +0 -45
  140. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSNew.py +0 -365
  141. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSProject.py +0 -206
  142. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSSettings.py +0 -1272
  143. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSSettings_test.py +0 -1547
  144. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSToolFile.py +0 -59
  145. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSUserFile.py +0 -153
  146. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSUtil.py +0 -271
  147. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/MSVSVersion.py +0 -574
  148. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/__init__.py +0 -692
  149. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/common.py +0 -711
  150. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/common_test.py +0 -171
  151. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/easy_xml.py +0 -169
  152. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/easy_xml_test.py +0 -113
  153. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/flock_tool.py +0 -55
  154. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/__init__.py +0 -0
  155. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/analyzer.py +0 -804
  156. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/android.py +0 -1173
  157. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/cmake.py +0 -1318
  158. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/compile_commands_json.py +0 -127
  159. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/dump_dependency_json.py +0 -103
  160. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/eclipse.py +0 -461
  161. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/gypd.py +0 -89
  162. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/gypsh.py +0 -57
  163. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/make.py +0 -2745
  164. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/msvs.py +0 -3976
  165. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/msvs_test.py +0 -44
  166. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/ninja.py +0 -2964
  167. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/ninja_test.py +0 -67
  168. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/xcode.py +0 -1391
  169. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/generator/xcode_test.py +0 -25
  170. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/input.py +0 -3115
  171. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/input_test.py +0 -98
  172. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/mac_tool.py +0 -771
  173. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/msvs_emulation.py +0 -1260
  174. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/ninja_syntax.py +0 -174
  175. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/simple_copy.py +0 -61
  176. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/win_tool.py +0 -373
  177. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation.py +0 -1938
  178. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation_test.py +0 -53
  179. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xcode_ninja.py +0 -302
  180. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xcodeproj_file.py +0 -3198
  181. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/gyp/xml_fix.py +0 -65
  182. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/LICENSE +0 -3
  183. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/LICENSE.APACHE +0 -177
  184. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/LICENSE.BSD +0 -23
  185. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/__init__.py +0 -15
  186. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_elffile.py +0 -108
  187. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_manylinux.py +0 -252
  188. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_musllinux.py +0 -83
  189. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_parser.py +0 -359
  190. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_structures.py +0 -61
  191. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/_tokenizer.py +0 -192
  192. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/markers.py +0 -252
  193. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/metadata.py +0 -825
  194. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/py.typed +0 -0
  195. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/requirements.py +0 -90
  196. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/specifiers.py +0 -1030
  197. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/tags.py +0 -553
  198. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/utils.py +0 -172
  199. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pylib/packaging/version.py +0 -563
  200. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/pyproject.toml +0 -120
  201. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/release-please-config.json +0 -11
  202. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/gyp/test_gyp.py +0 -261
  203. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/Find-VisualStudio.cs +0 -250
  204. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/build.js +0 -227
  205. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/clean.js +0 -15
  206. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/configure.js +0 -328
  207. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/create-config-gypi.js +0 -150
  208. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/download.js +0 -39
  209. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/find-node-directory.js +0 -63
  210. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/find-python.js +0 -310
  211. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/find-visualstudio.js +0 -590
  212. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/install.js +0 -415
  213. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/list.js +0 -26
  214. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/log.js +0 -168
  215. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/node-gyp.js +0 -188
  216. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/process-release.js +0 -146
  217. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/rebuild.js +0 -12
  218. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/remove.js +0 -43
  219. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/lib/util.js +0 -81
  220. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/macOS_Catalina_acid_test.sh +0 -21
  221. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/package.json +0 -51
  222. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/release-please-config.json +0 -40
  223. package/.yarn/unplugged/node-gyp-npm-10.2.0-cad1109948/node_modules/node-gyp/src/win_delay_load_hook.cc +0 -39
  224. package/coverage/tmp/coverage-31752-1735543485354-0.json +0 -1
  225. package/coverage/tmp/coverage-59920-1735543484555-0.json +0 -1
  226. package/coverage/tmp/coverage-66252-1735543483919-0.json +0 -1
  227. package/coverage/tmp/coverage-68440-1735543485236-0.json +0 -1
  228. package/coverage/tmp/coverage-70588-1735543484426-0.json +0 -1
  229. package/coverage/tmp/coverage-79292-1735543485296-0.json +0 -1
  230. package/coverage/tmp/coverage-80212-1735543483980-0.json +0 -1
@@ -1,590 +0,0 @@
1
- 'use strict'
2
-
3
- const log = require('./log')
4
- const { existsSync } = require('fs')
5
- const { win32: path } = require('path')
6
- const { regSearchKeys, execFile } = require('./util')
7
-
8
- class VisualStudioFinder {
9
- static findVisualStudio = (...args) => new VisualStudioFinder(...args).findVisualStudio()
10
-
11
- log = log.withPrefix('find VS')
12
-
13
- regSearchKeys = regSearchKeys
14
-
15
- constructor (nodeSemver, configMsvsVersion) {
16
- this.nodeSemver = nodeSemver
17
- this.configMsvsVersion = configMsvsVersion
18
- this.errorLog = []
19
- this.validVersions = []
20
- }
21
-
22
- // Logs a message at verbose level, but also saves it to be displayed later
23
- // at error level if an error occurs. This should help diagnose the problem.
24
- addLog (message) {
25
- this.log.verbose(message)
26
- this.errorLog.push(message)
27
- }
28
-
29
- async findVisualStudio () {
30
- this.configVersionYear = null
31
- this.configPath = null
32
- if (this.configMsvsVersion) {
33
- this.addLog('msvs_version was set from command line or npm config')
34
- if (this.configMsvsVersion.match(/^\d{4}$/)) {
35
- this.configVersionYear = parseInt(this.configMsvsVersion, 10)
36
- this.addLog(
37
- `- looking for Visual Studio version ${this.configVersionYear}`)
38
- } else {
39
- this.configPath = path.resolve(this.configMsvsVersion)
40
- this.addLog(
41
- `- looking for Visual Studio installed in "${this.configPath}"`)
42
- }
43
- } else {
44
- this.addLog('msvs_version not set from command line or npm config')
45
- }
46
-
47
- if (process.env.VCINSTALLDIR) {
48
- this.envVcInstallDir =
49
- path.resolve(process.env.VCINSTALLDIR, '..')
50
- this.addLog('running in VS Command Prompt, installation path is:\n' +
51
- `"${this.envVcInstallDir}"\n- will only use this version`)
52
- } else {
53
- this.addLog('VCINSTALLDIR not set, not running in VS Command Prompt')
54
- }
55
-
56
- const checks = [
57
- () => this.findVisualStudio2019OrNewerFromSpecifiedLocation(),
58
- () => this.findVisualStudio2019OrNewerUsingSetupModule(),
59
- () => this.findVisualStudio2019OrNewer(),
60
- () => this.findVisualStudio2017FromSpecifiedLocation(),
61
- () => this.findVisualStudio2017UsingSetupModule(),
62
- () => this.findVisualStudio2017(),
63
- () => this.findVisualStudio2015(),
64
- () => this.findVisualStudio2013()
65
- ]
66
-
67
- for (const check of checks) {
68
- const info = await check()
69
- if (info) {
70
- return this.succeed(info)
71
- }
72
- }
73
-
74
- return this.fail()
75
- }
76
-
77
- succeed (info) {
78
- this.log.info(`using VS${info.versionYear} (${info.version}) found at:` +
79
- `\n"${info.path}"` +
80
- '\nrun with --verbose for detailed information')
81
- return info
82
- }
83
-
84
- fail () {
85
- if (this.configMsvsVersion && this.envVcInstallDir) {
86
- this.errorLog.push(
87
- 'msvs_version does not match this VS Command Prompt or the',
88
- 'installation cannot be used.')
89
- } else if (this.configMsvsVersion) {
90
- // If msvs_version was specified but finding VS failed, print what would
91
- // have been accepted
92
- this.errorLog.push('')
93
- if (this.validVersions) {
94
- this.errorLog.push('valid versions for msvs_version:')
95
- this.validVersions.forEach((version) => {
96
- this.errorLog.push(`- "${version}"`)
97
- })
98
- } else {
99
- this.errorLog.push('no valid versions for msvs_version were found')
100
- }
101
- }
102
-
103
- const errorLog = this.errorLog.join('\n')
104
-
105
- // For Windows 80 col console, use up to the column before the one marked
106
- // with X (total 79 chars including logger prefix, 62 chars usable here):
107
- // X
108
- const infoLog = [
109
- '**************************************************************',
110
- 'You need to install the latest version of Visual Studio',
111
- 'including the "Desktop development with C++" workload.',
112
- 'For more information consult the documentation at:',
113
- 'https://github.com/nodejs/node-gyp#on-windows',
114
- '**************************************************************'
115
- ].join('\n')
116
-
117
- this.log.error(`\n${errorLog}\n\n${infoLog}\n`)
118
- throw new Error('Could not find any Visual Studio installation to use')
119
- }
120
-
121
- async findVisualStudio2019OrNewerFromSpecifiedLocation () {
122
- return this.findVSFromSpecifiedLocation([2019, 2022])
123
- }
124
-
125
- async findVisualStudio2017FromSpecifiedLocation () {
126
- if (this.nodeSemver.major >= 22) {
127
- this.addLog(
128
- 'not looking for VS2017 as it is only supported up to Node.js 21')
129
- return null
130
- }
131
- return this.findVSFromSpecifiedLocation([2017])
132
- }
133
-
134
- async findVSFromSpecifiedLocation (supportedYears) {
135
- if (!this.envVcInstallDir) {
136
- return null
137
- }
138
- const info = {
139
- path: path.resolve(this.envVcInstallDir),
140
- // Assume the version specified by the user is correct.
141
- // Since Visual Studio 2015, the Developer Command Prompt sets the
142
- // VSCMD_VER environment variable which contains the version information
143
- // for Visual Studio.
144
- // https://learn.microsoft.com/en-us/visualstudio/ide/reference/command-prompt-powershell?view=vs-2022
145
- version: process.env.VSCMD_VER,
146
- packages: [
147
- 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64',
148
- // Assume MSBuild exists. It will be checked in processing.
149
- 'Microsoft.VisualStudio.VC.MSBuild.Base'
150
- ]
151
- }
152
-
153
- // Is there a better way to get SDK information?
154
- const envWindowsSDKVersion = process.env.WindowsSDKVersion
155
- const sdkVersionMatched = envWindowsSDKVersion?.match(/^(\d+)\.(\d+)\.(\d+)\..*/)
156
- if (sdkVersionMatched) {
157
- info.packages.push(`Microsoft.VisualStudio.Component.Windows10SDK.${sdkVersionMatched[3]}.Desktop`)
158
- }
159
- // pass for further processing
160
- return this.processData([info], supportedYears)
161
- }
162
-
163
- async findVisualStudio2019OrNewerUsingSetupModule () {
164
- return this.findNewVSUsingSetupModule([2019, 2022])
165
- }
166
-
167
- async findVisualStudio2017UsingSetupModule () {
168
- if (this.nodeSemver.major >= 22) {
169
- this.addLog(
170
- 'not looking for VS2017 as it is only supported up to Node.js 21')
171
- return null
172
- }
173
- return this.findNewVSUsingSetupModule([2017])
174
- }
175
-
176
- async findNewVSUsingSetupModule (supportedYears) {
177
- const ps = path.join(process.env.SystemRoot, 'System32',
178
- 'WindowsPowerShell', 'v1.0', 'powershell.exe')
179
- const vcInstallDir = this.envVcInstallDir
180
-
181
- const checkModuleArgs = [
182
- '-NoProfile',
183
- '-Command',
184
- '&{@(Get-Module -ListAvailable -Name VSSetup).Version.ToString()}'
185
- ]
186
- this.log.silly('Running', ps, checkModuleArgs)
187
- const [cErr] = await this.execFile(ps, checkModuleArgs)
188
- if (cErr) {
189
- this.addLog('VSSetup module doesn\'t seem to exist. You can install it via: "Install-Module VSSetup -Scope CurrentUser"')
190
- this.log.silly('VSSetup error = %j', cErr && (cErr.stack || cErr))
191
- return null
192
- }
193
- const filterArg = vcInstallDir !== undefined ? `| where {$_.InstallationPath -eq '${vcInstallDir}' }` : ''
194
- const psArgs = [
195
- '-NoProfile',
196
- '-Command',
197
- `&{Get-VSSetupInstance ${filterArg} | ConvertTo-Json -Depth 3}`
198
- ]
199
-
200
- this.log.silly('Running', ps, psArgs)
201
- const [err, stdout, stderr] = await this.execFile(ps, psArgs)
202
- let parsedData = this.parseData(err, stdout, stderr)
203
- if (parsedData === null) {
204
- return null
205
- }
206
- this.log.silly('Parsed data', parsedData)
207
- if (!Array.isArray(parsedData)) {
208
- // if there are only 1 result, then Powershell will output non-array
209
- parsedData = [parsedData]
210
- }
211
- // normalize output
212
- parsedData = parsedData.map((info) => {
213
- info.path = info.InstallationPath
214
- info.version = `${info.InstallationVersion.Major}.${info.InstallationVersion.Minor}.${info.InstallationVersion.Build}.${info.InstallationVersion.Revision}`
215
- info.packages = info.Packages.map((p) => p.Id)
216
- return info
217
- })
218
- // pass for further processing
219
- return this.processData(parsedData, supportedYears)
220
- }
221
-
222
- // Invoke the PowerShell script to get information about Visual Studio 2019
223
- // or newer installations
224
- async findVisualStudio2019OrNewer () {
225
- return this.findNewVS([2019, 2022])
226
- }
227
-
228
- // Invoke the PowerShell script to get information about Visual Studio 2017
229
- async findVisualStudio2017 () {
230
- if (this.nodeSemver.major >= 22) {
231
- this.addLog(
232
- 'not looking for VS2017 as it is only supported up to Node.js 21')
233
- return null
234
- }
235
- return this.findNewVS([2017])
236
- }
237
-
238
- // Invoke the PowerShell script to get information about Visual Studio 2017
239
- // or newer installations
240
- async findNewVS (supportedYears) {
241
- const ps = path.join(process.env.SystemRoot, 'System32',
242
- 'WindowsPowerShell', 'v1.0', 'powershell.exe')
243
- const csFile = path.join(__dirname, 'Find-VisualStudio.cs')
244
- const psArgs = [
245
- '-ExecutionPolicy',
246
- 'Unrestricted',
247
- '-NoProfile',
248
- '-Command',
249
- '&{Add-Type -Path \'' + csFile + '\';' + '[VisualStudioConfiguration.Main]::PrintJson()}'
250
- ]
251
-
252
- this.log.silly('Running', ps, psArgs)
253
- const [err, stdout, stderr] = await this.execFile(ps, psArgs)
254
- const parsedData = this.parseData(err, stdout, stderr, { checkIsArray: true })
255
- if (parsedData === null) {
256
- return null
257
- }
258
- return this.processData(parsedData, supportedYears)
259
- }
260
-
261
- // Parse the output of the PowerShell script, make sanity checks
262
- parseData (err, stdout, stderr, sanityCheckOptions) {
263
- const defaultOptions = {
264
- checkIsArray: false
265
- }
266
-
267
- // Merging provided options with the default options
268
- const sanityOptions = { ...defaultOptions, ...sanityCheckOptions }
269
-
270
- this.log.silly('PS stderr = %j', stderr)
271
-
272
- const failPowershell = (failureDetails) => {
273
- this.addLog(
274
- `could not use PowerShell to find Visual Studio 2017 or newer, try re-running with '--loglevel silly' for more details. \n
275
- Failure details: ${failureDetails}`)
276
- return null
277
- }
278
-
279
- if (err) {
280
- this.log.silly('PS err = %j', err && (err.stack || err))
281
- return failPowershell(`${err}`.substring(0, 40))
282
- }
283
-
284
- let vsInfo
285
- try {
286
- vsInfo = JSON.parse(stdout)
287
- } catch (e) {
288
- this.log.silly('PS stdout = %j', stdout)
289
- this.log.silly(e)
290
- return failPowershell()
291
- }
292
-
293
- if (sanityOptions.checkIsArray && !Array.isArray(vsInfo)) {
294
- this.log.silly('PS stdout = %j', stdout)
295
- return failPowershell('Expected array as output of the PS script')
296
- }
297
- return vsInfo
298
- }
299
-
300
- // Process parsed data containing information about VS installations
301
- // Look for the required parts, extract and output them back
302
- processData (vsInfo, supportedYears) {
303
- vsInfo = vsInfo.map((info) => {
304
- this.log.silly(`processing installation: "${info.path}"`)
305
- info.path = path.resolve(info.path)
306
- const ret = this.getVersionInfo(info)
307
- ret.path = info.path
308
- ret.msBuild = this.getMSBuild(info, ret.versionYear)
309
- ret.toolset = this.getToolset(info, ret.versionYear)
310
- ret.sdk = this.getSDK(info)
311
- return ret
312
- })
313
- this.log.silly('vsInfo:', vsInfo)
314
-
315
- // Remove future versions or errors parsing version number
316
- // Also remove any unsupported versions
317
- vsInfo = vsInfo.filter((info) => {
318
- if (info.versionYear && supportedYears.indexOf(info.versionYear) !== -1) {
319
- return true
320
- }
321
- this.addLog(`${info.versionYear ? 'unsupported' : 'unknown'} version "${info.version}" found at "${info.path}"`)
322
- return false
323
- })
324
-
325
- // Sort to place newer versions first
326
- vsInfo.sort((a, b) => b.versionYear - a.versionYear)
327
-
328
- for (let i = 0; i < vsInfo.length; ++i) {
329
- const info = vsInfo[i]
330
- this.addLog(`checking VS${info.versionYear} (${info.version}) found ` +
331
- `at:\n"${info.path}"`)
332
-
333
- if (info.msBuild) {
334
- this.addLog('- found "Visual Studio C++ core features"')
335
- } else {
336
- this.addLog('- "Visual Studio C++ core features" missing')
337
- continue
338
- }
339
-
340
- if (info.toolset) {
341
- this.addLog(`- found VC++ toolset: ${info.toolset}`)
342
- } else {
343
- this.addLog('- missing any VC++ toolset')
344
- continue
345
- }
346
-
347
- if (info.sdk) {
348
- this.addLog(`- found Windows SDK: ${info.sdk}`)
349
- } else {
350
- this.addLog('- missing any Windows SDK')
351
- continue
352
- }
353
-
354
- if (!this.checkConfigVersion(info.versionYear, info.path)) {
355
- continue
356
- }
357
-
358
- return info
359
- }
360
-
361
- this.addLog(
362
- 'could not find a version of Visual Studio 2017 or newer to use')
363
- return null
364
- }
365
-
366
- // Helper - process version information
367
- getVersionInfo (info) {
368
- const match = /^(\d+)\.(\d+)(?:\..*)?/.exec(info.version)
369
- if (!match) {
370
- this.log.silly('- failed to parse version:', info.version)
371
- return {}
372
- }
373
- this.log.silly('- version match = %j', match)
374
- const ret = {
375
- version: info.version,
376
- versionMajor: parseInt(match[1], 10),
377
- versionMinor: parseInt(match[2], 10)
378
- }
379
- if (ret.versionMajor === 15) {
380
- ret.versionYear = 2017
381
- return ret
382
- }
383
- if (ret.versionMajor === 16) {
384
- ret.versionYear = 2019
385
- return ret
386
- }
387
- if (ret.versionMajor === 17) {
388
- ret.versionYear = 2022
389
- return ret
390
- }
391
- this.log.silly('- unsupported version:', ret.versionMajor)
392
- return {}
393
- }
394
-
395
- msBuildPathExists (path) {
396
- return existsSync(path)
397
- }
398
-
399
- // Helper - process MSBuild information
400
- getMSBuild (info, versionYear) {
401
- const pkg = 'Microsoft.VisualStudio.VC.MSBuild.Base'
402
- const msbuildPath = path.join(info.path, 'MSBuild', 'Current', 'Bin', 'MSBuild.exe')
403
- const msbuildPathArm64 = path.join(info.path, 'MSBuild', 'Current', 'Bin', 'arm64', 'MSBuild.exe')
404
- if (info.packages.indexOf(pkg) !== -1) {
405
- this.log.silly('- found VC.MSBuild.Base')
406
- if (versionYear === 2017) {
407
- return path.join(info.path, 'MSBuild', '15.0', 'Bin', 'MSBuild.exe')
408
- }
409
- if (versionYear === 2019) {
410
- if (process.arch === 'arm64' && this.msBuildPathExists(msbuildPathArm64)) {
411
- return msbuildPathArm64
412
- } else {
413
- return msbuildPath
414
- }
415
- }
416
- }
417
- /**
418
- * Visual Studio 2022 doesn't have the MSBuild package.
419
- * Support for compiling _on_ ARM64 was added in MSVC 14.32.31326,
420
- * so let's leverage it if the user has an ARM64 device.
421
- */
422
- if (process.arch === 'arm64' && this.msBuildPathExists(msbuildPathArm64)) {
423
- return msbuildPathArm64
424
- } else if (this.msBuildPathExists(msbuildPath)) {
425
- return msbuildPath
426
- }
427
- return null
428
- }
429
-
430
- // Helper - process toolset information
431
- getToolset (info, versionYear) {
432
- const pkg = 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64'
433
- const express = 'Microsoft.VisualStudio.WDExpress'
434
-
435
- if (info.packages.indexOf(pkg) !== -1) {
436
- this.log.silly('- found VC.Tools.x86.x64')
437
- } else if (info.packages.indexOf(express) !== -1) {
438
- this.log.silly('- found Visual Studio Express (looking for toolset)')
439
- } else {
440
- return null
441
- }
442
-
443
- if (versionYear === 2017) {
444
- return 'v141'
445
- } else if (versionYear === 2019) {
446
- return 'v142'
447
- } else if (versionYear === 2022) {
448
- return 'v143'
449
- }
450
- this.log.silly('- invalid versionYear:', versionYear)
451
- return null
452
- }
453
-
454
- // Helper - process Windows SDK information
455
- getSDK (info) {
456
- const win8SDK = 'Microsoft.VisualStudio.Component.Windows81SDK'
457
- const win10SDKPrefix = 'Microsoft.VisualStudio.Component.Windows10SDK.'
458
- const win11SDKPrefix = 'Microsoft.VisualStudio.Component.Windows11SDK.'
459
-
460
- let Win10or11SDKVer = 0
461
- info.packages.forEach((pkg) => {
462
- if (!pkg.startsWith(win10SDKPrefix) && !pkg.startsWith(win11SDKPrefix)) {
463
- return
464
- }
465
- const parts = pkg.split('.')
466
- if (parts.length > 5 && parts[5] !== 'Desktop') {
467
- this.log.silly('- ignoring non-Desktop Win10/11SDK:', pkg)
468
- return
469
- }
470
- const foundSdkVer = parseInt(parts[4], 10)
471
- if (isNaN(foundSdkVer)) {
472
- // Microsoft.VisualStudio.Component.Windows10SDK.IpOverUsb
473
- this.log.silly('- failed to parse Win10/11SDK number:', pkg)
474
- return
475
- }
476
- this.log.silly('- found Win10/11SDK:', foundSdkVer)
477
- Win10or11SDKVer = Math.max(Win10or11SDKVer, foundSdkVer)
478
- })
479
-
480
- if (Win10or11SDKVer !== 0) {
481
- return `10.0.${Win10or11SDKVer}.0`
482
- } else if (info.packages.indexOf(win8SDK) !== -1) {
483
- this.log.silly('- found Win8SDK')
484
- return '8.1'
485
- }
486
- return null
487
- }
488
-
489
- // Find an installation of Visual Studio 2015 to use
490
- async findVisualStudio2015 () {
491
- if (this.nodeSemver.major >= 19) {
492
- this.addLog(
493
- 'not looking for VS2015 as it is only supported up to Node.js 18')
494
- return null
495
- }
496
- return this.findOldVS({
497
- version: '14.0',
498
- versionMajor: 14,
499
- versionMinor: 0,
500
- versionYear: 2015,
501
- toolset: 'v140'
502
- })
503
- }
504
-
505
- // Find an installation of Visual Studio 2013 to use
506
- async findVisualStudio2013 () {
507
- if (this.nodeSemver.major >= 9) {
508
- this.addLog(
509
- 'not looking for VS2013 as it is only supported up to Node.js 8')
510
- return null
511
- }
512
- return this.findOldVS({
513
- version: '12.0',
514
- versionMajor: 12,
515
- versionMinor: 0,
516
- versionYear: 2013,
517
- toolset: 'v120'
518
- })
519
- }
520
-
521
- // Helper - common code for VS2013 and VS2015
522
- async findOldVS (info) {
523
- const regVC7 = ['HKLM\\Software\\Microsoft\\VisualStudio\\SxS\\VC7',
524
- 'HKLM\\Software\\Wow6432Node\\Microsoft\\VisualStudio\\SxS\\VC7']
525
- const regMSBuild = 'HKLM\\Software\\Microsoft\\MSBuild\\ToolsVersions'
526
-
527
- this.addLog(`looking for Visual Studio ${info.versionYear}`)
528
- try {
529
- let res = await this.regSearchKeys(regVC7, info.version, [])
530
- const vsPath = path.resolve(res, '..')
531
- this.addLog(`- found in "${vsPath}"`)
532
- const msBuildRegOpts = process.arch === 'ia32' ? [] : ['/reg:32']
533
-
534
- try {
535
- res = await this.regSearchKeys([`${regMSBuild}\\${info.version}`], 'MSBuildToolsPath', msBuildRegOpts)
536
- } catch (err) {
537
- this.addLog('- could not find MSBuild in registry for this version')
538
- return null
539
- }
540
-
541
- const msBuild = path.join(res, 'MSBuild.exe')
542
- this.addLog(`- MSBuild in "${msBuild}"`)
543
-
544
- if (!this.checkConfigVersion(info.versionYear, vsPath)) {
545
- return null
546
- }
547
-
548
- info.path = vsPath
549
- info.msBuild = msBuild
550
- info.sdk = null
551
- return info
552
- } catch (err) {
553
- this.addLog('- not found')
554
- return null
555
- }
556
- }
557
-
558
- // After finding a usable version of Visual Studio:
559
- // - add it to validVersions to be displayed at the end if a specific
560
- // version was requested and not found;
561
- // - check if this is the version that was requested.
562
- // - check if this matches the Visual Studio Command Prompt
563
- checkConfigVersion (versionYear, vsPath) {
564
- this.validVersions.push(versionYear)
565
- this.validVersions.push(vsPath)
566
-
567
- if (this.configVersionYear && this.configVersionYear !== versionYear) {
568
- this.addLog('- msvs_version does not match this version')
569
- return false
570
- }
571
- if (this.configPath &&
572
- path.relative(this.configPath, vsPath) !== '') {
573
- this.addLog('- msvs_version does not point to this installation')
574
- return false
575
- }
576
- if (this.envVcInstallDir &&
577
- path.relative(this.envVcInstallDir, vsPath) !== '') {
578
- this.addLog('- does not match this Visual Studio Command Prompt')
579
- return false
580
- }
581
-
582
- return true
583
- }
584
-
585
- async execFile (exec, args) {
586
- return await execFile(exec, args, { encoding: 'utf8' })
587
- }
588
- }
589
-
590
- module.exports = VisualStudioFinder