Octra Public Testnet

Join Discord

https://discord.gg/octra

---

Requirements

Linux Ubuntu OS

• VPS: You can use a linux VPS to follow the guide
• Windows: Install Linux Ubuntu using WSL by following this guide
• Codespace: If you don't have VPS or Windows WSL, you can use Github Codespace, create a blank template and run your codes.

---

Install dependecies

Install & Update Packages:

sudo apt update && sudo apt upgrade -y
sudo apt install screen curl iptables build-essential git wget lz4 jq make gcc nano automake autoconf tmux htop nvme-cli libgbm1 pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev  -y

Install Nodejs (Only VPS users)

sudo apt update
sudo curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v
npm install -g yarn
yarn -v

---

Create wallet

1. Clone the repository

git clone https://github.com/0xmoei/wallet-gen.git
cd wallet-gen

2. Run the wallet generator webserver

Linux/macOS:

chmod +x ./start.sh
./start.sh

3. Open your browser

• WSL/Linux/MAC users:

  • Navigate to http://localhost:8888 on browser

• VPS users:

  • 1- Open a new terminal
  • 2- Install localtunnel:

    npm install -g localtunnel
    

  • 3- Get a password:

    curl https://loca.lt/mytunnelpassword
    

  • The password is actually your VPS IP
  • 4- Get URL

    lt --port 8888
    

  • Visit the prompted url, and enter your password to access wallet generator page

4. Generate wallet

• Click "GENERATE NEW WALLET" and watch the real-time progress
• Save all the details of your Wallet

---

Get Faucet

• Visit Faucet page
• Enter your address starting with oct... to get faucet

---

Configure Octra CLI and Wallet

1. Install Python

sudo apt install python3 python3-pip python3-venv python3-dev -y

2. Install CLI

git clone https://github.com/octra-labs/octra_pre_client.git
cd octra_pre_client

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

cp wallet.json.example wallet.json

3. Add wallet to CLI

nano wallet.json

• Replace following values:
  • private-key-here: Privatekey with B64 format
  • octxxxxxxxx...: Octra address starting with oct...

4. Run CLI

python3 -m venv venv
source venv/bin/activate
python3 cli.py

• This should open a Testnet UI

---

Update CLI

After each new task, existing users must update their CLI

Option A: Normal Update

Update git:

cd octra_pre_client
git pull origin main

• If you see an error about uncommitted changes (e.g., in cli.py or other files), stash your changes:

git stash
git pull origin main

Install requirements:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Option B: Wipe and Reclone (Use if Option A fails or you want a clean setup)

Update git:

• Preserve your wallet.json file, wipe the repository, and reclone it:

mv $HOME/octra_pre_client/wallet.json $HOME/wallet.json
cd && rm -rf octra_pre_client && git clone https://github.com/octra-labs/octra_pre_client.git
mv $HOME/wallet.json $HOME/octra_pre_client/wallet.json
cd octra_pre_client

Install requirements:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

---

Testnet Tasks

Run CLI

cd octra_pre_client
python3 -m venv venv
source venv/bin/activate
python3 cli.py

Send transactions

• 1- Encrypt balance
• 2- Send private transaction to another address
  • You can send private transactions to my address: octBvPDeFCaAZtfr3SBr7Jn6nnWnUuCfAZfgCmaqswV8YR5
  • Use Octra Explorer to find more octra addresses

---

Wait for next steps

Stay tuned.