@trustbaseai/protocol 0.1.0

package/dist/registry.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 链消息类型注册表 —— 跨侧唯一事实来源。
+ *
+ * ## 这个文件为什么必须"较真"
+ *
+ * CosmJS 把 `@type` 字符串（type URL）直接当注册表键查。写错的症状是：
+ *
+ * ```
+ * unable to resolve type URL /trustchain.order.v1.MsgCreateOrder
+ * ```
+ *
+ * 或者更糟 —— **不报错，但语义错位**（比如把 `MsgConfirmPayment` 的 `authority`
+ * 写成签名账户，链上按 `params.payment_authority` 校验后拒绝，
+ * 报错信息看起来像"权限不足"，实际是字段填错）。这类"静默失败"是本项目真机上
+ * 踩过的坑，所以注册表**逐条从 proto 核对**，并标注 `文件:行号`。
+ *
+ * ## 出处与快照
+ *
+ * - proto 目录：`trustchain-relmerge/proto/trustchain/<模块>/v1/tx.proto`
+ * - 快照：`trustchain-relmerge@40d16543fe604e39009c8dbf72a54bcb81419e52`（2026-09-22）
+ *   ⚠️ 其中 `proto/trustchain/endpoint/`、`x/endpoint/`、`indexer/src/core/ws-query-provider.ts`
+ *   在该提交里**尚未提交**（工作区未跟踪/已修改），出自 2026-09-22 的工作区状态。
+ * - **2026-09-23 追加核对**（D2 争议申诉 + D3 保险索赔，均为该日工作区改动，尚未 commit）：
+ *   `order/v1/tx.proto`（CreateOrder/CancelOrder signer → seller；ConfirmOrder/DisputeOrder
+ *   signer → submitter 且新增字段 `submitter = 5`）、`order/v1/params.proto`（新增
+ *   `dispute_authority = 6`）、`insurance/v1/tx.proto`（`MsgSubmitClaim.order_id = 6` 必填）、
+ *   `insurance/v1/query.proto`（`Claim.order_id = 12` / `Claim.beneficiary = 13`）。
+ * - 已跑通参考：`trustbase-seller-backend/core/chain-signer.js:22-46`（`CUSTOM_TYPE_URLS`，
+ *   真机联调过的 type URL 清单）、`routes/chain-writes*.js`、`routes/onboard.js`
+ *
+ * ⚠️ `provenBy` 引用的两个外部仓库（seller-backend / indexer）**都有人在改**，
+ *    行号会漂移；它们只是"去这里看真机怎么发的"的线索，不是机器校验的引用。
+ *    proto 的 `source` 行号才是硬引用（有工具校验）。
+ *
+ * **出处不是手抄的**：`tools/check-proto-citations.cjs` 会拿真实 proto 逐条核对
+ * message 名、字段名、字段类型、signer 注解，并做**反向完整性检查**（proto 有而注册表漏 = 失败）。
+ * 有链码 checkout 的人跑：
+ *
+ * ```bash
+ * npm run build
+ * node tools/check-proto-citations.cjs /path/to/trustchain-relmerge        # 校验
+ * node tools/check-proto-citations.cjs /path/to/trustchain-relmerge --fix  # 顺手收紧行号
+ * ```
+ *
+ * ## 收录口径
+ *
+ * 收录**业务方（卖家/买家/服务商）实际要发的消息**，加 gov/authority-only 的划转类。
+ * 不收录 `MsgUpdateParams`（纯治理，SDK 用户不会发）。
+ *
+ * `kind` 与 proto 标量的对应：
+ * - `uint64` / `int64` → wire JSON 里是**字符串**（proto3 JSON 规范）
+ * - `bytes` → wire JSON 里是 **base64**（不是 hex！本仓库真机踩过：
+ *   `routes/chain-writes-products.js:205` 把 hex 的 content_hash 转成 base64 再发链）
+ * - `enum` → wire JSON 里是枚举**名字符串**（如 `PRODUCT_TYPE_PHYSICAL`）
+ */
+export type ProtoFieldKind = 'string' | 'uint32' | 'uint64' | 'int64' | 'bool' | 'bytes' | 'enum';
+export interface MsgFieldSpec {
+    /** proto 字段名（snake_case，与链上 proto JSON 同名 —— protobufjs 用 keepCase） */
+    name: string;
+    kind: ProtoFieldKind;
+    /** proto3 语义下"必填"不存在，这里表达的是**业务必填**：不填链上会拒或语义错 */
+    required: boolean;
+    /** `kind === 'enum'` 时的枚举全名 */
+    enumType?: string;
+    /** 取值约束 / 踩坑提示 */
+    note?: string;
+}
+export interface MsgTypeSpec {
+    /** 形如 `/trustchain.order.v1.MsgCreateOrder` —— 直接作为 cosmjs `@type` 使用 */
+    typeUrl: string;
+    /** proto message 全名（typeUrl 去掉前导 `/`） */
+    protoMessage: string;
+    /**
+     * `option (cosmos.msg.v1.signer)` 指名的字段 —— 交易签名者必须是**这个字段里的地址**，
+     * 否则链上拒签（`intended signer does not match`）。`null` 表示该 proto 没声明 signer 注解。
+     */
+    signer: string | null;
+    /** amino 名（有声明才填）。走 amino/ledger 序列化路径时需要，proto JSON 路径不需要。 */
+    aminoName?: string;
+    /** 一句话说明用途（中文） */
+    summary: string;
+    /** 字段清单，按 proto 里的字段号顺序 */
+    fields: readonly MsgFieldSpec[];
+    /** 出处：`proto 相对路径:行号`。多行用 `,` 分隔。 */
+    source: string;
+    /** 真机已跑通的参考实现（可选） */
+    provenBy?: string;
+}
+/** 出处：`proto/trustchain/marketplace/v1/product.proto:7-13` */
+export declare const PRODUCT_TYPE: {
+    readonly PRODUCT_TYPE_UNSPECIFIED: 0;
+    readonly PRODUCT_TYPE_PHYSICAL: 1;
+    readonly PRODUCT_TYPE_DIGITAL: 2;
+    readonly PRODUCT_TYPE_SAAS: 3;
+    readonly PRODUCT_TYPE_SERVICE: 4;
+};
+export type ProductTypeName = keyof typeof PRODUCT_TYPE;
+export type ProductTypeValue = (typeof PRODUCT_TYPE)[ProductTypeName];
+/** 出处：`proto/trustchain/marketplace/v1/product.proto:16-21` */
+export declare const LICENSE_TYPE: {
+    readonly LICENSE_TYPE_UNSPECIFIED: 0;
+    readonly LICENSE_TYPE_PERPETUAL: 1;
+    readonly LICENSE_TYPE_SUBSCRIPTION: 2;
+    readonly LICENSE_TYPE_TRIAL: 3;
+};
+export type LicenseTypeName = keyof typeof LICENSE_TYPE;
+export type LicenseTypeValue = (typeof LICENSE_TYPE)[LicenseTypeName];
+export declare const MSG_TYPES: readonly MsgTypeSpec[];
+/** 全部 type URL（保持注册顺序） */
+export declare const MSG_TYPE_URLS: readonly string[];
+/** 按 type URL 取注册项；未注册返回 undefined（调用方应把它翻成"模块未上线/拼错"提示） */
+export declare function getMsgType(typeUrl: string): MsgTypeSpec | undefined;
+export declare function isKnownMsgType(typeUrl: unknown): typeUrl is string;
+/** 按 proto message 全名反查（`trustchain.order.v1.MsgCreateOrder`） */
+export declare function getMsgTypeByProtoMessage(protoMessage: string): MsgTypeSpec | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,8DAA8D;AAC9D,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,YAAY,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC;AAEtE,+DAA+D;AAC/D,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,YAAY,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC;AAYtE,eAAO,MAAM,SAAS,EAAE,SAAS,WAAW,EAgiB3C,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAA0C,CAAC;AAMtF,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,MAAM,CAElE;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEtF"}