@cello-protocol/protocol-types 0.0.2

package/dist/structure2.js

@@ -0,0 +1,138 @@
+/**
+ * CELLO-MERKLE-002 — Structure 2 wire type and codec.
+ *
+ * Structure 2 is the relay-built Merkle leaf:
+ *   [sequence_number, sender_pubkey, content_hash, sender_signature, scan_result, prev_root]
+ *
+ * scan_result in M1 is a sentinel placeholder: {score: null, verdict: "unscanned", model_hash: <32 zero bytes>}.
+ * The field is present to keep the wire layout stable for future scanner integration (M4+).
+ *
+ * Canonical CBOR per RFC 8949 §4.2.1.
+ * Ed25519 verification per RFC 8032.
+ *
+ * Structure 1 TBS (for signature verification):
+ *   [1, content_hash, sender_pubkey, session_id, last_seen_seq, timestamp]
+ * This is what the sender signs; verifyStructure2Signature reconstructs it from Structure 2 fields
+ * plus the session_id, last_seen_seq, and timestamp carried through the relay path.
+ */
+import { Encoder } from "cbor-x";
+import { verify } from "@cello-protocol/crypto";
+const CBOR_ENC = new Encoder({ tagUint8Array: false });
+// ─── Sentinel ─────────────────────────────────────────────────────────────────
+/** M1 placeholder scan_result sentinel. The scanner field is stable but unset until M4+. */
+export const SCAN_RESULT_SENTINEL = Object.freeze({
+    score: null,
+    verdict: "unscanned",
+    model_hash: new Uint8Array(32),
+});
+/**
+ * Encodes the scan_result sentinel as canonical CBOR (RFC 8949 §4.2.1).
+ *
+ * Keys are sorted by byte length per RFC 8949 §4.2.1 core deterministic encoding:
+ *   "score" (5) < "verdict" (7) < "model_hash" (10)
+ *
+ * cbor-x's default POJO encoding uses non-canonical map-size encoding (uint16 length prefix).
+ * We construct the canonical bytes manually to guarantee RFC 8949 §4.2.1 compliance.
+ */
+export function encodeScanResultSentinel() {
+    // a3 = 3-item CBOR map (major type 5, additional info 3)
+    // Keys sorted by length: "score"(5) < "verdict"(7) < "model_hash"(10)
+    return new Uint8Array(Buffer.concat([
+        Buffer.from([0xa3]),
+        // "score": null
+        Buffer.from([0x65]), Buffer.from("score"),
+        Buffer.from([0xf6]),
+        // "verdict": "unscanned"
+        Buffer.from([0x67]), Buffer.from("verdict"),
+        Buffer.from([0x69]), Buffer.from("unscanned"),
+        // "model_hash": 32-byte zero byte string
+        Buffer.from([0x6a]), Buffer.from("model_hash"),
+        Buffer.from([0x58, 0x20]), Buffer.alloc(32),
+    ]));
+}
+// ─── Build ────────────────────────────────────────────────────────────────────
+/**
+ * Constructs a Structure 2 object after validating all field lengths.
+ * scan_result is always the M1 sentinel — callers do not supply it.
+ */
+export function buildStructure2(sequence_number, sender_pubkey, content_hash, sender_signature, prev_root) {
+    if (sender_pubkey.length !== 32) {
+        return {
+            ok: false,
+            error: { reason: "invalid_field", field: "sender_pubkey", message: `sender_pubkey must be 32 bytes, got ${sender_pubkey.length}` },
+        };
+    }
+    if (content_hash.length !== 32) {
+        return {
+            ok: false,
+            error: { reason: "invalid_field", field: "content_hash", message: `content_hash must be 32 bytes, got ${content_hash.length}` },
+        };
+    }
+    if (sender_signature.length !== 64) {
+        return {
+            ok: false,
+            error: { reason: "invalid_field", field: "sender_signature", message: `sender_signature must be 64 bytes, got ${sender_signature.length}` },
+        };
+    }
+    if (prev_root.length !== 32) {
+        return {
+            ok: false,
+            error: { reason: "invalid_field", field: "prev_root", message: `prev_root must be 32 bytes, got ${prev_root.length}` },
+        };
+    }
+    return {
+        ok: true,
+        structure2: {
+            sequence_number,
+            sender_pubkey,
+            content_hash,
+            sender_signature,
+            scan_result: SCAN_RESULT_SENTINEL,
+            prev_root,
+        },
+    };
+}
+// ─── Encode ───────────────────────────────────────────────────────────────────
+/**
+ * Encodes Structure 2 as canonical CBOR (RFC 8949 §4.2.1).
+ * Wire format: [sequence_number, sender_pubkey, content_hash, sender_signature, scan_result, prev_root]
+ */
+export function encodeStructure2(s2) {
+    const sentinelBytes = encodeScanResultSentinel();
+    // We must embed the pre-encoded sentinel bytes as raw CBOR, not re-encode the object.
+    // Construct the 6-element array manually to preserve canonical byte representation.
+    const arrayHeader = new Uint8Array([0x86]); // 6-element CBOR array
+    const seqBytes = CBOR_ENC.encode(s2.sequence_number);
+    const pubBytes = CBOR_ENC.encode(s2.sender_pubkey);
+    const hashBytes = CBOR_ENC.encode(s2.content_hash);
+    const sigBytes = CBOR_ENC.encode(s2.sender_signature);
+    const prevBytes = CBOR_ENC.encode(s2.prev_root);
+    return new Uint8Array(Buffer.concat([arrayHeader, seqBytes, pubBytes, hashBytes, sigBytes, sentinelBytes, prevBytes]));
+}
+// ─── Verify ───────────────────────────────────────────────────────────────────
+/**
+ * Reconstructs canonical CBOR of Structure 1 from Structure 2 fields plus the
+ * session_id, last_seen_seq, and timestamp carried through the relay path,
+ * then verifies the sender's Ed25519 signature.
+ *
+ * Structure 1 TBS: [1, content_hash, sender_pubkey, session_id, last_seen_seq, timestamp]
+ * Per RFC 8032 (Ed25519) and RFC 8949 §4.2.1 (canonical CBOR).
+ *
+ * @param timestamp - Unix milliseconds. May be number or bigint. cbor-x decodes uint64
+ *   timestamps as bigint; relay callers that deserialize Structure 1 CBOR must pass the
+ *   decoded value directly here rather than converting to number (which is lossy above
+ *   Number.MAX_SAFE_INTEGER).
+ */
+export function verifyStructure2Signature(s2, session_id, last_seen_seq, timestamp) {
+    const tsEncoded = typeof timestamp === "bigint" ? timestamp : timestamp > 0xffffffff ? BigInt(timestamp) : timestamp;
+    const tbs = CBOR_ENC.encode([
+        1,
+        s2.content_hash,
+        s2.sender_pubkey,
+        session_id,
+        last_seen_seq,
+        tsEncoded,
+    ]);
+    return verify(s2.sender_pubkey, tbs, s2.sender_signature);
+}
+//# sourceMappingURL=structure2.js.map

