ganache
personal Ethereum blockchain for development
TLDR
SYNOPSIS
ganache [options]
DESCRIPTION
Ganache is a personal Ethereum blockchain for development. It simulates full client behavior, providing instant transaction mining, configurable accounts, and blockchain forking.Developers use Ganache to test smart contracts locally before deploying to testnets or mainnet. It integrates with Truffle, Hardhat, and other development frameworks.
PARAMETERS
-p, --port port
Port to listen on (default 8545).-h, --host host
Hostname (default 127.0.0.1).-a, --accounts num
Number of accounts to generate (default: 10).-e, --defaultBalanceEther amount
Default account balance in ether (default: 100).-m, --mnemonic phrase
BIP39 mnemonic for HD wallet.-s, --seed seed
Seed to use for HD wallet account generation.-d, --deterministic
Generate deterministic addresses and mnemonic.-n, --secure
Lock available accounts by default.-u, --unlock accounts
Specify accounts to unlock.-f, --fork url
Fork from network at URL.-b, --blockTime seconds
Block time for auto-mining (default: 0, instant mining).-g, --gasPrice price
Gas price in wei (default: 20000000000).-l, --gasLimit limit
Block gas limit (default: 6721975).-i, --networkId id
Network ID.--chain.chainId id
Chain ID.--db path
Directory to save chain database for persistence.--verbose
Log all incoming requests to stdout.--allowUnlimitedContractSize
Allow unlimited contract sizes for debugging.
CAVEATS
Not for production. Behavior may differ from mainnet. State is lost on restart (use --db for persistence). Forking requires archive node access. Ganache was deprecated in December 2023 when Consensys sunset both Truffle and Ganache. Developers are encouraged to migrate to Hardhat or Foundry.
HISTORY
Ganache was developed by Truffle Suite (part of Consensys). It evolved from TestRPC and was renamed Ganache around 2017. The current version (Ganache 7+) was a complete rewrite supporting forking and improved compatibility. In September 2023, Consensys announced the sunset of both Truffle and Ganache, with codebases archived in December 2023.
