mirror of
https://github.com/fluencelabs/js-peer-id
synced 2025-07-04 20:31:54 +00:00
Compare commits
80 Commits
Author | SHA1 | Date | |
---|---|---|---|
464c92a53b | |||
8a608def32 | |||
19deeff432 | |||
b18c0082ff | |||
2b050bcaa1 | |||
b19edf2ab2 | |||
35b384ed15 | |||
655ceec29b | |||
8b9a134276 | |||
a637297112 | |||
e666b7284f | |||
156911e162 | |||
f91f2b6506 | |||
8f6935499e | |||
80da1a54b2 | |||
300266ad51 | |||
3abdcdabbb | |||
7d3cb8e87c | |||
a57c0c6f14 | |||
d7088d6650 | |||
c945d6ad48 | |||
0eee1a2a69 | |||
63428faae9 | |||
a38e3859d2 | |||
551fd710be | |||
442df13a11 | |||
156088db99 | |||
9c0c648001 | |||
a2934aa371 | |||
ac98b7582a | |||
0dc3c14f2b | |||
af6575d06c | |||
ccf0b7875c | |||
733b40bb47 | |||
ac27907241 | |||
e206c46549 | |||
41d3e5be5b | |||
bc213dd818 | |||
3f4f670691 | |||
d2894bfa32 | |||
c3e3b70d09 | |||
f08866047d | |||
a3fe1a2f03 | |||
0acc572fd3 | |||
8c49610dff | |||
e1ffe9bba5 | |||
e59010b439 | |||
60b1c09665 | |||
b28b8ef693 | |||
961b218a53 | |||
0642070fdd | |||
3da91b92fa | |||
ad9a43b7c8 | |||
c67bf150f2 | |||
a2afb2aeea | |||
6624c27d8d | |||
26ac06d21c | |||
f0d72b7bfe | |||
78d96d0b14 | |||
bebb0a7eae | |||
5d6a962b6c | |||
531c9f1086 | |||
06f93cd961 | |||
1452f233c8 | |||
77900c7b45 | |||
564489b0ea | |||
65c2ac8dca | |||
31701e236d | |||
e08907ff94 | |||
f6a42fef76 | |||
ba8aa3ff34 | |||
ae81e95927 | |||
d24500a042 | |||
5fec44833e | |||
2432c56ad5 | |||
f0e380af58 | |||
24cd31b2d1 | |||
5f9136b3ca | |||
4fe3e12b3c | |||
49d454da7d |
16
.aegir.js
16
.aegir.js
@ -1,16 +0,0 @@
|
|||||||
'use strict'
|
|
||||||
|
|
||||||
const path = require('path')
|
|
||||||
|
|
||||||
module.exports = {
|
|
||||||
webpack: {
|
|
||||||
resolve: {
|
|
||||||
alias: {
|
|
||||||
'node-forge': path.resolve(
|
|
||||||
path.dirname(require.resolve('libp2p-crypto')),
|
|
||||||
'../vendor/forge.bundle.js'
|
|
||||||
)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
21
.gitignore
vendored
21
.gitignore
vendored
@ -1,7 +1,15 @@
|
|||||||
|
docs
|
||||||
|
**/node_modules/
|
||||||
|
**/*.log
|
||||||
|
test/repo-tests*
|
||||||
|
**/bundle.js
|
||||||
|
|
||||||
# Logs
|
# Logs
|
||||||
logs
|
logs
|
||||||
*.log
|
*.log
|
||||||
|
|
||||||
|
coverage
|
||||||
|
|
||||||
# Runtime data
|
# Runtime data
|
||||||
pids
|
pids
|
||||||
*.pid
|
*.pid
|
||||||
@ -19,12 +27,19 @@ coverage
|
|||||||
# node-waf configuration
|
# node-waf configuration
|
||||||
.lock-wscript
|
.lock-wscript
|
||||||
|
|
||||||
# Compiled binary addons (http://nodejs.org/api/addons.html)
|
build
|
||||||
build/Release
|
|
||||||
|
|
||||||
# Dependency directory
|
# Dependency directory
|
||||||
# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
|
# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
|
||||||
node_modules
|
node_modules
|
||||||
|
|
||||||
|
docs
|
||||||
lib
|
lib
|
||||||
dist
|
dist
|
||||||
|
test/test-data/go-ipfs-repo/LOCK
|
||||||
|
test/test-data/go-ipfs-repo/LOG
|
||||||
|
test/test-data/go-ipfs-repo/LOG.old
|
||||||
|
|
||||||
|
# while testing npm5
|
||||||
|
package-lock.json
|
||||||
|
yarn.lock
|
||||||
|
29
.travis.yml
29
.travis.yml
@ -1,25 +1,32 @@
|
|||||||
|
# Warning: This file is automatically synced from https://github.com/ipfs/ci-sync so if you want to change it, please change it there and ask someone to sync all repositories.
|
||||||
sudo: false
|
sudo: false
|
||||||
language: node_js
|
language: node_js
|
||||||
node_js:
|
|
||||||
- 4
|
|
||||||
- 5
|
|
||||||
- stable
|
|
||||||
|
|
||||||
# Make sure we have new NPM.
|
matrix:
|
||||||
before_install:
|
include:
|
||||||
- npm install -g npm
|
- node_js: 6
|
||||||
|
env: CXX=g++-4.8
|
||||||
|
- node_js: 8
|
||||||
|
env: CXX=g++-4.8
|
||||||
|
# - node_js: stable
|
||||||
|
# env: CXX=g++-4.8
|
||||||
|
|
||||||
script:
|
script:
|
||||||
- npm run lint
|
- npm run lint
|
||||||
- npm test
|
- npm run test
|
||||||
- npm run coverage
|
- npm run coverage
|
||||||
|
|
||||||
addons:
|
|
||||||
firefox: 'latest'
|
|
||||||
|
|
||||||
before_script:
|
before_script:
|
||||||
- export DISPLAY=:99.0
|
- export DISPLAY=:99.0
|
||||||
- sh -e /etc/init.d/xvfb start
|
- sh -e /etc/init.d/xvfb start
|
||||||
|
|
||||||
after_success:
|
after_success:
|
||||||
- npm run coverage-publish
|
- npm run coverage-publish
|
||||||
|
|
||||||
|
addons:
|
||||||
|
firefox: 'latest'
|
||||||
|
apt:
|
||||||
|
sources:
|
||||||
|
- ubuntu-toolchain-r-test
|
||||||
|
packages:
|
||||||
|
- g++-4.8
|
||||||
|
236
CHANGELOG.md
Normal file
236
CHANGELOG.md
Normal file
@ -0,0 +1,236 @@
|
|||||||
|
<a name="0.10.6"></a>
|
||||||
|
## [0.10.6](https://github.com/libp2p/js-peer-id/compare/v0.10.5...v0.10.6) (2018-02-12)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.10.5"></a>
|
||||||
|
## [0.10.5](https://github.com/libp2p/js-peer-id/compare/v0.10.4...v0.10.5) (2018-01-28)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.10.4"></a>
|
||||||
|
## [0.10.4](https://github.com/libp2p/js-peer-id/compare/v0.10.3...v0.10.4) (2017-12-20)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* update dependencies ([#73](https://github.com/libp2p/js-peer-id/issues/73)) ([8b9a134](https://github.com/libp2p/js-peer-id/commit/8b9a134))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.10.3"></a>
|
||||||
|
## [0.10.3](https://github.com/libp2p/js-peer-id/compare/v0.10.2...v0.10.3) (2017-12-01)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* catch error when unmarshaling instead of crashing ([#72](https://github.com/libp2p/js-peer-id/issues/72)) ([156911e](https://github.com/libp2p/js-peer-id/commit/156911e))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.10.2"></a>
|
||||||
|
## [0.10.2](https://github.com/libp2p/js-peer-id/compare/v0.10.1...v0.10.2) (2017-10-12)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* Always add public key to constructor if possible, Fix for undefined pubKey in remote peers ([#68](https://github.com/libp2p/js-peer-id/issues/68)) ([3abdcda](https://github.com/libp2p/js-peer-id/commit/3abdcda))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.10.1"></a>
|
||||||
|
## [0.10.1](https://github.com/libp2p/js-peer-id/compare/v0.10.0...v0.10.1) (2017-09-07)
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* **deps:** update aegir and libp2p-crypto ([#67](https://github.com/libp2p/js-peer-id/issues/67)) ([d7088d6](https://github.com/libp2p/js-peer-id/commit/d7088d6))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.10.0"></a>
|
||||||
|
# [0.10.0](https://github.com/libp2p/js-peer-id/compare/v0.9.0...v0.10.0) (2017-09-03)
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* p2p addrs situation ([#66](https://github.com/libp2p/js-peer-id/issues/66)) ([63428fa](https://github.com/libp2p/js-peer-id/commit/63428fa))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.9.0"></a>
|
||||||
|
# [0.9.0](https://github.com/libp2p/js-peer-id/compare/v0.8.8...v0.9.0) (2017-07-22)
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* use next libp2p-crypto ([#64](https://github.com/libp2p/js-peer-id/issues/64)) ([442df13](https://github.com/libp2p/js-peer-id/commit/442df13))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.8.8"></a>
|
||||||
|
## [0.8.8](https://github.com/libp2p/js-peer-id/compare/v0.8.7...v0.8.8) (2017-07-21)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.8.7"></a>
|
||||||
|
## [0.8.7](https://github.com/libp2p/js-peer-id/compare/v0.8.6...v0.8.7) (2017-04-03)
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* set privKey pubKey ([ac27907](https://github.com/libp2p/js-peer-id/commit/ac27907))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.8.6"></a>
|
||||||
|
## [0.8.6](https://github.com/libp2p/js-peer-id/compare/v0.8.5...v0.8.6) (2017-03-30)
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* isEqual ([3f4f670](https://github.com/libp2p/js-peer-id/commit/3f4f670))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.8.5"></a>
|
||||||
|
## [0.8.5](https://github.com/libp2p/js-peer-id/compare/v0.8.4...v0.8.5) (2017-03-27)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* avoid using constructor.name ([a3fe1a2](https://github.com/libp2p/js-peer-id/commit/a3fe1a2))
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* isPeerId ([0acc572](https://github.com/libp2p/js-peer-id/commit/0acc572))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.8.4"></a>
|
||||||
|
## [0.8.4](https://github.com/libp2p/js-peer-id/compare/v0.8.2...v0.8.4) (2017-03-16)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.8.2"></a>
|
||||||
|
## [0.8.2](https://github.com/libp2p/js-peer-id/compare/v0.8.1...v0.8.2) (2017-02-09)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.8.1"></a>
|
||||||
|
## [0.8.1](https://github.com/libp2p/js-peer-id/compare/v0.8.0...v0.8.1) (2016-12-18)
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* cache b58 id ([bebb0a7](https://github.com/libp2p/js-peer-id/commit/bebb0a7))
|
||||||
|
* create b58 string on creation and throw on id mutation ([78d96d0](https://github.com/libp2p/js-peer-id/commit/78d96d0))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.8.0"></a>
|
||||||
|
# [0.8.0](https://github.com/libp2p/js-peer-id/compare/v0.7.0...v0.8.0) (2016-11-03)
|
||||||
|
|
||||||
|
|
||||||
|
* Async Crypto Endeavour (#33) ([31701e2](https://github.com/libp2p/js-peer-id/commit/31701e2))
|
||||||
|
|
||||||
|
|
||||||
|
### BREAKING CHANGES
|
||||||
|
|
||||||
|
* This changes the interface of .create, .createFromPrivKey,
|
||||||
|
.createFromPubKey, .createFromJSON
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.7.0"></a>
|
||||||
|
# [0.7.0](https://github.com/libp2p/js-peer-id/compare/v0.6.7...v0.7.0) (2016-05-26)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* code review and docs and go interop ([58f1933](https://github.com/libp2p/js-peer-id/commit/58f1933))
|
||||||
|
* use new version of libp2p-crypto ([ab55046](https://github.com/libp2p/js-peer-id/commit/ab55046))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.6.7"></a>
|
||||||
|
## [0.6.7](https://github.com/libp2p/js-peer-id/compare/v0.6.6...v0.6.7) (2016-05-23)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.6.6"></a>
|
||||||
|
## [0.6.6](https://github.com/libp2p/js-peer-id/compare/v0.6.5...v0.6.6) (2016-04-12)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.6.5"></a>
|
||||||
|
## [0.6.5](https://github.com/libp2p/js-peer-id/compare/v0.6.1...v0.6.5) (2016-04-12)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.6.1"></a>
|
||||||
|
## [0.6.1](https://github.com/libp2p/js-peer-id/compare/v0.6.0...v0.6.1) (2016-03-15)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.6.0"></a>
|
||||||
|
# [0.6.0](https://github.com/libp2p/js-peer-id/compare/v0.5.3...v0.6.0) (2016-03-10)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.5.3"></a>
|
||||||
|
## [0.5.3](https://github.com/libp2p/js-peer-id/compare/v0.5.1...v0.5.3) (2016-03-05)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.5.1"></a>
|
||||||
|
## [0.5.1](https://github.com/libp2p/js-peer-id/compare/v0.5.0...v0.5.1) (2016-03-03)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.5.0"></a>
|
||||||
|
# [0.5.0](https://github.com/libp2p/js-peer-id/compare/v0.4.0...v0.5.0) (2016-02-14)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.4.0"></a>
|
||||||
|
# [0.4.0](https://github.com/libp2p/js-peer-id/compare/v0.3.4...v0.4.0) (2015-11-05)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.3.4"></a>
|
||||||
|
## [0.3.4](https://github.com/libp2p/js-peer-id/compare/v0.3.3...v0.3.4) (2015-10-28)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.3.3"></a>
|
||||||
|
## [0.3.3](https://github.com/libp2p/js-peer-id/compare/v0.3.2...v0.3.3) (2015-09-15)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.3.2"></a>
|
||||||
|
## [0.3.2](https://github.com/libp2p/js-peer-id/compare/v0.3.1...v0.3.2) (2015-09-14)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.3.1"></a>
|
||||||
|
## [0.3.1](https://github.com/libp2p/js-peer-id/compare/v0.3.0...v0.3.1) (2015-08-25)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.3.0"></a>
|
||||||
|
# [0.3.0](https://github.com/libp2p/js-peer-id/compare/v0.2.0...v0.3.0) (2015-07-19)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.2.0"></a>
|
||||||
|
# [0.2.0](https://github.com/libp2p/js-peer-id/compare/v0.1.0...v0.2.0) (2015-07-17)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="0.1.0"></a>
|
||||||
|
# 0.1.0 (2015-07-08)
|
||||||
|
|
||||||
|
|
||||||
|
|
90
README.md
90
README.md
@ -2,41 +2,66 @@
|
|||||||
|
|
||||||
[](http://ipn.io)
|
[](http://ipn.io)
|
||||||
[](http://webchat.freenode.net/?channels=%23ipfs)
|
[](http://webchat.freenode.net/?channels=%23ipfs)
|
||||||
[](https://travis-ci.org/diasdavid/js-peer-id)
|
[](https://travis-ci.org/libp2p/js-peer-id)
|
||||||
[](https://coveralls.io/github/diasdavid/js-peer-id?branch=master)
|
[](https://coveralls.io/github/libp2p/js-peer-id?branch=master)
|
||||||
[](https://david-dm.org/diasdavid/js-peer-id)
|
[](https://david-dm.org/libp2p/js-peer-id)
|
||||||
[](https://github.com/feross/standard)
|
[](https://github.com/feross/standard)
|
||||||
|

|
||||||
|

|
||||||
|
|
||||||
> [IPFS](https://github.com/ipfs/ipfs) Peer ID implementation in JavaScript.
|
> [IPFS](https://github.com/ipfs/ipfs) Peer ID implementation in JavaScript.
|
||||||
|
|
||||||
|
- [Description](#description)
|
||||||
|
- [Example](#example)
|
||||||
|
- [Installation](#installation)
|
||||||
|
- [npm](#npm)
|
||||||
|
- [Setup](#setup)
|
||||||
|
- [Node.js](#nodejs)
|
||||||
|
- [Browser: Browserify, Webpack, other bundlers](#browser-browserify-webpack-other-bundlers)
|
||||||
|
- [Browser: `<script>` Tag](#browser-script-tag)
|
||||||
|
- [API](#api)
|
||||||
|
- [Create](#create)
|
||||||
|
- [`new PeerId(id[, privKey, pubKey])`](#new-peeridid-privkey-pubkey)
|
||||||
|
- [`create([opts], callback)`](#createopts-callback)
|
||||||
|
- [Import](#import)
|
||||||
|
- [`createFromHexString(str)`](#createfromhexstringstr)
|
||||||
|
- [`createFromBytes(buf)`](#createfrombytesbuf)
|
||||||
|
- [`createFromB58String(str)`](#createfromb58stringstr)
|
||||||
|
- [`createFromPubKey(pubKey)`](#createfrompubkeypubkey)
|
||||||
|
- [`createFromPrivKey(privKey)`](#createfromprivkeyprivkey)
|
||||||
|
- [`createFromJSON(obj)`](#createfromjsonobj)
|
||||||
|
- [Export](#export)
|
||||||
|
- [`toHexString()`](#tohexstring)
|
||||||
|
- [`toBytes()`](#tobytes)
|
||||||
|
- [`toB58String()`](#tob58string)
|
||||||
|
- [`toJSON()`](#tojson)
|
||||||
|
- [`toPrint()`](#toprint)
|
||||||
|
- [License](#license)
|
||||||
|
|
||||||
# Description
|
# Description
|
||||||
|
|
||||||
Generate, import, and export PeerIDs, for use with [IPFS](https://github.com/ipfs/ipfs).
|
Generate, import, and export PeerIDs, for use with [IPFS](https://github.com/ipfs/ipfs).
|
||||||
|
|
||||||
*A Peer ID is the SHA-256 [multihash](https://github.com/jbenet/multihash) of a
|
A Peer ID is the SHA-256 [multihash](https://github.com/multiformats/multihash) of a public key.
|
||||||
public key.*
|
|
||||||
|
|
||||||
*The public key is a base64 encoded string of a protobuf containing an RSA DER
|
The public key is a base64 encoded string of a protobuf containing an RSA DER buffer. This uses a node buffer to pass the base64 encoded public key protobuf to the multihash for ID generation.
|
||||||
buffer. This uses a node buffer to pass the base64 encoded public key protobuf
|
|
||||||
to the multihash for ID generation.*
|
|
||||||
|
|
||||||
# Example
|
# Example
|
||||||
|
|
||||||
```js
|
```JavaScript
|
||||||
var PeerId = require('peer-id')
|
const PeerId = require('peer-id')
|
||||||
var bs58 = require('bs58')
|
|
||||||
|
|
||||||
var id = PeerId.create({ bits: 32 })
|
PeerId.create({ bits: 1024 }, (err, id) => {
|
||||||
|
if (err) { throw err }
|
||||||
console.log('id ', id.toB58String())
|
console.log(JSON.stringify(id.toJSON(), null, 2))
|
||||||
console.log('priv key ', bs58.encode(id.privKey.bytes))
|
})
|
||||||
console.log('pub key ', bs58.encode(id.pubKey.bytes))
|
|
||||||
```
|
```
|
||||||
|
```bash
|
||||||
```
|
{
|
||||||
id QmeeLFb92nkZJGj3gXLqXrEMzCMYs6uBgQLVNbrcXEvYXk
|
"id": "Qma9T5YraSnpRDZqRR4krcSJabThc8nwZuJV3LercPHufi",
|
||||||
priv key 6ibrcPAbevzvPpkq6EA6XmLyuhmUrJrEvUfgQDtEiSEPzGnGU8Ejwf6b11DVm6opnFGo
|
"privKey": "CAAS4AQwggJcAgEAAoGBAMBgbIqyOL26oV3nGPBYrdpbv..",
|
||||||
pub key 2BeBZVKJ9RQs4i4LbGv4ReEeuBA5dck2Gje3wt67e44XuyyPq5jE
|
"pubKey": "CAASogEwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMBgbIqyOL26oV3nGPBYrdpbvzCY..."
|
||||||
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
# Installation
|
# Installation
|
||||||
@ -52,7 +77,7 @@ pub key 2BeBZVKJ9RQs4i4LbGv4ReEeuBA5dck2Gje3wt67e44XuyyPq5jE
|
|||||||
## Node.js
|
## Node.js
|
||||||
|
|
||||||
```js
|
```js
|
||||||
var PeerId = require('peer-id')
|
const PeerId = require('peer-id')
|
||||||
```
|
```
|
||||||
|
|
||||||
## Browser: Browserify, Webpack, other bundlers
|
## Browser: Browserify, Webpack, other bundlers
|
||||||
@ -63,7 +88,7 @@ it and use with your favourite bundler without having to adjust asset management
|
|||||||
process.
|
process.
|
||||||
|
|
||||||
```js
|
```js
|
||||||
var PeerId = require('peer-id')
|
const PeerId = require('peer-id')
|
||||||
```
|
```
|
||||||
|
|
||||||
## Browser: `<script>` Tag
|
## Browser: `<script>` Tag
|
||||||
@ -72,9 +97,9 @@ Loading this module through a script tag will make the `PeerId` obj available in
|
|||||||
the global namespace.
|
the global namespace.
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://npmcdn.com/peer-id/dist/index.min.js"></script>
|
<script src="https://unpkg.com/peer-id/dist/index.min.js"></script>
|
||||||
<!-- OR -->
|
<!-- OR -->
|
||||||
<script src="https://npmcdn.com/peer-id/dist/index.js"></script>
|
<script src="https://unpkg.com/peer-id/dist/index.js"></script>
|
||||||
```
|
```
|
||||||
|
|
||||||
# API
|
# API
|
||||||
@ -91,13 +116,16 @@ const PeerId = require('peer-id')
|
|||||||
- `privKey: RsaPrivateKey` - The private key
|
- `privKey: RsaPrivateKey` - The private key
|
||||||
- `pubKey: RsaPublicKey` - The public key
|
- `pubKey: RsaPublicKey` - The public key
|
||||||
|
|
||||||
The key format is detailed in [libp2p-crypto](https://github.com/ipfs/js-libp2p-crypto).
|
The key format is detailed in [libp2p-crypto](https://github.com/libp2p/js-libp2p-crypto).
|
||||||
|
|
||||||
### `create([opts])`
|
### `create([opts], callback)`
|
||||||
|
|
||||||
Generates a new Peer ID, complete with public/private keypair.
|
Generates a new Peer ID, complete with public/private keypair.
|
||||||
|
|
||||||
- `opts: Object`: Default: `{bits: 2048}`
|
- `opts: Object`: Default: `{bits: 2048}`
|
||||||
|
- `callback: Function`
|
||||||
|
|
||||||
|
Calls back `callback` with `err, id`.
|
||||||
|
|
||||||
## Import
|
## Import
|
||||||
|
|
||||||
@ -114,10 +142,14 @@ Creates a Peer ID from a Base58 string representing the key's multihash.
|
|||||||
|
|
||||||
### `createFromPubKey(pubKey)`
|
### `createFromPubKey(pubKey)`
|
||||||
|
|
||||||
|
- `publicKey: Buffer`
|
||||||
|
|
||||||
Creates a Peer ID from a buffer containing a public key.
|
Creates a Peer ID from a buffer containing a public key.
|
||||||
|
|
||||||
### `createFromPrivKey(privKey)`
|
### `createFromPrivKey(privKey)`
|
||||||
|
|
||||||
|
- `privKey: Buffer`
|
||||||
|
|
||||||
Creates a Peer ID from a buffer containing a private key.
|
Creates a Peer ID from a buffer containing a private key.
|
||||||
|
|
||||||
### `createFromJSON(obj)`
|
### `createFromJSON(obj)`
|
||||||
@ -126,7 +158,6 @@ Creates a Peer ID from a buffer containing a private key.
|
|||||||
- `obj.pubKey: String` - The public key in protobuf format, encoded in 'base64'
|
- `obj.pubKey: String` - The public key in protobuf format, encoded in 'base64'
|
||||||
- `obj.privKey: String` - The private key in protobuf format, encoded in 'base 64'
|
- `obj.privKey: String` - The private key in protobuf format, encoded in 'base 64'
|
||||||
|
|
||||||
|
|
||||||
## Export
|
## Export
|
||||||
|
|
||||||
### `toHexString()`
|
### `toHexString()`
|
||||||
@ -166,6 +197,9 @@ Returns an `obj` of the form
|
|||||||
|
|
||||||
Alias for `.toJSON()`.
|
Alias for `.toJSON()`.
|
||||||
|
|
||||||
|
### `isEqual(id)`
|
||||||
|
|
||||||
|
- `id` can be a PeerId or a Buffer containing the id
|
||||||
|
|
||||||
# License
|
# License
|
||||||
|
|
||||||
|
29
appveyor.yml
Normal file
29
appveyor.yml
Normal file
@ -0,0 +1,29 @@
|
|||||||
|
# Warning: This file is automatically synced from https://github.com/ipfs/ci-sync so if you want to change it, please change it there and ask someone to sync all repositories.
|
||||||
|
version: "{build}"
|
||||||
|
|
||||||
|
environment:
|
||||||
|
matrix:
|
||||||
|
- nodejs_version: "6"
|
||||||
|
- nodejs_version: "8"
|
||||||
|
|
||||||
|
matrix:
|
||||||
|
fast_finish: true
|
||||||
|
|
||||||
|
install:
|
||||||
|
# Install Node.js
|
||||||
|
- ps: Install-Product node $env:nodejs_version
|
||||||
|
|
||||||
|
# Upgrade npm
|
||||||
|
- npm install -g npm
|
||||||
|
|
||||||
|
# Output our current versions for debugging
|
||||||
|
- node --version
|
||||||
|
- npm --version
|
||||||
|
|
||||||
|
# Install our package dependencies
|
||||||
|
- npm install
|
||||||
|
|
||||||
|
test_script:
|
||||||
|
- npm run test:node
|
||||||
|
|
||||||
|
build: off
|
2
ci/Jenkinsfile
vendored
Normal file
2
ci/Jenkinsfile
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
// Warning: This file is automatically synced from https://github.com/ipfs/ci-sync so if you want to change it, please change it there and ask someone to sync all repositories.
|
||||||
|
javascript()
|
@ -1,3 +1,4 @@
|
|||||||
|
# Warning: This file is automatically synced from https://github.com/ipfs/ci-sync so if you want to change it, please change it there and ask someone to sync all repositories.
|
||||||
machine:
|
machine:
|
||||||
node:
|
node:
|
||||||
version: stable
|
version: stable
|
||||||
@ -5,8 +6,10 @@ machine:
|
|||||||
dependencies:
|
dependencies:
|
||||||
pre:
|
pre:
|
||||||
- google-chrome --version
|
- google-chrome --version
|
||||||
- wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
|
- curl -L -o google-chrome.deb https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
|
||||||
- sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google.list'
|
- sudo dpkg -i google-chrome.deb || true
|
||||||
- sudo apt-get update
|
- sudo apt-get update
|
||||||
- sudo apt-get --only-upgrade install google-chrome-stable
|
- sudo apt-get install -f
|
||||||
|
- sudo apt-get install --only-upgrade lsb-base
|
||||||
|
- sudo dpkg -i google-chrome.deb
|
||||||
- google-chrome --version
|
- google-chrome --version
|
||||||
|
60
package.json
60
package.json
@ -1,21 +1,19 @@
|
|||||||
{
|
{
|
||||||
"name": "peer-id",
|
"name": "peer-id",
|
||||||
"version": "0.7.0",
|
"version": "0.10.6",
|
||||||
"description": "IPFS Peer Id implementation in Node.js",
|
"description": "IPFS Peer Id implementation in Node.js",
|
||||||
"main": "lib/index.js",
|
"main": "src/index.js",
|
||||||
"bin": "src/bin.js",
|
"bin": "src/bin.js",
|
||||||
"jsnext:main": "src/index.js",
|
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"lint": "aegir-lint",
|
"lint": "aegir lint",
|
||||||
"build": "aegir-build",
|
"build": "aegir build",
|
||||||
"test": "aegir-test",
|
"test": "aegir test",
|
||||||
"test:node": "aegir-test node",
|
"test:node": "aegir test -t node",
|
||||||
"test:browser": "aegir-test browser",
|
"test:browser": "aegir test -t browser -t webworker",
|
||||||
"release": "aegir-release",
|
"release": "aegir release",
|
||||||
"release-minor": "aegir-release --type minor",
|
"release-minor": "aegir release --type minor",
|
||||||
"release-major": "aegir-release --type major",
|
"release-major": "aegir release --type major",
|
||||||
"coverage": "aegir-coverage",
|
"coverage": "aegir coverage"
|
||||||
"coverage-publish": "aegir-coverage publish"
|
|
||||||
},
|
},
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"IPFS"
|
"IPFS"
|
||||||
@ -27,30 +25,42 @@
|
|||||||
"test"
|
"test"
|
||||||
],
|
],
|
||||||
"engines": {
|
"engines": {
|
||||||
"node": "^4.3.0"
|
"node": ">=6.0.0",
|
||||||
|
"npm": ">=3.0.0"
|
||||||
},
|
},
|
||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/diasdavid/js-peer-id/issues"
|
"url": "https://github.com/libp2p/js-peer-id/issues"
|
||||||
},
|
},
|
||||||
"homepage": "https://github.com/diasdavid/js-peer-id",
|
"homepage": "https://github.com/libp2p/js-peer-id",
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"aegir": "^3.1.1",
|
"aegir": "^12.4.0",
|
||||||
"chai": "^3.5.0",
|
"chai": "^4.1.2",
|
||||||
"pre-commit": "^1.1.3"
|
"dirty-chai": "^2.0.1",
|
||||||
|
"pre-commit": "^1.2.2"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"libp2p-crypto": "^0.5.0",
|
"async": "^2.6.0",
|
||||||
"multihashes": "^0.2.2"
|
"libp2p-crypto": "~0.12.1",
|
||||||
|
"lodash": "^4.17.5",
|
||||||
|
"multihashes": "~0.4.13"
|
||||||
},
|
},
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
"url": "https://github.com/diasdavid/js-peer-id.git"
|
"url": "https://github.com/libp2p/js-peer-id.git"
|
||||||
},
|
},
|
||||||
"contributors": [
|
"contributors": [
|
||||||
"David Dias <daviddias.p@gmail.com>",
|
"David Dias <daviddias.p@gmail.com>",
|
||||||
"David Dias <mail@daviddias.me>",
|
"David Dias <mail@daviddias.me>",
|
||||||
|
"Friedel Ziegelmayer <dignifiedquire@gmail.com>",
|
||||||
|
"Maciej Krüger <mkg20001@gmail.com>",
|
||||||
|
"Prashanth Chandra <coolshanth94@gmail.com>",
|
||||||
|
"Richard Littauer <richard.littauer@gmail.com>",
|
||||||
|
"Richard Schneider <makaretu@gmail.com>",
|
||||||
"Stephen Whitmore <stephen.whitmore@gmail.com>",
|
"Stephen Whitmore <stephen.whitmore@gmail.com>",
|
||||||
"dignifiedquire <dignifiedquire@gmail.com>",
|
"Yahya <ya7yaz@gmail.com>",
|
||||||
"nginnever <ginneversource@gmail.com>"
|
"greenkeeperio-bot <support@greenkeeper.io>",
|
||||||
|
"nginnever <ginneversource@gmail.com>",
|
||||||
|
"npmcdn-to-unpkg-bot <npmcdn-to-unpkg-bot@users.noreply.github.com>",
|
||||||
|
"ᴠɪᴄᴛᴏʀ ʙᴊᴇʟᴋʜᴏʟᴍ <victorbjelkholm@gmail.com>"
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
@ -4,4 +4,10 @@
|
|||||||
|
|
||||||
const PeerId = require('./index.js')
|
const PeerId = require('./index.js')
|
||||||
|
|
||||||
console.log(JSON.stringify(PeerId.create().toJSON(), null, ' '))
|
PeerId.create((err, id) => {
|
||||||
|
if (err) {
|
||||||
|
throw err
|
||||||
|
}
|
||||||
|
|
||||||
|
console.log(JSON.stringify(id.toJSON(), null, 2))
|
||||||
|
})
|
||||||
|
224
src/index.js
224
src/index.js
@ -7,51 +7,63 @@
|
|||||||
const mh = require('multihashes')
|
const mh = require('multihashes')
|
||||||
const crypto = require('libp2p-crypto')
|
const crypto = require('libp2p-crypto')
|
||||||
const assert = require('assert')
|
const assert = require('assert')
|
||||||
|
const waterfall = require('async/waterfall')
|
||||||
|
|
||||||
class PeerId {
|
class PeerId {
|
||||||
constructor (id, privKey, pubKey) {
|
constructor (id, privKey, pubKey) {
|
||||||
assert(Buffer.isBuffer(id), 'invalid id provided')
|
assert(Buffer.isBuffer(id), 'invalid id provided')
|
||||||
|
|
||||||
if (pubKey) {
|
|
||||||
assert(id.equals(pubKey.hash()), 'inconsistent arguments')
|
|
||||||
}
|
|
||||||
|
|
||||||
if (privKey) {
|
|
||||||
assert(id.equals(privKey.public.hash()), 'inconsistent arguments')
|
|
||||||
}
|
|
||||||
|
|
||||||
if (privKey && pubKey) {
|
if (privKey && pubKey) {
|
||||||
assert(privKey.public.bytes.equals(pubKey.bytes), 'inconsistent arguments')
|
assert(privKey.public.bytes.equals(pubKey.bytes), 'inconsistent arguments')
|
||||||
}
|
}
|
||||||
|
|
||||||
this.id = id
|
this._id = id
|
||||||
this.privKey = privKey
|
this._idB58String = mh.toB58String(this.id)
|
||||||
|
this._privKey = privKey
|
||||||
this._pubKey = pubKey
|
this._pubKey = pubKey
|
||||||
}
|
}
|
||||||
|
|
||||||
|
get id () {
|
||||||
|
return this._id
|
||||||
|
}
|
||||||
|
|
||||||
|
set id (val) {
|
||||||
|
throw new Error('Id is immutable')
|
||||||
|
}
|
||||||
|
|
||||||
|
get privKey () {
|
||||||
|
return this._privKey
|
||||||
|
}
|
||||||
|
|
||||||
|
set privKey (privKey) {
|
||||||
|
this._privKey = privKey
|
||||||
|
}
|
||||||
|
|
||||||
get pubKey () {
|
get pubKey () {
|
||||||
if (this._pubKey) {
|
if (this._pubKey) {
|
||||||
return this._pubKey
|
return this._pubKey
|
||||||
}
|
}
|
||||||
|
|
||||||
if (this.privKey) {
|
if (this._privKey) {
|
||||||
return this.privKey.public
|
return this._privKey.public
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Return the protobuf version of the public key,
|
set pubKey (pubKey) {
|
||||||
// matching go ipfs formatting
|
this._pubKey = pubKey
|
||||||
|
}
|
||||||
|
|
||||||
|
// Return the protobuf version of the public key, matching go ipfs formatting
|
||||||
marshalPubKey () {
|
marshalPubKey () {
|
||||||
if (this.pubKey) {
|
if (this.pubKey) {
|
||||||
return crypto.marshalPublicKey(this.pubKey)
|
return crypto.keys.marshalPublicKey(this.pubKey)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Return the protobuf version of the private key,
|
// Return the protobuf version of the private key, matching go ipfs formatting
|
||||||
// matching go ipfs formatting
|
|
||||||
marshalPrivKey () {
|
marshalPrivKey () {
|
||||||
if (this.privKey) {
|
if (this.privKey) {
|
||||||
return crypto.marshalPrivateKey(this.privKey)
|
return crypto.keys.marshalPrivateKey(this.privKey)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -64,7 +76,7 @@ class PeerId {
|
|||||||
// of go-ipfs for its config file
|
// of go-ipfs for its config file
|
||||||
toJSON () {
|
toJSON () {
|
||||||
return {
|
return {
|
||||||
id: mh.toB58String(this.id),
|
id: this.toB58String(),
|
||||||
privKey: toB64Opt(this.marshalPrivKey()),
|
privKey: toB64Opt(this.marshalPrivKey()),
|
||||||
pubKey: toB64Opt(this.marshalPubKey())
|
pubKey: toB64Opt(this.marshalPubKey())
|
||||||
}
|
}
|
||||||
@ -80,21 +92,59 @@ class PeerId {
|
|||||||
}
|
}
|
||||||
|
|
||||||
toB58String () {
|
toB58String () {
|
||||||
return mh.toB58String(this.id)
|
return this._idB58String
|
||||||
|
}
|
||||||
|
|
||||||
|
isEqual (id) {
|
||||||
|
if (Buffer.isBuffer(id)) {
|
||||||
|
return this.id.equals(id)
|
||||||
|
} else if (id.id) {
|
||||||
|
return this.id.equals(id.id)
|
||||||
|
} else {
|
||||||
|
throw new Error('not valid Id')
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Check if this PeerId instance is valid (privKey -> pubKey -> Id)
|
||||||
|
*/
|
||||||
|
isValid (callback) {
|
||||||
|
// TODO Needs better checking
|
||||||
|
if (this.privKey &&
|
||||||
|
this.privKey.public &&
|
||||||
|
this.privKey.public.bytes &&
|
||||||
|
Buffer.isBuffer(this.pubKey.bytes) &&
|
||||||
|
this.privKey.public.bytes.equals(this.pubKey.bytes)) {
|
||||||
|
callback()
|
||||||
|
} else {
|
||||||
|
callback(new Error('Keys not match'))
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
exports = module.exports = PeerId
|
exports = module.exports = PeerId
|
||||||
exports.Buffer = Buffer
|
|
||||||
|
|
||||||
// generation
|
// generation
|
||||||
exports.create = function (opts) {
|
exports.create = function (opts, callback) {
|
||||||
|
if (typeof opts === 'function') {
|
||||||
|
callback = opts
|
||||||
|
opts = {}
|
||||||
|
}
|
||||||
opts = opts || {}
|
opts = opts || {}
|
||||||
opts.bits = opts.bits || 2048
|
opts.bits = opts.bits || 2048
|
||||||
|
|
||||||
const privKey = crypto.generateKeyPair('RSA', opts.bits)
|
waterfall([
|
||||||
|
(cb) => crypto.keys.generateKeyPair('RSA', opts.bits, cb),
|
||||||
|
(privKey, cb) => privKey.public.hash((err, digest) => {
|
||||||
|
cb(err, digest, privKey)
|
||||||
|
})
|
||||||
|
], (err, digest, privKey) => {
|
||||||
|
if (err) {
|
||||||
|
return callback(err)
|
||||||
|
}
|
||||||
|
|
||||||
return new PeerId(privKey.public.hash(), privKey)
|
callback(null, new PeerId(digest, privKey))
|
||||||
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
exports.createFromHexString = function (str) {
|
exports.createFromHexString = function (str) {
|
||||||
@ -110,39 +160,125 @@ exports.createFromB58String = function (str) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// Public Key input will be a buffer
|
// Public Key input will be a buffer
|
||||||
exports.createFromPubKey = function (key) {
|
exports.createFromPubKey = function (key, callback) {
|
||||||
let buf = key
|
if (typeof callback !== 'function') {
|
||||||
if (typeof buf === 'string') {
|
throw new Error('callback is required')
|
||||||
buf = new Buffer(key, 'base64')
|
|
||||||
}
|
}
|
||||||
const pubKey = crypto.unmarshalPublicKey(buf)
|
|
||||||
return new PeerId(pubKey.hash(), null, pubKey)
|
let pubKey
|
||||||
|
|
||||||
|
try {
|
||||||
|
let buf = key
|
||||||
|
if (typeof buf === 'string') {
|
||||||
|
buf = Buffer.from(key, 'base64')
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!Buffer.isBuffer(buf)) throw new Error('Supplied key is neither a base64 string nor a buffer')
|
||||||
|
|
||||||
|
pubKey = crypto.keys.unmarshalPublicKey(buf)
|
||||||
|
} catch (err) {
|
||||||
|
return callback(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
pubKey.hash((err, digest) => {
|
||||||
|
if (err) {
|
||||||
|
return callback(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
callback(null, new PeerId(digest, null, pubKey))
|
||||||
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
// Private key input will be a string
|
// Private key input will be a string
|
||||||
exports.createFromPrivKey = function (key) {
|
exports.createFromPrivKey = function (key, callback) {
|
||||||
let buf = key
|
if (typeof callback !== 'function') {
|
||||||
if (typeof buf === 'string') {
|
throw new Error('callback is required')
|
||||||
buf = new Buffer(key, 'base64')
|
|
||||||
}
|
}
|
||||||
|
|
||||||
const privKey = crypto.unmarshalPrivateKey(buf)
|
let buf = key
|
||||||
return new PeerId(privKey.public.hash(), privKey)
|
|
||||||
|
try {
|
||||||
|
if (typeof buf === 'string') {
|
||||||
|
buf = Buffer.from(key, 'base64')
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!Buffer.isBuffer(buf)) throw new Error('Supplied key is neither a base64 string nor a buffer')
|
||||||
|
} catch (err) {
|
||||||
|
return callback(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
waterfall([
|
||||||
|
(cb) => crypto.keys.unmarshalPrivateKey(buf, cb),
|
||||||
|
(privKey, cb) => privKey.public.hash((err, digest) => {
|
||||||
|
cb(err, digest, privKey)
|
||||||
|
})
|
||||||
|
], (err, digest, privKey) => {
|
||||||
|
if (err) {
|
||||||
|
return callback(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
callback(null, new PeerId(digest, privKey, privKey.public))
|
||||||
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
exports.createFromJSON = function (obj) {
|
exports.createFromJSON = function (obj, callback) {
|
||||||
let priv
|
if (typeof callback !== 'function') {
|
||||||
|
throw new Error('callback is required')
|
||||||
|
}
|
||||||
|
|
||||||
|
let id
|
||||||
|
let rawPrivKey
|
||||||
|
let rawPubKey
|
||||||
let pub
|
let pub
|
||||||
|
|
||||||
if (obj.privKey) {
|
try {
|
||||||
priv = crypto.unmarshalPrivateKey(new Buffer(obj.privKey, 'base64'))
|
id = mh.fromB58String(obj.id)
|
||||||
|
rawPrivKey = obj.privKey && Buffer.from(obj.privKey, 'base64')
|
||||||
|
rawPubKey = obj.pubKey && Buffer.from(obj.pubKey, 'base64')
|
||||||
|
pub = rawPubKey && crypto.keys.unmarshalPublicKey(rawPubKey)
|
||||||
|
} catch (err) {
|
||||||
|
return callback(err)
|
||||||
}
|
}
|
||||||
|
|
||||||
if (obj.pubKey) {
|
if (rawPrivKey) {
|
||||||
pub = crypto.unmarshalPublicKey(new Buffer(obj.pubKey, 'base64'))
|
waterfall([
|
||||||
}
|
(cb) => crypto.keys.unmarshalPrivateKey(rawPrivKey, cb),
|
||||||
|
(priv, cb) => priv.public.hash((err, digest) => {
|
||||||
|
cb(err, digest, priv)
|
||||||
|
}),
|
||||||
|
(privDigest, priv, cb) => {
|
||||||
|
if (pub) {
|
||||||
|
pub.hash((err, pubDigest) => {
|
||||||
|
cb(err, privDigest, priv, pubDigest)
|
||||||
|
})
|
||||||
|
} else {
|
||||||
|
cb(null, privDigest, priv)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
], (err, privDigest, priv, pubDigest) => {
|
||||||
|
if (err) {
|
||||||
|
return callback(err)
|
||||||
|
}
|
||||||
|
|
||||||
return new PeerId(mh.fromB58String(obj.id), priv, pub)
|
if (pub && !privDigest.equals(pubDigest)) {
|
||||||
|
return callback(new Error('Public and private key do not match'))
|
||||||
|
}
|
||||||
|
|
||||||
|
if (id && !privDigest.equals(id)) {
|
||||||
|
return callback(new Error('Id and private key do not match'))
|
||||||
|
}
|
||||||
|
|
||||||
|
callback(null, new PeerId(id, priv, pub))
|
||||||
|
})
|
||||||
|
} else {
|
||||||
|
callback(null, new PeerId(id, null, pub))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
exports.isPeerId = function (peerId) {
|
||||||
|
return Boolean(typeof peerId === 'object' &&
|
||||||
|
peerId._id &&
|
||||||
|
peerId._idB58String)
|
||||||
}
|
}
|
||||||
|
|
||||||
function toB64Opt (val) {
|
function toB64Opt (val) {
|
||||||
|
@ -1,170 +0,0 @@
|
|||||||
/* eslint-env mocha */
|
|
||||||
'use strict'
|
|
||||||
|
|
||||||
const expect = require('chai').expect
|
|
||||||
const crypto = require('libp2p-crypto')
|
|
||||||
const mh = require('multihashes')
|
|
||||||
|
|
||||||
const PeerId = require('../src')
|
|
||||||
|
|
||||||
const testId = require('./fixtures/sample-id')
|
|
||||||
const testIdHex = testId.id
|
|
||||||
const testIdBytes = mh.fromHexString(testId.id)
|
|
||||||
const testIdB58String = mh.toB58String(testIdBytes)
|
|
||||||
|
|
||||||
const goId = require('./fixtures/go-private-key')
|
|
||||||
|
|
||||||
describe('PeerId', () => {
|
|
||||||
it('create an id without \'new\'', () => {
|
|
||||||
expect(PeerId).to.throw(Error)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('create a new id', () => {
|
|
||||||
const id = PeerId.create()
|
|
||||||
expect(id.toB58String().length).to.equal(46)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('recreate an Id from Hex string', () => {
|
|
||||||
const id = PeerId.createFromHexString(testIdHex)
|
|
||||||
expect(testIdBytes).to.deep.equal(id.id)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('Recreate an Id from a Buffer', () => {
|
|
||||||
const id = PeerId.createFromBytes(testIdBytes)
|
|
||||||
expect(testId.id).to.equal(id.toHexString())
|
|
||||||
})
|
|
||||||
|
|
||||||
it('Recreate a B58 String', () => {
|
|
||||||
const id = PeerId.createFromB58String(testIdB58String)
|
|
||||||
expect(testIdB58String).to.equal(id.toB58String())
|
|
||||||
})
|
|
||||||
|
|
||||||
it('Recreate from a Public Key', () => {
|
|
||||||
const id = PeerId.createFromPubKey(testId.pubKey)
|
|
||||||
expect(testIdB58String).to.equal(id.toB58String())
|
|
||||||
})
|
|
||||||
|
|
||||||
it('Recreate from a Private Key', () => {
|
|
||||||
const id = PeerId.createFromPrivKey(testId.privKey)
|
|
||||||
expect(testIdB58String).to.equal(id.toB58String())
|
|
||||||
|
|
||||||
const id2 = PeerId.createFromPrivKey(new Buffer(testId.privKey, 'base64'))
|
|
||||||
expect(testIdB58String).to.equal(id2.toB58String())
|
|
||||||
})
|
|
||||||
|
|
||||||
it('Compare generated ID with one created from PubKey', () => {
|
|
||||||
const id1 = PeerId.create()
|
|
||||||
const id2 = PeerId.createFromPubKey(id1.marshalPubKey())
|
|
||||||
expect(id1.id).to.be.eql(id2.id)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('Non-default # of bits', () => {
|
|
||||||
const shortId = PeerId.create({ bits: 128 })
|
|
||||||
const longId = PeerId.create({ bits: 256 })
|
|
||||||
expect(shortId.privKey.bytes.length).is.below(longId.privKey.bytes.length)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('Pretty printing', () => {
|
|
||||||
const id = PeerId.createFromPrivKey(testId.privKey)
|
|
||||||
const out = id.toPrint()
|
|
||||||
|
|
||||||
expect(out.id).to.equal(testIdB58String)
|
|
||||||
expect(out.privKey).to.equal(testId.privKey)
|
|
||||||
expect(out.pubKey).to.equal(testId.pubKey)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('toBytes', () => {
|
|
||||||
const id = PeerId.createFromHexString(testIdHex)
|
|
||||||
expect(id.toBytes().toString('hex')).to.equal(testIdBytes.toString('hex'))
|
|
||||||
})
|
|
||||||
|
|
||||||
describe('toJSON', () => {
|
|
||||||
it('full node', () => {
|
|
||||||
const id = PeerId.create({bits: 64})
|
|
||||||
expect(
|
|
||||||
id.toB58String()
|
|
||||||
).to.equal(
|
|
||||||
PeerId.createFromJSON(id.toJSON()).toB58String()
|
|
||||||
)
|
|
||||||
expect(
|
|
||||||
id.privKey.bytes
|
|
||||||
).to.deep.equal(
|
|
||||||
PeerId.createFromJSON(id.toJSON()).privKey.bytes
|
|
||||||
)
|
|
||||||
expect(
|
|
||||||
id.pubKey.bytes
|
|
||||||
).to.deep.equal(
|
|
||||||
PeerId.createFromJSON(id.toJSON()).pubKey.bytes
|
|
||||||
)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('only id', () => {
|
|
||||||
const key = crypto.generateKeyPair('RSA', 64)
|
|
||||||
const id = PeerId.createFromBytes(key.public.hash())
|
|
||||||
expect(
|
|
||||||
id.toB58String()
|
|
||||||
).to.equal(
|
|
||||||
PeerId.createFromJSON(id.toJSON()).toB58String()
|
|
||||||
)
|
|
||||||
|
|
||||||
expect(id.privKey).to.not.exist
|
|
||||||
expect(id.pubKey).to.not.exist
|
|
||||||
})
|
|
||||||
|
|
||||||
it('go interop', () => {
|
|
||||||
const id = PeerId.createFromJSON(goId)
|
|
||||||
|
|
||||||
expect(
|
|
||||||
mh.toB58String(id.privKey.public.hash())
|
|
||||||
).to.be.eql(
|
|
||||||
goId.id
|
|
||||||
)
|
|
||||||
})
|
|
||||||
})
|
|
||||||
|
|
||||||
describe('throws on inconsistent data', () => {
|
|
||||||
const k1 = crypto.generateKeyPair('RSA', 64)
|
|
||||||
const k2 = crypto.generateKeyPair('RSA', 64)
|
|
||||||
const k3 = crypto.generateKeyPair('RSA', 64)
|
|
||||||
|
|
||||||
it('missmatch id - private key', () => {
|
|
||||||
expect(
|
|
||||||
() => new PeerId(k1.public.hash(), k2)
|
|
||||||
).to.throw(
|
|
||||||
/inconsistent arguments/
|
|
||||||
)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('missmatch id - public key', () => {
|
|
||||||
expect(
|
|
||||||
() => new PeerId(k1.public.hash(), null, k2.public)
|
|
||||||
).to.throw(
|
|
||||||
/inconsistent arguments/
|
|
||||||
)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('missmatch private - public key', () => {
|
|
||||||
expect(
|
|
||||||
() => new PeerId(k1.public.hash(), k1, k2.public)
|
|
||||||
).to.throw(
|
|
||||||
/inconsistent arguments/
|
|
||||||
)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('missmatch id - private - public key', () => {
|
|
||||||
expect(
|
|
||||||
() => new PeerId(k1.public.hash(), k1, k3.public)
|
|
||||||
).to.throw(
|
|
||||||
/inconsistent arguments/
|
|
||||||
)
|
|
||||||
})
|
|
||||||
|
|
||||||
it('invalid id', () => {
|
|
||||||
expect(
|
|
||||||
() => new PeerId(k1.public.hash().toString())
|
|
||||||
).to.throw(
|
|
||||||
/invalid id/
|
|
||||||
)
|
|
||||||
})
|
|
||||||
})
|
|
||||||
})
|
|
310
test/peer-id.spec.js
Normal file
310
test/peer-id.spec.js
Normal file
@ -0,0 +1,310 @@
|
|||||||
|
/* eslint max-nested-callbacks: ["error", 8] */
|
||||||
|
/* eslint-env mocha */
|
||||||
|
'use strict'
|
||||||
|
|
||||||
|
const chai = require('chai')
|
||||||
|
const dirtyChai = require('dirty-chai')
|
||||||
|
chai.use(dirtyChai)
|
||||||
|
const expect = chai.expect
|
||||||
|
const crypto = require('libp2p-crypto')
|
||||||
|
const mh = require('multihashes')
|
||||||
|
const parallel = require('async/parallel')
|
||||||
|
|
||||||
|
const PeerId = require('../src')
|
||||||
|
|
||||||
|
const util = require('util')
|
||||||
|
|
||||||
|
const testId = require('./fixtures/sample-id')
|
||||||
|
const testIdHex = testId.id
|
||||||
|
const testIdBytes = mh.fromHexString(testId.id)
|
||||||
|
const testIdB58String = mh.toB58String(testIdBytes)
|
||||||
|
|
||||||
|
const goId = require('./fixtures/go-private-key')
|
||||||
|
|
||||||
|
// Test options for making PeerId.create faster
|
||||||
|
// INSECURE, only use when testing
|
||||||
|
const testOpts = {
|
||||||
|
bits: 512
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('PeerId', () => {
|
||||||
|
it('create an id without \'new\'', () => {
|
||||||
|
expect(PeerId).to.throw(Error)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('create a new id', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, id) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(id.toB58String().length).to.equal(46)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('isPeerId', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, id) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(PeerId.isPeerId(id)).to.equal(true)
|
||||||
|
expect(PeerId.isPeerId('aaa')).to.equal(false)
|
||||||
|
expect(PeerId.isPeerId(Buffer.from('batatas'))).to.equal(false)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('throws on changing the id', function (done) {
|
||||||
|
this.timeout(10000)
|
||||||
|
PeerId.create(testOpts, (err, id) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(id.toB58String().length).to.equal(46)
|
||||||
|
expect(() => {
|
||||||
|
id.id = Buffer.from('hello')
|
||||||
|
}).to.throw(/immutable/)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('recreate an Id from Hex string', () => {
|
||||||
|
const id = PeerId.createFromHexString(testIdHex)
|
||||||
|
expect(testIdBytes).to.deep.equal(id.id)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Recreate an Id from a Buffer', () => {
|
||||||
|
const id = PeerId.createFromBytes(testIdBytes)
|
||||||
|
expect(testId.id).to.equal(id.toHexString())
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Recreate a B58 String', () => {
|
||||||
|
const id = PeerId.createFromB58String(testIdB58String)
|
||||||
|
expect(testIdB58String).to.equal(id.toB58String())
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Recreate from a Public Key', (done) => {
|
||||||
|
PeerId.createFromPubKey(testId.pubKey, (err, id) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(testIdB58String).to.equal(id.toB58String())
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Recreate from a Private Key', (done) => {
|
||||||
|
PeerId.createFromPrivKey(testId.privKey, (err, id) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(testIdB58String).to.equal(id.toB58String())
|
||||||
|
|
||||||
|
const encoded = Buffer.from(testId.privKey, 'base64')
|
||||||
|
PeerId.createFromPrivKey(encoded, (err, id2) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(testIdB58String).to.equal(id2.toB58String())
|
||||||
|
expect(id.marshalPubKey()).to.deep.equal(id2.marshalPubKey())
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Compare generated ID with one created from PubKey', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, id1) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
|
||||||
|
PeerId.createFromPubKey(id1.marshalPubKey(), (err, id2) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(id1.id).to.be.eql(id2.id)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Works with default options', function (done) {
|
||||||
|
this.timeout(10000)
|
||||||
|
PeerId.create((err, id) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(id.toB58String().length).to.equal(46)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Non-default # of bits', function (done) {
|
||||||
|
this.timeout(1000 * 60)
|
||||||
|
PeerId.create(testOpts, (err, shortId) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
PeerId.create({ bits: 1024 }, (err, longId) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(shortId.privKey.bytes.length).is.below(longId.privKey.bytes.length)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('Pretty printing', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, id1) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
PeerId.createFromPrivKey(id1.toPrint().privKey, (err, id2) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(id1.toPrint()).to.be.eql(id2.toPrint())
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('toBytes', () => {
|
||||||
|
const id = PeerId.createFromHexString(testIdHex)
|
||||||
|
expect(id.toBytes().toString('hex')).to.equal(testIdBytes.toString('hex'))
|
||||||
|
})
|
||||||
|
|
||||||
|
it('isEqual', (done) => {
|
||||||
|
parallel([
|
||||||
|
(cb) => PeerId.create(testOpts, cb),
|
||||||
|
(cb) => PeerId.create(testOpts, cb)
|
||||||
|
], (err, ids) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(ids[0].isEqual(ids[0])).to.equal(true)
|
||||||
|
expect(ids[0].isEqual(ids[1])).to.equal(false)
|
||||||
|
expect(ids[0].isEqual(ids[0].id)).to.equal(true)
|
||||||
|
expect(ids[0].isEqual(ids[1].id)).to.equal(false)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('fromJSON', () => {
|
||||||
|
it('full node', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, id) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
|
||||||
|
PeerId.createFromJSON(id.toJSON(), (err, other) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(id.toB58String()).to.equal(other.toB58String())
|
||||||
|
expect(id.privKey.bytes).to.eql(other.privKey.bytes)
|
||||||
|
expect(id.pubKey.bytes).to.eql(other.pubKey.bytes)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('only id', (done) => {
|
||||||
|
crypto.keys.generateKeyPair('RSA', 1024, (err, key) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
key.public.hash((err, digest) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
|
||||||
|
const id = PeerId.createFromBytes(digest)
|
||||||
|
expect(id.privKey).to.not.exist()
|
||||||
|
expect(id.pubKey).to.not.exist()
|
||||||
|
|
||||||
|
PeerId.createFromJSON(id.toJSON(), (err, other) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(id.toB58String()).to.equal(other.toB58String())
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('go interop', (done) => {
|
||||||
|
PeerId.createFromJSON(goId, (err, id) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
id.privKey.public.hash((err, digest) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(mh.toB58String(digest)).to.eql(goId.id)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('set privKey (valid)', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, peerId) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
peerId.privKey = peerId._privKey
|
||||||
|
peerId.isValid(done)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('set pubKey (valid)', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, peerId) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
peerId.pubKey = peerId._pubKey
|
||||||
|
peerId.isValid(done)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('set privKey (invalid)', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, peerId) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
peerId.privKey = Buffer.from('bufff')
|
||||||
|
peerId.isValid((err) => {
|
||||||
|
expect(err).to.exist()
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('set pubKey (invalid)', (done) => {
|
||||||
|
PeerId.create(testOpts, (err, peerId) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
peerId.pubKey = Buffer.from('buffff')
|
||||||
|
peerId.isValid((err) => {
|
||||||
|
expect(err).to.exist()
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('returns error via cb instead of crashing', () => {
|
||||||
|
const garbage = [Buffer.from('00010203040506070809', 'hex'), {}, null, false, undefined, true, 1, 0, Buffer.from(''), 'aGVsbG93b3JsZA==', 'helloworld', '']
|
||||||
|
|
||||||
|
const fncs = ['createFromPubKey', 'createFromPrivKey', 'createFromJSON']
|
||||||
|
|
||||||
|
garbage.forEach(garbage => {
|
||||||
|
fncs.forEach(fnc => {
|
||||||
|
it(fnc + '(' + util.inspect(garbage) + ')', cb => {
|
||||||
|
PeerId[fnc](garbage, (err, res) => {
|
||||||
|
expect(err).to.exist()
|
||||||
|
expect(res).to.not.exist()
|
||||||
|
cb()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('throws on inconsistent data', () => {
|
||||||
|
let k1
|
||||||
|
let k2
|
||||||
|
let k3
|
||||||
|
|
||||||
|
before((done) => {
|
||||||
|
parallel([
|
||||||
|
(cb) => crypto.keys.generateKeyPair('RSA', 512, cb),
|
||||||
|
(cb) => crypto.keys.generateKeyPair('RSA', 512, cb),
|
||||||
|
(cb) => crypto.keys.generateKeyPair('RSA', 512, cb)
|
||||||
|
], (err, keys) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
|
||||||
|
k1 = keys[0]
|
||||||
|
k2 = keys[1]
|
||||||
|
k3 = keys[2]
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('missmatch private - public key', (done) => {
|
||||||
|
k1.public.hash((err, digest) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(() => new PeerId(digest, k1, k2.public))
|
||||||
|
.to.throw(/inconsistent arguments/)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('missmatch id - private - public key', (done) => {
|
||||||
|
k1.public.hash((err, digest) => {
|
||||||
|
expect(err).to.not.exist()
|
||||||
|
expect(() => new PeerId(digest, k1, k3.public))
|
||||||
|
.to.throw(/inconsistent arguments/)
|
||||||
|
done()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('invalid id', () => {
|
||||||
|
expect(() => new PeerId('hello world')).to.throw(/invalid id/)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
Reference in New Issue
Block a user