@bolloon/bolloon-agent 0.4.31 → 0.4.33

package/dist/electron-build/agents/chain/chain-index-query.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * chain-index-query.ts — 链上索引的**只读查询接口** (P5, ③)
+ * =========================================================================
+ * 只做四件事, 全部是**读已落盘索引**, 不发任何 RPC、不写盘、不签名:
+ *   ① 按 taskKey 查 escrow 时间线      → getEscrowTimeline(taskKey)
+ *   ② 按 cursor(区块号+logIndex) 增量拉取 → fetchIndexSince(cursor, {limit})
+ *   ③ 全量统计 (tasks/released/refunded/disputed/expired) → getIndexStats()
+ *   ④ 当前索引高度 + 最后同步时间      → getIndexStatus()
+ *
+ * 为什么单独一个文件: 网页/工具/别的进程都可能要读, 而**读不该需要 RPC**。
+ * 这里构造的 ChainIndexer 一律是只读模式 (deploymentBlock 显式给 0, 不查 manifest),
+ * 真去读链会明确报 'chain_index_readonly' —— 不静默返回空。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setChainIndexPathForTesting = setChainIndexPathForTesting;
+exports.currentIndexPath = currentIndexPath;
+exports.readIndexFile = readIndexFile;
+exports.getIndexStatus = getIndexStatus;
+exports.getIndexStats = getIndexStats;
+exports.getEscrowTimeline = getEscrowTimeline;
+exports.fetchIndexSince = fetchIndexSince;
+const chain_indexer_js_1 = require("./chain-indexer.js");
+const chain_config_js_1 = require("./chain-config.js");
+let overridePath = null;
+/** 测试/嵌入用: 把索引文件路径钉死 (null = 恢复默认 ~/.bolloon/chain/index.json) */
+function setChainIndexPathForTesting(p) {
+    overridePath = p;
+}
+function currentIndexPath(home) {
+    return overridePath || (0, chain_indexer_js_1.chainIndexPath)(home);
+}
+/** 只读模式的 indexer (故意不查 manifest: 查索引不需要知道部署块) */
+function readonlyIndexer(opts = {}) {
+    const p = currentIndexPath(opts.home);
+    return new chain_indexer_js_1.ChainIndexer({
+        // 只读: 给个占位 provider, 真调链会抛 chain_index_readonly
+        provider: {
+            async getBlockNumber() { throw new Error('chain_index_readonly: 只读查询不发 RPC'); },
+            async getBlock() { throw new Error('chain_index_readonly: 只读查询不发 RPC'); },
+            async getLogs() { throw new Error('chain_index_readonly: 只读查询不发 RPC'); },
+        },
+        escrowAddress: '0x' + '00'.repeat(20),
+        deploymentBlock: 0,
+        deploymentSource: 'readonly-query (不需要起点)',
+        home: opts.home,
+        indexPath: p,
+        confirmations: chain_config_js_1.DEFAULT_CONFIRMATIONS,
+    });
+}
+/** 读索引文件 (没有 → 空索引, 不假装有) */
+function readIndexFile(opts = {}) {
+    return readonlyIndexer(opts).load();
+}
+/** ④ 当前索引高度 + 最后同步时间 */
+function getIndexStatus(opts = {}) {
+    const s = readIndexFile(opts);
+    return {
+        indexPath: currentIndexPath(opts.home),
+        chainId: s.chainId, networkName: s.networkName,
+        escrowAddress: s.escrowAddress, deploymentBlock: s.deploymentBlock, deploymentSource: s.deploymentSource,
+        identity: s.identity ?? { chainId: s.chainId, escrowAddress: s.escrowAddress.toLowerCase(), deploymentBlock: s.deploymentBlock },
+        lastSyncedBlock: s.lastSyncedBlock, lastSyncedAt: s.lastSyncedAt,
+        lastSyncedAgoMs: s.lastSyncedAt == null ? null : Date.now() - s.lastSyncedAt,
+        headBlock: s.headBlock, headBlockHash: s.headBlockHash,
+        entries: s.entries.length, suspects: s.entries.filter((e) => e.suspect).length,
+        confirmations: s.confirmations, pageSize: s.pageSize, reorgDepth: s.reorgDepth,
+        rebuiltAt: s.rebuiltAt ?? null, updatedAt: s.updatedAt,
+        lagFromSnapshot: s.headBlock == null ? null : Math.max(0, s.headBlock - (s.lastSyncedBlock + 1)),
+    };
+}
+/** ③ 全量统计。suspect (被回退) 的记录**不计入**业务计数, 但单独报出来。 */
+function getIndexStats(opts = {}) {
+    const s = readIndexFile(opts);
+    const live = s.entries.filter((e) => !e.suspect);
+    const byEvent = {};
+    for (const e of live)
+        byEvent[e.eventName] = (byEvent[e.eventName] || 0) + 1;
+    const byFinality = { observed: 0, confirmed: 0, finalized: 0 };
+    for (const e of s.entries)
+        byFinality[e.finality]++;
+    const n = (name) => live.filter((e) => e.eventName === name).length;
+    return {
+        entries: s.entries.length,
+        suspects: s.entries.filter((e) => e.suspect).length,
+        tasks: new Set(live.filter((e) => e.eventName === 'EscrowCreatedV2').map((e) => e.taskKey.toLowerCase())).size,
+        created: n('EscrowCreatedV2'),
+        proofSubmitted: n('ProofSubmittedV2'),
+        released: n('ReleasedV2'),
+        refunded: n('RefundedV2'),
+        disputed: n('DisputedV2'),
+        expired: n('ExpiredV2'),
+        byFinality, byEvent,
+        lastSyncedBlock: s.lastSyncedBlock, lastSyncedAt: s.lastSyncedAt, headBlock: s.headBlock,
+        deploymentBlock: s.deploymentBlock, chainId: s.chainId, escrowAddress: s.escrowAddress,
+    };
+}
+const slim = (e) => ({
+    blockNumber: e.blockNumber, blockHash: e.blockHash, txHash: e.txHash, logIndex: e.logIndex,
+    eventName: e.eventName, args: e.args, confirmations: e.confirmations, finality: e.finality,
+    suspect: e.suspect, suspectReason: e.suspectReason,
+});
+/** ① 按 taskKey 查 escrow 时间线 (块号 + logIndex 升序) */
+function getEscrowTimeline(taskKey, opts = {}) {
+    const key = String(taskKey || '').toLowerCase();
+    if (!/^0x[0-9a-f]{64}$/.test(key)) {
+        // 非法 taskKey 不硬搜: 直接空时间线 + 明确说明 (路由层会回 400)
+        return { taskKey: key, state: null, events: [], count: 0, hasSuspect: false };
+    }
+    const events = readIndexFile(opts).entries
+        .filter((e) => e.taskKey.toLowerCase() === key)
+        .sort(chain_indexer_js_1.byBlockLogIndex);
+    return {
+        taskKey: key,
+        state: (0, chain_indexer_js_1.deriveEscrowState)(events),
+        events: events.map(slim),
+        count: events.length,
+        hasSuspect: events.some((e) => e.suspect),
+    };
+}
+/** ② 按 cursor 增量拉取 (严格大于 cursor 的 (blockNumber, logIndex)) */
+function fetchIndexSince(cursor, opts = {}) {
+    const limit = Math.max(1, Math.min(1000, Math.floor(opts.limit ?? 200)));
+    const all = readIndexFile(opts).entries
+        .filter((e) => {
+        if (!cursor)
+            return true;
+        const cb = Number(cursor.blockNumber), cl = Number(cursor.logIndex);
+        return e.blockNumber > cb || (e.blockNumber === cb && e.logIndex > cl);
+    })
+        .sort(chain_indexer_js_1.byBlockLogIndex);
+    const page = all.slice(0, limit);
+    const last = page[page.length - 1];
+    return {
+        events: page.map(slim),
+        nextCursor: last ? { blockNumber: last.blockNumber, logIndex: last.logIndex } : (cursor ?? null),
+        hasMore: all.length > page.length,
+        remaining: all.length,
+        cursor: cursor ?? null,
+        limit,
+    };
+}
+// 索引目录/路径的唯一出口在 chain-indexer.ts (chainIndexDir / chainIndexPath) —— 这里不重复导出,
+// 否则 index.ts 的 `export *` 会出现同名歧义 (ESM 下歧义名会被静默丢掉)。
+//# sourceMappingURL=chain-index-query.js.map

package/dist/electron-build/agents/chain/chain-index-query.js.map

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