Skip to content

Commit 2d9675b

Browse files
committed
Documentation update
1 parent 9151a24 commit 2d9675b

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

83 files changed

+1425
-1285
lines changed

CHANGELOG.md

+50-228
Large diffs are not rendered by default.

Contributing.md

+12-6
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
# Git Workflow
2+
23
This project is a monorepo that uses lerna to link dependencies.
34

45
https://github.com/lerna/lerna
@@ -8,7 +9,8 @@ This mono repo should contain the commits from all of the packages.
89
Each package has it's own repo.
910

1011
## Packages
11-
Each package is in the packages directory.
12+
13+
Each package is in the packages directory.
1214

1315
Code changes that touch multiple modules should be done on the bitcore repo.
1416
This way one branch can update multiple modules.
@@ -17,36 +19,40 @@ Lengthy developments on a single package should be done on that package's repo.
1719
Once the package is at a good point, it should be merged into the monorepo
1820

1921
## Updating Packages From Their Own Repo
22+
2023
The monorepo packages can be updated via git subtrees, then submitted to the bitcore repo as a MR
2124

2225
Example:
23-
```
26+
27+
```sh
2428
git co -b feature/bitcore-node-update
2529
git subtree pull --prefix=packages/bitcore-node [email protected]:bitpay/bitcore-node.git branchToPull
2630
git push -u origin feature/bitcore-node-update
2731
# Create MR from origin:feature/bitcore-node-update to upstream:bitcore
2832
```
2933

30-
3134
## Updating Repos from Bitcore Package
35+
3236
Changes to the mono repo can be pushed to the package repo.
33-
```
37+
38+
```sh
3439
git subtree push --prefix=packages/bitcore-node [email protected]:micahriggan/bitcore-node.git branchToPush
3540
```
3641

3742
## Adding New Packages from Existing Repos
43+
3844
Packages can be added via Lerna or via git subtrees.
3945

40-
```
46+
```sh
4147
lerna import ~/somedir/path-to-bitcore-repo --flatten
4248
# OR
4349
git subtree add --prefix=packages/bitcore-repo-to-add [email protected]:bitpay/bitcore-repo-to-add.git branchToAdd
4450
```
4551

4652
This will merge all of the commits into the bitcore history
4753

54+
## Dev Dependencies
4855

49-
# Dev Dependencies
5056
Dev dependencies that are used on multiple packages can be hoisted to the top-level
5157

5258
Linters, formatters, and other standards can be defined top-level for the monorepo

README.md

+44-26
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,31 @@
1-
Bitcore Node
2-
============
3-
_Requirements_:
1+
# Bitcore
2+
3+
**Infrastructure to build Bitcoin and blockchain-based applications for the next generation of financial technology.**
4+
5+
## Getting Started
6+
7+
### Requirements
8+
49
- Trusted P2P Peer
510
- MongoDB Server >= v3.4
611

7-
Checkout the repo
12+
### Checkout the repo
813

9-
```
14+
```sh
1015
git clone [email protected]:bitpay/bitcore.git
1116
git checkout master
1217
npm install
1318
```
1419

1520
## Setup Guide
1621

17-
**1. Setup Bitcore config**
22+
### 1. Setup Bitcore config
1823

1924
<details>
2025
<summary>Example bitcore.config.json</summary>
2126
<br>
2227

