@blockchaincommons/tags 1.0.0-beta.1

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["IANA_URI","IANA_UUID","IANA_ENCODED_CBOR"],"sources":["../src/tags.ts","../src/register.ts"],"sourcesContent":["/**\n * The Blockchain Commons CBOR tag registry.\n *\n * Values are the CBOR tag numbers on the wire; names are wire too, since\n * `uniform-resources` derives UR types from them (`ur:envelope`). Neither\n * may change without a specification change. Every constant is frozen.\n *\n * Tags compare by value: `TAG_ENVELOPE === Tag.from(200, \"envelope\")` is\n * `false` (two objects), `Tag.equals(a, b)` and `a.value === b.value` are\n * the comparisons to write.\n *\n * @see https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2020-006-urtypes.md\n * @module tags\n */\nimport {\n  Tag,\n  TAG_ENCODED_CBOR as IANA_ENCODED_CBOR,\n  TAG_URI as IANA_URI,\n  TAG_UUID as IANA_UUID,\n} from \"@blockchaincommons/dcbor\";\n\n/**\n * One immutable tag. dcbor's `Tag.from` returns a plain object whose\n * `readonly` is a compile-time promise only; the names here are wire,\n * so nothing may rewrite them process-wide.\n */\nconst tag = (value: number, name: string): Tag => Object.freeze(Tag.from(value, name));\n\n// IANA standard tags this stack uses. dcbor owns the numbers (it defines\n// them unnamed); this registry owns the names.\n\n/** #6.32: URI (RFC 8949 §3.4.5.3), named `url` in this stack. */\nexport const TAG_URI: Tag = tag(IANA_URI, \"url\");\n/** #6.37: binary UUID (RFC 4122). */\nexport const TAG_UUID: Tag = tag(IANA_UUID, \"uuid\");\n\n// Core Envelope tags. #6.24 was used as the leaf header by an earlier spec\n// (incorrectly: RFC 8949 §3.4.5.1 requires a byte string); #6.201 replaced\n// it and #6.24 is still recognised on decode. #6.200 and #6.201 are the only\n// Blockchain Commons tags in IANA's \"Specification Required\" range.\n\n/** #6.24: encoded CBOR data item; the pre-#6.201 Envelope leaf header, accepted on decode only. */\nexport const TAG_ENCODED_CBOR: Tag = tag(IANA_ENCODED_CBOR, \"encoded-cbor\");\n/** #6.200: Gordian Envelope. */\nexport const TAG_ENVELOPE: Tag = tag(200, \"envelope\");\n/** #6.201: dCBOR data item; the Envelope leaf case. */\nexport const TAG_LEAF: Tag = tag(201, \"leaf\");\n/** #6.262: byte string holding UTF-8 JSON text. */\nexport const TAG_JSON: Tag = tag(262, \"json\");\n\n// Envelope extensions.\n\n/** #6.40000: known value, a registered unsigned integer with a fixed meaning. */\nexport const TAG_KNOWN_VALUE: Tag = tag(40000, \"known-value\");\n/** #6.40001: SHA-256 digest. */\nexport const TAG_DIGEST: Tag = tag(40001, \"digest\");\n/** #6.40002: encrypted message (IETF ChaCha20-Poly1305). */\nexport const TAG_ENCRYPTED: Tag = tag(40002, \"encrypted\");\n/** #6.40003: DEFLATE-compressed data with the digest of the original. */\nexport const TAG_COMPRESSED: Tag = tag(40003, \"compressed\");\n\n// Distributed function calls.\n\n/** #6.40004: request. */\nexport const TAG_REQUEST: Tag = tag(40004, \"request\");\n/** #6.40005: response. */\nexport const TAG_RESPONSE: Tag = tag(40005, \"response\");\n/** #6.40006: function identifier. */\nexport const TAG_FUNCTION: Tag = tag(40006, \"function\");\n/** #6.40007: parameter identifier. */\nexport const TAG_PARAMETER: Tag = tag(40007, \"parameter\");\n/** #6.40008: placeholder. */\nexport const TAG_PLACEHOLDER: Tag = tag(40008, \"placeholder\");\n/** #6.40009: replacement. */\nexport const TAG_REPLACEMENT: Tag = tag(40009, \"replacement\");\n\n// Cryptographic components.\n\n/** #6.40010: X25519 key-agreement private key. */\nexport const TAG_X25519_PRIVATE_KEY: Tag = tag(40010, \"agreement-private-key\");\n/** #6.40011: X25519 key-agreement public key. */\nexport const TAG_X25519_PUBLIC_KEY: Tag = tag(40011, \"agreement-public-key\");\n/** #6.40012: apparently random identifier (32 bytes). */\nexport const TAG_ARID: Tag = tag(40012, \"arid\");\n/** #6.40013: a signing and an encapsulation private key together. */\nexport const TAG_PRIVATE_KEYS: Tag = tag(40013, \"crypto-prvkeys\");\n/** #6.40014: nonce. */\nexport const TAG_NONCE: Tag = tag(40014, \"nonce\");\n/** #6.40015: password. */\nexport const TAG_PASSWORD: Tag = tag(40015, \"password\");\n/** #6.40016: private key base, the material every other key derives from. */\nexport const TAG_PRIVATE_KEY_BASE: Tag = tag(40016, \"crypto-prvkey-base\");\n/** #6.40017: a signing and an encapsulation public key together. */\nexport const TAG_PUBLIC_KEYS: Tag = tag(40017, \"crypto-pubkeys\");\n/** #6.40018: salt. */\nexport const TAG_SALT: Tag = tag(40018, \"salt\");\n/** #6.40019: sealed message, encrypted to a recipient's public keys. */\nexport const TAG_SEALED_MESSAGE: Tag = tag(40019, \"crypto-sealed\");\n/** #6.40020: signature. */\nexport const TAG_SIGNATURE: Tag = tag(40020, \"signature\");\n/** #6.40021: signing private key. */\nexport const TAG_SIGNING_PRIVATE_KEY: Tag = tag(40021, \"signing-private-key\");\n/** #6.40022: signing public key. */\nexport const TAG_SIGNING_PUBLIC_KEY: Tag = tag(40022, \"signing-public-key\");\n/** #6.40023: symmetric encryption key. */\nexport const TAG_SYMMETRIC_KEY: Tag = tag(40023, \"crypto-key\");\n/** #6.40024: extensible identifier (XID). */\nexport const TAG_XID: Tag = tag(40024, \"xid\");\n/** #6.40025: reference to an identifier by a prefix of it. */\nexport const TAG_REFERENCE: Tag = tag(40025, \"reference\");\n/** #6.40026: distributed function call event. */\nexport const TAG_EVENT: Tag = tag(40026, \"event\");\n/** #6.40027: symmetric key wrapped for a recipient. */\nexport const TAG_ENCRYPTED_KEY: Tag = tag(40027, \"encrypted-key\");\n\n// Post-quantum.\n\n/** #6.40100: ML-KEM (FIPS 203) private key. */\nexport const TAG_MLKEM_PRIVATE_KEY: Tag = tag(40100, \"mlkem-private-key\");\n/** #6.40101: ML-KEM (FIPS 203) public key. */\nexport const TAG_MLKEM_PUBLIC_KEY: Tag = tag(40101, \"mlkem-public-key\");\n/** #6.40102: ML-KEM (FIPS 203) encapsulated ciphertext. */\nexport const TAG_MLKEM_CIPHERTEXT: Tag = tag(40102, \"mlkem-ciphertext\");\n/** #6.40103: ML-DSA (FIPS 204) private key. */\nexport const TAG_MLDSA_PRIVATE_KEY: Tag = tag(40103, \"mldsa-private-key\");\n/** #6.40104: ML-DSA (FIPS 204) public key. */\nexport const TAG_MLDSA_PUBLIC_KEY: Tag = tag(40104, \"mldsa-public-key\");\n/** #6.40105: ML-DSA (FIPS 204) signature. */\nexport const TAG_MLDSA_SIGNATURE: Tag = tag(40105, \"mldsa-signature\");\n\n// Seeds, keys and wallets.\n\n/** #6.40300: cryptographic seed. */\nexport const TAG_SEED: Tag = tag(40300, \"seed\");\n/** #6.40303: BIP-32 hierarchical deterministic key. */\nexport const TAG_HDKEY: Tag = tag(40303, \"hdkey\");\n/** #6.40304: BIP-32 derivation path. */\nexport const TAG_DERIVATION_PATH: Tag = tag(40304, \"keypath\");\n/** #6.40305: coin type and network (`coin-info`). */\nexport const TAG_USE_INFO: Tag = tag(40305, \"coin-info\");\n/** #6.40306: elliptic-curve key. */\nexport const TAG_EC_KEY: Tag = tag(40306, \"eckey\");\n/** #6.40307: address. */\nexport const TAG_ADDRESS: Tag = tag(40307, \"address\");\n/** #6.40308: output descriptor. */\nexport const TAG_OUTPUT_DESCRIPTOR: Tag = tag(40308, \"output-descriptor\");\n/** #6.40309: SSKR share. */\nexport const TAG_SSKR_SHARE: Tag = tag(40309, \"sskr\");\n/** #6.40310: partially signed Bitcoin transaction. */\nexport const TAG_PSBT: Tag = tag(40310, \"psbt\");\n/** #6.40311: account descriptor. */\nexport const TAG_ACCOUNT_DESCRIPTOR: Tag = tag(40311, \"account-descriptor\");\n\n// SSH.\n\n/** #6.40800: OpenSSH text-format private key. */\nexport const TAG_SSH_TEXT_PRIVATE_KEY: Tag = tag(40800, \"ssh-private\");\n/** #6.40801: OpenSSH text-format public key. */\nexport const TAG_SSH_TEXT_PUBLIC_KEY: Tag = tag(40801, \"ssh-public\");\n/** #6.40802: OpenSSH text-format signature. */\nexport const TAG_SSH_TEXT_SIGNATURE: Tag = tag(40802, \"ssh-signature\");\n/** #6.40803: OpenSSH text-format certificate. */\nexport const TAG_SSH_TEXT_CERTIFICATE: Tag = tag(40803, \"ssh-certificate\");\n\n/** #6.1347571542: provenance mark. */\nexport const TAG_PROVENANCE_MARK: Tag = tag(1347571542, \"provenance\");\n\n// Output descriptor script types (subtypes of `crypto-output`).\n\n/** #6.400: output descriptor `sh` (script hash). */\nexport const TAG_OUTPUT_SCRIPT_HASH: Tag = tag(400, \"output-script-hash\");\n/** #6.401: output descriptor `wsh` (witness script hash). */\nexport const TAG_OUTPUT_WITNESS_SCRIPT_HASH: Tag = tag(401, \"output-witness-script-hash\");\n/** #6.402: output descriptor `pk` (public key). */\nexport const TAG_OUTPUT_PUBLIC_KEY: Tag = tag(402, \"output-public-key\");\n/** #6.403: output descriptor `pkh` (public key hash). */\nexport const TAG_OUTPUT_PUBLIC_KEY_HASH: Tag = tag(403, \"output-public-key-hash\");\n/** #6.404: output descriptor `wpkh` (witness public key hash). */\nexport const TAG_OUTPUT_WITNESS_PUBLIC_KEY_HASH: Tag = tag(404, \"output-witness-public-key-hash\");\n/** #6.405: output descriptor `combo`. */\nexport const TAG_OUTPUT_COMBO: Tag = tag(405, \"output-combo\");\n/** #6.406: output descriptor `multi` (multisig). */\nexport const TAG_OUTPUT_MULTISIG: Tag = tag(406, \"output-multisig\");\n/** #6.407: output descriptor `sortedmulti` (sorted multisig). */\nexport const TAG_OUTPUT_SORTED_MULTISIG: Tag = tag(407, \"output-sorted-multisig\");\n/** #6.408: output descriptor `raw` (raw script). */\nexport const TAG_OUTPUT_RAW_SCRIPT: Tag = tag(408, \"output-raw-script\");\n/** #6.409: output descriptor `tr` (taproot). */\nexport const TAG_OUTPUT_TAPROOT: Tag = tag(409, \"output-taproot\");\n/** #6.410: output descriptor cosigner. */\nexport const TAG_OUTPUT_COSIGNER: Tag = tag(410, \"output-cosigner\");\n\n/** The legacy tag set; see {@link LEGACY_TAGS}. */\nexport interface LegacyTags {\n  /** #6.300: `crypto-seed`, superseded by {@link TAG_SEED}. */\n  readonly SEED_V1: Tag;\n  /** #6.306: `crypto-eckey`, superseded by {@link TAG_EC_KEY}. */\n  readonly EC_KEY_V1: Tag;\n  /** #6.309: `crypto-sskr`, superseded by {@link TAG_SSKR_SHARE}. */\n  readonly SSKR_SHARE_V1: Tag;\n  /** #6.303: `crypto-hdkey`, superseded by {@link TAG_HDKEY}. */\n  readonly HDKEY_V1: Tag;\n  /** #6.304: `crypto-keypath`, superseded by {@link TAG_DERIVATION_PATH}. */\n  readonly DERIVATION_PATH_V1: Tag;\n  /** #6.305: `crypto-coin-info`, superseded by {@link TAG_USE_INFO}. */\n  readonly USE_INFO_V1: Tag;\n  /** #6.307: `crypto-output`, superseded by {@link TAG_OUTPUT_DESCRIPTOR}. */\n  readonly OUTPUT_DESCRIPTOR_V1: Tag;\n  /** #6.310: `crypto-psbt`, superseded by {@link TAG_PSBT}. */\n  readonly PSBT_V1: Tag;\n  /** #6.311: `crypto-account`, superseded by {@link TAG_ACCOUNT_DESCRIPTOR}. */\n  readonly ACCOUNT_V1: Tag;\n}\n\n/**\n * Superseded tags, accepted on decode only. They sit in IANA's\n * \"Specification Required\" range (300–311) and were replaced by the\n * first-come-first-served 40300+ tags above; existing data still uses them.\n * Never emit these for new data. Frozen, like every entry in it.\n */\nexport const LEGACY_TAGS: LegacyTags = Object.freeze({\n  SEED_V1: tag(300, \"crypto-seed\"),\n  EC_KEY_V1: tag(306, \"crypto-eckey\"),\n  SSKR_SHARE_V1: tag(309, \"crypto-sskr\"),\n  HDKEY_V1: tag(303, \"crypto-hdkey\"),\n  DERIVATION_PATH_V1: tag(304, \"crypto-keypath\"),\n  USE_INFO_V1: tag(305, \"crypto-coin-info\"),\n  OUTPUT_DESCRIPTOR_V1: tag(307, \"crypto-output\"),\n  PSBT_V1: tag(310, \"crypto-psbt\"),\n  ACCOUNT_V1: tag(311, \"crypto-account\"),\n});\n\n/**\n * Every tag this package defines, in registration order (the order the\n * Rust reference registers them). Iterate this rather than the constants.\n * Frozen, like every entry in it.\n */\nexport const ALL_TAGS: readonly Tag[] = Object.freeze([\n  TAG_URI,\n  TAG_UUID,\n  TAG_ENCODED_CBOR,\n  TAG_ENVELOPE,\n  TAG_LEAF,\n  TAG_JSON,\n  TAG_KNOWN_VALUE,\n  TAG_DIGEST,\n  TAG_ENCRYPTED,\n  TAG_COMPRESSED,\n  TAG_REQUEST,\n  TAG_RESPONSE,\n  TAG_FUNCTION,\n  TAG_PARAMETER,\n  TAG_PLACEHOLDER,\n  TAG_REPLACEMENT,\n  TAG_EVENT,\n  LEGACY_TAGS.SEED_V1,\n  LEGACY_TAGS.EC_KEY_V1,\n  LEGACY_TAGS.SSKR_SHARE_V1,\n  TAG_SEED,\n  TAG_EC_KEY,\n  TAG_SSKR_SHARE,\n  TAG_X25519_PRIVATE_KEY,\n  TAG_X25519_PUBLIC_KEY,\n  TAG_ARID,\n  TAG_PRIVATE_KEYS,\n  TAG_NONCE,\n  TAG_PASSWORD,\n  TAG_PRIVATE_KEY_BASE,\n  TAG_PUBLIC_KEYS,\n  TAG_SALT,\n  TAG_SEALED_MESSAGE,\n  TAG_SIGNATURE,\n  TAG_SIGNING_PRIVATE_KEY,\n  TAG_SIGNING_PUBLIC_KEY,\n  TAG_SYMMETRIC_KEY,\n  TAG_XID,\n  TAG_REFERENCE,\n  TAG_ENCRYPTED_KEY,\n  TAG_MLKEM_PRIVATE_KEY,\n  TAG_MLKEM_PUBLIC_KEY,\n  TAG_MLKEM_CIPHERTEXT,\n  TAG_MLDSA_PRIVATE_KEY,\n  TAG_MLDSA_PUBLIC_KEY,\n  TAG_MLDSA_SIGNATURE,\n  LEGACY_TAGS.HDKEY_V1,\n  LEGACY_TAGS.DERIVATION_PATH_V1,\n  LEGACY_TAGS.USE_INFO_V1,\n  LEGACY_TAGS.OUTPUT_DESCRIPTOR_V1,\n  LEGACY_TAGS.PSBT_V1,\n  LEGACY_TAGS.ACCOUNT_V1,\n  TAG_HDKEY,\n  TAG_DERIVATION_PATH,\n  TAG_USE_INFO,\n  TAG_ADDRESS,\n  TAG_OUTPUT_DESCRIPTOR,\n  TAG_PSBT,\n  TAG_ACCOUNT_DESCRIPTOR,\n  TAG_SSH_TEXT_PRIVATE_KEY,\n  TAG_SSH_TEXT_PUBLIC_KEY,\n  TAG_SSH_TEXT_SIGNATURE,\n  TAG_SSH_TEXT_CERTIFICATE,\n  TAG_OUTPUT_SCRIPT_HASH,\n  TAG_OUTPUT_WITNESS_SCRIPT_HASH,\n  TAG_OUTPUT_PUBLIC_KEY,\n  TAG_OUTPUT_PUBLIC_KEY_HASH,\n  TAG_OUTPUT_WITNESS_PUBLIC_KEY_HASH,\n  TAG_OUTPUT_COMBO,\n  TAG_OUTPUT_MULTISIG,\n  TAG_OUTPUT_SORTED_MULTISIG,\n  TAG_OUTPUT_RAW_SCRIPT,\n  TAG_OUTPUT_TAPROOT,\n  TAG_OUTPUT_COSIGNER,\n  TAG_PROVENANCE_MARK,\n]);\n","/**\n * Registration into a dCBOR tags store.\n *\n * @module register\n */\nimport { type TagsStore, getGlobalTagsStore, registerStandardTags } from \"@blockchaincommons/dcbor\";\nimport { ALL_TAGS } from \"./tags.js\";\n\n/**\n * Register dcbor's standard tags and every tag in {@link ALL_TAGS} into\n * `store` (default: the global store).\n *\n * Idempotent: the store compares names, so a value already registered under\n * the same name is a no-op, which is what makes repeated calls safe.\n *\n * @param store - The store to register into; defaults to dcbor's global store.\n * @throws {Error} dcbor's store throws a bare `Error` when a value is\n * already registered under a *different* name\n * (`Attempt to register tag: 200 'foo' with different name: 'envelope'`).\n */\nexport function registerTags(store: TagsStore = getGlobalTagsStore()): void {\n  registerStandardTags(store);\n  store.registerAll([...ALL_TAGS]);\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@blockchaincommons/tags",
+  "version": "1.0.0-beta.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Blockchain Commons CBOR Tags Registry for TypeScript",
+  "license": "BSD-2-Clause-Patent",
+  "author": {
+    "name": "Blockchain Commons",
+    "email": "info@blockchaincommons.com",
+    "url": "https://www.blockchaincommons.com"
+  },
+  "homepage": "https://github.com/BlockchainCommons/bc-tags-ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BlockchainCommons/bc-tags-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/BlockchainCommons/bc-tags-ts/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "MIGRATION.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint 'src/**/*.ts' 'tests/**/*.ts'",
+    "lint:fix": "eslint 'src/**/*.ts' 'tests/**/*.ts' --fix",
+    "format": "prettier --write 'src/**/*.ts' 'tests/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts' 'tests/**/*.ts'",
+    "typecheck": "tsc --noEmit",
+    "size": "size-limit",
+    "api:snapshot": "bun scripts/api-snapshot.mjs && node scripts/api-report.mjs --local",
+    "api:check": "bun scripts/api-snapshot.mjs --check && node scripts/api-report.mjs",
+    "clean": "rm -rf dist",
+    "docs": "typedoc",
+    "postinstall": "node scripts/pin-lint-typescript.mjs",
+    "prepublishOnly": "npm run build",
+    "lint:pkg": "publint && attw --pack . --profile node16",
+    "check:deps": "node scripts/check-deps.mjs",
+    "test:golden": "vitest run tests/golden-vectors.test.ts",
+    "test:differential": "vitest run tests/differential.test.ts",
+    "vectors:generate": "bun scripts/generate-vectors.mjs",
+    "baseline:build": "bun scripts/build-baseline.mjs"
+  },
+  "keywords": [
+    "cbor",
+    "tags",
+    "blockchain-commons",
+    "envelope",
+    "gordian",
+    "cryptography"
+  ],
+  "engines": {
+    "node": ">=22.12"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@eslint/js": "^10.0.1",
+    "@microsoft/api-extractor": "^7.59.1",
+    "@size-limit/preset-small-lib": "^13.0.3",
+    "@types/node": "^26.1.1",
+    "@typescript-eslint/eslint-plugin": "^8.70.0",
+    "@typescript-eslint/parser": "^8.70.0",
+    "@vitest/coverage-v8": "^5.0.0",
+    "ajv": "^8.20.0",
+    "eslint": "^10.10.0",
+    "prettier": "3.9.6",
+    "publint": "^0.3.24",
+    "size-limit": "^13.0.3",
+    "tsdown": "^0.23.0",
+    "typedoc": "^0.28.20",
+    "typescript": "^7.0.2",
+    "typescript6": "npm:typescript@^6.0.3",
+    "vitest": "^5.0.0"
+  },
+  "dependencies": {
+    "@blockchaincommons/dcbor": "^1.0.0-beta.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,81 @@
+/**
+ * @blockchaincommons/tags - the CBOR tags used by Blockchain Commons
+ * protocols (Gordian Envelope, URs, crypto components), as frozen dcbor
+ * `Tag` values spelled `TAG_<NAME>`, plus {@link registerTags} to name them
+ * in a dcbor `TagsStore`. Compare tags with `Tag.equals` or by `.value`,
+ * never with `===`.
+ *
+ * @module @blockchaincommons/tags
+ */
+export {
+  TAG_URI,
+  TAG_UUID,
+  TAG_ENCODED_CBOR,
+  TAG_ENVELOPE,
+  TAG_LEAF,
+  TAG_JSON,
+  TAG_KNOWN_VALUE,
+  TAG_DIGEST,
+  TAG_ENCRYPTED,
+  TAG_COMPRESSED,
+  TAG_REQUEST,
+  TAG_RESPONSE,
+  TAG_FUNCTION,
+  TAG_PARAMETER,
+  TAG_PLACEHOLDER,
+  TAG_REPLACEMENT,
+  TAG_X25519_PRIVATE_KEY,
+  TAG_X25519_PUBLIC_KEY,
+  TAG_ARID,
+  TAG_PRIVATE_KEYS,
+  TAG_NONCE,
+  TAG_PASSWORD,
+  TAG_PRIVATE_KEY_BASE,
+  TAG_PUBLIC_KEYS,
+  TAG_SALT,
+  TAG_SEALED_MESSAGE,
+  TAG_SIGNATURE,
+  TAG_SIGNING_PRIVATE_KEY,
+  TAG_SIGNING_PUBLIC_KEY,
+  TAG_SYMMETRIC_KEY,
+  TAG_XID,
+  TAG_REFERENCE,
+  TAG_EVENT,
+  TAG_ENCRYPTED_KEY,
+  TAG_MLKEM_PRIVATE_KEY,
+  TAG_MLKEM_PUBLIC_KEY,
+  TAG_MLKEM_CIPHERTEXT,
+  TAG_MLDSA_PRIVATE_KEY,
+  TAG_MLDSA_PUBLIC_KEY,
+  TAG_MLDSA_SIGNATURE,
+  TAG_SEED,
+  TAG_HDKEY,
+  TAG_DERIVATION_PATH,
+  TAG_USE_INFO,
+  TAG_EC_KEY,
+  TAG_ADDRESS,
+  TAG_OUTPUT_DESCRIPTOR,
+  TAG_SSKR_SHARE,
+  TAG_PSBT,
+  TAG_ACCOUNT_DESCRIPTOR,
+  TAG_SSH_TEXT_PRIVATE_KEY,
+  TAG_SSH_TEXT_PUBLIC_KEY,
+  TAG_SSH_TEXT_SIGNATURE,
+  TAG_SSH_TEXT_CERTIFICATE,
+  TAG_PROVENANCE_MARK,
+  TAG_OUTPUT_SCRIPT_HASH,
+  TAG_OUTPUT_WITNESS_SCRIPT_HASH,
+  TAG_OUTPUT_PUBLIC_KEY,
+  TAG_OUTPUT_PUBLIC_KEY_HASH,
+  TAG_OUTPUT_WITNESS_PUBLIC_KEY_HASH,
+  TAG_OUTPUT_COMBO,
+  TAG_OUTPUT_MULTISIG,
+  TAG_OUTPUT_SORTED_MULTISIG,
+  TAG_OUTPUT_RAW_SCRIPT,
+  TAG_OUTPUT_TAPROOT,
+  TAG_OUTPUT_COSIGNER,
+  LEGACY_TAGS,
+  type LegacyTags,
+  ALL_TAGS,
+} from "./tags.js";
+export { registerTags } from "./register.js";

package/src/register.ts

@@ -0,0 +1,24 @@
+/**
+ * Registration into a dCBOR tags store.
+ *
+ * @module register
+ */
+import { type TagsStore, getGlobalTagsStore, registerStandardTags } from "@blockchaincommons/dcbor";
+import { ALL_TAGS } from "./tags.js";
+
+/**
+ * Register dcbor's standard tags and every tag in {@link ALL_TAGS} into
+ * `store` (default: the global store).
+ *
+ * Idempotent: the store compares names, so a value already registered under
+ * the same name is a no-op, which is what makes repeated calls safe.
+ *
+ * @param store - The store to register into; defaults to dcbor's global store.
+ * @throws {Error} dcbor's store throws a bare `Error` when a value is
+ * already registered under a *different* name
+ * (`Attempt to register tag: 200 'foo' with different name: 'envelope'`).
+ */
+export function registerTags(store: TagsStore = getGlobalTagsStore()): void {
+  registerStandardTags(store);
+  store.registerAll([...ALL_TAGS]);
+}

package/src/tags.ts

@@ -0,0 +1,314 @@
+/**
+ * The Blockchain Commons CBOR tag registry.
+ *
+ * Values are the CBOR tag numbers on the wire; names are wire too, since
+ * `uniform-resources` derives UR types from them (`ur:envelope`). Neither
+ * may change without a specification change. Every constant is frozen.
+ *
+ * Tags compare by value: `TAG_ENVELOPE === Tag.from(200, "envelope")` is
+ * `false` (two objects), `Tag.equals(a, b)` and `a.value === b.value` are
+ * the comparisons to write.
+ *
+ * @see https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2020-006-urtypes.md
+ * @module tags
+ */
+import {
+  Tag,
+  TAG_ENCODED_CBOR as IANA_ENCODED_CBOR,
+  TAG_URI as IANA_URI,
+  TAG_UUID as IANA_UUID,
+} from "@blockchaincommons/dcbor";
+
+/**
+ * One immutable tag. dcbor's `Tag.from` returns a plain object whose
+ * `readonly` is a compile-time promise only; the names here are wire,
+ * so nothing may rewrite them process-wide.
+ */
+const tag = (value: number, name: string): Tag => Object.freeze(Tag.from(value, name));
+
+// IANA standard tags this stack uses. dcbor owns the numbers (it defines
+// them unnamed); this registry owns the names.
+
+/** #6.32: URI (RFC 8949 §3.4.5.3), named `url` in this stack. */
+export const TAG_URI: Tag = tag(IANA_URI, "url");
+/** #6.37: binary UUID (RFC 4122). */
+export const TAG_UUID: Tag = tag(IANA_UUID, "uuid");
+
+// Core Envelope tags. #6.24 was used as the leaf header by an earlier spec
+// (incorrectly: RFC 8949 §3.4.5.1 requires a byte string); #6.201 replaced
+// it and #6.24 is still recognised on decode. #6.200 and #6.201 are the only
+// Blockchain Commons tags in IANA's "Specification Required" range.
+
+/** #6.24: encoded CBOR data item; the pre-#6.201 Envelope leaf header, accepted on decode only. */
+export const TAG_ENCODED_CBOR: Tag = tag(IANA_ENCODED_CBOR, "encoded-cbor");
+/** #6.200: Gordian Envelope. */
+export const TAG_ENVELOPE: Tag = tag(200, "envelope");
+/** #6.201: dCBOR data item; the Envelope leaf case. */
+export const TAG_LEAF: Tag = tag(201, "leaf");
+/** #6.262: byte string holding UTF-8 JSON text. */
+export const TAG_JSON: Tag = tag(262, "json");
+
+// Envelope extensions.
+
+/** #6.40000: known value, a registered unsigned integer with a fixed meaning. */
+export const TAG_KNOWN_VALUE: Tag = tag(40000, "known-value");
+/** #6.40001: SHA-256 digest. */
+export const TAG_DIGEST: Tag = tag(40001, "digest");
+/** #6.40002: encrypted message (IETF ChaCha20-Poly1305). */
+export const TAG_ENCRYPTED: Tag = tag(40002, "encrypted");
+/** #6.40003: DEFLATE-compressed data with the digest of the original. */
+export const TAG_COMPRESSED: Tag = tag(40003, "compressed");
+
+// Distributed function calls.
+
+/** #6.40004: request. */
+export const TAG_REQUEST: Tag = tag(40004, "request");
+/** #6.40005: response. */
+export const TAG_RESPONSE: Tag = tag(40005, "response");
+/** #6.40006: function identifier. */
+export const TAG_FUNCTION: Tag = tag(40006, "function");
+/** #6.40007: parameter identifier. */
+export const TAG_PARAMETER: Tag = tag(40007, "parameter");
+/** #6.40008: placeholder. */
+export const TAG_PLACEHOLDER: Tag = tag(40008, "placeholder");
+/** #6.40009: replacement. */
+export const TAG_REPLACEMENT: Tag = tag(40009, "replacement");
+
+// Cryptographic components.
+
+/** #6.40010: X25519 key-agreement private key. */
+export const TAG_X25519_PRIVATE_KEY: Tag = tag(40010, "agreement-private-key");
+/** #6.40011: X25519 key-agreement public key. */
+export const TAG_X25519_PUBLIC_KEY: Tag = tag(40011, "agreement-public-key");
+/** #6.40012: apparently random identifier (32 bytes). */
+export const TAG_ARID: Tag = tag(40012, "arid");
+/** #6.40013: a signing and an encapsulation private key together. */
+export const TAG_PRIVATE_KEYS: Tag = tag(40013, "crypto-prvkeys");
+/** #6.40014: nonce. */
+export const TAG_NONCE: Tag = tag(40014, "nonce");
+/** #6.40015: password. */
+export const TAG_PASSWORD: Tag = tag(40015, "password");
+/** #6.40016: private key base, the material every other key derives from. */
+export const TAG_PRIVATE_KEY_BASE: Tag = tag(40016, "crypto-prvkey-base");
+/** #6.40017: a signing and an encapsulation public key together. */
+export const TAG_PUBLIC_KEYS: Tag = tag(40017, "crypto-pubkeys");
+/** #6.40018: salt. */
+export const TAG_SALT: Tag = tag(40018, "salt");
+/** #6.40019: sealed message, encrypted to a recipient's public keys. */
+export const TAG_SEALED_MESSAGE: Tag = tag(40019, "crypto-sealed");
+/** #6.40020: signature. */
+export const TAG_SIGNATURE: Tag = tag(40020, "signature");
+/** #6.40021: signing private key. */
+export const TAG_SIGNING_PRIVATE_KEY: Tag = tag(40021, "signing-private-key");
+/** #6.40022: signing public key. */
+export const TAG_SIGNING_PUBLIC_KEY: Tag = tag(40022, "signing-public-key");
+/** #6.40023: symmetric encryption key. */
+export const TAG_SYMMETRIC_KEY: Tag = tag(40023, "crypto-key");
+/** #6.40024: extensible identifier (XID). */
+export const TAG_XID: Tag = tag(40024, "xid");
+/** #6.40025: reference to an identifier by a prefix of it. */
+export const TAG_REFERENCE: Tag = tag(40025, "reference");
+/** #6.40026: distributed function call event. */
+export const TAG_EVENT: Tag = tag(40026, "event");
+/** #6.40027: symmetric key wrapped for a recipient. */
+export const TAG_ENCRYPTED_KEY: Tag = tag(40027, "encrypted-key");
+
+// Post-quantum.
+
+/** #6.40100: ML-KEM (FIPS 203) private key. */
+export const TAG_MLKEM_PRIVATE_KEY: Tag = tag(40100, "mlkem-private-key");
+/** #6.40101: ML-KEM (FIPS 203) public key. */
+export const TAG_MLKEM_PUBLIC_KEY: Tag = tag(40101, "mlkem-public-key");
+/** #6.40102: ML-KEM (FIPS 203) encapsulated ciphertext. */
+export const TAG_MLKEM_CIPHERTEXT: Tag = tag(40102, "mlkem-ciphertext");
+/** #6.40103: ML-DSA (FIPS 204) private key. */
+export const TAG_MLDSA_PRIVATE_KEY: Tag = tag(40103, "mldsa-private-key");
+/** #6.40104: ML-DSA (FIPS 204) public key. */
+export const TAG_MLDSA_PUBLIC_KEY: Tag = tag(40104, "mldsa-public-key");
+/** #6.40105: ML-DSA (FIPS 204) signature. */
+export const TAG_MLDSA_SIGNATURE: Tag = tag(40105, "mldsa-signature");
+
+// Seeds, keys and wallets.
+
+/** #6.40300: cryptographic seed. */
+export const TAG_SEED: Tag = tag(40300, "seed");
+/** #6.40303: BIP-32 hierarchical deterministic key. */
+export const TAG_HDKEY: Tag = tag(40303, "hdkey");
+/** #6.40304: BIP-32 derivation path. */
+export const TAG_DERIVATION_PATH: Tag = tag(40304, "keypath");
+/** #6.40305: coin type and network (`coin-info`). */
+export const TAG_USE_INFO: Tag = tag(40305, "coin-info");
+/** #6.40306: elliptic-curve key. */
+export const TAG_EC_KEY: Tag = tag(40306, "eckey");
+/** #6.40307: address. */
+export const TAG_ADDRESS: Tag = tag(40307, "address");
+/** #6.40308: output descriptor. */
+export const TAG_OUTPUT_DESCRIPTOR: Tag = tag(40308, "output-descriptor");
+/** #6.40309: SSKR share. */
+export const TAG_SSKR_SHARE: Tag = tag(40309, "sskr");
+/** #6.40310: partially signed Bitcoin transaction. */
+export const TAG_PSBT: Tag = tag(40310, "psbt");
+/** #6.40311: account descriptor. */
+export const TAG_ACCOUNT_DESCRIPTOR: Tag = tag(40311, "account-descriptor");
+
+// SSH.
+
+/** #6.40800: OpenSSH text-format private key. */
+export const TAG_SSH_TEXT_PRIVATE_KEY: Tag = tag(40800, "ssh-private");
+/** #6.40801: OpenSSH text-format public key. */
+export const TAG_SSH_TEXT_PUBLIC_KEY: Tag = tag(40801, "ssh-public");
+/** #6.40802: OpenSSH text-format signature. */
+export const TAG_SSH_TEXT_SIGNATURE: Tag = tag(40802, "ssh-signature");
+/** #6.40803: OpenSSH text-format certificate. */
+export const TAG_SSH_TEXT_CERTIFICATE: Tag = tag(40803, "ssh-certificate");
+
+/** #6.1347571542: provenance mark. */
+export const TAG_PROVENANCE_MARK: Tag = tag(1347571542, "provenance");
+
+// Output descriptor script types (subtypes of `crypto-output`).
+
+/** #6.400: output descriptor `sh` (script hash). */
+export const TAG_OUTPUT_SCRIPT_HASH: Tag = tag(400, "output-script-hash");
+/** #6.401: output descriptor `wsh` (witness script hash). */
+export const TAG_OUTPUT_WITNESS_SCRIPT_HASH: Tag = tag(401, "output-witness-script-hash");
+/** #6.402: output descriptor `pk` (public key). */
+export const TAG_OUTPUT_PUBLIC_KEY: Tag = tag(402, "output-public-key");
+/** #6.403: output descriptor `pkh` (public key hash). */
+export const TAG_OUTPUT_PUBLIC_KEY_HASH: Tag = tag(403, "output-public-key-hash");
+/** #6.404: output descriptor `wpkh` (witness public key hash). */
+export const TAG_OUTPUT_WITNESS_PUBLIC_KEY_HASH: Tag = tag(404, "output-witness-public-key-hash");
+/** #6.405: output descriptor `combo`. */
+export const TAG_OUTPUT_COMBO: Tag = tag(405, "output-combo");
+/** #6.406: output descriptor `multi` (multisig). */
+export const TAG_OUTPUT_MULTISIG: Tag = tag(406, "output-multisig");
+/** #6.407: output descriptor `sortedmulti` (sorted multisig). */
+export const TAG_OUTPUT_SORTED_MULTISIG: Tag = tag(407, "output-sorted-multisig");
+/** #6.408: output descriptor `raw` (raw script). */
+export const TAG_OUTPUT_RAW_SCRIPT: Tag = tag(408, "output-raw-script");
+/** #6.409: output descriptor `tr` (taproot). */
+export const TAG_OUTPUT_TAPROOT: Tag = tag(409, "output-taproot");
+/** #6.410: output descriptor cosigner. */
+export const TAG_OUTPUT_COSIGNER: Tag = tag(410, "output-cosigner");
+
+/** The legacy tag set; see {@link LEGACY_TAGS}. */
+export interface LegacyTags {
+  /** #6.300: `crypto-seed`, superseded by {@link TAG_SEED}. */
+  readonly SEED_V1: Tag;
+  /** #6.306: `crypto-eckey`, superseded by {@link TAG_EC_KEY}. */
+  readonly EC_KEY_V1: Tag;
+  /** #6.309: `crypto-sskr`, superseded by {@link TAG_SSKR_SHARE}. */
+  readonly SSKR_SHARE_V1: Tag;
+  /** #6.303: `crypto-hdkey`, superseded by {@link TAG_HDKEY}. */
+  readonly HDKEY_V1: Tag;
+  /** #6.304: `crypto-keypath`, superseded by {@link TAG_DERIVATION_PATH}. */
+  readonly DERIVATION_PATH_V1: Tag;
+  /** #6.305: `crypto-coin-info`, superseded by {@link TAG_USE_INFO}. */
+  readonly USE_INFO_V1: Tag;
+  /** #6.307: `crypto-output`, superseded by {@link TAG_OUTPUT_DESCRIPTOR}. */
+  readonly OUTPUT_DESCRIPTOR_V1: Tag;
+  /** #6.310: `crypto-psbt`, superseded by {@link TAG_PSBT}. */
+  readonly PSBT_V1: Tag;
+  /** #6.311: `crypto-account`, superseded by {@link TAG_ACCOUNT_DESCRIPTOR}. */
+  readonly ACCOUNT_V1: Tag;
+}
+
+/**
+ * Superseded tags, accepted on decode only. They sit in IANA's
+ * "Specification Required" range (300–311) and were replaced by the
+ * first-come-first-served 40300+ tags above; existing data still uses them.
+ * Never emit these for new data. Frozen, like every entry in it.
+ */
+export const LEGACY_TAGS: LegacyTags = Object.freeze({
+  SEED_V1: tag(300, "crypto-seed"),
+  EC_KEY_V1: tag(306, "crypto-eckey"),
+  SSKR_SHARE_V1: tag(309, "crypto-sskr"),
+  HDKEY_V1: tag(303, "crypto-hdkey"),
+  DERIVATION_PATH_V1: tag(304, "crypto-keypath"),
+  USE_INFO_V1: tag(305, "crypto-coin-info"),
+  OUTPUT_DESCRIPTOR_V1: tag(307, "crypto-output"),
+  PSBT_V1: tag(310, "crypto-psbt"),
+  ACCOUNT_V1: tag(311, "crypto-account"),
+});
+
+/**
+ * Every tag this package defines, in registration order (the order the
+ * Rust reference registers them). Iterate this rather than the constants.
+ * Frozen, like every entry in it.
+ */
+export const ALL_TAGS: readonly Tag[] = Object.freeze([
+  TAG_URI,
+  TAG_UUID,
+  TAG_ENCODED_CBOR,
+  TAG_ENVELOPE,
+  TAG_LEAF,
+  TAG_JSON,
+  TAG_KNOWN_VALUE,
+  TAG_DIGEST,
+  TAG_ENCRYPTED,
+  TAG_COMPRESSED,
+  TAG_REQUEST,
+  TAG_RESPONSE,
+  TAG_FUNCTION,
+  TAG_PARAMETER,
+  TAG_PLACEHOLDER,
+  TAG_REPLACEMENT,
+  TAG_EVENT,
+  LEGACY_TAGS.SEED_V1,
+  LEGACY_TAGS.EC_KEY_V1,
+  LEGACY_TAGS.SSKR_SHARE_V1,
+  TAG_SEED,
+  TAG_EC_KEY,
+  TAG_SSKR_SHARE,
+  TAG_X25519_PRIVATE_KEY,
+  TAG_X25519_PUBLIC_KEY,
+  TAG_ARID,
+  TAG_PRIVATE_KEYS,
+  TAG_NONCE,
+  TAG_PASSWORD,
+  TAG_PRIVATE_KEY_BASE,
+  TAG_PUBLIC_KEYS,
+  TAG_SALT,
+  TAG_SEALED_MESSAGE,
+  TAG_SIGNATURE,
+  TAG_SIGNING_PRIVATE_KEY,
+  TAG_SIGNING_PUBLIC_KEY,
+  TAG_SYMMETRIC_KEY,
+  TAG_XID,
+  TAG_REFERENCE,
+  TAG_ENCRYPTED_KEY,
+  TAG_MLKEM_PRIVATE_KEY,
+  TAG_MLKEM_PUBLIC_KEY,
+  TAG_MLKEM_CIPHERTEXT,
+  TAG_MLDSA_PRIVATE_KEY,
+  TAG_MLDSA_PUBLIC_KEY,
+  TAG_MLDSA_SIGNATURE,
+  LEGACY_TAGS.HDKEY_V1,
+  LEGACY_TAGS.DERIVATION_PATH_V1,
+  LEGACY_TAGS.USE_INFO_V1,
+  LEGACY_TAGS.OUTPUT_DESCRIPTOR_V1,
+  LEGACY_TAGS.PSBT_V1,
+  LEGACY_TAGS.ACCOUNT_V1,
+  TAG_HDKEY,
+  TAG_DERIVATION_PATH,
+  TAG_USE_INFO,
+  TAG_ADDRESS,
+  TAG_OUTPUT_DESCRIPTOR,
+  TAG_PSBT,
+  TAG_ACCOUNT_DESCRIPTOR,
+  TAG_SSH_TEXT_PRIVATE_KEY,
+  TAG_SSH_TEXT_PUBLIC_KEY,
+  TAG_SSH_TEXT_SIGNATURE,
+  TAG_SSH_TEXT_CERTIFICATE,
+  TAG_OUTPUT_SCRIPT_HASH,
+  TAG_OUTPUT_WITNESS_SCRIPT_HASH,
+  TAG_OUTPUT_PUBLIC_KEY,
+  TAG_OUTPUT_PUBLIC_KEY_HASH,
+  TAG_OUTPUT_WITNESS_PUBLIC_KEY_HASH,
+  TAG_OUTPUT_COMBO,
+  TAG_OUTPUT_MULTISIG,
+  TAG_OUTPUT_SORTED_MULTISIG,
+  TAG_OUTPUT_RAW_SCRIPT,
+  TAG_OUTPUT_TAPROOT,
+  TAG_OUTPUT_COSIGNER,
+  TAG_PROVENANCE_MARK,
+]);