-
Notifications
You must be signed in to change notification settings - Fork 152
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add Mordor Mining Guide #588
base: master
Are you sure you want to change the base?
Conversation
chris-mercer
commented
Nov 21, 2023
- Update Build from Source: Go version and Installation instructions
- Update Installation: Fix broken link, Add --classic flags and Installation instructions
- Add Mordor Mining Guide
- Spiral upgrade release
- Spiral Upgrade release
|
||
```shell | ||
$ wget https://github.com/etclabscore/core-geth/releases/download/v1.12.17/core-geth-linux-v1.12.17.zip # Update to the most current release version | ||
$ sudo unzip core-geth-linux-v1.12.17.zip -d /bin/ # Update to the most current release version |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Normally the best place for user-installed programs is in /usr/local/bin
.
https://unix.stackexchange.com/questions/8656/usr-bin-vs-usr-local-bin-on-linux
$ sudo unzip core-geth-linux-v1.12.17.zip -d /bin/ # Update to the most current release version | |
$ sudo unzip core-geth-linux-v1.12.17.zip -d /usr/local/bin # Update to the most current release version |
Here and other places.
|
||
Binary archives are published at https://github.com/etclabscore/core-geth/releases. Find the latest one for your OS, download it, (check the SHA sum), unarchive it, and run! | ||
|
||
Tip: When running Core-geth use `--classic` flag for Ethereum Classic mainnet. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How about we use the markdown !!! tip
s instead for these Tip:
s?
Tip: When running Core-geth use `--classic` flag for Ethereum Classic mainnet. | |
!!! tip "Run Ethereum Classic" | |
When running Core-geth use `--classic` flag for Ethereum Classic mainnet. |
@@ -3,14 +3,31 @@ title: Installation | |||
--- | |||
|
|||
!!! tip "Build from Source" | |||
Instructions to build from source can be found [here](core-geth/developers/build-from-source/). | |||
Instructions to build from source can be found [here](https://etclabscore.github.io/core-geth/developers/build-from-source/) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Will it work to use a relative path instead? That'd be a little less brittle.
Instructions to build from source can be found [here](https://etclabscore.github.io/core-geth/developers/build-from-source/) | |
Instructions to build from source can be found [here](./core-geth/developers/build-from-source/) |
--- | ||
|
||
!!! tip "Mordor Testnet" | ||
Mordor is a PoW Ethereum Classic testnet. A testnet allows developers to perform specific tests. Developers may want to test protocol changes, test a smart contract, or interact with the network in anyway that does not require real EthClassic (ETC)—just don’t test on mainnet, mainnet is for production. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Mordor is a PoW Ethereum Classic testnet. A testnet allows developers to perform specific tests. Developers may want to test protocol changes, test a smart contract, or interact with the network in anyway that does not require real EthClassic (ETC)—just don’t test on mainnet, mainnet is for production. | |
Mordor is a PoW Ethereum Classic testnet. A testnet allows developers to test transactions before deploying them with real value on the mainnet. Developers may want to test protocol changes, test a smart contract, or interact with the network in any way that does not require real EthClassic (ETC)—just don’t test on mainnet, mainnet is for production. |
$ source ~/.bash_profile | ||
$ go version | ||
``` | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
All three of these paragraphs are Go installation instructions. I'd prefer to defer simply to one -- the official Go docs -- rather than provide 3 redundant options which will need updating. The important part here -- and thanks for updating it :) -- is the minimum Go version.
|
||
You’ll notice listing the account will print the keystore file location.For example:keystore:///home/USER/.ethereum/mordor/keystore/UTC... | ||
|
||
## Run Mordor with Mining Enable |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
## Run Mordor with Mining Enable | |
## Run Mordor with Mining Enabled |
|
||
So, you’re running a Mordor node and mining testnet mETC. Woohoo! An easy way to double check you’re actually growing a Mordor testnet balance is on [Blockscout](https://etc-mordor.blockscout.com). Just search the account address you created earlier. | ||
|
||
## Add your Mordor Account to a Wallet? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
## Add your Mordor Account to a Wallet? | |
## Add your Mordor Account to a Wallet (Optional) |
Enter the following in a new terminal window (ctrl + alt + t): | ||
|
||
```shell | ||
touch start-mordor.sh && echo "geth --mordor --mine --minerthreads 1 --miner.etherbase 0x_INSERT_YOUR_ADDRESS_HERE_3a087" >start-mordor.sh && chmod +x start-mordor.sh |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
>
will create (and truncate) the file if it does not already exist.
touch start-mordor.sh && echo "geth --mordor --mine --minerthreads 1 --miner.etherbase 0x_INSERT_YOUR_ADDRESS_HERE_3a087" >start-mordor.sh && chmod +x start-mordor.sh | |
echo "geth --mordor --mine --minerthreads 1 --miner.etherbase 0x_INSERT_YOUR_ADDRESS_HERE_3a087" >start-mordor.sh && chmod +x start-mordor.sh |
touch start-mordor.sh && echo "geth --mordor --mine --minerthreads 1 --miner.etherbase 0x_INSERT_YOUR_ADDRESS_HERE_3a087" >start-mordor.sh && chmod +x start-mordor.sh | ||
``` | ||
|
||
touch start-mordor.sh to create the file && echo “the contents” into the shell script file && add chmod executable+x permissions to the file. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
touch start-mordor.sh to create the file && echo “the contents” into the shell script file && add chmod executable+x permissions to the file. | |
Create or truncate the script file and echo the command into it, then make it executable. |