23-
```
28+
```json
2429
{
2530
"bitcoreNode": {
2631
"chains": {
@@ -95,15 +100,13 @@ npm install
95100
```
96101

97102
</details>
98-
<br>
99103

100-
**2. Setup Bitcoin Node**
104+
### 2. Setup Bitcoin Node
101105

102106
<details>
103107
<summary>Example Bitcoin Mainnet Config</summary>
104-
<br>
105108

106-
```
109+
```sh
107110
whitelist=127.0.0.1
108111
txindex=0
109112
listen=1
@@ -124,44 +127,59 @@ rpcallowip=127.0.0.1
124127
rpcuser=username
125128
rpcpassword=password
126129
```
130+
127131
</details>
128-
<br>
129132

130-
**3. Run Bitcoin node**
133+
### 3. Run Bitcoin node
134+
131135
<details>
132136
<summary>Example Starting a Bitcoin Node</summary>
133-
<br>
134-
135-
```
137+
138+
```sh
136139
# Path to your bitcoin application and path to the config above
137140
/Applications/Bitcoin-Qt.app/Contents/MacOS/Bitcoin-Qt -datadir=/Users/username/blockchains/bitcoin-core/networks/mainnet/
138141
```
139142

140143
</details>
141-
<br>
142144

143-
**4. Start Bitcore**
145+
### 4. Start Bitcore
144146

145-
```
147+
```sh
146148
npm run node
147149
```
148150

149-
## API Documentation
151+
## Applications
152+
153+
- [Bitcore Node](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-node) - A full node with extended capabilities using Bitcoin Core
154+
- [Bitcore Wallet](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-wallet) - A command-line based wallet client
155+
- [Bitcore Wallet Client](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-wallet-client) - A client for the wallet service
156+
- [Bitcore Wallet Service](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-wallet-service) - A multisig HD service for wallets
157+
- [Bitpay Wallet](https://github.com/bitpay/copay) - An easy-to-use, multiplatform, multisignature, secure bitcoin wallet
158+
- [Insight](https://github.com/bitpay/bitcore/tree/master/packages/insight-previous) - A blockchain explorer web user interface
150159

151-
[REST API parameters and example responses](./packages/bitcore-node/docs/api-documentation.md)
160+
## Libraries
152161

153-
[Websockets API namespaces, event names, and parameters](./packages/bitcore-node/docs/sockets-api.md)
162+
- [Bitcore Channel](https://github.com/bitpay/bitcore-channel) - Micropayment channels for rapidly adjusting bitcoin transactions
163+
- [Bitcore ECIES](https://github.com/bitpay/bitcore-ecies) - Uses ECIES symmetric key negotiation from public keys to encrypt arbitrarily long data streams
164+
- [Bitcore Lib](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-lib) - A pure and powerful JavaScript Bitcoin library
165+
- [Bitcore Lib Cash](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-lib-cash) - A pure and powerful JavaScript Bitcoin Cash library
166+
- [Bitcore Message](https://github.com/bitpay/bitcore-message) - Bitcoin message verification and signing
167+
- [Bitcore Mnemonic](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-mnemonic) - Implements mnemonic code for generating deterministic keys
168+
- [Bitcore P2P](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-p2p) - The peer-to-peer networking protocol for BTC
169+
- [Bitcore P2P Cash](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-p2p-cash) - The peer-to-peer networking protocol for BCH
170+
- [Crypto Wallet Core](https://github.com/bitpay/bitcore/tree/master/packages/crypto-wallet-core) - A coin-agnostic wallet library for creating transactions, signing, and address derivation
154171

155-
[Testing Bitcore-node in RegTest](./packages/bitcore-node/docs/wallet-guide.md)
172+
## Extras
156173

157-
[Wallet Guide - Creating, Signing, Import Address](./packages/bitcore-client/README.md)
174+
- [Bitcore Build](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-build) - A helper to add tasks to gulp
175+
- [Bitcore Client](https://github.com/bitpay/bitcore/tree/master/packages/bitcore-client) - A helper to create a wallet using the bitcore-v8 infrastructure
158176

159177
## Contributing
160178

161-
See [CONTRIBUTING.md](https://github.com/bitpay/bitcore) on the main bitcore repo for information about how to contribute.
179+
See [CONTRIBUTING.md](https://github.com/bitpay/bitcore/blob/master/Contributing.md) on the main bitcore repo for information about how to contribute.
162180

163181
## License
164182

165183
Code released under [the MIT license](https://github.com/bitpay/bitcore/blob/master/LICENSE).
166184

167-
Copyright 2015-2019 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.
185+
Copyright 2013-2019 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.

packages/bitcore-build/CHANGELOG.md

+2-10
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,8 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
77

88
**Note:** Version bump only for package bitcore-build
99

10-
11-
12-
13-
14-
# [8.1.0](https://github.com/bitpay/bitcore-build/compare/v5.0.0-beta.44...v8.1.0) (2019-02-27)
10+
## [8.1.0](https://github.com/bitpay/bitcore-build/compare/v5.0.0-beta.44...v8.1.0) (2019-02-27)
1511

1612
**Note:** Version bump only for package bitcore-build
1713

18-
19-
20-
21-
22-
# [8.0.0](https://github.com/bitpay/bitcore-build/compare/v5.0.0-beta.44...v8.0.0) (2019-02-27)
14+
## [8.0.0](https://github.com/bitpay/bitcore-build/compare/v5.0.0-beta.44...v8.0.0) (2019-02-27)

packages/bitcore-build/README.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# bitcore-build
1+
# Bitcore Build
22

3-
A helper to add tasks to gulp.
3+
**A helper to add tasks to gulp.**
44

55
## Getting started
66

@@ -10,7 +10,7 @@ Install with:
1010
npm install bitcore-build
1111
```
1212

13-
and use and require in your gulp file:
13+
And use and require in your gulp file:
1414

1515
```javascript
1616
var gulp = require('gulp');
@@ -22,20 +22,20 @@ gulp.task('default', ['lint', 'test', 'browser', 'coverage']);
2222

2323
### Notes
2424

25-
* There's no default task to allow for each submodule to set up their own configuration
26-
* If the module is node-only, avoid adding the browser tasks with:
25+
- There's no default task to allow for each submodule to set up their own configuration
26+
- If the module is node-only, avoid adding the browser tasks with:
27+
2728
```javascript
2829
var bitcoreTasks = require('bitcore-build');
2930
bitcoreTasks('submodule', {skipBrowsers: true});
3031
```
3132

3233
## Contributing
3334

34-
See [CONTRIBUTING.md](https://github.com/bitpay/bitcore) on the main bitcore repo for information about how to contribute.
35+
See [CONTRIBUTING.md](https://github.com/bitpay/bitcore/blob/master/Contributing.md) on the main bitcore repo for information about how to contribute.
3536

3637
## License
3738

3839
Code released under [the MIT license](https://github.com/bitpay/bitcore/blob/master/LICENSE).
3940

40-
Copyright 2015 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.
41-
41+
Copyright 2013-2019 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.

packages/bitcore-client/CHANGELOG.md

+2-16
Original file line numberDiff line numberDiff line change
@@ -7,44 +7,30 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
77

88
**Note:** Version bump only for package bitcore-client
99

10-
11-
12-
13-
14-
# [8.1.0](https://github.com/nitsujlangston/bitcore/compare/v5.0.0-beta.44...v8.1.0) (2019-02-27)
15-
10+
## [8.1.0](https://github.com/nitsujlangston/bitcore/compare/v5.0.0-beta.44...v8.1.0) (2019-02-27)
1611

1712
### Features
1813

1914
* **api:** Adds check wallet endpoint ([a606095](https://github.com/nitsujlangston/bitcore/commit/a606095))
2015

21-
2216
### Performance Improvements
2317

2418
* **wallet api:** improve wallet transaction list performance ([7491e6f](https://github.com/nitsujlangston/bitcore/commit/7491e6f))
2519

26-
2720
### BREAKING CHANGES
2821

2922
* **wallet api:** no longer page based on _id
3023

31-
32-
33-
34-
35-
# [8.0.0](https://github.com/nitsujlangston/bitcore/compare/v5.0.0-beta.44...v8.0.0) (2019-02-27)
36-
24+
## [8.0.0](https://github.com/nitsujlangston/bitcore/compare/v5.0.0-beta.44...v8.0.0) (2019-02-27)
3725

3826
### Features
3927

4028
* **api:** Adds check wallet endpoint ([a606095](https://github.com/nitsujlangston/bitcore/commit/a606095))
4129

42-
4330
### Performance Improvements
4431

4532
* **wallet api:** improve wallet transaction list performance ([7491e6f](https://github.com/nitsujlangston/bitcore/commit/7491e6f))
4633

47-
4834
### BREAKING CHANGES
4935

5036
* **wallet api:** no longer page based on _id

0 commit comments

Comments
 (0)