@quantabit/chain-analytics-sdk

QuantaBit 区块链交易与遥测统计桥接 SDK。

本 SDK 用于无缝连接 @quantabit/qbit-chain-sdk 与 @quantabit/analytics-sdk。支持在不修改底层业务逻辑的情况下，自动拦截 RPC 调用性能、监听钱包连接，并追踪链上交易的确认最终状态与耗时。

安装

npm install @quantabit/chain-analytics-sdk

核心特性

• 非侵入式自动劫持：通过代理模式拦截 RPC 方法（如 getAccountInfo 等），自动上报接口响应时延。
• 钱包状态同步：自动监听钱包连接、断开等生命周期。
• 交易生命周期轮询：对于发送的交易，支持后台自动、非阻塞轮询上链状态，精准统计确认耗时（Confirmation Latency），防遗漏并保证数据一致性。
• 合规保障：所有上报数据均受隐私控制（ConsentManager）约束，对敏感的钱包地址及交易哈希执行自动化脱敏。

快速开始

import { Tracker } from '@quantabit/analytics-sdk';
import { QBitConnection } from '@quantabit/qbit-chain-sdk';
import { ChainTracker } from '@quantabit/chain-analytics-sdk';

// 1. 初始化统计追踪器
const tracker = new Tracker({ appId: 'my-dapp' });
tracker.init();

// 2. 初始化区块链连接
const connection = new QBitConnection({ network: 'devnet' });

// 3. 初始化并绑定桥接器
const chainTracker = new ChainTracker(tracker, connection);

// 4. 手动追踪一个交易生命周期
const txSignature = '...solana_transaction_signature...';
chainTracker.trackTransactionLifecycle(txSignature, 'swap_tokens');

许可协议

MIT