{"_id":"@cogcoin/genesis","name":"@cogcoin/genesis","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@cogcoin/genesis","version":"1.0.0","description":"Genesis artifacts for the Cogcoin protocol.","license":"MIT","type":"module","engines":{"node":">=18"},"homepage":"https://cogcoin.org","repository":{"type":"git","url":"git+https://github.com/cogcoin/genesis.git"},"keywords":["cogcoin","coglex","cogtoshi","bitcoin","genesis","protocol","whitepaper"],"publishConfig":{"access":"public"},"scripts":{"verify":"node verify.mjs"},"gitHead":"d25ce2669639bf315f4d61f81095b2ad4bc30b40","_id":"@cogcoin/genesis@1.0.0","bugs":{"url":"https://github.com/cogcoin/genesis/issues"},"_nodeVersion":"25.6.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-Xw3G/A2N3Ylt0h4WfeYwJGAIveijLFsiQ9Nmx4yxG7OIKEr0iphfDnMtHWjWjdYGbguJkHN0HKIbSw/LoXgkDQ==","shasum":"ce9b688a654d7b04fcb48247ba1626fc63a8c86f","tarball":"https://registry.npmjs.org/@cogcoin/genesis/-/genesis-1.0.0.tgz","fileCount":17,"unpackedSize":38084302,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDXp39hx9sT26KazEu9NGmDmKh+ySxSqtbI+1wjf5kqwAiB6H0dyPlCYLy+0Jk5vCmByiY02H7d+pBmsMSr3+SZ5ag=="}]},"_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/genesis_1.0.0_1774911227557_0.01850147289007098"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-30T22:53:47.498Z","1.0.0":"2026-03-30T22:53:48.282Z","modified":"2026-03-30T22:53:48.528Z"},"maintainers":[{"name":"cogcoindev","email":"dev@cogcoin.org"}],"description":"Genesis artifacts for the Cogcoin protocol.","homepage":"https://cogcoin.org","keywords":["cogcoin","coglex","cogtoshi","bitcoin","genesis","protocol","whitepaper"],"repository":{"type":"git","url":"git+https://github.com/cogcoin/genesis.git"},"bugs":{"url":"https://github.com/cogcoin/genesis/issues"},"license":"MIT","readme":"# `@cogcoin/genesis`\n\n`@cogcoin/genesis@1.0.0` is the canonical artifact bundle for developers building Cogcoin indexers, verifiers, and other protocol tooling. It extends the on-chain trust chain rooted in the GENESIS transaction at Bitcoin block `937337` to every consensus-critical artifact needed for offline verification.\n\nUse this package as the local source of truth for genesis artifacts. Install it, run verification, then load the included files directly.\n\n## Links\n\n- Website: [cogcoin.org](https://cogcoin.org)\n- Whitepaper: [cogcoin.org/whitepaper.md](https://cogcoin.org/whitepaper.md)\n- Genesis transaction: [block 937,337](https://mempool.space/tx/7258ebf6d45f13d46024ed00e5c21937a6e54f6a0f88afa96156ee4a6c4b667d)\n- Source: [github.com/cogcoin](https://github.com/cogcoin)\n\n## Quick Start\n\nInstall the package:\n\n```bash\nnpm install @cogcoin/genesis\n```\n\nThen, from your project root, run:\n\n```bash\nnode node_modules/@cogcoin/genesis/verify.mjs\n```\n\nRun verification before using the package in an implementation.\n\n## Contents\n\n- `LICENSE`: MIT license text shipped with the package\n- `genesis_tx.json`: raw GENESIS transaction plus explicit treasury script bytes\n- `genesis_params.json`: byte-exact parameters file committed on-chain by SHA-256\n- `genesis_announcement.json` and `genesis_announcement.sig`: signed package trust extension\n- `canonical_constants.json`: consensus-critical constants not present in `genesis_params.json`\n- `bip39_english.txt`: pinned BIP-39 English wordlist\n- `scoring_bundle/*`: scoring bundle committed by `genesis_params.json -> scoring_bundle_sha256`\n- `cogcoin_whitepaper.md`: authoritative protocol specification\n- `verify.mjs`: self-contained package verifier\n\n## Trust Chain\n\n1. The GENESIS transaction OP_RETURN commits the SHA-256 of `genesis_params.json`.\n2. `genesis_params.json` commits `scoring_bundle/manifest.sha256` via `scoring_bundle_sha256`.\n3. `genesis_pubkey` in `genesis_params.json` identifies the same key as the treasury recipient in `genesis_tx.json`.\n4. That key signs the SHA-256 hash of `genesis_announcement.json`, and the announcement's `package_manifest` commits the signed package artifacts by SHA-256.\n\nThe signed package manifest excludes `genesis_announcement.json`, `genesis_announcement.sig`, `README.md`, and `package.json`. `LICENSE` is also shipped outside the signed set as package/legal metadata. The package is immutable. The trust model is the Bitcoin anchor plus the signed manifest, not the npm registry.\n\n## Verification\n\nVerify the installed package before using any artifact:\n\n```bash\nnode node_modules/@cogcoin/genesis/verify.mjs\n```\n\nIf you are already inside the package directory itself, `npm run verify` runs the same verifier.\n\nThe verifier checks:\n\n- the on-chain `genesis_params.json` hash commitment\n- the scoring bundle manifest and all scoring bundle artifact hashes\n- every hash listed in `genesis_announcement.json -> package_manifest`\n- the GENESIS txid and OP_RETURN payload\n- treasury address, scriptPubKey, and pubkey-derived address consistency\n- the Bitcoin message signature over the SHA-256 hash of `genesis_announcement.json`\n\nRun the verifier after installation. If verification fails, do not use the package artifacts.\n\n## Critical Clarifications\n\n- `bootstrap_award_per_registration_cogtoshi` applies at `DOMAIN_ANCHOR`, not `DOMAIN_REG`. The genesis parameter key name is a locked on-chain misnomer.\n- The scoring WASM export `settle_block_wasm` is non-consensus. Use the WASM bundle for scoring only, and implement settlement per Sections 5.1.2-5.1.5 of `cogcoin_whitepaper.md`.\n\n## Signature\n\n`genesis_announcement.sig` contains the Bitcoin message signature over the SHA-256 hash of `genesis_announcement.json`. The verifier checks that signature together with the package manifest, transaction data, and on-chain anchors.\n","readmeFilename":"README.md","_rev":"1-60670d94f9dbf8e473c2ed1de7211f2b"}