ble-anima-minter

📡 BLE设备MAC地址区块链铸造工具

个人开源BLE工具,本地哈希存储附近MAC,实现隐私友好的物联网Proof-of-Remnant存证。

收藏
10.3k
安装
2.6k
版本
v1.0.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

BLE-Anima-Minter 是一款基于 Python 的蓝牙低功耗(BLE)设备扫描与区块链概念验证工具,旨在将物理世界中的 BLE 设备 MAC 地址通过密码学哈希转化为数字世界的 "灵魂绑定" 凭证。该工具通过扫描 2.4 GHz 频段获取附近设备的 MAC 地址,采用 SHA256 加盐哈希算法生成唯一的 Proof-of-Remnant,并以有向无环图(DAG)结构本地存储,实现了无需中心化服务器的设备身份存证方案。

核心用法相对简单,用户只需安装 aioblescannetworkx 等依赖后运行主脚本,即可启动 10 秒周期的 BLE 扫描。扫描期间,工具会自动发现附近的蓝牙设备,提取其 MAC 地址并实时进行哈希处理,最终将生成的 $ANIMA 代币凭证序列化存储在本地 gpickle 文件中。整个过程支持 KeyboardInterrupt 中断,提供了基础的交互控制。

显著优点在于其隐私保护设计理念。与常见的云端物联网平台不同,该工具将所有敏感数据(MAC 地址)在本地完成哈希处理后才存储,原始 MAC 信息不会持久化保存,且明确未实现文档中提及的 "gossip-sync" 网络同步功能,有效降低了数据泄露风险。此外,使用 DAG 结构存储代币关系也为后续的图查询和分析提供了灵活的数据组织方式。

然而,该工具存在明显的局限性和不完善之处。作为 T3 级别的个人开源项目,代码健壮性不足:依赖版本完全未锁定,可能导致未来兼容性问题;缺乏输入参数的类型校验和边界检查;主要功能函数没有 try-except 异常处理,蓝牙权限不足或硬件故障时容易崩溃。更关键的是,SKILL.md 文档与代码实现存在不一致,"gossip-sync" 功能仅存在于描述中而未实际开发,且文档未明确告知用户运行需要 Linux 系统的蓝牙组权限或 root 权限。

该技能主要适合三类人群:一是物联网(IoT)开发者,用于本地蓝牙设备发现和网络拓扑调研;二是区块链技术学习者,理解哈希证明、DAG 存储和 "灵魂绑定" 代币的概念实现;三是隐私计算研究者,探索本地化数据处理与最小化收集的实践方案。

使用风险需特别关注隐私合规和系统稳定性。工具默认收集附近所有 BLE 设备的 MAC 地址,这在 GDPR 等严格隐私法规下可能构成个人数据收集行为,存在合规风险。同时,由于依赖特定硬件(蓝牙适配器)和系统权限,在容器化环境或 Windows/macOS 系统上可能无法正常运行。生产环境使用时,未锁定的依赖版本和缺失的错误处理机制可能导致不可预期的故障,建议仅作为概念验证或开发调试工具使用。

安全解读

核心用法

BLE-Anima-Minter 是一款本地蓝牙低功耗(BLE)扫描工具,运行后自动扫描 2.4 GHz 频段内的周边设备,提取 MAC 地址,通过 SHA256+盐值哈希生成唯一「proof-of-remnant」,并在本地有向无环图(DAG)中存储为灵魂绑定 $ANIMA 通证。支持可选的 gossip-sync 节点间同步。

显著优点

  • 纯本地处理:无外部 API 调用,MAC 地址哈希后立即存储,杜绝数据外泄
  • 隐私优先设计:采用 SHA256 单向哈希+盐值,原始设备标识符不可逆向
  • 轻量依赖:仅依赖 aioblescan 和 networkx 两个成熟开源库,无已知 CVE
  • 代码透明:95 行代码结构清晰,无 eval/exec/system 等危险函数,无混淆
  • 合规友好:符合 GDPR 数据最小化原则,无跨境传输风险

潜在缺点与局限

  • 来源可信度有限:T3 级别(个人开发者 penguinx01),缺乏组织背书
  • 硬编码盐值:当前盐值 "anima2026" 固定,虽功能必需但灵活性不足
  • 无开源许可证:未指定 MIT/Apache 等标准协议,法律边界模糊
  • 错误处理薄弱:仅捕获 ImportError,BLE 扫描失败等场景缺乏容错
  • 概念隐喻晦涩:「灵魂绑定」「复活」「地平论」等标签增加理解成本

适合人群

  • 隐私极客与本地优先(Local-First)软件倡导者
  • BLE 设备研究、室内定位或近场交互开发者
  • 探索去中心化身份(DID)与物理世界证明(PoP)概念的实验者
  • 需要在隔离环境中构建设备关联图谱的安全研究员

常规风险

  • 扫描范围内 BLE 设备可能被记录哈希,虽不可逆但存在设备存在性泄露
  • 本地 DAG 文件若被复制,攻击者可获知「某时某地存在某类设备」的时序模式
  • gossip-sync 功能若启用,需评估对等节点的信任边界

ble-anima-minter 内容

手动下载zip · 1.7 kB
anima_minter.pytext/plain
请选择文件