mirror of
https://github.com/fluencelabs/js-libp2p
synced 2025-03-30 22:31:03 +00:00
Converts this module to typescript. - Ecosystem modules renamed from (e.g.) `libp2p-tcp` to `@libp2p/tcp` - Ecosystem module now have named exports - Configuration has been updated, now pass instances of modules instead of classes: - Some configuration keys have been renamed to make them more descriptive. `transport` -> `transports`, `connEncryption` -> `connectionEncryption`. In general where we pass multiple things, the key is now plural, e.g. `streamMuxer` -> `streamMuxers`, `contentRouting` -> `contentRouters`, etc. Where we are configuring a singleton the config key is singular, e.g. `connProtector` -> `connectionProtector` etc. - Properties of the `modules` config key have been moved to the root - Properties of the `config` config key have been moved to the root ```js // before import Libp2p from 'libp2p' import TCP from 'libp2p-tcp' await Libp2p.create({ modules: { transport: [ TCP ], } config: { transport: { [TCP.tag]: { foo: 'bar' } }, relay: { enabled: true, hop: { enabled: true, active: true } } } }) ``` ```js // after import { createLibp2p } from 'libp2p' import { TCP } from '@libp2p/tcp' await createLibp2p({ transports: [ new TCP({ foo: 'bar' }) ], relay: { enabled: true, hop: { enabled: true, active: true } } }) ``` - Use of `enabled` flag has been reduced - previously you could pass a module but disable it with config. Now if you don't want a feature, just don't pass an implementation. Eg: ```js // before await Libp2p.create({ modules: { transport: [ TCP ], pubsub: Gossipsub }, config: { pubsub: { enabled: false } } }) ``` ```js // after await createLibp2p({ transports: [ new TCP() ] }) ``` - `.multiaddrs` renamed to `.getMultiaddrs()` because it's not a property accessor, work is done by that method to calculate announce addresses, observed addresses, etc - `/p2p/${peerId}` is now appended to all addresses returned by `.getMultiaddrs()` so they can be used opaquely (every consumer has to append the peer ID to the address to actually use it otherwise). If you need low-level unadulterated addresses, call methods on the address manager. BREAKING CHANGE: types are no longer hand crafted, this module is now ESM only
174 lines
6.4 KiB
TypeScript
174 lines
6.4 KiB
TypeScript
/* eslint-env mocha */
|
|
|
|
import { expect } from 'aegir/utils/chai.js'
|
|
import sinon from 'sinon'
|
|
import { Multiaddr } from '@multiformats/multiaddr'
|
|
import { pipe } from 'it-pipe'
|
|
import { fromString as uint8ArrayFromString } from 'uint8arrays/from-string'
|
|
import { createNode } from '../utils/creators/peer.js'
|
|
import { codes as Errors } from '../../src/errors.js'
|
|
import type { Libp2pNode } from '../../src/libp2p.js'
|
|
import all from 'it-all'
|
|
import { RELAY_CODEC } from '../../src/circuit/multicodec.js'
|
|
import { StreamHandler } from '../../src/circuit/circuit/stream-handler.js'
|
|
import { CircuitRelay } from '../../src/circuit/pb/index.js'
|
|
import { createNodeOptions, createRelayOptions } from './utils.js'
|
|
|
|
describe('Dialing (via relay, TCP)', () => {
|
|
let srcLibp2p: Libp2pNode
|
|
let relayLibp2p: Libp2pNode
|
|
let dstLibp2p: Libp2pNode
|
|
|
|
beforeEach(async () => {
|
|
// Create 3 nodes, and turn HOP on for the relay
|
|
[srcLibp2p, relayLibp2p, dstLibp2p] = await Promise.all([
|
|
createNode({
|
|
config: createNodeOptions({
|
|
relay: {
|
|
autoRelay: {
|
|
enabled: false
|
|
}
|
|
}
|
|
})
|
|
}),
|
|
createNode({
|
|
config: createRelayOptions({
|
|
relay: {
|
|
autoRelay: {
|
|
enabled: false
|
|
}
|
|
}
|
|
})
|
|
}),
|
|
createNode({
|
|
config: createNodeOptions({
|
|
relay: {
|
|
autoRelay: {
|
|
enabled: false
|
|
}
|
|
}
|
|
})
|
|
})
|
|
])
|
|
|
|
await dstLibp2p.handle('/echo/1.0.0', ({ stream }) => {
|
|
void pipe(stream, stream)
|
|
})
|
|
|
|
// Start each node
|
|
await Promise.all([srcLibp2p, relayLibp2p, dstLibp2p].map(async libp2p => await libp2p.start()))
|
|
})
|
|
|
|
afterEach(async () => {
|
|
// Stop each node
|
|
return await Promise.all([srcLibp2p, relayLibp2p, dstLibp2p].map(async libp2p => await libp2p.stop()))
|
|
})
|
|
|
|
it('should be able to connect to a peer over a relay with active connections', async () => {
|
|
const relayAddr = relayLibp2p.components.getTransportManager().getAddrs()[0]
|
|
const relayIdString = relayLibp2p.peerId.toString()
|
|
|
|
const dialAddr = relayAddr
|
|
.encapsulate(`/p2p/${relayIdString}`)
|
|
.encapsulate(`/p2p-circuit/p2p/${dstLibp2p.peerId.toString()}`)
|
|
|
|
await relayLibp2p.dial(dstLibp2p.getMultiaddrs()[0])
|
|
|
|
const connection = await srcLibp2p.dial(dialAddr)
|
|
|
|
expect(connection).to.exist()
|
|
expect(connection.remotePeer.toBytes()).to.eql(dstLibp2p.peerId.toBytes())
|
|
expect(connection.remoteAddr).to.eql(dialAddr)
|
|
|
|
const { stream: echoStream } = await connection.newStream('/echo/1.0.0')
|
|
|
|
const input = uint8ArrayFromString('hello')
|
|
const [output] = await pipe(
|
|
[input],
|
|
echoStream,
|
|
async (source) => await all(source)
|
|
)
|
|
|
|
expect(output.slice()).to.eql(input)
|
|
})
|
|
|
|
it('should fail to connect to a peer over a relay with inactive connections', async () => {
|
|
const relayAddr = relayLibp2p.components.getTransportManager().getAddrs()[0]
|
|
const relayIdString = relayLibp2p.peerId.toString()
|
|
|
|
const dialAddr = relayAddr
|
|
.encapsulate(`/p2p/${relayIdString}`)
|
|
.encapsulate(`/p2p-circuit/p2p/${dstLibp2p.peerId.toString()}`)
|
|
|
|
await expect(srcLibp2p.dial(dialAddr))
|
|
.to.eventually.be.rejected()
|
|
.and.to.have.nested.property('.errors[0].code', Errors.ERR_HOP_REQUEST_FAILED)
|
|
})
|
|
|
|
it('should not stay connected to a relay when not already connected and HOP fails', async () => {
|
|
const relayAddr = relayLibp2p.components.getTransportManager().getAddrs()[0]
|
|
const relayIdString = relayLibp2p.peerId.toString()
|
|
|
|
const dialAddr = relayAddr
|
|
.encapsulate(`/p2p/${relayIdString}`)
|
|
.encapsulate(`/p2p-circuit/p2p/${dstLibp2p.peerId.toString()}`)
|
|
|
|
await expect(srcLibp2p.dial(dialAddr))
|
|
.to.eventually.be.rejected()
|
|
.and.to.have.nested.property('.errors[0].code', Errors.ERR_HOP_REQUEST_FAILED)
|
|
|
|
// We should not be connected to the relay, because we weren't before the dial
|
|
const srcToRelayConn = srcLibp2p.components.getConnectionManager().getConnection(relayLibp2p.peerId)
|
|
expect(srcToRelayConn).to.not.exist()
|
|
})
|
|
|
|
it('dialer should stay connected to an already connected relay on hop failure', async () => {
|
|
const relayIdString = relayLibp2p.peerId.toString()
|
|
const relayAddr = relayLibp2p.components.getTransportManager().getAddrs()[0].encapsulate(`/p2p/${relayIdString}`)
|
|
|
|
const dialAddr = relayAddr
|
|
.encapsulate(`/p2p-circuit/p2p/${dstLibp2p.peerId.toString()}`)
|
|
|
|
await srcLibp2p.dial(relayAddr)
|
|
|
|
await expect(srcLibp2p.dial(dialAddr))
|
|
.to.eventually.be.rejected()
|
|
.and.to.have.nested.property('.errors[0].code', Errors.ERR_HOP_REQUEST_FAILED)
|
|
|
|
const srcToRelayConn = srcLibp2p.components.getConnectionManager().getConnection(relayLibp2p.peerId)
|
|
expect(srcToRelayConn).to.exist()
|
|
expect(srcToRelayConn?.stat.status).to.equal('OPEN')
|
|
})
|
|
|
|
it('destination peer should stay connected to an already connected relay on hop failure', async () => {
|
|
const relayIdString = relayLibp2p.peerId.toString()
|
|
const relayAddr = relayLibp2p.components.getTransportManager().getAddrs()[0].encapsulate(`/p2p/${relayIdString}`)
|
|
|
|
const dialAddr = relayAddr
|
|
.encapsulate(`/p2p-circuit/p2p/${dstLibp2p.peerId.toString()}`)
|
|
|
|
// Connect the destination peer and the relay
|
|
const tcpAddrs = dstLibp2p.components.getTransportManager().getAddrs()
|
|
sinon.stub(dstLibp2p.components.getAddressManager(), 'getListenAddrs').returns([new Multiaddr(`${relayAddr.toString()}/p2p-circuit`)])
|
|
|
|
await dstLibp2p.components.getTransportManager().listen(dstLibp2p.components.getAddressManager().getListenAddrs())
|
|
expect(dstLibp2p.components.getTransportManager().getAddrs()).to.have.deep.members([...tcpAddrs, dialAddr.decapsulate('p2p')])
|
|
|
|
// send an invalid relay message from the relay to the destination peer
|
|
const connections = relayLibp2p.getConnections(dstLibp2p.peerId)
|
|
const { stream } = await connections[0].newStream(RELAY_CODEC)
|
|
const streamHandler = new StreamHandler({ stream })
|
|
streamHandler.write({
|
|
type: CircuitRelay.Type.STATUS
|
|
})
|
|
const res = await streamHandler.read()
|
|
expect(res?.code).to.equal(CircuitRelay.Status.MALFORMED_MESSAGE)
|
|
streamHandler.close()
|
|
|
|
// should still be connected
|
|
const dstToRelayConn = dstLibp2p.components.getConnectionManager().getConnection(relayLibp2p.peerId)
|
|
expect(dstToRelayConn).to.exist()
|
|
expect(dstToRelayConn?.stat.status).to.equal('OPEN')
|
|
})
|
|
})
|