{"_id":"@cogcoin/bitcoin","name":"@cogcoin/bitcoin","dist-tags":{"latest":"30.2.0"},"versions":{"30.2.0":{"name":"@cogcoin/bitcoin","version":"30.2.0","description":"Bitcoin Core 30.2 binaries for Cogcoin","type":"module","main":"index.js","exports":{".":"./index.js"},"engines":{"node":">=22.0.0"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/cogcoin/bitcoin.git"},"optionalDependencies":{"@cogcoin/bitcoin-darwin-arm64":"30.2.0","@cogcoin/bitcoin-darwin-x64":"30.2.0","@cogcoin/bitcoin-linux-arm64":"30.2.0","@cogcoin/bitcoin-linux-x64":"30.2.0","@cogcoin/bitcoin-win32-x64":"30.2.0"},"gitHead":"a7c5b27e419e9449f3c2d68e31326e0beaecaf1c","_id":"@cogcoin/bitcoin@30.2.0","bugs":{"url":"https://github.com/cogcoin/bitcoin/issues"},"homepage":"https://github.com/cogcoin/bitcoin#readme","_nodeVersion":"25.6.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-SNsW6R29kBlV6zPm7hCkzAC2dwHfMIxp6ZC/QX0ADKt8dZYQ7/OlmGzBWBPCDxW5EwOtSweyS7aeB7V0CXSDdA==","shasum":"a4b73e6c192295ac45c4572cb73a8f2992de14de","tarball":"https://registry.npmjs.org/@cogcoin/bitcoin/-/bitcoin-30.2.0.tgz","fileCount":5,"unpackedSize":11343,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCXBHG8DoGdBMf4OP2ywZ9kIr5SfCAbrSynnRNXnSPbjwIhAPJfkN3Z8iipsTI+aawdxJuFpPNqfRmiCor0/ZYZ+Gx8"}]},"_npmUser":{"name":"cogcoindev","email":"dev@cogcoin.org"},"directories":{},"maintainers":[{"name":"cogcoindev","email":"dev@cogcoin.org"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bitcoin_30.2.0_1775097594307_0.7726811954010151"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-02T02:39:54.238Z","30.2.0":"2026-04-02T02:39:54.470Z","modified":"2026-04-02T02:39:54.660Z"},"maintainers":[{"name":"cogcoindev","email":"dev@cogcoin.org"}],"description":"Bitcoin Core 30.2 binaries for Cogcoin","homepage":"https://github.com/cogcoin/bitcoin#readme","repository":{"type":"git","url":"git+https://github.com/cogcoin/bitcoin.git"},"bugs":{"url":"https://github.com/cogcoin/bitcoin/issues"},"license":"MIT","readme":"# `@cogcoin/bitcoin`\n\n`@cogcoin/bitcoin@30.2.0` is the canonical npm entrypoint for verified Bitcoin Core 30.2 binaries used by Cogcoin. It ships no executables itself. Instead, it selects the matching platform package, verifies the selected binary by SHA-256, and returns a local executable path for `bitcoind` or `bitcoin-cli`.\n\nUse this package as the local source of truth for Bitcoin Core binaries in Cogcoin tooling. Install the parent package, resolve binary paths through the loader, and launch the executable from that verified path.\n\n## Links\n\n- Website: [cogcoin.org](https://cogcoin.org)\n- Source: [github.com/cogcoin](https://github.com/cogcoin)\n- Package repo: [github.com/cogcoin/bitcoin](https://github.com/cogcoin/bitcoin)\n- Bitcoin Core release: <https://bitcoincore.org/bin/bitcoin-core-30.2/>\n- Bitcoin Core verification guide: <https://bitcoincore.org/en/download/#verify-your-download>\n- Guix attestations: <https://github.com/bitcoin-core/guix.sigs/tree/main/30.2>\n\n## Quick Start\n\nInstall the package:\n\n```bash\nnpm install @cogcoin/bitcoin\n```\n\nThen resolve verified binary paths from your application:\n\n```js\nimport { getBitcoindPath, getBitcoinCliPath } from '@cogcoin/bitcoin';\nimport { execFile } from 'child_process';\n\nconst bitcoind = await getBitcoindPath();\nconst bitcoinCli = await getBitcoinCliPath();\n\nexecFile(bitcoind, ['-datadir=/path/to/data', '-server'], (error) => {\n  if (error) {\n    throw error;\n  }\n});\n\nexecFile(bitcoinCli, ['getblockchaininfo'], (error, stdout) => {\n  if (error) {\n    throw error;\n  }\n\n  console.log(JSON.parse(stdout));\n});\n```\n\nThis package contains no binaries itself. npm installs the matching platform package as an optional dependency.\n\n## Contents\n\n- `index.js`: loader that selects a platform package, verifies SHA-256, repairs execute bits, and removes macOS quarantine on a best-effort basis\n- `manifest.sha256`: canonical per-binary hash record for all supported platforms\n- `LICENSE`: wrapper package license text\n- platform package optional dependencies: ship the actual `bitcoind` and `bitcoin-cli` executables\n\n## Trust Model\n\n1. The shipped binaries are extracted unmodified from the official Bitcoin Core 30.2 release archives.\n2. The refresh process verifies release archives against signed `SHA256SUMS` from a pinned trusted signer set before packaging.\n3. `manifest.sha256` records the exact per-binary hashes committed by this package release.\n4. The loader re-verifies the selected binary hash before returning its path.\n\nThe package is immutable. The trust model is official Bitcoin Core release provenance plus local loader verification, not the npm registry alone.\n\n## Verification\n\nTo independently verify:\n\n1. Download `SHA256SUMS` and `SHA256SUMS.asc` from the Bitcoin Core 30.2 release page.\n2. Import trusted Bitcoin Core signer keys and verify the signatures against them.\n3. Download the release archive for your platform.\n4. Verify the archive hash against `SHA256SUMS`.\n5. Extract `bitcoind` and `bitcoin-cli` from the verified archive.\n6. Run `shasum -a 256 bitcoind bitcoin-cli`.\n7. Compare the results to the hashes below and to `manifest.sha256` in this package.\n\n### Archive hashes\n\n| Archive | SHA-256 |\n| --- | --- |\n| `bitcoin-30.2-aarch64-linux-gnu.tar.gz` | `73e76c14edc79808a0511c744d102ffbb494807ee90cbcba176568243254b532` |\n| `bitcoin-30.2-x86_64-linux-gnu.tar.gz` | `6aa7bb4feb699c4c6262dd23e4004191f6df7f373b5d5978b5bcdd4bb72f75d8` |\n| `bitcoin-30.2-arm64-apple-darwin.tar.gz` | `c2ecab62891de22228043815cb6211549a32272be3d5d052ff19847d3420bd10` |\n| `bitcoin-30.2-x86_64-apple-darwin.tar.gz` | `99d5cee9b9c37be506396c30837a4b98e320bfea71c474d6120a7e8eb6075c7b` |\n| `bitcoin-30.2-win64.zip` | `0d7e1f16f8823aa26d29b44855ff6dbac11c03d75631a6c1d2ea5fab3a84fdf8` |\n\n### Binary hashes\n\n| Platform | Binary | SHA-256 |\n| --- | --- | --- |\n| `linux-arm64` | `bitcoind` | `ef420fad3db5e8769acbf7a179d4a4122b558d62939a425d34b07e45f64e6997` |\n| `linux-arm64` | `bitcoin-cli` | `84f49c0d3ddc2b763e9d2fa32e52f6816cc2159f0779bdfb4f6df7f6c3d00ab9` |\n| `linux-x64` | `bitcoind` | `87fc011683f72ce1113add2d2c67085ac7acbba1266a538cccbadb08b6926785` |\n| `linux-x64` | `bitcoin-cli` | `2f4a391973d399d47de0c103ea99ed59355f597f6d32884200c00b40a1b8829c` |\n| `darwin-arm64` | `bitcoind` | `3c40be552d92887107f68d7e534aa553b6f94b0b6bfe8a7cd18bc053988a67c9` |\n| `darwin-arm64` | `bitcoin-cli` | `6c8024645f1f5eeb6f1f93f9f790771c322eb077eed4d5b3ff76e5a7be8bf1c2` |\n| `darwin-x64` | `bitcoind` | `8a872ebf4878d4b26c98fb936c72d1f5dcfe6206cc9e398fbaa3d927f2814ba2` |\n| `darwin-x64` | `bitcoin-cli` | `48ce393e484de2fc43fe39cb32df61957fce46d5865574f8f6b6521dee2f0168` |\n| `win32-x64` | `bitcoind.exe` | `4fddd47cb33560109b826f3d5b8a8332480db7a1c13d91676375cdae20c240b3` |\n| `win32-x64` | `bitcoin-cli.exe` | `45eb95ec60dccb242770bcc19c4a5a1ad3ee9dc53841f5a710b35d127d80e21b` |\n\n## Critical Clarifications\n\n- Installing with `--omit=optional` makes this package unusable because the platform binaries will not be installed.\n- Running a platform package binary directly, such as `./node_modules/@cogcoin/bitcoin-linux-x64/bitcoind`, bypasses the loader-side verification step.\n- Linux support is glibc-only on `linux-x64` and `linux-arm64`. musl-based distributions such as Alpine Linux are not supported.\n- Unsupported platforms throw an error when the loader is called.\n\n## License\n\nThe wrapper package is distributed under the MIT license.\n\nThe binaries are distributed in separate platform packages under Bitcoin Core's MIT license.\n","readmeFilename":"README.md","_rev":"1-5407c2f81bb0b7979b96f5c61d0dd7f9"}