trustbase-seller-backend 0.1.5

package/core/websocket.js

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * TrustChain Indexer WebSocket Server
+ *
+ * 实时推送区块事件到客户端
+ * 目标：同步延迟从10s → <1s
+ */
+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.IndexerWebSocketServer = exports.DEFAULT_WEBSOCKET_CONFIG = void 0;
+const events_1 = require("events");
+const ws_1 = __importStar(require("ws"));
+exports.DEFAULT_WEBSOCKET_CONFIG = {
+    port: 3002,
+    heartbeatInterval: 30000, // 30秒
+    clientTimeout: 60000, // 60秒
+};
+class IndexerWebSocketServer extends events_1.EventEmitter {
+    config;
+    wss;
+    clients = new Map();
+    heartbeatTimer;
+    constructor(config = exports.DEFAULT_WEBSOCKET_CONFIG) {
+        super();
+        this.config = config;
+    }
+    /**
+     * 启动WebSocket服务器
+     */
+    start() {
+        this.wss = new ws_1.WebSocketServer({ port: this.config.port });
+        console.log(`[WebSocket] Server started on port ${this.config.port}`);
+        this.wss.on('connection', (ws, req) => {
+            const clientIP = req.socket.remoteAddress || 'unknown';
+            console.log(`[WebSocket] Client connected from ${clientIP}`);
+            // 初始化客户端信息
+            const clientInfo = {
+                ws,
+                lastPong: Date.now(),
+                subscriptions: new Set(['block', 'transaction', 'product', 'order']),
+            };
+            this.clients.set(ws, clientInfo);
+            // 发送欢迎消息
+            this.sendToClient(ws, {
+                type: 'welcome',
+                message: 'Connected to TrustChain Indexer WebSocket',
+                timestamp: Date.now(),
+            });
+            // 设置消息处理器
+            ws.on('message', (data) => {
+                this.handleMessage(ws, data);
+            });
+            ws.on('pong', () => {
+                const info = this.clients.get(ws);
+                if (info) {
+                    info.lastPong = Date.now();
+                }
+            });
+            ws.on('close', () => {
+                console.log(`[WebSocket] Client disconnected from ${clientIP}`);
+                this.clients.delete(ws);
+            });
+            ws.on('error', (error) => {
+                console.error(`[WebSocket] Client error: ${error.message}`);
+                this.clients.delete(ws);
+            });
+        });
+        // 启动心跳检测
+        this.startHeartbeat();
+    }
+    /**
+     * 停止WebSocket服务器
+     */
+    stop() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+        }
+        if (this.wss) {
+            // 关闭所有客户端连接
+            for (const [ws] of this.clients) {
+                ws.close();
+            }
+            this.clients.clear();
+            // 关闭服务器
+            this.wss.close(() => {
+                console.log('[WebSocket] Server stopped');
+            });
+        }
+    }
+    /**
+     * 广播区块事件
+     */
+    broadcastBlockEvent(height, events) {
+        const message = {
+            type: 'block',
+            height,
+            events,
+            count: events.length,
+            timestamp: Date.now(),
+        };
+        this.broadcast(message, 'block');
+        console.log(`[WebSocket] Broadcasted block ${height} with ${events.length} events to ${this.clients.size} clients`);
+    }
+    /**
+     * 广播交易事件
+     */
+    broadcastTransactionEvent(txHash, eventType, data) {
+        const message = {
+            type: 'transaction',
+            txHash,
+            eventType,
+            data,
+            timestamp: Date.now(),
+        };
+        this.broadcast(message, 'transaction');
+    }
+    /**
+     * 广播商品事件
+     */
+    broadcastProductEvent(productId, eventType, data) {
+        const message = {
+            type: 'product',
+            productId,
+            eventType,
+            data,
+            timestamp: Date.now(),
+        };
+        this.broadcast(message, 'product');
+    }
+    /**
+     * 广播订单事件
+     */
+    broadcastOrderEvent(orderId, eventType, data) {
+        const message = {
+            type: 'order',
+            orderId,
+            eventType,
+            data,
+            timestamp: Date.now(),
+        };
+        this.broadcast(message, 'order');
+    }
+    /**
+     * 广播消息给所有订阅的客户端
+     */
+    broadcast(message, eventType) {
+        const messageStr = JSON.stringify(message);
+        for (const [ws, info] of this.clients) {
+            if (ws.readyState === ws_1.default.OPEN && info.subscriptions.has(eventType)) {
+                ws.send(messageStr);
+            }
+        }
+    }
+    /**
+     * 发送消息给特定客户端
+     */
+    sendToClient(ws, message) {
+        if (ws.readyState === ws_1.default.OPEN) {
+            ws.send(JSON.stringify(message));
+        }
+    }
+    /**
+     * 处理客户端消息
+     */
+    handleMessage(ws, data) {
+        try {
+            const message = JSON.parse(data.toString());
+            switch (message.type) {
+                case 'subscribe':
+                    this.handleSubscribe(ws, message.events);
+                    break;
+                case 'unsubscribe':
+                    this.handleUnsubscribe(ws, message.events);
+                    break;
+                case 'ping':
+                    this.sendToClient(ws, { type: 'pong', timestamp: Date.now() });
+                    break;
+                default:
+                    console.warn(`[WebSocket] Unknown message type: ${message.type}`);
+            }
+        }
+        catch (error) {
+            console.error(`[WebSocket] Failed to parse message: ${error.message}`);
+        }
+    }
+    /**
+     * 处理订阅请求
+     */
+    handleSubscribe(ws, events) {
+        const info = this.clients.get(ws);
+        if (!info)
+            return;
+        for (const event of events) {
+            info.subscriptions.add(event);
+        }
+        this.sendToClient(ws, {
+            type: 'subscribed',
+            events: Array.from(info.subscriptions),
+            timestamp: Date.now(),
+        });
+        console.log(`[WebSocket] Client subscribed to: ${events.join(', ')}`);
+    }
+    /**
+     * 处理取消订阅请求
+     */
+    handleUnsubscribe(ws, events) {
+        const info = this.clients.get(ws);
+        if (!info)
+            return;
+        for (const event of events) {
+            info.subscriptions.delete(event);
+        }
+        this.sendToClient(ws, {
+            type: 'unsubscribed',
+            events: Array.from(info.subscriptions),
+            timestamp: Date.now(),
+        });
+        console.log(`[WebSocket] Client unsubscribed from: ${events.join(', ')}`);
+    }
+    /**
+     * 启动心跳检测
+     */
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(() => {
+            const now = Date.now();
+            for (const [ws, info] of this.clients) {
+                // 检查客户端是否超时
+                if (now - info.lastPong > this.config.clientTimeout) {
+                    console.log(`[WebSocket] Client timeout, closing connection`);
+                    ws.terminate();
+                    this.clients.delete(ws);
+                    continue;
+                }
+                // 发送ping
+                if (ws.readyState === ws_1.default.OPEN) {
+                    ws.ping();
+                }
+            }
+        }, this.config.heartbeatInterval);
+    }
+    /**
+     * 获取连接的客户端数量
+     */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /**
+     * 获取服务器状态
+     */
+    getStatus() {
+        return {
+            running: !!this.wss,
+            port: this.config.port,
+            clients: this.clients.size,
+            uptime: process.uptime(),
+        };
+    }
+}
+exports.IndexerWebSocketServer = IndexerWebSocketServer;
+//# sourceMappingURL=websocket.js.map

