trustbase-seller-backend 0.1.5

package/core/trustworthiness.js

@@ -0,0 +1,375 @@
+"use strict";
+/**
+ * TrustChain Indexer Trustworthiness Evaluation System
+ *
+ * 索引器可信度评估系统 - 信誉评分、可信度排名、惩罚机制
+ * 目标：保证索引器质量，防止恶意索引器
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexerTrustworthinessSystem = void 0;
+const events_1 = require("events");
+const crypto_1 = __importDefault(require("crypto"));
+// ===================== Indexer Trustworthiness System =====================
+/**
+ * 索引器可信度评估系统
+ */
+class IndexerTrustworthinessSystem extends events_1.EventEmitter {
+    scores = new Map();
+    performances = new Map();
+    penalties = new Map();
+    communityVotes = new Map(); // indexerId -> voter -> score
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            minReportsForEvaluation: config.minReportsForEvaluation || 10,
+            accuracyWeight: config.accuracyWeight || 0.35,
+            availabilityWeight: config.availabilityWeight || 0.15,
+            responseTimeWeight: config.responseTimeWeight || 0.15,
+            communityVoteWeight: config.communityVoteWeight || 0.20,
+            historyWeight: config.historyWeight || 0.15,
+            goldThreshold: config.goldThreshold || 90,
+            silverThreshold: config.silverThreshold || 75,
+            bronzeThreshold: config.bronzeThreshold || 60,
+            penaltyThresholds: {
+                falseReportRate: config.penaltyThresholds?.falseReportRate || 0.1, // 10%
+                maliciousReportRate: config.penaltyThresholds?.maliciousReportRate || 0.05, // 5%
+                uptimeThreshold: config.penaltyThresholds?.uptimeThreshold || 0.9, // 90%
+                responseTimeThreshold: config.penaltyThresholds?.responseTimeThreshold || 5000, // 5秒
+            },
+        };
+    }
+    /**
+     * 注册索引器
+     */
+    registerIndexer(indexerId) {
+        const initialScore = {
+            indexerId,
+            overallScore: 50, // 初始评分50
+            components: {
+                accuracy: 50,
+                availability: 100,
+                responseTime: 100,
+                communityVote: 50,
+                history: 50,
+            },
+            rank: 0,
+            tier: 'basic',
+            lastUpdated: Date.now(),
+        };
+        const initialPerformance = {
+            indexerId,
+            totalReports: 0,
+            accurateReports: 0,
+            falseReports: 0,
+            maliciousReports: 0,
+            uptime: 100,
+            avgResponseTime: 0,
+            lastActive: Date.now(),
+        };
+        this.scores.set(indexerId, initialScore);
+        this.performances.set(indexerId, initialPerformance);
+        this.communityVotes.set(indexerId, new Map());
+        console.log(`[Trust] Indexer registered: ${indexerId}`);
+        this.emit('indexer-registered', indexerId);
+    }
+    /**
+     * 记录报告
+     */
+    recordReport(indexerId, accurate, malicious = false) {
+        const performance = this.performances.get(indexerId);
+        if (!performance) {
+            console.warn(`[Trust] Indexer not found: ${indexerId}`);
+            return;
+        }
+        performance.totalReports++;
+        if (malicious) {
+            performance.maliciousReports++;
+        }
+        else if (accurate) {
+            performance.accurateReports++;
+        }
+        else {
+            performance.falseReports++;
+        }
+        performance.lastActive = Date.now();
+        // 更新评分
+        this.updateScore(indexerId);
+        // 检查惩罚阈值
+        this.checkPenaltyThresholds(indexerId);
+        console.log(`[Trust] Report recorded: ${indexerId} (accurate: ${accurate})`);
+        this.emit('report-recorded', indexerId, accurate, malicious);
+    }
+    /**
+     * 记录可用性
+     */
+    recordAvailability(indexerId, uptime) {
+        const performance = this.performances.get(indexerId);
+        if (!performance) {
+            return;
+        }
+        performance.uptime = uptime;
+        performance.lastActive = Date.now();
+        this.updateScore(indexerId);
+        this.checkPenaltyThresholds(indexerId);
+        console.log(`[Trust] Availability recorded: ${indexerId} (${uptime.toFixed(2)}%)`);
+    }
+    /**
+     * 记录响应时间
+     */
+    recordResponseTime(indexerId, responseTime) {
+        const performance = this.performances.get(indexerId);
+        if (!performance) {
+            return;
+        }
+        // 计算平均响应时间
+        const totalRequests = performance.totalReports || 1;
+        performance.avgResponseTime =
+            (performance.avgResponseTime * (totalRequests - 1) + responseTime) / totalRequests;
+        performance.lastActive = Date.now();
+        this.updateScore(indexerId);
+        this.checkPenaltyThresholds(indexerId);
+        console.log(`[Trust] Response time recorded: ${indexerId} (${responseTime}ms)`);
+    }
+    /**
+     * 社区投票
+     */
+    communityVote(indexerId, voter, score // 0-100
+    ) {
+        if (score < 0 || score > 100) {
+            throw new Error('Score must be between 0 and 100');
+        }
+        const votes = this.communityVotes.get(indexerId);
+        if (!votes) {
+            console.warn(`[Trust] Indexer not found: ${indexerId}`);
+            return;
+        }
+        votes.set(voter, score);
+        this.updateScore(indexerId);
+        console.log(`[Trust] Community vote: ${voter} -> ${indexerId} (${score})`);
+        this.emit('community-vote', indexerId, voter, score);
+    }
+    /**
+     * 更新评分
+     */
+    updateScore(indexerId) {
+        const score = this.scores.get(indexerId);
+        const performance = this.performances.get(indexerId);
+        const votes = this.communityVotes.get(indexerId);
+        if (!score || !performance) {
+            return;
+        }
+        // 检查是否达到最小报告数
+        if (performance.totalReports < this.config.minReportsForEvaluation) {
+            return;
+        }
+        // 计算各组件评分
+        // 1. 准确率评分
+        const accuracyRate = performance.totalReports > 0
+            ? performance.accurateReports / performance.totalReports
+            : 0;
+        score.components.accuracy = accuracyRate * 100;
+        // 2. 可用性评分
+        score.components.availability = performance.uptime;
+        // 3. 响应速度评分（越快越高）
+        const responseTimeScore = Math.max(0, 100 - (performance.avgResponseTime / 100));
+        score.components.responseTime = responseTimeScore;
+        // 4. 社区投票评分
+        if (votes && votes.size > 0) {
+            const totalVotes = Array.from(votes.values());
+            score.components.communityVote = totalVotes.reduce((a, b) => a + b, 0) / totalVotes.length;
+        }
+        // 5. 历史记录评分（基于活跃度和稳定性）
+        const daysSinceLastActive = (Date.now() - performance.lastActive) / 86400000;
+        const historyScore = Math.max(0, 100 - daysSinceLastActive * 5);
+        score.components.history = historyScore;
+        // 计算总体评分
+        score.overallScore =
+            score.components.accuracy * this.config.accuracyWeight +
+                score.components.availability * this.config.availabilityWeight +
+                score.components.responseTime * this.config.responseTimeWeight +
+                score.components.communityVote * this.config.communityVoteWeight +
+                score.components.history * this.config.historyWeight;
+        // 确定等级
+        score.tier = this.determineTier(score.overallScore);
+        score.lastUpdated = Date.now();
+        // 更新排名
+        this.updateRanks();
+        console.log(`[Trust] Score updated: ${indexerId} (${score.overallScore.toFixed(2)})`);
+        this.emit('score-updated', indexerId, score);
+    }
+    /**
+     * 确定等级
+     */
+    determineTier(score) {
+        if (score >= this.config.goldThreshold)
+            return 'gold';
+        if (score >= this.config.silverThreshold)
+            return 'silver';
+        if (score >= this.config.bronzeThreshold)
+            return 'bronze';
+        return 'basic';
+    }
+    /**
+     * 更新排名
+     */
+    updateRanks() {
+        const allScores = Array.from(this.scores.values())
+            .sort((a, b) => b.overallScore - a.overallScore);
+        for (let i = 0; i < allScores.length; i++) {
+            allScores[i].rank = i + 1;
+        }
+    }
+    /**
+     * 检查惩罚阈值
+     */
+    checkPenaltyThresholds(indexerId) {
+        const performance = this.performances.get(indexerId);
+        if (!performance || performance.totalReports < this.config.minReportsForEvaluation) {
+            return;
+        }
+        // 检查误报率
+        const falseReportRate = performance.falseReports / performance.totalReports;
+        if (falseReportRate > this.config.penaltyThresholds.falseReportRate) {
+            this.applyPenalty(indexerId, 'score_reduction', 'High false report rate', 'medium', 10);
+        }
+        // 检查恶意举报率
+        const maliciousReportRate = performance.maliciousReports / performance.totalReports;
+        if (maliciousReportRate > this.config.penaltyThresholds.maliciousReportRate) {
+            this.applyPenalty(indexerId, 'temporary_ban', 'Malicious reporting detected', 'high', undefined, 604800000);
+        }
+        // 检查可用性
+        if (performance.uptime < this.config.penaltyThresholds.uptimeThreshold) {
+            this.applyPenalty(indexerId, 'score_reduction', 'Low availability', 'low', 5);
+        }
+        // 检查响应时间
+        if (performance.avgResponseTime > this.config.penaltyThresholds.responseTimeThreshold) {
+            this.applyPenalty(indexerId, 'score_reduction', 'Slow response time', 'low', 5);
+        }
+    }
+    /**
+     * 应用惩罚
+     */
+    applyPenalty(indexerId, type, reason, severity, amount, duration) {
+        const penalty = {
+            id: `penalty-${Date.now()}-${crypto_1.default.randomBytes(4).toString('hex')}`,
+            indexerId,
+            type,
+            reason,
+            severity,
+            amount,
+            duration,
+            timestamp: Date.now(),
+            expiresAt: duration ? Date.now() + duration : undefined,
+            active: true,
+        };
+        // 记录惩罚
+        let penalties = this.penalties.get(indexerId) || [];
+        penalties.push(penalty);
+        this.penalties.set(indexerId, penalties);
+        // 执行惩罚
+        const score = this.scores.get(indexerId);
+        if (score) {
+            if (type === 'score_reduction' && amount) {
+                score.overallScore = Math.max(0, score.overallScore - amount);
+                score.tier = this.determineTier(score.overallScore);
+                this.updateRanks();
+            }
+        }
+        console.log(`[Trust] Penalty applied: ${indexerId} (${type})`);
+        this.emit('penalty-applied', penalty);
+        return penalty;
+    }
+    /**
+     * 解除惩罚
+     */
+    removePenalty(penaltyId) {
+        for (const [indexerId, penalties] of this.penalties) {
+            const penalty = penalties.find(p => p.id === penaltyId);
+            if (penalty) {
+                penalty.active = false;
+                // 如果是降分惩罚，恢复评分
+                if (penalty.type === 'score_reduction' && penalty.amount) {
+                    const score = this.scores.get(indexerId);
+                    if (score) {
+                        score.overallScore = Math.min(100, score.overallScore + penalty.amount);
+                        score.tier = this.determineTier(score.overallScore);
+                        this.updateRanks();
+                    }
+                }
+                console.log(`[Trust] Penalty removed: ${penaltyId}`);
+                this.emit('penalty-removed', penalty);
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 获取索引器评分
+     */
+    getScore(indexerId) {
+        return this.scores.get(indexerId);
+    }
+    /**
+     * 获取索引器性能
+     */
+    getPerformance(indexerId) {
+        return this.performances.get(indexerId);
+    }
+    /**
+     * 获取索引器惩罚
+     */
+    getPenalties(indexerId, activeOnly = true) {
+        const penalties = this.penalties.get(indexerId) || [];
+        if (activeOnly) {
+            return penalties.filter(p => p.active && (!p.expiresAt || p.expiresAt > Date.now()));
+        }
+        return penalties;
+    }
+    /**
+     * 获取排名列表
+     */
+    getRanking(limit) {
+        const allScores = Array.from(this.scores.values())
+            .sort((a, b) => b.overallScore - a.overallScore);
+        return limit ? allScores.slice(0, limit) : allScores;
+    }
+    /**
+     * 获取等级分布
+     */
+    getTierDistribution() {
+        const scores = Array.from(this.scores.values());
+        return {
+            gold: scores.filter(s => s.tier === 'gold').length,
+            silver: scores.filter(s => s.tier === 'silver').length,
+            bronze: scores.filter(s => s.tier === 'bronze').length,
+            basic: scores.filter(s => s.tier === 'basic').length,
+        };
+    }
+    /**
+     * 获取统计信息
+     */
+    getStats() {
+        const scores = Array.from(this.scores.values());
+        const performances = Array.from(this.performances.values());
+        return {
+            totalIndexers: scores.length,
+            avgScore: scores.length > 0
+                ? scores.reduce((sum, s) => sum + s.overallScore, 0) / scores.length
+                : 0,
+            tierDistribution: this.getTierDistribution(),
+            totalReports: performances.reduce((sum, p) => sum + p.totalReports, 0),
+            totalAccurateReports: performances.reduce((sum, p) => sum + p.accurateReports, 0),
+            totalFalseReports: performances.reduce((sum, p) => sum + p.falseReports, 0),
+            totalMaliciousReports: performances.reduce((sum, p) => sum + p.maliciousReports, 0),
+            activePenalties: Array.from(this.penalties.values())
+                .flat()
+                .filter(p => p.active).length,
+        };
+    }
+}
+exports.IndexerTrustworthinessSystem = IndexerTrustworthinessSystem;
+//# sourceMappingURL=trustworthiness.js.map

package/core/trustworthiness.js.map

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

package/core/types.d.ts

@@ -0,0 +1,258 @@
+/**
+ * TrustCoin Indexer Plugin Interface
+ *
+ * PRD 16.5: 统一接口，多种实现，一键切换
+ * 写上链，读走索引器 — 读写分离架构
+ */
+export interface Product {
+    skuId: string;
+    seller: string;
+    title: string;
+    description: string;
+    contentHash: string;
+    priceCny: number;
+    priceTct?: number;
+    category: Category;
+    location: GeoLocation;
+    stock: number;
+    stakePerUnit: string;
+    brand?: BrandCert;
+    insurance?: InsuranceCert;
+    images: ImageRef[];
+    shipping: ShippingInfo;
+    createdAt: number;
+    updatedAt: number;
+    status: 'active' | 'inactive' | 'banned';
+}
+export interface Category {
+    level1: string;
+    level2: string;
+    level3?: string;
+}
+export interface GeoLocation {
+    latitude: number;
+    longitude: number;
+    city?: string;
+    district?: string;
+}
+export interface BrandCert {
+    brandId: string;
+    authType: 1 | 2 | 3 | 4;
+    region: string;
+    authorizedAt: string;
+}
+export interface InsuranceCert {
+    insurer: string;
+    insuranceSku: string;
+    coverageSummary: string;
+    disputeHandler: boolean;
+}
+export interface ImageRef {
+    sha256: string;
+    filename: string;
+    size: number;
+}
+export interface ShippingInfo {
+    method: string;
+    fee: number;
+    deliveryDays: number;
+}
+export interface Seller {
+    address: string;
+    moniker?: string;
+    reputation: number;
+    totalStake: string;
+    activeOrders: number;
+    completedOrders: number;
+    disputeRate: number;
+    location: GeoLocation;
+    lastOnline: number;
+    registeredAt: number;
+}
+export interface Review {
+    id: string;
+    orderId: string;
+    fromAddress: string;
+    toAddress: string;
+    rating: 1 | 2 | 3 | 4 | 5;
+    content: string;
+    contentHash: string;
+    createdAt: number;
+}
+export interface Order {
+    id: string;
+    buyer: string;
+    seller: string;
+    skuId: string;
+    quantity: number;
+    totalPrice: string;
+    status: string;
+    createdAt: number;
+    sourceChain?: string;
+}
+export interface SearchQuery {
+    keyword?: string;
+    category?: string;
+    priceMin?: number;
+    priceMax?: number;
+    location?: {
+        latitude: number;
+        longitude: number;
+        radiusKm: number;
+    };
+    attributes?: Record<string, string>;
+    sortBy?: 'relevance' | 'price_asc' | 'price_desc' | 'distance' | 'credit' | 'newest';
+    entrySeller?: string;
+    sellerMinCredit?: number;
+    minStakeCoverage?: number;
+    hasBrand?: boolean;
+    hasInsurance?: boolean;
+    onlyInsured?: boolean;
+    cellId?: string;
+    pageSize?: number;
+    page?: number;
+}
+export interface SearchResult {
+    total: number;
+    results: SearchResultItem[];
+    facets?: SearchFacets;
+    meta: {
+        queryTimeMs: number;
+        indexerName: string;
+        coverage: string;
+    };
+}
+export interface SearchResultItem {
+    product: Product;
+    seller: Seller;
+    trustScore: number;
+    trustLevel: '极高' | '很高' | '高' | '中高' | '中' | '一般' | '有风险' | '低';
+    stakeCoverage: number;
+    distanceKm?: number;
+    reviewCount: number;
+    goodRate: number;
+    rankingScore?: number;
+}
+export interface SearchFacets {
+    categories: {
+        name: string;
+        count: number;
+    }[];
+    priceRange: {
+        min: number;
+        max: number;
+    };
+    attributes?: Record<string, {
+        value: string;
+        count: number;
+    }[]>;
+}
+export interface IndexerStats {
+    totalProducts: number;
+    totalSellers: number;
+    totalReviews: number;
+    totalOrders: number;
+    syncedHeight: number;
+    indexerTier: 1 | 2 | 3;
+    dbSizeBytes: number;
+    uptimeSeconds: number;
+    queriesPerSecond: number;
+}
+/**
+ * IndexerPlugin - 索引器插件标准接口
+ *
+ * PRD 16.5: 所有索引器实现必须遵循此接口
+ * 支持插件化切换：SQLite → PostgreSQL → Elasticsearch
+ */
+export interface IndexerPlugin {
+    /** 插件名称 */
+    readonly name: string;
+    /** 显示名称 */
+    readonly displayName: string;
+    /** 索引层级：1=本地, 2=区域, 3=全网 */
+    readonly tier: 1 | 2 | 3;
+    /** 最大容量（卖家数） */
+    readonly maxCapacity: number;
+    /** 初始化（建表、配置等） */
+    init(config: IndexerConfig): Promise<void>;
+    /** 启动索引器 */
+    start(): Promise<void>;
+    /** 停止索引器 */
+    stop(): Promise<void>;
+    /** 销毁（清理数据） */
+    destroy(): Promise<void>;
+    /** 索引商品 */
+    indexProduct(product: Product): Promise<void>;
+    /** 更新商品 */
+    updateProduct(product: Product): Promise<void>;
+    /** 删除商品 */
+    removeProduct(skuId: string): Promise<void>;
+    /** 索引卖家 */
+    indexSeller(seller: Seller): Promise<void>;
+    /** 更新卖家信息 */
+    updateSeller(seller: Seller): Promise<void>;
+    /** 索引评价 */
+    indexReview(review: Review): Promise<void>;
+    /** 获取卖家的评价列表 */
+    getReviews(address: string, limit?: number, offset?: number): Promise<Review[]>;
+    /** 提交评价（直接写入本地DB，不上链） */
+    addReview(review: Review): Promise<void>;
+    /** 索引订单 */
+    indexOrder(order: Order): Promise<void>;
+    /** 核心搜索方法 */
+    search(query: SearchQuery): Promise<SearchResult>;
+    /** 获取卖家信息 */
+    getSeller(address: string): Promise<Seller | null>;
+    /** 获取商品信息 */
+    getProduct(skuId: string): Promise<Product | null>;
+    /** 获取统计信息 */
+    getStats(): Promise<IndexerStats>;
+    /**
+     * 清空所有索引数据（仅数据，保留表结构）
+     * 用于 'rebuild-required' 时从区块 1 重新同步
+     */
+    clearAll(): Promise<void>;
+    /** 获取当前同步高度 */
+    getSyncHeight(): number;
+    /** 从指定高度同步区块事件 */
+    syncFromBlock(height: number, events: ChainEvent[]): Promise<void>;
+    /** 处理来自其他节点的查询请求 */
+    handleQuery(query: SearchQuery): Promise<SearchResult>;
+    /** 获取索引器状态（供P2P网络查询） */
+    getStatus(): IndexerStats;
+}
+export interface IndexerConfig {
+    /** 数据存储路径 */
+    dataDir: string;
+    /** 链RPC端点 */
+    chainRpcUrl: string;
+    /** 链ID */
+    chainId: string;
+    /** 本节点钱包地址 */
+    selfAddress?: string;
+    /** 本地位置（用于距离计算） */
+    selfLocation?: GeoLocation;
+    /** 索引范围（同城/区域/全网） */
+    coverageMode: 'local' | 'regional' | 'global';
+    /** 自定义规则目录 */
+    rulesDir?: string;
+    /** 日志级别 */
+    logLevel?: 'trace' | 'debug' | 'info' | 'warn' | 'error';
+    /** 集群节点配置（可选） */
+    clusterNodes?: Array<{
+        id: string;
+        url: string;
+        role: 'primary' | 'replica';
+        status?: 'healthy' | 'unhealthy' | 'unknown';
+        lastCheck?: number;
+        latency?: number;
+    }>;
+}
+export interface ChainEvent {
+    type: string;
+    height: number;
+    txHash: string;
+    attributes: Record<string, string>;
+    chainId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/core/types.d.ts.map

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

package/core/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * TrustCoin Indexer Plugin Interface
+ *
+ * PRD 16.5: 统一接口，多种实现，一键切换
+ * 写上链，读走索引器 — 读写分离架构
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}