feat: add path multiaddr support (#118)

* chore: update deps
* test: skip paths on windows

src/index.js

@@ -7,6 +7,7 @@ const errCode = require('err-code')
 const log = require('debug')('libp2p:tcp')
 const toConnection = require('./socket-to-conn')
 const createListener = require('./listener')
+const { multiaddrToNetConfig } = require('./utils')
 const { AbortError } = require('abortable-iterator')
 const { CODE_CIRCUIT, CODE_P2P } = require('./constants')
 const assert = require('assert')
@@ -56,9 +57,9 @@ class TCP {
 
     return new Promise((resolve, reject) => {
       const start = Date.now()
-      const cOpts = ma.toOptions()
+      const cOpts = multiaddrToNetConfig(ma)
 
-      log('dialing %s:%s', cOpts.host, cOpts.port)
+      log('dialing %j', cOpts)
       const rawSocket = net.connect(cOpts)
 
       const onError = err => {
@@ -74,12 +75,12 @@ class TCP {
       }
 
       const onConnect = () => {
-        log('connection opened %s:%s', cOpts.host, cOpts.port)
+        log('connection opened %j', cOpts)
         done()
       }
 
       const onAbort = () => {
-        log('connection aborted %s:%s', cOpts.host, cOpts.port)
+        log('connection aborted %j', cOpts)
         rawSocket.destroy()
         done(new AbortError())
       }

src/listener.js

@@ -1,13 +1,14 @@
 'use strict'
 
-const multiaddr = require('multiaddr')
-const os = require('os')
 const net = require('net')
 const EventEmitter = require('events')
 const log = require('debug')('libp2p:tcp:listener')
 const toConnection = require('./socket-to-conn')
 const { CODE_P2P } = require('./constants')
-const ProtoFamily = { ip4: 'IPv4', ip6: 'IPv6' }
+const {
+  getMultiaddrs,
+  multiaddrToNetConfig
+} = require('./utils')
 
 module.exports = ({ handler, upgrader }, options) => {
   const listener = new EventEmitter()
@@ -16,7 +17,7 @@ module.exports = ({ handler, upgrader }, options) => {
     // Avoid uncaught errors caused by unstable connections
     socket.on('error', err => log('socket error', err))
 
-    const maConn = toConnection(socket)
+    const maConn = toConnection(socket, { listeningAddr })
     log('new inbound connection %s', maConn.remoteAddr)
 
     const conn = await upgrader.upgradeInbound(maConn)
@@ -56,8 +57,8 @@ module.exports = ({ handler, upgrader }, options) => {
     }
 
     return new Promise((resolve, reject) => {
-      const { host, port } = listeningAddr.toOptions()
-      server.listen(port, host, err => {
+      const options = multiaddrToNetConfig(listeningAddr)
+      server.listen(options, err => {
         if (err) return reject(err)
         log('Listening on %s', server.address())
         resolve()
@@ -76,9 +77,9 @@ module.exports = ({ handler, upgrader }, options) => {
     // Because TCP will only return the IPv6 version
     // we need to capture from the passed multiaddr
     if (listeningAddr.toString().startsWith('/ip4')) {
-      addrs = addrs.concat(getMulitaddrs('ip4', address.address, address.port))
+      addrs = addrs.concat(getMultiaddrs('ip4', address.address, address.port))
     } else if (address.family === 'IPv6') {
-      addrs = addrs.concat(getMulitaddrs('ip6', address.address, address.port))
+      addrs = addrs.concat(getMultiaddrs('ip6', address.address, address.port))
     }
 
     return addrs.map(ma => peerId ? ma.encapsulate(`/p2p/${peerId}`) : ma)
@@ -87,30 +88,6 @@ module.exports = ({ handler, upgrader }, options) => {
   return listener
 }
 
-function getMulitaddrs (proto, ip, port) {
-  const toMa = ip => multiaddr(`/${proto}/${ip}/tcp/${port}`)
-  return (isAnyAddr(ip) ? getNetworkAddrs(ProtoFamily[proto]) : [ip]).map(toMa)
-}
-
-function isAnyAddr (ip) {
-  return ['0.0.0.0', '::'].includes(ip)
-}
-
-/**
- * @private
- * @param {string} family One of ['IPv6', 'IPv4']
- * @returns {string[]} an array of ip address strings
- */
-function getNetworkAddrs (family) {
-  return Object.values(os.networkInterfaces()).reduce((addresses, netAddrs) => {
-    netAddrs.forEach(netAddr => {
-      // Add the ip of each matching network interface
-      if (netAddr.family === family) addresses.push(netAddr.address)
-    })
-    return addresses
-  }, [])
-}
-
 function trackConn (server, maConn) {
   server.__connections.push(maConn)
 

src/socket-to-conn.js

@@ -11,6 +11,15 @@ const { CLOSE_TIMEOUT } = require('./constants')
 module.exports = (socket, options) => {
   options = options || {}
 
+  // Check if we are connected on a unix path
+  if (options.listeningAddr && options.listeningAddr.getPath()) {
+    options.remoteAddr = options.listeningAddr
+  }
+
+  if (options.remoteAddr && options.remoteAddr.getPath()) {
+    options.localAddr = options.remoteAddr
+  }
+
   const { sink, source } = toIterable.duplex(socket)
   const maConn = {
     async sink (source) {
@@ -40,7 +49,7 @@ module.exports = (socket, options) => {
 
     conn: socket,
 
-    localAddr: toMultiaddr(socket.localAddress, socket.localPort),
+    localAddr: options.localAddr || toMultiaddr(socket.localAddress, socket.localPort),
 
     // If the remote address was passed, use it - it may have the peer ID encapsulated
     remoteAddr: options.remoteAddr || toMultiaddr(socket.remoteAddress, socket.remotePort),

src/utils.js

@@ -0,0 +1,46 @@
+'use strict'
+
+const multiaddr = require('multiaddr')
+const os = require('os')
+const { resolve } = require('path')
+const ProtoFamily = { ip4: 'IPv4', ip6: 'IPv6' }
+
+function multiaddrToNetConfig (addr) {
+  const listenPath = addr.getPath()
+  // unix socket listening
+  if (listenPath) {
+    return resolve(listenPath)
+  }
+  // tcp listening
+  return addr.toOptions()
+}
+
+function getMultiaddrs (proto, ip, port) {
+  const toMa = ip => multiaddr(`/${proto}/${ip}/tcp/${port}`)
+  return (isAnyAddr(ip) ? getNetworkAddrs(ProtoFamily[proto]) : [ip]).map(toMa)
+}
+
+function isAnyAddr (ip) {
+  return ['0.0.0.0', '::'].includes(ip)
+}
+
+/**
+ * @private
+ * @param {string} family One of ['IPv6', 'IPv4']
+ * @returns {string[]} an array of ip address strings
+ */
+function getNetworkAddrs (family) {
+  return Object.values(os.networkInterfaces()).reduce((addresses, netAddrs) => {
+    netAddrs.forEach(netAddr => {
+      // Add the ip of each matching network interface
+      if (netAddr.family === family) addresses.push(netAddr.address)
+    })
+    return addresses
+  }, [])
+}
+
+module.exports = {
+  multiaddrToNetConfig,
+  isAnyAddr,
+  getMultiaddrs
+}