package/dist/structure2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure2.js","sourceRoot":"","sources":["../src/structure2.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * @cello-protocol/protocol-types — CELLO-MSG-001 (v0) + CELLO-MSG-003 (v1)
+ *
+ * Wire types for the MessageEnvelope.
+ *
+ * v0 TBS layout (positional, RFC 8949 §4.2.1 canonical CBOR):
+ *   [protocol_version, content_hash, sender_pubkey, timestamp]
+ *
+ * v1 TBS layout (Structure 1, RFC 8949 §4.2.1 canonical CBOR):
+ *   [protocol_version, content_hash, sender_pubkey, session_id, last_seen_seq, timestamp]
+ *
+ * Wire format (canonical CBOR, RFC 8949 §4.2.1):
+ *   Full envelope is a CBOR map with the fields below.
+ *
+ * Ed25519 reference: RFC 8032
+ * CBOR reference: RFC 8949
+ */
+/**
+ * A signed, tamper-evident message envelope (v0, M0).
+ *
+ * All byte arrays are bare Uint8Array values — no CBOR tag.
+ * The timestamp is stored as a JS number (milliseconds since Unix epoch).
+ */
+export interface MessageEnvelope {
+    /** CBOR unsigned integer, always 0 in M0. */
+    protocol_version: 0;
+    /** 32-byte Ed25519 K_local public key of the sender. */
+    sender_pubkey: Uint8Array;
+    /** Raw message content, up to 1 MiB. */
+    content: Uint8Array;
+    /**
+     * SHA-256(0x00 || content) — computed by msgLeafHash from @cello-protocol/crypto.
+     * ALWAYS recomputed by buildEnvelope; any caller-supplied value is ignored.
+     */
+    content_hash: Uint8Array;
+    /** Unix milliseconds, non-negative. */
+    timestamp: number;
+    /** 64-byte Ed25519 signature over canonical CBOR of TBS. */
+    sender_signature: Uint8Array;
+}
+/**
+ * A signed, tamper-evident message envelope (v1, M1).
+ *
+ * Adds session_id and last_seen_seq to the TBS array (Structure 1).
+ * protocol_version is always 1. M1 hard-cuts v0 — these are never interoperable.
+ *
+ * TBS (Structure 1): [1, content_hash, sender_pubkey, session_id, last_seen_seq, timestamp]
+ * All byte arrays are bare Uint8Array values — no CBOR tag.
+ *
+ * Ed25519 reference: RFC 8032
+ * CBOR reference: RFC 8949 §4.2.1
+ */
+export interface MessageEnvelopeV1 {
+    /** CBOR unsigned integer, always 1 in M1. */
+    protocol_version: 1;
+    /** 32-byte Ed25519 K_local public key of the sender. */
+    sender_pubkey: Uint8Array;
+    /** Raw message content, up to 1 MiB. */
+    content: Uint8Array;
+    /**
+     * SHA-256(0x00 || content) — computed by msgLeafHash from @cello-protocol/crypto.
+     * ALWAYS recomputed by buildEnvelopeV1; any caller-supplied value is ignored.
+     */
+    content_hash: Uint8Array;
+    /** 16-byte session identifier. */
+    session_id: Uint8Array;
+    /**
+     * Highest canonical sequence number seen from relay on this session.
+     * 0 for the first message on a session.
+     * CBOR unsigned integer, non-negative.
+     */
+    last_seen_seq: number;
+    /** Unix milliseconds, non-negative. */
+    timestamp: number;
+    /**
+     * 64-byte Ed25519 signature over canonical CBOR of Structure 1:
+     * [1, content_hash, sender_pubkey, session_id, last_seen_seq, timestamp]
+     */
+    sender_signature: Uint8Array;
+}
+export interface ContentTooLargeError {
+    reason: "content_too_large";
+    message: string;
+}
+export interface ContentHashMismatchError {
+    reason: "content_hash_mismatch";
+    message: string;
+}
+export interface UnsupportedVersionError {
+    reason: "unsupported_version";
+    message: string;
+}
+export interface InvalidFieldError {
+    reason: "invalid_field";
+    field: string;
+    message: string;
+}
+export interface MissingFieldError {
+    reason: "missing_field";
+    field: string;
+    message: string;
+}
+export type EnvelopeError = ContentTooLargeError | ContentHashMismatchError | UnsupportedVersionError | InvalidFieldError | MissingFieldError;
+export type BuildResult = {
+    ok: true;
+    envelope: MessageEnvelope;
+} | {
+    ok: false;
+    error: EnvelopeError;
+};
+export type ValidateResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: EnvelopeError;
+};
+export type DeserializeResult = {
+    ok: true;
+    envelope: MessageEnvelope;
+} | {
+    ok: false;
+    error: EnvelopeError;
+};
+export type BuildResultV1 = {
+    ok: true;
+    envelope: MessageEnvelopeV1;
+} | {
+    ok: false;
+    error: EnvelopeError;
+};
+export type ValidateResultV1 = {
+    ok: true;
+} | {
+    ok: false;
+    error: EnvelopeError;
+};
+export type DeserializeResultV1 = {
+    ok: true;
+    envelope: MessageEnvelopeV1;
+} | {
+    ok: false;
+    error: EnvelopeError;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,19 @@
+/**
+ * @cello-protocol/protocol-types — CELLO-MSG-001 (v0) + CELLO-MSG-003 (v1)
+ *
+ * Wire types for the MessageEnvelope.
+ *
+ * v0 TBS layout (positional, RFC 8949 §4.2.1 canonical CBOR):
+ *   [protocol_version, content_hash, sender_pubkey, timestamp]
+ *
+ * v1 TBS layout (Structure 1, RFC 8949 §4.2.1 canonical CBOR):
+ *   [protocol_version, content_hash, sender_pubkey, session_id, last_seen_seq, timestamp]
+ *
+ * Wire format (canonical CBOR, RFC 8949 §4.2.1):
+ *   Full envelope is a CBOR map with the fields below.
+ *
+ * Ed25519 reference: RFC 8032
+ * CBOR reference: RFC 8949
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@cello-protocol/protocol-types",
+  "version": "0.0.2",
+  "private": false,
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "package.json"
+  ],
+  "dependencies": {
+    "cbor-x": "^1.6.4",
+    "@cello-protocol/crypto": "0.0.2"
+  },
+  "devDependencies": {
+    "@claude-flow/testing": "3.0.0-alpha.6",
+    "@types/node": "^25.6.2",
+    "@cello-protocol/test-fixtures": "0.0.2"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "test": "vitest run"
+  }
+}