@trustbaseai/protocol 0.1.0

package/dist/ws-protocol.js

@@ -0,0 +1,289 @@
+"use strict";
+/**
+ * 索引器 WS 查询协议（PWA 的"只读门"）—— 类型 + 运行时校验。
+ *
+ * ## 事实出处（这一份协议是**已有实现**的镜像，不是新设计）
+ *
+ * - 服务端实现：`trustchain-relmerge/indexer/src/core/websocket.ts`
+ *   - 收消息分派 `handleMessage()`（`:508` 起；subscribe / unsubscribe / ping / query，
+ *     其余回 `unknown_type`）
+ *   - `subscribe`/`unsubscribe` topic 提取 `extractTopics()`（`:100` 起；老字段 `events`
+ *     与新字段 `topics` 都收，**两个都给时 `events` 优先**；非数组当空数组；
+ *     单 topic ≤64 字符；最多 64 个）
+ *   - `query` 校验 `handleQuery()`（`:553` 起）→ 参数校验 `validateQueryArgs()`（`:115` 起）
+ *   - 查询后端与上限常量 `indexer/src/core/ws-query-provider.ts` 的 `WS_QUERY_LIMITS`（`:17-25`）
+ *     与 `WS_QUERY_NAMES`（`:28`）
+ * - 设计文档口径：《PWA-内嵌P2P轻索引器设计-2026-09-22》§6.1
+ *
+ * ⚠️ 索引器行号**会随其自身演进漂移**（编写时索引器正在被其它人改），引用以
+ *    **函数名 / 常量名**为准；协议内容本身不随行号变化。
+ *
+ * ## 三条容易踩的语义
+ *
+ * 1. **`events` 优先于 `topics`**：两个字段都给时按 `events` 算（老客户端兼容策略）。
+ * 2. **非法 topic 是"过滤"不是"报错"**：服务端会静默丢掉超长/非字符串的 topic，
+ *    照样回 `subscribed`（回包里 `events` 才是权威的最终订阅集合）。客户端应以
+ *    响应里的 `events` 为准，不要以为发了就一定订上了。
+ * 3. **连接建立即默认全订** `block/transaction/product/order`
+ *    （`handleConnection()`，`:468`），`subscribe` 是**增量**语义，不是替换。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WS_ERROR_CODES = void 0;
+exports.extractTopics = extractTopics;
+exports.validateSubscribeRequest = validateSubscribeRequest;
+exports.validateUnsubscribeRequest = validateUnsubscribeRequest;
+exports.validateQueryArgs = validateQueryArgs;
+exports.validateQueryRequest = validateQueryRequest;
+exports.validateClientMessage = validateClientMessage;
+exports.validateServerMessage = validateServerMessage;
+const constants_1 = require("./constants");
+const validation_1 = require("./validation");
+/**
+ * `error` 消息与 `query_result.ok=false` 里的错误码。
+ *
+ * 出处：`indexer/src/core/websocket.ts` 里所有 `sendToClient({type:'error'...})`
+ * 与 `sendQueryFailure(...)` 的实参；`not_found` / `db_error` 来自
+ * `indexer/src/core/ws-query-provider.ts:264,271,279`。
+ */
+exports.WS_ERROR_CODES = [
+    'message_too_large',
+    'unknown_type',
+    'invalid_json',
+    'invalid_id',
+    'unknown_query',
+    'invalid_params',
+    'query_unavailable',
+    'too_many_requests',
+    'timeout',
+    'query_failed',
+    'not_found',
+    'db_error',
+];
+// ---------------------------------------------------------------------------
+// 校验函数
+// ---------------------------------------------------------------------------
+/**
+ * 提取订阅 topic —— **与 `websocket.ts` 的 `extractTopics()`（`:100` 起）逐行同语义**：
+ * `events` 优先于 `topics`；非数组 → []；逐项过滤（字符串、1..64 字符）；最多 64 项。
+ * 过滤语义是刻意的：服务端不会因为 topic 非法而报错。
+ */
+function extractTopics(request) {
+    if (!(0, validation_1.isPlainObject)(request))
+        return [];
+    const raw = request['events'] !== undefined ? request['events'] : request['topics'];
+    if (!Array.isArray(raw))
+        return [];
+    const topics = [];
+    for (const item of raw) {
+        if (typeof item !== 'string')
+            continue;
+        if (item.length === 0 || item.length > constants_1.WS_QUERY_LIMITS.maxTopicLength)
+            continue;
+        topics.push(item);
+        if (topics.length >= constants_1.WS_QUERY_LIMITS.maxTopics)
+            break;
+    }
+    return topics;
+}
+function validateSubscription(raw) {
+    const sinceHeight = raw['since_height'];
+    if (sinceHeight !== undefined &&
+        sinceHeight !== null &&
+        !(0, validation_1.isIntegerInRange)(sinceHeight, 0, Number.MAX_SAFE_INTEGER)) {
+        return (0, validation_1.invalid)('invalid_params', 'since_height must be a non-negative integer');
+    }
+    const request = { topics: extractTopics(raw) };
+    if (typeof sinceHeight === 'number')
+        request.since_height = sinceHeight;
+    return (0, validation_1.valid)(request);
+}
+/** 校验 `subscribe` 请求 */
+function validateSubscribeRequest(input) {
+    if (!(0, validation_1.isPlainObject)(input))
+        return (0, validation_1.invalid)('invalid_params', 'subscribe request must be an object');
+    if (input['type'] !== 'subscribe')
+        return (0, validation_1.invalid)('unknown_type', 'type must be "subscribe"');
+    return validateSubscription(input);
+}
+/** 校验 `unsubscribe` 请求 */
+function validateUnsubscribeRequest(input) {
+    if (!(0, validation_1.isPlainObject)(input))
+        return (0, validation_1.invalid)('invalid_params', 'unsubscribe request must be an object');
+    if (input['type'] !== 'unsubscribe')
+        return (0, validation_1.invalid)('unknown_type', 'type must be "unsubscribe"');
+    return validateSubscription(input);
+}
+/** 按 query 名校验参数（镜像 `websocket.ts` 的 `validateQueryArgs()`，`:115` 起） */
+function validateQueryArgs(name, args) {
+    const raw = args === undefined || args === null ? {} : args;
+    if (!(0, validation_1.isPlainObject)(raw))
+        return (0, validation_1.invalid)('invalid_params', 'args must be an object');
+    switch (name) {
+        case 'health':
+            return (0, validation_1.valid)({});
+        case 'catalog': {
+            const q = raw['q'] === undefined || raw['q'] === null ? '' : raw['q'];
+            if (typeof q !== 'string')
+                return (0, validation_1.invalid)('invalid_params', 'q must be a string');
+            if (q.length > constants_1.WS_QUERY_LIMITS.maxKeywordLength) {
+                return (0, validation_1.invalid)('invalid_params', `q too long (<=${constants_1.WS_QUERY_LIMITS.maxKeywordLength})`);
+            }
+            const limit = raw['limit'] === undefined || raw['limit'] === null
+                ? constants_1.WS_QUERY_LIMITS.defaultLimit
+                : raw['limit'];
+            if (!(0, validation_1.isIntegerInRange)(limit, 1, constants_1.WS_QUERY_LIMITS.maxLimit)) {
+                return (0, validation_1.invalid)('invalid_params', `limit must be an integer between 1 and ${constants_1.WS_QUERY_LIMITS.maxLimit}`);
+            }
+            const offset = raw['offset'] === undefined || raw['offset'] === null ? 0 : raw['offset'];
+            if (!(0, validation_1.isIntegerInRange)(offset, 0, constants_1.WS_QUERY_LIMITS.maxOffset)) {
+                return (0, validation_1.invalid)('invalid_params', `offset must be an integer between 0 and ${constants_1.WS_QUERY_LIMITS.maxOffset}`);
+            }
+            return (0, validation_1.valid)({ q, limit, offset });
+        }
+        case 'product': {
+            const id = raw['id'];
+            if (!(0, validation_1.isNonEmptyString)(id))
+                return (0, validation_1.invalid)('invalid_params', 'id must be a non-empty string');
+            if (id.length > constants_1.WS_QUERY_LIMITS.maxIdLength) {
+                return (0, validation_1.invalid)('invalid_params', `id too long (<=${constants_1.WS_QUERY_LIMITS.maxIdLength})`);
+            }
+            return (0, validation_1.valid)({ id });
+        }
+        case 'endpoints': {
+            const seller = raw['seller'] === undefined || raw['seller'] === null ? undefined : raw['seller'];
+            if (seller !== undefined && typeof seller !== 'string') {
+                return (0, validation_1.invalid)('invalid_params', 'seller must be a string');
+            }
+            if (typeof seller === 'string' && seller.length > constants_1.WS_QUERY_LIMITS.maxIdLength) {
+                return (0, validation_1.invalid)('invalid_params', `seller too long (<=${constants_1.WS_QUERY_LIMITS.maxIdLength})`);
+            }
+            return (0, validation_1.valid)((seller === undefined ? {} : { seller }));
+        }
+        default:
+            return (0, validation_1.invalid)('unknown_query', `unsupported query: ${String(name)}`);
+    }
+}
+/**
+ * 校验 `query` 请求（镜像 `websocket.ts` 的 `handleQuery()`，`:553` 起）：
+ * `id` 非空且 ≤128 → `q` 在白名单 → `args` 是对象 → 按 q 校验参数。
+ * 校验失败时的 `error` 码与服务端回的错误码一致，便于客户端同一套分支处理。
+ */
+function validateQueryRequest(input) {
+    if (!(0, validation_1.isPlainObject)(input))
+        return (0, validation_1.invalid)('invalid_params', 'query request must be an object');
+    if (input['type'] !== 'query')
+        return (0, validation_1.invalid)('unknown_type', 'type must be "query"');
+    const id = input['id'];
+    if (!(0, validation_1.isNonEmptyString)(id) || id.length > constants_1.WS_QUERY_LIMITS.maxQueryIdLength) {
+        return (0, validation_1.invalid)('invalid_id', `id must be a non-empty string (<=${constants_1.WS_QUERY_LIMITS.maxQueryIdLength} chars)`);
+    }
+    const name = typeof input['q'] === 'string' ? input['q'] : '';
+    if (!constants_1.WS_QUERY_NAMES.includes(name)) {
+        return (0, validation_1.invalid)('unknown_query', `supported queries: ${constants_1.WS_QUERY_NAMES.join(', ')}`);
+    }
+    const queryName = name;
+    const args = validateQueryArgs(queryName, input['args']);
+    if (!args.ok)
+        return args;
+    return (0, validation_1.valid)({ id, q: queryName, args: args.value });
+}
+/**
+ * 校验客户端消息（顶层分派，镜像 `websocket.ts` 的 `handleMessage()`，`:508` 起）。
+ * 未知 `type` 回 `unknown_type`（服务端同款行为：回 error 消息但不关连接）。
+ */
+function validateClientMessage(input) {
+    if (!(0, validation_1.isPlainObject)(input))
+        return (0, validation_1.invalid)('invalid_json', 'message must be a JSON object');
+    switch (input['type']) {
+        case 'subscribe': {
+            const r = validateSubscribeRequest(input);
+            if (!r.ok)
+                return r;
+            const msg = { type: 'subscribe', topics: r.value.topics };
+            if (r.value.since_height !== undefined)
+                msg.since_height = r.value.since_height;
+            return (0, validation_1.valid)(msg);
+        }
+        case 'unsubscribe': {
+            const r = validateUnsubscribeRequest(input);
+            if (!r.ok)
+                return r;
+            return (0, validation_1.valid)({ type: 'unsubscribe', topics: r.value.topics });
+        }
+        case 'ping':
+            return (0, validation_1.valid)({ type: 'ping' });
+        case 'query': {
+            const r = validateQueryRequest(input);
+            if (!r.ok)
+                return r;
+            return (0, validation_1.valid)({ type: 'query', id: r.value.id, q: r.value.q, args: r.value.args });
+        }
+        default:
+            return (0, validation_1.invalid)('unknown_type', `unknown message type: ${String(input['type'])}`);
+    }
+}
+function hasNumberField(value, key) {
+    return typeof value[key] === 'number' && Number.isFinite(value[key]);
+}
+/** 校验服务端消息。用于客户端侧防御（服务端可能升级、代理可能插话）。 */
+function validateServerMessage(input) {
+    if (!(0, validation_1.isPlainObject)(input))
+        return (0, validation_1.invalid)('invalid_json', 'message must be a JSON object');
+    const message = input;
+    // 通过校验即原样返回入参（不重建对象）：调用方可能要拿它算哈希 / 转发。
+    const passthrough = input;
+    switch (message['type']) {
+        case 'welcome':
+            if (typeof message['message'] !== 'string') {
+                return (0, validation_1.invalid)('invalid_params', 'welcome.message must be a string');
+            }
+            return (0, validation_1.valid)(passthrough);
+        case 'pong':
+            if (!hasNumberField(message, 'timestamp')) {
+                return (0, validation_1.invalid)('invalid_params', 'pong.timestamp must be a number');
+            }
+            return (0, validation_1.valid)(passthrough);
+        case 'subscribed':
+        case 'unsubscribed':
+            if (!Array.isArray(message['events'])) {
+                return (0, validation_1.invalid)('invalid_params', `${String(message['type'])}.events must be an array`);
+            }
+            return (0, validation_1.valid)(passthrough);
+        case 'block':
+            if (!hasNumberField(message, 'height')) {
+                return (0, validation_1.invalid)('invalid_params', 'block.height must be a number');
+            }
+            if (!Array.isArray(message['events'])) {
+                return (0, validation_1.invalid)('invalid_params', 'block.events must be an array');
+            }
+            return (0, validation_1.valid)(passthrough);
+        case 'transaction':
+        case 'product':
+        case 'order':
+            if (!hasNumberField(message, 'timestamp')) {
+                return (0, validation_1.invalid)('invalid_params', `${String(message['type'])}.timestamp must be a number`);
+            }
+            return (0, validation_1.valid)(passthrough);
+        case 'error':
+            if (!(0, validation_1.isNonEmptyString)(message['error'])) {
+                return (0, validation_1.invalid)('invalid_params', 'error.error must be a non-empty string');
+            }
+            return (0, validation_1.valid)(passthrough);
+        case 'query_result': {
+            const id = message['id'];
+            if (id !== null && !(0, validation_1.isNonEmptyString)(id)) {
+                return (0, validation_1.invalid)('invalid_params', 'query_result.id must be a string or null');
+            }
+            if (typeof message['ok'] !== 'boolean') {
+                return (0, validation_1.invalid)('invalid_params', 'query_result.ok must be a boolean');
+            }
+            if (message['ok'] === true && id === null) {
+                return (0, validation_1.invalid)('invalid_params', 'query_result with ok=true must echo a non-null id');
+            }
+            return (0, validation_1.valid)(passthrough);
+        }
+        default:
+            return (0, validation_1.invalid)('unknown_type', `unknown message type: ${String(message['type'])}`);
+    }
+}
+//# sourceMappingURL=ws-protocol.js.map

