ethereumjs-monorepo
id:ethereumjs/ethereumjs-monorepo ·
· 目录记录
项目概述
EthereumJS Monorepo是一组面向以太坊执行层的模块化TypeScript库,按需组合EVM执行、交易/区块、状态与Merkle树、链配置等能力,可在Node.js或浏览器中使用。它是可组合的协议构件,不是完整执行客户端;旧的@ethereumjs/client已归档,不应作为新项目起点。
原项目介绍
忠实中文 / 作者自述整理
作者称其为经过规范测试的执行层构件,涵盖EVM、交易、区块、状态、tries和链配置,默认可树摇且使用Noble加密、除非选择否则不用WASM。文档按目标引导到@ethereumjs/vm、evm、tx、block、blockchain、mpt、common等包,并给出在内存状态上对已签名转账调用runTx的示例。当前主网硬分叉Osaka在npm稳定,Amsterdam仍在开发。多数包为MPL-2.0,许可以各包目录为准。维护者包括前以太坊基金会JavaScript团队与社区。
短摘 / 原文
Modular TypeScript libraries for Ethereum execution-layer protocol work.
出处:https://github.com/ethereumjs/ethereumjs-monorepo/blob/HEAD/README.md
translation_kind:实际选读作者README定位段的忠实中文要点;非全文翻译
excerpt_kind:readme_literal
source_kind:official_repository_readme_via_sanctioned_github_tool
is_self_report:True
excerpt_truncated:False
当前具体详情
做什么
EthereumJS Monorepo是一组面向以太坊执行层的模块化TypeScript库,按需组合EVM执行、交易/区块、状态与Merkle树、链配置等能力,可在Node.js或浏览器中使用。它是可组合的协议构件,不是完整执行客户端;旧的@ethereumjs/client已归档,不应作为新项目起点。
谁会用
需要在TypeScript/JavaScript中执行或解析以太坊交易、区块、状态或字节码,但不想引入完整客户端的协议与工具开发者。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
JavaScript应用需要可组合的执行层构件来执行或解析交易、区块和状态,而不是运行完整客户端。
文档化使用场景(编辑归纳)
按目标安装vm或evm等包,在指定硬分叉的内存状态下runTx或执行字节码;归档client不用于新项目。
主要能力与用途
按层提供可组合包:执行(vm、evm)、状态(statemanager、mpt、binarytree)、协议类型(tx、block、blockchain)、配置(common、genesis)以及rlp/util等原语。
文档说明用途分流:跑已签名交易/重放或构建区块用@ethereumjs/vm;只执行字节码或自定义操作码/预编译用@ethereumjs/evm;创建、签名或解析交易用@ethereumjs/tx。
交易类型覆盖文档所列legacy/1559/2930/4844/7702;blob交易需另配KZG库,细节指向tx子README。
另有devp2p网络包、genesis与beacon-light;e2store面临废弃考虑,ethash仅为依赖维护、不在当前活跃发版轮次。已废弃的client与wallet包仍可能在npm,但作者明确不要用于新项目。
如何使用 / 既有稿流程
文档场景:按目标安装相应npm包(例如@ethereumjs/vm及common/tx/util)→用Common设定链与硬分叉→在VM的内存状态中放入账户并runTx/runBlock,或只用evm执行字节码。本研究不安装、不运行示例,也不把它当作可同步主网的节点。
用法证据状态
documented_workflow_only_not_executed
公开限制
根README是包目录与入门示例,各包的打包器/KZG细节、完整责任矩阵见子README和ARCHITECTURE.md,本次未逐份深读。
Amsterdam硬分叉标明开发中;归档的完整客户端不能再当作本仓现成功能。
许可声明为多数包MPL-2.0且以各包为准,元数据快照为“未识别”,全文未读。
浏览器可用是作者说明,具体打包与加密依赖需按子文档评估,本研究未验证。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
未识别
discussion_zh
README写明多数包为MPL-2.0并以各包许可文件为准;元数据快照为“未识别”。全文与依赖许可未读,不能当作已核的统一许可证。
strict_open_source_verified
False
full_license_text_read
False
完成评估
status
specific_details_complete
count_as_completed
True
reason_zh
已逐项阅读所列README/官方文档,复核具体功能、用户、问题、场景/流程、依赖及边界;仅文档级具体描述,不是运行/源码核验。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
problem_solved_zh
JavaScript应用需要可组合的执行层构件来执行或解析交易、区块和状态,而不是运行完整客户端。
documented_use_case_zh
按目标安装vm或evm等包,在指定硬分叉的内存状态下runTx或执行字节码;归档client不用于新项目。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:56:36.066235+08:00
来源
https://github.com/ethereumjs/ethereumjs-monorepo/blob/HEAD/README.md
local_path 未打进数据包,不生成链接:research/sources/ethereumjs/ethereumjs-monorepo/README.md.phase036-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:56:16.344705+08:00", "sha256": "43c1106bf52170da6efcd0f68e5033963e7373b96c7e0f376ca55bd40c425a1c", "read_scope": "选读根README的定位、硬分叉状态、目标/包地图、VM快速示例、废弃包与许可说明;不读各子包实现或ARCHITECTURE全文,不运行示例", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }https://github.com/ethereumjs/ethereumjs-monorepo
{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:03:16+08:00", "description": "Ethereum L1 Protocol Stack and EVM in TypeScript", "topics": [ "bytecode", "client", "ethereum", "ethereumjs", "evm", "javascript", "monorepo", "mpt", "typescript", "virtual-machine", "vm" ], "record_sha256": "d2e8fd055b602b7aaa04e73db590fbecf3f63ff00cfb9dec0cef014cfdac28a9", "read_scope": "逐项重读作者description前900字符(更长者明确截断)、topics前12项及星数/时间/许可快照;旧文档限制沿用须标非新增核验", "readme_read": false }
研究层级与范围
{
"tier": "B1_readme_light_intro",
"status": "readme_based_brief_available_not_code_or_full_documentary_audit",
"new_source_read_this_phase": true,
"readme_read": true,
"read_scope": "选读根README的定位、硬分叉状态、目标/包地图、VM快速示例、废弃包与许可说明;不读各子包实现或ARCHITECTURE全文,不运行示例",
"source_code_read": false,
"human_reviewed": false,
"human_tested": false,
"not_full_documentary_study": true,
"previous_metadata_profile_generation": "working_copy_after_phase010-b010-20261117T084141+0800",
"previous_metadata_profile_sha256": "4c4c5ab0be4098c390e34737118659f4cc850c46c971a74ddb1caa865ce0bf16"
}