git x discord telegram
gitxdiscordtelegram

installing the client

lightweight web client to interact with octra network

octra labs maintains an official web client to interact with the octra network.

the client lets the user:

  • view their balance
  • send transactions
  • encrypt and decrypt their balance
  • send and receive stealth transactions
  • use apps such as the bridge
  • develop, deploy, and interact with programs

the web client is open sourced and available at https://github.com/octra-labs/webcli.

requirements

  • c++17 compiler
  • OpenSSL 3.x
  • LevelDB
  • make
  • pkg-config or pkgconf
  • libpvac, included from the local pvac/ directory

for most users, the setup script installs the required dependencies automatically.

macOS and linux

from the client directory:

chmod +x setup.sh
./setup.sh
./octra_wallet

then open:

http://127.0.0.1:8420

to install dependencies only, without building the client:

./setup.sh --deps-only

windows

on Windows, run:

setup.bat

the script checks for MSYS2 and installs the required build dependencies.

after the build finishes, run:

octra_wallet.exe

then open:

http://127.0.0.1:8420

if MSYS2 is not installed automatically, install it from https://www.msys2.org/ and run setup.bat again.

build manually

if dependencies are already installed, build with:

make

then run:

./octra_wallet

on Windows:

octra_wallet.exe

you can also pass a custom local port:

./octra_wallet 9000

or on Windows:

octra_wallet.exe 9000

launch

after opening the web interface in your browser:

  1. create a new wallet or import an existing one
  2. enter a 6 digit PIN code
  3. the client encrypts your wallet locally
  4. your encrypted wallet file is stored in data/wallet.oct

the PIN is required on every startup to unlock the wallet. never share your seed phrase, private key, or wallet file with anyone.

vendor libraries

octra labs avoids third-party dependencies where possible. the client includes only a small set of well-known libraries and point implementations; the rest is written specifically for the octra client.

common issues

browser does not open automatically

open the client manually:

http://127.0.0.1:8420

dependencies are missing

run the setup script again, or install OpenSSL 3.x, LevelDB, make, and pkg-config manually for your operating system.

Windows build fails

run setup.bat from normal Windows Command Prompt. if MSYS2 was just installed, close and reopen Command Prompt, then run setup.bat again.

Last updated 18 days ago

modal