2018-01-19 09:26:14 -08:00
|
|
|
ZCL Electrum - Lightweight Zclassic Client
|
2018-01-19 09:42:13 -08:00
|
|
|
==========================================
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2018-01-27 18:10:07 -08:00
|
|
|
**Current Release (1.0.0) (beta)**: https://github.com/BTCP-community/electrum-zcl/releases/tag/Z!1.0.0
|
2018-01-26 10:02:37 -08:00
|
|
|
|
|
|
|
|
2018-01-19 09:42:13 -08:00
|
|
|
Forked from **spesmilo/electrum**: https://github.com/spesmilo/electrum
|
2018-01-19 09:26:14 -08:00
|
|
|
|
|
|
|
Original Project Info
|
|
|
|
---------------------
|
|
|
|
::
|
2018-01-19 09:42:13 -08:00
|
|
|
|
2016-02-23 02:36:42 -08:00
|
|
|
Licence: MIT Licence
|
2015-06-27 00:58:45 -07:00
|
|
|
Author: Thomas Voegtlin
|
|
|
|
Language: Python
|
|
|
|
Homepage: https://electrum.org/
|
|
|
|
|
|
|
|
|
|
|
|
.. image:: https://travis-ci.org/spesmilo/electrum.svg?branch=master
|
|
|
|
:target: https://travis-ci.org/spesmilo/electrum
|
|
|
|
:alt: Build Status
|
2017-11-08 13:31:13 -08:00
|
|
|
.. image:: https://coveralls.io/repos/github/spesmilo/electrum/badge.svg?branch=master
|
|
|
|
:target: https://coveralls.io/github/spesmilo/electrum?branch=master
|
2017-11-08 08:58:17 -08:00
|
|
|
:alt: Test coverage statistics
|
|
|
|
|
2015-06-27 00:58:45 -07:00
|
|
|
|
|
|
|
|
2016-03-05 22:44:10 -08:00
|
|
|
Getting started
|
|
|
|
===============
|
|
|
|
|
2017-04-01 19:55:09 -07:00
|
|
|
Electrum is a pure python application. If you want to use the
|
2018-01-19 18:49:32 -08:00
|
|
|
Qt interface, install the Qt dependencies.
|
2016-03-05 22:44:10 -08:00
|
|
|
|
|
|
|
|
2017-04-01 19:55:09 -07:00
|
|
|
If you downloaded the official package (tar.gz), you can run
|
2016-03-05 22:44:10 -08:00
|
|
|
Electrum from its root directory, without installing it on your
|
2016-03-18 01:20:00 -07:00
|
|
|
system; all the python dependencies are included in the 'packages'
|
|
|
|
directory. To run Electrum from its root directory, just do::
|
2015-06-27 00:58:45 -07:00
|
|
|
|
|
|
|
./electrum
|
|
|
|
|
2016-10-15 03:12:10 -07:00
|
|
|
|
2017-04-01 19:55:09 -07:00
|
|
|
If you cloned the git repository, you need to compile extra files
|
2016-03-05 22:44:10 -08:00
|
|
|
before you can run Electrum. Read the next section, "Development
|
|
|
|
Version".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Development version
|
|
|
|
===================
|
|
|
|
|
|
|
|
Check out the code from Github::
|
|
|
|
|
2018-01-20 08:00:15 -08:00
|
|
|
git clone git://github.com/BTCP-community/electrum-zcl.git
|
|
|
|
cd electrum-zcl
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2018-01-19 18:49:32 -08:00
|
|
|
For Mac:
|
|
|
|
--------
|
2016-03-17 04:52:40 -07:00
|
|
|
|
2018-01-19 18:49:32 -08:00
|
|
|
Using Homebrew::
|
2016-03-17 04:52:40 -07:00
|
|
|
|
2018-01-25 23:23:30 -08:00
|
|
|
# Setup Homebrew
|
|
|
|
sh ./setup-mac.sh
|
2018-01-24 04:29:19 -08:00
|
|
|
|
2018-01-25 23:23:30 -08:00
|
|
|
# Install Homebrew dependencies
|
|
|
|
brew bundle
|
2018-01-24 04:29:19 -08:00
|
|
|
|
2018-01-25 23:23:30 -08:00
|
|
|
# Install Python dependencies
|
|
|
|
pip3 install -r requirements.txt
|
2018-01-24 04:29:19 -08:00
|
|
|
|
|
|
|
# Build icons
|
2018-01-19 18:49:32 -08:00
|
|
|
pyrcc5 icons.qrc -o gui/qt/icons_rc.py
|
2018-01-19 09:26:14 -08:00
|
|
|
|
2018-01-25 23:23:30 -08:00
|
|
|
# Compile the protobuf description file
|
|
|
|
protoc --proto_path=lib/ --python_out=lib/ lib/paymentrequest.proto
|
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
# Run
|
2018-01-19 18:49:32 -08:00
|
|
|
./electrum
|
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
`(Alternatively, copy the generated "build/scripts-3.6/electrum" to the main directory)`::
|
2018-01-19 09:26:14 -08:00
|
|
|
|
2018-01-19 18:49:32 -08:00
|
|
|
cp -f build/scripts-3.6/electrum electrum-mac
|
2018-01-19 09:26:14 -08:00
|
|
|
./electrum-mac
|
|
|
|
|
|
|
|
|
|
|
|
For Linux:
|
|
|
|
----------
|
|
|
|
|
2018-01-19 18:49:32 -08:00
|
|
|
Install Dependencies::
|
|
|
|
|
2018-01-25 23:23:30 -08:00
|
|
|
sudo apt-get install $(grep -vE "^\s*#" packages.txt | tr "\n" " ")
|
2018-01-24 04:29:19 -08:00
|
|
|
|
2018-01-25 23:23:30 -08:00
|
|
|
pip install -r requirement.txt
|
2018-01-19 18:49:32 -08:00
|
|
|
|
2018-01-25 23:43:24 -08:00
|
|
|
(Ubuntu with ledger wallet)
|
|
|
|
ln -s /lib/x86_64-linux-gnu/libudev.so.1 /lib/x86_64-linux-gnu/libudev.so
|
2018-01-24 04:29:19 -08:00
|
|
|
|
|
|
|
|
|
|
|
Compile the icons file for Qt::
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2017-09-22 20:54:38 -07:00
|
|
|
pyrcc5 icons.qrc -o gui/qt/icons_rc.py
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
For the Linux app launcher (start menu) icon::
|
2018-01-18 18:55:26 -08:00
|
|
|
|
|
|
|
sudo desktop-file-install electrum.desktop
|
|
|
|
|
2016-03-05 22:44:10 -08:00
|
|
|
Compile the protobuf description file::
|
|
|
|
|
|
|
|
protoc --proto_path=lib/ --python_out=lib/ lib/paymentrequest.proto
|
|
|
|
|
2016-10-15 03:12:10 -07:00
|
|
|
Create translations (optional)::
|
2016-03-05 22:44:10 -08:00
|
|
|
./contrib/make_locale
|
|
|
|
|
2018-01-19 09:26:14 -08:00
|
|
|
Run::
|
2018-01-20 19:33:16 -08:00
|
|
|
|
2018-01-19 09:26:14 -08:00
|
|
|
./electrum
|
|
|
|
|
2016-03-05 22:44:10 -08:00
|
|
|
|
|
|
|
|
2018-01-14 18:41:18 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
Building Releases
|
|
|
|
=================
|
2018-01-19 09:42:13 -08:00
|
|
|
|
2018-01-19 09:26:14 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
MacOS
|
|
|
|
------
|
2018-01-19 09:42:13 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
Simply - ::
|
2018-01-14 18:41:18 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
sh ./setup-mac.sh
|
2018-01-14 18:41:18 -08:00
|
|
|
|
2018-01-27 18:05:51 -08:00
|
|
|
sudo sh ./create-dmg.sh
|
2018-01-19 09:42:13 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
Windows
|
|
|
|
-------
|
2018-01-14 18:41:18 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
See `contrib/build-wine/README` file.
|
2018-01-14 18:41:18 -08:00
|
|
|
|
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
Android
|
|
|
|
-------
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
See `gui/kivy/Readme.txt` file.
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
---
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
To just create binaries, create the 'packages/' directory::
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2016-03-17 04:52:40 -07:00
|
|
|
./contrib/make_packages
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
(This directory contains the Python dependencies used by Electrum.)
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2015-06-27 00:58:45 -07:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
ZCL Hints and Debug
|
|
|
|
===================
|
2018-01-20 19:33:16 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
There are several useful scripts in::
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
scripts
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
This is a good initial check to determine whether things are working.::
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
cd scripts
|
|
|
|
python3 block_headers
|
2016-03-05 22:44:10 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
It should run, validating chunks without error.
|
|
|
|
|
|
|
|
Also be sure to check out:::
|
|
|
|
|
|
|
|
~/.electrum-zcl/
|
|
|
|
|
|
|
|
~/.electrum-zcl/wallets/ has your wallet files - ** back up this folder **
|
|
|
|
|
|
|
|
~/.electrum-zcl/config has your Electrum connection object.
|
|
|
|
|
|
|
|
|
2018-01-27 18:05:51 -08:00
|
|
|
|
2018-01-24 04:29:19 -08:00
|
|
|
---
|
|
|
|
|
|
|
|
The Zclassic Team
|