-WIP-electrum-btcp/README.rst

169 lines
3.7 KiB
ReStructuredText
Raw Normal View History

2018-02-16 16:11:35 -08:00
ZCL Electrum - Zclassic Electrum (Lite) Client
==============================================
2015-06-27 00:58:45 -07:00
2018-09-02 00:35:31 -07:00
Latest Release: https://github.com/z-classic/electrum-zcl/releases
2018-01-26 10:02:37 -08:00
Viewing & Sending from Z addresses is not yet supported on this wallet.
2018-01-26 10:02:37 -08:00
2018-01-28 16:26:05 -08:00
Know about your data directory::
2018-01-19 09:26:14 -08:00
Linux + Mac: ~/.electrum-zcl/
Windows: C:\Users\YourUserName\AppData\Roaming\Electrum-zcl\
2018-01-19 09:42:13 -08:00
2018-02-16 16:11:35 -08:00
~/.electrum-zcl/wallets/ has your wallet files - BACK UP THIS FOLDER
2015-06-27 00:58:45 -07:00
You can also use 'Export Private Keys' and 'Show Seed' from inside the application to write down and store your funds.
2015-06-27 00:58:45 -07:00
2018-09-02 00:35:31 -07:00
Please use the issue tracker for bug reports, feature requests, and other mission-critical information. It is actively monitored by the Zclassic development team. For general support, please visit our Discord: https://discord.gg/45NNrMJ
2016-10-15 03:12:10 -07:00
Development Version
2016-03-05 22:44:10 -08:00
===================
2018-02-16 16:11:35 -08:00
First, clone from Github::
2016-03-05 22:44:10 -08:00
2018-09-02 00:35:31 -07:00
git clone https://github.com/z-classic/electrum-zcl.git
cd electrum-zcl
2016-03-05 22:44:10 -08:00
For Mac:
--------
2016-03-17 04:52:40 -07:00
Using Homebrew::
2016-03-17 04:52:40 -07:00
2018-01-25 23:23:30 -08:00
# Setup Homebrew
2018-02-16 16:49:18 -08:00
./setup-mac
2018-01-25 23:23:30 -08:00
# Install Homebrew dependencies
brew bundle
2018-01-25 23:23:30 -08:00
# Install Python dependencies
pip3 install -r requirements.txt
# Build icons
2018-01-28 16:26:05 -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-02-16 16:49:18 -08:00
# Build .app, .dmg
2018-09-02 00:35:31 -07:00
./create-dmg.sh
2018-02-16 16:49:18 -08:00
# Run the .app in dist/, or
./electrum-zcl
2018-01-19 09:26:14 -08:00
For Linux:
----------
Install Dependencies::
sudo apt-get install python-pip pyqt5-dev-tools $(grep -vE "^\s*#" packages.txt | tr "\n" " ")
2018-02-20 20:38:24 -08:00
pip3 install -r requirements.txt
2018-02-16 16:11:35 -08:00
2018-02-20 20:38: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-02-05 23:57:28 -08:00
# For yum installations (no apt-get), or for a clean python env, use Anaconda with Python 3:
2018-02-20 20:38:24 -08:00
# https://poweruphosting.com/blog/install-anaconda-python-ubuntu-16-04/
2018-02-05 23:57:28 -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
For the Linux app launcher (start menu) icon::
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-02-16 16:11:35 -08:00
./electrum-zcl
2018-01-19 09:26:14 -08:00
2016-03-05 22:44:10 -08:00
2018-01-31 14:46:50 -08:00
For Linux with docker:
----------------------
Build the docker image::
./build-docker.sh
Run the docker image::
./run-docker.sh
2016-03-05 22:44:10 -08:00
2018-01-30 12:14:28 -08:00
See `contrib/build-osx/`.
2018-01-19 09:42:13 -08:00
Windows
-------
2018-01-30 12:14:28 -08:00
See `contrib/build-wine/`.
Android
-------
2015-06-27 00:58:45 -07:00
See `gui/kivy/Readme.txt` file.
2016-03-05 22:44:10 -08:00
---
2015-06-27 00:58:45 -07: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-02-20 20:38:24 -08:00
(This directory contains the Python dependencies used by Electrum-ZCL.)
2016-03-05 22:44:10 -08:00
2015-06-27 00:58:45 -07:00
ZCL Hints and Debug
===================
2018-01-20 19:33:16 -08:00
There are several useful scripts in::
2016-03-05 22:44:10 -08:00
scripts
2016-03-05 22:44:10 -08:00
Here is a good initial check to determine whether things are working (should successfully validate chunks)::
2016-03-05 22:44:10 -08:00
cd scripts
python3 block_headers
2016-03-05 22:44:10 -08:00
--
The Zclassic Wiki is located at: https://github.com/z-classic/zclassic/wiki. Please use this as a reference and feel free to contribute.
Original Project Info
---------------------
::
Forked from **spesmilo/electrum**: https://github.com/spesmilo/electrum
Licence: MIT Licence
Author: Thomas Voegtlin
Language: Python (GUI: Qt, Kivy)
Platforms: Windows, Mac, Linux, Android
Homepage: https://electrum.org/
.. image:: https://travis-ci.org/spesmilo/electrum.svg?branch=master
:target: https://travis-ci.org/spesmilo/electrum
:alt: Build Status
.. image:: https://coveralls.io/repos/github/spesmilo/electrum/badge.svg?branch=master
:target: https://coveralls.io/github/spesmilo/electrum?branch=master
:alt: Test coverage statistics
---
2018-09-02 00:35:31 -07:00
The Zclassic CE Team
2018-02-16 16:11:35 -08:00
2018-09-02 00:35:31 -07:00
ZCL: t3eYEnoMmfUV65CZvPvV2mfAUnfFGoFbkJu