forked from ethereum/staking-deposit-cli
-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
aa7d961
commit 395e9cd
Showing
10 changed files
with
132 additions
and
12 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,4 @@ | ||
[book] | ||
authors = ["valefar-on-discord"] | ||
language = "en" | ||
multilingual = false | ||
src = "src" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,8 +1,10 @@ | ||
# Summary | ||
|
||
- [Introduction](README.md) | ||
- [Ethstaker Deposit CLI](landing.md) | ||
- [Quick Setup](quick_setup.md) | ||
- [New Mnemonic](new_mnemonic.md) | ||
- [Existing Mnemonic](existing_mnemonic.md) | ||
- [Generate BLS to Execution Change](generate_bls_to_execution_change.md) | ||
- [Exit Transaction Keystore](exit_transaction_keystore.md) | ||
- [Exit Transaction Mnemonic](exit_transaction_mnemonic.md) | ||
- [Local Development](local_development.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -23,3 +23,4 @@ Creates an exit transaction using a mnemonic phrase. | |
|
||
```sh | ||
./deposit exit-transaction-mnemonic | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,46 @@ | ||
# Local Development Instructions | ||
|
||
To install the `ethstaker-deposit-cli`, follow these steps: | ||
|
||
## Prerequisites | ||
|
||
Ensure you have the following software installed on your system: | ||
|
||
- **Git**: Version control system to clone the repository. [Download Git](https://git-scm.com/downloads) | ||
- **Python 3.12+**: The programming language required to run the tool. [Download Python](https://www.python.org/downloads/) | ||
- **pip**: Package installer for Python, which is included with Python 3.12+. | ||
|
||
|
||
## Local Development Steps | ||
|
||
1. **Clone the Repository** | ||
|
||
```sh | ||
git clone https://github.com/eth-educators/ethstaker-deposit-cli.git | ||
``` | ||
|
||
2. **Navigate to the Project Directory** | ||
|
||
```sh | ||
cd ethstaker-deposit-cli | ||
``` | ||
|
||
3. **Install Dependencies** | ||
|
||
```sh | ||
pip3 install -r requirements.txt | ||
``` | ||
|
||
4. **Run the CLI** | ||
|
||
You can now run the CLI tool using the following command: | ||
|
||
```sh | ||
python3 -m ethstaker_deposit [OPTIONS] COMMAND [ARGS] | ||
``` | ||
|
||
**To execute tests, you will need to install the test dependencies**: | ||
```sh | ||
python3 -m pip install -r requirements_test.txt | ||
python3 -m pytest tests | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
# Quick Setup | ||
|
||
This guide will walk you through the steps to download and set up the `ethstaker-deposit-cli` for your operating system. | ||
|
||
## Step 1: Download the Latest Release | ||
|
||
1. Navigate to the [Releases page](https://github.com/eth-educators/ethstaker-deposit-cli/releases) of the `ethstaker-deposit-cli` repository. | ||
|
||
2. Download the corresponding file for your operating system: | ||
- **Windows**: Look for a file with `windows` in the name. | ||
- **MacOS**: Look for a file with `darwin` in the name. | ||
- **Linux**: Look for a file with `linux` in the name. | ||
|
||
3. Extract the contents of the zipped file | ||
|
||
4. Open a terminal or command prompt and navigate to the extracted folder | ||
|
||
|
||
## Step 2: Verify the Installation | ||
|
||
1. Make sure you have GPG installed. | ||
|
||
2. Make sure you have the `[email protected]` public key by running | ||
```sh | ||
gpg --keyserver keys.openpgp.org --search-keys '[email protected]' | ||
``` | ||
|
||
3. Verify the signature file against the corresponding file but be sure to replace the contents with the exact file name: | ||
```sh | ||
gpg --verify staking_deposit-cli-***.asc staking_deposit-cli-*** | ||
``` | ||
|
||
4. You should see `Good signature from "EDC Security <[email protected]>"` in the output **otherwise do not continue**. | ||
|
||
## Step 3: Usage | ||
|
||
**MacOS users:** In order to run from the terminal, you must first open the file to bypass MacOS code signing issues. Do so by right clicking the `deposit` file and then selecting `Open`. | ||
|
||
Determine which command best suites what you would like to accomplish: | ||
|
||
- **[new-mnemonic](new_mnemonic.md)**: Used to generate a new mnemonic, validator keys, and deposit file. It is not recommended to use this command if you have existing validators. | ||
|
||
- **[existing-mnemonic](existing_mnemonic.md)**: Provide a mnemonic to regenerate validator keys or create new ones. | ||
|
||
- **[generate-bls-to-execution-change](generate_bls_to_execution_change.md)**: Update your withdrawal credentials of existing validators. It is **required** to have the corresponding mnemonic. | ||
|
||
- **[exit-transaction-keystore](exit_transaction_keystore.md)**: Generate an exit message using the keystore of your validators. | ||
|
||
- **[exit-transaction-mnemonic](exit_transaction_mnemonic.md)**: Generate an exit message using the mnemonic of your validators. | ||
|
||
--- | ||
|
||
If you encounter any issues, please check the [issues page](https://github.com/eth-educators/ethstaker-deposit-cli/issues) for help or to report a problem. You may also contact us on the [Ethstaker discord](https://dsc.gg/ethstaker). |