EthereumJS 单一代码库

[![代码覆盖率][coverage-badge]][coverage-link] [![Discord][discord-badge]][discord-link] [![GitPOAP][gitpoap-badge]][gitpoap-link]

本代码库包含了以太坊区块链执行层的各种协议构建模块，由以太坊基金会的JavaScript团队管理。这里有一个可以在Node.js或浏览器环境中使用的[以太坊虚拟机（EVM）][vm-package]的TypeScript实现，以及核心区块链结构构建模块的实现，如以太坊[交易][tx-package]、[区块][block-package]或[区块链][blockchain-package]，还有[Trie][trie-package]（默克尔帕特里夏树）和[devp2p][devp2p-package]（执行网络层）的实现。

所有库都通过核心[Common][common-package]库绑定在一起，该库跟踪链的具体信息和硬分叉变更。它们由辅助包complemented，如用于数据编码/解码的[RLP][rlp-package]，或提供（字节）转换、签名、类型等辅助功能的[Util][util-package]。

最后，[EthereumJS执行客户端][client-package]（EthereumJS）已经处于积极开发中一段时间了。它已经服务于多种用途，如测试、研究（如EIP）和开发者工具，以参与协议。

还需注意：在以太坊共识方面，ChainSafe的Lodestar代码库补充了本代码库，提供了以太坊共识客户端实现以及在以太坊共识层演进背景下开发的各种协议实现（如SSZ库）。

包列表

以下是本代码库中包含的包列表。

包名	npm	问题	测试	覆盖率
[@ethereumjs/block][block-package]	[![NPM包][block-npm-badge]][block-npm-link]	[![Block问题][block-issues-badge]][block-issues-link]	[![Actions状态][block-actions-badge]][block-actions-link]	[![代码覆盖率][block-coverage-badge]][block-coverage-link]
[@ethereumjs/blockchain][blockchain-package]	[![NPM包][blockchain-npm-badge]][blockchain-npm-link]	[![Blockchain问题][blockchain-issues-badge]][blockchain-issues-link]	[![Actions状态][blockchain-actions-badge]][blockchain-actions-link]	[![代码覆盖率][blockchain-coverage-badge]][blockchain-coverage-link]
[@ethereumjs/client][client-package]	[![NPM包][client-npm-badge]][client-npm-link]	[![Client问题][client-issues-badge]][client-issues-link]	[![Actions状态][client-actions-badge]][client-actions-link]	[![代码覆盖率][client-coverage-badge]][client-coverage-link]
[@ethereumjs/common][common-package]	[![NPM包][common-npm-badge]][common-npm-link]	[![Common问题][common-issues-badge]][common-issues-link]	[![Actions状态][common-actions-badge]][common-actions-link]	[![代码覆盖率][common-coverage-badge]][common-coverage-link]
[@ethereumjs/devp2p][devp2p-package]	[![NPM包][devp2p-npm-badge]][devp2p-npm-link]	[![Devp2p问题][devp2p-issues-badge]][devp2p-issues-link]	[![Actions状态][devp2p-actions-badge]][devp2p-actions-link]	[![代码覆盖率][devp2p-coverage-badge]][devp2p-coverage-link]
[@ethereumjs/ethash][ethash-package]	[![NPM包][ethash-npm-badge]][ethash-npm-link]	[![Ethash问题][ethash-issues-badge]][ethash-issues-link]	[![Actions状态][ethash-actions-badge]][ethash-actions-link]	[![代码覆盖率][ethash-coverage-badge]][ethash-coverage-link]
[@ethereumjs/evm][evm-package]	[![NPM包][evm-npm-badge]][evm-npm-link]	[![EVM问题][evm-issues-badge]][evm-issues-link]	[![Actions状态][evm-actions-badge]][evm-actions-link]	[![代码覆盖率][evm-coverage-badge]][evm-coverage-link]
[@ethereumjs/genesis][genesis-package]	[![NPM包][genesis-npm-badge]][genesis-npm-link]	[![Genesis问题][genesis-issues-badge]][genesis-issues-link]	[![Actions状态][genesis-actions-badge]][genesis-actions-link]	[![代码覆盖率][genesis-coverage-badge]][genesis-coverage-link]
[@ethereumjs/rlp][rlp-package]	[![NPM包][rlp-npm-badge]][rlp-npm-link]	[![rlp问题][rlp-issues-badge]][rlp-issues-link]	[![Actions状态][rlp-actions-badge]][rlp-actions-link]	[![代码覆盖率][rlp-coverage-badge]][rlp-coverage-link]
[@ethereumjs/statemanager][statemanager-package]	[![NPM包][statemanager-npm-badge]][statemanager-npm-link]	[![StateManager问题][statemanager-issues-badge]][statemanager-issues-link]	[![Actions状态][statemanager-actions-badge]][statemanager-actions-link]	[![代码覆盖率][statemanager-coverage-badge]][statemanager-coverage-link]
[@ethereumjs/trie][trie-package]	[![NPM包][trie-npm-badge]][trie-npm-link]	[![Trie问题][trie-issues-badge]][trie-issues-link]	[![Actions状态][trie-actions-badge]][trie-actions-link]	[![代码覆盖率][trie-coverage-badge]][trie-coverage-link]
[@ethereumjs/tx][tx-package]	[![NPM包][tx-npm-badge]][tx-npm-link]	[![Tx问题][tx-issues-badge]][tx-issues-link]	[![Actions状态][tx-actions-badge]][tx-actions-link]	[![代码覆盖率][tx-coverage-badge]][tx-coverage-link]
[@ethereumjs/util][util-package]	[![NPM包][util-npm-badge]][util-npm-link]	[![Util问题][util-issues-badge]][util-issues-link]	[![Actions状态][util-actions-badge]][util-actions-link]	[![代码覆盖率][util-coverage-badge]][util-coverage-link]
[@ethereumjs/verkle][verkle-package]	[![NPM包][verkle-npm-badge]][verkle-npm-link]	[![VM问题][verkle-issues-badge]][verkle-issues-link]	[![Actions状态][verkle-actions-badge]][verkle-actions-link]	[![代码覆盖率][verkle-coverage-badge]][verkle-coverage-link]
[@ethereumjs/vm][vm-package]	[![NPM包][vm-npm-badge]][vm-npm-link]	[![VM问题][vm-issues-badge]][vm-issues-link]	[![Actions状态][vm-actions-badge]][vm-actions-link]	[![代码覆盖率][vm-coverage-badge]][vm-coverage-link]
[@ethereumjs/wallet][wallet-package]	[![NPM包][wallet-npm-badge]][wallet-npm-link]	[![StateManager问题][wallet-issues-badge]][wallet-issues-link]	[![Actions状态][wallet-actions-badge]][wallet-actions-link]	[![代码覆盖率][wallet-coverage-badge]][wallet-coverage-link]

