1 个不稳定版本

0.11.0 2019 年 7 月 1 日

#32#sputnik-vm

Apache-2.0 以及可能 GPL-3.0

265KB
5.5K SLoC

SputnikVM:Rust 实现的 Ethereum 虚拟机

Build Status License

名称 描述 Crates.io 文档
evm Ethereum 虚拟机的核心库 crates.io Documentation
evm-stateful SputnikVM 的 Merkle Trie 状态包装器 crates.io Documentation

特性

  • 独立 - 可以作为一个独立进程启动,或者集成到其他应用中
  • 通用 - 支持不同的 Ethereum 链,例如 ETC、ETH 或私有链
  • 无状态 - 只是一个连接到独立状态存储的执行环境
  • 快速 - 主要关注性能
  • IoT 兼容 - 设计用于支持嵌入式设备中使用的硬件
  • 用 Rust 编写,可以作为二进制文件、cargo 包或共享库使用

支持的网络

支持的网络

网络 Crates.io 文档
任何网络 crates.io Documentation
Ethereum Classic crates.io Documentation
Ethereum crates.io Documentation
Ellaism crates.io Documentation
Ubiq crates.io Documentation
Expanse crates.io Documentation
Musicoin crates.io Documentation

预编译合约

核心库中嵌入了初始的四个预编译合约。为了使用拜占庭硬分叉引入的bn128和modexp预编译合约,请拉取以下crate。

名称 描述 Crates.io 文档
evm-precompiled-bn128 bn128 预编译合约 crates.io Documentation
evm-precompiled-modexp modexp 预编译合约 crates.io Documentation

依赖关系

请确保您至少有 rustc 1.33.0 (2aa4c46cf 2019-02-28)。Rust 1.32.0及以前版本不受支持。

文档

从源代码构建

SputnikVM是用Rust编写的。如果您不熟悉Rust,请参阅入门指南

构建

要开始使用SputnikVM,您需要安装rustup,然后您可以这样做

$ git clone [email protected]:ethereumproject/evm-rs.git
$ cd evm-rs
$ cargo build --release --all

测试

我们目前使用两种方式来测试SputnikVM,并确保其执行与其他以太坊虚拟机实现保持一致

  • jsontests:这使用以太坊测试的一部分。这些测试目前对系统操作操作码的覆盖率不好。此外,一些测试是错误的,因此它们已被禁用。
  • regtests:在以太坊经典主网上从创世块到第4百万块进行了完整的回归测试。一些之前失败的测试也被集成到Rust的测试系统中。

要运行所有测试,在克隆的仓库中执行以下命令

$ cargo test --all

贡献

格式化策略在GUIDE.md中描述,推荐的自动化格式化技术可在FORMATTING.md中找到

许可证

Apache 2.0

依赖关系

~6MB
~50K SLoC