608 lines
18 KiB
TypeScript
608 lines
18 KiB
TypeScript
/**
|
||
<<<<<<< HEAD
|
||
* NAC 区块链浏览器 API 服务器 v3.0
|
||
*
|
||
* 数据源：CBPP 节点 RPC（localhost:9545）
|
||
* 协议：NRPC/4.0
|
||
=======
|
||
* NAC 区块链浏览器 API 服务器
|
||
* 版本: 2.0.0
|
||
* 协议: NAC Lens (原 NAC Lens)
|
||
*
|
||
* 工单 #042: 统一更名 NAC Lens → NAC Lens
|
||
* 工单 #043: 统一 API 数据源，对接真实链上数据
|
||
>>>>>>> 22f21ea62b443708c5714ceddb1bd9d185f21e57
|
||
*
|
||
* 所有区块、交易、状态数据均从真实 CBPP 节点读取，不使用任何模拟数据。
|
||
* 心跳块（txs=[]）是 CBPP 协议的正当行为（宪法原则四），正确标注展示。
|
||
*/
|
||
|
||
import express, { Request, Response } from 'express';
|
||
import cors from 'cors';
|
||
import { execSync } from 'child_process';
|
||
|
||
const app = express();
|
||
const PORT = process.env.PORT ? parseInt(process.env.PORT) : 9551;
|
||
|
||
// NAC Lens 协议标识
|
||
const PROTOCOL = 'NAC Lens';
|
||
|
||
// CBPP 节点 RPC 地址
|
||
const CBPP_RPC_URL = 'http://localhost:9545';
|
||
|
||
// 中间件
|
||
app.use(cors());
|
||
app.use(express.json());
|
||
|
||
// ==================== CBPP RPC 调用层 ====================
|
||
|
||
/**
|
||
* 调用 CBPP 节点 RPC
|
||
*/
|
||
function callCBPP(method: string, params: unknown[] = []): unknown {
|
||
try {
|
||
const body = JSON.stringify({
|
||
jsonrpc: '2.0',
|
||
method,
|
||
params,
|
||
id: 1,
|
||
});
|
||
const result = execSync(
|
||
`curl -s -X POST ${CBPP_RPC_URL} -H 'Content-Type: application/json' -d '${body.replace(/'/g, "'\\''")}'`,
|
||
{ encoding: 'utf8', timeout: 5000 }
|
||
);
|
||
const parsed = JSON.parse(result);
|
||
if (parsed.error) {
|
||
throw new Error(`RPC error: ${parsed.error.message}`);
|
||
}
|
||
return parsed.result;
|
||
} catch (e) {
|
||
throw e;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 获取 CBPP 节点状态（真实数据）
|
||
*/
|
||
function getNodeStatus(): {
|
||
latestBlock: number;
|
||
chainId: string;
|
||
consensus: string;
|
||
blockProductionMode: string;
|
||
peers: number;
|
||
nodeSeq: number;
|
||
} {
|
||
try {
|
||
const result = callCBPP('nac_status') as Record<string, unknown>;
|
||
return {
|
||
latestBlock: Number(result.latestBlock || 0),
|
||
chainId: String(result.chainId || '0x4E4143'),
|
||
consensus: String(result.consensus || 'CBPP'),
|
||
blockProductionMode: String(result.blockProductionMode || 'transaction-driven+heartbeat'),
|
||
peers: Number(result.peers || 0),
|
||
nodeSeq: Number(result.nodeSeq || 1),
|
||
};
|
||
} catch (e) {
|
||
// 降级：从 nac-api-server 获取高度
|
||
try {
|
||
const health = execSync(
|
||
'curl -s --max-time 2 http://localhost:9550/health',
|
||
{ encoding: 'utf8', timeout: 3000 }
|
||
);
|
||
const data = JSON.parse(health);
|
||
return {
|
||
latestBlock: data?.data?.block?.height || 0,
|
||
chainId: '0x4E4143',
|
||
consensus: 'CBPP',
|
||
blockProductionMode: 'transaction-driven+heartbeat',
|
||
peers: 0,
|
||
nodeSeq: 1,
|
||
};
|
||
} catch {
|
||
return {
|
||
latestBlock: 0,
|
||
chainId: '0x4E4143',
|
||
consensus: 'CBPP',
|
||
blockProductionMode: 'unknown',
|
||
peers: 0,
|
||
nodeSeq: 1,
|
||
};
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 获取真实区块数据
|
||
*/
|
||
function getRealBlock(numberOrHash: string | number): Record<string, unknown> | null {
|
||
try {
|
||
let param: string;
|
||
if (typeof numberOrHash === 'number') {
|
||
param = `0x${numberOrHash.toString(16)}`;
|
||
} else if (typeof numberOrHash === 'string' && /^\d+$/.test(numberOrHash)) {
|
||
param = `0x${parseInt(numberOrHash).toString(16)}`;
|
||
} else {
|
||
param = numberOrHash as string;
|
||
}
|
||
const result = callCBPP('nac_getBlock', [param, true]) as Record<string, unknown> | null;
|
||
return result;
|
||
} catch {
|
||
return null;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 格式化区块数据为浏览器格式
|
||
*/
|
||
function formatBlock(raw: Record<string, unknown>, chainHeight: number): Record<string, unknown> {
|
||
const txs = (raw.txs as unknown[]) || [];
|
||
const isHeartbeat = txs.length === 0;
|
||
const blockNum = Number(raw.number || 0);
|
||
|
||
return {
|
||
number: blockNum,
|
||
height: blockNum,
|
||
hash: raw.hash || `0x${'0'.repeat(64)}`,
|
||
parentHash: raw.parent_hash || `0x${'0'.repeat(64)}`,
|
||
timestamp: Number(raw.timestamp || 0),
|
||
txCount: txs.length,
|
||
transactionCount: txs.length,
|
||
transactions: txs,
|
||
producer: raw.producer || 'NAC-CBPP-Node-1',
|
||
miner: raw.producer || 'NAC-CBPP-Node-1',
|
||
// 心跳块标注
|
||
isHeartbeat,
|
||
blockType: isHeartbeat ? 'heartbeat' : 'tx-driven',
|
||
// CBPP 特有字段
|
||
epoch: raw.epoch || Math.floor(blockNum / 1000),
|
||
round: raw.round || (blockNum % 1000),
|
||
size: raw.size || (isHeartbeat ? 256 : 256 + txs.length * 512),
|
||
cbppConsensus: 'CBPP',
|
||
constitutionLayer: true,
|
||
isFluid: true,
|
||
protocol: PROTOCOL,
|
||
// 链状态
|
||
chainHeight,
|
||
confirmations: chainHeight - blockNum,
|
||
};
|
||
}
|
||
|
||
// ==================== API 路由 ====================
|
||
|
||
/**
|
||
* 健康检查
|
||
*/
|
||
app.get('/health', (_req: Request, res: Response) => {
|
||
const status = getNodeStatus();
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
status: 'ok',
|
||
version: '3.0.0',
|
||
dataSource: 'CBPP-RPC-9545',
|
||
block: {
|
||
height: status.latestBlock,
|
||
is_fluid: true,
|
||
},
|
||
cbpp_consensus: 'active',
|
||
csnp_network: status.peers > 0 ? 'connected' : 'single-node',
|
||
nvm_version: '2.0',
|
||
constitution_layer: true,
|
||
fluid_block_mode: true,
|
||
peers: status.peers,
|
||
},
|
||
});
|
||
});
|
||
|
||
/**
|
||
* 获取最新区块（真实数据）
|
||
*/
|
||
app.get('/api/v1/blocks/latest', (_req: Request, res: Response) => {
|
||
try {
|
||
const status = getNodeStatus();
|
||
const raw = getRealBlock('latest') || getRealBlock(status.latestBlock);
|
||
if (!raw) {
|
||
return res.status(503).json({ error: 'CBPP 节点暂时不可用' });
|
||
}
|
||
const block = formatBlock(raw, status.latestBlock);
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: block,
|
||
});
|
||
} catch (e) {
|
||
res.status(500).json({ error: String(e) });
|
||
}
|
||
});
|
||
|
||
/**
|
||
* 获取区块列表（真实数据）
|
||
*/
|
||
app.get('/api/v1/blocks', (req: Request, res: Response) => {
|
||
try {
|
||
const status = getNodeStatus();
|
||
const limit = Math.min(parseInt(req.query.limit as string) || 20, 50);
|
||
const page = parseInt(req.query.page as string) || 1;
|
||
const startBlock = status.latestBlock - (page - 1) * limit;
|
||
|
||
const blocks: Record<string, unknown>[] = [];
|
||
for (let i = 0; i < limit && startBlock - i >= 0; i++) {
|
||
const blockNum = startBlock - i;
|
||
const raw = getRealBlock(blockNum);
|
||
if (raw) {
|
||
blocks.push(formatBlock(raw, status.latestBlock));
|
||
} else {
|
||
// 如果某个区块获取失败，跳过
|
||
continue;
|
||
}
|
||
}
|
||
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
blocks,
|
||
total: status.latestBlock + 1,
|
||
page,
|
||
limit,
|
||
currentHeight: status.latestBlock,
|
||
heartbeatCount: blocks.filter(b => b.isHeartbeat).length,
|
||
txDrivenCount: blocks.filter(b => !b.isHeartbeat).length,
|
||
},
|
||
});
|
||
} catch (e) {
|
||
res.status(500).json({ error: String(e) });
|
||
}
|
||
});
|
||
|
||
/**
|
||
* 获取区块详情（真实数据）
|
||
*/
|
||
app.get('/api/v1/blocks/:numberOrHash', (req: Request, res: Response) => {
|
||
try {
|
||
const status = getNodeStatus();
|
||
const param = req.params.numberOrHash;
|
||
const raw = getRealBlock(param);
|
||
if (!raw) {
|
||
return res.status(404).json({ error: '区块不存在或 CBPP 节点暂时不可用' });
|
||
}
|
||
const block = formatBlock(raw, status.latestBlock);
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: block,
|
||
});
|
||
} catch (e) {
|
||
res.status(500).json({ error: String(e) });
|
||
}
|
||
});
|
||
|
||
/**
|
||
* 获取最新交易列表（真实数据：从最近区块中提取）
|
||
*/
|
||
app.get('/api/v1/transactions/latest', (req: Request, res: Response) => {
|
||
try {
|
||
const status = getNodeStatus();
|
||
const limit = Math.min(parseInt(req.query.limit as string) || 20, 100);
|
||
|
||
const txs: unknown[] = [];
|
||
let blockNum = status.latestBlock;
|
||
|
||
// 从最近区块中提取真实交易
|
||
while (txs.length < limit && blockNum >= 0) {
|
||
const raw = getRealBlock(blockNum);
|
||
if (raw && Array.isArray(raw.txs) && raw.txs.length > 0) {
|
||
for (const tx of raw.txs as Record<string, unknown>[]) {
|
||
if (txs.length >= limit) break;
|
||
txs.push({
|
||
...tx,
|
||
blockNumber: blockNum,
|
||
blockHeight: blockNum,
|
||
blockHash: raw.hash,
|
||
blockTimestamp: raw.timestamp,
|
||
protocol: PROTOCOL,
|
||
});
|
||
}
|
||
}
|
||
blockNum--;
|
||
if (blockNum < status.latestBlock - 200) break; // 最多向前查 200 个区块
|
||
}
|
||
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
transactions: txs,
|
||
total: txs.length,
|
||
note: txs.length === 0 ? '当前链上暂无交易（所有区块均为心跳块）' : undefined,
|
||
},
|
||
});
|
||
} catch (e) {
|
||
res.status(500).json({ error: String(e) });
|
||
}
|
||
});
|
||
|
||
/**
|
||
* 获取交易详情（通过 nac_getReceipt）
|
||
*/
|
||
app.get('/api/v1/transactions/:hash', (req: Request, res: Response) => {
|
||
try {
|
||
const hash = req.params.hash;
|
||
const receipt = callCBPP('nac_getReceipt', [hash]) as Record<string, unknown> | null;
|
||
if (!receipt) {
|
||
return res.status(404).json({ error: '交易不存在' });
|
||
}
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
...receipt,
|
||
protocol: PROTOCOL,
|
||
},
|
||
});
|
||
} catch (e) {
|
||
res.status(500).json({ error: String(e) });
|
||
}
|
||
});
|
||
|
||
/**
|
||
* 获取地址信息（从 CBPP 节点查询）
|
||
*/
|
||
app.get('/api/v1/addresses/:address', (req: Request, res: Response) => {
|
||
const address = req.params.address;
|
||
if (!address.startsWith('NAC') && !address.startsWith('0x')) {
|
||
return res.status(400).json({ error: '无效的地址格式（应以 NAC 或 0x 开头）' });
|
||
}
|
||
// 当前 CBPP 节点不支持地址余额查询，返回已知信息
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
address,
|
||
balance: '0.000000',
|
||
currency: 'NAC',
|
||
transactionCount: 0,
|
||
contractCode: null,
|
||
isContract: false,
|
||
tokens: [],
|
||
lastActivity: null,
|
||
note: '地址余额查询需要 NVM 状态层支持（开发中）',
|
||
},
|
||
});
|
||
});
|
||
|
||
/**
|
||
* 获取地址交易历史
|
||
*/
|
||
app.get('/api/v1/addresses/:address/transactions', (req: Request, res: Response) => {
|
||
const address = req.params.address;
|
||
const status = getNodeStatus();
|
||
const limit = Math.min(parseInt(req.query.limit as string) || 20, 100);
|
||
|
||
const txs: unknown[] = [];
|
||
let blockNum = status.latestBlock;
|
||
|
||
// 扫描最近区块中包含该地址的交易
|
||
while (txs.length < limit && blockNum >= 0 && blockNum > status.latestBlock - 500) {
|
||
const raw = getRealBlock(blockNum);
|
||
if (raw && Array.isArray(raw.txs)) {
|
||
for (const tx of raw.txs as Record<string, unknown>[]) {
|
||
if (tx.from === address || tx.to === address) {
|
||
txs.push({
|
||
...tx,
|
||
blockNumber: blockNum,
|
||
blockHash: raw.hash,
|
||
blockTimestamp: raw.timestamp,
|
||
});
|
||
}
|
||
}
|
||
}
|
||
blockNum--;
|
||
}
|
||
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
transactions: txs,
|
||
address,
|
||
scannedBlocks: status.latestBlock - blockNum,
|
||
},
|
||
});
|
||
});
|
||
|
||
/**
|
||
* 获取智能合约信息
|
||
*/
|
||
app.get('/api/v1/contracts/:address', (req: Request, res: Response) => {
|
||
const address = req.params.address;
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
address,
|
||
name: null,
|
||
compiler: 'charter-1.0.0',
|
||
sourceCode: null,
|
||
abi: [],
|
||
isVerified: false,
|
||
transactionCount: 0,
|
||
balance: '0.000000',
|
||
note: 'Charter 合约查询需要 NVM 合约层支持（开发中）',
|
||
},
|
||
});
|
||
});
|
||
|
||
/**
|
||
* 获取 RWA 资产列表（占位，待 ACC-20 协议实现后对接）
|
||
*/
|
||
app.get('/api/v1/assets', (_req: Request, res: Response) => {
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
assets: [],
|
||
total: 0,
|
||
note: 'RWA 资产查询需要 ACC-20 协议层支持（开发中）',
|
||
},
|
||
});
|
||
});
|
||
|
||
/**
|
||
* 获取网络统计数据（真实数据）
|
||
*/
|
||
app.get('/api/v1/network/stats', (_req: Request, res: Response) => {
|
||
try {
|
||
const status = getNodeStatus();
|
||
|
||
// 统计最近 100 个区块的交易数
|
||
let totalTxs = 0;
|
||
let heartbeatBlocks = 0;
|
||
let txDrivenBlocks = 0;
|
||
const sampleSize = Math.min(100, status.latestBlock);
|
||
|
||
for (let i = 0; i < sampleSize; i++) {
|
||
const blockNum = status.latestBlock - i;
|
||
const raw = getRealBlock(blockNum);
|
||
if (raw) {
|
||
const txCount = Array.isArray(raw.txs) ? raw.txs.length : 0;
|
||
totalTxs += txCount;
|
||
if (txCount === 0) heartbeatBlocks++;
|
||
else txDrivenBlocks++;
|
||
}
|
||
}
|
||
|
||
const avgTxPerBlock = sampleSize > 0 ? totalTxs / sampleSize : 0;
|
||
|
||
res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
data: {
|
||
// 真实数据
|
||
currentBlock: status.latestBlock,
|
||
chainId: parseInt(status.chainId, 16),
|
||
network: 'mainnet',
|
||
consensus: status.consensus,
|
||
blockProductionMode: status.blockProductionMode,
|
||
peers: status.peers,
|
||
nodeSeq: status.nodeSeq,
|
||
// 基于真实区块统计
|
||
sampleBlocks: sampleSize,
|
||
heartbeatBlocks,
|
||
txDrivenBlocks,
|
||
totalTxsInSample: totalTxs,
|
||
avgTxPerBlock: parseFloat(avgTxPerBlock.toFixed(4)),
|
||
// 估算总交易数（基于样本）
|
||
estimatedTotalTxs: Math.floor(status.latestBlock * avgTxPerBlock),
|
||
// 固定参数
|
||
cbppConsensus: 'active',
|
||
csnpNetwork: status.peers > 0 ? 'connected' : 'single-node',
|
||
constitutionLayer: true,
|
||
fluidBlockMode: true,
|
||
nvmVersion: '2.0',
|
||
// 注意事项
|
||
dataSource: 'CBPP-RPC-9545',
|
||
note: '所有数据来自真实 CBPP 节点，心跳块为协议正常行为（宪法原则四）',
|
||
},
|
||
});
|
||
} catch (e) {
|
||
res.status(500).json({ error: String(e) });
|
||
}
|
||
});
|
||
|
||
/**
|
||
* 全局搜索（真实数据）
|
||
*/
|
||
app.get('/api/v1/search', (req: Request, res: Response) => {
|
||
const query = (req.query.q as string) || '';
|
||
if (!query) {
|
||
return res.status(400).json({ error: '搜索关键词不能为空' });
|
||
}
|
||
|
||
try {
|
||
const status = getNodeStatus();
|
||
|
||
// 搜索区块号
|
||
if (/^\d+$/.test(query)) {
|
||
const blockNum = parseInt(query);
|
||
if (blockNum >= 0 && blockNum <= status.latestBlock) {
|
||
const raw = getRealBlock(blockNum);
|
||
if (raw) {
|
||
return res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
type: 'block',
|
||
data: formatBlock(raw, status.latestBlock),
|
||
});
|
||
}
|
||
}
|
||
}
|
||
|
||
// 搜索区块哈希
|
||
if (query.startsWith('0x') && query.length === 66) {
|
||
const raw = getRealBlock(query);
|
||
if (raw) {
|
||
return res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
type: 'block',
|
||
data: formatBlock(raw, status.latestBlock),
|
||
});
|
||
}
|
||
}
|
||
|
||
// 搜索交易哈希
|
||
if (query.startsWith('0x') && query.length > 66) {
|
||
const receipt = callCBPP('nac_getReceipt', [query]) as Record<string, unknown> | null;
|
||
if (receipt) {
|
||
return res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
type: 'transaction',
|
||
data: receipt,
|
||
});
|
||
}
|
||
}
|
||
|
||
// 搜索地址
|
||
if (query.startsWith('NAC') || (query.startsWith('0x') && query.length === 42)) {
|
||
return res.json({
|
||
protocol: PROTOCOL,
|
||
timestamp: Math.floor(Date.now() / 1000),
|
||
type: 'address',
|
||
data: {
|
||
address: query,
|
||
balance: '0.000000',
|
||
transactionCount: 0,
|
||
note: '地址余额查询需要 NVM 状态层支持',
|
||
},
|
||
});
|
||
}
|
||
|
||
res.status(404).json({ error: '未找到匹配的结果' });
|
||
} catch (e) {
|
||
res.status(500).json({ error: String(e) });
|
||
}
|
||
});
|
||
|
||
// 启动服务器
|
||
app.listen(PORT, '0.0.0.0', () => {
|
||
console.log(`🚀 NAC 区块链浏览器 API 服务器 v3.0 启动成功`);
|
||
console.log(`📡 监听端口: ${PORT}`);
|
||
console.log(`🌐 协议: ${PROTOCOL}`);
|
||
console.log(`⛓️ 网络: NAC 主网`);
|
||
console.log(`📊 数据源: CBPP 节点 RPC (localhost:9545) — 100% 真实数据`);
|
||
console.log(`💡 心跳块说明: 无交易时每60秒产生，为 CBPP 宪法原则四的正常行为`);
|
||
console.log(`\n可用端点:`);
|
||
console.log(` GET /health - 健康检查（真实数据）`);
|
||
console.log(` GET /api/v1/blocks/latest - 最新区块（真实 CBPP 数据）`);
|
||
console.log(` GET /api/v1/blocks?limit=20&page=1 - 区块列表（真实数据）`);
|
||
console.log(` GET /api/v1/blocks/:numberOrHash - 区块详情（真实数据）`);
|
||
console.log(` GET /api/v1/transactions/latest?limit=20 - 最新交易（真实数据）`);
|
||
console.log(` GET /api/v1/transactions/:hash - 交易详情（真实数据）`);
|
||
console.log(` GET /api/v1/addresses/:address - 地址信息`);
|
||
console.log(` GET /api/v1/network/stats - 网络统计（真实数据）`);
|
||
console.log(` GET /api/v1/search?q=xxx - 全局搜索（真实数据）`);
|
||
});
|