mirror of
https://github.com/fluencelabs/js-libp2p
synced 2025-03-16 07:30:51 +00:00
199395de4d
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
64 lines
1.7 KiB
JavaScript
64 lines
1.7 KiB
JavaScript
'use strict'
|
|
|
|
/** @type {import('aegir').PartialOptions} */
|
|
module.exports = {
|
|
build: {
|
|
bundlesizeMax: '253kB'
|
|
},
|
|
test: {
|
|
before: async () => {
|
|
const { createLibp2p } = await import('./dist/src/index.js')
|
|
const { MULTIADDRS_WEBSOCKETS } = await import('./dist/test/fixtures/browser.js')
|
|
const { default: Peers } = await import('./dist/test/fixtures/peers.js')
|
|
const { WebSockets } = await import('@libp2p/websockets')
|
|
const { Mplex } = await import('@libp2p/mplex')
|
|
const { NOISE } = await import('@chainsafe/libp2p-noise')
|
|
const { Plaintext } = await import('./dist/src/insecure/index.js')
|
|
const { pipe } = await import('it-pipe')
|
|
const { createFromJSON } = await import('@libp2p/peer-id-factory')
|
|
|
|
// Use the last peer
|
|
const peerId = await createFromJSON(Peers[Peers.length - 1])
|
|
const libp2p = await createLibp2p({
|
|
addresses: {
|
|
listen: [MULTIADDRS_WEBSOCKETS[0]]
|
|
},
|
|
peerId,
|
|
transports: [
|
|
new WebSockets()
|
|
],
|
|
streamMuxers: [
|
|
new Mplex()
|
|
],
|
|
connectionEncryption: [
|
|
NOISE,
|
|
new Plaintext()
|
|
],
|
|
relay: {
|
|
enabled: true,
|
|
hop: {
|
|
enabled: true,
|
|
active: false
|
|
}
|
|
},
|
|
nat: {
|
|
enabled: false
|
|
}
|
|
})
|
|
// Add the echo protocol
|
|
await libp2p.handle('/echo/1.0.0', ({ stream }) => {
|
|
pipe(stream, stream)
|
|
.catch() // sometimes connections are closed before multistream-select finishes which causes an error
|
|
})
|
|
await libp2p.start()
|
|
|
|
return {
|
|
libp2p
|
|
}
|
|
},
|
|
after: async (_, before) => {
|
|
await before.libp2p.stop()
|
|
}
|
|
}
|
|
}
|