@libp2p/keychain NPM

@libp2p/keychain

Key management and cryptographically protected messages

Install

$ npm i @libp2p/keychain

Browser `<script>` tag

Loading this module through a script tag will make it's exports available as Libp2pKeychain in the global namespace.

<script src="https://unpkg.com/@libp2p/keychain/dist/index.min.js"></script>

Features

Manages the lifecycle of a key
Keys are encrypted at rest
Enforces the use of safe key names
Uses encrypted PKCS 8 for key storage
Uses PBKDF2 for a "stetched" key encryption key
Enforces NIST SP 800-131A and NIST SP 800-132
Delays reporting errors to slow down brute force attacks

KeyInfo

The key management and naming service API all return a KeyInfo object. The id is a universally unique identifier for the key. The name is local to the key chain.

{
  name: 'rsa-key',
  id: 'QmYWYSUZ4PV6MRFYpdtEDJBiGs4UrmE6g8wmAWSePekXVW'
}

The key id is the SHA-256 multihash of its public key. The public key is a protobuf encoding containing a type and the DER encoding of the PKCS SubjectPublicKeyInfo.

Private key storage

A private key is stored as an encrypted PKCS 8 structure in the PEM format. It is protected by a key generated from the key chain's passPhrase using PBKDF2.

The default options for generating the derived encryption key are in the dek object. This, along with the passPhrase, is the input to a PBKDF2 function.

const defaultOptions = {
  //See https://cryptosense.com/parameter-choice-for-pbkdf2/
  dek: {
    keyLength: 512 / 8,
    iterationCount: 1000,
    salt: 'at least 16 characters long',
    hash: 'sha2-512'
  }
}

key storage

Physical storage

The actual physical storage of an encrypted key is left to implementations of interface-datastore. A key benefit is that now the key chain can be used in browser with the js-datastore-level implementation.

API Docs

https://libp2p.github.io/js-libp2p/modules/_libp2p_keychain.html

License

Licensed under either of

Apache 2.0, (LICENSE-APACHE / http://www.apache.org/licenses/LICENSE-2.0)
MIT (LICENSE-MIT / http://opensource.org/licenses/MIT)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

IPFS crypto encryption keys libp2p secure

@libp2p/crypto @libp2p/interface @libp2p/peer-id interface-datastore merge-options multiformats sanitize-filename uint8arrays

libp2p @everything-registry/sub-chunk-546 helia @helia/cli @helia/cli-utils @helia/interop @peer-ai/peer-ai

3 days ago

4 days ago

4 days ago

4 days ago

4 days ago

5 days ago

5 days ago

8 days ago

8 days ago

9 days ago

11 days ago

10 days ago

10 days ago

12 days ago

12 days ago

13 days ago

18 days ago

19 days ago

20 days ago

23 days ago

22 days ago

22 days ago

25 days ago

25 days ago

26 days ago

29 days ago

29 days ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

6 months ago

5 months ago

9 months ago

9 months ago

8 months ago

8 months ago

8 months ago

7 months ago

5 months ago

9 months ago

9 months ago

7 months ago

5 months ago

7 months ago

8 months ago

9 months ago

5 months ago

8 months ago

5 months ago

5 months ago

6 months ago

9 months ago

9 months ago

9 months ago

6 months ago

8 months ago

9 months ago

5 months ago

6 months ago

7 months ago

8 months ago

9 months ago

9 months ago

5 months ago

9 months ago

8 months ago

6 months ago

5 months ago

10 months ago

5 months ago

7 months ago

5 months ago

5 months ago

5 months ago

8 months ago

9 months ago

9 months ago

6 months ago

8 months ago

9 months ago

9 months ago

6 months ago

7 months ago

8 months ago

6 months ago

8 months ago

5 months ago

6 months ago

10 months ago

9 months ago

8 months ago

6 months ago

7 months ago

8 months ago

9 months ago

9 months ago

9 months ago

6 months ago

6 months ago

6 months ago

8 months ago

7 months ago

9 months ago

9 months ago

8 months ago

9 months ago

8 months ago

6 months ago

5 months ago

8 months ago

7 months ago

9 months ago

8 months ago

6 months ago

6 months ago

8 months ago

8 months ago

9 months ago

8 months ago

5 months ago

6 months ago

9 months ago

10 months ago

9 months ago

7 months ago

5 months ago

6 months ago

6 months ago

8 months ago

7 months ago

8 months ago

7 months ago

6 months ago

8 months ago

5 months ago

5 months ago

9 months ago

8 months ago

7 months ago

8 months ago

6 months ago

9 months ago

9 months ago

6 months ago

10 months ago

8 months ago

9 months ago

8 months ago

6 months ago

9 months ago

5 months ago

8 months ago

6 months ago

10 months ago

5 months ago

6 months ago

8 months ago

9 months ago

7 months ago

10 months ago

5 months ago

6 months ago

5 months ago

9 months ago

6 months ago

9 months ago

5 months ago

9 months ago

9 months ago

7 months ago

9 months ago

9 months ago

5 months ago

9 months ago

7 months ago

5 months ago

5 months ago

9 months ago

6 months ago

9 months ago

5 months ago

5 months ago

9 months ago

6 months ago

7 months ago

6 months ago

9 months ago

6 months ago

8 months ago

9 months ago

5 months ago

5 months ago

9 months ago

9 months ago

9 months ago

7 months ago

6 months ago

9 months ago

6 months ago

6 months ago

7 months ago

10 months ago

6 months ago

9 months ago

5 months ago

8 months ago

8 months ago

6 months ago

10 months ago

7 months ago

9 months ago

5 months ago

5 months ago

7 months ago

9 months ago

6 months ago

5 months ago

6 months ago

6 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

1 year ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

@libp2p/keychain v4.0.14

@libp2p/keychain

Table of contents

Install

Browser `<script>` tag

Features

KeyInfo

Private key storage

Physical storage

API Docs

License

Contribution

@libp2p/keychain

Table of contents

Install

Browser <script> tag

Features

KeyInfo

Private key storage

Physical storage

API Docs

License

Contribution

Browser `<script>` tag