{"id":13790350,"url":"https://github.com/vrde/ethnode","last_synced_at":"2026-01-24T05:14:35.876Z","repository":{"id":34118569,"uuid":"169246942","full_name":"vrde/ethnode","owner":"vrde","description":"Run an Ethereum node (Geth or Openethereum) for development","archived":false,"fork":false,"pushed_at":"2023-07-11T00:58:17.000Z","size":158,"stargazers_count":194,"open_issues_count":8,"forks_count":32,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-10T11:49:06.559Z","etag":null,"topics":["blockchain","ethereum","ethereum-node","geth","openethereum","smart-contracts"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vrde.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-02-05T13:38:37.000Z","updated_at":"2025-03-16T21:37:25.000Z","dependencies_parsed_at":"2023-01-15T04:45:34.516Z","dependency_job_id":"c53df142-236c-4db2-8ac4-cb5c65e55c7e","html_url":"https://github.com/vrde/ethnode","commit_stats":{"total_commits":61,"total_committers":8,"mean_commits":7.625,"dds":0.2622950819672131,"last_synced_commit":"aa031e8f2bc0e658f0de9b6da91bf374573cd0a0"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vrde%2Fethnode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vrde%2Fethnode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vrde%2Fethnode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vrde%2Fethnode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vrde","download_url":"https://codeload.github.com/vrde/ethnode/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253709210,"owners_count":21951120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","ethereum","ethereum-node","geth","openethereum","smart-contracts"],"created_at":"2024-08-03T22:00:42.012Z","updated_at":"2026-01-24T05:14:35.846Z","avatar_url":"https://github.com/vrde.png","language":"JavaScript","funding_links":[],"categories":["Roadmap"],"sub_categories":[],"readme":"# `ethnode`, run an Ethereum node for test and development\n`ethnode` is a **zero configuration** tool to run a local Ethereum node. It supports both [Openethereum][openethereum] and [Geth][geth].\n\nTry it out:\n```\nnpm install -g ethnode\nethnode\n```\n\nOr docker:\n```\ndocker run -it ghcr.io/vrde/ethnode:latest\n```\n\n`ethnode` automatically:\n- downloads the latest stable version of `geth` or `openethereum`\n- configures `geth` or `openethereum` to run in a single node network using the *clique* (Geth) or *InstantSeal* (Openethereum) consensus engine (transactions are processed **instantly**)\n- provides 10 unlocked accounts with 100ETH each\n- enables all RPC endpoints (personal, db, eth, net, web3, debug and more)\n- allows CORS from any domain (so you can use it with [remix][remix])\n\nBy default `ethnode` runs `geth`. If you want to run `openethereum` type `ethnode openethereum`.\n\n# Examples\n\n## Start ethnode and store the data in a specific directory\nEvery time you run `ethnode`, it creates a new temporary directory to store the data. If you want to persist the data in a specific directory use:\n```\nethnode --workdir=mydata\n```\n\n## Start ethnode and allocate 100ETH to one or more target addresses\nSometimes you want to allocate Ether to some specific addresses (maybe some other accounts you have on MetaMask). This is an alternative approach to import a private key to your MetaMask extension.\n```\nethnode --allocate=0xad7b5e515e557b2dc4d0625d206394b502412003,0xecdd5b467e38731bfad4bd75faa45c7d58e41b49\n```\n\n## Start ethnode to run some tests and then exit\nThis is quite handy if you want to have a precommit hook that runs tests before committing, or if you want to integrate with a continuous integration system like travis.\n\n```\nethnode --execute=\"truffle test\"\n```\n\n## Start\n\n## FAQ\n### Why not just running `openethereum --config dev`?\nOpenethereum has a nice feature to run it as a [private development chain][openethereum:devchain] (aka *test RPC*).\n\nWhile testing it, I run into some problems, like:\n- address management\n- outdated genesis file\n- the default configuration (`--config dev`) doesn't:\n  - open up CORS\n  - unlock the test keys\n\n### Why not just running `geth --dev`?\nMore or less for the same reasons mentioned above.\n\n### Why not `ganache-cli`?\nGanache sometimes is not enough.\n\n\n[openethereum]: https://github.com/openethereum/openethereum\n[geth]: https://github.com/ethereum/go-ethereum\n[openethereum:devchain]: https://openethereum.github.io/wiki/Private-development-chain\n[remix]: http://remix.ethereum.org/\n[geth-testnet]: https://hackernoon.com/setup-your-own-private-proof-of-authority-ethereum-network-with-geth-9a0a3750cda8\n[hudson:gas]: https://hudsonjameson.com/2017-06-27-accounts-transactions-gas-ethereum/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvrde%2Fethnode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvrde%2Fethnode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvrde%2Fethnode/lists"}