# aleth **Repository Path**: liunix61/aleth ## Basic Information - **Project Name**: aleth - **Description**: Aleth – Ethereum C++ client, tools and libraries - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2020-06-17 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Aleth – Ethereum C++ client, tools and libraries > The collection of C++ libraries and tools for Ethereum, > formerly known as _cpp-ethereum_ project. > This includes the full Ethereum client **aleth**. ## Contact [![Gitter](https://img.shields.io/gitter/room/ethereum/aleth.svg)](https://gitter.im/ethereum/aleth) [![GitHub Issues](https://img.shields.io/github/issues-raw/ethereum/aleth.svg)](https://github.com/ethereum/aleth/issues) - Chat in [aleth channel on Gitter](https://gitter.im/ethereum/aleth). - Report bugs, issues or feature requests using [GitHub issues](https://github.com/ethereum/aleth/issues/new). ## Usage The Ethereum Documentation site hosts the **[aleth homepage](http://cpp-ethereum.org)**, which has a Quick Start section. Operating system | Status ---------------- | ---------- Ubuntu and macOS | [![TravisCI](https://img.shields.io/travis/ethereum/aleth/develop.svg)](https://travis-ci.org/ethereum/aleth) Windows | [![AppVeyor](https://img.shields.io/appveyor/ci/ethereum/cpp-ethereum/develop.svg)](https://ci.appveyor.com/project/ethereum/cpp-ethereum) ## Install ### Download release binaries https://github.com/ethereum/aleth/releases ### Using docker images Aleth: ```bash docker run ethereum/aleth --help ``` Testeth: ```bash docker run ethereum/testeth --help ``` ### Building from source #### Get the source code Git and GitHub are used to maintain the source code. Clone the repository by: ```shell git clone --recursive https://github.com/ethereum/aleth.git cd aleth ``` The `--recursive` option is important. It orders git to clone additional submodules to build the project. If you missed `--recursive` option, you are able to correct your mistake with command `git submodule update --init`. #### Install CMake CMake is used to control the build configuration of the project. Latest version of CMake is required (at the time of writing [3.9.3 is the minimum](CMakeLists.txt#L5)). We strongly recommend you to install CMake by downloading and unpacking the binary distribution of the latest version available on the [**CMake download page**](https://cmake.org/download/). The CMake package available in your operating system can also be installed and used if it meets the minimum version requirement. > **Alternative method** > > The repository contains the [scripts/install_cmake.sh](scripts/install_cmake.sh) script that downloads > a fixed version of CMake and unpacks it to the given directory prefix. > Example usage: `scripts/install_cmake.sh --prefix /usr/local`. #### Build Configure the project build with the following command to create the `build` directory with the configuration. ```shell mkdir build; cd build # Create a build directory. cmake .. # Configure the project. cmake --build . # Build all default targets. ``` On **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: * **Visual Studio 2017**: `cmake .. -G "Visual Studio 15 2017 Win64"` * **Visual Studio 2019**: `cmake .. -G "Visual Studio 16 2019" -A x64` After the necessary dependencies have been downloaded and built and the solution has been generated, `aleth.sln` can be found in the `build` directory. #### Common Issues Building on Windows ##### LINK : fatal error LNK1158: cannot run 'rc.exe' Rc.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\\bin\\\``` If you hit this error, adding the directory to your path (and launching a new command prompt) should fix the issue. ## Contribute [![Contributors](https://img.shields.io/github/contributors/ethereum/aleth.svg)](https://github.com/ethereum/aleth/graphs/contributors) [![Gitter](https://img.shields.io/gitter/room/ethereum/aleth.svg)](https://gitter.im/ethereum/aleth) [![up-for-grabs](https://img.shields.io/github/issues-raw/ethereum/aleth/help%20wanted.svg)](https://github.com/ethereum/aleth/labels/help%20wanted) The current codebase is the work of many, many hands, with over 100 [individual contributors](https://github.com/ethereum/aleth/graphs/contributors) over the course of its development. Our day-to-day development chat happens on the [aleth](https://gitter.im/ethereum/aleth) Gitter channel. All contributions are welcome! We try to keep a list of tasks that are suitable for newcomers under the tag [help wanted](https://github.com/ethereum/aleth/labels/help%20wanted). If you have any questions, please do not hesitate to ask us about more information. Please read [CONTRIBUTING](CONTRIBUTING.md) and [CODING_STYLE](CODING_STYLE.md) thoroughly before making alterations to the code base. All development goes in develop branch. ## Usage *Note: The following is the output of ```./aleth -h [--help]``` on Linux* ``` NAME: aleth 1.7.2 USAGE: aleth [options] WALLET USAGE: account list List all keys available in wallet account new Create a new key and add it to wallet account update [|
, ... ] Decrypt and re-encrypt keys account import [||] Import keys from given source and place in wallet wallet import Import a presale wallet CLIENT MODE (default): --mainnet Use the main network protocol --ropsten Use the Ropsten testnet --test Testing mode; disable PoW and provide test rpc interface --config Configure specialised blockchain using given JSON information --ipc Enable IPC server (default: on) --ipcpath Set .ipc socket path (default: data directory) --no-ipc Disable IPC server --admin Specify admin session key for JSON-RPC (default: auto-generated and printed at start-up) -K [ --kill ] Kill the blockchain first -R [ --rebuild ] Rebuild the blockchain from the existing database --rescue Attempt to rescue a corrupt database --import-presale Import a pre-sale key; you'll need to specify the password to this key -s [ --import-secret ] Import a secret key into the key store -S [ --import-session-secret ] Import a secret session into the key store --master Give the master password for the key store; use --master "" to show a prompt --password Give a password for a private key CLIENT TRANSACTING: --ask Set the minimum ask gas price under which no transaction will be mined (default: 20000000000) --bid Set the bid gas price to pay for transactions (default: 20000000000) --unsafe-transactions Allow all transactions to proceed without verification; EXTREMELY UNSAFE CLIENT NETWORKING: -b [ --bootstrap ] Connect to the default Ethereum peer servers (default unless --no-discovery used) --no-bootstrap Do not connect to the default Ethereum peer servers (default only when --no-discovery is used) -x [ --peers ] Attempt to connect to a given number of peers (default: 11) --peer-stretch Give the accepted connection multiplier (default: 7) --public-ip Force advertised public IP to the given IP (default: auto) --listen-ip (:) Listen on the given IP for incoming connections (default: 0.0.0.0) --listen Listen on the given port for incoming connections (default: 30303) -r [ --remote ] (:) Connect to the given remote host (default: none) --port Connect to the given remote port (default: 30303) --network-id Only connect to other hosts with this network id --allow-local-discovery Include local addresses in the discovery process. Used for testing purposes. --peerset Comma delimited list of peers; element format: type:enode://publickey@ipAddress[:port[?discport=port]] Types: default Attempt connection when no other peers are available and pinning is disabled required Keep connected at all times Ports: The first port argument is the tcp port used for direct communication among peers. If the second port argument isn't supplied, the first port argument will also be the udp port used for node discovery. If neither the first nor second port arguments are supplied, a default port of 30303 will be used for both peer communication and node discovery. --no-discovery Disable node discovery; implies --no-bootstrap --pin Only accept or connect to trusted peers CLIENT MINING: -a [ --address ] Set the author (mining payout) address (default: auto) -m [ --mining ] Enable mining; optionally for a specified number of blocks (default: off) --extra-data arg Set extra data for the sealed blocks BENCHMARKING MODE: -M [ --benchmark ] Benchmark for mining and exit --benchmark-warmup Set the duration of warmup for the benchmark tests (default: 3) --benchmark-trial Set the duration for each trial for the benchmark tests (default: 3) --benchmark-trials Set the number of trials for the benchmark tests (default: 5) MINING CONFIGURATION: -C [ --cpu ] When mining, use the CPU -t [ --mining-threads ] Limit number of CPU/GPU miners to n (default: use everything available on selected platform) --current-block Let the miner know the current block number at configuration time. Will help determine DAG size and required GPU memory --disable-submit-hashrate When mining, don't submit hashrate to node IMPORT/EXPORT MODES: -I [ --import ] Import blocks from file -E [ --export ] Export blocks to file --from Export only from block n; n may be a decimal, a '0x' prefixed hash, or 'latest' --to Export only to block n (inclusive); n may be a decimal, a '0x' prefixed hash, or 'latest' --only Equivalent to --export-from n --export-to n --format Set export format --dont-check Prevent checking some block aspects. Faster importing, but to apply only when the data is known to be valid --download-snapshot Download Parity Warp Sync snapshot data to the specified path --import-snapshot Import blockchain and state data from the Parity Warp Sync snapshot DATABASE OPTIONS: --db (=leveldb) Select database implementation. Available options are: leveldb, memorydb. --db-path (=$HOME/.ethereum) Database path (for non-memory database options) VM OPTIONS: --vm | (=legacy) Select VM implementation. Available options are: interpreter, legacy. --evmc