Byteball is a wallet for storage and transfer of decentralized value. See byteball.org.
Binary Downloads
Main Features
TBD
Installation
Download and install NW.js v0.14.7 LTS and Node.js v5.12.0. These versions are recommended for easiest install but newer versions will work too. If you already have another version of Node.js installed, you can use NVM to keep both.
Clone the source:
git clone https://github.com/byteball/byteball.git
cd byteballIf you are building for testnet, switch to testnet branch:
git checkout testnetInstall bower and grunt if you haven't already:
npm install -g bower
npm install -g grunt-cliBuild Byteball:
bower install
npm install
gruntIf you are on Windows or using NW.js and Node.js versions other than recommended, see NW.js instructions about building native modules.
After first run, you'll likely encounter runtime error complaining about node_sqlite3.node not being found, copy the file from the neighboring directory to where the program tries to find it, and run again. (e.g. from byteball/node_modules/sqlite3/lib/binding/node-v47-darwin-x64 to byteball/node_modules/sqlite3/lib/binding/node-webkit-v0.14.7-darwin-x64)
Then run Byteball desktop client:
/path/to/your/nwjs/nwjs .Build Byteball App Bundles
All app bundles will be placed at ../byteballbuilds dir, so create it first: mkdir -p ../byteballbuilds
Android
- Install Android SDK
- Run
make android-debug
iOS
- Install Xcode 7 (or newer)
- Install Cordova 6
npm install cordova@6 -g - Run
make ios-debug- In case of ios-deploy missing error:
npm install -g ios-deploy - In case of
DeviceSupportmissing error, runcd /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/DeviceSupport/ && sudo ln -s 10.3.1\ \(14E8301\)/ 10.3 - If you encounter 'bitcore' not found after app launch, install it also
npm install bitcore-liband remove../bytebalbuilds/project-IOSfolder completely, then rerun make again. - On code signing error, open Xcode project
../byteballbuilds/project-IOS/platforms/ios/Byteball.xcodeprojin Xcode, open project properties, select Byteball target and set your AppleID account as a team. Xcode may also ask you to change bundle identifier to be unique, just append any random string to 'org.byteball.wallet' bundle identifier.
- In case of ios-deploy missing error:
macOS
grunt desktop- copy
node_modulesinto the app bundle ../byteballbuilds/Byteball/osx64/Byteball.app/Contents/Resources/app.nw, except those that are important only for development (karma, grunt, jasmine) grunt dmg
Windows
grunt desktop- copy
node_modulesinto the app bundle ../byteballbuilds/Byteball/win64, except those that are important only for development (karma, grunt, jasmine) grunt inno64
Linux
grunt desktop- copy
node_modulesinto the app bundle ../byteballbuilds/Byteball/linux64, except those that are important only for development (karma, grunt, jasmine) grunt linux64
About Byteball
TBD
Byteball Backups and Recovery
Byteball uses a single extended private key for all wallets, BIP44 is used for wallet address derivation. There is a BIP39 mnemonic for backing up the wallet key, but it is not enough. Private payments and co-signers of multisig wallets are stored only in the app's data directory, which you have to back up manually:
- macOS:
~/Library/Application Support/byteball - Linux:
~/.config/byteball - Windows:
%LOCALAPPDATA%\byteball
Translations
Byteball uses standard gettext PO files for translations and Crowdin as the front-end tool for translators. To join our team of translators, please create an account at Crowdin and translate the Byteball documentation and application text into your native language.
To download and build using the latest translations from Crowdin, please use the following commands:
cd i18n
node crowdin_download.jsThis will download all partial and complete language translations while also cleaning out any untranslated ones.
Support
- GitHub Issues
- Open an issue if you are having problems with this project
- Email Support
Credits
The GUI is based on Copay, the most beautiful and easy to use Bitcoin wallet.
License
MIT.