trustbase-seller-backend 0.1.5

package/event-listener.js

@@ -0,0 +1,321 @@
+"use strict";
+/**
+ * Indexer Event Listener v0.2 — 事件白名单过滤 + 路由 (baobei #16143 实战)
+ *
+ * 原则 (Lesson #335):
+ * 1. 链上 emit → listener 收到事件
+ * 2. listener 查白名单 (event-whitelist.ts)
+ * 3. 不在白名单 = 丢弃 (Lesson #335 强制)
+ * 4. 在白名单 → 路由到对应 sqlite handler
+ *
+ * 三处一致铁律: 链上 emit + 索引器白名单 + sqlite handler
+ * 缺一不可 (任何 v0.4+ 新模块启用必走)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVENT_WHITELIST_V3_1 = exports.EventListener = void 0;
+const event_whitelist_1 = require("./event-whitelist");
+class EventListener {
+    stats = {
+        totalReceived: 0,
+        totalWhitelisted: 0,
+        totalDropped: 0,
+        bySource: {},
+        byPriority: {},
+    };
+    options = {};
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * 主入口: 收到 ChainEvent → 查白名单 → 路由
+     */
+    async handleEvent(event) {
+        this.stats.totalReceived++;
+        const eventType = this.extractEventType(event);
+        if (!eventType) {
+            this.recordDropped('unknown', 'no eventType');
+            if (this.options.debug)
+                console.warn('[EventListener] No eventType:', event);
+            return;
+        }
+        // 白名单过滤 (Lesson #335)
+        if (!(0, event_whitelist_1.isWhitelisted)(eventType)) {
+            this.recordDropped('unknown', `not in whitelist: ${eventType}`);
+            if (this.options.debug)
+                console.warn(`[EventListener] Dropped (not in whitelist): ${eventType}`);
+            return;
+        }
+        const whitelisted = (0, event_whitelist_1.findWhitelistedEvent)(eventType);
+        if (!whitelisted)
+            return;
+        this.stats.totalWhitelisted++;
+        this.stats.byPriority[whitelisted.priority] = (this.stats.byPriority[whitelisted.priority] || 0) + 1;
+        if (!this.stats.bySource[whitelisted.source]) {
+            this.stats.bySource[whitelisted.source] = { whitelisted: 0, dropped: 0 };
+        }
+        this.stats.bySource[whitelisted.source].whitelisted++;
+        // 路由到对应 handler
+        await this.routeToHandler(event, whitelisted);
+        // baobei #16315 W3 实战锁版: webhook 推送 (5 订单事件)
+        // 事件发出后, 推送到 webhook URL (店小秘 / 第三方 ERP)
+        await this.pushWebhook(event, whitelisted);
+    }
+    /**
+     * 提取事件类型 — 兼容两种格式
+     */
+    extractEventType(event) {
+        // 新格式 (chain emit): event.type = 'relationship_follow' 等
+        const direct = event.type;
+        if (typeof direct === 'string' && direct.length > 0)
+            return direct;
+        // 旧格式: event.attributes[0].key='action', value='follow'
+        const attrs = event.attributes;
+        if (Array.isArray(attrs)) {
+            for (const a of attrs) {
+                if (a.key === 'action' || a.key === 'eventType')
+                    return a.value;
+            }
+        }
+        return null;
+    }
+    /**
+     * 路由到对应 handler
+     */
+    async routeToHandler(event, whitelisted) {
+        const handler = this.getHandler(whitelisted.source);
+        if (!handler) {
+            console.warn(`[EventListener] No handler for source: ${whitelisted.source} (event: ${whitelisted.eventType})`);
+            return;
+        }
+        try {
+            await handler(event);
+            if (this.options.debug)
+                console.log(`[EventListener] ✅ Routed ${whitelisted.eventType} → ${whitelisted.source}`);
+        }
+        catch (err) {
+            console.error(`[EventListener] ❌ Handler error for ${whitelisted.eventType}:`, err);
+            throw err;
+        }
+    }
+    getHandler(source) {
+        switch (source) {
+            case 'x/order':
+                return this.options.orderHandler;
+            case 'x/riskcontrol':
+                return this.options.riskcontrolHandler;
+            case 'x/relationship':
+                return this.options.relationshipHandler;
+            case 'x/insurance':
+                return this.options.insuranceHandler;
+            case 'x/gov':
+                return this.options.governanceHandler;
+            case 'x/crosschain':
+                return this.options.crosschainHandler;
+            case 'x/subchain':
+                return this.options.subchainHandler;
+            case 'x/marketplace':
+                return this.options.marketplaceHandler;
+            default:
+                return null;
+        }
+    }
+    recordDropped(source, _reason) {
+        this.stats.totalDropped++;
+        if (!this.stats.bySource[source]) {
+            this.stats.bySource[source] = { whitelisted: 0, dropped: 0 };
+        }
+        this.stats.bySource[source].dropped++;
+    }
+    /**
+     * 暴露统计 — 索引器监控用
+     */
+    getStats() {
+        return this.stats;
+    }
+    /**
+     * 重置统计
+     */
+    resetStats() {
+        this.stats = {
+            totalReceived: 0,
+            totalWhitelisted: 0,
+            totalDropped: 0,
+            bySource: {},
+            byPriority: {},
+        };
+    }
+    /**
+     * baobei #16315 W3 实战锁版: webhook 推送 (Lesson #335 三处一致实战风格)
+     *
+     * 触发场景: 事件发出后, 推到 webhook URL (店小秘 / 第三方 ERP / Shopify / 自建)
+     * 5 订单事件实战锁版:
+     *   - payment_confirmed (链上 PENDING → PAID, 库存占用)
+     *   - ship_order (链上 PAID → SHIPPED, 物流推送)
+     *   - confirm_order (链上 SHIPPED → CONFIRMED, 释放 escrow)
+     *   - order_settled (链上 CONFIRMED → SETTLED, dispute_window 过后 crank)
+     *   - cancel_order (链上 PENDING/PAID → CANCELLED, 退款)
+     *
+     * 设计原则:
+     *   - Webhook URL 从 options.webhookUrls 读 (事件类型 → URL)
+     *   - POST body = WooCommerce 兼容 (跟 baobei 9ccbf60 wc-v3.ts spec 一致)
+     *   - HMAC-SHA256 签名 (跟 WooCommerce REST API 同款)
+     *   - 失败重试 3 次 (指数 backoff)
+     */
+    async pushWebhook(event, whitelisted) {
+        const webhookUrls = this.options.webhookUrls;
+        if (!webhookUrls)
+            return; // 没配 webhook URL = 跳过 (Lesson #335 三处一致不强求)
+        const url = webhookUrls[whitelisted.eventType];
+        if (!url)
+            return; // 该事件没配 webhook = 跳过
+        // 提取链上事件 attribute (Record<string, string>)
+        const attrs = event.attributes || {};
+        const eventType = whitelisted.eventType;
+        // WooCommerce 兼容 payload (跟 baobei 9ccbf60 wc-v3.ts 一致)
+        const payload = this.buildWebhookPayload(eventType, event, attrs);
+        // HMAC-SHA256 签名 (跟 WooCommerce REST API 同款)
+        // 2026-09-07 kimi: ts-jest CJS interop 下 await import('crypto') 可能包在 .default 里
+        const cryptoMod = await Promise.resolve().then(() => __importStar(require('crypto')));
+        const createHmac = cryptoMod.createHmac ?? cryptoMod.default?.createHmac;
+        const consumerSecret = process.env.WC_CONSUMER_SECRET || 'wc-default-secret';
+        const baseString = `${eventType}&${encodeURIComponent(url)}&${encodeURIComponent(JSON.stringify(payload))}`;
+        const signature = createHmac('sha256', consumerSecret).update(baseString).digest('base64');
+        // POST + 重试 3 次 (指数 backoff)
+        const maxRetries = 3;
+        let lastError = null;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-WC-Webhook-Signature': signature,
+                        'X-WC-Webhook-Event': eventType,
+                        'X-WC-Webhook-Source': whitelisted.source,
+                        'X-WC-Webhook-Delivery': `${event.height || 0}-${event.txHash || ''}`,
+                    },
+                    body: JSON.stringify(payload),
+                });
+                if (response.ok) {
+                    if (this.options.debug) {
+                        console.log(`[Webhook] ✅ Pushed ${eventType} → ${url} (attempt ${attempt})`);
+                    }
+                    return;
+                }
+                throw new Error(`HTTP ${response.status}`);
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt < maxRetries) {
+                    // 指数 backoff: 1s / 2s / 4s
+                    await new Promise((r) => setTimeout(r, Math.pow(2, attempt - 1) * 1000));
+                }
+            }
+        }
+        console.warn(`[Webhook] ❌ Push ${eventType} → ${url} failed after ${maxRetries} attempts:`, lastError?.message);
+    }
+    /**
+     * WooCommerce 兼容 webhook payload 构造器
+     * 跟 baobei 9ccbf60 wc-v3.ts spec 一致 (订单事件格式)
+     */
+    buildWebhookPayload(eventType, event, attrs) {
+        // 链上 → WC 字段映射 (跟 wc-v3.ts meta_data 实战锁版一致)
+        const basePayload = {
+            event_type: eventType,
+            source: event.type,
+            height: Number(event.height) || 0,
+            tx_hash: event.txHash || '',
+            timestamp: new Date().toISOString(),
+        };
+        // 订单事件 payload (跟 wc-v3.ts wc-tracker/v1 同款)
+        if (eventType === 'payment_confirmed') {
+            return {
+                ...basePayload,
+                order_id: attrs.order_id || '',
+                authority: attrs.authority || '',
+                psp_payment_id: attrs.psp_payment_id || '',
+                new_status: 'processing',
+            };
+        }
+        if (eventType === 'ship_order') {
+            return {
+                ...basePayload,
+                order_id: attrs.order_id || '',
+                seller: attrs.seller || '',
+                tracking_info: attrs.tracking_info || '',
+            };
+        }
+        if (eventType === 'confirm_order') {
+            return {
+                ...basePayload,
+                order_id: attrs.order_id || '',
+                buyer: attrs.buyer || '',
+                seller: attrs.seller || '',
+                total_paid: attrs.total_paid || '0',
+                escrow_released: attrs.escrow_released || '0',
+            };
+        }
+        if (eventType === 'order_settled') {
+            return {
+                ...basePayload,
+                order_id: attrs.order_id || '',
+                seller: attrs.seller || '',
+                caller: attrs.caller || '',
+                settled: true,
+            };
+        }
+        if (eventType === 'cancel_order') {
+            return {
+                ...basePayload,
+                order_id: attrs.order_id || '',
+                canceller: attrs.canceller || '',
+                refund_amount: attrs.refund_amount || '0',
+            };
+        }
+        // 其他事件通用 payload
+        return {
+            ...basePayload,
+            attributes: attrs,
+        };
+    }
+}
+exports.EventListener = EventListener;
+/**
+ * 默认白名单 (从 event-whitelist.ts re-export)
+ */
+var event_whitelist_2 = require("./event-whitelist");
+Object.defineProperty(exports, "EVENT_WHITELIST_V3_1", { enumerable: true, get: function () { return event_whitelist_2.EVENT_WHITELIST_V3_1; } });
+//# sourceMappingURL=event-listener.js.map

