mirror of
https://github.com/logos-storage/logos-storage-testnet-starter.git
synced 2026-05-20 16:49:30 +00:00
Moving setup instructions to MD
This commit is contained in:
Ben
parent
2aca2bc2da
commit
a77539399b
193
README.md
193
README.md
@ -1,19 +1,6 @@
|
|||||||
# Codex Testnet Starter
|
# Codex Testnet Starter
|
||||||
Hit the ground running with Codex.
|
Hit the ground running with Codex.
|
||||||
|
|
||||||
1. [Overview](#overview)
|
|
||||||
2. [How to start](#how-to-start)
|
|
||||||
3. [How to get ready](#how-to-get-ready)
|
|
||||||
4. [How to use](#how-to-use)
|
|
||||||
5. [How to stop](#how-to-stop)
|
|
||||||
6. [How to stop and delete everything](#how-to-stop-and-delete-everything)
|
|
||||||
7. [Troubleshooting](#troubleshooting)
|
|
||||||
|
|
||||||
|
|
||||||
## [Overview](#codex-testnet-starter)
|
|
||||||
|
|
||||||
Using the Testnet Starter, you can run a (mostly preconfigured) Codex node on your machine. You always have the option to build and run Codex from sources [Here](https://github.com/codex-storage/nim-codex/).
|
|
||||||
|
|
||||||
### Links
|
### Links
|
||||||
- Codex Website - [codex.storage](https://codex.storage)
|
- Codex Website - [codex.storage](https://codex.storage)
|
||||||
- Codex Whitepaper - [codex.storage](https://codex.storage)
|
- Codex Whitepaper - [codex.storage](https://codex.storage)
|
||||||
@ -22,183 +9,3 @@ Using the Testnet Starter, you can run a (mostly preconfigured) Codex node on yo
|
|||||||
- Block explorer - [explorer.testnet.codex.storage](https://explorer.testnet.codex.storage)
|
- Block explorer - [explorer.testnet.codex.storage](https://explorer.testnet.codex.storage)
|
||||||
- Web wallet - [wallet.testnet.codex.storage](https://wallet.testnet.codex.storage)
|
- Web wallet - [wallet.testnet.codex.storage](https://wallet.testnet.codex.storage)
|
||||||
|
|
||||||
|
|
||||||
## [How to start](#codex-testnet-starter)
|
|
||||||
1. [Have Docker with compose installed](https://docs.docker.com/engine/install/)
|
|
||||||
|
|
||||||
2. Clone this repo
|
|
||||||
```shell
|
|
||||||
git clone https://github.com/codex-storage/codex-testnet-starter && cd codex-testnet-starter
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Create an Ethereum public/private key pair using [web wallet](https://wallet.testnet.codex.storage) or consider other local methods
|
|
||||||
<details>
|
|
||||||
<summary>Use Docker</summary>
|
|
||||||
|
|
||||||
```shell
|
|
||||||
# Generate keypair
|
|
||||||
docker run --rm gochain/web3 account create
|
|
||||||
```
|
|
||||||
</details>
|
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary>Use MetaMask</summary>
|
|
||||||
|
|
||||||
1. [Accounts and Addresses](https://support.metamask.io/hc/en-us/sections/4471975962907-Accounts-and-Addresses)
|
|
||||||
2. [How to export an account's private key](https://support.metamask.io/hc/en-us/articles/360015289632-How-to-export-an-account-s-private-key)
|
|
||||||
</details>
|
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary>Use Python code</summary>
|
|
||||||
|
|
||||||
1. Create a venv
|
|
||||||
```shell
|
|
||||||
pip3 install virtualenv
|
|
||||||
|
|
||||||
venv=codex-eth-key
|
|
||||||
mkdir $venv && cd $venv
|
|
||||||
|
|
||||||
python3 -m venv env
|
|
||||||
source env/bin/activate
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Install required packages
|
|
||||||
```shell
|
|
||||||
pip3 install web3
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Create a script
|
|
||||||
```shell
|
|
||||||
vi eth-keys.py
|
|
||||||
```
|
|
||||||
```python
|
|
||||||
from eth_account import Account
|
|
||||||
|
|
||||||
def generate_ethereum_keypair():
|
|
||||||
# Generate a new Ethereum account
|
|
||||||
account = Account.create()
|
|
||||||
|
|
||||||
# Get the private key
|
|
||||||
private_key = account._private_key.hex()
|
|
||||||
|
|
||||||
# Get the public key (Ethereum address)
|
|
||||||
public_key = account.address
|
|
||||||
|
|
||||||
return private_key, public_key
|
|
||||||
|
|
||||||
# Generate the Ethereum key pair
|
|
||||||
private_key, public_key = generate_ethereum_keypair()
|
|
||||||
|
|
||||||
# Print the keys
|
|
||||||
print("Private Key:", private_key)
|
|
||||||
print("Public Key (Ethereum Address):", public_key)
|
|
||||||
```
|
|
||||||
|
|
||||||
4. Generate the keys
|
|
||||||
```shell
|
|
||||||
python3 eth-keys.py
|
|
||||||
```
|
|
||||||
5. Cleanup
|
|
||||||
```shell
|
|
||||||
deactivate
|
|
||||||
cd .. && rm -rf $venv
|
|
||||||
```
|
|
||||||
</details>
|
|
||||||
|
|
||||||
```
|
|
||||||
# Example
|
|
||||||
Private key: 0xacec4df7549199708a9f66b151aea7bf41b4d30bd325b96b26f017246226e1a3
|
|
||||||
Public address: 0x1C408C8572ce7d5E79a3a6D353e5FC2E8E2c49ce
|
|
||||||
```
|
|
||||||
|
|
||||||
4. Define variables
|
|
||||||
```shell
|
|
||||||
export PRIV_KEY=0xacec4df7549199708a9f66b151aea7bf41b4d30bd325b96b26f017246226e1a3
|
|
||||||
export CODEX_LISTEN_ADDRS=/ip4/0.0.0.0/tcp/8070
|
|
||||||
export CODEX_DISC_PORT=8090
|
|
||||||
|
|
||||||
# export CODEX_ETH_PROVIDER=https://rpc.testnet.codex.storage
|
|
||||||
# export CODEX_LOG_LEVEL=TRACE
|
|
||||||
#
|
|
||||||
# export GETH_DISCOVERY_PORT=8547
|
|
||||||
# export GETH_PORT=8548
|
|
||||||
# export GETH_NAT=extip:1.1.1.1
|
|
||||||
# export GETH_VERBOSITY=3
|
|
||||||
```
|
|
||||||
|
|
||||||
5. Run local nodes
|
|
||||||
```shell
|
|
||||||
docker-compose up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
6. Setup port forwarding on your router for Codex, based on defined values
|
|
||||||
```
|
|
||||||
TCP - CODEX_LISTEN_ADDRS=/ip4/0.0.0.0/tcp/8070
|
|
||||||
UDP - CODEX_DISC_PORT=8090
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## [How to get ready](#codex-testnet-starter)
|
|
||||||
When starting the Testnet Starter for the first time, (or restarting after a long pause) please keep in mind:
|
|
||||||
- Your local Geth node will need time to sync.
|
|
||||||
- Geth checker will wait until Geth is in sync and only then Codex will start.
|
|
||||||
|
|
||||||
Before you can use the marketplace functionality of Codex, you will need to obtain some tokens in the Testnet.
|
|
||||||
1. Use web faucets
|
|
||||||
- ETH - [faucet-eth.testnet.codex.storage](https://faucet-eth.testnet.codex.storage)
|
|
||||||
- TST - [faucet-tst.testnet.codex.storage](https://faucet-tst.testnet.codex.storage/)
|
|
||||||
|
|
||||||
2. Or join the [Codex Discord server](https://discord.gg/codex-storage)
|
|
||||||
<details>
|
|
||||||
<summary>Get tokens on Discord server faucet</summary>
|
|
||||||
|
|
||||||
1. Find the `#bot` channel.
|
|
||||||
2. Give your public key to the bot using `set` command.
|
|
||||||
<details>
|
|
||||||
<summary>example</summary>
|
|
||||||
|
|
||||||
|
|
||||||
</details>
|
|
||||||
3. Ask it politely to mint some tokens for you using `mint` command.
|
|
||||||
<details>
|
|
||||||
<summary>example</summary>
|
|
||||||
|
|
||||||
|
|
||||||
</details>
|
|
||||||
(It may or may not happen in the future that testnet participation will be rewarded automatically with Discord server roles.)
|
|
||||||
</details>
|
|
||||||
|
|
||||||
|
|
||||||
## [How to use](#codex-testnet-starter)
|
|
||||||
Once running, Codex exposes a web-api at the API port. (default: 8080)
|
|
||||||
To read more about how to use the API, go [Here](/USINGCODEX.md)
|
|
||||||
|
|
||||||
|
|
||||||
## [How to stop](#codex-testnet-starter)
|
|
||||||
- `docker-compose down`
|
|
||||||
|
|
||||||
|
|
||||||
## [How to stop and delete everything](#codex-testnet-starter)
|
|
||||||
- `docker-compose down --rmi all -v`
|
|
||||||
|
|
||||||
|
|
||||||
## [Troubleshooting](#codex-testnet-starter)
|
|
||||||
|
|
||||||
|
|
||||||
### Geth
|
|
||||||
```shell
|
|
||||||
# List peers
|
|
||||||
docker exec -it geth geth attach --exec net.peerCount /data/geth.ipc
|
|
||||||
|
|
||||||
# Connected peers
|
|
||||||
docker exec -it geth geth attach --exec admin.peers /data/geth.ipc
|
|
||||||
|
|
||||||
# Add a peer
|
|
||||||
docker exec -it geth geth attach --exec 'admin.addPeer("enode://cff0c44c62ecd6e00d72131f336bb4e4968f2c1c1abeca7d4be2d35f818608b6d8688b6b65a18f1d57796eaca32fd9d08f15908a88afe18c1748997235ea6fe7@159.223.243.50:40010")' /data/geth.ipc
|
|
||||||
|
|
||||||
# Sync status
|
|
||||||
docker exec -it geth geth attach --exec eth.syncing /data/geth.ipc
|
|
||||||
|
|
||||||
# Geth own enode
|
|
||||||
docker exec -it geth geth attach --exec admin.nodeInfo.enode /data/geth.ipc
|
|
||||||
```
|
|
||||||
|
|||||||
51
WORKSHOPSETUP.mb
Normal file
51
WORKSHOPSETUP.mb
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
# Workshop Setup
|
||||||
|
With these instructions you can set up a Codex node on your machine, to use during the Brussels 2024 workshop. If you run into trouble and need help, ask a nearby Codexer!
|
||||||
|
|
||||||
|
## Local network
|
||||||
|
Switch to the workshop wifi:
|
||||||
|
- SSID: `codex`
|
||||||
|
- Password: `ethcc2024`
|
||||||
|
|
||||||
|
## Clone this repository
|
||||||
|
```
|
||||||
|
git clone https://github.com/codex-storage/codex-testnet-starter.git
|
||||||
|
```
|
||||||
|
|
||||||
|
Open a terminal in the scripts folder for your platform:
|
||||||
|
- `scripts/linux`
|
||||||
|
- `scripts/mac`
|
||||||
|
- `scripts/windows`
|
||||||
|
|
||||||
|
## Download Codex
|
||||||
|
Run `download` script.
|
||||||
|
|
||||||
|
## Generate an Eth key-pair
|
||||||
|
Run `generate` script.
|
||||||
|
|
||||||
|
Keep your public key at hand. Update the file named `eth.key` with your private key. You may need to change the permissions for this file. See the README.md in your platform specific folder.
|
||||||
|
|
||||||
|
## Start Codex node
|
||||||
|
Determine your local IP address. Use `ifconfig` or `ipconfig`, depending on your platform.
|
||||||
|
|
||||||
|
Set local IP environment variable
|
||||||
|
- Bash: `export LOCALIP="192.168.179.999"`
|
||||||
|
- Batch: `set LOCALIP="192.168.179.999"`
|
||||||
|
|
||||||
|
Run `run_client` script.
|
||||||
|
|
||||||
|
## Acquire tokens
|
||||||
|
You can acquire tokens in one of two ways: Discord bot or faucet.
|
||||||
|
|
||||||
|
### Discord bot
|
||||||
|
- Join the Codex discord server: https://discord.gg/codex-storage.
|
||||||
|
- Go to the "bot" channel, in the category "codex-bot".
|
||||||
|
- Use `/set` command to enter your public key.
|
||||||
|
- Use `/mint` command to receive some tokens.
|
||||||
|
|
||||||
|
### Faucet
|
||||||
|
- Follow instructions on https://faucet-eth.testnet.codex.storage to get some Eth.
|
||||||
|
- Follow instructions on https://faucet-tst.testnet.codex.storage to get some test tokens.
|
||||||
|
You will need both Eth and test tokens to use Codex.
|
||||||
|
|
||||||
|
## Use Codex
|
||||||
|
You can now proceed to use your Codex node. Follow the instructions [here](./USINGCODEX.md)
|
||||||
@ -1,3 +1,6 @@
|
|||||||
# May need
|
# Permissions
|
||||||
`sudo apt-get install libzip-dev unzip`
|
To fix the permissions of your eth.key file:
|
||||||
`chmod 600 eth.key`
|
`chmod 600 eth.key`
|
||||||
|
|
||||||
|
# Additional requirements for prover
|
||||||
|
`sudo apt-get install libzip-dev unzip`
|
||||||
|
|||||||
@ -1,11 +1,14 @@
|
|||||||
# May need
|
# Permissions
|
||||||
Right-click 'eth.key' file -> Properties
|
To fix the permissions of your eth.key file in Windows:
|
||||||
-> Security -> Advanced
|
- Right-click 'eth.key' file
|
||||||
Add -> Select a principal -> Advanced -> Find now
|
- Properties
|
||||||
Select you user from the list
|
- Security
|
||||||
OK -> OK
|
- Advanced
|
||||||
Check Full control, Modify, Read&exe, Read, Write, Special
|
- Add -> Select a principal -> Advanced -> Find now
|
||||||
OK
|
- Select you user from the list
|
||||||
Disable inheritance -> Confirm warning
|
- OK -> OK
|
||||||
Apply and close
|
- Check: "Full control", "Modify", "Read&exe", "Read", "Write"
|
||||||
Apply and close
|
- OK
|
||||||
|
- Disable inheritance -> Confirm warning
|
||||||
|
- Apply and close
|
||||||
|
- Apply and close
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user