{"id":13417840,"url":"https://github.com/ethereum/aleth","last_synced_at":"2025-09-30T08:31:18.949Z","repository":{"id":12787008,"uuid":"15460666","full_name":"ethereum/aleth","owner":"ethereum","description":"Aleth – Ethereum C++ client, tools and libraries","archived":true,"fork":false,"pushed_at":"2024-03-05T10:53:01.000Z","size":58058,"stargazers_count":3966,"open_issues_count":340,"forks_count":2168,"subscribers_count":469,"default_branch":"master","last_synced_at":"2025-01-06T10:04:38.886Z","etag":null,"topics":["cpp","ethereum","ethereum-client","evm"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ethereum.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-12-26T21:26:06.000Z","updated_at":"2025-01-03T21:43:54.000Z","dependencies_parsed_at":"2024-06-19T02:54:59.021Z","dependency_job_id":"365c6ac9-5d67-4d64-9af9-d5b06e2c802d","html_url":"https://github.com/ethereum/aleth","commit_stats":{"total_commits":22111,"total_committers":211,"mean_commits":104.7914691943128,"dds":0.7721948351499254,"last_synced_commit":"5d1078ac43e0e2eaffb6e58300686d20a0bfb512"},"previous_names":["ethereum/cpp-ethereum"],"tags_count":69,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethereum%2Faleth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethereum%2Faleth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethereum%2Faleth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethereum%2Faleth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ethereum","download_url":"https://codeload.github.com/ethereum/aleth/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234719349,"owners_count":18876523,"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":["cpp","ethereum","ethereum-client","evm"],"created_at":"2024-07-30T22:00:53.712Z","updated_at":"2025-09-30T08:31:18.241Z","avatar_url":"https://github.com/ethereum.png","language":"C++","readme":"# Aleth – Ethereum C++ client, tools and libraries\n\n\u003e The collection of C++ libraries and tools for Ethereum,\n\u003e formerly known as _cpp-ethereum_ project.\n\u003e This includes the full Ethereum client **aleth**.\n\n## ⚠️ **This project has been discontinued and is no longer maintained.** \n\n## Contact\n\n[![Gitter](https://img.shields.io/gitter/room/ethereum/aleth.svg)](https://gitter.im/ethereum/aleth)\n[![GitHub Issues](https://img.shields.io/github/issues-raw/ethereum/aleth.svg)](https://github.com/ethereum/aleth/issues)\n\n- Chat in [aleth channel on Gitter](https://gitter.im/ethereum/aleth).\n- Report bugs, issues or feature requests using [GitHub issues](https://github.com/ethereum/aleth/issues/new).\n\n\n## Usage\n\nThe Ethereum Documentation site hosts the **[aleth homepage](http://cpp-ethereum.org)**, which\nhas a Quick Start section.\n\n\nOperating system | Status\n---------------- | ----------\nUbuntu and macOS | [![TravisCI](https://img.shields.io/travis/ethereum/aleth/develop.svg)](https://travis-ci.org/ethereum/aleth)\nWindows          | [![AppVeyor](https://img.shields.io/appveyor/ci/ethereum/cpp-ethereum/develop.svg)](https://ci.appveyor.com/project/ethereum/cpp-ethereum)\n\n\n## Install\n\n### Download release binaries\n\nhttps://github.com/ethereum/aleth/releases\n\n### Using docker images\n\nAleth:\n```bash\ndocker run ethereum/aleth --help\n```\n\nTesteth:\n```bash\ndocker run ethereum/testeth --help\n```\n\n### Building from source\n\n#### Get the source code\n\nGit and GitHub are used to maintain the source code. Clone the repository by:\n\n```shell\ngit clone --recursive https://github.com/ethereum/aleth.git\ncd aleth\n```\n\nThe `--recursive` option is important. It orders git to clone additional\nsubmodules to build the project.\nIf you missed `--recursive` option, you are able to correct your mistake with command\n`git submodule update --init`.\n\n#### Install CMake\n\nCMake is used to control the build configuration of the project. Latest version of CMake is required\n(at the time of writing [3.9.3 is the minimum](CMakeLists.txt#L5)).\nWe strongly recommend you to install CMake by downloading and unpacking the binary\ndistribution  of the latest version available on the\n[**CMake download page**](https://cmake.org/download/).\n\nThe CMake package available in your operating system can also be installed\nand used if it meets the minimum version requirement.\n\n\u003e **Alternative method**\n\u003e\n\u003e The repository contains the\n[scripts/install_cmake.sh](scripts/install_cmake.sh) script that downloads\n\u003e a fixed version of CMake and unpacks it to the given directory prefix.\n\u003e Example usage: `scripts/install_cmake.sh --prefix /usr/local`.\n\n#### Build\n\nConfigure the project build with the following command to create the\n`build` directory with the configuration.\n\n```shell\nmkdir build; cd build  # Create a build directory.\ncmake ..               # Configure the project.\ncmake --build .        # Build all default targets.\n```\n\nOn **Windows** we support Visual Studio 2017, and 2019. You should generate a Visual Studio solution file (`.sln`) for the 64-bit architecture via the following command:\n\n* **Visual Studio 2017**: `cmake .. -G \"Visual Studio 15 2017 Win64\"`\n* **Visual Studio 2019**: `cmake .. -G \"Visual Studio 16 2019\" -A x64`\n\nAfter the necessary dependencies have been downloaded and built and the solution has been generated, `aleth.sln` can be found in the\n`build` directory.\n\n#### Common Issues Building on Windows\n##### LINK : fatal error LNK1158: cannot run 'rc.exe'\nRc.exe is the [Microsoft Resource Compiler](https://docs.microsoft.com/en-us/windows/desktop/menurc/resource-compiler). It's distributed with the [Windows SDK](https://developer.microsoft.com/en-US/windows/downloads/windows-10-sdk) and is required for generating the Visual Studio solution file. It can be found in the following directory: ```%ProgramFiles(x86)%\\Windows Kits\\\u003cOS major version\u003e\\bin\\\u003cOS full version\u003e\\\u003carch\u003e\\```\n\nIf you hit this error, adding the directory to your path (and launching a new command prompt) should fix the issue.\n\n## Contribute\n\n[![Contributors](https://img.shields.io/github/contributors/ethereum/aleth.svg)](https://github.com/ethereum/aleth/graphs/contributors)\n[![Gitter](https://img.shields.io/gitter/room/ethereum/aleth.svg)](https://gitter.im/ethereum/aleth)\n[![up-for-grabs](https://img.shields.io/github/issues-raw/ethereum/aleth/help%20wanted.svg)](https://github.com/ethereum/aleth/labels/help%20wanted)\n\nThe current codebase is the work of many, many hands, with over 100\n[individual contributors](https://github.com/ethereum/aleth/graphs/contributors) over the course of its development.\n\nOur day-to-day development chat happens on the\n[aleth](https://gitter.im/ethereum/aleth) Gitter channel.\n\nAll contributions are welcome! We try to keep a list of tasks that are suitable\nfor newcomers under the tag\n[help wanted](https://github.com/ethereum/aleth/labels/help%20wanted).\nIf you have any questions, please do not hesitate to ask us about more information.\n\nPlease read [CONTRIBUTING](CONTRIBUTING.md) and [CODING_STYLE](CODING_STYLE.md)\nthoroughly before making alterations to the code base.\n\nAll development goes in develop branch.\n\n## Usage\n*Note: The following is the output of ```./aleth -h [--help]``` on Linux*\n\n```\nNAME:\n   aleth 1.7.2\nUSAGE:\n   aleth [options]\n\nWALLET USAGE:\n   account list                                List all keys available in wallet\n   account new                                 Create a new key and add it to wallet\n   account update [\u003cuuid\u003e|\u003caddress\u003e , ... ]    Decrypt and re-encrypt keys\n   account import [\u003cuuid\u003e|\u003cfile\u003e|\u003csecret-hex\u003e] Import keys from given source and place in wallet\n   wallet import \u003cfile\u003e                        Import a presale wallet\n\nCLIENT MODE (default):\n  --mainnet                               Use the main network protocol\n  --ropsten                               Use the Ropsten testnet\n  --test                                  Testing mode; disable PoW and provide test rpc interface\n  --config \u003cfile\u003e                         Configure specialised blockchain using given JSON information\n\n  --ipc                                   Enable IPC server (default: on)\n  --ipcpath \u003cpath\u003e                        Set .ipc socket path (default: data directory)\n  --no-ipc                                Disable IPC server\n  --admin \u003cpassword\u003e                      Specify admin session key for JSON-RPC (default: auto-generated and printed at start-up)\n  -K [ --kill ]                           Kill the blockchain first\n  -R [ --rebuild ]                        Rebuild the blockchain from the existing database\n  --rescue                                Attempt to rescue a corrupt database\n\n  --import-presale \u003cfile\u003e                 Import a pre-sale key; you'll need to specify the password to this key\n  -s [ --import-secret ] \u003csecret\u003e         Import a secret key into the key store\n  -S [ --import-session-secret ] \u003csecret\u003e Import a secret session into the key store\n  --master \u003cpassword\u003e                     Give the master password for the key store; use --master \"\" to show a prompt\n  --password \u003cpassword\u003e                   Give a password for a private key\n\nCLIENT TRANSACTING:\n  --ask \u003cwei\u003e            Set the minimum ask gas price under which no transaction will be mined (default: 20000000000)\n  --bid \u003cwei\u003e            Set the bid gas price to pay for transactions (default: 20000000000)\n  --unsafe-transactions  Allow all transactions to proceed without verification; EXTREMELY UNSAFE\n\nCLIENT NETWORKING:\n  -b [ --bootstrap ]              Connect to the default Ethereum peer servers (default unless --no-discovery used)\n  --no-bootstrap                  Do not connect to the default Ethereum peer servers (default only when --no-discovery is used)\n  -x [ --peers ] \u003cnumber\u003e         Attempt to connect to a given number of peers (default: 11)\n  --peer-stretch \u003cnumber\u003e         Give the accepted connection multiplier (default: 7)\n  --public-ip \u003cip\u003e                Force advertised public IP to the given IP (default: auto)\n  --listen-ip \u003cip\u003e(:\u003cport\u003e)       Listen on the given IP for incoming connections (default: 0.0.0.0)\n  --listen \u003cport\u003e                 Listen on the given port for incoming connections (default: 30303)\n  -r [ --remote ] \u003chost\u003e(:\u003cport\u003e) Connect to the given remote host (default: none)\n  --port \u003cport\u003e                   Connect to the given remote port (default: 30303)\n  --network-id \u003cn\u003e                Only connect to other hosts with this network id\n  --allow-local-discovery         Include local addresses in the discovery process. Used for testing purposes.\n  --peerset \u003clist\u003e                Comma delimited list of peers; element format: type:enode://publickey@ipAddress[:port[?discport=port]]\n                                          Types:\n                                          default     Attempt connection when no other peers are available and pinning is disabled\n                                          required    Keep connected at all times\n\n                                          Ports:\n                                          The first port argument is the tcp port used for direct communication among peers. If the second port\n                                          argument isn't supplied, the first port argument will also be the udp port used for node discovery.\n                                          If neither the first nor second port arguments are supplied, a default port of 30303 will be used for\n                                          both peer communication and node discovery.\n  --no-discovery                  Disable node discovery; implies --no-bootstrap\n  --pin                           Only accept or connect to trusted peers\n\nCLIENT MINING:\n  -a [ --address ] \u003caddr\u003e         Set the author (mining payout) address (default: auto)\n  -m [ --mining ] \u003con/off/number\u003e Enable mining; optionally for a specified number of blocks (default: off)\n  --extra-data arg                Set extra data for the sealed blocks\n\nBENCHMARKING MODE:\n  -M [ --benchmark ]           Benchmark for mining and exit\n  --benchmark-warmup \u003cseconds\u003e Set the duration of warmup for the benchmark tests (default: 3)\n  --benchmark-trial \u003cseconds\u003e  Set the duration for each trial for the benchmark tests (default: 3)\n  --benchmark-trials \u003cn\u003e       Set the number of trials for the benchmark tests (default: 5)\n\nMINING CONFIGURATION:\n  -C [ --cpu ]                 When mining, use the CPU\n  -t [ --mining-threads ] \u003cn\u003e  Limit number of CPU/GPU miners to n (default: use everything available on selected platform)\n  --current-block \u003cn\u003e          Let the miner know the current block number at configuration time. Will help determine DAG size and required GPU memory\n  --disable-submit-hashrate    When mining, don't submit hashrate to node\n\nIMPORT/EXPORT MODES:\n  -I [ --import ] \u003cfile\u003e      Import blocks from file\n  -E [ --export ] \u003cfile\u003e      Export blocks to file\n  --from \u003cn\u003e                  Export only from block n; n may be a decimal, a '0x' prefixed hash, or 'latest'\n  --to \u003cn\u003e                    Export only to block n (inclusive); n may be a decimal, a '0x' prefixed hash, or 'latest'\n  --only \u003cn\u003e                  Equivalent to --export-from n --export-to n\n  --format \u003cbinary/hex/human\u003e Set export format\n  --dont-check                Prevent checking some block aspects. Faster importing, but to apply only when the data is known to be valid\n  --download-snapshot \u003cpath\u003e  Download Parity Warp Sync snapshot data to the specified path\n  --import-snapshot \u003cpath\u003e    Import blockchain and state data from the Parity Warp Sync snapshot\n\nDATABASE OPTIONS:\n  --db \u003cname\u003e (=leveldb)      Select database implementation. Available options are: leveldb, memorydb.\n  --db-path \u003cpath\u003e (=$HOME/.ethereum) Database path (for non-memory database options)\n\nVM OPTIONS:\n  --vm \u003cname\u003e|\u003cpath\u003e (=legacy) Select VM implementation. Available options are: interpreter, legacy.\n  --evmc  \u003coption\u003e=\u003cvalue\u003e     EVMC option\n\nLOGGING OPTIONS:\n  -v [ --log-verbosity ] \u003c0 - 4\u003e        Set the log verbosity from 0 to 4 (default: 2).\n  --log-channels \u003cchannel_list\u003e         Space-separated list of the log channels to show (default: show all channels).\n                                        Channels: block blockhdr bq chain client debug discov error ethcap exec host impolite info net overlaydb p2pcap peer\n                                        rlpx rpc snap statedb sync timer tq trace vmtrace warn warpcap watch\n  --log-exclude-channels \u003cchannel_list\u003e Space-separated list of the log channels to hide.\n\n  --log-vmtrace                         Enable VM trace log (requires log-verbosity 4).\n\nGENERAL OPTIONS:\n  -d [ --data-dir ] \u003cpath\u003e Load configuration files and keystore from path (default: $HOME/.ethereum)\n  -V [ --version ]         Show the version and exit\n  -h [ --help ]            Show this help message and exit\n```\n\n## Tools\nThe Aleth project includes the following tools in addition to the Aleth client:\n* **[aleth-bootnode](aleth-bootnode/)**: A C++ Ethereum discovery bootnode implementation\n* **[aleth-key](aleth-key/)**: A rudimentary wallet\n* **[aleth-vm](aleth-vm/)**: An EVM bytecode runner tool\n* **[rlp](rlp/)**: A RLP encoder/decoder tool\n* **[testeth](test/)**: A consensus test generator/runner tool\n\n## Mining\n\nThis project is **not suitable for Ethereum mining** because the support for GPU mining\nhas been dropped some time ago including the ethminer tool. Use the ethminer tool from https://github.com/ethereum-mining/ethminer.\n\n## Testing\nDetails on how to run and debug the tests can be found [here](doc/usingtesteth.rst)\n\n## Documentation\n\n- [Internal documentation for developers](doc/index.rst).\n- [Outdated documentation for end users](http://www.ethdocs.org/en/latest/ethereum-clients/cpp-ethereum/).\n\n## License\n\n[![License](https://img.shields.io/github/license/ethereum/aleth.svg)](LICENSE)\n\nAll contributions are made under the [GNU General Public License v3](https://www.gnu.org/licenses/gpl-3.0.en.html). See [LICENSE](LICENSE).\n","funding_links":[],"categories":["TODO scan for Android support in followings","C++","C++/QML"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethereum%2Faleth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fethereum%2Faleth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethereum%2Faleth/lists"}