package/core/websocket.js.map

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

package/council/hidden-weight.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Council HiddenWeight 链上直读（ABCI store query）。
+ *
+ * 背景（2026-08-17，议员等级匿名化）：链侧 Query/HiddenWeight rpc 已移除
+ * （proto/trustchain/council/v1/query.proto），LCD/gRPC 查询面关闭。
+ * 本模块是 POST /api/council/my-level（本人签名自证）的取数通道：
+ * 通过 Tendermint RPC /abci_query 直读 council store 的 hidden_weights 集合。
+ *
+ * 设计意图（与链侧注释一致）：链上状态对全节点理论上可读，真正的匿名靠
+ * 地址-身份解耦（议员用独立化名地址）；公开查询面的关闭只是提高聚合分析
+ * 门槛。本模块不做访问控制——鉴权在 routes/council.ts 的 my-level 端点。
+ *
+ * 存储布局（x/council/keeper/keeper.go:84）：
+ *   HiddenWeights = collections.NewMap(sb, NewPrefix(7), "hidden_weights",
+ *                    collections.StringKey, codec.CollValue[types.HiddenWeight])
+ *   store key = 0x07 || raw address bytes（StringKey 终态编码=原始字节，见
+ *   collections@v1.3.1 codec/string.go Encode），value = gogo proto Marshal。
+ */
+export interface HiddenWeightRecord {
+    address: string;
+    weight: number;
+    level: number;
+    totalVotes: number;
+    correctVotes: number;
+    wrongVotes: number;
+    consecutiveCorrect: number;
+    consecutiveWrong: number;
+    lastVoteTime: string | null;
+}
+/** 零记录：从未投过票的地址（镜像链侧旧 handler 语义：返回 weight/level 0）。 */
+export declare function zeroHiddenWeight(address: string): HiddenWeightRecord;
+/**
+ * 解码 gogoproto Marshal 的 trustchain.council.v1.HiddenWeight：
+ *   string address = 1; uint64 weight = 2; uint32 level = 3;
+ *   uint64 total_votes = 4; uint64 correct_votes = 5; uint64 wrong_votes = 6;
+ *   uint64 consecutive_correct = 7; uint64 consecutive_wrong = 8;
+ *   google.protobuf.Timestamp last_vote_time = 9; // stdtime, non-nullable
+ */
+export declare function decodeHiddenWeight(data: Uint8Array): HiddenWeightRecord;
+/**
+ * ABCI store query 读取某地址的 HiddenWeight；不存在返回零记录。
+ * 抛错 = 节点不可达/查询失败（调用方映射 502）。
+ */
+export declare function fetchHiddenWeight(address: string): Promise<HiddenWeightRecord>;
+//# sourceMappingURL=hidden-weight.d.ts.map

