KomodoOcean (komodo-qt)

Overview

KomodoOcean, also known as Komodo-QT, is the first native graphical wallet for the Komodo ecosystem, which includes the KMD coin and its assetchains (ACs). Built with the Qt framework, it offers an easy-to-use interface for managing Komodo assets. With KomodoOcean, users can send and receive KMD and interact with assetchains (ACs), view their transaction history, and access various features of the Komodo Platform.

While the Komodo assetchains provide advanced privacy features, the main KMD coin does not include these privacy options. KomodoOcean stands out as a pioneering Qt-based wallet for a ZCash fork, especially since ZCash itself still does not have a native Qt wallet.

KomodoOcean is available on three OS platforms: Windows, Linux, and macOS.

Use the default static branch and the following scripts in ./zcutil to build, depending on your target platform and architecture:

• Linux:

  • build.sh: Native build for Linux.
  • build-no-qt.sh: Native build for Linux, but without Qt (produces a daemon-only version).
  • build-aarch64-cross.sh: Cross-compilation for ARM (aarch64) on Linux.

• Windows:

  • build-win.sh: Cross-compilation for Windows from a Linux environment.

• MacOS:

  • build-mac.sh: Native build for macOS (x86_64). Use on Intel-based Macs or run with arch -x86_64 /bin/zsh on Apple Silicon Macs.
  • build-mac-cross.sh: Cross-compilation for macOS (x86_64) from a Linux environment; produces Mach-O 64-bit x86_64 executable binaries.
  • build-mac-arm.sh: Native build for macOS aarch64. Use this on Apple Silicon Macs to produce Mach-O 64-bit executable arm64 binaries.
  • build-mac-arm-cross.sh: Cross-compilation for macOS aarch64 from a Linux environment.

Or use the static-experimental branch to access the latest nightly features.

Note: Cross-compiled arm64 Darwin (macOS) binaries do not include a digital signature by default. To use these binaries on macOS, they must be signed before execution. Failure to sign these binaries may result in issues with macOS security settings, preventing them from running properly.

Please note that the parent repository ip-gpu/KomodoOcean is no longer maintained!

Visit #🤝│general-support or #wallet-ocean-qt channel in Komodo Discord for more information.

How to build?

Linux

The following packages are needed:

sudo apt-get install build-essential pkg-config libc6-dev m4 g++-multilib autoconf libtool ncurses-dev unzip git python3 bison zlib1g-dev wget libcurl4-gnutls-dev bsdmainutils automake curl

Build:

git clone https://github.com/DeckerSU/KomodoOcean --branch static --single-branch
cd KomodoOcean
./zcutil/fetch-params.sh
# -j8 = using 8 threads for the compilation - replace 8 with number of threads you want to use
./zcutil/build-linux.sh -j8

This can take some time.

Linux (aarch64)

Install the Cross-Compilation Toolchain:

sudo apt install g++-aarch64-linux-gnu
aarch64-linux-gnu-g++ --version # verify the installation

Build:

./zcutil/build-aarch64-cross.sh -j8

OSX (Cross-compile)

Before start, read the following docs: depends, macdeploy .

Install dependencies:

sudo apt-get install curl librsvg2-bin libtiff-tools bsdmainutils cmake imagemagick libcap-dev libz-dev libbz2-dev python3-setuptools libtinfo5 xorriso
# sudo apt-get install libstdc++-$(g++ -dumpversion)-dev # in the event of errors occurring while building native_libtapi

Place prepared SDK file Xcode-13.2.1-13C100-extracted-SDK-with-libcxx-headers.tar.gz in repo root, use build-mac-cross.sh script to build.

OSX (Native)

Ensure you have brew and Command Line Tools installed.

# Install brew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
# Install Xcode, opens a pop-up window to install CLT without installing the entire Xcode package
xcode-select --install 
# Update brew and install dependencies
brew update
brew upgrade
brew tap discoteq/discoteq; brew install flock
brew install autoconf autogen automake
brew install binutils
brew install protobuf
brew install coreutils
brew install wget
# Clone the Komodo repo
git clone https://github.com/DeckerSU/KomodoOcean --branch static --single-branch
# Change master branch to other branch you wish to compile
cd komodo
./zcutil/fetch-params.sh
# -j8 = using 8 threads for the compilation - replace 8 with number of threads you want to use
./zcutil/build-mac.sh -j8

This can take some time.

macOS 12 (Monterrey) have incompatible version of Xcode 14.2 (Build version 14C18), to build on Monterrey you'll need to install the older version 13.2.1 using the following steps:

• Download the specific Xcode 13.2.1 version from here or here.
• Install it.
• To set default Xcode version run this command:

sudo xcode-select -switch /Applications/Xcode_13.2.1.app

• To check default Xcode version in your system use this command:

xcodebuild -version

Windows (Cross-compile)

Use a debian cross-compilation setup with mingw for windows and run:

sudo apt-get install build-essential pkg-config libc6-dev m4 g++-multilib autoconf libtool ncurses-dev unzip git python python-zmq zlib1g-dev wget libcurl4-gnutls-dev bsdmainutils automake curl cmake mingw-w64
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env
rustup target add x86_64-pc-windows-gnu

sudo update-alternatives --config x86_64-w64-mingw32-gcc
# (configure to use POSIX variant)
sudo update-alternatives --config x86_64-w64-mingw32-g++
# (configure to use POSIX variant)

git clone https://github.com/DeckerSU/KomodoOcean --branch static --single-branch
cd komodo
./zcutil/fetch-params.sh
# -j8 = using 8 threads for the compilation - replace 8 with number of threads you want to use
./zcutil/build-win.sh -j8
#This can take some time.

komodo is experimental and a work-in-progress. Use at your own risk.

Docker

🐳 deckersu/komodoocean - This Docker image provides the official KomodoOcean daemon for the Komodo blockchain platform. Komodod is the core component responsible for running a Komodo node, facilitating transaction validation, block creation, and communication within the network.

Read the description on Docker Hub for usage examples.

Create komodo.conf

Before start the wallet you should create config file komodo.conf at one of the following locations:

• Linux - ~/.komodo/komodo.conf
• Windows - %APPDATA%\Komodo\komodo.conf
• MacOS - ~/Library/Application Support/Komodo/komodo.conf

With the following content:

txindex=1
rpcuser=komodo
rpcpassword=local321 # don't forget to change password
rpcallowip=127.0.0.1
rpcbind=127.0.0.1
server=1

Bash one-liner for Linux to create komodo.conf with random RPC password:

RANDPASS=$(tr -cd '[:alnum:]' < /dev/urandom | fold -w16 | head -n1) && \
tee -a ~/.komodo/komodo.conf << END
txindex=1
rpcuser=komodo
rpcpassword=${RANDPASS}
rpcallowip=127.0.0.1
rpcbind=127.0.0.1
server=1
END

Developers of Qt wallet

• Main developer: Ocean
• IT Expert / Sysengineer: Decker