| 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>
