Lucidwallet

A Frontend for Fluxwallet

Features

• Full graphical wallet in your terminal
• Browser support coming soon
• Can work over ssh with full copy paste (even headless)
• Flux native wallet (other chains coming soon)
• Optionally encrypt keys
• Send / receive transactions
• Sign messages (login to home.runonflux.io)
• Create wallet / import from mnemonic
• Uses Websocket to subscribe for latest blocks etc

Quickstart (Python 3.10+)

Install:

pip install lucidwallet

Once installed run from a terminal:

Run:

lucidwallet

OR if you're having trouble with your Python path:

python3 -m lucidwallet

OR if you want a portable, albiet slower way to run:

docker run --name lucidwallet -it megachips/lucidwallet:latest

Then on subsequent runs:

docker start lucidwallet -ia

Installation

Requires Python 3.10 or greater. If you don't have Python 3.10 - use the docker image

macOS

Prerequisites:

gmp

brew install gmp

Install:

python3 -m pip install lucidwallet

A note on macOS terminal, it is recommended that you use ITerm2, native terminal works, however you need to modify some settings. See here if you plan on using Terminal.app

Ubuntu 22.04 (comes standard with Python 3.10)

Prerequisites:

libgmp-dev

sudo apt-get update && apt-get install python3-pip libgmp3-dev

Install:

python3 -m pip install lucidwallet

Source your profile to pick up new bin folder (or restart terminal)

source ~/.profile

Windows

Tested on a Windows Server 2022 VM.

Prerequisites:

A decent terminal. Powershell 7 works, but it's not pretty.

tabby.sh has been tested and works well.

Once Python is installed, install with pip. Make sure your paths are up to date.

python3 -m pip install lucidwallet

Note, there is no fastecdsa natively on Windows. So some cryptographic functions are slower. You can install the fastecdsa-any package however you will need a working gmp and C++ build tools for Python installed.

OR - Just use docker.

Docker

Usage notes:

The perfered method to run in docker is to NOT use mounts and reuse the same container.

Performance takes a bit of a hit on docker (especially on macOS) You can try virtiofs for faster mounts. (If you are bind mounting a database) See here

However, docker lucidwallet is the easiest to install.

Preferred method:

docker run --name lucidwallet -it megachips/lucidwallet:latest

Then on subsequent runs:

docker start lucidwallet -ia

If you want to use a local db dir, mount it like this:

docker run -v $(pwd)/database/:/database --rm -it megachips/lucidwallet:latest

This will create a database folder in your current directory, and the container will store database files there.