4 个版本 (破坏性更新)
0.4.0 | 2022年11月5日 |
---|---|
0.3.0 | 2022年9月26日 |
0.2.0 | 2021年1月21日 |
0.1.0 | 2020年8月5日 |
#1879 in 魔法豆
每月47次下载
在 6 个 crate 中使用 (3 直接)
170KB
4K SLoC
nakamoto
Nakamoto 是一个使用 Rust 编写的隐私保护比特币轻客户端实现,重点关注低资源利用率、模块化和安全性。
该项目的愿景是构建一套针对轻客户端功能的库,这些库易于嵌入到任何程序和任何平台中,无论是移动端还是桌面端。由于高效的运行时和最小化依赖项,该项目的 CPU、内存和代码占用很小。实现语言 Rust 为使用其他语言(例如 Swift、Python、Java)编写的程序提供了通过外部函数接口(FFI)直接绑定的可能性。
[dependencies]
nakamoto = "0.4.0"
设计
Nakamoto 被分为几个 crate,每个 crate 处理轻客户端协议的不同方面。虽然这些 crate 设计成一起使用,但由于它们之间的明确边界和 traits 的使用,交换实现变得非常简单。从高层次来看,我们有
nakamoto-client
:核心轻客户端库nakamoto-p2p
:协议状态机实现nakamoto-chain
:区块存储和分叉选择逻辑nakamoto-net
:由反应器实现使用的网络原语nakamoto-net-poll
:默认的 poll 基于网络后端nakamoto-common
:所有 crate 使用的通用功能nakamoto-node
:一个独立的光客户端守护进程nakamoto-wallet
:基于上述crate构建的一个非常基础的可观察钱包
关于上述内容的概述,请参阅位于 docs
文件夹中的 架构图。
状态
虽然该项目仍处于起步阶段,但基础功能已实现。Nakamoto能够发现节点、下载和验证最长链以及处理分叉,同时实现完整的头部验证协议。
客户端块过滤(BIP 157/158)已实现并正在工作。请参阅nakamoto-wallet
了解如何使用它的示例。
点对点层加密(BIP 324),自Bitcoin Core v26.0以来可用,也将在Nakamoto中很快实现。
最后,将实现一个C FFI,以便于将客户端嵌入移动应用程序。
尽管钱包功能将逐渐添加,但这并不是该项目的重点,该项目位于钱包之下一个层级。
项目目标
-
高保证:该库应该使用现代技术(如属性和基于模型的测试,以及离散事件模拟和模糊测试)进行彻底测试。这些方法受益于I/O和协议逻辑之间的清晰分离,并且已被证明比单元测试能够捕捉更多的错误。
-
安全性:作为一个可能进入钱包实现的库,主要目标是安全性和可审计性。因此,我们试图最小化总依赖性足迹,保持代码易于阅读,并禁止任何不安全的代码。
-
效率:区块链同步应该尽可能地高效,具有低内存、磁盘和带宽开销。我们针对资源受限的环境,如移动设备。
-
隐私:当可能时,应采用隐私保护技术。《客户端侧块过滤》(BIP 157/158)应使用 bloom 过滤器(BIP 37)来确保用户隐私并提供审查阻力。
运行测试
cargo test --all
运行守护进程
cargo run --release -p nakamoto-node -- --testnet
贡献
如果您想为Nakamoto的开发做出贡献,请与我们联系!否则,请阅读贡献指南。
捐赠
为了资助项目并确保其持续的开发和维护,非常感谢您在以下地址对Bitcoin的支持
bc1qa47tl4vmz8j82wdsdkmxex30r23c9ljs84fxah
动机
观察那些对轻客户端不友好的生态系统——例如Ethereum——我们看到,绝大多数用户在网络上进行交易时被迫信任第三方。这与区块链的理念和raison d'être完全相反,并带来了巨大的安全性和隐私风险。遗憾的是,这是由于协议层面和现有实现中对轻客户端支持不足。轻客户端对于普通用户安全地与像Ethereum或Bitcoin这样的网络接口是必要的。
为此,Nakamoto被构思为一个可以在任何移动设备上高效运行的客户端,在给定的限制下实现最高标准的隐私和安全。
许可
在MIT许可下发布。© 2020 Alexis Sellier (https://cloudhead.io)
lib.rs
:
围绕工作量证明链的功能。
依赖关系
~8MB
~107K SLoC