# libp2p-tcp

> Node.js implementation of the TCP module that libp2p uses, which implements the interface-connection and interface-transport interfaces

Latest version **0.17.2** (published 2021-09-03) · MIT license · 0 weekly downloads

## Install

```sh
npm install libp2p-tcp
pnpm add libp2p-tcp
yarn add libp2p-tcp
bun add libp2p-tcp
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.17.2 |
| Published | 2021-09-03 |
| First published | 2015-09-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=14.0.0 |
| Dependencies | 8 |
| Unpacked size | 139.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 74 |
| Maintainers | jacobheun, daviddias, dignifiedquire, achingbrain, vascosantos |
| Keywords | libp2p, network, p2p, peer, peer-to-peer, IPFS, TCP |

## Links

- npm: https://www.npmjs.com/package/libp2p-tcp
- Repository: https://github.com/libp2p/js-libp2p-tcp
- Issues: https://github.com/libp2p/js-libp2p-tcp/issues
- npm.io page: https://npm.io/package/libp2p-tcp

## Dependencies (8)

- [debug](https://npm.io/package/debug.md) ^4.3.1
- [mafmt](https://npm.io/package/mafmt.md) ^10.0.0
- [class-is](https://npm.io/package/class-is.md) ^1.1.0
- [err-code](https://npm.io/package/err-code.md) ^3.0.1
- [multiaddr](https://npm.io/package/multiaddr.md) ^10.0.0
- [libp2p-utils](https://npm.io/package/libp2p-utils.md) ^0.4.0
- [stream-to-it](https://npm.io/package/stream-to-it.md) ^0.2.2
- [abortable-iterator](https://npm.io/package/abortable-iterator.md) ^3.0.0

## Recent versions

- 0.17.2 (latest) — 2021-09-03
- 0.15.1 (beta) — 2020-08-11
- 0.17.1 — 2021-07-08
- 0.17.0 — 2021-07-07
- 0.16.0 — 2021-06-10
- 0.15.4 — 2021-04-12
- 0.15.3 — 2021-02-03
- 0.15.2 — 2020-12-28
- 0.15.0 — 2020-08-07
- 0.14.6 — 2020-07-17
- 0.14.5 — 2020-04-28
- 0.14.4 — 2020-02-24
- 0.14.3 — 2019-12-20
- 0.14.2 — 2019-12-06
- 0.13.2 — 2019-09-24
- … 42 more at https://npm.io/package/libp2p-tcp/versions

## README

# js-libp2p-tcp

[![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](http://protocol.ai)
[![](https://img.shields.io/badge/project-libp2p-yellow.svg?style=flat-square)](http://libp2p.io/)
[![](https://img.shields.io/badge/freenode-%23libp2p-yellow.svg?style=flat-square)](http://webchat.freenode.net/?channels=%23libp2p)
[![Discourse posts](https://img.shields.io/discourse/https/discuss.libp2p.io/posts.svg)](https://discuss.libp2p.io)
[![](https://img.shields.io/codecov/c/github/libp2p/js-libp2p-tcp.svg?style=flat-square)](https://codecov.io/gh/libp2p/js-libp2p-tcp)
[![](https://img.shields.io/travis/libp2p/js-libp2p-tcp.svg?style=flat-square)](https://travis-ci.com/libp2p/js-libp2p-tcp)
[![Dependency Status](https://david-dm.org/libp2p/js-libp2p-tcp.svg?style=flat-square)](https://david-dm.org/libp2p/js-libp2p-tcp)
[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/feross/standard)

[![](https://raw.githubusercontent.com/libp2p/js-libp2p-interfaces/master/src/transport/img/badge.png)](https://github.com/libp2p/js-libp2p-interfaces/tree/master/src/transport)
[![](https://raw.githubusercontent.com/libp2p/js-libp2p-interfaces/master/src/connection/img/badge.png)](https://github.com/libp2p/js-libp2p-interfaces/tree/master/src/connection)


> JavaScript implementation of the TCP module for libp2p. It exposes the [interface-transport](https://github.com/libp2p/js-libp2p-interfaces/tree/master/src/transport) for dial/listen. `libp2p-tcp` is a very thin shim that adds support for dialing to a `multiaddr`. This small shim will enable libp2p to use other transports.

## Lead Maintainer

[Jacob Heun](https://github.com/jacobheun)

## Table of Contents

- [Install](#install)
  - [npm](#npm)
- [Usage](#usage)
- [API](#api)
- [Contribute](#contribute)
- [License](#license)

## Install

### npm

```sh
> npm install libp2p-tcp
```

## Usage

```js
const TCP = require('libp2p-tcp')
const multiaddr = require('multiaddr')
const pipe = require('it-pipe')
const { collect } = require('streaming-iterables')

// A simple upgrader that just returns the MultiaddrConnection
const upgrader = {
  upgradeInbound: maConn => maConn,
  upgradeOutbound: maConn => maConn
}

const tcp = new TCP({ upgrader })

const listener = tcp.createListener((socket) => {
  console.log('new connection opened')
  pipe(
    ['hello'],
    socket
  )
})

const addr = multiaddr('/ip4/127.0.0.1/tcp/9090')
await listener.listen(addr)
console.log('listening')

const socket = await tcp.dial(addr)
const values = await pipe(
  socket,
  collect
)
console.log(`Value: ${values.toString()}`)

// Close connection after reading
await listener.close()
```

Outputs:

```sh
listening
new connection opened
Value: hello
```

## API

### Transport

[![](https://raw.githubusercontent.com/libp2p/js-libp2p-interfaces/master/src/transport/img/badge.png)](https://github.com/libp2p/js-libp2p-interfaces/tree/master/src/transport)

`libp2p-tcp` accepts TCP addresses as both IPFS and non IPFS encapsulated addresses, i.e:

`/ip4/127.0.0.1/tcp/4001`
`/ip4/127.0.0.1/tcp/4001/ipfs/QmHash`

(both for dialing and listening)

### Connection

[![](https://raw.githubusercontent.com/libp2p/js-libp2p-interfaces/master/src/connection/img/badge.png)](https://github.com/libp2p/js-libp2p-interfaces/tree/master/src/connection)


## Contribute

Contributions are welcome! The libp2p implementation in JavaScript is a work in progress. As such, there's a few things you can do right now to help out:

- [Check out the existing issues](//github.com/libp2p/js-libp2p-tcp/issues).
- **Perform code reviews**.
- **Add tests**. There can never be enough tests.

Please be aware that all interactions related to libp2p are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).

Small note: If editing the README, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.

## License

[MIT](LICENSE) © 2015-2016 David Dias

---
_Source: https://npm.io/package/libp2p-tcp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._