#stateful #ethereum #virtual-machine #sputnik-vm #fork #tries #wrapped

ethereumvm-stateful

带有tries的SputnikVM的EthereumVM状态包装器

1 个不稳定版本

0.11.0 2019年7月1日

#29 in #tries

Apache-2.0GPL-3.0 许可协议

490KB
6K SLoC

SputnikVM:Rust实现的以太坊虚拟机

Build Status License

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

特性

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

支持的网络

支持的网络

网络 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
  • 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:在以太坊经典主网上从创世块到第 400 万个块进行完整的回归测试。一些之前失败的测试也已集成到 Rust 的测试系统中。

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

$ cargo test --all

贡献

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

许可

Apache 2.0

依赖项

~3MB
~35K SLoC