trustbase-seller-backend 0.1.5

package/core/chain-listener.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Chain Event Listener
+ *
+ * 监听TrustChain链上事件，同步到索引器
+ * "写上链，读走索引器" — 核心数据流
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainListener = void 0;
+const events_1 = require("events");
+const event_whitelist_1 = require("../event-whitelist");
+class ChainListener extends events_1.EventEmitter {
+    rpcUrl;
+    chainId;
+    indexer;
+    pollIntervalMs;
+    batchSize;
+    running = false;
+    timer;
+    currentHeight = 0;
+    rebuilding = false;
+    constructor(options) {
+        super();
+        this.rpcUrl = options.rpcUrl;
+        this.chainId = options.chainId;
+        this.indexer = options.indexer;
+        this.pollIntervalMs = options.pollIntervalMs || 2000;
+        this.batchSize = options.batchSize || 50;
+    }
+    async start() {
+        // Crash recovery: try to open DB / get sync height
+        try {
+            this.currentHeight = this.indexer.getSyncHeight();
+        }
+        catch (e) {
+            console.error(`[ChainListener] DB open failed, triggering rebuild: ${e.message}`);
+            this.emit('rebuild-required', `DB open failed: ${e.message}`);
+            // Attempt to recover by resetting height to 0 (full rebuild)
+            this.currentHeight = 0;
+        }
+        // If no sync height, start from the chain's EARLIEST AVAILABLE block.
+        // (轻节点实测 .128 2026-08-01: 全节点的早期块已被剪枝——trustchain-1 块库
+        // 基线 157521，从 1 开始只会无限 500。从 earliest-1 起步既覆盖全部可得
+        // 历史，也让 gap-rebuild 流程 (clearAll → 新 listener 从此进) 自洽。)
+        if (this.currentHeight === 0) {
+            try {
+                const status = await this.fetchJson('/status');
+                const earliest = Number(status.result.sync_info.earliest_block_height);
+                this.currentHeight = Number.isFinite(earliest) && earliest > 0 ? earliest - 1 : 0;
+            }
+            catch {
+                this.currentHeight = 0; // RPC 不可达时保持原行为
+            }
+            this.emit('info', `Starting full sync from block ${this.currentHeight + 1}`);
+        }
+        this.running = true;
+        this.poll();
+        this.timer = setInterval(() => this.poll(), this.pollIntervalMs);
+        this.emit('started');
+    }
+    stop() {
+        this.running = false;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        this.emit('stopped');
+    }
+    /** Mark/clear rebuilding state; while true, poll() won't fire another rebuild. */
+    setRebuilding(value) {
+        this.rebuilding = value;
+        if (value) {
+            console.log(`[ChainListener] Rebuilding flag set, currentHeight=${this.currentHeight}`);
+        }
+    }
+    /** Reset sync height after rebuild completes (typically 0 to start from block 1). */
+    resetToHeight(height) {
+        this.currentHeight = height;
+        console.log(`[ChainListener] currentHeight reset to ${height}`);
+    }
+    async poll() {
+        if (!this.running)
+            return;
+        try {
+            // Get latest height
+            const status = await this.fetchJson('/status');
+            const latestHeight = Number(status.result.sync_info.latest_block_height);
+            if (latestHeight <= this.currentHeight)
+                return;
+            // Crash recovery: if gap > 1000 blocks, trigger full rebuild (only once)
+            const gap = latestHeight - this.currentHeight;
+            if (gap > 1000 && !this.rebuilding) {
+                console.warn(`[ChainListener] Sync gap ${gap} blocks exceeds threshold. Triggering full rebuild.`);
+                this.rebuilding = true;
+                this.emit('rebuild-required', `Sync gap ${gap} > 1000 blocks`);
+                // Don't reset currentHeight here — let index.ts handle the rebuild flow.
+                return;
+            }
+            // Process batch
+            const endHeight = Math.min(this.currentHeight + this.batchSize, latestHeight);
+            for (let h = this.currentHeight + 1; h <= endHeight; h++) {
+                await this.processBlock(h);
+            }
+            this.currentHeight = endHeight;
+            this.emit('sync', this.currentHeight, latestHeight);
+            // Notify recovery complete if we just caught up after a rebuild
+            if (this.currentHeight === latestHeight) {
+                this.emit('recovery-complete');
+            }
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+    }
+    async processBlock(height) {
+        // Fetch block results for this height
+        const data = await this.fetchJson(`/block_results?height=${height}`);
+        const events = [];
+        // Extract events from transactions
+        const txResults = data.result?.txs_results || [];
+        for (const txResult of txResults) {
+            const txEvents = txResult.events || [];
+            for (const event of txEvents) {
+                const attrs = {};
+                for (const attr of event.attributes || []) {
+                    // Attributes may be base64 encoded in CometBFT
+                    try {
+                        const key = this.tryDecode(attr.key);
+                        const value = this.tryDecode(attr.value);
+                        attrs[key] = value;
+                    }
+                    catch {
+                        attrs[attr.key] = attr.value;
+                    }
+                }
+                // Filter for TrustCoin custom module events
+                if (this.isRelevantEvent(event.type)) {
+                    events.push({
+                        type: event.type,
+                        height,
+                        txHash: '', // Would need block data to get tx hash
+                        attributes: attrs,
+                        chainId: this.chainId,
+                    });
+                }
+                else {
+                    // Debug: log unmatched custom events
+                    if (!event.type.startsWith('coin_') && !event.type.startsWith('tx') && event.type !== 'message' && event.type !== 'transfer') {
+                        this.emit('info', `Unmatched event type: ${event.type} attrs=${JSON.stringify(attrs).substring(0, 200)}`);
+                    }
+                }
+            }
+        }
+        // Sync events to indexer
+        if (events.length > 0) {
+            await this.indexer.syncFromBlock(height, events);
+            this.emit('events', height, events.length);
+            this.emit('raw-events', height, events);
+        }
+        else {
+            // Still update sync height even if no events
+            await this.indexer.syncFromBlock(height, []);
+        }
+    }
+    isRelevantEvent(type) {
+        // TrustCoin custom module events (actual on-chain event names)
+        const relevantEvents = new Set([
+            // marketplace
+            'list_sku',
+            'pause_sku',
+            'resume_sku',
+            'delist_sku',
+            'add_stock',
+            'reduce_stock',
+            // order
+            'create_order',
+            'ship_order',
+            'confirm_order',
+            'dispute_order',
+            'cancel_order',
+            'resolve_dispute',
+            // reputation
+            'submit_review',
+            // trustcoin
+            'register_account',
+            'transfer_tct',
+            'verify_identity',
+            // brand
+            'register_brand',
+            'verify_brand',
+            // device
+            'register_device',
+            'unbind_device',
+            // recovery
+            'setup_recovery',
+            'initiate_recovery',
+            'approve_recovery',
+            // reward
+            'reward_distributed',
+            // insurance (v0.21.3, indexer④)
+            'insurance_application_expired',
+            'insurance_claim_paid',
+            'insurance_claim_payout_failed',
+            'insurance_stake_confiscated',
+            // council (v0.21.3, indexer④)
+            'insurer_impeached',
+            // grantrevoke (v0.21.3, indexer④)
+            'grant_revoked',
+            'grant_revoke_all',
+            // economy/flowback/lottery (2026-08-19 kimi: reserve 转账/回流路由/抽奖事件上索引)
+            'economy_reserve_transfer',
+            'economy_authority_set',
+            'economy_admin_set_via_dev_mode',
+            'flowback_end_block',
+            'lottery_draw',
+            'lottery_rollover',
+        ]);
+        if (relevantEvents.has(type))
+            return true;
+        // kimi 8/25 实战: 并上 Lesson #335 白名单 (event-whitelist.ts) — 本 Set 是旧硬编码,
+        // 白名单 v0.4 的 30 个事件 (payment_confirmed/order_settled/subchain_params_updated/
+        // crosschain_*/insurance_*/gov/relationship) 会在这里被静默丢弃, 三处一致断链实证
+        // (order 129 的 payment_confirmed 链上 emit 了但 order_events 无记录)。
+        // TODO(baobei): 两个清单应完全并轨, 本 Set 最终退役, 单一事实源 = event-whitelist.ts
+        return (0, event_whitelist_1.isWhitelisted)(type);
+    }
+    tryDecode(value) {
+        // Try base64 decode first
+        if (/^[A-Za-z0-9+/=]+$/.test(value) && value.length > 4) {
+            try {
+                const decoded = Buffer.from(value, 'base64').toString('utf-8');
+                // If decoded looks like readable text, use it
+                if (/^[\x20-\x7E\u4e00-\u9fff]+$/.test(decoded)) {
+                    return decoded;
+                }
+            }
+            catch { }
+        }
+        return value;
+    }
+    async fetchJson(path) {
+        const url = `${this.rpcUrl}${path}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`RPC ${path} returned ${response.status}`);
+        }
+        return response.json();
+    }
+    getCurrentHeight() {
+        return this.currentHeight;
+    }
+}
+exports.ChainListener = ChainListener;
+//# sourceMappingURL=chain-listener.js.map

package/core/chain-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-listener.js","sourceRoot":"","sources":["../../src/core/chain-listener.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,mCAAsC;AACtC,wDAAmD;AAgCnD,MAAa,aAAc,SAAQ,qBAAY;IACrC,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,OAAO,CAAgB;IACvB,cAAc,CAAS;IACvB,SAAS,CAAS;IAClB,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,CAAkC;IACvC,aAAa,GAAG,CAAC,CAAC;IAClB,UAAU,GAAG,KAAK,CAAC;IAE3B,YAAY,OAA6B;QACvC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,mDAAmD;QACnD,IAAI,CAAC;YACH,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,6DAA6D;YAC7D,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,sEAAsE;QACtE,uDAAuD;QACvD,kDAAkD;QAClD,wDAAwD;QACxD,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;gBACvE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpF,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,gBAAgB;YAC1C,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,iCAAiC,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,kFAAkF;IAClF,aAAa,CAAC,KAAc;QAC1B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,sDAAsD,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,aAAa,CAAC,MAAc;QAC1B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,0CAA0C,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YAEzE,IAAI,YAAY,IAAI,IAAI,CAAC,aAAa;gBAAE,OAAO;YAE/C,yEAAyE;YACzE,MAAM,GAAG,GAAG,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC;YAC9C,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,4BAA4B,GAAG,qDAAqD,CAAC,CAAC;gBACnG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,YAAY,GAAG,gBAAgB,CAAC,CAAC;gBAC/D,yEAAyE;gBACzE,OAAO;YACT,CAAC;YAED,gBAAgB;YAChB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YAE9E,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzD,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7B,CAAC;YAED,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;YAEpD,gEAAgE;YAChE,IAAI,IAAI,CAAC,aAAa,KAAK,YAAY,EAAE,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,MAAc;QACvC,sCAAsC;QACtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;QAErE,MAAM,MAAM,GAAiB,EAAE,CAAC;QAEhC,mCAAmC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC;QACjD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;YACvC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAA2B,EAAE,CAAC;gBACzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;oBAC1C,+CAA+C;oBAC/C,IAAI,CAAC;wBACH,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBACrC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACzC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;oBACrB,CAAC;oBAAC,MAAM,CAAC;wBACP,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;oBAC/B,CAAC;gBACH,CAAC;gBAED,4CAA4C;gBAC5C,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,MAAM;wBACN,MAAM,EAAE,EAAE,EAAE,uCAAuC;wBACnD,UAAU,EAAE,KAAK;wBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;qBACtB,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,qCAAqC;oBACrC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;wBAC7H,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,yBAAyB,KAAK,CAAC,IAAI,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;oBAC5G,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,6CAA6C;YAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,IAAY;QAClC,+DAA+D;QAC/D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;YAC7B,cAAc;YACd,UAAU;YACV,WAAW;YACX,YAAY;YACZ,YAAY;YACZ,WAAW;YACX,cAAc;YACd,QAAQ;YACR,cAAc;YACd,YAAY;YACZ,eAAe;YACf,eAAe;YACf,cAAc;YACd,iBAAiB;YACjB,aAAa;YACb,eAAe;YACf,YAAY;YACZ,kBAAkB;YAClB,cAAc;YACd,iBAAiB;YACjB,QAAQ;YACR,gBAAgB;YAChB,cAAc;YACd,SAAS;YACT,iBAAiB;YACjB,eAAe;YACf,WAAW;YACX,gBAAgB;YAChB,mBAAmB;YACnB,kBAAkB;YAClB,SAAS;YACT,oBAAoB;YACpB,gCAAgC;YAChC,+BAA+B;YAC/B,sBAAsB;YACtB,+BAA+B;YAC/B,6BAA6B;YAC7B,8BAA8B;YAC9B,mBAAmB;YACnB,kCAAkC;YAClC,eAAe;YACf,kBAAkB;YAClB,sEAAsE;YACtE,0BAA0B;YAC1B,uBAAuB;YACvB,gCAAgC;YAChC,oBAAoB;YACpB,cAAc;YACd,kBAAkB;SACnB,CAAC,CAAC;QACH,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,uEAAuE;QACvE,8EAA8E;QAC9E,iEAAiE;QACjE,+DAA+D;QAC/D,kEAAkE;QAClE,OAAO,IAAA,+BAAa,EAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,0BAA0B;QAC1B,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC/D,8CAA8C;gBAC9C,IAAI,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAChD,OAAO,OAAO,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,IAAY;QAClC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;CACF;AA9PD,sCA8PC"}

package/core/chain-reject.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * chain-reject.js — 链上拒绝 (raw_log) 的"尽力分类" (全仓唯一口径)
+ *
+ * 用途: 502 响应里给调用方一个 `hint`, 让它能区分"买家没注册 trustcoin 账户" /
+ *       "买家地址非法" / "订单状态不对" 这类**可操作**的错误, 而不用自己啃 raw_log。
+ *
+ * 三条纪律:
+ *   1. **raw_log 永远原样回传** (调用方以它为准); hint 只是提示, 判错不致命。
+ *   2. 链侧文案可能演进, 本地正则不会自动跟着变 → 匹配不上就返回 'unknown', 不猜。
+ *   3. 分类只做"包含匹配", 不解析结构化字段 (链上 error 不是稳定 ABI)。
+ *
+ * 文案出处 (只读对齐, 2026-09-23):
+ *   - x/order/keeper/msg_server.go (CreateOrder/ConfirmOrder/CancelOrder/DisputeOrder/ShipOrder)
+ *   - x/order/keeper/order_submit_auth.go (authorizeOrderSubmit 三条白名单路径)
+ */
+
+/** 规则表: 顺序敏感 (先具体后宽泛), 首个命中即返回 */
+const RULES = [
+    // ---------- 下单 (MsgCreateOrder, 见 routes/chain-writes.js /api/orders) ----------
+    {
+        hint: 'buyer_has_no_account',
+        re: /has\s*no\s+(trustcoin\s+)?account|HasAccount|not\s+registered|account\s+not\s+(found|exist)|is\s+not\s+(a\s+)?registered|未注册|无\s*trustcoin\s*账户/i,
+    },
+    {
+        // N15 #5 (2026-09-23): 链上对未注册 buyer 的另一段文案 (MsgCreateOrder 校验,
+        // .215 实测 raw_log 原文) —— 与 has_no_account 同族但措辞不同, 之前落到 'unknown'。
+        hint: 'buyer_not_registered',
+        re: /must\s+register\s+(a\s+)?(trustcoin\s+)?account/i,
+    },
+    {
+        hint: 'buyer_invalid_on_chain',
+        re: /buyer[^:;]*\b(empty|invalid|missing)\b|invalid\s+(bech32|address)|incorrect\s+address|decode\s+bech32/i,
+    },
+    {
+        hint: 'buyer_is_seller',
+        re: /buyer[^:;]*(equals|==|same\s+as|must\s+differ)[^:;]*seller/i,
+    },
+
+    // ---------- 生命周期 (ship / confirm / cancel / dispute) ----------
+    {
+        hint: 'submitter_required',
+        re: /submitter is required/i,
+    },
+    {
+        hint: 'submitter_not_allowed',
+        re: /only the order's seller, the dispute authority|can submit this; submitter=/i,
+    },
+    {
+        hint: 'order_not_found',
+        re: /order not found/i,
+    },
+    {
+        hint: 'order_not_ours',
+        // CancelOrder: 'only the order's seller can submit this cancellation (sender=...)'
+        // ShipOrder:   'only seller can ship this order'
+        re: /only the order's seller can submit this cancellation|only seller can ship this order/i,
+    },
+    {
+        hint: 'buyer_mismatch',
+        re: /only buyer can confirm this order/i,
+    },
+    {
+        hint: 'counterparty_not_party',
+        // 'only buyer or seller can dispute this order' / 'only buyer or seller can cancel this order'
+        re: /only buyer or seller can (dispute|cancel) this order/i,
+    },
+    {
+        hint: 'status_not_paid',
+        re: /order is not paid, cannot ship/i,
+    },
+    {
+        hint: 'status_not_shipped',
+        re: /order is not shipped, cannot confirm/i,
+    },
+    {
+        hint: 'status_not_pending',
+        re: /only pending orders can be cancelled/i,
+    },
+    {
+        hint: 'status_not_disputable',
+        re: /order cannot be disputed in current status/i,
+    },
+    {
+        hint: 'dispute_window_expired',
+        re: /dispute window expired/i,
+    },
+    {
+        hint: 'order_settled',
+        re: /already settled, cannot dispute|is not in confirmed status, cannot settle|already settled/i,
+    },
+];
+
+/** @returns {string} hint (匹配不上 = 'unknown') */
+function classifyChainReject(rawLog) {
+    const s = String(rawLog || '');
+    for (const r of RULES) {
+        if (r.re.test(s))
+            return r.hint;
+    }
+    return 'unknown';
+}
+
+/** 全部可能的 hint (测试/文档用) */
+const HINTS = RULES.map((r) => r.hint).concat('unknown');
+
+module.exports = { classifyChainReject, HINTS };

package/core/chain-signer.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * chain-signer.js — JS 直签通道 (cosmjs), 替代 trustchaind CLI 签名上链。
+ *
+ * - 助记词: env SELLER_MNEMONIC/CHAIN_MNEMONIC 优先, 否则 <base>/tb-keyring/mnemonic.txt
+ *   (base 由 core/paths.js 启动时解析并 freeze: TB_BASE_DIR → 包布局 → cwd; 不随 cwd 漂移)
+ *   (core/seller-identity.js 生成的真身份; HD path m/44'/118'/0'/0/0 = cosmjs 默认)
+ * - Msg 编码: protobufjs 运行时反射, vendor proto/ 目录 (keepCase: 链上 JSON 用 snake_case 原名)
+ * - 签名: @cosmjs/stargate SigningStargateClient + 自定义 Registry (proto3 标准编码)
+ * - 广播: CometBFT RPC broadcast_tx_sync (base64) → 拿 CheckTx code/log/txhash
+ *         → code==0 轮询 LCD /cosmos/tx/v1beta1/txs/{hash} 拿 DeliverTx 最终结果
+ *   (与 chain-writes.js 的 CLI 流程语义逐一对齐, 调用方零改动)
+ *
+ * 私钥材料只进 wallet, 不打日志。
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+const protobuf = require("protobufjs");
+const base_paths = require("./paths");
+
+/** seller-backend 用到的自定义 Msg typeUrl (proto vendor 清单见 proto/ 目录) */
+const CUSTOM_TYPE_URLS = [
+    "/trustchain.marketplace.v1.MsgListSKU",
+    "/trustchain.marketplace.v1.MsgAddStock",
+    "/trustchain.marketplace.v1.MsgReduceStock",
+    "/trustchain.marketplace.v1.MsgUpdateSKU",
+    "/trustchain.marketplace.v1.MsgPauseSKU",
+    "/trustchain.marketplace.v1.MsgResumeSKU",
+    "/trustchain.marketplace.v1.MsgDelistSKU",
+    "/trustchain.order.v1.MsgCreateOrder",
+    "/trustchain.order.v1.MsgConfirmPayment",
+    "/trustchain.order.v1.MsgShipOrder",
+    "/trustchain.order.v1.MsgConfirmOrder",
+    "/trustchain.order.v1.MsgCancelOrder",
+    "/trustchain.order.v1.MsgDisputeOrder",
+    "/trustchain.order.v1.MsgSettleOrder",
+    "/trustchain.order.v1.MsgTransferCredits",
+    "/trustchain.serviceprovider.v1.MsgRegisterServiceProvider",
+    "/trustchain.serviceprovider.v1.MsgSubmitPaymentFact",
+    "/trustchain.serviceprovider.v1.MsgConfirmPaymentFact",
+    "/trustchain.serviceprovider.v1.MsgClaimProviderReward",
+    // v3.9.3 联调: 引导金 (x/subchain) + 实名审批 (x/verification) + 积分 (x/economy)
+    "/trustchain.subchain.v1.MsgDisburseBootstrap",
+    "/trustchain.subchain.v1.MsgFundBootstrap",
+    "/trustchain.verification.v1.MsgSubmitVerification",
+    "/trustchain.verification.v1.MsgApproveVerification",
+    "/trustchain.economy.v1.MsgGrantCredits",
+    // N13 (2026-09-23): trustcoin 账户自助注册 (上架/下单前置; signer=creator, 商户本人签)
+    "/trustchain.trustcoin.v1.MsgRegisterAccount",
+];
+
+let _root = null;
+/** protobufjs 反射 Root (keepCase: 字段名保持 proto snake_case, 与链上 proto JSON 一致) */
+function protoRoot() {
+    if (_root) return _root;
+    const protoDir = path_1.join(__dirname, "..", "proto");
+    const root = new protobuf.Root();
+    root.resolvePath = (origin, target) => {
+        const p = path_1.join(protoDir, target);
+        try { fs_1.accessSync(p); return p; } catch (_) { return null; }
+    };
+    root.loadSync([
+        "trustchain/marketplace/v1/tx.proto",
+        "trustchain/order/v1/tx.proto",
+        "trustchain/serviceprovider/v1/tx.proto",
+        "trustchain/subchain/v1/tx.proto",
+        "trustchain/verification/v1/tx.proto",
+        "trustchain/economy/v1/tx.proto",
+        // N13 (2026-09-23): trustcoin 账户注册
+        "trustchain/trustcoin/v1/tx.proto",
+    ], { keepCase: true });
+    _root = root;
+    return root;
+}
+
+let _registry = null;
+/** cosmjs Registry: 内置 cosmos 类型 + 自定义 trustchain 类型 (protobufjs 反射包一层) */
+function makeRegistry() {
+    if (_registry) return _registry;
+    const { Registry } = require("@cosmjs/proto-signing");
+    const { defaultRegistryTypes } = require("@cosmjs/stargate");
+    const custom = CUSTOM_TYPE_URLS.map((typeUrl) => {
+        const Type = protoRoot().lookupType(typeUrl.slice(1));
+        return [typeUrl, {
+            // cosmjs Registry.encode: hasFromPartial → fromPartial(value) → encode(instance).finish()
+            fromPartial: (value) => Type.fromObject(value),
+            // 入参是 chain-writes 的 proto JSON 对象 (snake_case), 先 fromObject 再二进制编码
+            encode: (value) => ({ finish: () => Type.encode(Type.fromObject(value)).finish() }),
+            decode: (bytes) => Type.toObject(Type.decode(bytes)),
+        }];
+    });
+    _registry = new Registry([...defaultRegistryTypes, ...custom]);
+    return _registry;
+}
+
+/** 助记词文件路径: 传 baseDir 用 <baseDir>/tb-keyring/mnemonic.txt, 否则用 core/paths 解析出的安装目录 */
+function mnemonicPath(baseDir) {
+    return baseDir ? path_1.join(baseDir, "tb-keyring", "mnemonic.txt") : base_paths.mnemonicFile();
+}
+
+/** 读签名助记词 (env 优先, 否则 tb-keyring/mnemonic.txt); 没有返回 null。oracle 侧用 ORACLE_MNEMONIC */
+function loadMnemonic(baseDir) {
+    for (const k of ["ORACLE_MNEMONIC", "SELLER_MNEMONIC", "CHAIN_MNEMONIC", "CHAIN_KEY_MNEMONIC"]) {
+        if (process.env[k] && process.env[k].trim()) return process.env[k].trim();
+    }
+    const f = mnemonicPath(baseDir);
+    if (fs_1.existsSync(f)) {
+        const m = fs_1.readFileSync(f, "utf8").trim();
+        if (m) return m;
+    }
+    return null;
+}
+
+function hasMnemonic(baseDir) {
+    return loadMnemonic(baseDir) !== null;
+}
+
+let _walletCache = { mnemonic: null, wallet: null };
+async function getWallet(mnemonic) {
+    if (_walletCache.mnemonic === mnemonic && _walletCache.wallet) return _walletCache.wallet;
+    const { DirectSecp256k1HdWallet } = require("@cosmjs/proto-signing");
+    const wallet = await DirectSecp256k1HdWallet.fromMnemonic(mnemonic, { prefix: "tct" });
+    _walletCache = { mnemonic, wallet };
+    return wallet;
+}
+
+/** JS 直签模式的签名地址 (HD path m/44'/118'/0'/0/0, 与 seller-identity 派生一致) */
+async function jsSignerAddress(baseDir) {
+    const mnemonic = loadMnemonic(baseDir);
+    if (!mnemonic) throw new Error(`助记词不存在 (${mnemonicPath(baseDir)}), JS 直签不可用`);
+    const wallet = await getWallet(mnemonic);
+    const [acct] = await wallet.getAccounts();
+    return acct.address;
+}
+
+let _clientCache = { rpcUrl: null, wallet: null, client: null };
+async function getClient(rpcUrl, wallet) {
+    if (_clientCache.rpcUrl === rpcUrl && _clientCache.wallet === wallet && _clientCache.client) return _clientCache.client;
+    const { SigningStargateClient } = require("@cosmjs/stargate");
+    const client = await SigningStargateClient.connectWithSigner(rpcUrl, wallet, { registry: makeRegistry() });
+    _clientCache = { rpcUrl, wallet, client };
+    return client;
+}
+
+/** chain-writes.js 传进来的 {@type, ...snake_case} → cosmjs {typeUrl, value} */
+function toEncodeObjects(messages) {
+    return messages.map((m) => {
+        const { "@type": typeUrl, ...value } = m;
+        return { typeUrl, value };
+    });
+}
+
+/** CometBFT RPC broadcast_tx_sync (base64 tx) → {code, raw_log, txhash} (CheckTx 结果) */
+async function broadcastTxSync(rpcUrl, txBytes) {
+    const resp = await fetch(rpcUrl, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+            jsonrpc: "2.0", id: "tb-seller",
+            method: "broadcast_tx_sync",
+            params: { tx: Buffer.from(txBytes).toString("base64") },
+        }),
+        signal: AbortSignal.timeout(10000),
+    });
+    const j = await resp.json().catch(() => null);
+    const r = j && j.result;
+    if (!r) throw new Error(`broadcast_tx_sync 响应异常: ${JSON.stringify(j).slice(0, 200)}`);
+    return {
+        code: Number(r.code ?? 0),
+        raw_log: String(r.log || r.codespace || ""),
+        txhash: String(r.hash || ""),
+    };
+}
+
+/** 轮询 LCD 拿 DeliverTx 最终结果 (与 chain-writes.js pollFinalTx 同语义: ~15s, 查不到返回 null) */
+async function pollFinalTx(lcdUrl, txhash) {
+    const intervalMs = Number(process.env.CHAIN_TX_POLL_INTERVAL_MS || 3000);
+    for (let i = 0; i < 5; i++) {
+        await new Promise((r) => setTimeout(r, intervalMs));
+        try {
+            const resp = await fetch(`${lcdUrl}/cosmos/tx/v1beta1/txs/${txhash}`, {
+                signal: AbortSignal.timeout(8000),
+            });
+            if (resp.status === 404 || !resp.ok) continue;
+            const j = await resp.json();
+            const tr = j && j.tx_response;
+            if (tr && tr.height && Number(tr.height) > 0) {
+                return { txhash, code: Number(tr.code ?? 0), raw_log: String(tr.raw_log ?? "") };
+            }
+        } catch (_) { /* 网络抖动, 下轮再试 */ }
+    }
+    return null;
+}
+
+class SequenceMismatchErrorJs extends Error {}
+
+/**
+ * JS 直签 + 广播完整流程。入参/返回与 chain-writes.js 的 CLI 路径对齐:
+ *   c: cfg() 结果 (rpcUrl/lcdUrl/chainId/feeDenom/feeAmount/gasLimit)
+ *   messages: proto JSON [{@type, ...snake_case}]
+ *   account: {accountNumber, sequence} (字符串)
+ * 返回 {txhash, code, raw_log} (code!=0 也返回, 由调用方判 502)
+ * memo: 可选; 下单 (MsgCreateOrder) 走 "tb-auth:<sha256>" 意愿摘要, 其余写路径留空
+ * 抛 SequenceMismatchErrorJs (message 含 "account sequence mismatch")
+ * 抛 Error("tx_delivery_timeout: ...") 当 15s 未入块
+ */
+async function jsSignAndBroadcast(c, messages, account, baseDir, memo) {
+    const mnemonic = loadMnemonic(baseDir);
+    if (!mnemonic) throw new Error(`助记词不存在 (${mnemonicPath(baseDir)}), JS 直签不可用`);
+    const wallet = await getWallet(mnemonic);
+    const client = await getClient(c.rpcUrl, wallet);
+    const signerAddress = (await wallet.getAccounts())[0].address;
+    const fee = {
+        amount: [{ denom: c.feeDenom, amount: c.feeAmount }],
+        gas: String(c.gasLimit),
+    };
+    // N15 (2026-09-23): 服务商代扣 gas — feegrant granter 随 fee 序列化进 auth_info
+    // (cosmjs makeAuthInfoBytes 原生支持); 链上无 grant/超额会被 CheckTx 拒,
+    // 回退自付在 chain-writes.signAndBroadcastInner 做这一层。
+    if (c.feeGranter) fee.granter = c.feeGranter;
+    const txRaw = await client.sign(signerAddress, toEncodeObjects(messages), fee, memo || "", {
+        accountNumber: Number(account.accountNumber),
+        sequence: Number(account.sequence),
+        chainId: c.chainId,
+    });
+    // sign() 返回 TxRaw 对象, 广播前要序列化
+    const { TxRaw } = require("cosmjs-types/cosmos/tx/v1beta1/tx");
+    const txBytes = TxRaw.encode(txRaw).finish();
+    const checkTx = await broadcastTxSync(c.rpcUrl, txBytes);
+    if (/account sequence mismatch/i.test(checkTx.raw_log)) {
+        throw new SequenceMismatchErrorJs(`account sequence mismatch: ${checkTx.raw_log}`);
+    }
+    if (checkTx.code !== 0) {
+        // CheckTx 拒绝 (码/ccodespace/log 原样回传, 语义同 CLI broadcast 的 code!=0)
+        return { txhash: checkTx.txhash, code: checkTx.code, raw_log: checkTx.raw_log };
+    }
+    const final = await pollFinalTx(c.lcdUrl, checkTx.txhash);
+    if (final) {
+        if (/account sequence mismatch/i.test(final.raw_log)) {
+            throw new SequenceMismatchErrorJs(`account sequence mismatch: ${final.raw_log}`);
+        }
+        return final;
+    }
+    throw new Error(`tx_delivery_timeout: tx ${checkTx.txhash} 未在 15s 内入块 (可能被 mempool 逐出), 请重试`);
+}
+
+module.exports = {
+    CUSTOM_TYPE_URLS,
+    protoRoot,
+    makeRegistry,
+    mnemonicPath,
+    loadMnemonic,
+    hasMnemonic,
+    jsSignerAddress,
+    jsSignAndBroadcast,
+    toEncodeObjects,
+    SequenceMismatchErrorJs,
+};

package/core/cleanup.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Storage Cleanup Strategy - PRD 16.21
+ *
+ * - Daily cleanup of delisted products older than 30 days
+ * - Clean expired search logs (keep 7 days)
+ * - SQLite VACUUM / PostgreSQL VACUUM ANALYZE
+ * - Scheduled task registration
+ */
+export interface CleanupResult {
+    deletedProducts: number;
+    deletedLogs: number;
+    vacuumOk: boolean;
+    durationMs: number;
+}
+export declare class StorageCleanup {
+    private db;
+    private dbType;
+    constructor(db: any, dbType: 'sqlite' | 'postgresql');
+    /**
+     * Run all cleanup tasks and return summary
+     */
+    runAll(): Promise<CleanupResult>;
+    /**
+     * Delete products that have been delisted for more than thresholdDays
+     */
+    cleanDelistedProducts(thresholdDays: number): Promise<number>;
+    /**
+     * Clean expired search logs, keep only recentDays
+     * Uses a search_logs table if it exists; otherwise a no-op.
+     */
+    cleanExpiredLogs(recentDays: number): Promise<number>;
+    /**
+     * Run VACUUM to reclaim disk space
+     */
+    vacuum(): Promise<boolean>;
+    /**
+     * Schedule daily cleanup at a given hour (default 3 AM)
+     * Returns the timer for cleanup
+     */
+    scheduleDaily(atHour?: number): ReturnType<typeof setInterval>;
+}
+//# sourceMappingURL=cleanup.d.ts.map

package/core/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/core/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,MAAM,CAA0B;gBAE5B,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAG,YAAY;IAKpD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IA+BtC;;OAEG;IACG,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBnE;;;OAGG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0B3D;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBhC;;;OAGG;IACH,aAAa,CAAC,MAAM,GAAE,MAAU,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC;CAkBlE"}