blockchain-analytics

name	blockchain-analytics
description	区块链链上数据分析工具，基于共同输入与找零启发式进行地址聚类、交易图谱构建与资金流向追踪。适用于链上取证研究与。使用启发式方法，聚类结果需人工验证，不适用于实时监控或智能合约形式化验证。
version	1.0.0
author	wangyi

blockchain-analytics

区块链链上分析工具，实现地址聚类（启发式方法）、交易图谱构建、资金流向追踪与可视化数据输出。仅使用 Python 标准库。

📌 说明：本工具基于简化模型实现和启发式方法。结果仅供学习参考，不构成投资建议或交易依据。

脚本API

类 UnionFind

并查集数据结构，用于地址聚类合并。

• UnionFind.find(x) — 查找元素所属集合的根节点（路径压缩）。
• UnionFind.union(x, y) — 合并两个元素所属集合（按秩合并）。
• UnionFind.get_clusters() — 获取所有聚类簇。

cluster_by_common_input(transactions)

基于共同输入启发式的地址聚类。 必填: transactions

cluster_by_change_address(transactions)

基于找零地址启发式的地址聚类。 必填: transactions

build_transaction_graph(transactions)

构建地址交易图谱。 必填: transactions

trace_funds(transactions, target_address, max_depth=5, min_amount=0.0)

追踪资金流向（广度优先遍历）。 必填: transactions, target_address

analyze_blockchain(transactions, target_address=None, max_depth=5, clustering_method='common_input')

区块链链上综合分析。 必填: transactions

find(x)

查找元素所属集合的根节点（路径压缩）。 必填: x

union(x, y)

合并两个元素所属集合（按秩合并）。 必填: x, y

get_clusters()

获取所有聚类簇。

调用示例

python scripts/main.py \
  --transactions <transactions> \
  --target-address <target_address> \
  --max-depth <max_depth> \
  --clustering-method <clustering_method>