package/council/hidden-weight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hidden-weight.d.ts","sourceRoot":"","sources":["../../src/council/hidden-weight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAYpE;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,kBAAkB,CAmDvE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoBpF"}

package/council/hidden-weight.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Council HiddenWeight 链上直读（ABCI store query）。
+ *
+ * 背景（2026-08-17，议员等级匿名化）：链侧 Query/HiddenWeight rpc 已移除
+ * （proto/trustchain/council/v1/query.proto），LCD/gRPC 查询面关闭。
+ * 本模块是 POST /api/council/my-level（本人签名自证）的取数通道：
+ * 通过 Tendermint RPC /abci_query 直读 council store 的 hidden_weights 集合。
+ *
+ * 设计意图（与链侧注释一致）：链上状态对全节点理论上可读，真正的匿名靠
+ * 地址-身份解耦（议员用独立化名地址）；公开查询面的关闭只是提高聚合分析
+ * 门槛。本模块不做访问控制——鉴权在 routes/council.ts 的 my-level 端点。
+ *
+ * 存储布局（x/council/keeper/keeper.go:84）：
+ *   HiddenWeights = collections.NewMap(sb, NewPrefix(7), "hidden_weights",
+ *                    collections.StringKey, codec.CollValue[types.HiddenWeight])
+ *   store key = 0x07 || raw address bytes（StringKey 终态编码=原始字节，见
+ *   collections@v1.3.1 codec/string.go Encode），value = gogo proto Marshal。
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zeroHiddenWeight = zeroHiddenWeight;
+exports.decodeHiddenWeight = decodeHiddenWeight;
+exports.fetchHiddenWeight = fetchHiddenWeight;
+const axios_1 = __importDefault(require("axios"));
+const minimal_1 = require("protobufjs/minimal");
+const RPC = process.env.CHAIN_RPC_URL || 'http://localhost:26657';
+const STORE_KEY = 'council';
+const HIDDEN_WEIGHTS_PREFIX = 0x07;
+/** 零记录：从未投过票的地址（镜像链侧旧 handler 语义：返回 weight/level 0）。 */
+function zeroHiddenWeight(address) {
+    return {
+        address,
+        weight: 0,
+        level: 0,
+        totalVotes: 0,
+        correctVotes: 0,
+        wrongVotes: 0,
+        consecutiveCorrect: 0,
+        consecutiveWrong: 0,
+        lastVoteTime: null,
+    };
+}
+function toNum(v) {
+    return typeof v === 'number' ? v : Number(v.toString());
+}
+/**
+ * 解码 gogoproto Marshal 的 trustchain.council.v1.HiddenWeight：
+ *   string address = 1; uint64 weight = 2; uint32 level = 3;
+ *   uint64 total_votes = 4; uint64 correct_votes = 5; uint64 wrong_votes = 6;
+ *   uint64 consecutive_correct = 7; uint64 consecutive_wrong = 8;
+ *   google.protobuf.Timestamp last_vote_time = 9; // stdtime, non-nullable
+ */
+function decodeHiddenWeight(data) {
+    const r = minimal_1.Reader.create(data);
+    const rec = zeroHiddenWeight('');
+    let seconds = 0;
+    const end = r.len;
+    while (r.pos < end) {
+        const tag = r.uint32();
+        const field = tag >>> 3;
+        switch (field) {
+            case 1:
+                rec.address = r.string();
+                break;
+            case 2:
+                rec.weight = toNum(r.uint64());
+                break;
+            case 3:
+                rec.level = r.uint32();
+                break;
+            case 4:
+                rec.totalVotes = toNum(r.uint64());
+                break;
+            case 5:
+                rec.correctVotes = toNum(r.uint64());
+                break;
+            case 6:
+                rec.wrongVotes = toNum(r.uint64());
+                break;
+            case 7:
+                rec.consecutiveCorrect = toNum(r.uint64());
+                break;
+            case 8:
+                rec.consecutiveWrong = toNum(r.uint64());
+                break;
+            case 9: {
+                const tr = minimal_1.Reader.create(r.bytes());
+                while (tr.pos < tr.len) {
+                    const ttag = tr.uint32();
+                    if (ttag >>> 3 === 1)
+                        seconds = toNum(tr.int64());
+                    else
+                        tr.skipType(ttag & 7);
+                }
+                break;
+            }
+            default:
+                r.skipType(tag & 7);
+        }
+    }
+    // gogo stdtime 零值 = 0001-01-01（seconds=-62135596800），视为"从未投票"
+    if (seconds !== 0 && seconds > -62135596800) {
+        rec.lastVoteTime = new Date(seconds * 1000).toISOString();
+    }
+    return rec;
+}
+/**
+ * ABCI store query 读取某地址的 HiddenWeight；不存在返回零记录。
+ * 抛错 = 节点不可达/查询失败（调用方映射 502）。
+ */
+async function fetchHiddenWeight(address) {
+    const keyBytes = new Uint8Array(1 + address.length);
+    keyBytes[0] = HIDDEN_WEIGHTS_PREFIX;
+    for (let i = 0; i < address.length; i++)
+        keyBytes[1 + i] = address.charCodeAt(i);
+    const keyHex = '0x' + Buffer.from(keyBytes).toString('hex');
+    const resp = await axios_1.default.get(`${RPC}/abci_query`, {
+        params: { path: `/store/${STORE_KEY}/key`, data: keyHex },
+        timeout: 5000,
+    });
+    const abci = resp.data?.result?.response;
+    if (!abci || (abci.code !== undefined && abci.code !== 0)) {
+        throw new Error(`abci_query failed: code=${abci?.code} log=${abci?.log ?? ''}`);
+    }
+    if (!abci.value) {
+        return zeroHiddenWeight(address); // 未存过 = 零记录
+    }
+    const rec = decodeHiddenWeight(new Uint8Array(Buffer.from(abci.value, 'base64')));
+    rec.address = address; // 以请求地址为准（store value 内地址应一致）
+    return rec;
+}
+//# sourceMappingURL=hidden-weight.js.map

