{"_id":"@cogcoin/vectors","_rev":"2-4c9282c8163ef18cee1309d542202ce2","name":"@cogcoin/vectors","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@cogcoin/vectors","version":"1.0.0","keywords":["cogcoin","coglex","bitcoin","vectors","fixtures","conformance","indexer","protocol"],"license":"MIT","_id":"@cogcoin/vectors@1.0.0","maintainers":[{"name":"cogcoindev","email":"dev@cogcoin.org"}],"homepage":"https://cogcoin.org","bugs":{"url":"https://github.com/cogcoin/vectors/issues"},"dist":{"shasum":"7f249a7c403aea8b89e36a068d931c2fe9eb8e2c","tarball":"https://registry.npmjs.org/@cogcoin/vectors/-/vectors-1.0.0.tgz","fileCount":29,"integrity":"sha512-lN/NvT4myMPhEEbiSGRX8S49X7yITttgkP80wFCo1m/G48+FPwNL4xEa+2g2MwSW9sBqhPk4d93oyM7RC2hGjA==","signatures":[{"sig":"MEUCIB6zuynxpVQ/lvtaY+VmrL7S2/NkWbE/BHAHuuBwEn+TAiEAxIBt5kriJNtHrSvhiQoo5/HGC1UHQ5zf7pzU4GPBJWY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3450634},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./vector-schema.json":"./schema/vector.schema.json","./history-queries.json":"./vectors/generated/history-queries.json","./real-mining-pass.json":"./vectors/generated/real-mining-pass.json","./displayBlockHashes.json":"./displayBlockHashes.json","./scoring-pass-fixtures.json":"./vectors/generated/scoring-pass-fixtures.json","./recipientScriptPubKeys.json":"./recipientScriptPubKeys.json"},"gitHead":"a45e09ebc756209fc5e5d40ef65fa4f6bee48fac","scripts":{"test":"rm -rf .test-dist && node ./node_modules/typescript/bin/tsc -p tsconfig.test.json && node --test .test-dist/test/*.test.js","build":"rm -rf dist && node ./node_modules/typescript/bin/tsc -p tsconfig.json"},"_npmUser":{"name":"cogcoindev","email":"dev@cogcoin.org"},"repository":{"url":"git+https://github.com/cogcoin/vectors.git","type":"git"},"_npmVersion":"11.8.0","description":"Self-contained Cogcoin indexer vectors, runner utilities, and published generation fixtures.","directories":{},"sideEffects":false,"_nodeVersion":"25.6.0","dependencies":{"@cogcoin/indexer":"1.0.0","@cogcoin/scoring":"1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.2","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/vectors_1.0.0_1775852144097_0.5728762533778318","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@cogcoin/vectors","version":"1.0.1","description":"Self-contained Cogcoin indexer vectors, runner utilities, and published generation fixtures.","license":"MIT","type":"module","engines":{"node":">=18"},"homepage":"https://cogcoin.org","repository":{"type":"git","url":"git+https://github.com/cogcoin/vectors.git"},"bugs":{"url":"https://github.com/cogcoin/vectors/issues"},"keywords":["cogcoin","coglex","bitcoin","vectors","fixtures","conformance","indexer","protocol"],"publishConfig":{"access":"public"},"sideEffects":false,"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./history-queries.json":"./vectors/generated/history-queries.json","./real-mining-pass.json":"./vectors/generated/real-mining-pass.json","./scoring-pass-fixtures.json":"./vectors/generated/scoring-pass-fixtures.json","./vector-schema.json":"./schema/vector.schema.json","./displayBlockHashes.json":"./displayBlockHashes.json","./recipientScriptPubKeys.json":"./recipientScriptPubKeys.json"},"scripts":{"build":"rm -rf dist && node ./node_modules/typescript/bin/tsc -p tsconfig.json","test":"rm -rf .test-dist && node ./node_modules/typescript/bin/tsc -p tsconfig.test.json && node --test .test-dist/test/*.test.js"},"dependencies":{"@cogcoin/indexer":"1.0.2","@cogcoin/scoring":"1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^6.0.2"},"gitHead":"a874eed76f6cd0a5a52793ca9612199d6674abde","_id":"@cogcoin/vectors@1.0.1","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-4s/iY6rzYULY1wvHdh8vtmRXrAnUO2EPr8H0kErfMU1IgG+Yve8Qo2miXm20VKYU/aJjbsArog5LvB48SO+4Eg==","shasum":"8a2128c0b50d7ca9f75bc1793738d5ee52f7232c","tarball":"https://registry.npmjs.org/@cogcoin/vectors/-/vectors-1.0.1.tgz","fileCount":29,"unpackedSize":3450694,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFpYG1Oq5keXBLTFCDzrrqhVFjtkO+2V9iMF6rHkTv48AiB1QBI4NLqj6ts8CBYZnJ3Mvcy2gXzk3IzHKzd9eF2AIw=="}]},"_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/vectors_1.0.1_1778174957002_0.2834346156503862"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-10T20:15:43.890Z","modified":"2026-05-07T17:29:17.312Z","1.0.0":"2026-04-10T20:15:44.266Z","1.0.1":"2026-05-07T17:29:17.160Z"},"bugs":{"url":"https://github.com/cogcoin/vectors/issues"},"license":"MIT","homepage":"https://cogcoin.org","keywords":["cogcoin","coglex","bitcoin","vectors","fixtures","conformance","indexer","protocol"],"repository":{"type":"git","url":"git+https://github.com/cogcoin/vectors.git"},"description":"Self-contained Cogcoin indexer vectors, runner utilities, and published generation fixtures.","maintainers":[{"name":"cogcoindev","email":"dev@cogcoin.org"}],"readme":"# `@cogcoin/vectors`\n\n`@cogcoin/vectors@1.0.1` publishes self-contained Cogcoin indexer vectors together with the runner and schema used to replay them. Each vector bundles its own setup blocks, test blocks, expected state hash, transaction outcomes, and query assertions so it can be replayed directly against `@cogcoin/indexer`.\n\nUse Node 18 or newer.\n\n## Links\n\n- Website: [cogcoin.org](https://cogcoin.org)\n- Whitepaper: [cogcoin.org/whitepaper.md](https://cogcoin.org/whitepaper.md)\n- Source: [github.com/cogcoin/vectors](https://github.com/cogcoin/vectors)\n- Indexer package: [npmjs.com/package/@cogcoin/indexer](https://www.npmjs.com/package/@cogcoin/indexer)\n- Scoring package: [npmjs.com/package/@cogcoin/scoring](https://www.npmjs.com/package/@cogcoin/scoring)\n\n## Quick Start\n\nInstall the package:\n\n```bash\nnpm install @cogcoin/vectors\n```\n\nThe installed package includes the runner, published generated vectors, schema, and helper datasets needed by consumers.\nThe runtime API is published as compiled ESM with bundled type declarations.\n\n## Dependency Surface\n\nThe published package depends on:\n\n- `@cogcoin/indexer@1.0.2`\n- `@cogcoin/scoring@1.0.0`\n\n`@cogcoin/genesis` is pulled transitively through `@cogcoin/indexer`.\n\n## API\n\nRuntime utilities:\n\n- `loadVector(path)`\n- `runVector(vector, options?)`\n\nPublished JSON exports:\n\n- `@cogcoin/vectors/history-queries.json`\n- `@cogcoin/vectors/real-mining-pass.json`\n- `@cogcoin/vectors/scoring-pass-fixtures.json`\n- `@cogcoin/vectors/vector-schema.json`\n- `@cogcoin/vectors/displayBlockHashes.json`\n- `@cogcoin/vectors/recipientScriptPubKeys.json`\n\n## Load a Vector from Disk\n\n```ts\nimport { loadVector, runVector } from \"@cogcoin/vectors\";\n\nconst vector = await loadVector(\"/absolute/path/to/vector.json\");\nconst result = await runVector(vector);\n```\n\n`runVector(...)` drives the full `prepare -> score -> finalize -> rewind` flow and checks query assertions against the resulting state.\n\n## Import a Published Vector\n\n```ts\nimport { createRequire } from \"node:module\";\nimport { runVector } from \"@cogcoin/vectors\";\n\nconst require = createRequire(import.meta.url);\nconst historyVector = require(\"@cogcoin/vectors/history-queries.json\");\n\nconst result = await runVector(historyVector);\n```\n\n## Contents\n\nGenerated vectors:\n\n- `history-queries.json`: anchoring, reviews, data history, resolved locks, and domain event log coverage\n- `real-mining-pass.json`: published pass sentence replayed through the indexer with a compact synthetic setup\n- `scoring-pass-fixtures.json`: extracted pass cases from the published scoring conformance vectors\n\nSupporting data:\n\n- `displayBlockHashes.json`: real display-order Bitcoin block hashes used by vector generation\n- `recipientScriptPubKeys.json`: real recipient scriptPubKey samples used by fixtures and generators\n- `schema/vector.schema.json`: JSON schema for vector files\n\nThe package intentionally ships finalized, self-contained vectors only.\n\n## Practical Notes\n\n- Vectors are designed for `@cogcoin/indexer`, not as standalone consensus logic.\n- Query assertions cover both current-state selectors and the whitepaper's optional historical interfaces.\n- Generated vector data is intentionally shipped as release artifacts; this package does not regenerate vectors during install or publish.\n","readmeFilename":"README.md"}