Skip to content

Faster noise libp2p handshake for js-libp2p with Libsodium and Node.js crypto

License

Notifications You must be signed in to change notification settings

dao-xyz/js-libp2p-noise

 
 

Repository files navigation

js-libp2p-noise

This is a fork for ChainSafe/js-libp2p-noise where performance gains are made by utilising libsodium.js (appx. 20-50% gain) instead of 'stablelib' for browser usages, and Node crypto native lib from Node apps (500-700% gain).

This fork is ESM only.

npm Discourse posts dao-xyz

Noise libp2p handshake for js-libp2p

This repository contains TypeScript implementation of noise protocol, an encryption protocol used in libp2p.

Warning: Even though this package works in browser, it will bundle around 600Kb (200Kb gzipped) of code

https://bundlephobia.com/result?p=@dao-xyz/libp2p-noise@latest

Usage

Install with yarn add @dao-xyz/libp2p-noise or npm i @dao-xyz/libp2p-noise.

Example of using default noise configuration and passing it to the libp2p config:

import {noise} from "@dao-xyz/libp2p-noise"

//custom noise configuration, pass it instead of `new Noise()`
//x25519 private key
const n = noise(privateKey);

const libp2p = new Libp2p({
   modules: {
     connEncryption: [noise()],
   },
});

Where parameters for Noise constructor are:

  • static Noise key - (optional) existing private Noise static key
  • early data - (optional) an early data payload to be sent in handshake messages

API

This module exposes a crypto interface, as defined in the repository js-interfaces.

» API Docs

Bring your own crypto

You can provide a custom crypto implementation (instead of the default, based on stablelib) by passing a third argument to the Noise constructor.

The implementation must conform to the ICryptoInterface, defined in https://github.com/dao-xyz/js-libp2p-noise/blob/master/src/crypto/crypto.ts

Contribute

Feel free to join in. All welcome. Open an issue!

License

Licensed under either of

About

Faster noise libp2p handshake for js-libp2p with Libsodium and Node.js crypto

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 98.0%
  • JavaScript 2.0%