package/event-listener.js.map

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

package/event-whitelist.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Indexer 事件白名单 v0.3 — Lesson #335 铁律落地
+ *
+ * 原则: 链上 emit + indexer 白名单 + sqlite handler 三处一致, 缺一不可.
+ * 不在白名单的事件 = 丢弃 (Lesson #335 强制).
+ *
+ * v0.5 = v0.4 (36) + kimi 9/7 x/marketplace SKU 家族 6 事件 (baei #17439 #5 派单) = 42 事件
+ * v0.4 = v0.3 (35, 测试实测数) + kimi #276 x/subchain subchain_params_updated (v3.2 MsgUpdateParams) = 36 事件
+ * v0.3 = v0.2 + baobei #16591 x/crosschain 4 事件 (matrix v3, dd6cc3a 实战; 实测总数 35, 头部旧注释 22 是过时的)
+ * v0.2 = v0.1 (14) + kimi #16142 x/relationship 4 事件 = 18 事件
+ *
+ * 来源: plans/indexer-event-whitelist-v0.1.md (baobei #16100 起草, baobei #16143 v0.2 锁版, baobei #16591 v0.3 锁版)
+ */
+export type EventPriority = 'critical' | 'high' | 'medium' | 'low';
+export interface EventAction {
+    type: 'insert' | 'soft_delete' | 'update_count';
+    table?: string;
+}
+export interface WhitelistedEvent {
+    eventType: string;
+    source: string;
+    priority: EventPriority;
+    sqliteTable?: string;
+    attributes?: string[];
+    action?: EventAction['type'];
+    description?: string;
+}
+/**
+ * v3.1 + x/relationship FactHash 重做 + x/crosschain matrix v3 — 22 事件白名单
+ */
+export declare const EVENT_WHITELIST_V3_1: WhitelistedEvent[];
+/**
+ * 由 eventType 查白名单条目
+ */
+export declare function findWhitelistedEvent(eventType: string): WhitelistedEvent | undefined;
+/**
+ * 按 source 查所有事件 (用于批量加载)
+ */
+export declare function findEventsBySource(source: string): WhitelistedEvent[];
+/**
+ * 检查事件是否在白名单
+ */
+export declare function isWhitelisted(eventType: string): boolean;
+/**
+ * v0.2 升级: +4 x/relationship 事件 (kimi #16142 commit 851af12)
+ * Lesson #NEW 锁版: 任何 v0.4+ 新模块启用 = 必加白名单 + sqlite handler + 链上 emit 三处齐备
+ */
+export declare const WHITELIST_V0_2_ADDITIONS: readonly ["relationship_follow", "relationship_unfollow", "relationship_block", "relationship_unblock"];
+/**
+ * v0.3 升级: +4 x/crosschain 事件 (matrix v3, kimi 链端 dd6cc3a PASS)
+ * Lesson #335 实战: 任何 v0.4+ 新模块启用 = 必加白名单 + sqlite handler + 链上 emit 三处齐备
+ */
+export declare const WHITELIST_V0_3_ADDITIONS: readonly ["crosschain_ibc_transfer", "crosschain_query", "crosschain_multisig_execute", "crosschain_stake"];
+/** v0.4 新增 (kimi #276, 8/25): x/subchain 参数治理事件 */
+export declare const WHITELIST_V0_4_ADDITIONS: readonly ["subchain_params_updated"];
+/** v0.5 新增 (kimi 9/7, baei #17439 #5): x/marketplace SKU 上架家族 6 事件 */
+export declare const WHITELIST_V0_5_ADDITIONS: readonly ["list_sku", "pause_sku", "resume_sku", "delist_sku", "add_stock", "reduce_stock"];
+/**
+ * 统计
+ */
+export declare const WHITELIST_STATS: {
+    totalEvents: number;
+    byPriority: {
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+    };
+    bySource: {
+        'x/order': number;
+        'x/riskcontrol': number;
+        'x/relationship': number;
+        'x/gov': number;
+        'x/crosschain': number;
+        'x/subchain': number;
+        'x/marketplace': number;
+    };
+};
+//# sourceMappingURL=event-whitelist.d.ts.map

package/event-whitelist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-whitelist.d.ts","sourceRoot":"","sources":["../src/event-whitelist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,cAAc,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EA2blD,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEpF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAErE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,yGAK3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB,6GAK3B,CAAC;AAEX,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,sCAE3B,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,6FAO3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CAiB3B,CAAC"}