This repository is an umbrella repository with git sub-module references to all of the components of cpp-ethereum, the Ethereum C++ client. The project was initiated by Gavin Wood, the former CTO of the Ethereum Foundation, in December 2013. It is the second most popular of the clients with around 5% of 'market share', trailing a long way behind go-ethereum.

Read more about the project at our swanky new website.

      | Status

----------|----------- develop | release |

The current codebase is the work of many, many hands, with probably close to 100 individual contributors over the course of its development. Perhaps we will write a script to maintain a 'credits list' at some stage? In the meantime, here are all of the per-repo contributions:

• alethzero
• cpp-dependencies
• cpp-ethereum
• evmjit
• homebrew-ethereum
• libethereum
• libweb3core
• solidity
• web3.js
• webthree
• webthree-helpers
• webthree-umbrella

The following individuals are currently employed or contracted by the Ethereum Foundation for C++ client work:

• Greg Colvin
• Liana Husikyan
• Dimitry Khoklov
• Yann Levreau
• Christian Reitwiessner - C++ Lead
• Bob Summerwill

To run the tests, make sure you clone github.com/ethereum/tests and point the environment variable ETHEREUM_TEST_PATH to that path.

External contributions are more than welcome! We try to keep a list of tasks that are suitable for newcomers under the tag good first task. If you have any questions, please ask in our gitter channel.

Please refer to the file CONTRIBUTING.md for some guidelines.

All new contributions are added under the MIT License. Please refer to the LICENSE file in the root directory. To state that you accept this fact for all of your contributions please add yourself to the list of external contributors like in the example below.

All new contributions are under the MIT license. See LICENSE. Some old contributions are under the GPLv3 license. See GPLV3_LICENSE.

I hereby place all my contributions in this codebase under an MIT licence, as specified here.

• Name Surname (email@domain)

Please add yourself in the @author doxygen section of the file your are adding/editing with the same wording as the one you listed yourself in the external contributors section above, only replacing the word contribution by file

All development goes in develop branch - please don't submit pull requests to master.

Please read CodingStandards.txt thoroughly before making alterations to the code base. Please do NOT use an editor that automatically reformats whitespace away from astylerc or the formatting guidelines as described in CodingStandards.txt.

libweb3jsonrpc/abstractwebthreestubserver.h is autogenerated from the jsonrpcstub executable that comes with the libjsonrpc library (json-rpc-cpp project). It shouldn't be maually altered.

jsonrpcstub spec.json --cpp-server=AbstractWebThreeStubServer