分支

以下是我们目前活跃的分支：

分支	发布系列	状态	描述
master	即将发布（2024年秋季）	`开发中`	破坏性发布工作
maintenance-v8	v7/v8	`维护中`	v8版本的维护（也包括v7）
maintenance-v6	v6	`维护中`	v6版本的维护

破坏性发布通常会同步进行所有库的更新（最近的例外：VM v8，EVM v3），发布周期目前以@ethereumjs/vm的版本命名。在大多数情况下，PR应该提交到当前的工作分支。如果没有当前的工作分支，请询问！🙂

要查看特定包版本的相关代码，请参考标签。

覆盖率报告

详细版本可以在[Codecov.io][coverage-link]上查看

[ 代码覆盖率 ][coverage-link]

包依赖关系

 graph TD
   vm{vm}
   client{client}
   ethash --> blockchain
   ethash --> client
   devp2p --> client
   block --> client
   block --> blockchain
   block --> ethash
   block --> vm
   blockchain --> client
   blockchain --> vm
   trie --> client
   trie --> vm
   trie --> blockchain
   trie --> block
   trie --> statemanager
   common --> block
   common --> statemanager
   common --> tx
   common --> blockchain
   common --> vm
   common --> evm
   common --> client
   common --> devp2p
   common --> genesis
   evm --> vm
   evm --> client
   genesis --> client
   genesis --> statemanager
   genesis --> trie
   tx --> block
   tx --> evm
   tx --> vm
   vm --> client
   statemanager --> evm
   statemanager --> vm