package/dist/ws-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-protocol.js","sourceRoot":"","sources":["../src/ws-protocol.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAkRH,sCAYC;AAmBD,4DAIC;AAGD,gEAMC;AAGD,8CA+DC;AAcD,oDAsBC;AAMD,sDA0BC;AAOD,sDAkEC;AA3gBD,2CAIqB;AACrB,6CAOsB;AA2LtB;;;;;;GAMG;AACU,QAAA,cAAc,GAAG;IAC5B,mBAAmB;IACnB,cAAc;IACd,cAAc;IACd,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;IACnB,SAAS;IACT,cAAc;IACd,WAAW;IACX,UAAU;CACF,CAAC;AA4CX,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;;GAIG;AACH,SAAgB,aAAa,CAAC,OAAgB;IAC5C,IAAI,CAAC,IAAA,0BAAa,EAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,2BAAe,CAAC,cAAc;YAAE,SAAS;QAChF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,MAAM,CAAC,MAAM,IAAI,2BAAe,CAAC,SAAS;YAAE,MAAM;IACxD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAC3B,GAA4B;IAE5B,MAAM,WAAW,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;IACxC,IACE,WAAW,KAAK,SAAS;QACzB,WAAW,KAAK,IAAI;QACpB,CAAC,IAAA,6BAAgB,EAAC,WAAW,EAAE,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,EAC1D,CAAC;QACD,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,6CAA6C,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,OAAO,GAAiC,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7E,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,CAAC,YAAY,GAAG,WAAW,CAAC;IACxE,OAAO,IAAA,kBAAK,EAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED,wBAAwB;AACxB,SAAgB,wBAAwB,CAAC,KAAc;IACrD,IAAI,CAAC,IAAA,0BAAa,EAAC,KAAK,CAAC;QAAE,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,qCAAqC,CAAC,CAAC;IACnG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,WAAW;QAAE,OAAO,IAAA,oBAAO,EAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC;IAC9F,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,0BAA0B;AAC1B,SAAgB,0BAA0B,CACxC,KAAc;IAEd,IAAI,CAAC,IAAA,0BAAa,EAAC,KAAK,CAAC;QAAE,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,uCAAuC,CAAC,CAAC;IACrG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,aAAa;QAAE,OAAO,IAAA,oBAAO,EAAC,cAAc,EAAE,4BAA4B,CAAC,CAAC;IAClG,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,wEAAwE;AACxE,SAAgB,iBAAiB,CAC/B,IAAO,EACP,IAAa;IAEb,MAAM,GAAG,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,IAAI,CAAC,IAAA,0BAAa,EAAC,GAAG,CAAC;QAAE,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;IAEpF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAA,kBAAK,EAAC,EAA0B,CAAC,CAAC;QAE3C,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtE,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;YAClF,IAAI,CAAC,CAAC,MAAM,GAAG,2BAAe,CAAC,gBAAgB,EAAE,CAAC;gBAChD,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,iBAAiB,2BAAe,CAAC,gBAAgB,GAAG,CAAC,CAAC;YACzF,CAAC;YAED,MAAM,KAAK,GACT,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI;gBACjD,CAAC,CAAC,2BAAe,CAAC,YAAY;gBAC9B,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACnB,IAAI,CAAC,IAAA,6BAAgB,EAAC,KAAK,EAAE,CAAC,EAAE,2BAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAA,oBAAO,EACZ,gBAAgB,EAChB,0CAA0C,2BAAe,CAAC,QAAQ,EAAE,CACrE,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACzF,IAAI,CAAC,IAAA,6BAAgB,EAAC,MAAM,EAAE,CAAC,EAAE,2BAAe,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5D,OAAO,IAAA,oBAAO,EACZ,gBAAgB,EAChB,2CAA2C,2BAAe,CAAC,SAAS,EAAE,CACvE,CAAC;YACJ,CAAC;YAED,OAAO,IAAA,kBAAK,EAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAA0B,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,IAAA,6BAAgB,EAAC,EAAE,CAAC;gBAAE,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;YAC7F,IAAI,EAAE,CAAC,MAAM,GAAG,2BAAe,CAAC,WAAW,EAAE,CAAC;gBAC5C,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,kBAAkB,2BAAe,CAAC,WAAW,GAAG,CAAC,CAAC;YACrF,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,EAAE,EAAE,EAA0B,CAAC,CAAC;QAC/C,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACjG,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACvD,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,2BAAe,CAAC,WAAW,EAAE,CAAC;gBAC9E,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,sBAAsB,2BAAe,CAAC,WAAW,GAAG,CAAC,CAAC;YACzF,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAyB,CAAC,CAAC;QACjF,CAAC;QAED;YACE,OAAO,IAAA,oBAAO,EAAC,eAAe,EAAE,sBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AASD;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,IAAA,0BAAa,EAAC,KAAK,CAAC;QAAE,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,iCAAiC,CAAC,CAAC;IAC/F,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO;QAAE,OAAO,IAAA,oBAAO,EAAC,cAAc,EAAE,sBAAsB,CAAC,CAAC;IAEtF,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,IAAA,6BAAgB,EAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,2BAAe,CAAC,gBAAgB,EAAE,CAAC;QAC1E,OAAO,IAAA,oBAAO,EACZ,YAAY,EACZ,oCAAoC,2BAAe,CAAC,gBAAgB,SAAS,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,IAAI,CAAE,0BAAoC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,OAAO,IAAA,oBAAO,EAAC,eAAe,EAAE,sBAAsB,0BAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,SAAS,GAAG,IAAmB,CAAC;IAEtC,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAE1B,OAAO,IAAA,kBAAK,EAAC,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,IAAA,0BAAa,EAAC,KAAK,CAAC;QAAE,OAAO,IAAA,oBAAO,EAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC;IAE3F,QAAQ,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,OAAO,CAAC,CAAC;YACpB,MAAM,GAAG,GAAuB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC9E,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS;gBAAE,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;YAChF,OAAO,IAAA,kBAAK,EAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,CAAC,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,OAAO,CAAC,CAAC;YACpB,OAAO,IAAA,kBAAK,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,MAAM;YACT,OAAO,IAAA,kBAAK,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,OAAO,CAAC,CAAC;YACpB,OAAO,IAAA,kBAAK,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QACD;YACE,OAAO,IAAA,oBAAO,EAAC,cAAc,EAAE,yBAAyB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAA8B,EAAE,GAAW;IACjE,OAAO,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,wCAAwC;AACxC,SAAgB,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,IAAA,0BAAa,EAAC,KAAK,CAAC;QAAE,OAAO,IAAA,oBAAO,EAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,KAAgC,CAAC;IACjD,uCAAuC;IACvC,MAAM,WAAW,GAAG,KAAgB,CAAC;IAErC,QAAQ,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,KAAK,SAAS;YACZ,IAAI,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC3C,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,kCAAkC,CAAC,CAAC;YACvE,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,WAA+B,CAAC,CAAC;QAEhD,KAAK,MAAM;YACT,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC1C,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,iCAAiC,CAAC,CAAC;YACtE,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,WAA4B,CAAC,CAAC;QAE7C,KAAK,YAAY,CAAC;QAClB,KAAK,cAAc;YACjB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;gBACtC,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;YACzF,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,WAA0D,CAAC,CAAC;QAE3E,KAAK,OAAO;YACV,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACvC,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;gBACtC,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,WAAkC,CAAC,CAAC;QAEnD,KAAK,aAAa,CAAC;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,OAAO;YACV,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC1C,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;YAC5F,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,WAA8B,CAAC,CAAC;QAE/C,KAAK,OAAO;YACV,IAAI,CAAC,IAAA,6BAAgB,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBACxC,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,wCAAwC,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,WAA6B,CAAC,CAAC;QAE9C,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,IAAA,6BAAgB,EAAC,EAAE,CAAC,EAAE,CAAC;gBACzC,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,0CAA0C,CAAC,CAAC;YAC/E,CAAC;YACD,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACvC,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,mCAAmC,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC1C,OAAO,IAAA,oBAAO,EAAC,gBAAgB,EAAE,mDAAmD,CAAC,CAAC;YACxF,CAAC;YACD,OAAO,IAAA,kBAAK,EAAC,WAAmC,CAAC,CAAC;QACpD,CAAC;QAED;YACE,OAAO,IAAA,oBAAO,EAAC,cAAc,EAAE,yBAAyB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@trustbaseai/protocol",
+  "version": "0.1.0",
+  "description": "TrustBase 跨侧唯一事实来源：链消息 type URL 注册表、bundle_hash 规范化、WS 查询协议、端点广播/探测协议、跨侧常量",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "trustbase",
+    "canonical-json",
+    "protocol",
+    "bundle-hash"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "jest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""
+  },
+  "dependencies": {
+    "@noble/hashes": "^1.8.0"
+  }
+}