ganache
id:consensys-archive/ganache ·
· 目录记录
项目概述
Ganache是用于本地快速开发的以太坊模拟器:可在命令行、Node.js程序、浏览器或Docker中提供JSON-RPC,支持即时或按间隔出块、快照回滚、时间快进、主网分叉和账户模拟等。本条目对应ConsenSys-archive中的归档仓库,文档仍大量引用trufflesuite/ganache;它模拟本地链,不是同步或替代真实主网节点。
原项目介绍
忠实中文 / 作者自述整理
作者称Ganache能让以太坊应用开发更快、更容易、更安全,包含常见RPC与事件,并可确定性运行。功能列表包括Solidity console.log、零配置主网分叉、JSON-RPC、snapshot/revert、多种出块方式、快进时间、无需私钥的账户模拟、HTTP/WebSocket、Node.js编程接口、pending交易和Filecoin等Flavor插件。用法:全局或项目内npm安装后运行ganache,或作为EIP-1193/web3.js/ethers/viem提供者,也可在浏览器引入CDN脚本,或docker run发布8545端口。要求Node>=16、npm>=7.10。示例输出含演示账户与助记词。许可快照为MIT。
短摘 / 原文
A tool for creating a local blockchain for fast Ethereum development.
出处:https://github.com/ConsenSys-archive/ganache/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
当前具体详情
做什么
Ganache是用于本地快速开发的以太坊模拟器:可在命令行、Node.js程序、浏览器或Docker中提供JSON-RPC,支持即时或按间隔出块、快照回滚、时间快进、主网分叉和账户模拟等。本条目对应ConsenSys-archive中的归档仓库,文档仍大量引用trufflesuite/ganache;它模拟本地链,不是同步或替代真实主网节点。
谁会用
需要在本地或CI中快速得到一条可脚本化以太坊链,以开发、测试或演示合约与dApp的开发者。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
合约与dApp开发需要一条可脚本化、可分叉的本地以太坊模拟链,而不必同步真实网络。
文档化使用场景(编辑归纳)
用CLI或Node provider启动本地JSON-RPC,在测试中发方法调用或对接web3/ethers/viem。仓库已归档,示例密钥不可用于真实资金。
主要能力与用途
作为以太坊模拟器提供常用JSON-RPC(含事件),可通过HTTP/WebSocket监听,并支持即时、按需或定时出块以及时间快进。
支持状态快照与恢复、pending交易,以及文档所述的零配置主网分叉(不等待同步);也可impersonate账户且不需要私钥。
使用方式包括全局CLI、项目npm脚本、编程中作为provider/server,以及浏览器脚本和Docker(默认在DOCKER=true时监听0.0.0.0)。
可与web3.js、ethers.js、viem等库对接;另有Flavor插件机制(文档举例Filecoin)。交互式RPC方法列表指向ganache.dev,本次未通读。
如何使用 / 既有稿流程
文档场景:安装Node 16+后npm install ganache(或--global)→运行ganache得到本地RPC与测试账户→在测试代码中用provider.request调用eth_accounts等,或把该provider交给web3/ethers/viem。Docker则映射8545端口。本研究不启动模拟器,也不使用README示例中的私钥或助记词。
用法证据状态
documented_workflow_only_not_executed
公开限制
仓库位于ConsenSys-archive,文档克隆/镜像仍指向trufflesuite;维护与发布状态需另核,不能当作仍在活跃支持的产品保证。
主网分叉、插件和完整RPC选项未在本次运行验证;交互文档ganache.dev未通读。
示例输出中的账户密钥仅是文档演示,绝不能用于真实资金。本地模拟链与真实网络共识/数据并不等同。
许可快照为MIT,全文未读。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
MIT
discussion_zh
快照为MIT。全文未读。
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
合约与dApp开发需要一条可脚本化、可分叉的本地以太坊模拟链,而不必同步真实网络。
documented_use_case_zh
用CLI或Node provider启动本地JSON-RPC,在测试中发方法调用或对接web3/ethers/viem。仓库已归档,示例密钥不可用于真实资金。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:56:36.076411+08:00
来源
https://github.com/ConsenSys-archive/ganache/blob/HEAD/README.md
local_path 未打进数据包,不生成链接:research/sources/ConsenSys-archive/ganache/README.md.phase036-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:56:16.344705+08:00", "sha256": "2481b785b2748626b25f329a2b55c7db76051a5af457a6bc95b975fce068a31e", "read_scope": "选读README的功能列表、CLI/npm/编程/浏览器/Docker用法及归档仓库性质;不启动模拟链,不使用文中示例私钥", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }https://github.com/ConsenSys-archive/ganache
{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:03:16+08:00", "description": ":warning: The Truffle Suite is being sunset. For information on ongoing support, migration options and FAQs, visit the Consensys blog. Thank you for all the support over the years.", "topics": [ "blockchain", "ethereum", "ganache" ], "record_sha256": "9fead61daa19d6abd212738f5f2bfa3c95f8c1b824faf820bad8adbc0f2b2369", "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的功能列表、CLI/npm/编程/浏览器/Docker用法及归档仓库性质;不启动模拟链,不使用文中示例私钥",
"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": "7a2c9289f6533bb898cd06a7e5ee9d5ad239d65831a6efe579e1a043312d679b"
}