mirror of https://github.com/BTCPrivate/copay.git
use libsass, deprecate ruby, simplify installation (#4206)
* use libsass, deprecate ruby, simplify installation * update installation instructions, readme formatting
This commit is contained in:
parent
98471e952a
commit
f1c03b8a49
18
Gruntfile.js
18
Gruntfile.js
|
@ -1,5 +1,9 @@
|
|||
'use strict';
|
||||
|
||||
module.exports = function(grunt) {
|
||||
|
||||
require('load-grunt-tasks')(grunt);
|
||||
|
||||
// Project Configuration
|
||||
grunt.initConfig({
|
||||
pkg: grunt.file.readJSON('package.json'),
|
||||
|
@ -238,20 +242,6 @@ module.exports = function(grunt) {
|
|||
}
|
||||
});
|
||||
|
||||
grunt.loadNpmTasks('grunt-contrib-concat');
|
||||
grunt.loadNpmTasks('grunt-contrib-copy');
|
||||
grunt.loadNpmTasks('grunt-contrib-watch');
|
||||
grunt.loadNpmTasks('grunt-contrib-uglify');
|
||||
grunt.loadNpmTasks('grunt-angular-gettext');
|
||||
grunt.loadNpmTasks('grunt-browserify');
|
||||
grunt.loadNpmTasks('grunt-exec');
|
||||
grunt.loadNpmTasks('grunt-karma');
|
||||
grunt.loadNpmTasks('grunt-karma-coveralls');
|
||||
grunt.loadNpmTasks('grunt-node-webkit-builder');
|
||||
grunt.loadNpmTasks('grunt-contrib-compress');
|
||||
grunt.loadNpmTasks('grunt-string-replace');
|
||||
grunt.loadNpmTasks('grunt-contrib-sass');
|
||||
|
||||
grunt.registerTask('default', ['nggettext_compile', 'exec:version', 'exec:coinbase', 'browserify', 'sass', 'concat', 'copy:icons']);
|
||||
grunt.registerTask('prod', ['default', 'uglify']);
|
||||
grunt.registerTask('translate', ['nggettext_extract']);
|
||||
|
|
43
README.md
43
README.md
|
@ -5,7 +5,7 @@
|
|||
|
||||
Copay is an easy-to-use, open-source, multiplatform, multisignature, secure bitcoin wallet platform for both individuals and companies. Copay uses [Bitcore Wallet Service](https://github.com/bitpay/bitcore-wallet-service) (BWS) for peer synchronization and network interfacing.
|
||||
|
||||
Binary versions of Copay are available for download at [Copay.io](https://copay.io/#download). Copay Binaries are signed with the key copay@bitpay.com [See here for details](https://github.com/bitpay/copay#how-to-verify-copay-signatures)
|
||||
Binary versions of Copay are available for download at [Copay.io](https://copay.io/#download). Copay Binaries are signed with the key `copay@bitpay.com` – See the section [`How to Verify Copay Signatures`](https://github.com/bitpay/copay#how-to-verify-copay-signatures) for details.
|
||||
|
||||
## Main Features
|
||||
|
||||
|
@ -27,35 +27,25 @@ Binary versions of Copay are available for download at [Copay.io](https://copay.
|
|||
- Multiple languages supported
|
||||
- Available for [iOS](https://itunes.apple.com/us/app/copay/id951330296), [Android](https://play.google.com/store/apps/details?id=com.bitpay.copay&hl=en), [Windows Phone](http://www.windowsphone.com/en-us/store/app/copay-wallet/4372479b-a064-4d18-8bd3-74a3bdb81c3a), [Chrome App](https://chrome.google.com/webstore/detail/copay/cnidaodnidkbaplmghlelgikaiejfhja?hl=en), [Linux](https://github.com/bitpay/copay/releases/latest), [Windows](https://github.com/bitpay/copay/releases/latest) and [OS X](https://github.com/bitpay/copay/releases/latest) devices
|
||||
|
||||
## Installation
|
||||
## Install For Development
|
||||
|
||||
Clone the source:
|
||||
Clone the repo and open the directory:
|
||||
|
||||
```sh
|
||||
git clone https://github.com/bitpay/copay.git
|
||||
cd copay
|
||||
```
|
||||
|
||||
Install [bower](http://bower.io/) and [grunt](http://gruntjs.com/getting-started) if you haven't already:
|
||||
Ensure you have [Node](https://nodejs.org/) installed, then install and start Copay:
|
||||
|
||||
```sh
|
||||
npm install -g bower
|
||||
npm install -g grunt-cli
|
||||
```
|
||||
|
||||
Build Copay:
|
||||
|
||||
```sh
|
||||
sudo gem install sass
|
||||
bower install
|
||||
npm install
|
||||
grunt
|
||||
npm start
|
||||
```
|
||||
|
||||
Then visit `localhost:3000` in your browser.
|
||||
Visit [`localhost:3000`](http://localhost:3000/) to view the app.
|
||||
|
||||
> **Note:** Other browser extensions could have access to Copay internal data and compromise the user's private key when running Copay as a web page. For optimal security, you should disable all third-party browser extensions when using Copay in this manner.
|
||||
> **Note:** This method should only be used for development purposes. When running Copay in a normal browser environment, browser extensions and other malicious code might have access to internal data and private keys. For production use, see the latest official [releases](https://github.com/bitpay/copay/releases/).
|
||||
|
||||
## Build Copay App Bundles
|
||||
|
||||
|
@ -151,7 +141,7 @@ Previous versions of Copay used files as backups. See the following section.
|
|||
It is possible to recover funds from a Copay Wallet without using Copay or the Wallet Service, check the [Copay Recovery Tool](https://github.com/bitpay/copay-recovery).
|
||||
|
||||
|
||||
## Wallet Export format
|
||||
## Wallet Export Format
|
||||
|
||||
Copay encrypts the backup with the [Stanford JS Crypto Library](http://bitwiseshiftleft.github.io/sjcl/). To extract the private key of your wallet you can use https://bitwiseshiftleft.github.io/sjcl/demo/, copy the backup to 'ciphertext' and enter your password. The resulting JSON will have a key named: `xPrivKey`, that is the extended private key of your wallet. That information is enough to sign any transaction from your wallet, so be careful when handling it!
|
||||
|
||||
|
@ -227,34 +217,35 @@ This will download all partial and complete language translations while also cle
|
|||
|
||||
*Gracias totales!*
|
||||
|
||||
## Release schedules
|
||||
## Release Schedules
|
||||
Copay uses the `MAJOR.MINOR.BATCH` convention for versioning. Any release that adds features should modify the MINOR or MAJOR number.
|
||||
|
||||
### Bug Fixing Releases
|
||||
|
||||
We release bug fixes as soon as possible for all platforms. Usually around a week after patches, a new release is made with language translation updates (like 1.1.4 and then 1.1.5). There is no coordination so all platforms are updated at the same time.
|
||||
|
||||
### Minor and Major releases
|
||||
### Minor and Major Releases
|
||||
- t+0: tag the release 1.2 and "text lock" (meaning only non-text related bug fixes. Though this rule is sometimes broken, it's good to make a rule.)
|
||||
- t+7: testing for 1.2 is finished, translation is also finished, and 1.2.1 is tagged with all translations along with bug fixes made in the last week.
|
||||
- t+7: iOS is submitted for 1.2.1. All other platforms are submitted with auto-release off.
|
||||
- t + (~17): All platforms 1.2.1 are released when Apple approves the iOS application update.
|
||||
|
||||
## How to verify Copay signatures
|
||||
## How to Verify Copay Signatures
|
||||
|
||||
1. Download the `copay@bitpay.com` public key (`gpg --recv-keys 1112CFA1`)
|
||||
2. Download Copay binary (`$FILENAME`) and signature file (`$FILENAME.sig`)
|
||||
3. Verify the signature by running:
|
||||
|
||||
1. Download copay@bitpay.com public key (`gpg --recv-keys 1112CFA1`)
|
||||
1. Download Copay binary ($FILENAME) and signature file ($FILENAME.sig)
|
||||
1. Check it by running:
|
||||
``` bash
|
||||
$ gpg --verify \
|
||||
$FILENAME.sig \
|
||||
$FILENAME
|
||||
|
||||
# It should say:
|
||||
"Good signature from "Copay (visit copay.io) <copay@bitpay.com>"
|
||||
# It should return:
|
||||
Good signature from "Copay (visit copay.io) <copay@bitpay.com>"
|
||||
```
|
||||
|
||||
### Public Key for Copay binaries
|
||||
### Public Key for Copay Binaries
|
||||
Instead of importing the public key from a public server (like gnu's) you can grab it from here:
|
||||
|
||||
```
|
||||
|
|
10
package.json
10
package.json
|
@ -58,21 +58,26 @@
|
|||
"shelljs": "^0.3.0"
|
||||
},
|
||||
"scripts": {
|
||||
"preinstall": "bower install",
|
||||
"postinstall": "npm run build",
|
||||
"build": "grunt",
|
||||
"start": "node app.js",
|
||||
"test": "./node_modules/.bin/grunt test-coveralls"
|
||||
"test": "./node_modules/.bin/grunt test-coveralls",
|
||||
"clean": "git clean -dfx"
|
||||
},
|
||||
"devDependencies": {
|
||||
"adm-zip": "^0.4.7",
|
||||
"angular": "1.4.6",
|
||||
"angular-mocks": "1.4.10",
|
||||
"bhttp": "^1.2.1",
|
||||
"bower": "^1.7.9",
|
||||
"chai": "^3.5.0",
|
||||
"cordova": "5.4.1",
|
||||
"cordova-android": "5.1.1",
|
||||
"grunt-contrib-sass": "^1.0.0",
|
||||
"grunt-karma": "^1.0.0",
|
||||
"grunt-karma-coveralls": "^2.5.4",
|
||||
"grunt-node-webkit-builder": "^1.0.2",
|
||||
"grunt-sass": "^1.2.0",
|
||||
"grunt-string-replace": "^1.2.1",
|
||||
"karma": "^0.13.22",
|
||||
"karma-chai": "^0.1.0",
|
||||
|
@ -83,6 +88,7 @@
|
|||
"karma-mocha-reporter": "^2.0.3",
|
||||
"karma-phantomjs-launcher": "^1.0.0",
|
||||
"karma-sinon": "^1.0.5",
|
||||
"load-grunt-tasks": "^3.5.0",
|
||||
"mocha": "^2.4.5",
|
||||
"phantomjs-prebuilt": "^2.1.7",
|
||||
"xcode": "^0.8.2"
|
||||
|
|
Loading…
Reference in New Issue