mirror of
https://github.com/fluencelabs/js-peer-id
synced 2025-07-04 23:31:42 +00:00
Compare commits
20 Commits
Author | SHA1 | Date | |
---|---|---|---|
f3fc3449c1 | |||
927a6cf078 | |||
73fe2c553f | |||
719ddfe8e2 | |||
037ed87dac | |||
af47794289 | |||
eeb53305c8 | |||
5468ee0877 | |||
f895151451 | |||
e7d0eaa796 | |||
41ab96c47d | |||
4178e53db8 | |||
10ead07dd9 | |||
d940099131 | |||
b2ee34295b | |||
ecc1e5be6d | |||
153bc8ea38 | |||
d40d588776 | |||
224b30cb65 | |||
6d571ae196 |
47
CHANGELOG.md
47
CHANGELOG.md
@ -1,3 +1,50 @@
|
||||
## [0.14.6](https://github.com/libp2p/js-peer-id/compare/v0.14.4...v0.14.6) (2021-04-06)
|
||||
|
||||
|
||||
|
||||
## [0.14.4](https://github.com/libp2p/js-peer-id/compare/v0.14.3...v0.14.4) (2021-03-29)
|
||||
|
||||
|
||||
### Bug Fixes
|
||||
|
||||
* remove toString side effect that breaks deep equals ([#142](https://github.com/libp2p/js-peer-id/issues/142)) ([eeb5330](https://github.com/libp2p/js-peer-id/commit/eeb53305c8767a6a2b3f610fe9e45a589b4fa972)), closes [#141](https://github.com/libp2p/js-peer-id/issues/141)
|
||||
|
||||
|
||||
|
||||
## [0.14.3](https://github.com/libp2p/js-peer-id/compare/v0.14.2...v0.14.3) (2021-01-26)
|
||||
|
||||
|
||||
|
||||
<a name="0.14.2"></a>
|
||||
## [0.14.2](https://github.com/libp2p/js-peer-id/compare/v0.14.1...v0.14.2) (2020-09-23)
|
||||
|
||||
|
||||
### Features
|
||||
|
||||
* has inline public key method ([#132](https://github.com/libp2p/js-peer-id/issues/132)) ([b2ee342](https://github.com/libp2p/js-peer-id/commit/b2ee342))
|
||||
|
||||
|
||||
|
||||
<a name="0.14.1"></a>
|
||||
## [0.14.1](https://github.com/libp2p/js-peer-id/compare/v0.13.13...v0.14.1) (2020-09-03)
|
||||
|
||||
|
||||
### Bug Fixes
|
||||
|
||||
* privKey possible undefined ([#129](https://github.com/libp2p/js-peer-id/issues/129)) ([224b30c](https://github.com/libp2p/js-peer-id/commit/224b30c))
|
||||
* replace node buffers with uint8arrays ([#127](https://github.com/libp2p/js-peer-id/issues/127)) ([d16ce9c](https://github.com/libp2p/js-peer-id/commit/d16ce9c))
|
||||
* ts constructor types ([#130](https://github.com/libp2p/js-peer-id/issues/130)) ([d40d588](https://github.com/libp2p/js-peer-id/commit/d40d588))
|
||||
* typo in readme ([#128](https://github.com/libp2p/js-peer-id/issues/128)) ([6d571ae](https://github.com/libp2p/js-peer-id/commit/6d571ae))
|
||||
|
||||
|
||||
### BREAKING CHANGES
|
||||
|
||||
* - Where node Buffers were returned, now Uint8Arrays are
|
||||
|
||||
* chore: remove gh dep
|
||||
|
||||
|
||||
|
||||
<a name="0.14.0"></a>
|
||||
# [0.14.0](https://github.com/libp2p/js-peer-id/compare/v0.13.13...v0.14.0) (2020-08-07)
|
||||
|
||||
|
16
README.md
16
README.md
@ -53,6 +53,8 @@
|
||||
- [`toPrint()`](#toprint)
|
||||
- [`equals(id)`](#equalsid)
|
||||
- [`isEqual(id)`](#isequalid)
|
||||
- [Others](#others)
|
||||
- [`isPeerId(id)`](#ispeeridid)
|
||||
- [License](#license)
|
||||
|
||||
# Description
|
||||
@ -68,7 +70,7 @@ The public key is a base64 encoded string of a protobuf containing an RSA DER bu
|
||||
```JavaScript
|
||||
const PeerId = require('peer-id')
|
||||
|
||||
const id = await PeerId.create({ bits: 1024, keyType: 'rsa' })
|
||||
const id = await PeerId.create({ bits: 1024, keyType: 'RSA' })
|
||||
console.log(JSON.stringify(id.toJSON(), null, 2))
|
||||
```
|
||||
|
||||
@ -147,7 +149,7 @@ The key format is detailed in [libp2p-crypto](https://github.com/libp2p/js-libp2
|
||||
Generates a new Peer ID, complete with public/private keypair.
|
||||
|
||||
- `opts.bits: number` - The size of the key. Default: `2048`
|
||||
- `opts.keyType: string` - The key type, one of: `['rsa', 'ed25519', 'secp256k1']`. Default: `rsa`
|
||||
- `opts.keyType: string` - The key type, one of: `['RSA', 'Ed25519', 'secp256k1']`. Default: `RSA`
|
||||
|
||||
Returns `Promise<PeerId>`.
|
||||
|
||||
@ -157,7 +159,7 @@ Returns `Promise<PeerId>`.
|
||||
|
||||
Creates a Peer ID from hex string representing the key's multihash.
|
||||
|
||||
Returns `PeerId.
|
||||
Returns `PeerId`.
|
||||
|
||||
### `createFromBytes(buf)`
|
||||
|
||||
@ -285,6 +287,14 @@ Returns `true` if the given PeerId is equal to the current instance.
|
||||
|
||||
- `id` can be a PeerId or a Buffer containing the id
|
||||
|
||||
## Others
|
||||
|
||||
### `isPeerId(id)`
|
||||
|
||||
Returns `true` if the given id is an instance of PeerId
|
||||
|
||||
- `id` should be an instance of PeerId
|
||||
|
||||
# License
|
||||
|
||||
MIT
|
||||
|
41
package.json
41
package.json
@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "peer-id",
|
||||
"version": "0.14.0",
|
||||
"version": "0.14.6",
|
||||
"description": "IPFS Peer Id implementation in Node.js",
|
||||
"leadMaintainer": "Vasco Santos <santos.vasco10@gmail.com>",
|
||||
"main": "src/index.js",
|
||||
@ -8,12 +8,12 @@
|
||||
"bin": "src/bin.js",
|
||||
"scripts": {
|
||||
"lint": "aegir lint",
|
||||
"build": "aegir build",
|
||||
"build": "aegir build --no-types",
|
||||
"test": "aegir test",
|
||||
"test:node": "aegir test -t node",
|
||||
"test:browser": "aegir test -t browser -t webworker",
|
||||
"test:types": "npx tsc",
|
||||
"release": "aegir release",
|
||||
"release": "aegir release --no-types",
|
||||
"release-minor": "aegir release --type minor",
|
||||
"release-major": "aegir release --type major",
|
||||
"coverage": "aegir coverage",
|
||||
@ -36,19 +36,19 @@
|
||||
},
|
||||
"homepage": "https://github.com/libp2p/js-peer-id",
|
||||
"devDependencies": {
|
||||
"@types/chai": "^4.2.7",
|
||||
"@types/chai": "^4.2.14",
|
||||
"@types/dirty-chai": "^2.0.2",
|
||||
"@types/mocha": "^8.0.1",
|
||||
"aegir": "^25.0.0"
|
||||
"@types/mocha": "^8.2.0",
|
||||
"aegir": "^32.2.0"
|
||||
},
|
||||
"dependencies": {
|
||||
"cids": "^1.0.0",
|
||||
"cids": "^1.1.5",
|
||||
"class-is": "^1.1.0",
|
||||
"libp2p-crypto": "^0.18.0",
|
||||
"libp2p-crypto": "^0.19.0",
|
||||
"minimist": "^1.2.5",
|
||||
"multihashes": "^3.0.1",
|
||||
"multihashes": "^4.0.2",
|
||||
"protons": "^2.0.0",
|
||||
"uint8arrays": "^1.1.0"
|
||||
"uint8arrays": "^2.0.5"
|
||||
},
|
||||
"repository": {
|
||||
"type": "git",
|
||||
@ -62,22 +62,25 @@
|
||||
"Jacob Heun <jacobheun@gmail.com>",
|
||||
"Pedro Teixeira <i@pgte.me>",
|
||||
"Stephen Whitmore <stephen.whitmore@gmail.com>",
|
||||
"Alex Potsides <alex@achingbrain.net>",
|
||||
"Hugo Dias <hugomrdias@gmail.com>",
|
||||
"Maciej Krüger <mkg20001@gmail.com>",
|
||||
"Alex Potsides <alex@achingbrain.net>",
|
||||
"Robert Kiel <robert.kiel@validitylabs.org>",
|
||||
"Nate Foss <npfoss@gmail.com>",
|
||||
"Robert Kiel <robert.kiel@validitylabs.org>",
|
||||
"Adam Uhlíř <adam@uhlir.dev>",
|
||||
"ᴠɪᴄᴛᴏʀ ʙᴊᴇʟᴋʜᴏʟᴍ <victorbjelkholm@gmail.com>",
|
||||
"Arve Knudsen <arve.knudsen@gmail.com>",
|
||||
"Carson Farmer <carson.farmer@gmail.com>",
|
||||
"Christian Paul <info@jaller.de>",
|
||||
"Henrique Dias <hacdias@gmail.com>",
|
||||
"Marcin Rataj <lidel@lidel.org>",
|
||||
"Michael Garvin <gar+gh@danger.computer>",
|
||||
"Prashanth Chandra <coolshanth94@gmail.com>",
|
||||
"Richard Littauer <richard.littauer@gmail.com>",
|
||||
"Richard Schneider <makaretu@gmail.com>",
|
||||
"Marcin Rataj <lidel@lidel.org>",
|
||||
"Topper Bowers <topper@quorumcontrol.com>",
|
||||
"Henrique Dias <hacdias@gmail.com>",
|
||||
"Vojtech Simetka <vojtech@simetka.cz>",
|
||||
"Yahya <ya7yaz@gmail.com>",
|
||||
"Christian Paul <info@jaller.de>",
|
||||
"Carson Farmer <carson.farmer@gmail.com>",
|
||||
"Arve Knudsen <arve.knudsen@gmail.com>",
|
||||
"Michael Garvin <gar+gh@danger.computer>",
|
||||
"Prashanth Chandra <coolshanth94@gmail.com>"
|
||||
"a1300 <matthias-knopp@gmx.net>"
|
||||
]
|
||||
}
|
||||
|
9
src/index.d.ts
vendored
9
src/index.d.ts
vendored
@ -31,7 +31,7 @@ declare namespace PeerId {
|
||||
/**
|
||||
* Private key.
|
||||
*/
|
||||
privKey: string;
|
||||
privKey?: string;
|
||||
};
|
||||
|
||||
/**
|
||||
@ -100,7 +100,7 @@ declare namespace PeerId {
|
||||
* PeerId is an object representation of a peer identifier.
|
||||
*/
|
||||
declare class PeerId {
|
||||
constructor(id: Uint8Array | string, privKey?: PrivateKey, pubKey?: PublicKey);
|
||||
constructor(id: Uint8Array, privKey?: PrivateKey, pubKey?: PublicKey);
|
||||
|
||||
/**
|
||||
* Raw id.
|
||||
@ -183,6 +183,11 @@ declare class PeerId {
|
||||
* Check if this PeerId instance is valid (privKey -> pubKey -> Id)
|
||||
*/
|
||||
isValid(): boolean;
|
||||
|
||||
/**
|
||||
* Check if the PeerId has an inline public key.
|
||||
*/
|
||||
hasInlinePublicKey(): boolean;
|
||||
}
|
||||
|
||||
export = PeerId;
|
||||
|
26
src/index.js
26
src/index.js
@ -137,13 +137,18 @@ class PeerId {
|
||||
toString () {
|
||||
if (!this._idCIDString) {
|
||||
const cid = new CID(1, 'libp2p-key', this.id, 'base32')
|
||||
this._idCIDString = cid.toBaseEncodedString('base32')
|
||||
|
||||
Object.defineProperty(this, '_idCIDString', {
|
||||
value: cid.toBaseEncodedString('base32'),
|
||||
enumerable: false
|
||||
})
|
||||
}
|
||||
return this._idCIDString
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks the equality of `this` peer against a given PeerId.
|
||||
*
|
||||
* @param {Uint8Array|PeerId} id
|
||||
* @returns {boolean}
|
||||
*/
|
||||
@ -159,6 +164,7 @@ class PeerId {
|
||||
|
||||
/**
|
||||
* Checks the equality of `this` peer against a given PeerId.
|
||||
*
|
||||
* @deprecated Use `.equals`
|
||||
* @param {Uint8Array|PeerId} id
|
||||
* @returns {boolean}
|
||||
@ -178,6 +184,24 @@ class PeerId {
|
||||
this.pubKey.bytes instanceof Uint8Array &&
|
||||
uint8ArrayEquals(this.privKey.public.bytes, this.pubKey.bytes))
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the PeerId has an inline public key.
|
||||
*
|
||||
* @returns {boolean}
|
||||
*/
|
||||
hasInlinePublicKey () {
|
||||
try {
|
||||
const decoded = mh.decode(this.id)
|
||||
if (decoded.name === 'identity') {
|
||||
return true
|
||||
}
|
||||
} catch (_) {
|
||||
// Ignore, there is no valid public key
|
||||
}
|
||||
|
||||
return false
|
||||
}
|
||||
}
|
||||
|
||||
const PeerIdWithIs = withIs(PeerId, {
|
||||
|
@ -243,6 +243,18 @@ describe('PeerId', () => {
|
||||
expect(ids[0].equals(ids[1].id)).to.equal(false)
|
||||
})
|
||||
|
||||
describe('hasInlinePublicKey', () => {
|
||||
it('returns true if uses a key type with inline public key', async () => {
|
||||
const peerId = await PeerId.create({ keyType: 'secp256k1' })
|
||||
expect(peerId.hasInlinePublicKey()).to.equal(true)
|
||||
})
|
||||
|
||||
it('returns false if uses a key type with no inline public key', async () => {
|
||||
const peerId = await PeerId.create({ keyType: 'RSA' })
|
||||
expect(peerId.hasInlinePublicKey()).to.equal(false)
|
||||
})
|
||||
})
|
||||
|
||||
describe('fromJSON', () => {
|
||||
it('full node', async () => {
|
||||
const id = await PeerId.create(testOpts)
|
||||
@ -297,6 +309,18 @@ describe('PeerId', () => {
|
||||
expect(peerId.isValid()).to.equal(false)
|
||||
})
|
||||
|
||||
it('keys are equal after one is stringified', async () => {
|
||||
const peerId = await PeerId.create(testOpts)
|
||||
const peerId1 = PeerId.createFromB58String(peerId.toB58String())
|
||||
const peerId2 = PeerId.createFromB58String(peerId.toB58String())
|
||||
|
||||
expect(peerId1).to.deep.equal(peerId2)
|
||||
|
||||
peerId1.toString()
|
||||
|
||||
expect(peerId1).to.deep.equal(peerId2)
|
||||
})
|
||||
|
||||
describe('returns error via cb instead of crashing', () => {
|
||||
const garbage = [
|
||||
uint8ArrayFromString('00010203040506070809', 'base16'),
|
||||
|
Reference in New Issue
Block a user