Skip to content
This repository has been archived by the owner. It is now read-only.
[DEPRECATED]: now part of the https://github.com/libp2p/js-libp2p repo
JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
test
.gitignore
.npmignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
package.json

README.md

⛔️ DEPRECATED: libp2p-identify is now included in js-libp2p

js-libp2p-identify

Discourse posts Dependency Status js-standard-style

libp2p Identify Protocol

Lead Maintainer

Jacob Heun

Description

Identify is a STUN protocol, used by libp2p-swarm in order to broadcast and learn about the ip:port pairs a specific peer is available through and to know when a new stream muxer is established, so a conn can be reused.

How does it work

Best way to understand the current design is through this issue: https://github.com/libp2p/js-libp2p-swarm/issues/78

This module uses pull-streams

We expose a streaming interface based on pull-streams, rather then on the Node.js core streams implementation (aka Node.js streams). pull-streams offers us a better mechanism for error handling and flow control guarantees. If you would like to know more about why we did this, see the discussion at this issue.

You can learn more about pull-streams at:

Converting pull-streams to Node.js Streams

If you are a Node.js streams user, you can convert a pull-stream to a Node.js stream using the module pull-stream-to-stream, giving you an instance of a Node.js stream that is linked to the pull-stream. For example:

const pullToStream = require('pull-stream-to-stream')

const nodeStreamInstance = pullToStream(pullStreamInstance)
// nodeStreamInstance is an instance of a Node.js Stream

To learn more about this utility, visit https://pull-stream.github.io/#pull-stream-to-stream.

You can’t perform that action at this time.