@trustbaseai/protocol 0.1.0

package/dist/registry.js

@@ -0,0 +1,637 @@
+"use strict";
+/**
+ * 链消息类型注册表 —— 跨侧唯一事实来源。
+ *
+ * ## 这个文件为什么必须"较真"
+ *
+ * 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`）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MSG_TYPE_URLS = exports.MSG_TYPES = exports.LICENSE_TYPE = exports.PRODUCT_TYPE = void 0;
+exports.getMsgType = getMsgType;
+exports.isKnownMsgType = isKnownMsgType;
+exports.getMsgTypeByProtoMessage = getMsgTypeByProtoMessage;
+/** 出处：`proto/trustchain/marketplace/v1/product.proto:7-13` */
+exports.PRODUCT_TYPE = {
+    PRODUCT_TYPE_UNSPECIFIED: 0,
+    PRODUCT_TYPE_PHYSICAL: 1,
+    PRODUCT_TYPE_DIGITAL: 2,
+    PRODUCT_TYPE_SAAS: 3,
+    PRODUCT_TYPE_SERVICE: 4,
+};
+/** 出处：`proto/trustchain/marketplace/v1/product.proto:16-21` */
+exports.LICENSE_TYPE = {
+    LICENSE_TYPE_UNSPECIFIED: 0,
+    LICENSE_TYPE_PERPETUAL: 1,
+    LICENSE_TYPE_SUBSCRIPTION: 2,
+    LICENSE_TYPE_TRIAL: 3,
+};
+const ORDER = 'proto/trustchain/order/v1/tx.proto';
+const MARKETPLACE = 'proto/trustchain/marketplace/v1/tx.proto';
+const VERIFICATION = 'proto/trustchain/verification/v1/tx.proto';
+const SERVICEPROVIDER = 'proto/trustchain/serviceprovider/v1/tx.proto';
+const INSURANCE = 'proto/trustchain/insurance/v1/tx.proto';
+const REWARD = 'proto/trustchain/reward/v1/tx.proto';
+const ENDPOINT = 'proto/trustchain/endpoint/v1/tx.proto';
+const SUBCHAIN = 'proto/trustchain/subchain/v1/tx.proto';
+const ECONOMY = 'proto/trustchain/economy/v1/tx.proto';
+exports.MSG_TYPES = [
+    // -------------------------------------------------------------------------
+    // x/order —— 下单 / 支付 / 履约 / 结算
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.order.v1.MsgCreateOrder',
+        protoMessage: 'trustchain.order.v1.MsgCreateOrder',
+        // 2026-09-22 方案 A（xiaomu 拍板，见 prd-docs 入口文档 §8.3.1）：signer 由 buyer 改为 seller。
+        // 原因：买家不装节点、浏览器侧不持私钥 → 买家无签名能力；订单的收益与信誉一律以
+        // MsgConfirmPaymentFact（真实支付事实）为准，卖家自造订单拿不到好处。
+        // ⚠️ 这条随 v3.9.4 升级生效；升级前链上仍是 buyer。且必须与卖家后端同批上线
+        // （升级后 buyer == seller 会被链上拒，而升级前后端正是这么发的）。
+        signer: 'seller',
+        summary: '下单（signer=seller，卖家代建单；v9 起支持 payment_method=""/"tct"/"fiat"）',
+        fields: [
+            { name: 'buyer', kind: 'string', required: true, note: '买家 tct1 地址（**不是签名者**）；必须合法 bech32、非空、≠ seller，且已注册 trustcoin 账户（否则退款无处可退）' },
+            { name: 'seller', kind: 'string', required: true, note: '卖家 tct1 地址；**签名者必须是它**；链上要求双方都已注册 trustcoin 账户' },
+            { name: 'sku_id', kind: 'string', required: true },
+            { name: 'quantity', kind: 'uint64', required: true },
+            { name: 'price_per_unit', kind: 'string', required: true, note: 'microTCT 整数串（不是 TCT！）' },
+            { name: 'shipping_address_hash', kind: 'string', required: false, note: '加密后的收货地址哈希' },
+            { name: 'source_chain', kind: 'string', required: false, note: '多链预留；空串 = 当前链' },
+            { name: 'payment_method', kind: 'string', required: false, note: '"" / "tct" / "fiat"；空 = tct。fiat 不锁 escrow' },
+            { name: 'referrer', kind: 'string', required: false, note: '引荐入口店地址；空 = 无引荐' },
+        ],
+        // 买家知情证据走 tx memo（不是字段）：以 `tb-auth:` 开头时必须跟 64 位小写 hex（sha256）；
+        // 原文（时间/商品/金额/买家标识）由卖家节点本地保存，争议时出示。
+        source: `${ORDER}:45-63`,
+        provenBy: 'trustbase-seller-backend/routes/chain-writes.js:416（/orders 路由；行号会漂移）',
+    },
+    {
+        typeUrl: '/trustchain.order.v1.MsgConfirmPayment',
+        protoMessage: 'trustchain.order.v1.MsgConfirmPayment',
+        signer: 'authority',
+        aminoName: 'trustchain/x/order/MsgConfirmPayment',
+        summary: '支付事实确认（预言机回调）：PENDING → PAID，库存在此步扣减',
+        fields: [
+            { name: 'authority', kind: 'string', required: true, note: '= params.payment_authority（Phase A 卖家 / Phase B 平台支付服务）；空参回落模块 authority(gov)' },
+            { name: 'order_id', kind: 'uint64', required: true },
+            { name: 'psp_payment_id', kind: 'string', required: true, note: '支付凭证号，幂等键；重复回调直接拒' },
+        ],
+        source: `${ORDER}:145-152`,
+        provenBy: 'trustbase-seller-backend/routes/chain-writes.js:500（/payments 回调；行号会漂移）',
+    },
+    {
+        typeUrl: '/trustchain.order.v1.MsgSettleOrder',
+        protoMessage: 'trustchain.order.v1.MsgSettleOrder',
+        signer: 'caller',
+        aminoName: 'trustchain/x/order/MsgSettleOrder',
+        summary: '结算 crank（permissionless）：确认收货 + 争议窗口过后任何人可触发',
+        fields: [
+            { name: 'caller', kind: 'string', required: true, note: '任何人，无权限要求' },
+            { name: 'order_id', kind: 'uint64', required: true },
+        ],
+        source: `${ORDER}:157-163`,
+    },
+    {
+        typeUrl: '/trustchain.order.v1.MsgTransferCredits',
+        protoMessage: 'trustchain.order.v1.MsgTransferCredits',
+        signer: 'caller',
+        aminoName: 'trustchain/x/order/MsgTransferCredits',
+        summary: '引荐佣金结算 crank（permissionless）：卖家经营科目 → referrer 经营科目',
+        fields: [
+            { name: 'caller', kind: 'string', required: true, note: '任何人，无权限' },
+            { name: 'order_id', kind: 'uint64', required: true, note: '同一 order_id 只结一次；卖家经营不足时 skip' },
+        ],
+        source: `${ORDER}:170-176`,
+    },
+    {
+        typeUrl: '/trustchain.order.v1.MsgShipOrder',
+        protoMessage: 'trustchain.order.v1.MsgShipOrder',
+        signer: 'seller',
+        summary: '卖家发货',
+        fields: [
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'order_id', kind: 'uint64', required: true },
+            { name: 'tracking_info', kind: 'string', required: true, note: '加密后的物流信息' },
+        ],
+        source: `${ORDER}:69-74`,
+    },
+    {
+        typeUrl: '/trustchain.order.v1.MsgConfirmOrder',
+        protoMessage: 'trustchain.order.v1.MsgConfirmOrder',
+        // 2026-09-23 D2 —— signer 是 **submitter**。注意三点：
+        //  1. `buyer` 字段只是「实际发起方」的记录（keeper 校验它 = 订单买家），**不是签名者**；
+        //  2. `signer: 'submitter'` 只说明"签名写在这个字段里"，**不代表签名者身份是卖家**；
+        //  3. 真正的白名单判定在 keeper：`x/order/keeper/order_submit_auth.go` 的
+        //     `authorizeOrderSubmit()` —— 三条路径任一命中即放行：
+        //       a. `seller`            — 订单卖家本人代买家确认收货（方案 A 基线路径）；
+        //       b. `dispute_authority` — params.dispute_authority（平台服务商/客服运营），
+        //                                治理可调、空串 = 关闭该路径
+        //                                （proto/trustchain/order/v1/params.proto:36-39）； 
+        //       c. `timeout_fallback`  — 订单 SHIPPED 且 now > shipped_at + params.auto_confirm_timeout
+        //                                → **任何账户**都可提交（卖家与平台双双不作为时的硬兜底）。
+        //     其余账户一律拒（否则任何账户都能替买家提前放款 + 吃掉争议窗口）。
+        // 路径值也会写进事件（`submit_path`，见 order_submit_auth.go:13-19），索引器按它分类。
+        // ⚠️ v3.9.4/D2 生效，必须与卖家后端同批上线。
+        signer: 'submitter',
+        summary: '确认收货 + 评价（签名者 = submitter：订单卖家 / dispute_authority / 超时兜底任意账户）',
+        fields: [
+            { name: 'buyer', kind: 'string', required: true, note: '实际买家地址（keeper 校验其合法性），**不是签名者**' },
+            { name: 'order_id', kind: 'uint64', required: true },
+            { name: 'rating', kind: 'uint64', required: true, note: '1-5 星' },
+            { name: 'review', kind: 'string', required: false },
+            { name: 'submitter', kind: 'string', required: true, note: '**签名者**；白名单三条路径见上方注释（判定在 keeper，不在消息本身）' },
+        ],
+        source: `${ORDER}:90-98`,
+    },
+    {
+        typeUrl: '/trustchain.order.v1.MsgCancelOrder',
+        protoMessage: 'trustchain.order.v1.MsgCancelOrder',
+        // 2026-09-22 方案 A 延伸（v3.9.4 生效）—— signer 由 canceller 改为 **seller**。
+        // 与 ConfirmOrder/DisputeOrder 不同：这条**只有一条路径**（订单卖家本人），
+        // keeper 新增校验 `seller` 必须 = 订单卖家 —— 否则任何账户都能取消别人的订单。
+        // `canceller` 字段降级为「实际发起方」的记录（buyer 或 seller，keeper 校验其合法性）。
+        signer: 'seller',
+        summary: '取消订单（仅 PENDING；签名者 = 订单卖家；canceller 记实际发起方）',
+        fields: [
+            { name: 'canceller', kind: 'string', required: true, note: '实际发起方记录（buyer 或 seller；**不是签名者**）' },
+            { name: 'order_id', kind: 'uint64', required: true },
+            { name: 'seller', kind: 'string', required: true, note: '**签名者**；链上校验必须 = 订单卖家' },
+        ],
+        source: `${ORDER}:125-131`,
+    },
+    {
+        typeUrl: '/trustchain.order.v1.MsgDisputeOrder',
+        protoMessage: 'trustchain.order.v1.MsgDisputeOrder',
+        // 2026-09-23 D2 —— signer 是 **submitter**，白名单与 MsgConfirmOrder **完全一致**
+        //（见上方 MsgConfirmOrder 的注释：seller / params.dispute_authority / timeout_fallback 三条路径）。
+        // `disputer` 字段只是「实际发起方」的记录（buyer 或 seller，keeper 校验），**不是签名者**。
+        // D2 口径的意义：买家不持私钥，争议**必须有人能发起** —— 卖家与平台服务商是两条入口，
+        // 超时兜底保证"两边都不作为"时订单不会永久卡死（escrow 锁死 + 买家无法申诉）。
+        signer: 'submitter',
+        summary: '发起争议（签名者 = submitter：订单卖家 / dispute_authority / 超时兜底任意账户）',
+        fields: [
+            { name: 'disputer', kind: 'string', required: true, note: '实际发起方记录（buyer 或 seller；**不是签名者**）' },
+            { name: 'order_id', kind: 'uint64', required: true },
+            { name: 'reason', kind: 'string', required: true },
+            { name: 'evidence_hash', kind: 'string', required: false, note: '证据材料哈希（hex）' },
+            { name: 'submitter', kind: 'string', required: true, note: '**签名者**；白名单三条路径同 MsgConfirmOrder（判定在 keeper）' },
+        ],
+        source: `${ORDER}:109-117`,
+    },
+    {
+        typeUrl: '/trustchain.order.v1.MsgResolveDispute',
+        protoMessage: 'trustchain.order.v1.MsgResolveDispute',
+        signer: 'resolver',
+        summary: '裁决争议（keeper 内另有 authority 校验，实际为治理/仲裁路径）',
+        fields: [
+            { name: 'resolver', kind: 'string', required: true },
+            { name: 'order_id', kind: 'uint64', required: true },
+            { name: 'refund_percent', kind: 'uint32', required: true, note: '0-100，退给买家的百分比' },
+            { name: 'resolution_note', kind: 'string', required: false },
+        ],
+        source: `${ORDER}:134-140`,
+    },
+    // -------------------------------------------------------------------------
+    // x/marketplace —— 上架 / 库存 / 下架
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.marketplace.v1.MsgListSKU',
+        protoMessage: 'trustchain.marketplace.v1.MsgListSKU',
+        signer: 'seller',
+        aminoName: 'trustchain/x/marketplace/MsgListSKU',
+        summary: '上架 SKU（同一 ACTIVE sku_id 重复上架会被拒 → 应转 MsgAddStock）',
+        fields: [
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'sku_id', kind: 'string', required: true },
+            { name: 'content_hash', kind: 'bytes', required: true, note: 'base64！线协议里常见 hex，发链前必须转 base64（chain-writes-products.js:205）' },
+            { name: 'stock', kind: 'uint64', required: true },
+            { name: 'stake_per_unit', kind: 'string', required: true, note: 'microTCT 串；链上 params.min_stake_per_unit 默认 1000000 (1 TCT)，写 0 会被拒' },
+            { name: 'cdn_url', kind: 'string', required: false },
+            { name: 'p2p_endpoint', kind: 'string', required: false, note: '形如 "[2001:db8::1]:9527"（IPv6:端口）' },
+            { name: 'product_type', kind: 'enum', required: false, enumType: 'trustchain.marketplace.v1.ProductType', note: '默认 PRODUCT_TYPE_UNSPECIFIED(0) = 实体物品' },
+            { name: 'download_url', kind: 'string', required: false, note: '数字产品专有' },
+            { name: 'license_type', kind: 'enum', required: false, enumType: 'trustchain.marketplace.v1.LicenseType' },
+            { name: 'version', kind: 'string', required: false, note: '数字产品专有' },
+            { name: 'api_endpoint', kind: 'string', required: false, note: 'SaaS 专有' },
+            { name: 'subscription_duration', kind: 'uint64', required: false, note: 'SaaS 专有（秒）' },
+            { name: 'service_duration', kind: 'uint64', required: false, note: '服务类专有（秒）' },
+            { name: 'service_provider', kind: 'string', required: false, note: '服务类专有' },
+        ],
+        source: `${MARKETPLACE}:34-60`,
+        provenBy: 'trustbase-seller-backend/routes/chain-writes-products.js:222-235',
+    },
+    {
+        typeUrl: '/trustchain.marketplace.v1.MsgAddStock',
+        protoMessage: 'trustchain.marketplace.v1.MsgAddStock',
+        signer: 'seller',
+        aminoName: 'trustchain/x/marketplace/MsgAddStock',
+        summary: '补库存（按 slot_index，不是 sku_id）',
+        fields: [
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'slot_index', kind: 'uint64', required: true, note: '来自 MsgListSKUResponse.slot_index 或查询接口' },
+            { name: 'quantity', kind: 'uint64', required: true },
+        ],
+        source: `${MARKETPLACE}:89-95`,
+        provenBy: 'trustbase-seller-backend/routes/chain-writes-products.js:247-255',
+    },
+    {
+        typeUrl: '/trustchain.marketplace.v1.MsgReduceStock',
+        protoMessage: 'trustchain.marketplace.v1.MsgReduceStock',
+        signer: 'seller',
+        aminoName: 'trustchain/x/marketplace/MsgReduceStock',
+        summary: '减库存',
+        fields: [
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'slot_index', kind: 'uint64', required: true },
+            { name: 'quantity', kind: 'uint64', required: true },
+        ],
+        source: `${MARKETPLACE}:98-104`,
+        provenBy: 'trustbase-seller-backend/routes/chain-writes-products.js:330-338',
+    },
+    {
+        typeUrl: '/trustchain.marketplace.v1.MsgUpdateSKU',
+        protoMessage: 'trustchain.marketplace.v1.MsgUpdateSKU',
+        signer: 'seller',
+        aminoName: 'trustchain/x/marketplace/MsgUpdateSKU',
+        summary: '改单件质押（只此一个可变字段）',
+        fields: [
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'slot_index', kind: 'uint64', required: true },
+            { name: 'stake_per_unit', kind: 'string', required: true, note: 'microTCT 串' },
+        ],
+        source: `${MARKETPLACE}:107-113`,
+    },
+    {
+        typeUrl: '/trustchain.marketplace.v1.MsgPauseSKU',
+        protoMessage: 'trustchain.marketplace.v1.MsgPauseSKU',
+        signer: 'seller',
+        aminoName: 'trustchain/x/marketplace/MsgPauseSKU',
+        summary: '暂停售卖（可恢复）',
+        fields: [
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'slot_index', kind: 'uint64', required: true },
+        ],
+        source: `${MARKETPLACE}:65-70`,
+    },
+    {
+        typeUrl: '/trustchain.marketplace.v1.MsgResumeSKU',
+        protoMessage: 'trustchain.marketplace.v1.MsgResumeSKU',
+        signer: 'seller',
+        aminoName: 'trustchain/x/marketplace/MsgResumeSKU',
+        summary: '恢复售卖',
+        fields: [
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'slot_index', kind: 'uint64', required: true },
+        ],
+        source: `${MARKETPLACE}:73-78`,
+    },
+    {
+        typeUrl: '/trustchain.marketplace.v1.MsgDelistSKU',
+        protoMessage: 'trustchain.marketplace.v1.MsgDelistSKU',
+        signer: 'seller',
+        aminoName: 'trustchain/x/marketplace/MsgDelistSKU',
+        summary: '下架（终态）',
+        fields: [
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'slot_index', kind: 'uint64', required: true },
+        ],
+        source: `${MARKETPLACE}:81-86`,
+    },
+    {
+        typeUrl: '/trustchain.marketplace.v1.MsgConfiscateStake',
+        protoMessage: 'trustchain.marketplace.v1.MsgConfiscateStake',
+        signer: 'authority',
+        aminoName: 'trustchain/x/marketplace/MsgConfiscateStake',
+        summary: 'WASH 判定后全额没收卖家质押（→ x/subchain 池）；同时 slot 置 DELISTED',
+        fields: [
+            { name: 'authority', kind: 'string', required: true, note: 'gov 或 emergencyAuthority' },
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'sku_id', kind: 'string', required: true },
+            { name: 'reason', kind: 'string', required: true },
+        ],
+        // ⚠️ proto 里有 message，但 `service Msg` 没有对应 rpc（生成的 MsgServer 接口也没有该方法），
+        // 而 keeper 已实现 handler（x/marketplace/keeper/confiscate.go:81）—— 即**发不出去**，
+        // 只能模块内部调用。详见 packages/protocol/README.md §9 第 4 条。
+        source: `${MARKETPLACE}:119-126`,
+    },
+    // -------------------------------------------------------------------------
+    // x/verification —— 实名 / 资质提交与审批
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.verification.v1.MsgSubmitVerification',
+        protoMessage: 'trustchain.verification.v1.MsgSubmitVerification',
+        signer: 'owner',
+        aminoName: 'trustchain/x/verification/MsgSubmitVerification',
+        summary: '提交实名/资质核验申请',
+        fields: [
+            { name: 'owner', kind: 'string', required: true, note: '被核验主体地址' },
+            { name: 'entity_type', kind: 'string', required: true, note: '"identity" | "brand" | "device" | "shop" | "product"' },
+            { name: 'entity_id', kind: 'string', required: true, note: '实名场景 = owner 地址本身' },
+            { name: 'credential_hash', kind: 'string', required: true, note: '材料 SHA-256（本仓库实现用 hex）' },
+            { name: 'method', kind: 'string', required: true, note: '"governance" | "kyc" | "oracle" | "manual"' },
+            { name: 'metadata', kind: 'string', required: false, note: 'JSON 字符串' },
+            { name: 'kyc_provider', kind: 'string', required: false, note: 'method="kyc" 时填' },
+        ],
+        source: `${VERIFICATION}:50-73`,
+        provenBy: 'trustbase-seller-backend/routes/onboard.js:167-176',
+    },
+    {
+        typeUrl: '/trustchain.verification.v1.MsgApproveVerification',
+        protoMessage: 'trustchain.verification.v1.MsgApproveVerification',
+        signer: 'approver',
+        aminoName: 'trustchain/x/verification/MsgApproveVerification',
+        summary: '审批通过（authority / oracle / kyc 方）',
+        fields: [
+            { name: 'approver', kind: 'string', required: true, note: '必须落在允许审批人集合内（params/oracle），否则链上拒' },
+            { name: 'verification_id', kind: 'string', required: true, note: 'keeper 规则：`ENTITY_TYPE_IDENTITY-<address>` 形式（onboard.js:166 生成同款 id）' },
+            { name: 'expires_at', kind: 'int64', required: false, note: '0 = 用默认有效期' },
+        ],
+        source: `${VERIFICATION}:80-89`,
+        // 审批方（oracle / 服务商侧）的实现不在 seller-backend 里，故无 provenBy。
+        // seller-backend 只发提交（MsgSubmitVerification），对"已通过"只做幂等识别
+        // （routes/onboard.js:187 匹配 already approved 视为成功）。
+    },
+    {
+        typeUrl: '/trustchain.verification.v1.MsgRejectVerification',
+        protoMessage: 'trustchain.verification.v1.MsgRejectVerification',
+        signer: 'rejector',
+        aminoName: 'trustchain/x/verification/MsgRejectVerification',
+        summary: '审批驳回',
+        fields: [
+            { name: 'rejector', kind: 'string', required: true },
+            { name: 'verification_id', kind: 'string', required: true },
+            { name: 'reason', kind: 'string', required: true },
+        ],
+        source: `${VERIFICATION}:94-101`,
+    },
+    {
+        typeUrl: '/trustchain.verification.v1.MsgRevokeVerification',
+        protoMessage: 'trustchain.verification.v1.MsgRevokeVerification',
+        signer: 'revoker',
+        aminoName: 'trustchain/x/verification/MsgRevokeVerification',
+        summary: '撤销已通过的核验',
+        fields: [
+            { name: 'revoker', kind: 'string', required: true },
+            { name: 'verification_id', kind: 'string', required: true },
+            { name: 'reason', kind: 'string', required: true },
+        ],
+        source: `${VERIFICATION}:106-113`,
+    },
+    {
+        typeUrl: '/trustchain.verification.v1.MsgVerifyByGovernance',
+        protoMessage: 'trustchain.verification.v1.MsgVerifyByGovernance',
+        signer: 'authority',
+        aminoName: 'trustchain/x/verification/MsgVerifyByGovernance',
+        summary: '治理提案方式通过核验（authority only）',
+        fields: [
+            { name: 'authority', kind: 'string', required: true },
+            { name: 'verification_id', kind: 'string', required: true },
+        ],
+        source: `${VERIFICATION}:118-124`,
+    },
+    // -------------------------------------------------------------------------
+    // x/serviceprovider —— 服务商注册 / 支付事实 / 贡献奖励
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.serviceprovider.v1.MsgRegisterServiceProvider',
+        protoMessage: 'trustchain.serviceprovider.v1.MsgRegisterServiceProvider',
+        signer: 'provider',
+        summary: '服务商注册（含质押；微信服务商商户号唯一）',
+        fields: [
+            { name: 'provider', kind: 'string', required: true, note: '服务商链上地址；签名者必须等于它' },
+            { name: 'name', kind: 'string', required: true },
+            { name: 'wechat_mchid', kind: 'string', required: true, note: '微信服务商商户号，链上唯一' },
+            { name: 'stake', kind: 'string', required: true, note: '质押 utct 串，必须 > 0' },
+        ],
+        source: `${SERVICEPROVIDER}:34-40`,
+        provenBy: 'trustbase-seller-backend/routes/agent-serviceprovider.js:107-112',
+    },
+    {
+        typeUrl: '/trustchain.serviceprovider.v1.MsgSubmitPaymentFact',
+        protoMessage: 'trustchain.serviceprovider.v1.MsgSubmitPaymentFact',
+        signer: 'provider',
+        summary: '提交支付事实（仅已注册 ACTIVE 服务商）',
+        fields: [
+            { name: 'provider', kind: 'string', required: true },
+            { name: 'order_ref', kind: 'string', required: true },
+            { name: 'psp_txn_id', kind: 'string', required: true, note: '微信支付交易号' },
+            { name: 'amount', kind: 'string', required: true, note: 'utct 串' },
+            { name: 'evidence_hash', kind: 'string', required: true, note: '回调数据 sha256（本仓库实现用 hex lowercase）' },
+        ],
+        source: `${SERVICEPROVIDER}:47-54`,
+        provenBy: 'trustbase-seller-backend/routes/agent-serviceprovider.js:162-168',
+    },
+    {
+        typeUrl: '/trustchain.serviceprovider.v1.MsgConfirmPaymentFact',
+        protoMessage: 'trustchain.serviceprovider.v1.MsgConfirmPaymentFact',
+        signer: 'authority',
+        summary: 'C5 确认支付事实（authority 或 params.confirmers 白名单）→ 贡献分 +1',
+        fields: [
+            { name: 'authority', kind: 'string', required: true, note: '= 模块 authority 或确认人白名单成员' },
+            { name: 'provider', kind: 'string', required: true },
+            { name: 'order_ref', kind: 'string', required: true },
+        ],
+        source: `${SERVICEPROVIDER}:96-101`,
+    },
+    {
+        typeUrl: '/trustchain.serviceprovider.v1.MsgClaimProviderReward',
+        protoMessage: 'trustchain.serviceprovider.v1.MsgClaimProviderReward',
+        signer: 'provider',
+        summary: '服务商领取累计贡献奖励',
+        fields: [{ name: 'provider', kind: 'string', required: true }],
+        source: `${SERVICEPROVIDER}:86-89`,
+    },
+    // -------------------------------------------------------------------------
+    // x/insurance —— 理赔申请（D3 修复：索赔绑定订单 + 赔付对象固定）
+    //
+    // ⚠️ 覆盖范围：本注册表**只收录 x/insurance 的 MsgSubmitClaim**（D3 修复点）。
+    //    同模块其余 9 条消息（MsgRequestInsurance / MsgConfirmInsurance /
+    //    MsgCancelInsuranceApplication / MsgResolveClaim / MsgDepositInsuranceStake /
+    //    MsgWithdrawInsuranceStake / MsgDeclareSKU / MsgRevokeInsurance /
+    //    MsgUpdateParams）尚未收录 —— 需要时再补，别当它们"不存在"。
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.insurance.v1.MsgSubmitClaim',
+        protoMessage: 'trustchain.insurance.v1.MsgSubmitClaim',
+        signer: 'claimant',
+        aminoName: 'trustchain/x/insurance/MsgSubmitClaim',
+        // 2026-09-23 D3 修复 —— `order_id` 由"没有"变成**必填**（必须 > 0）。链上用它做三件事：
+        //  ① 证明索赔人是本单利益相关方（订单买家 **或** 保单投保人）；
+        //  ② 证明本单确实在保（order.is_insured + 卖家/SKU 与保单一致）；
+        //  ③ 固定**赔付对象** = 订单买家（`Claim.beneficiary`，insurance/v1/query.proto:34），
+        //     而不是"谁提交就打给谁"。
+        // ⚠️ 老客户端（不带 order_id）现在必被链上拒 —— 这是**破坏性**行为变更，不是兼容新增。
+        // ⚠️ Claim 是**查询侧状态类型**（在 insurance/v1/query.proto 里，不在 tx.proto），
+        //    本注册表只收 Msg* 交易消息，故未登记 Claim 本身 —— 见 README §9。
+        summary: '理赔申请（签名者 = claimant；D3 起必须绑定 order_id）',
+        fields: [
+            { name: 'claimant', kind: 'string', required: true, note: '**签名者**；必须与本单利益相关（订单买家或保单投保人）' },
+            { name: 'application_id', kind: 'string', required: true, note: '保单申请 id' },
+            { name: 'claim_reason', kind: 'string', required: true, note: '理赔原因' },
+            { name: 'evidence_hash', kind: 'string', required: true, note: '证据文件哈希' },
+            { name: 'claim_amount', kind: 'string', required: true, note: '理赔金额（microTCT 纯数字串）' },
+            { name: 'order_id', kind: 'uint64', required: true, note: '**D3 新增必填**（> 0）；绑定订单，并决定赔付对象 = 订单买家' },
+        ],
+        source: `${INSURANCE}:77-90`,
+    },
+    // -------------------------------------------------------------------------
+    // x/reward —— 奖励池划转
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.reward.v1.MsgRewardPoolTransfer',
+        protoMessage: 'trustchain.reward.v1.MsgRewardPoolTransfer',
+        signer: 'authority',
+        aminoName: 'trustchain/x/reward/MsgRewardPoolTransfer',
+        summary: '奖励池定向划转（authority/emergency 双轨；池间调拨，如奖励池 → 引导金池）',
+        fields: [
+            { name: 'authority', kind: 'string', required: true, note: 'gov 模块地址或应急密钥' },
+            { name: 'recipient', kind: 'string', required: true, note: '普通账户或目标模块账户' },
+            { name: 'amount', kind: 'string', required: true, note: 'utct 串' },
+        ],
+        source: `${REWARD}:24-36`,
+    },
+    // -------------------------------------------------------------------------
+    // x/endpoint —— 端点指针轮换 + 见证投票（P2P 端点发现的地基）
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.endpoint.v1.MsgUpdateEndpointPointer',
+        protoMessage: 'trustchain.endpoint.v1.MsgUpdateEndpointPointer',
+        signer: 'seller',
+        aminoName: 'trustchain/x/endpoint/MsgUpdateEndpointPointer',
+        summary: '卖家轮换端点指针（端点内容不上链，只上 bundle_hash）；副作用：旧见证全部标记过期',
+        fields: [
+            { name: 'seller', kind: 'string', required: true, note: '必须等于签名者' },
+            { name: 'pointer_version', kind: 'uint64', required: true, note: '**严格递增**；回退/重放被拒' },
+            { name: 'bundle_hash', kind: 'bytes', required: true, note: '32 字节 sha256；hex 先转字节再编码（base64 是 wire 形态）' },
+            { name: 'ttl_blocks', kind: 'uint64', required: true, note: '∈ (0, params.max_pointer_ttl_blocks]，默认上限 8640 ≈ 12h @5s' },
+            { name: 'region_hint', kind: 'string', required: false, note: '粗粒度地域（如 "cn-js"），默认 ≤16 字节' },
+        ],
+        source: `${ENDPOINT}:27-45`,
+    },
+    {
+        typeUrl: '/trustchain.endpoint.v1.MsgAttestEndpoint',
+        protoMessage: 'trustchain.endpoint.v1.MsgAttestEndpoint',
+        signer: 'witness',
+        aminoName: 'trustchain/x/endpoint/MsgAttestEndpoint',
+        summary: '任一账户对当前端点包投见证票（第三方背书，与卖家自述分开计权）',
+        fields: [
+            { name: 'witness', kind: 'string', required: true, note: '**不允许等于 seller**（自投票被拒：ErrSelfAttestation）' },
+            { name: 'seller', kind: 'string', required: true },
+            { name: 'bundle_hash', kind: 'bytes', required: true, note: '32 字节；**必须等于当前指针的哈希**，给旧/伪造包背书一律拒' },
+            { name: 'ok', kind: 'bool', required: true, note: 'false = 负票（判 UNUSABLE 的唯一依据）' },
+            { name: 'latency_ms', kind: 'uint64', required: true, note: `≤ ${3_600_000}（MaxLatencyMs，编译期常量，x/endpoint/types/keys.go:44）` },
+        ],
+        source: `${ENDPOINT}:59-77`,
+    },
+    // -------------------------------------------------------------------------
+    // x/subchain —— 引导金（入驻流程依赖）
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.subchain.v1.MsgFundBootstrap',
+        protoMessage: 'trustchain.subchain.v1.MsgFundBootstrap',
+        signer: 'authority',
+        aminoName: 'trustchain/subchain/MsgFundBootstrap',
+        summary: '引导金池注资（authority → subchain 模块账户）',
+        fields: [
+            { name: 'authority', kind: 'string', required: true },
+            { name: 'amount', kind: 'string', required: true, note: 'utct 串' },
+        ],
+        source: `${SUBCHAIN}:135-141`,
+        provenBy: 'trustbase-seller-backend/core/chain-signer.js:43（CUSTOM_TYPE_URLS）',
+    },
+    {
+        typeUrl: '/trustchain.subchain.v1.MsgDisburseBootstrap',
+        protoMessage: 'trustchain.subchain.v1.MsgDisburseBootstrap',
+        signer: 'authority',
+        aminoName: 'trustchain/subchain/MsgDisburseBootstrap',
+        summary: '引导金发放（subchain 模块账户 → 卖家）；按 credential_hash 幂等',
+        fields: [
+            { name: 'authority', kind: 'string', required: true },
+            { name: 'recipient', kind: 'string', required: true, note: '卖家地址' },
+            { name: 'credential_hash', kind: 'string', required: true, note: 'sha256(merchant_id)；一商户一次（防女巫）' },
+        ],
+        source: `${SUBCHAIN}:147-154`,
+        provenBy: 'trustbase-seller-backend/core/chain-signer.js:42（CUSTOM_TYPE_URLS）',
+    },
+    // -------------------------------------------------------------------------
+    // x/economy —— 积分（非链上币）
+    // -------------------------------------------------------------------------
+    {
+        typeUrl: '/trustchain.economy.v1.MsgGrantCredits',
+        protoMessage: 'trustchain.economy.v1.MsgGrantCredits',
+        signer: 'issuer',
+        summary: '发放积分（issuer 必须 = economy authority）',
+        fields: [
+            { name: 'issuer', kind: 'string', required: true, note: '必须等于 economy authority' },
+            { name: 'recipient', kind: 'string', required: true },
+            { name: 'amount', kind: 'string', required: true, note: '积分数（整数串，如 "20"）' },
+            { name: 'reason_kind', kind: 'string', required: true, note: '∈ {bind, first_order, ten_orders, confirm, referral}' },
+            { name: 'ref_id', kind: 'string', required: true, note: '幂等引用（order id / binding id）' },
+        ],
+        source: `${ECONOMY}:47-64`,
+        provenBy: 'trustbase-seller-backend/core/chain-signer.js:46（CUSTOM_TYPE_URLS 末条）',
+    },
+];
+/** 全部 type URL（保持注册顺序） */
+exports.MSG_TYPE_URLS = exports.MSG_TYPES.map((spec) => spec.typeUrl);
+const BY_TYPE_URL = new Map(exports.MSG_TYPES.map((spec) => [spec.typeUrl, spec]));
+/** 按 type URL 取注册项；未注册返回 undefined（调用方应把它翻成"模块未上线/拼错"提示） */
+function getMsgType(typeUrl) {
+    return BY_TYPE_URL.get(typeUrl);
+}
+function isKnownMsgType(typeUrl) {
+    return typeof typeUrl === 'string' && BY_TYPE_URL.has(typeUrl);
+}
+/** 按 proto message 全名反查（`trustchain.order.v1.MsgCreateOrder`） */
+function getMsgTypeByProtoMessage(protoMessage) {
+    return exports.MSG_TYPES.find((spec) => spec.protoMessage === protoMessage);
+}
+//# sourceMappingURL=registry.js.map