kralverde's notes

Botched together tweaks: - Added a UI to ledger to let the user know something is going on for large tx's - Added coingecko for more fiat comparison options - re-implemented updates - Hardware (ledger) support fix - Updated defunct default electrumx servers - Implemented an automatic blockchain base install (based on https://github.com/standard-error/electrum-raven/releases/tag/3.3.8-rvn3) - Crude wine and linux appimage docker fixes

Running the software presteps (tested on ubuntu 20.04):

1. Familiarize yourself with git
2. Clone this repo
3. The rest of the steps in this temporary guide assume you are in the root of the project

NOTE: Building binaries may affect raw python performance. You can always reclone the files.

Running with python3 (recommended for linux/if you have python on your device):

1. sudo apt-get install python3-pyqt5
2. insure the following is installed https://electrum.readthedocs.io/en/latest/hardware-linux.html
3. ./electrum-env

Building executables:

If you are having trouble building binaries check https://github.com/kralverde/electrum-raven/releases (You should try and build these yourself first!!!)

NOTE: These executables are a little bloated because my hotfix for getting a correct header base is literally sticking a zipped blockchain_headers file in the executable. Currently working on getting the client to sync the whole chain.

Windows:

1. Install docker (if using windows use the ubuntu vm)

2. sudo docker build -t electrum-wine-builder-img contrib/build-wine

3. Create Executables:

   $ sudo docker run -it \
       --name electrum-wine-builder-cont \
       -v $PWD:/opt/wine64/drive_c/electrum \
       --rm \
       --workdir /opt/wine64/drive_c/electrum/contrib/build-wine \
       electrum-wine-builder-img \
       ./build.sh
   

4. The generated binaries are in ./contrib/build-wine/dist

5. Refer to https://github.com/kralverde/electrum-raven/tree/master/contrib/build-wine for more information.

Linux Appimage:

1. Install docker

2. sudo docker build -t electrum-appimage-builder-img contrib/build-linux/appimage

3. Create Executables:

   $ sudo docker run -it \
       --name electrum-appimage-builder-cont \
       -v $PWD:/opt/electrum \
       --rm \
       --workdir /opt/electrum/contrib/build-linux/appimage \
       electrum-appimage-builder-img \
       ./build.sh
   

4. The generated binaries are in ./dist

5. Refer to https://github.com/kralverde/electrum-raven/tree/master/contrib/build-linux/appimage for more information.

Other docker build files are currently broken

Electrum-raven - Lightweight Ravencoin client

Licence: MIT Licence
Author: Thomas Voegtlin
Port Maintainer: standard-error@github (Electrum-raven)
Language: Python (>= 3.6)
Homepage: https://ravencoin.org/

Getting started

Electrum-RVN is a pure python application. If you want to use the Qt interface, install the Qt dependencies:

sudo apt-get install python3-pyqt5

If you downloaded the official package (tar.gz), you can run Electrum-RVN from its root directory without installing it on your system; all the python dependencies are included in the 'packages' directory. To run Electrum-RVN from its root directory, just do:

./run_electrum

You can also install Electrum-RVN on your system, by running these commands:

cd ~
virtualenv -p /usr/local/bin/python3.7 pve
source ~/pve/bin/activate
git clone https://github.com/standard-error/electrum-raven
cd electrum-raven
pip3 install x16r-hash x16rv2-hash pyqt5
python3 -m pip install .[fast]

This will download and install the Python dependencies used by Electrum-RVN instead of using the 'packages' directory. The 'fast' extra contains some optional dependencies that we think are often useful but they are not strictly needed.

If you cloned the git repository, you need to compile extra files before you can run Electrum-RVN. Read the next section, "Development Version".

Development version

Check out the code from GitHub:

git clone git://github.com/standard-error/electrum-raven.git
cd electrum-raven

Run install (this should install dependencies):

python3 -m pip install .[fast]

Compile the protobuf description file:

sudo apt-get install protobuf-compiler
protoc --proto_path=electrum --python_out=electrum electrum/paymentrequest.proto

Create translations (optional):

sudo apt-get install python-requests gettext
./contrib/pull_locale

Creating Binaries

Linux (tarball)

See contrib/build-linux/README.md.

Linux (AppImage)

See contrib/build-linux/appimage/README.md.

Mac OS X / macOS

See contrib/osx/README.md.

Windows

See contrib/build-wine/README.md.

Android

See electrum/gui/kivy/Readme.md.