1 个不稳定版本
0.11.0 | 2019 年 7 月 1 日 |
---|
#26 in #sputnik-vm
260KB
6K SLoC
SputnikVM:Rust Ethereum 虚拟机实现
名称 | 描述 | Crates.io | 文档 |
---|---|---|---|
evm | Ethereum 虚拟机核心库 | ||
evm-stateful | SputnikVM 的 Merkle Trie 状态包装器 |
特性
- 独立 - 可以作为独立进程启动或集成到其他应用中
- 通用 - 支持不同的 Ethereum 链,例如 ETC、ETH 或私有链
- 无状态 - 仅提供连接到独立状态存储的执行环境
- 快速 - 主要关注性能
- 物联网兼容 - 专为支持嵌入式设备中使用的硬件而设计
- 用 Rust 编写,可以作为二进制文件、cargo crate 或共享库使用
支持的网络
- 基金会 (evm-network-foundation)
- 经典 (evm-network-classic)
- Ellaism (evm-network-ellaism)
- Expanse (evm-network-expanse)
- Musicoin (evm-network-musicoin)
- Ubiq (evm-network-ubiq)
- 所有上述网络和其他网络 (evm-network-dynamic)
支持的网络
网络 | Crates.io | 文档 |
---|---|---|
任何网络 | ||
Ethereum Classic | ||
Ethereum | ||
Ellaism | ||
Ubiq | ||
Expanse | ||
Musicoin |
预编译合约
核心库中嵌入了初始的四个预编译合约。要使用拜占庭分叉引入的 bn128 和 modexp 预编译合约,请拉取以下 crate。
名称 | 描述 | Crates.io | 文档 |
---|---|---|---|
evm-precompiled-bn128 | bn128 预编译合约 | ||
evm-precompiled-modexp | 预编译的modexp合约 |
相关项目
- ethereum-rs - Ethereum的通用特性和结构。
- etclient - 使用Rust编写的最小化Ethereum客户端。
- SputnikVM FFI - SputnikVM的C和Go FFI绑定
- SputnikVM Dev - 用于智能合约开发的SputnikVM实例,提供测试环境和JSON RPC API的模拟
- SputnikVM in Browser - 将SputnikVM编译成WebAssembly的实验版本,因此可以在Node.js浏览器中启动
- SputnikVM for embedded devices - 在嵌入式设备上运行完整功能的EVM的实验项目
依赖项
请确保您至少有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,并确保其执行与其他Ethereum虚拟机实现相一致
- jsontests:这使用了Ethereum的部分测试。这些测试目前对系统操作码的覆盖率不好。此外,一些测试是错误的,因此已禁用。
- regtests:从创世区块到第4百万区块,在Ethereum Classic主网上进行完整的回归测试。一些之前失败的测试也已集成到Rust的测试系统中。
要运行所有测试,请在克隆的存储库中执行以下命令
$ cargo test --all
贡献
格式化策略在GUIDE.md中描述,推荐的自动化格式化技术可以在FORMATTING.md中找到
许可证
Apache 2.0
依赖项
~6MB
~51K SLoC