package/council/hidden-weight.js.map

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

package/db/email-migrations.sql

@@ -0,0 +1,31 @@
+-- TrustChain Email 注册 + 验证 migrations (baobei lane 6 W2 邮箱注册实战锁版)
+-- Lesson #314 实战风格: 加列不拆表
+
+-- 1. email_codes 表 (验证码记录)
+CREATE TABLE IF NOT EXISTS email_codes (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  email TEXT NOT NULL,
+  code TEXT NOT NULL,
+  scene TEXT NOT NULL CHECK (scene IN ('register', 'change', 'login')),
+  created_at TEXT NOT NULL,
+  expires_at TEXT NOT NULL,
+  used INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_email_codes_email_code ON email_codes(email, code);
+CREATE INDEX IF NOT EXISTS idx_email_codes_expires ON email_codes(expires_at);
+
+-- 2. email_verifications 表 (邮箱已验证状态)
+CREATE TABLE IF NOT EXISTS email_verifications (
+  email TEXT PRIMARY KEY,
+  verified_at TEXT NOT NULL,
+  valid_until TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_email_verifications_valid ON email_verifications(valid_until);
+
+-- 3. users 表加 email 列 (Lesson #314 实战锁版: 加列不拆表)
+-- 注意: 已有 users 表则 ALTER, 没有则忽略
+ALTER TABLE users ADD COLUMN email TEXT;
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_users_email_unique ON users(email) WHERE email IS NOT NULL;

package/db/oauth-migrate.d.ts

@@ -0,0 +1,39 @@
+/**
+ * TrustChain OAuth Bridge — Migration runner (baobei #314 实战锁版)
+ *
+ * 设计要点:
+ * - 读 src/db/oauth-migrations.sql (exec 整个文件, sqlite 多语句 OK)
+ * - users 表加列用 try/catch (SQLite ADD COLUMN 无 IF NOT EXISTS, 重复跑会抛)
+ * - 幂等 (可重跑): CREATE IF NOT EXISTS / UNIQUE INDEX IF NOT EXISTS
+ * - Lesson #266a fail loud: 启动失败抛错, 不静默
+ *
+ * 实战锁版 (跟 email-migrate 类似, 但处理 4 列 ADD COLUMN 的 idempotency):
+ *
+ * @see src/db/oauth-migrations.sql
+ * @see Lesson #314 实战风格
+ */
+import Database = require('better-sqlite3');
+export interface MigrationResult {
+    appliedAt: number;
+    /** 是否包含新增的 oauth_bridge_* 表 (false = 表已存在) */
+    freshInstall: boolean;
+    /** 错误信息 (成功时 null) */
+    error: string | null;
+}
+/**
+ * 跑 OAuth bridge migrations
+ *
+ * @param db better-sqlite3 Database 实例
+ * @returns MigrationResult
+ * @throws Error if migration 失败 (Lesson #266a fail loud)
+ */
+export declare function runOAuthBridgeMigrations(db: Database.Database): MigrationResult;
+/**
+ * 检查 OAuth bridge schema 是否就绪 (用于健康检查)
+ */
+export declare function isOAuthBridgeSchemaReady(db: Database.Database): boolean;
+/**
+ * 获取当前 schema version
+ */
+export declare function getOAuthBridgeSchemaVersion(db: Database.Database): number | null;
+//# sourceMappingURL=oauth-migrate.d.ts.map

package/db/oauth-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-migrate.d.ts","sourceRoot":"","sources":["../../src/db/oauth-migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,QAAQ,GAAG,QAAQ,gBAAgB,CAAC,CAAC;AAM5C,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,eAAe,CAiH/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAavE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CAShF"}