Aleth -- 以太坊 C++ 客户端、工具和库
Ethereum 的 c++ 库和工具的集合,以前称为 pap-Ethereum 项目。这包括完整的以太客户端 aleth。
联系
- 在 Gitter上的第5频道聊天。
- 使用 GitHub问题报告错误,问题或功能请求。
用法
以太坊文档网站提供 aleth主页, 有一个快速入门部分。
安装
下载发布二进制文件
https://github.com/ethereum/aleth/releases
使用 docker 映像
Aleth:
docker run ethereum/aleth --help
Testeth:
docker run ethereum/testeth --help
从源文件构建
获取源代码
Git 和 GitHub 用于维护源代码。通过以下方式克隆存储库:
git clone --recursive https://github.com/ethereum/aleth.git cd aleth
--recursive 选项很重要。它命令 git 克隆其他子模块以构建项目。如果您错过了--recursive 选项,您可以使用命令 git submodule update --init 更正错误。
安装CMake
CMake用于控制项目的构建配置。需要最新版本的 CMake(在撰写本文时,3.9.3是最低版本)。我们强烈建议您通过下载和解压缩 CMake下载页面上提供的最新版本的二进制发行版来安装 CMake。
如果满足最低版本要求,也可以安装和使用操作系统中提供的CMake软件包。
替代方法
存储库包含 scripts/install_cmake.sh 脚本,该脚本下载固定版本的 CMake 并将其解压缩到给定的目录前缀。用法示例:scripts/install_cmake.sh --prefix/usr/local。
安装依赖项(Windows)
我们提供预构建的依赖项来构建项目。使用 scripts\install_deps.bat 脚本下载它们。
scripts\install_deps.bat
构建
使用以下命令配置项目构建,以使用配置创建构建目录。
mkdir build; cd build # Create a build directory. cmake .. # Configure the project. cmake --build . # Build all default targets.
在 Windows 上 Visual Studio 2015 是必需的。您应该通过向 CMake configure 命令添加 -G "Visual Studio 14 2015 Win64" 参数来为64位体系结构生成 Visual Studio 解决方案文件(.sln)。配置完成后,可以在构建目录中找到 aleth.sln。
cmake .. -G "Visual Studio 14 2015 Win64"
在 Windows 上构建的常见问题
链接:致命错误LNK1158:无法运行'rc.exe'
Rc.exe 是 Microsoft 资源编译器。它随 Windows SDK 一起分发,是生成 Visual Studio 解决方案文件所必需的。它可以在以下目录中找到:%ProgramFiles(x86)%\Windows Kits\
如果您遇到此错误,将目录添加到路径(并启动新的命令提示符)应解决此问题。
用法
注意:以下是在 Linux 上 ./aleth -h [-help] 的输出
NAME: aleth 1.5.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 [<uuid>|<address> , ... ] Decrypt and re-encrypt keys account import [<uuid>|<file>|<secret-hex>] Import keys from given source and place in wallet wallet import <file> Import a presale wallet CLIENT MODE (default): --mainnet Use the main network protocol --ropsten Use the Ropsten testnet --private <name> Use a private chain --test Testing mode; disable PoW and provide test rpc interface --config <file> Configure specialised blockchain using given JSON information --ipc Enable IPC server (default: on) --ipcpath <path> Set .ipc socket path (default: data directory) --no-ipc Disable IPC server --admin <password> 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 <file> Import a pre-sale key; you'll need to specify the password to this key -s [ --import-secret ] <secret> Import a secret key into the key store -S [ --import-session-secret ] <secret> Import a secret session into the key store --master <password> Give the master password for the key store; use --master "" to show a prompt --password <password> Give a password for a private key CLIENT TRANSACTING: --ask <wei> Set the minimum ask gas price under which no transaction will be mined (default: 20000000000) --bid <wei> 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 ] <number> Attempt to connect to a given number of peers (default: 11) --peer-stretch <number> Give the accepted connection multiplier (default: 7) --public-ip <ip> Force advertised public IP to the given IP (default: auto) --listen-ip <ip>(:<port>) Listen on the given IP for incoming connections (default: 0.0.0.0) --listen <port> Listen on the given port for incoming connections (default: 30303) -r [ --remote ] <host>(:<port>) Connect to the given remote host (default: none) --port <port> Connect to the given remote port (default: 30303) --network-id <n> Only connect to other hosts with this network id --allow-local-discovery Include local addresses in the discovery process. Used for testing purposes. --peerset <list> 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 ] <addr> Set the author (mining payout) address (default: auto) -m [ --mining ] <on/off/number> 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 <seconds> Set the duration of warmup for the benchmark tests (default: 3) --benchmark-trial <seconds> Set the duration for each trial for the benchmark tests (default: 3) --benchmark-trials <n> Set the number of trials for the benchmark tests (default: 5) MINING CONFIGURATION: -C [ --cpu ] When mining, use the CPU -t [ --mining-threads ] <n> Limit number of CPU/GPU miners to n (default: use everything available on selected platform) --current-block <n> 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 ] <file> Import blocks from file -E [ --export ] <file> Export blocks to file --from <n> Export only from block n; n may be a decimal, a '0x' prefixed hash, or 'latest' --to <n> Export only to block n (inclusive); n may be a decimal, a '0x' prefixed hash, or 'latest' --only <n> Equivalent to --export-from n --export-to n --format <binary/hex/human> 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 <path> Download Parity Warp Sync snapshot data to the specified path --import-snapshot <path> Import blockchain and state data from the Parity Warp Sync snapshot DATABASE OPTIONS: --db <name> (=leveldb) Select database implementation. Available options are: leveldb, rocksdb, memorydb. --db-path <path> (=$HOME/.ethereum) Database path (for non-memory database options) VM OPTIONS: --vm <name>|<path> (=legacy) Select VM implementation. Available options are: interpreter, legacy. --evmc <option>=<value> EVMC option LOGGING OPTIONS: -v [ --log-verbosity ] <0 - 4> Set the log verbosity from 0 to 4 (default: 2). --log-channels <channel_list> Space-separated list of the log channels to show (default: show all channels). --log-exclude-channels <channel_list> Space-separated list of the log channels to hide. GENERAL OPTIONS: -d [ --data-dir ] <path> Load configuration files and keystore from path (default: /home/mwo2/.ethereum) -V [ --version ] Show the version and exit -h [ --help ] Show this help message and exit
挖矿
这个项目不适合以太坊挖掘,因为包括 ethminer 工具在内的 GPU 挖掘支持已经被淘汰了。 使用 https://github.com/ethereum-mining/ethminer 中的 ethminer 工具。
测试
有关如何运行和调试测试的详细信息,请参见此处。