La collection de bibliothèques C ++ et d'outils pour Ethereum, anciennement connue sous le nom de projet CPP-Ethereum . Cela inclut le client Ethereum complet Aleth .
Le site de documentation Ethereum héberge la page d'accueil d'Aleth , qui a une section de démarrage rapide.
| Système opérateur | Statut |
|---|---|
| Ubuntu et macOS | |
| Fenêtre |
https://github.com/ethereum/aleth/releases
Aleth:
docker run ethereum/aleth --helpTesteth:
docker run ethereum/testeth --helpGit et GitHub sont utilisés pour maintenir le code source. Clone le référentiel par:
git clone --recursive https://github.com/ethereum/aleth.git
cd aleth L'option --recursive est importante. Il ordonne à Git de cloner des sous-modules supplémentaires pour construire le projet. Si vous avez manqué - l'option --recursive , vous pouvez corriger votre erreur avec git submodule update --init .
CMake est utilisé pour contrôler la configuration de construction du projet. La dernière version de CMake est requise (au moment de la rédaction de 3.9.3 est le minimum). Nous vous recommandons fortement d'installer CMake en téléchargeant et en déballant la distribution binaire de la dernière version disponible sur la page de téléchargement CMake .
Le package CMake disponible dans votre système d'exploitation peut également être installé et utilisé s'il répond aux exigences de version minimale.
Méthode alternative
Le référentiel contient le script scripts / install_cmake.sh qui télécharge une version fixe de CMake et le déballe dans le préfixe du répertoire donné. Exemple d'utilisation:
scripts/install_cmake.sh --prefix /usr/local.
Configurez la construction du projet avec la commande suivante pour créer le répertoire build avec la configuration.
mkdir build ; cd build # Create a build directory.
cmake .. # Configure the project.
cmake --build . # Build all default targets. Sur Windows, nous prenons en charge Visual Studio 2017 et 2019. Vous devriez générer un fichier de solution Visual Studio ( .sln ) pour l'architecture 64 bits via la commande suivante:
cmake .. -G "Visual Studio 15 2017 Win64"cmake .. -G "Visual Studio 16 2019" -A x64 Une fois que les dépendances nécessaires ont été téléchargées et construites et que la solution a été générée, aleth.sln peut être trouvé dans le répertoire build .
RC.EXE est le compilateur de ressources Microsoft. Il est distribué avec le SDK Windows et est requis pour générer le fichier de solution Visual Studio. Il peut être trouvé dans le répertoire suivant: %ProgramFiles(x86)%Windows Kits<OS major version>bin<OS full version><arch>
Si vous appuyez sur cette erreur, l'ajout du répertoire à votre chemin (et le lancement d'une nouvelle invite de commande) devrait résoudre le problème.
La base de code actuelle est le travail de très nombreuses mains, avec plus de 100 contributeurs individuels au cours de son développement.
Notre chat de développement quotidien se produit sur la chaîne Aleth Gitter.
Toutes les contributions sont les bienvenues! Nous essayons de conserver une liste de tâches adaptées aux nouveaux arrivants dans le cadre de la tag de l'aide. Si vous avez des questions, n'hésitez pas à nous poser des questions sur plus d'informations.
Veuillez lire soigneusement la contribution et le coding_style avant d'apporter des modifications à la base de code.
Tout le développement va dans la branche de développement.
Remarque: Ce qui suit est la sortie de ./aleth -h [--help] sur 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 [<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
--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, 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).
Channels: block blockhdr bq chain client debug discov error ethcap exec host impolite info net overlaydb p2pcap peer
rlpx rpc snap statedb sync timer tq trace vmtrace warn warpcap watch
--log-exclude-channels <channel_list> Space-separated list of the log channels to hide.
--log-vmtrace Enable VM trace log (requires log-verbosity 4).
GENERAL OPTIONS:
-d [ --data-dir ] <path> Load configuration files and keystore from path (default: $HOME/.ethereum)
-V [ --version ] Show the version and exit
-h [ --help ] Show this help message and exit
Le projet Aleth comprend les outils suivants en plus du client Aleth:
Ce projet ne convient pas à l'extraction d'Ethereum car le support de l'exploitation de GPU a été abandonné il y a quelque temps, y compris l'outil ethminer. Utilisez l'outil ethmin de https://github.com/ethereum-mining/ethmin.
Des détails sur la façon d'exécuter et de déboguer les tests peuvent être trouvés ici
Toutes les contributions sont faites dans le cadre de la licence publique générale GNU V3. Voir la licence.