mirror of
https://github.com/fluencelabs/js-libp2p
synced 2025-07-09 13:51:34 +00:00
Compare commits
158 Commits
Author | SHA1 | Date | |
---|---|---|---|
6d0ac819f1 | |||
15a0b1dbf2 | |||
9cbf36fcb5 | |||
3a9d5f64d9 | |||
eacd7e8f76 | |||
7f2cc4dc44 | |||
5cc5a8749a | |||
ee60e18213 | |||
a4a2fac41e | |||
2f598eba09 | |||
443a102528 | |||
3bed7b4cb2 | |||
3fb424914f | |||
bb0ca28195 | |||
01a8b8da9b | |||
77d7cb8f08 | |||
a335fda852 | |||
43e3af0c12 | |||
2c9c3cf6d5 | |||
4d6587539c | |||
83734ef520 | |||
1c2e4d89ac | |||
c635b08d2f | |||
3aedf55115 | |||
ede653cad9 | |||
2ab811d708 | |||
122c89dd0d | |||
97107c4ef7 | |||
d3f78edffe | |||
f8e3cf10b0 | |||
f342c1ff50 | |||
fe63990a16 | |||
e82b6e414b | |||
1d62ead8e5 | |||
3d25ff7fd0 | |||
0f389a7828 | |||
9f0582f372 | |||
266f2c3c86 | |||
7783edb059 | |||
ba2b4d4b28 | |||
06c3a6d407 | |||
833f789714 | |||
ef24fabf02 | |||
3b33fb4b73 | |||
a07fb7960b | |||
b11126ca89 | |||
df53ab4e65 | |||
0701de40b1 | |||
d6bb967243 | |||
d48005b8b7 | |||
67b97e32da | |||
664ba2d1e7 | |||
608564b033 | |||
af723b355e | |||
13cf476148 | |||
39b03586e8 | |||
f7183e8afd | |||
b9988adce9 | |||
b291bc06ec | |||
755eb909f2 | |||
afe0f854e8 | |||
50f7f32e53 | |||
052aad4e06 | |||
2c4b567b00 | |||
2a6a635f13 | |||
cd152f122f | |||
2959794796 | |||
2068c845cb | |||
d8ba284883 | |||
869d35d852 | |||
d6540bf01d | |||
478963ad2d | |||
d22ad83890 | |||
538f296b0a | |||
7bac2045cc | |||
818d2b2a98 | |||
d163ffd224 | |||
b29d6c9304 | |||
890dd05941 | |||
a79c6b50d7 | |||
d372a68692 | |||
4e3fc19623 | |||
2fa82b387c | |||
8fc6f8af81 | |||
924585b143 | |||
556f0203db | |||
b5a9eb2087 | |||
e5187d02ba | |||
150e4f97c1 | |||
302bb90058 | |||
f860ffb3e7 | |||
2572f3e034 | |||
d76356e56a | |||
e9543eb2e1 | |||
5282708263 | |||
ed494f03ae | |||
ac370fc967 | |||
ef4393649f | |||
f23fd4b7c7 | |||
5372f7af2f | |||
97da0ba740 | |||
88b04156bf | |||
64f3af897b | |||
54e502afcb | |||
086b0ec0df | |||
cc1f4af879 | |||
6456a0fff8 | |||
44463b9145 | |||
7eb2cea570 | |||
c381be3510 | |||
975e77991e | |||
b043bca607 | |||
3ffeb4ebe6 | |||
06e8f3dd42 | |||
3f7dde3e13 | |||
6f4e7ceeac | |||
2af692fb4d | |||
906315ce73 | |||
49f04cbe70 | |||
3d0a79eff3 | |||
55ee332907 | |||
ffe122d47e | |||
21c9aeecb1 | |||
a93cca9178 | |||
828a32d4f5 | |||
b4fb9b7bf2 | |||
0aed9fe1b3 | |||
9d1b917e8a | |||
8506414ea1 | |||
8e1743cac4 | |||
3ea95ce642 | |||
c4cae29ef3 | |||
a7128f07ec | |||
c3e147df6b | |||
b89445274d | |||
b9e3bcd91e | |||
f5c1cd1fb0 | |||
975e4b0fe0 | |||
9504f1951a | |||
8e1fc78353 | |||
8895a092b6 | |||
f2f361998d | |||
5f702f3481 | |||
03b34cac7d | |||
9c67364caa | |||
a1424826e7 | |||
3d5bba070b | |||
3f314d5e90 | |||
4ee3e1973b | |||
fc6558b897 | |||
3e302570e5 | |||
a34d2bbcc3 | |||
9941414a91 | |||
46cb46188a | |||
1af8472dc6 | |||
f6a4cad827 | |||
b1079474de | |||
a150ea60c5 |
26
.aegir.js
26
.aegir.js
@ -1,12 +1,13 @@
|
|||||||
'use strict'
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
const Libp2p = require('./src')
|
const Libp2p = require('./src')
|
||||||
const { MULTIADDRS_WEBSOCKETS } = require('./test/fixtures/browser')
|
const { MULTIADDRS_WEBSOCKETS } = require('./test/fixtures/browser')
|
||||||
const Peers = require('./test/fixtures/peers')
|
const Peers = require('./test/fixtures/peers')
|
||||||
const PeerId = require('peer-id')
|
const PeerId = require('peer-id')
|
||||||
const WebSockets = require('libp2p-websockets')
|
const WebSockets = require('libp2p-websockets')
|
||||||
const Muxer = require('libp2p-mplex')
|
const Muxer = require('libp2p-mplex')
|
||||||
const { NOISE: Crypto } = require('libp2p-noise')
|
const { NOISE: Crypto } = require('@chainsafe/libp2p-noise')
|
||||||
const pipe = require('it-pipe')
|
const pipe = require('it-pipe')
|
||||||
let libp2p
|
let libp2p
|
||||||
|
|
||||||
@ -47,16 +48,23 @@ const after = async () => {
|
|||||||
await libp2p.stop()
|
await libp2p.stop()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** @type {import('aegir').Options["build"]["config"]} */
|
||||||
|
const esbuild = {
|
||||||
|
inject: [path.join(__dirname, './scripts/node-globals.js')]
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @type {import('aegir').PartialOptions} */
|
||||||
module.exports = {
|
module.exports = {
|
||||||
bundlesize: { maxSize: '215kB' },
|
build: {
|
||||||
hooks: {
|
bundlesizeMax: '253kB'
|
||||||
pre: before,
|
|
||||||
post: after
|
|
||||||
},
|
},
|
||||||
webpack: {
|
test: {
|
||||||
node: {
|
before,
|
||||||
// needed by bcrypto
|
after,
|
||||||
Buffer: true
|
browser: {
|
||||||
|
config: {
|
||||||
|
buildConfig: esbuild
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
5
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
5
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
blank_issues_enabled: false
|
||||||
|
contact_links:
|
||||||
|
- name: libp2p Official Forum
|
||||||
|
url: https://discuss.libp2p.io
|
||||||
|
about: For general questions, support requests and discussions
|
55
.github/ISSUE_TEMPLATE/open_an_issue.md
vendored
Normal file
55
.github/ISSUE_TEMPLATE/open_an_issue.md
vendored
Normal file
@ -0,0 +1,55 @@
|
|||||||
|
---
|
||||||
|
name: Open an issue
|
||||||
|
about: For reporting bugs or errors in the JavaScript libp2p implementation
|
||||||
|
title: ''
|
||||||
|
labels: need/triage
|
||||||
|
assignees: ''
|
||||||
|
---
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Thank you for reporting an issue.
|
||||||
|
|
||||||
|
This issue tracker is for bugs found within the JavaScript implementation of libp2p.
|
||||||
|
|
||||||
|
If you are asking a question about how to use libp2p, please ask on https://discuss.libp2p.io
|
||||||
|
|
||||||
|
Otherwise please fill in as much of the template below as possible.
|
||||||
|
-->
|
||||||
|
|
||||||
|
- **Version**:
|
||||||
|
<!--
|
||||||
|
Check package.json version
|
||||||
|
-->
|
||||||
|
|
||||||
|
- **Platform**:
|
||||||
|
<!--
|
||||||
|
Output of `uname -a` (UNIX), or version and 32 or 64-bit (Windows). If using in a Browser, please share the browser version as well
|
||||||
|
-->
|
||||||
|
|
||||||
|
- **Subsystem**:
|
||||||
|
<!--
|
||||||
|
If known, please specify affected core module name (e.g Dialer, Pubsub, Relay etc)
|
||||||
|
-->
|
||||||
|
|
||||||
|
#### Severity:
|
||||||
|
<!--
|
||||||
|
One of following:
|
||||||
|
Critical - System crash, application panic.
|
||||||
|
High - The main functionality of the application does not work, API breakage, repo format breakage, etc.
|
||||||
|
Medium - A non-essential functionality does not work, performance issues, etc.
|
||||||
|
Low - An optional functionality does not work.
|
||||||
|
Very Low - Translation or documentation mistake. Something that won't give anyone a bad day.
|
||||||
|
-->
|
||||||
|
|
||||||
|
#### Description:
|
||||||
|
<!--
|
||||||
|
- What you did
|
||||||
|
- What happened
|
||||||
|
- What you expected to happen
|
||||||
|
-->
|
||||||
|
|
||||||
|
#### Steps to reproduce the error:
|
||||||
|
<!--
|
||||||
|
If possible, please provide code that demonstrates the problem, keeping it as simple and free of external dependencies as you are able
|
||||||
|
-->
|
||||||
|
|
@ -25,8 +25,6 @@
|
|||||||
- [ ] [js-ipfs](https://github.com/ipfs/js-ipfs)
|
- [ ] [js-ipfs](https://github.com/ipfs/js-ipfs)
|
||||||
- Documentation
|
- Documentation
|
||||||
- [ ] Ensure that README.md is up to date
|
- [ ] Ensure that README.md is up to date
|
||||||
- [ ] Ensure that all the examples run
|
|
||||||
- [ ] Ensure [libp2p/js-libp2p-examples](https://github.com/libp2p/js-libp2p-examples) is updated
|
|
||||||
- [ ] Ensure that [libp2p/docs](https://github.com/libp2p/docs) is updated
|
- [ ] Ensure that [libp2p/docs](https://github.com/libp2p/docs) is updated
|
||||||
- Communication
|
- Communication
|
||||||
- [ ] Create the release issue
|
- [ ] Create the release issue
|
8
.github/dependabot.yml
vendored
Normal file
8
.github/dependabot.yml
vendored
Normal file
@ -0,0 +1,8 @@
|
|||||||
|
version: 2
|
||||||
|
updates:
|
||||||
|
- package-ecosystem: npm
|
||||||
|
directory: "/"
|
||||||
|
schedule:
|
||||||
|
interval: daily
|
||||||
|
time: "11:00"
|
||||||
|
open-pull-requests-limit: 10
|
141
.github/workflows/examples.yml
vendored
Normal file
141
.github/workflows/examples.yml
vendored
Normal file
@ -0,0 +1,141 @@
|
|||||||
|
name: examples
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches:
|
||||||
|
- master
|
||||||
|
pull_request:
|
||||||
|
branches:
|
||||||
|
- '**'
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
check:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: npx aegir lint
|
||||||
|
- run: npx aegir ts -p check
|
||||||
|
- run: npx aegir build
|
||||||
|
test-auto-relay-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- auto-relay
|
||||||
|
test-chat-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- chat
|
||||||
|
test-connection-encryption-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- connection-encryption
|
||||||
|
test-discovery-mechanisms-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: macos-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- discovery-mechanisms
|
||||||
|
test-echo-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- echo
|
||||||
|
test-libp2p-in-the-browser-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: macos-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- libp2p-in-the-browser
|
||||||
|
test-peer-and-content-routing-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- peer-and-content-routing
|
||||||
|
test-pnet-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- pnet
|
||||||
|
test-protocol-and-stream-muxing-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- protocol-and-stream-muxing
|
||||||
|
test-pubsub-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- pubsub
|
||||||
|
test-transports-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- transports
|
||||||
|
test-webrtc-direct-example:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: 16
|
||||||
|
- run: npm install -g @mapbox/node-pre-gyp && npm install
|
||||||
|
- run: cd examples && npm i && npm run test -- webrtc-direct
|
100
.github/workflows/main.yml
vendored
100
.github/workflows/main.yml
vendored
@ -12,12 +12,14 @@ jobs:
|
|||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
- run: yarn
|
- uses: actions/setup-node@v2
|
||||||
- run: yarn lint
|
with:
|
||||||
- uses: gozala/typescript-error-reporter-action@v1.0.8
|
node-version: 16
|
||||||
- run: yarn build
|
- run: npm install
|
||||||
- run: yarn aegir dep-check
|
- run: npx aegir lint
|
||||||
- uses: ipfs/aegir/actions/bundle-size@master
|
- run: npx aegir build
|
||||||
|
- run: npx aegir dep-check
|
||||||
|
- uses: ipfs/aegir/actions/bundle-size@v32.1.0
|
||||||
name: size
|
name: size
|
||||||
with:
|
with:
|
||||||
github_token: ${{ secrets.GITHUB_TOKEN }}
|
github_token: ${{ secrets.GITHUB_TOKEN }}
|
||||||
@ -27,83 +29,53 @@ jobs:
|
|||||||
strategy:
|
strategy:
|
||||||
matrix:
|
matrix:
|
||||||
os: [windows-latest, ubuntu-latest, macos-latest]
|
os: [windows-latest, ubuntu-latest, macos-latest]
|
||||||
node: [12, 14]
|
node: [16]
|
||||||
fail-fast: true
|
fail-fast: true
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
- uses: actions/setup-node@v1
|
- uses: actions/setup-node@v2
|
||||||
with:
|
with:
|
||||||
node-version: ${{ matrix.node }}
|
node-version: ${{ matrix.node }}
|
||||||
- run: yarn
|
- run: npm install
|
||||||
- run: npx nyc --reporter=lcov aegir test -t node -- --bail
|
- run: npx aegir test -t node --cov --bail
|
||||||
- uses: codecov/codecov-action@v1
|
- uses: codecov/codecov-action@v1
|
||||||
test-chrome:
|
test-chrome:
|
||||||
needs: check
|
needs: check
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
- run: yarn
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: lts/*
|
||||||
|
- run: npm install
|
||||||
- run: npx aegir test -t browser -t webworker --bail
|
- run: npx aegir test -t browser -t webworker --bail
|
||||||
test-firefox:
|
test-firefox:
|
||||||
needs: check
|
needs: check
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
- run: yarn
|
- uses: actions/setup-node@v2
|
||||||
- run: npx aegir test -t browser -t webworker --bail -- --browsers FirefoxHeadless
|
with:
|
||||||
|
node-version: lts/*
|
||||||
|
- run: npm install
|
||||||
|
- run: npx aegir test -t browser -t webworker --bail -- --browser firefox
|
||||||
|
test-ts:
|
||||||
|
needs: check
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- uses: actions/setup-node@v2
|
||||||
|
with:
|
||||||
|
node-version: lts/*
|
||||||
|
- run: npm install
|
||||||
|
- run: npm run test:ts
|
||||||
test-interop:
|
test-interop:
|
||||||
needs: check
|
needs: check
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
- run: yarn
|
- uses: actions/setup-node@v2
|
||||||
- run: cd node_modules/interop-libp2p && yarn && LIBP2P_JS=${GITHUB_WORKSPACE}/src/index.js npx aegir test -t node --bail
|
with:
|
||||||
test-auto-relay-example:
|
node-version: lts/*
|
||||||
needs: check
|
- run: npm install
|
||||||
runs-on: ubuntu-latest
|
- run: npm run test:interop -- --bail -- --exit
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2
|
|
||||||
- run: yarn
|
|
||||||
- run: cd examples && yarn && npm run test -- auto-relay
|
|
||||||
test-chat-example:
|
|
||||||
needs: check
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2
|
|
||||||
- run: yarn
|
|
||||||
- run: cd examples && yarn && npm run test -- chat
|
|
||||||
test-connection-encryption-example:
|
|
||||||
needs: check
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2
|
|
||||||
- run: yarn
|
|
||||||
- run: cd examples && yarn && npm run test -- connection-encryption
|
|
||||||
test-echo-example:
|
|
||||||
needs: check
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2
|
|
||||||
- run: yarn
|
|
||||||
- run: cd examples && yarn && npm run test -- echo
|
|
||||||
test-libp2p-in-the-browser-example:
|
|
||||||
needs: check
|
|
||||||
runs-on: macos-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2
|
|
||||||
- run: yarn
|
|
||||||
- run: cd examples && yarn && npm run test -- libp2p-in-the-browser
|
|
||||||
test-discovery-mechanisms-example:
|
|
||||||
needs: check
|
|
||||||
runs-on: macos-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2
|
|
||||||
- run: yarn
|
|
||||||
- run: cd examples && yarn && npm run test -- discovery-mechanisms
|
|
||||||
test-pnet-example:
|
|
||||||
needs: check
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2
|
|
||||||
- run: yarn
|
|
||||||
- run: cd examples && yarn && npm run test -- pnet
|
|
||||||
|
1
.gitignore
vendored
1
.gitignore
vendored
@ -4,6 +4,7 @@ docs
|
|||||||
test/repo-tests*
|
test/repo-tests*
|
||||||
**/bundle.js
|
**/bundle.js
|
||||||
.cache
|
.cache
|
||||||
|
.parcel-cache
|
||||||
|
|
||||||
# Logs
|
# Logs
|
||||||
logs
|
logs
|
||||||
|
307
CHANGELOG.md
307
CHANGELOG.md
@ -1,3 +1,310 @@
|
|||||||
|
# [0.35.0](https://github.com/libp2p/js-libp2p/compare/v0.34.0...v0.35.0) (2021-12-02)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* stop dht before connection manager ([#1041](https://github.com/libp2p/js-libp2p/issues/1041)) ([3a9d5f6](https://github.com/libp2p/js-libp2p/commit/3a9d5f64d96719ebb4d3b083c4f5832db4fa0816)), closes [#1039](https://github.com/libp2p/js-libp2p/issues/1039)
|
||||||
|
|
||||||
|
|
||||||
|
### chore
|
||||||
|
|
||||||
|
* update peer id and libp2p crypto ([#1042](https://github.com/libp2p/js-libp2p/issues/1042)) ([9cbf36f](https://github.com/libp2p/js-libp2p/commit/9cbf36fcb54099e6fed35ceccc4a2376f0926c1f))
|
||||||
|
|
||||||
|
|
||||||
|
### BREAKING CHANGES
|
||||||
|
|
||||||
|
* requires node 15+
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.34.0](https://github.com/libp2p/js-libp2p/compare/v0.33.0...v0.34.0) (2021-11-25)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* private ip ts compile has no call signatures ([#1020](https://github.com/libp2p/js-libp2p/issues/1020)) ([77d7cb8](https://github.com/libp2p/js-libp2p/commit/77d7cb8f0815f2cdd3bfdfa8b641a7a186fe9520))
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* update dht ([#1009](https://github.com/libp2p/js-libp2p/issues/1009)) ([2f598eb](https://github.com/libp2p/js-libp2p/commit/2f598eba09cff4301474af08196158065e3602d8))
|
||||||
|
|
||||||
|
|
||||||
|
### BREAKING CHANGES
|
||||||
|
|
||||||
|
* libp2p-kad-dht has a new event-based API which is exposed as `_dht`
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.33.0](https://github.com/libp2p/js-libp2p/compare/v0.32.5...v0.33.0) (2021-09-24)
|
||||||
|
|
||||||
|
|
||||||
|
### chore
|
||||||
|
|
||||||
|
* update datastore ([#990](https://github.com/libp2p/js-libp2p/issues/990)) ([83734ef](https://github.com/libp2p/js-libp2p/commit/83734ef52061ad61ddb5ca49aae27e3a8b937058))
|
||||||
|
|
||||||
|
|
||||||
|
### BREAKING CHANGES
|
||||||
|
|
||||||
|
* datastore implementations provided to libp2p must be compliant with interface-datastore@6.0.0
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.32.5](https://github.com/libp2p/js-libp2p/compare/v0.32.4...v0.32.5) (2021-09-21)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* move abortable-iterator to dependencies ([#992](https://github.com/libp2p/js-libp2p/issues/992)) ([122c89d](https://github.com/libp2p/js-libp2p/commit/122c89dd0df55a59edaae078e3dc7c31b5603715)), closes [#986](https://github.com/libp2p/js-libp2p/issues/986)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.32.4](https://github.com/libp2p/js-libp2p/compare/v0.32.3...v0.32.4) (2021-08-20)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.32.3](https://github.com/libp2p/js-libp2p/compare/v0.32.2...v0.32.3) (2021-08-16)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* uint8arrays is a dep ([#964](https://github.com/libp2p/js-libp2p/issues/964)) ([ba2b4d4](https://github.com/libp2p/js-libp2p/commit/ba2b4d4b28f1d9940b457de344aed44537f9eabd))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.32.2](https://github.com/libp2p/js-libp2p/compare/v0.32.1...v0.32.2) (2021-08-13)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* browser example ci ([3b33fb4](https://github.com/libp2p/js-libp2p/commit/3b33fb4b73ba8065e432fb59f758fe138fd23d9e))
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* custom protocol name ([#962](https://github.com/libp2p/js-libp2p/issues/962)) ([ef24fab](https://github.com/libp2p/js-libp2p/commit/ef24fabf0269fd079888e92eedb458e23ef1c733))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.32.1](https://github.com/libp2p/js-libp2p/compare/v0.32.0...v0.32.1) (2021-07-22)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* turn compliance tests into devDependency ([#960](https://github.com/libp2p/js-libp2p/issues/960)) ([0701de4](https://github.com/libp2p/js-libp2p/commit/0701de40b1ebdf319959846d8c4fdd30b3cf34a4))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.32.0](https://github.com/libp2p/js-libp2p/compare/v0.32.0-rc.0...v0.32.0) (2021-07-15)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.32.0-rc.0](https://github.com/libp2p/js-libp2p/compare/v0.31.7...v0.32.0-rc.0) (2021-07-09)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* do not allow dial to large number of multiaddrs ([#954](https://github.com/libp2p/js-libp2p/issues/954)) ([af723b3](https://github.com/libp2p/js-libp2p/commit/af723b355e1ddf4aecf439f81c3aa67613d45fa4))
|
||||||
|
|
||||||
|
|
||||||
|
### chore
|
||||||
|
|
||||||
|
* update to new multiformats ([#948](https://github.com/libp2p/js-libp2p/issues/948)) ([13cf476](https://github.com/libp2p/js-libp2p/commit/13cf4761489d59b22924bb8ec2ec6dbe207b280c))
|
||||||
|
|
||||||
|
|
||||||
|
### BREAKING CHANGES
|
||||||
|
|
||||||
|
* uses the CID class from the new multiformats module
|
||||||
|
|
||||||
|
Co-authored-by: Vasco Santos <vasco.santos@moxy.studio>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.31.7](https://github.com/libp2p/js-libp2p/compare/v0.31.6...v0.31.7) (2021-06-14)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* chat example with new multiaddr ([#946](https://github.com/libp2p/js-libp2p/issues/946)) ([d8ba284](https://github.com/libp2p/js-libp2p/commit/d8ba2848833d9fb8a963d1b7c8d27062c6f829da))
|
||||||
|
* dialer leaking resources after stopping ([#947](https://github.com/libp2p/js-libp2p/issues/947)) ([b291bc0](https://github.com/libp2p/js-libp2p/commit/b291bc06ec13feeb6e010730edfad754a3b2dc1b))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.31.6](https://github.com/libp2p/js-libp2p/compare/v0.31.5...v0.31.6) (2021-05-27)
|
||||||
|
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
* keychain rotate passphrase ([#944](https://github.com/libp2p/js-libp2p/issues/944)) ([478963a](https://github.com/libp2p/js-libp2p/commit/478963ad2d195444494c0acc54cb3847a29e117c))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.31.5](https://github.com/libp2p/js-libp2p/compare/v0.31.4...v0.31.5) (2021-05-12)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* store remote agent and protocol version during identify ([#943](https://github.com/libp2p/js-libp2p/issues/943)) ([818d2b2](https://github.com/libp2p/js-libp2p/commit/818d2b2a98736f4242694479089396f6070cdad5))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.31.4](https://github.com/libp2p/js-libp2p/compare/v0.31.3...v0.31.4) (2021-05-12)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* peerRouting.findPeer() trying to find self ([#941](https://github.com/libp2p/js-libp2p/issues/941)) ([a79c6b5](https://github.com/libp2p/js-libp2p/commit/a79c6b50d7fddbcdb1af53efae922cecad4c9a83))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.31.3](https://github.com/libp2p/js-libp2p/compare/v0.31.2...v0.31.3) (2021-05-04)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.31.2](https://github.com/libp2p/js-libp2p/compare/v0.31.1...v0.31.2) (2021-04-30)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* moving averages record types ([#935](https://github.com/libp2p/js-libp2p/issues/935)) ([b5a9eb2](https://github.com/libp2p/js-libp2p/commit/b5a9eb208763efa027d0b4caae87c515b6f5869b))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.31.1](https://github.com/libp2p/js-libp2p/compare/v0.31.0...v0.31.1) (2021-04-30)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* event emitter and interfaces types for discovery and routing ([#934](https://github.com/libp2p/js-libp2p/issues/934)) ([302bb90](https://github.com/libp2p/js-libp2p/commit/302bb9005891aa06b70a5f354bfac6b2d5a3c3b8))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0](https://github.com/libp2p/js-libp2p/compare/v0.31.0-rc.7...v0.31.0) (2021-04-28)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0-rc.7](https://github.com/libp2p/js-libp2p/compare/v0.31.0-rc.6...v0.31.0-rc.7) (2021-04-27)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* address book guarantees no replicated entries are added ([#927](https://github.com/libp2p/js-libp2p/issues/927)) ([ac370fc](https://github.com/libp2p/js-libp2p/commit/ac370fc9679b51da8cee3791b6dd268d0695d136))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0-rc.6](https://github.com/libp2p/js-libp2p/compare/v0.31.0-rc.5...v0.31.0-rc.6) (2021-04-22)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* keychain optional pw and use interfaces for validators and selectors instead ([#924](https://github.com/libp2p/js-libp2p/issues/924)) ([88b0415](https://github.com/libp2p/js-libp2p/commit/88b04156bf614650c2b14d49b12e969c5eecf04d))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0-rc.5](https://github.com/libp2p/js-libp2p/compare/v0.31.0-rc.4...v0.31.0-rc.5) (2021-04-21)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* address book should not emit peer event if no addresses are known ([b4fb9b7](https://github.com/libp2p/js-libp2p/commit/b4fb9b7bf266ba03c4462c0a41b1c2691e4e88d4))
|
||||||
|
* demand pubsub subclass instead of pubsub instance ([#922](https://github.com/libp2p/js-libp2p/issues/922)) ([086b0ec](https://github.com/libp2p/js-libp2p/commit/086b0ec0df2fac93845d0a0a6b2e2464e869afcd))
|
||||||
|
* dht configuration selectors and validators ([#919](https://github.com/libp2p/js-libp2p/issues/919)) ([cc1f4af](https://github.com/libp2p/js-libp2p/commit/cc1f4af879a58e94538591851d0085ff98cd2641))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0-rc.4](https://github.com/libp2p/js-libp2p/compare/v0.31.0-rc.3...v0.31.0-rc.4) (2021-04-20)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* add clientMode dht arg and upgrade interface-datastore ([#918](https://github.com/libp2p/js-libp2p/issues/918)) ([975e779](https://github.com/libp2p/js-libp2p/commit/975e77991e67dd9bff790b83df7bd6fa5ddcfc67))
|
||||||
|
* do not add abort signals to useless addresses ([#913](https://github.com/libp2p/js-libp2p/issues/913)) ([06e8f3d](https://github.com/libp2p/js-libp2p/commit/06e8f3dd42432e4b37ab7904b02abde7d1cadda3))
|
||||||
|
* specify pbjs root ([#917](https://github.com/libp2p/js-libp2p/issues/917)) ([b043bca](https://github.com/libp2p/js-libp2p/commit/b043bca607565cf534771e6cf975288a8ff3030b))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0-rc.3](https://github.com/libp2p/js-libp2p/compare/v0.31.0-rc.2...v0.31.0-rc.3) (2021-04-19)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* remove inline arg types from function definitions ([#916](https://github.com/libp2p/js-libp2p/issues/916)) ([2af692f](https://github.com/libp2p/js-libp2p/commit/2af692fb4de572168524ae684608fc6526de4ef7))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0-rc.2](https://github.com/libp2p/js-libp2p/compare/v0.31.0-rc.1...v0.31.0-rc.2) (2021-04-16)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* metrics stats and moving averages types ([#915](https://github.com/libp2p/js-libp2p/issues/915)) ([3d0a79e](https://github.com/libp2p/js-libp2p/commit/3d0a79eff3bc34a5bdc8ffa31e9b09345a02ad9d))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0-rc.1](https://github.com/libp2p/js-libp2p/compare/v0.31.0-rc.0...v0.31.0-rc.1) (2021-04-16)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* dial protocol should throw if no protocol is provided ([#914](https://github.com/libp2p/js-libp2p/issues/914)) ([21c9aee](https://github.com/libp2p/js-libp2p/commit/21c9aeecb13440238aa6b0fb5a6731d2f87d4938))
|
||||||
|
|
||||||
|
|
||||||
|
### BREAKING CHANGES
|
||||||
|
|
||||||
|
* dialProtocol does not return connection when no protocols are provided
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# [0.31.0-rc.0](https://github.com/libp2p/js-libp2p/compare/v0.30.12...v0.31.0-rc.0) (2021-04-15)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.30.12](https://github.com/libp2p/js-libp2p/compare/v0.30.11...v0.30.12) (2021-03-27)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* the API of es6-promisify is not the same as promisify-es6 ([#905](https://github.com/libp2p/js-libp2p/issues/905)) ([a7128f0](https://github.com/libp2p/js-libp2p/commit/a7128f07ec8d4b729145ecfc6ad1d585ffddea46))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.30.11](https://github.com/libp2p/js-libp2p/compare/v0.30.10...v0.30.11) (2021-03-23)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* connection direction should be only inbound or outbound ([9504f19](https://github.com/libp2p/js-libp2p/commit/9504f1951a3cca55bb7b4e25e4934e4024034ee8))
|
||||||
|
* interface-datastore update ([f5c1cd1](https://github.com/libp2p/js-libp2p/commit/f5c1cd1fb07bc73cf9d9da3c2eb4327bed4279a4))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.30.10](https://github.com/libp2p/js-libp2p/compare/v0.30.9...v0.30.10) (2021-03-09)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* conn mgr access to moving averages record object ([#897](https://github.com/libp2p/js-libp2p/issues/897)) ([5f702f3](https://github.com/libp2p/js-libp2p/commit/5f702f3481afd4ad4fbc89f0e9b75a6d56b03520))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.30.9](https://github.com/libp2p/js-libp2p/compare/v0.30.8...v0.30.9) (2021-02-25)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* transport manager fault tolerance should include tolerance to transport listen fail ([#893](https://github.com/libp2p/js-libp2p/issues/893)) ([3f314d5](https://github.com/libp2p/js-libp2p/commit/3f314d5e90f74583b721386d0c9c5d8363cd4de7))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## [0.30.8](https://github.com/libp2p/js-libp2p/compare/v0.30.7...v0.30.8) (2021-02-11)
|
||||||
|
|
||||||
|
|
||||||
|
### Bug Fixes
|
||||||
|
|
||||||
|
* routers should only use dht if enabled ([#885](https://github.com/libp2p/js-libp2p/issues/885)) ([a34d2bb](https://github.com/libp2p/js-libp2p/commit/a34d2bbcc3d69ec3006137a909a7e8c53b9d378e))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## [0.30.7](https://github.com/libp2p/js-libp2p/compare/v0.30.6...v0.30.7) (2021-02-01)
|
## [0.30.7](https://github.com/libp2p/js-libp2p/compare/v0.30.6...v0.30.7) (2021-02-01)
|
||||||
|
|
||||||
|
|
||||||
|
@ -163,9 +163,9 @@ List of packages currently in existence for libp2p
|
|||||||
| [`libp2p-kad-dht`](//github.com/libp2p/js-libp2p-kad-dht) | [](//github.com/libp2p/js-libp2p-kad-dht/releases) | [](https://david-dm.org/libp2p/js-libp2p-kad-dht) | [](https://travis-ci.com/libp2p/js-libp2p-kad-dht) | [](https://codecov.io/gh/libp2p/js-libp2p-kad-dht) | [Vasco Santos](mailto:vasco.santos@moxy.studio) |
|
| [`libp2p-kad-dht`](//github.com/libp2p/js-libp2p-kad-dht) | [](//github.com/libp2p/js-libp2p-kad-dht/releases) | [](https://david-dm.org/libp2p/js-libp2p-kad-dht) | [](https://travis-ci.com/libp2p/js-libp2p-kad-dht) | [](https://codecov.io/gh/libp2p/js-libp2p-kad-dht) | [Vasco Santos](mailto:vasco.santos@moxy.studio) |
|
||||||
| **utilities** |
|
| **utilities** |
|
||||||
| [`libp2p-crypto`](//github.com/libp2p/js-libp2p-crypto) | [](//github.com/libp2p/js-libp2p-crypto/releases) | [](https://david-dm.org/libp2p/js-libp2p-crypto) | [](https://travis-ci.com/libp2p/js-libp2p-crypto) | [](https://codecov.io/gh/libp2p/js-libp2p-crypto) | [Jacob Heun](mailto:jacobheun@gmail.com) |
|
| [`libp2p-crypto`](//github.com/libp2p/js-libp2p-crypto) | [](//github.com/libp2p/js-libp2p-crypto/releases) | [](https://david-dm.org/libp2p/js-libp2p-crypto) | [](https://travis-ci.com/libp2p/js-libp2p-crypto) | [](https://codecov.io/gh/libp2p/js-libp2p-crypto) | [Jacob Heun](mailto:jacobheun@gmail.com) |
|
||||||
| [`libp2p-crypto-secp256k1`](//github.com/libp2p/js-libp2p-crypto-secp256k1) | [](//github.com/libp2p/js-libp2p-crypto-secp256k1/releases) | [](https://david-dm.org/libp2p/js-libp2p-crypto-secp256k1) | [](https://travis-ci.com/libp2p/js-libp2p-crypto-secp256k1) | [](https://codecov.io/gh/libp2p/js-libp2p-crypto-secp256k1) | [Friedel Ziegelmayer](mailto:dignifiedquire@gmail.com) |
|
|
||||||
| **data types** |
|
| **data types** |
|
||||||
| [`peer-id`](//github.com/libp2p/js-peer-id) | [](//github.com/libp2p/js-peer-id/releases) | [](https://david-dm.org/libp2p/js-peer-id) | [](https://travis-ci.com/libp2p/js-peer-id) | [](https://codecov.io/gh/libp2p/js-peer-id) | [Vasco Santos](mailto:santos.vasco10@gmail.com) |
|
| [`peer-id`](//github.com/libp2p/js-peer-id) | [](//github.com/libp2p/js-peer-id/releases) | [](https://david-dm.org/libp2p/js-peer-id) | [](https://travis-ci.com/libp2p/js-peer-id) | [](https://codecov.io/gh/libp2p/js-peer-id) | [Vasco Santos](mailto:santos.vasco10@gmail.com) |
|
||||||
|
| [`libp2p-record`](//github.com/libp2p/js-libp2p-record) | [](//github.com/libp2p/js-libp2p-record/releases) | [](https://david-dm.org/libp2p/js-libp2p-record) | [](https://travis-ci.com/libp2p/js-libp2p-record) | [](https://codecov.io/gh/libp2p/js-libp2p-record) | [Jacob Heun](mailto:santos.vasco10@gmail.com) |
|
||||||
| **pubsub** |
|
| **pubsub** |
|
||||||
| [`libp2p-floodsub`](//github.com/libp2p/js-libp2p-floodsub) | [](//github.com/libp2p/js-libp2p-floodsub/releases) | [](https://david-dm.org/libp2p/js-libp2p-floodsub) | [](https://travis-ci.com/libp2p/js-libp2p-floodsub) | [](https://codecov.io/gh/libp2p/js-libp2p-floodsub) | [Vasco Santos](mailto:vasco.santos@moxy.studio) |
|
| [`libp2p-floodsub`](//github.com/libp2p/js-libp2p-floodsub) | [](//github.com/libp2p/js-libp2p-floodsub/releases) | [](https://david-dm.org/libp2p/js-libp2p-floodsub) | [](https://travis-ci.com/libp2p/js-libp2p-floodsub) | [](https://codecov.io/gh/libp2p/js-libp2p-floodsub) | [Vasco Santos](mailto:vasco.santos@moxy.studio) |
|
||||||
| [`libp2p-gossipsub`](//github.com/ChainSafe/js-libp2p-gossipsub) | [](//github.com/ChainSafe/js-libp2p-gossipsub/releases) | [](https://david-dm.org/ChainSafe/js-libp2p-gossipsub) | [](https://travis-ci.com/ChainSafe/js-libp2p-gossipsub) | [](https://codecov.io/gh/ChainSafe/js-libp2p-gossipsub) | [Cayman Nava](mailto:caymannava@gmail.com) |
|
| [`libp2p-gossipsub`](//github.com/ChainSafe/js-libp2p-gossipsub) | [](//github.com/ChainSafe/js-libp2p-gossipsub/releases) | [](https://david-dm.org/ChainSafe/js-libp2p-gossipsub) | [](https://travis-ci.com/ChainSafe/js-libp2p-gossipsub) | [](https://codecov.io/gh/ChainSafe/js-libp2p-gossipsub) | [Cayman Nava](mailto:caymannava@gmail.com) |
|
||||||
|
@ -2086,7 +2086,7 @@ the NatManager performing NAT hole punching.
|
|||||||
|
|
||||||
[address]: https://github.com/libp2p/js-libp2p/tree/master/src/peer-store/address-book.js
|
[address]: https://github.com/libp2p/js-libp2p/tree/master/src/peer-store/address-book.js
|
||||||
[cid]: https://github.com/multiformats/js-cid
|
[cid]: https://github.com/multiformats/js-cid
|
||||||
[connection]: https://github.com/libp2p/js-interfaces/tree/master/src/connection
|
[connection]: https://github.com/libp2p/js-libp2p-interfaces/tree/master/packages/interfaces/src/connection
|
||||||
[multiaddr]: https://github.com/multiformats/js-multiaddr
|
[multiaddr]: https://github.com/multiformats/js-multiaddr
|
||||||
[peer-id]: https://github.com/libp2p/js-peer-id
|
[peer-id]: https://github.com/libp2p/js-peer-id
|
||||||
[keys]: https://github.com/libp2p/js-libp2p-crypto/tree/master/src/keys
|
[keys]: https://github.com/libp2p/js-libp2p-crypto/tree/master/src/keys
|
||||||
|
@ -1,37 +1,37 @@
|
|||||||
# Configuration
|
#
|
||||||
|
|
||||||
- [Configuration](#configuration)
|
- [Overview](#overview)
|
||||||
- [Overview](#overview)
|
- [Modules](#modules)
|
||||||
- [Modules](#modules)
|
- [Transport](#transport)
|
||||||
- [Transport](#transport)
|
- [Stream Multiplexing](#stream-multiplexing)
|
||||||
- [Stream Multiplexing](#stream-multiplexing)
|
- [Connection Encryption](#connection-encryption)
|
||||||
- [Connection Encryption](#connection-encryption)
|
- [Peer Discovery](#peer-discovery)
|
||||||
- [Peer Discovery](#peer-discovery)
|
- [Content Routing](#content-routing)
|
||||||
- [Content Routing](#content-routing)
|
- [Peer Routing](#peer-routing)
|
||||||
- [Peer Routing](#peer-routing)
|
- [DHT](#dht)
|
||||||
- [DHT](#dht)
|
- [Pubsub](#pubsub)
|
||||||
- [Pubsub](#pubsub)
|
- [Customizing libp2p](#customizing-libp2p)
|
||||||
- [Customizing libp2p](#customizing-libp2p)
|
- [Examples](#examples)
|
||||||
- [Examples](#examples)
|
- [Basic setup](#basic-setup)
|
||||||
- [Basic setup](#basic-setup)
|
- [Customizing Peer Discovery](#customizing-peer-discovery)
|
||||||
- [Customizing Peer Discovery](#customizing-peer-discovery)
|
- [Setup webrtc transport and discovery](#setup-webrtc-transport-and-discovery)
|
||||||
- [Setup webrtc transport and discovery](#setup-webrtc-transport-and-discovery)
|
- [Customizing Pubsub](#customizing-pubsub)
|
||||||
- [Customizing Pubsub](#customizing-pubsub)
|
- [Customizing DHT](#customizing-dht)
|
||||||
- [Customizing DHT](#customizing-dht)
|
- [Setup with Content and Peer Routing](#setup-with-content-and-peer-routing)
|
||||||
- [Setup with Content and Peer Routing](#setup-with-content-and-peer-routing)
|
- [Setup with Relay](#setup-with-relay)
|
||||||
- [Setup with Relay](#setup-with-relay)
|
- [Setup with Auto Relay](#setup-with-auto-relay)
|
||||||
- [Setup with Auto Relay](#setup-with-auto-relay)
|
- [Setup with Keychain](#setup-with-keychain)
|
||||||
- [Setup with Keychain](#setup-with-keychain)
|
- [Configuring Dialing](#configuring-dialing)
|
||||||
- [Configuring Dialing](#configuring-dialing)
|
- [Configuring Connection Manager](#configuring-connection-manager)
|
||||||
- [Configuring Connection Manager](#configuring-connection-manager)
|
- [Configuring Transport Manager](#configuring-transport-manager)
|
||||||
- [Configuring Transport Manager](#configuring-transport-manager)
|
- [Configuring Metrics](#configuring-metrics)
|
||||||
- [Configuring Metrics](#configuring-metrics)
|
- [Configuring PeerStore](#configuring-peerstore)
|
||||||
- [Configuring PeerStore](#configuring-peerstore)
|
- [Customizing Transports](#customizing-transports)
|
||||||
- [Customizing Transports](#customizing-transports)
|
- [Configuring the NAT Manager](#configuring-the-nat-manager)
|
||||||
- [Configuring the NAT Manager](#configuring-the-nat-manager)
|
- [Browser support](#browser-support)
|
||||||
- [Browser support](#browser-support)
|
- [UPnP and NAT-PMP](#upnp-and-nat-pmp)
|
||||||
- [UPnP and NAT-PMP](#upnp-and-nat-pmp)
|
- [Configuring protocol name](#configuring-protocol-name)
|
||||||
- [Configuration examples](#configuration-examples)
|
- [Configuration examples](#configuration-examples)
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
@ -210,7 +210,7 @@ const modules = {
|
|||||||
Moreover, the majority of the modules can be customized via option parameters. This way, it is also possible to provide this options through a `config` object. This config object should have the property name of each building block to configure, the same way as the modules specification.
|
Moreover, the majority of the modules can be customized via option parameters. This way, it is also possible to provide this options through a `config` object. This config object should have the property name of each building block to configure, the same way as the modules specification.
|
||||||
|
|
||||||
Besides the `modules` and `config`, libp2p allows other internal options and configurations:
|
Besides the `modules` and `config`, libp2p allows other internal options and configurations:
|
||||||
- `datastore`: an instance of [ipfs/interface-datastore](https://github.com/ipfs/interface-datastore/) modules.
|
- `datastore`: an instance of [ipfs/interface-datastore](https://github.com/ipfs/js-ipfs-interfaces/tree/master/packages/interface-datastore) modules.
|
||||||
- This is used in modules such as the DHT. If it is not provided, `js-libp2p` will use an in memory datastore.
|
- This is used in modules such as the DHT. If it is not provided, `js-libp2p` will use an in memory datastore.
|
||||||
- `peerId`: the identity of the node, an instance of [libp2p/js-peer-id](https://github.com/libp2p/js-peer-id).
|
- `peerId`: the identity of the node, an instance of [libp2p/js-peer-id](https://github.com/libp2p/js-peer-id).
|
||||||
- This is particularly useful if you want to reuse the same `peer-id`, as well as for modules like `libp2p-delegated-content-routing`, which need a `peer-id` in their instantiation.
|
- This is particularly useful if you want to reuse the same `peer-id`, as well as for modules like `libp2p-delegated-content-routing`, which need a `peer-id` in their instantiation.
|
||||||
@ -282,7 +282,7 @@ const node = await Libp2p.create({
|
|||||||
interval: 1000,
|
interval: 1000,
|
||||||
enabled: true
|
enabled: true
|
||||||
},
|
},
|
||||||
[Bootstrap.tag:] {
|
[Bootstrap.tag]: {
|
||||||
list: [ // A list of bootstrap peers to connect to starting up the node
|
list: [ // A list of bootstrap peers to connect to starting up the node
|
||||||
"/ip4/104.131.131.82/tcp/4001/ipfs/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ",
|
"/ip4/104.131.131.82/tcp/4001/ipfs/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ",
|
||||||
"/dnsaddr/bootstrap.libp2p.io/ipfs/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN",
|
"/dnsaddr/bootstrap.libp2p.io/ipfs/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN",
|
||||||
@ -373,12 +373,8 @@ const node = await Libp2p.create({
|
|||||||
config: {
|
config: {
|
||||||
dht: { // The DHT options (and defaults) can be found in its documentation
|
dht: { // The DHT options (and defaults) can be found in its documentation
|
||||||
kBucketSize: 20,
|
kBucketSize: 20,
|
||||||
enabled: true,
|
enabled: true, // This flag is required for DHT to run (disabled by default)
|
||||||
randomWalk: {
|
clientMode: false // Whether to run the WAN DHT in client or server mode (default: client mode)
|
||||||
enabled: true, // Allows to disable discovery (enabled by default)
|
|
||||||
interval: 300e3,
|
|
||||||
timeout: 10e3
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
@ -391,6 +387,7 @@ const Libp2p = require('libp2p')
|
|||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('libp2p-noise')
|
||||||
|
const ipfsHttpClient = require('ipfs-http-client')
|
||||||
const DelegatedPeerRouter = require('libp2p-delegated-peer-routing')
|
const DelegatedPeerRouter = require('libp2p-delegated-peer-routing')
|
||||||
const DelegatedContentRouter = require('libp2p-delegated-content-routing')
|
const DelegatedContentRouter = require('libp2p-delegated-content-routing')
|
||||||
const PeerId = require('peer-id')
|
const PeerId = require('peer-id')
|
||||||
@ -398,17 +395,25 @@ const PeerId = require('peer-id')
|
|||||||
// create a peerId
|
// create a peerId
|
||||||
const peerId = await PeerId.create()
|
const peerId = await PeerId.create()
|
||||||
|
|
||||||
|
const delegatedPeerRouting = new DelegatedPeerRouter(ipfsHttpClient.create({
|
||||||
|
host: 'node0.delegate.ipfs.io', // In production you should setup your own delegates
|
||||||
|
protocol: 'https',
|
||||||
|
port: 443
|
||||||
|
}))
|
||||||
|
|
||||||
|
const delegatedContentRouting = new DelegatedContentRouter(peerId, ipfsHttpClient.create({
|
||||||
|
host: 'node0.delegate.ipfs.io', // In production you should setup your own delegates
|
||||||
|
protocol: 'https',
|
||||||
|
port: 443
|
||||||
|
}))
|
||||||
|
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
modules: {
|
modules: {
|
||||||
transport: [TCP],
|
transport: [TCP],
|
||||||
streamMuxer: [MPLEX],
|
streamMuxer: [MPLEX],
|
||||||
connEncryption: [NOISE],
|
connEncryption: [NOISE],
|
||||||
contentRouting: [
|
contentRouting: [delegatedContentRouting],
|
||||||
new DelegatedContentRouter(peerId)
|
peerRouting: [delegatedPeerRouting],
|
||||||
],
|
|
||||||
peerRouting: [
|
|
||||||
new DelegatedPeerRouter()
|
|
||||||
],
|
|
||||||
},
|
},
|
||||||
peerId,
|
peerId,
|
||||||
peerRouting: { // Peer routing configuration
|
peerRouting: { // Peer routing configuration
|
||||||
@ -494,6 +499,9 @@ const MPLEX = require('libp2p-mplex')
|
|||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('libp2p-noise')
|
||||||
const LevelStore = require('datastore-level')
|
const LevelStore = require('datastore-level')
|
||||||
|
|
||||||
|
const datastore = new LevelStore('path/to/store')
|
||||||
|
await datastore.open()
|
||||||
|
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
modules: {
|
modules: {
|
||||||
transport: [TCP],
|
transport: [TCP],
|
||||||
@ -502,11 +510,11 @@ const node = await Libp2p.create({
|
|||||||
},
|
},
|
||||||
keychain: {
|
keychain: {
|
||||||
pass: 'notsafepassword123456789',
|
pass: 'notsafepassword123456789',
|
||||||
datastore: new LevelStore('path/to/store')
|
datastore: dsInstant,
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
await libp2p.loadKeychain()
|
await node.loadKeychain()
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Configuring Dialing
|
#### Configuring Dialing
|
||||||
@ -516,6 +524,7 @@ Dialing in libp2p can be configured to limit the rate of dialing, and how long d
|
|||||||
| Name | Type | Description |
|
| Name | Type | Description |
|
||||||
|------|------|-------------|
|
|------|------|-------------|
|
||||||
| maxParallelDials | `number` | How many multiaddrs we can dial in parallel. |
|
| maxParallelDials | `number` | How many multiaddrs we can dial in parallel. |
|
||||||
|
| maxAddrsToDial | `number` | How many multiaddrs is the dial allowed to dial for a single peer. |
|
||||||
| maxDialsPerPeer | `number` | How many multiaddrs we can dial per peer, in parallel. |
|
| maxDialsPerPeer | `number` | How many multiaddrs we can dial per peer, in parallel. |
|
||||||
| dialTimeout | `number` | Second dial timeout per peer in ms. |
|
| dialTimeout | `number` | Second dial timeout per peer in ms. |
|
||||||
| resolvers | `object` | Dial [Resolvers](https://github.com/multiformats/js-multiaddr/blob/master/src/resolvers/index.js) for resolving multiaddrs |
|
| resolvers | `object` | Dial [Resolvers](https://github.com/multiformats/js-multiaddr/blob/master/src/resolvers/index.js) for resolving multiaddrs |
|
||||||
@ -540,6 +549,7 @@ const node = await Libp2p.create({
|
|||||||
},
|
},
|
||||||
dialer: {
|
dialer: {
|
||||||
maxParallelDials: 100,
|
maxParallelDials: 100,
|
||||||
|
maxAddrsToDial: 25,
|
||||||
maxDialsPerPeer: 4,
|
maxDialsPerPeer: 4,
|
||||||
dialTimeout: 30e3,
|
dialTimeout: 30e3,
|
||||||
resolvers: {
|
resolvers: {
|
||||||
@ -590,7 +600,7 @@ const TCP = require('libp2p-tcp')
|
|||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('libp2p-noise')
|
||||||
|
|
||||||
const { FaultTolerance } = require('libp2p/src/transport-manager')}
|
const { FaultTolerance } = require('libp2p/src/transport-manager')
|
||||||
|
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
modules: {
|
modules: {
|
||||||
@ -662,16 +672,18 @@ const Libp2p = require('libp2p')
|
|||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('libp2p-noise')
|
||||||
|
|
||||||
const LevelStore = require('datastore-level')
|
const LevelStore = require('datastore-level')
|
||||||
|
|
||||||
|
const datastore = new LevelStore('path/to/store')
|
||||||
|
const dsInstant = await datastore.open()
|
||||||
|
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
modules: {
|
modules: {
|
||||||
transport: [TCP],
|
transport: [TCP],
|
||||||
streamMuxer: [MPLEX],
|
streamMuxer: [MPLEX],
|
||||||
connEncryption: [NOISE]
|
connEncryption: [NOISE]
|
||||||
},
|
},
|
||||||
datastore: new LevelStore('path/to/store'),
|
datastore: dsInstant,
|
||||||
peerStore: {
|
peerStore: {
|
||||||
persistence: true,
|
persistence: true,
|
||||||
threshold: 5
|
threshold: 5
|
||||||
@ -770,6 +782,26 @@ By default under nodejs libp2p will attempt to use [UPnP](https://en.wikipedia.o
|
|||||||
|
|
||||||
[NAT-PMP](http://miniupnp.free.fr/nat-pmp.html) is a feature of some modern routers which performs a similar job to UPnP. NAT-PMP is disabled by default, if enabled libp2p will try to use NAT-PMP and will fall back to UPnP if it fails.
|
[NAT-PMP](http://miniupnp.free.fr/nat-pmp.html) is a feature of some modern routers which performs a similar job to UPnP. NAT-PMP is disabled by default, if enabled libp2p will try to use NAT-PMP and will fall back to UPnP if it fails.
|
||||||
|
|
||||||
|
#### Configuring protocol name
|
||||||
|
|
||||||
|
Changing the protocol name prefix can isolate default public network (IPFS) for custom purposes.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const node = await Libp2p.create({
|
||||||
|
config: {
|
||||||
|
protocolPrefix: 'ipfs' // default
|
||||||
|
}
|
||||||
|
})
|
||||||
|
/*
|
||||||
|
protocols: [
|
||||||
|
"/ipfs/id/1.0.0", // identify service protocol (if we have multiplexers)
|
||||||
|
"/ipfs/id/push/1.0.0", // identify service push protocol (if we have multiplexers)
|
||||||
|
"/ipfs/ping/1.0.0", // built-in ping protocol
|
||||||
|
]
|
||||||
|
*/
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
## Configuration examples
|
## Configuration examples
|
||||||
|
|
||||||
As libp2p is designed to be a modular networking library, its usage will vary based on individual project needs. We've included links to some existing project configurations for your reference, in case you wish to replicate their configuration:
|
As libp2p is designed to be a modular networking library, its usage will vary based on individual project needs. We've included links to some existing project configurations for your reference, in case you wish to replicate their configuration:
|
||||||
|
123
doc/migrations/v0.30-v0.31.md
Normal file
123
doc/migrations/v0.30-v0.31.md
Normal file
@ -0,0 +1,123 @@
|
|||||||
|
<!--Specify versions for migration below-->
|
||||||
|
# Migrating to libp2p@31
|
||||||
|
|
||||||
|
A migration guide for refactoring your application code from libp2p v0.30.x to v0.31.0.
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
|
||||||
|
- [Types](#types)
|
||||||
|
- [API](#api)
|
||||||
|
- [Module Updates](#module-updates)
|
||||||
|
|
||||||
|
## Types
|
||||||
|
|
||||||
|
Most of the type definitions in the libp2p configuration were `any` or were not included before this release. This might cause breaking changes on upstream projects relying on the previous provided types, as well as to libp2p modules implemented by the libp2p community.
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### Core API
|
||||||
|
|
||||||
|
`libp2p.dialProtocol` does not accept empty or null protocols returning a connection anymore and `dial` must be used instead.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const connection = await libp2p.dialProtocol(peerId)
|
||||||
|
```
|
||||||
|
|
||||||
|
**After**
|
||||||
|
|
||||||
|
```js
|
||||||
|
const connection = await libp2p.dial(peerId)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Connection Manager Options
|
||||||
|
|
||||||
|
We updated the connection manager options naming in `libp2p@0.29` but kept it backward compatible until now.
|
||||||
|
|
||||||
|
**Before**
|
||||||
|
|
||||||
|
```js
|
||||||
|
const node = await Libp2p.create({
|
||||||
|
connectionManager: {
|
||||||
|
minPeers: 0
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
**After**
|
||||||
|
|
||||||
|
```js
|
||||||
|
const node = await Libp2p.create({
|
||||||
|
connectionManager: {
|
||||||
|
minConnections: 0
|
||||||
|
}
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
You can see full details on how to configure the connection manager [here](https://github.com/libp2p/js-libp2p/blob/master/doc/CONFIGURATION.md#configuring-connection-manager).
|
||||||
|
|
||||||
|
### Dialer and Keychain components
|
||||||
|
|
||||||
|
Internal property names to create a libp2p `Dialer` and `Keychain` were updated to reflect the properties naming in the libp2p configuration. These are internal modules of libp2p core and should not impact most of the users, but as it is possible to use them separately here follow the changes:
|
||||||
|
|
||||||
|
***Before**
|
||||||
|
|
||||||
|
```js
|
||||||
|
const dialer = new Dialer({
|
||||||
|
transportManager,
|
||||||
|
peerStore,
|
||||||
|
concurrency,
|
||||||
|
perPeerLimit,
|
||||||
|
timeout,
|
||||||
|
resolvers,
|
||||||
|
addressSorter
|
||||||
|
})
|
||||||
|
|
||||||
|
const keychain = new Keychain(datastore, {
|
||||||
|
passPhrase
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
**After**
|
||||||
|
|
||||||
|
```js
|
||||||
|
this.dialer = new Dialer({
|
||||||
|
transportManager,
|
||||||
|
peerStore,
|
||||||
|
maxParallelDials,
|
||||||
|
maxDialsPerPeer,
|
||||||
|
dialTimeout,
|
||||||
|
resolvers,
|
||||||
|
addressSorter
|
||||||
|
})
|
||||||
|
|
||||||
|
const keychain = new Keychain(datastore, {
|
||||||
|
pass
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
## Module Updates
|
||||||
|
|
||||||
|
With this release you should update the following libp2p modules if you are relying on them:
|
||||||
|
|
||||||
|
<!--Specify module versions in JSON for migration below.
|
||||||
|
It's recommended to check package.json changes for this:
|
||||||
|
`git diff <release> <prev> -- package.json`
|
||||||
|
-->
|
||||||
|
|
||||||
|
```json
|
||||||
|
"libp2p-bootstrap": "^0.12.3",
|
||||||
|
"libp2p-crypto": "^0.19.4",
|
||||||
|
"libp2p-interfaces": "^0.10.0",
|
||||||
|
"libp2p-delegated-content-routing": "^0.10.0",
|
||||||
|
"libp2p-delegated-peer-routing": "^0.9.0",
|
||||||
|
"libp2p-floodsub": "^0.25.1",
|
||||||
|
"libp2p-gossipsub": "^0.9.0",
|
||||||
|
"libp2p-kad-dht": "^0.22.0",
|
||||||
|
"libp2p-mdns": "^0.16.0",
|
||||||
|
"libp2p-noise": "^3.0.0",
|
||||||
|
"libp2p-tcp": "^0.15.4",
|
||||||
|
"libp2p-webrtc-star": "^0.22.2",
|
||||||
|
"libp2p-websockets": "^0.15.6"
|
||||||
|
```
|
||||||
|
|
||||||
|
One of the main changes in this new release is the update to `multiaddr@9.0.0`. This should also be updated in upstream projects to avoid several multiaddr versions in the bundle and to avoid potential problems when libp2p interacts with provided outdated multiaddr instances.
|
36
doc/migrations/v0.31-v0.32.md
Normal file
36
doc/migrations/v0.31-v0.32.md
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
<!--Specify versions for migration below-->
|
||||||
|
# Migrating to libp2p@32
|
||||||
|
|
||||||
|
A migration guide for refactoring your application code from libp2p v0.31.x to v0.32.0.
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
|
||||||
|
- [Module Updates](#module-updates)
|
||||||
|
|
||||||
|
## Module Updates
|
||||||
|
|
||||||
|
With this release you should update the following libp2p modules if you are relying on them:
|
||||||
|
|
||||||
|
<!--Specify module versions in JSON for migration below.
|
||||||
|
It's recommended to check package.json changes for this:
|
||||||
|
`git diff <release> <prev> -- package.json`
|
||||||
|
-->
|
||||||
|
|
||||||
|
```json
|
||||||
|
"libp2p-bootstrap": "^0.13.0",
|
||||||
|
"libp2p-crypto": "^0.19.4",
|
||||||
|
"libp2p-interfaces": "^1.0.0",
|
||||||
|
"libp2p-delegated-content-routing": "^0.11.0",
|
||||||
|
"libp2p-delegated-peer-routing": "^0.10.0",
|
||||||
|
"libp2p-floodsub": "^0.27.0",
|
||||||
|
"libp2p-gossipsub": "^0.11.0",
|
||||||
|
"libp2p-kad-dht": "^0.23.0",
|
||||||
|
"libp2p-mdns": "^0.17.0",
|
||||||
|
"libp2p-noise": "^4.0.0",
|
||||||
|
"libp2p-tcp": "^0.17.0",
|
||||||
|
"libp2p-webrtc-direct": "^0.7.0",
|
||||||
|
"libp2p-webrtc-star": "^0.23.0",
|
||||||
|
"libp2p-websockets": "^0.16.0"
|
||||||
|
```
|
||||||
|
|
||||||
|
One of the main changes in this new release is the update to `multiaddr@10.0.0`. This should also be updated in upstream projects to avoid several multiaddr versions in the bundle and to avoid potential problems when libp2p interacts with provided outdated multiaddr instances.
|
14
doc/migrations/v0.32-v0.33.md
Normal file
14
doc/migrations/v0.32-v0.33.md
Normal file
@ -0,0 +1,14 @@
|
|||||||
|
<!--Specify versions for migration below-->
|
||||||
|
# Migrating to libp2p@33
|
||||||
|
|
||||||
|
A migration guide for refactoring your application code from libp2p v0.32.x to v0.33.0.
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
|
||||||
|
- [Module Updates](#module-updates)
|
||||||
|
|
||||||
|
## Module Updates
|
||||||
|
|
||||||
|
Libp2p uses a datastore implementation for Peerstore persistence and for the DHT state. While libp2p defaults to a datastore implementation, it can receive any implementation of a datastore compliant with the [interface-datastore](https://github.com/ipfs/js-ipfs-interfaces/tree/master/packages/interface-datastore) via its configuration.
|
||||||
|
|
||||||
|
In this release, we updated to `interface-datastore@6.0.0`. As a result, libp2p users relying on a configured datastore should update it to a compliant implementation for updating libp2p.
|
@ -8,7 +8,7 @@ Let us know if you find any issues, or if you want to contribute and add a new t
|
|||||||
|
|
||||||
- [Transports](./transports)
|
- [Transports](./transports)
|
||||||
- [Protocol and Stream Muxing](./protocol-and-stream-muxing)
|
- [Protocol and Stream Muxing](./protocol-and-stream-muxing)
|
||||||
- [Encrypted Communications](./encrypted-communications)
|
- [Connection Encryption](./connection-encryption)
|
||||||
- [Discovery Mechanisms](./discovery-mechanisms)
|
- [Discovery Mechanisms](./discovery-mechanisms)
|
||||||
- [Peer and Content Routing](./peer-and-content-routing)
|
- [Peer and Content Routing](./peer-and-content-routing)
|
||||||
- [PubSub](./pubsub)
|
- [PubSub](./pubsub)
|
||||||
|
@ -18,7 +18,7 @@ The relay node will need to have its relay subsystem enabled, as well as its HOP
|
|||||||
```js
|
```js
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const Websockets = require('libp2p-websockets')
|
const Websockets = require('libp2p-websockets')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
@ -76,7 +76,7 @@ One of the typical use cases for Auto Relay is nodes behind a NAT or browser nod
|
|||||||
```js
|
```js
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const Websockets = require('libp2p-websockets')
|
const Websockets = require('libp2p-websockets')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
const relayAddr = process.argv[2]
|
const relayAddr = process.argv[2]
|
||||||
@ -125,7 +125,7 @@ As you can see in the code, we need to provide the relay address, `relayAddr`, a
|
|||||||
You should now run the following to start the node running Auto Relay:
|
You should now run the following to start the node running Auto Relay:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
node listener.js /ip4/192.168.1.120/tcp/58941/ws/p2p/QmQKCBm87HQMbFqy14oqC85pMmnRrj6iD46ggM6reqNpsd
|
node listener.js /ip4/192.168.1.120/tcp/61592/ws/p2p/QmWDn2LY8nannvSWJzruUYoLZ4vV83vfCBwd8DipvdgQc3
|
||||||
```
|
```
|
||||||
|
|
||||||
This should print out something similar to the following:
|
This should print out something similar to the following:
|
||||||
@ -147,7 +147,7 @@ Now that you have a relay node and a node bound to that relay, you can test conn
|
|||||||
```js
|
```js
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const Websockets = require('libp2p-websockets')
|
const Websockets = require('libp2p-websockets')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
const autoRelayNodeAddr = process.argv[2]
|
const autoRelayNodeAddr = process.argv[2]
|
||||||
@ -173,7 +173,7 @@ console.log(`Connected to the auto relay node via ${conn.remoteAddr.toString()}`
|
|||||||
You should now run the following to start the relay node using the listen address from step 2:
|
You should now run the following to start the relay node using the listen address from step 2:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
node dialer.js /ip4/192.168.1.120/tcp/58941/ws/p2p/QmQKCBm87HQMbFqy14oqC85pMmnRrj6iD46ggM6reqNpsd
|
node dialer.js /ip4/192.168.1.120/tcp/61592/ws/p2p/QmWDn2LY8nannvSWJzruUYoLZ4vV83vfCBwd8DipvdgQc3
|
||||||
```
|
```
|
||||||
|
|
||||||
Once you start your test node, it should print out something similar to the following:
|
Once you start your test node, it should print out something similar to the following:
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const Websockets = require('libp2p-websockets')
|
const Websockets = require('libp2p-websockets')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
async function main () {
|
async function main () {
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const Websockets = require('libp2p-websockets')
|
const Websockets = require('libp2p-websockets')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
async function main () {
|
async function main () {
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const Websockets = require('libp2p-websockets')
|
const Websockets = require('libp2p-websockets')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
async function main () {
|
async function main () {
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const path = require('path')
|
const path = require('path')
|
||||||
const execa = require('execa')
|
const execa = require('execa')
|
||||||
const pDefer = require('p-defer')
|
const pDefer = require('p-defer')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
function startProcess (name, args = []) {
|
function startProcess (name, args = []) {
|
||||||
return execa('node', [path.join(__dirname, name), ...args], {
|
return execa('node', [path.join(__dirname, name), ...args], {
|
||||||
|
@ -2,11 +2,11 @@
|
|||||||
/* eslint-disable no-console */
|
/* eslint-disable no-console */
|
||||||
|
|
||||||
const PeerId = require('peer-id')
|
const PeerId = require('peer-id')
|
||||||
const multiaddr = require('multiaddr')
|
const { Multiaddr } = require('multiaddr')
|
||||||
const createLibp2p = require('./libp2p')
|
const createLibp2p = require('./libp2p')
|
||||||
const { stdinToStream, streamToConsole } = require('./stream')
|
const { stdinToStream, streamToConsole } = require('./stream')
|
||||||
|
|
||||||
async function run() {
|
async function run () {
|
||||||
const [idDialer, idListener] = await Promise.all([
|
const [idDialer, idListener] = await Promise.all([
|
||||||
PeerId.createFromJSON(require('./peer-id-dialer')),
|
PeerId.createFromJSON(require('./peer-id-dialer')),
|
||||||
PeerId.createFromJSON(require('./peer-id-listener'))
|
PeerId.createFromJSON(require('./peer-id-listener'))
|
||||||
@ -30,7 +30,7 @@ async function run() {
|
|||||||
})
|
})
|
||||||
|
|
||||||
// Dial to the remote peer (the "listener")
|
// Dial to the remote peer (the "listener")
|
||||||
const listenerMa = multiaddr(`/ip4/127.0.0.1/tcp/10333/p2p/${idListener.toB58String()}`)
|
const listenerMa = new Multiaddr(`/ip4/127.0.0.1/tcp/10333/p2p/${idListener.toB58String()}`)
|
||||||
const { stream } = await nodeDialer.dialProtocol(listenerMa, '/chat/1.0.0')
|
const { stream } = await nodeDialer.dialProtocol(listenerMa, '/chat/1.0.0')
|
||||||
|
|
||||||
console.log('Dialer dialed to listener on protocol: /chat/1.0.0')
|
console.log('Dialer dialed to listener on protocol: /chat/1.0.0')
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const WS = require('libp2p-websockets')
|
const WS = require('libp2p-websockets')
|
||||||
const mplex = require('libp2p-mplex')
|
const mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const defaultsDeep = require('@nodeutils/defaults-deep')
|
const defaultsDeep = require('@nodeutils/defaults-deep')
|
||||||
const libp2p = require('../../..')
|
const libp2p = require('../../..')
|
||||||
|
|
||||||
|
@ -5,7 +5,7 @@ const PeerId = require('peer-id')
|
|||||||
const createLibp2p = require('./libp2p.js')
|
const createLibp2p = require('./libp2p.js')
|
||||||
const { stdinToStream, streamToConsole } = require('./stream')
|
const { stdinToStream, streamToConsole } = require('./stream')
|
||||||
|
|
||||||
async function run() {
|
async function run () {
|
||||||
// Create a new libp2p node with the given multi-address
|
// Create a new libp2p node with the given multi-address
|
||||||
const idListener = await PeerId.createFromJSON(require('./peer-id-listener'))
|
const idListener = await PeerId.createFromJSON(require('./peer-id-listener'))
|
||||||
const nodeListener = await createLibp2p({
|
const nodeListener = await createLibp2p({
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const path = require('path')
|
const path = require('path')
|
||||||
const execa = require('execa')
|
const execa = require('execa')
|
||||||
const pDefer = require('p-defer')
|
const pDefer = require('p-defer')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
function startProcess(name) {
|
function startProcess(name) {
|
||||||
return execa('node', [path.join(__dirname, name)], {
|
return execa('node', [path.join(__dirname, name)], {
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const Libp2p = require('../..')
|
const Libp2p = require('../..')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const Mplex = require('libp2p-mplex')
|
const Mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
|
||||||
const pipe = require('it-pipe')
|
const pipe = require('it-pipe')
|
||||||
|
|
||||||
|
@ -8,13 +8,13 @@ A byproduct of having these encrypted communications modules is that we can auth
|
|||||||
|
|
||||||
# 1. Set up encrypted communications
|
# 1. Set up encrypted communications
|
||||||
|
|
||||||
We will build this example on top of example for [Protocol and Stream Multiplexing](../protocol-and-stream-multiplexing). You will need the `libp2p-noise` module to complete it, go ahead and `npm install libp2p-noise`.
|
We will build this example on top of example for [Protocol and Stream Multiplexing](../protocol-and-stream-multiplexing). You will need the `@chainsafe/libp2p-noise` module to complete it, go ahead and `npm install @chainsafe/libp2p-noise`.
|
||||||
|
|
||||||
To add them to your libp2p configuration, all you have to do is:
|
To add them to your libp2p configuration, all you have to do is:
|
||||||
|
|
||||||
```JavaScript
|
```JavaScript
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
|
||||||
const createNode = () => {
|
const createNode = () => {
|
||||||
return Libp2p.create({
|
return Libp2p.create({
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const path = require('path')
|
const path = require('path')
|
||||||
const execa = require('execa')
|
const execa = require('execa')
|
||||||
const pDefer = require('p-defer')
|
const pDefer = require('p-defer')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
async function test () {
|
async function test () {
|
||||||
const messageReceived = pDefer()
|
const messageReceived = pDefer()
|
||||||
|
@ -7,7 +7,7 @@
|
|||||||
"libp2p": "github:libp2p/js-libp2p#master",
|
"libp2p": "github:libp2p/js-libp2p#master",
|
||||||
"libp2p-delegated-content-routing": "~0.2.2",
|
"libp2p-delegated-content-routing": "~0.2.2",
|
||||||
"libp2p-delegated-peer-routing": "~0.2.2",
|
"libp2p-delegated-peer-routing": "~0.2.2",
|
||||||
"libp2p-kad-dht": "~0.14.12",
|
"libp2p-kad-dht": "^0.26.5",
|
||||||
"libp2p-mplex": "~0.8.5",
|
"libp2p-mplex": "~0.8.5",
|
||||||
"libp2p-secio": "~0.11.1",
|
"libp2p-secio": "~0.11.1",
|
||||||
"libp2p-webrtc-star": "~0.15.8",
|
"libp2p-webrtc-star": "~0.15.8",
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
const Libp2p = require('../../')
|
const Libp2p = require('../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const Mplex = require('libp2p-mplex')
|
const Mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const Bootstrap = require('libp2p-bootstrap')
|
const Bootstrap = require('libp2p-bootstrap')
|
||||||
|
|
||||||
const bootstrapers = require('./bootstrapers')
|
const bootstrapers = require('./bootstrapers')
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
const Libp2p = require('../../')
|
const Libp2p = require('../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const Mplex = require('libp2p-mplex')
|
const Mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MulticastDNS = require('libp2p-mdns')
|
const MulticastDNS = require('libp2p-mdns')
|
||||||
|
|
||||||
const createNode = async () => {
|
const createNode = async () => {
|
||||||
|
68
examples/discovery-mechanisms/3.js
Normal file
68
examples/discovery-mechanisms/3.js
Normal file
@ -0,0 +1,68 @@
|
|||||||
|
/* eslint-disable no-console */
|
||||||
|
'use strict'
|
||||||
|
|
||||||
|
const Libp2p = require('../../')
|
||||||
|
const TCP = require('libp2p-tcp')
|
||||||
|
const Mplex = require('libp2p-mplex')
|
||||||
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
const Gossipsub = require('libp2p-gossipsub')
|
||||||
|
const Bootstrap = require('libp2p-bootstrap')
|
||||||
|
const PubsubPeerDiscovery = require('libp2p-pubsub-peer-discovery')
|
||||||
|
|
||||||
|
const createRelayServer = require('libp2p-relay-server')
|
||||||
|
|
||||||
|
const createNode = async (bootstrapers) => {
|
||||||
|
const node = await Libp2p.create({
|
||||||
|
addresses: {
|
||||||
|
listen: ['/ip4/0.0.0.0/tcp/0']
|
||||||
|
},
|
||||||
|
modules: {
|
||||||
|
transport: [TCP],
|
||||||
|
streamMuxer: [Mplex],
|
||||||
|
connEncryption: [NOISE],
|
||||||
|
pubsub: Gossipsub,
|
||||||
|
peerDiscovery: [Bootstrap, PubsubPeerDiscovery]
|
||||||
|
},
|
||||||
|
config: {
|
||||||
|
peerDiscovery: {
|
||||||
|
[PubsubPeerDiscovery.tag]: {
|
||||||
|
interval: 1000,
|
||||||
|
enabled: true
|
||||||
|
},
|
||||||
|
[Bootstrap.tag]: {
|
||||||
|
enabled: true,
|
||||||
|
list: bootstrapers
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
return node
|
||||||
|
}
|
||||||
|
|
||||||
|
;(async () => {
|
||||||
|
const relay = await createRelayServer({
|
||||||
|
listenAddresses: ['/ip4/0.0.0.0/tcp/0']
|
||||||
|
})
|
||||||
|
console.log(`libp2p relay starting with id: ${relay.peerId.toB58String()}`)
|
||||||
|
await relay.start()
|
||||||
|
const relayMultiaddrs = relay.multiaddrs.map((m) => `${m.toString()}/p2p/${relay.peerId.toB58String()}`)
|
||||||
|
|
||||||
|
const [node1, node2] = await Promise.all([
|
||||||
|
createNode(relayMultiaddrs),
|
||||||
|
createNode(relayMultiaddrs)
|
||||||
|
])
|
||||||
|
|
||||||
|
node1.on('peer:discovery', (peerId) => {
|
||||||
|
console.log(`Peer ${node1.peerId.toB58String()} discovered: ${peerId.toB58String()}`)
|
||||||
|
})
|
||||||
|
node2.on('peer:discovery', (peerId) => {
|
||||||
|
console.log(`Peer ${node2.peerId.toB58String()} discovered: ${peerId.toB58String()}`)
|
||||||
|
})
|
||||||
|
|
||||||
|
;[node1, node2].forEach((node, index) => console.log(`Node ${index} starting with id: ${node.peerId.toB58String()}`))
|
||||||
|
await Promise.all([
|
||||||
|
node1.start(),
|
||||||
|
node2.start()
|
||||||
|
])
|
||||||
|
})();
|
@ -2,13 +2,13 @@
|
|||||||
|
|
||||||
A Peer Discovery module enables libp2p to find peers to connect to. Think of these mechanisms as ways to join the rest of the network, as railing points.
|
A Peer Discovery module enables libp2p to find peers to connect to. Think of these mechanisms as ways to join the rest of the network, as railing points.
|
||||||
|
|
||||||
With these system, a libp2p node can both have a set of nodes to always connect on boot (bootstraper nodes), discover nodes through locality (e.g connected in the same LAN) or through serendipity (random walks on a DHT).
|
With this system, a libp2p node can both have a set of nodes to always connect on boot (bootstraper nodes), discover nodes through locality (e.g connected in the same LAN) or through serendipity (random walks on a DHT).
|
||||||
|
|
||||||
These mechanisms save configuration and enable a node to operate without any explicit dials, it will just work. Once new peers are discovered, their known data is stored in the peer's PeerStore.
|
These mechanisms save configuration and enable a node to operate without any explicit dials, it will just work. Once new peers are discovered, their known data is stored in the peer's PeerStore.
|
||||||
|
|
||||||
## 1. Bootstrap list of Peers when booting a node
|
## 1. Bootstrap list of Peers when booting a node
|
||||||
|
|
||||||
For this demo, we will connect to IPFS default bootstrapper nodes and so, we will need to support the same set of features those nodes have, that are: TCP, mplex and NOISE. You can see the complete example at [1.js](./1.js).
|
For this demo, we will connect to IPFS default bootstrapper nodes and so, we will need to support the same set of features those nodes have, that are: TCP, mplex, and NOISE. You can see the complete example at [1.js](./1.js).
|
||||||
|
|
||||||
First, we create our libp2p node.
|
First, we create our libp2p node.
|
||||||
|
|
||||||
@ -16,7 +16,7 @@ First, we create our libp2p node.
|
|||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const Bootstrap = require('libp2p-bootstrap')
|
const Bootstrap = require('libp2p-bootstrap')
|
||||||
|
|
||||||
const node = Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
modules: {
|
modules: {
|
||||||
transport: [ TCP ],
|
transport: [ TCP ],
|
||||||
streamMuxer: [ Mplex ],
|
streamMuxer: [ Mplex ],
|
||||||
@ -55,7 +55,7 @@ const node = await Libp2p.create({
|
|||||||
peerId,
|
peerId,
|
||||||
addresses: {
|
addresses: {
|
||||||
listen: ['/ip4/0.0.0.0/tcp/0']
|
listen: ['/ip4/0.0.0.0/tcp/0']
|
||||||
}
|
},
|
||||||
modules: {
|
modules: {
|
||||||
transport: [ TCP ],
|
transport: [ TCP ],
|
||||||
streamMuxer: [ Mplex ],
|
streamMuxer: [ Mplex ],
|
||||||
@ -117,7 +117,7 @@ const createNode = () => {
|
|||||||
return Libp2p.create({
|
return Libp2p.create({
|
||||||
addresses: {
|
addresses: {
|
||||||
listen: ['/ip4/0.0.0.0/tcp/0']
|
listen: ['/ip4/0.0.0.0/tcp/0']
|
||||||
}
|
},
|
||||||
modules: {
|
modules: {
|
||||||
transport: [ TCP ],
|
transport: [ TCP ],
|
||||||
streamMuxer: [ Mplex ],
|
streamMuxer: [ Mplex ],
|
||||||
@ -144,8 +144,13 @@ const [node1, node2] = await Promise.all([
|
|||||||
createNode()
|
createNode()
|
||||||
])
|
])
|
||||||
|
|
||||||
node1.on('peer:discovery', (peer) => console.log('Discovered:', peer.id.toB58String()))
|
node1.on('peer:discovery', (peer) => console.log('Discovered:', peerId.toB58String()))
|
||||||
node2.on('peer:discovery', (peer) => console.log('Discovered:', peer.id.toB58String()))
|
node2.on('peer:discovery', (peer) => console.log('Discovered:', peerId.toB58String()))
|
||||||
|
|
||||||
|
await Promise.all([
|
||||||
|
node1.start(),
|
||||||
|
node2.start()
|
||||||
|
])
|
||||||
```
|
```
|
||||||
|
|
||||||
If you run this example, you will see the other peers being discovered.
|
If you run this example, you will see the other peers being discovered.
|
||||||
@ -156,10 +161,103 @@ Discovered: QmSSbQpuKrxkoXHm1v4Pi35hPN5hUHMZoBoawEs2Nhvi8m
|
|||||||
Discovered: QmRcXXhtG8vTqwVBRonKWtV4ovDoC1Fe56WYtcrw694eiJ
|
Discovered: QmRcXXhtG8vTqwVBRonKWtV4ovDoC1Fe56WYtcrw694eiJ
|
||||||
```
|
```
|
||||||
|
|
||||||
## 3. Where to find other Peer Discovery Mechanisms
|
## 3. Pubsub based Peer Discovery
|
||||||
|
|
||||||
|
For this example, we need [`libp2p-pubsub-peer-discovery`](https://github.com/libp2p/js-libp2p-pubsub-peer-discovery/), go ahead and `npm install` it. You also need to spin up a set of [`libp2p-relay-servers`](https://github.com/libp2p/js-libp2p-relay-server). These servers act as relay servers and a peer discovery source.
|
||||||
|
|
||||||
|
In the context of this example, we will create and run the `libp2p-relay-server` in the same code snippet. You can find the complete solution at [3.js](./3.js).
|
||||||
|
|
||||||
|
You can create your libp2p nodes as follows:
|
||||||
|
|
||||||
|
```js
|
||||||
|
const Libp2p = require('libp2p')
|
||||||
|
const TCP = require('libp2p-tcp')
|
||||||
|
const Mplex = require('libp2p-mplex')
|
||||||
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
const Gossipsub = require('libp2p-gossipsub')
|
||||||
|
const Bootstrap = require('libp2p-bootstrap')
|
||||||
|
const PubsubPeerDiscovery = require('libp2p-pubsub-peer-discovery')
|
||||||
|
|
||||||
|
const createNode = async (bootstrapers) => {
|
||||||
|
const node = await Libp2p.create({
|
||||||
|
addresses: {
|
||||||
|
listen: ['/ip4/0.0.0.0/tcp/0']
|
||||||
|
},
|
||||||
|
modules: {
|
||||||
|
transport: [TCP],
|
||||||
|
streamMuxer: [Mplex],
|
||||||
|
connEncryption: [NOISE],
|
||||||
|
pubsub: Gossipsub,
|
||||||
|
peerDiscovery: [Bootstrap, PubsubPeerDiscovery]
|
||||||
|
},
|
||||||
|
config: {
|
||||||
|
peerDiscovery: {
|
||||||
|
[PubsubPeerDiscovery.tag]: {
|
||||||
|
interval: 1000,
|
||||||
|
enabled: true
|
||||||
|
},
|
||||||
|
[Bootstrap.tag]: {
|
||||||
|
enabled: true,
|
||||||
|
list: bootstrapers
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
return node
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
We will use the `libp2p-relay-server` as bootstrap nodes for the libp2p nodes, so that they establish a connection with the relay after starting. As a result, after they establish a connection with the relay, the pubsub discovery will kick in and the relay will advertise them.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const relay = await createRelayServer({
|
||||||
|
listenAddresses: ['/ip4/0.0.0.0/tcp/0']
|
||||||
|
})
|
||||||
|
console.log(`libp2p relay starting with id: ${relay.peerId.toB58String()}`)
|
||||||
|
await relay.start()
|
||||||
|
const relayMultiaddrs = relay.multiaddrs.map((m) => `${m.toString()}/p2p/${relay.peerId.toB58String()}`)
|
||||||
|
|
||||||
|
const [node1, node2] = await Promise.all([
|
||||||
|
createNode(relayMultiaddrs),
|
||||||
|
createNode(relayMultiaddrs)
|
||||||
|
])
|
||||||
|
|
||||||
|
node1.on('peer:discovery', (peerId) => {
|
||||||
|
console.log(`Peer ${node1.peerId.toB58String()} discovered: ${peerId.toB58String()}`)
|
||||||
|
})
|
||||||
|
node2.on('peer:discovery', (peerId) => {
|
||||||
|
console.log(`Peer ${node2.peerId.toB58String()} discovered: ${peerId.toB58String()}`)
|
||||||
|
})
|
||||||
|
|
||||||
|
;[node1, node2].forEach((node, index) => console.log(`Node ${index} starting with id: ${node.peerId.toB58String()}`))
|
||||||
|
await Promise.all([
|
||||||
|
node1.start(),
|
||||||
|
node2.start()
|
||||||
|
])
|
||||||
|
```
|
||||||
|
|
||||||
|
If you run this example, you will see the other peers being discovered.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
> node 3.js
|
||||||
|
libp2p relay starting with id: QmW6FqVV6RsyoGC5zaeFGW9gSWA3LcBRVZrjkKMruh38Bo
|
||||||
|
Node 0 starting with id: QmezqDTmEjZ5BfMgVqjSpLY19mVVLTQ9bE9mRpZwtGxL8N
|
||||||
|
Node 1 starting with id: QmYWeom2odTkm79DzB68NHULqVHDaNDqHhoyqLdcV1fqdv
|
||||||
|
Peer QmezqDTmEjZ5BfMgVqjSpLY19mVVLTQ9bE9mRpZwtGxL8N discovered: QmW6FqVV6RsyoGC5zaeFGW9gSWA3LcBRVZrjkKMruh38Bo
|
||||||
|
Peer QmYWeom2odTkm79DzB68NHULqVHDaNDqHhoyqLdcV1fqdv discovered: QmW6FqVV6RsyoGC5zaeFGW9gSWA3LcBRVZrjkKMruh38Bo
|
||||||
|
Peer QmYWeom2odTkm79DzB68NHULqVHDaNDqHhoyqLdcV1fqdv discovered: QmezqDTmEjZ5BfMgVqjSpLY19mVVLTQ9bE9mRpZwtGxL8N
|
||||||
|
Peer QmezqDTmEjZ5BfMgVqjSpLY19mVVLTQ9bE9mRpZwtGxL8N discovered: QmYWeom2odTkm79DzB68NHULqVHDaNDqHhoyqLdcV1fqdv
|
||||||
|
```
|
||||||
|
|
||||||
|
Taking into account the output, after the relay and both libp2p nodes start, both libp2p nodes will discover the bootstrap node (relay) and connect with it. After establishing a connection with the relay, they will discover each other.
|
||||||
|
|
||||||
|
This is really useful when running libp2p in constrained environments like a browser. You can run a set of `libp2p-relay-server` nodes that will be responsible for both relaying websocket connections between browser nodes and for discovering other browser peers.
|
||||||
|
|
||||||
|
## 4. Where to find other Peer Discovery Mechanisms
|
||||||
|
|
||||||
There are plenty more Peer Discovery Mechanisms out there, you can:
|
There are plenty more Peer Discovery Mechanisms out there, you can:
|
||||||
|
|
||||||
- Find one in [libp2p-webrtc-star](https://github.com/libp2p/js-libp2p-webrtc-star). Yes, a transport with discovery capabilities! This happens because WebRTC requires a rendezvous point for peers to exchange [SDP](https://tools.ietf.org/html/rfc4317) offer, which means we have one or more points that can introduce peers to each other. Think of it as MulticastDNS for the Web, as in MulticastDNS only works in LAN.
|
- Find one in [libp2p-webrtc-star](https://github.com/libp2p/js-libp2p-webrtc-star). Yes, a transport with discovery capabilities! This happens because WebRTC requires a rendezvous point for peers to exchange [SDP](https://tools.ietf.org/html/rfc4317) offer, which means we have one or more points that can introduce peers to each other. Think of it as MulticastDNS for the Web, as in MulticastDNS only works in LAN.
|
||||||
- Any DHT will offer you a discovery capability. You can simple _random-walk_ the routing tables to find other peers to connect to. For example [libp2p-kad-dht](https://github.com/libp2p/js-libp2p-kad-dht) can be used for peer discovery. An example how to configure it to enable random walks can be found [here](https://github.com/libp2p/js-libp2p/blob/v0.28.4/doc/CONFIGURATION.md#customizing-dht).
|
- Any DHT will offer you a discovery capability. You can simple _random-walk_ the routing tables to find other peers to connect to. For example [libp2p-kad-dht](https://github.com/libp2p/js-libp2p-kad-dht) can be used for peer discovery. An example of how to configure it to enable random walks can be found [here](https://github.com/libp2p/js-libp2p/blob/v0.28.4/doc/CONFIGURATION.md#customizing-dht).
|
||||||
- You can create your own Discovery service, a registry, a list, a radio beacon, you name it!
|
- You can create your own Discovery service, a registry, a list, a radio beacon, you name it!
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const path = require('path')
|
const path = require('path')
|
||||||
const execa = require('execa')
|
const execa = require('execa')
|
||||||
const pWaitFor = require('p-wait-for')
|
const pWaitFor = require('p-wait-for')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
const bootstrapers = require('./bootstrapers')
|
const bootstrapers = require('./bootstrapers')
|
||||||
|
|
||||||
const discoveredCopy = 'Discovered:'
|
const discoveredCopy = 'Discovered:'
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const path = require('path')
|
const path = require('path')
|
||||||
const execa = require('execa')
|
const execa = require('execa')
|
||||||
const pWaitFor = require('p-wait-for')
|
const pWaitFor = require('p-wait-for')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
const discoveredCopy = 'Discovered:'
|
const discoveredCopy = 'Discovered:'
|
||||||
|
|
||||||
|
35
examples/discovery-mechanisms/test-3.js
Normal file
35
examples/discovery-mechanisms/test-3.js
Normal file
@ -0,0 +1,35 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pWaitFor = require('p-wait-for')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
const discoveredCopy = 'discovered:'
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
let discoverCount = 0
|
||||||
|
|
||||||
|
process.stdout.write('3.js\n')
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '3.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
// Discovered or Connected
|
||||||
|
if (line.includes(discoveredCopy)) {
|
||||||
|
discoverCount++
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await pWaitFor(() => discoverCount === 4)
|
||||||
|
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
@ -2,10 +2,12 @@
|
|||||||
|
|
||||||
const test1 = require('./test-1')
|
const test1 = require('./test-1')
|
||||||
const test2 = require('./test-2')
|
const test2 = require('./test-2')
|
||||||
|
const test3 = require('./test-3')
|
||||||
|
|
||||||
async function test () {
|
async function test () {
|
||||||
await test1()
|
await test1()
|
||||||
await test2()
|
await test2()
|
||||||
|
await test3()
|
||||||
}
|
}
|
||||||
|
|
||||||
module.exports = test
|
module.exports = test
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const WS = require('libp2p-websockets')
|
const WS = require('libp2p-websockets')
|
||||||
const mplex = require('libp2p-mplex')
|
const mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
|
||||||
const defaultsDeep = require('@nodeutils/defaults-deep')
|
const defaultsDeep = require('@nodeutils/defaults-deep')
|
||||||
const libp2p = require('../../..')
|
const libp2p = require('../../..')
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const path = require('path')
|
const path = require('path')
|
||||||
const execa = require('execa')
|
const execa = require('execa')
|
||||||
const pDefer = require('p-defer')
|
const pDefer = require('p-defer')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
function startProcess(name) {
|
function startProcess(name) {
|
||||||
return execa('node', [path.join(__dirname, name)], {
|
return execa('node', [path.join(__dirname, name)], {
|
||||||
|
@ -4,9 +4,13 @@ This example leverages the [Parcel.js bundler](https://parceljs.org/) to compile
|
|||||||
|
|
||||||
## Setup
|
## Setup
|
||||||
|
|
||||||
In order to run the example, first install the dependencies from same directory as this README:
|
In order to run the example:
|
||||||
|
|
||||||
|
- Install dependencey at the root of the js-libp2p repository (if not already done),
|
||||||
|
- then, install the dependencies from same directory as this README:
|
||||||
|
|
||||||
```
|
```
|
||||||
|
npm install
|
||||||
cd ./examples/libp2p-in-the-browser
|
cd ./examples/libp2p-in-the-browser
|
||||||
npm install
|
npm install
|
||||||
```
|
```
|
||||||
|
@ -16,7 +16,7 @@
|
|||||||
<pre id="output"></pre>
|
<pre id="output"></pre>
|
||||||
</main>
|
</main>
|
||||||
|
|
||||||
<script src="./index.js"></script>
|
<script type="module" src="./index.js"></script>
|
||||||
|
|
||||||
</body>
|
</body>
|
||||||
|
|
||||||
|
@ -2,7 +2,7 @@ import 'babel-polyfill'
|
|||||||
import Libp2p from 'libp2p'
|
import Libp2p from 'libp2p'
|
||||||
import Websockets from 'libp2p-websockets'
|
import Websockets from 'libp2p-websockets'
|
||||||
import WebRTCStar from 'libp2p-webrtc-star'
|
import WebRTCStar from 'libp2p-webrtc-star'
|
||||||
import { NOISE } from 'libp2p-noise'
|
import { NOISE } from '@chainsafe/libp2p-noise'
|
||||||
import Mplex from 'libp2p-mplex'
|
import Mplex from 'libp2p-mplex'
|
||||||
import Bootstrap from 'libp2p-bootstrap'
|
import Bootstrap from 'libp2p-bootstrap'
|
||||||
|
|
||||||
|
@ -2,7 +2,6 @@
|
|||||||
"name": "libp2p-in-browser",
|
"name": "libp2p-in-browser",
|
||||||
"version": "1.0.0",
|
"version": "1.0.0",
|
||||||
"description": "A libp2p node running in the browser",
|
"description": "A libp2p node running in the browser",
|
||||||
"main": "index.js",
|
|
||||||
"browserslist": [
|
"browserslist": [
|
||||||
"last 2 Chrome versions"
|
"last 2 Chrome versions"
|
||||||
],
|
],
|
||||||
@ -15,20 +14,20 @@
|
|||||||
"author": "",
|
"author": "",
|
||||||
"license": "ISC",
|
"license": "ISC",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@babel/preset-env": "^7.8.3",
|
"@babel/preset-env": "^7.13.0",
|
||||||
"libp2p": "../../",
|
"libp2p": "../../",
|
||||||
"libp2p-bootstrap": "^0.12.1",
|
"libp2p-bootstrap": "^0.13.0",
|
||||||
"libp2p-mplex": "^0.10.0",
|
"libp2p-mplex": "^0.10.4",
|
||||||
"libp2p-noise": "^2.0.0",
|
"@chainsafe/libp2p-noise": "^4.1.0",
|
||||||
"libp2p-webrtc-star": "^0.20.0",
|
"libp2p-webrtc-star": "^0.23.0",
|
||||||
"libp2p-websockets": "^0.14.0"
|
"libp2p-websockets": "^0.16.1"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@babel/cli": "^7.8.3",
|
"@babel/cli": "^7.13.10",
|
||||||
"@babel/core": "^7.8.3",
|
"@babel/core": "^7.13.0",
|
||||||
"babel-plugin-syntax-async-functions": "^6.13.0",
|
"babel-plugin-syntax-async-functions": "^6.13.0",
|
||||||
"babel-plugin-transform-regenerator": "^6.26.0",
|
"babel-plugin-transform-regenerator": "^6.26.0",
|
||||||
"babel-polyfill": "^6.26.0",
|
"babel-polyfill": "^6.26.0",
|
||||||
"parcel-bundler": "^1.12.4"
|
"parcel": "^2.0.1"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -17,10 +17,10 @@ async function run() {
|
|||||||
const out = chunk.toString()
|
const out = chunk.toString()
|
||||||
|
|
||||||
if (out.includes('Server running at')) {
|
if (out.includes('Server running at')) {
|
||||||
url = out.replace('Server running at ', '')
|
url = out.split('Server running at ')[1]
|
||||||
}
|
}
|
||||||
|
|
||||||
if (out.includes('✨ Built in ')) {
|
if (out.includes('Built in')) {
|
||||||
try {
|
try {
|
||||||
const browser = await chromium.launch();
|
const browser = await chromium.launch();
|
||||||
const page = await browser.newPage();
|
const page = await browser.newPage();
|
||||||
@ -38,7 +38,7 @@ async function run() {
|
|||||||
)
|
)
|
||||||
await browser.close();
|
await browser.close();
|
||||||
|
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
console.error(err)
|
console.error(err)
|
||||||
process.exit(1)
|
process.exit(1)
|
||||||
} finally {
|
} finally {
|
||||||
|
@ -10,10 +10,16 @@
|
|||||||
"dependencies": {
|
"dependencies": {
|
||||||
"execa": "^2.1.0",
|
"execa": "^2.1.0",
|
||||||
"fs-extra": "^8.1.0",
|
"fs-extra": "^8.1.0",
|
||||||
|
"libp2p": "../src",
|
||||||
|
"libp2p-pubsub-peer-discovery": "^4.0.0",
|
||||||
|
"libp2p-relay-server": "^0.3.0",
|
||||||
|
"libp2p-gossipsub": "^0.11.0",
|
||||||
"p-defer": "^3.0.0",
|
"p-defer": "^3.0.0",
|
||||||
|
"uint8arrays": "^3.0.0",
|
||||||
"which": "^2.0.1"
|
"which": "^2.0.1"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
|
"https": "^1.0.0",
|
||||||
"playwright": "^1.7.1"
|
"playwright": "^1.7.1"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
const Libp2p = require('../../')
|
const Libp2p = require('../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const Mplex = require('libp2p-mplex')
|
const Mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const KadDHT = require('libp2p-kad-dht')
|
const KadDHT = require('libp2p-kad-dht')
|
||||||
|
|
||||||
const delay = require('delay')
|
const delay = require('delay')
|
||||||
|
@ -4,8 +4,8 @@
|
|||||||
const Libp2p = require('../../')
|
const Libp2p = require('../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const Mplex = require('libp2p-mplex')
|
const Mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const CID = require('cids')
|
const { CID } = require('multiformats/cid')
|
||||||
const KadDHT = require('libp2p-kad-dht')
|
const KadDHT = require('libp2p-kad-dht')
|
||||||
|
|
||||||
const all = require('it-all')
|
const all = require('it-all')
|
||||||
@ -51,10 +51,10 @@ const createNode = async () => {
|
|||||||
// Wait for onConnect handlers in the DHT
|
// Wait for onConnect handlers in the DHT
|
||||||
await delay(100)
|
await delay(100)
|
||||||
|
|
||||||
const cid = new CID('QmTp9VkYvnHyrqKQuFPiuZkiX9gPcqj6x5LJ1rmWuSySnL')
|
const cid = CID.parse('QmTp9VkYvnHyrqKQuFPiuZkiX9gPcqj6x5LJ1rmWuSySnL')
|
||||||
await node1.contentRouting.provide(cid)
|
await node1.contentRouting.provide(cid)
|
||||||
|
|
||||||
console.log('Node %s is providing %s', node1.peerId.toB58String(), cid.toBaseEncodedString())
|
console.log('Node %s is providing %s', node1.peerId.toB58String(), cid.toString())
|
||||||
|
|
||||||
// wait for propagation
|
// wait for propagation
|
||||||
await delay(300)
|
await delay(300)
|
||||||
|
@ -81,7 +81,7 @@ Instead of calling `peerRouting.findPeer`, we will use `contentRouting.provide`
|
|||||||
|
|
||||||
```JavaScript
|
```JavaScript
|
||||||
await node1.contentRouting.provide(cid)
|
await node1.contentRouting.provide(cid)
|
||||||
console.log('Node %s is providing %s', node1.peerId.toB58String(), cid.toBaseEncodedString())
|
console.log('Node %s is providing %s', node1.peerId.toB58String(), cid.toString())
|
||||||
|
|
||||||
const provs = await all(node3.contentRouting.findProviders(cid, { timeout: 5000 }))
|
const provs = await all(node3.contentRouting.findProviders(cid, { timeout: 5000 }))
|
||||||
|
|
||||||
|
36
examples/peer-and-content-routing/test-1.js
Normal file
36
examples/peer-and-content-routing/test-1.js
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pWaitFor = require('p-wait-for')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
process.stdout.write('1.js\n')
|
||||||
|
|
||||||
|
const addrs = []
|
||||||
|
let foundIt = false
|
||||||
|
const proc = execa('node', [path.join(__dirname, '1.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
// Discovered peer
|
||||||
|
if (!foundIt && line.includes('Found it, multiaddrs are:')) {
|
||||||
|
foundIt = true
|
||||||
|
}
|
||||||
|
|
||||||
|
addrs.push(line)
|
||||||
|
})
|
||||||
|
|
||||||
|
await pWaitFor(() => addrs.length === 2)
|
||||||
|
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
40
examples/peer-and-content-routing/test-2.js
Normal file
40
examples/peer-and-content-routing/test-2.js
Normal file
@ -0,0 +1,40 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
const providedCopy = 'is providing'
|
||||||
|
const foundCopy = 'Found provider:'
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
process.stdout.write('2.js\n')
|
||||||
|
const providedDefer = pDefer()
|
||||||
|
const foundDefer = pDefer()
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '2.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (line.includes(providedCopy)) {
|
||||||
|
providedDefer.resolve()
|
||||||
|
} else if (line.includes(foundCopy)) {
|
||||||
|
foundDefer.resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await Promise.all([
|
||||||
|
providedDefer.promise,
|
||||||
|
foundDefer.promise
|
||||||
|
])
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
11
examples/peer-and-content-routing/test.js
Normal file
11
examples/peer-and-content-routing/test.js
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const test1 = require('./test-1')
|
||||||
|
const test2 = require('./test-2')
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
await test1()
|
||||||
|
await test2()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
@ -3,7 +3,7 @@
|
|||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const Protector = require('libp2p/src/pnet')
|
const Protector = require('libp2p/src/pnet')
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const path = require('path')
|
const path = require('path')
|
||||||
const execa = require('execa')
|
const execa = require('execa')
|
||||||
const pDefer = require('p-defer')
|
const pDefer = require('p-defer')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
async function test () {
|
async function test () {
|
||||||
const messageReceived = pDefer()
|
const messageReceived = pDefer()
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const Libp2p = require('../../')
|
const Libp2p = require('../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
|
||||||
const pipe = require('it-pipe')
|
const pipe = require('it-pipe')
|
||||||
|
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
const Libp2p = require('../../')
|
const Libp2p = require('../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
|
||||||
const pipe = require('it-pipe')
|
const pipe = require('it-pipe')
|
||||||
|
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
const Libp2p = require('../../')
|
const Libp2p = require('../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
|
||||||
const pipe = require('it-pipe')
|
const pipe = require('it-pipe')
|
||||||
|
|
||||||
|
31
examples/protocol-and-stream-muxing/test-1.js
Normal file
31
examples/protocol-and-stream-muxing/test-1.js
Normal file
@ -0,0 +1,31 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
const messageDefer = pDefer()
|
||||||
|
process.stdout.write('1.js\n')
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '1.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (line.includes('my own protocol, wow!')) {
|
||||||
|
messageDefer.resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await messageDefer.promise
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
38
examples/protocol-and-stream-muxing/test-2.js
Normal file
38
examples/protocol-and-stream-muxing/test-2.js
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pWaitFor = require('p-wait-for')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
const messages = [
|
||||||
|
'protocol (a)',
|
||||||
|
'protocol (b)',
|
||||||
|
'another stream on protocol (b)'
|
||||||
|
]
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
process.stdout.write('2.js\n')
|
||||||
|
|
||||||
|
let count = 0
|
||||||
|
const proc = execa('node', [path.join(__dirname, '2.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (messages.find((m) => line.includes(m))) {
|
||||||
|
count += 1
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await pWaitFor(() => count === messages.length)
|
||||||
|
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
37
examples/protocol-and-stream-muxing/test-3.js
Normal file
37
examples/protocol-and-stream-muxing/test-3.js
Normal file
@ -0,0 +1,37 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pWaitFor = require('p-wait-for')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
const messages = [
|
||||||
|
'from 1 to 2',
|
||||||
|
'from 2 to 1'
|
||||||
|
]
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
process.stdout.write('3.js\n')
|
||||||
|
|
||||||
|
let count = 0
|
||||||
|
const proc = execa('node', [path.join(__dirname, '3.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (messages.find((m) => line.includes(m))) {
|
||||||
|
count += 1
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await pWaitFor(() => count === messages.length)
|
||||||
|
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
13
examples/protocol-and-stream-muxing/test.js
Normal file
13
examples/protocol-and-stream-muxing/test.js
Normal file
@ -0,0 +1,13 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const test1 = require('./test-1')
|
||||||
|
const test2 = require('./test-2')
|
||||||
|
const test3 = require('./test-3')
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
await test1()
|
||||||
|
await test2()
|
||||||
|
await test3()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
@ -4,10 +4,10 @@
|
|||||||
const Libp2p = require('../../')
|
const Libp2p = require('../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const Mplex = require('libp2p-mplex')
|
const Mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const Gossipsub = require('libp2p-gossipsub')
|
const Gossipsub = require('libp2p-gossipsub')
|
||||||
const uint8ArrayFromString = require('uint8arrays/from-string')
|
const { fromString: uint8ArrayFromString } = require('uint8arrays/from-string')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
const createNode = async () => {
|
const createNode = async () => {
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
|
@ -8,6 +8,10 @@ We've seen many interesting use cases appear with this, here are some highlights
|
|||||||
- [IPFS PubSub (using libp2p-floodsub) for IoT](https://www.youtube.com/watch?v=qLpM5pBDGiE).
|
- [IPFS PubSub (using libp2p-floodsub) for IoT](https://www.youtube.com/watch?v=qLpM5pBDGiE).
|
||||||
- [Real Time distributed Applications](https://www.youtube.com/watch?v=vQrbxyDPSXg)
|
- [Real Time distributed Applications](https://www.youtube.com/watch?v=vQrbxyDPSXg)
|
||||||
|
|
||||||
|
## 0. Set up the example
|
||||||
|
|
||||||
|
Before moving into the examples, you should run `npm install` on the top level `js-libp2p` folder, in order to install all the dependencies needed for this example. In addition, you will need to install the example related dependencies by doing `cd examples && npm install`. Once the install finishes, you should move into the example folder with `cd pubsub`.
|
||||||
|
|
||||||
## 1. Setting up a simple PubSub network on top of libp2p
|
## 1. Setting up a simple PubSub network on top of libp2p
|
||||||
|
|
||||||
For this example, we will use MulticastDNS for automatic Peer Discovery. This example is based the previous examples found in [Discovery Mechanisms](../discovery-mechanisms). You can find the complete version at [1.js](./1.js).
|
For this example, we will use MulticastDNS for automatic Peer Discovery. This example is based the previous examples found in [Discovery Mechanisms](../discovery-mechanisms). You can find the complete version at [1.js](./1.js).
|
||||||
|
@ -4,10 +4,10 @@
|
|||||||
const Libp2p = require('../../../')
|
const Libp2p = require('../../../')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const Mplex = require('libp2p-mplex')
|
const Mplex = require('libp2p-mplex')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const Gossipsub = require('libp2p-gossipsub')
|
const Gossipsub = require('libp2p-gossipsub')
|
||||||
const uint8ArrayFromString = require('uint8arrays/from-string')
|
const { fromString: uint8ArrayFromString } = require('uint8arrays/from-string')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
const createNode = async () => {
|
const createNode = async () => {
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
|
67
examples/pubsub/message-filtering/test.js
Normal file
67
examples/pubsub/message-filtering/test.js
Normal file
@ -0,0 +1,67 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
const stdout = [
|
||||||
|
{
|
||||||
|
topic: 'banana',
|
||||||
|
messageCount: 2
|
||||||
|
},
|
||||||
|
{
|
||||||
|
topic: 'apple',
|
||||||
|
messageCount: 2
|
||||||
|
},
|
||||||
|
{
|
||||||
|
topic: 'car',
|
||||||
|
messageCount: 0
|
||||||
|
},
|
||||||
|
{
|
||||||
|
topic: 'orange',
|
||||||
|
messageCount: 2
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
async function test () {
|
||||||
|
const defer = pDefer()
|
||||||
|
let topicCount = 0
|
||||||
|
let topicMessageCount = 0
|
||||||
|
|
||||||
|
process.stdout.write('message-filtering/1.js\n')
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '1.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
// End
|
||||||
|
if (topicCount === stdout.length) {
|
||||||
|
defer.resolve()
|
||||||
|
proc.all.removeAllListeners('data')
|
||||||
|
}
|
||||||
|
|
||||||
|
process.stdout.write(data)
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (stdout[topicCount] && line.includes(stdout[topicCount].topic)) {
|
||||||
|
// Validate previous number of messages
|
||||||
|
if (topicCount > 0 && topicMessageCount > stdout[topicCount - 1].messageCount) {
|
||||||
|
defer.reject()
|
||||||
|
throw new Error(`topic ${stdout[topicCount - 1].topic} had ${topicMessageCount} messages instead of ${stdout[topicCount - 1].messageCount}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
topicCount++
|
||||||
|
topicMessageCount = 0
|
||||||
|
} else {
|
||||||
|
topicMessageCount++
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await defer.promise
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
30
examples/pubsub/test-1.js
Normal file
30
examples/pubsub/test-1.js
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
async function test () {
|
||||||
|
const defer = pDefer()
|
||||||
|
process.stdout.write('1.js\n')
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '1.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (line.includes('node1 received: Bird bird bird, bird is the word!')) {
|
||||||
|
defer.resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await defer.promise
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
11
examples/pubsub/test.js
Normal file
11
examples/pubsub/test.js
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const test1 = require('./test-1')
|
||||||
|
const testMessageFiltering = require('./message-filtering/test')
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
await test1()
|
||||||
|
await testMessageFiltering()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
@ -3,7 +3,7 @@
|
|||||||
|
|
||||||
const Libp2p = require('../..')
|
const Libp2p = require('../..')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
|
||||||
const createNode = async () => {
|
const createNode = async () => {
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
|
|
||||||
const Libp2p = require('../..')
|
const Libp2p = require('../..')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
const pipe = require('it-pipe')
|
const pipe = require('it-pipe')
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
const Libp2p = require('../..')
|
const Libp2p = require('../..')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const WebSockets = require('libp2p-websockets')
|
const WebSockets = require('libp2p-websockets')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
const pipe = require('it-pipe')
|
const pipe = require('it-pipe')
|
||||||
@ -81,7 +81,7 @@ function print ({ stream }) {
|
|||||||
// node 3 (listening WebSockets) can dial node 1 (TCP)
|
// node 3 (listening WebSockets) can dial node 1 (TCP)
|
||||||
try {
|
try {
|
||||||
await node3.dialProtocol(node1.peerId, '/print')
|
await node3.dialProtocol(node1.peerId, '/print')
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
console.log('node 3 failed to dial to node 1 with:', err.message)
|
console.log('node 3 failed to dial to node 1 with:', err.message)
|
||||||
}
|
}
|
||||||
})();
|
})();
|
||||||
|
89
examples/transports/4.js
Normal file
89
examples/transports/4.js
Normal file
@ -0,0 +1,89 @@
|
|||||||
|
/* eslint-disable no-console */
|
||||||
|
'use strict'
|
||||||
|
|
||||||
|
const Libp2p = require('../..')
|
||||||
|
const TCP = require('libp2p-tcp')
|
||||||
|
const WebSockets = require('libp2p-websockets')
|
||||||
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
const MPLEX = require('libp2p-mplex')
|
||||||
|
|
||||||
|
const fs = require('fs');
|
||||||
|
const https = require('https');
|
||||||
|
const pipe = require('it-pipe')
|
||||||
|
|
||||||
|
const transportKey = WebSockets.prototype[Symbol.toStringTag];
|
||||||
|
|
||||||
|
const httpServer = https.createServer({
|
||||||
|
cert: fs.readFileSync('./test_certs/cert.pem'),
|
||||||
|
key: fs.readFileSync('./test_certs/key.pem'),
|
||||||
|
});
|
||||||
|
|
||||||
|
const createNode = async (addresses = []) => {
|
||||||
|
if (!Array.isArray(addresses)) {
|
||||||
|
addresses = [addresses]
|
||||||
|
}
|
||||||
|
|
||||||
|
const node = await Libp2p.create({
|
||||||
|
addresses: {
|
||||||
|
listen: addresses
|
||||||
|
},
|
||||||
|
modules: {
|
||||||
|
transport: [WebSockets],
|
||||||
|
connEncryption: [NOISE],
|
||||||
|
streamMuxer: [MPLEX]
|
||||||
|
},
|
||||||
|
config: {
|
||||||
|
peerDiscovery: {
|
||||||
|
// Disable autoDial as it would fail because we are using a self-signed cert.
|
||||||
|
// `dialProtocol` does not fail because we pass `rejectUnauthorized: false`.
|
||||||
|
autoDial: false
|
||||||
|
},
|
||||||
|
transport: {
|
||||||
|
[transportKey]: {
|
||||||
|
listenerOptions: { server: httpServer },
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await node.start()
|
||||||
|
return node
|
||||||
|
}
|
||||||
|
|
||||||
|
function printAddrs(node, number) {
|
||||||
|
console.log('node %s is listening on:', number)
|
||||||
|
node.multiaddrs.forEach((ma) => console.log(`${ma.toString()}/p2p/${node.peerId.toB58String()}`))
|
||||||
|
}
|
||||||
|
|
||||||
|
function print ({ stream }) {
|
||||||
|
pipe(
|
||||||
|
stream,
|
||||||
|
async function (source) {
|
||||||
|
for await (const msg of source) {
|
||||||
|
console.log(msg.toString())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
;(async () => {
|
||||||
|
const [node1, node2] = await Promise.all([
|
||||||
|
createNode('/ip4/127.0.0.1/tcp/10000/wss'),
|
||||||
|
createNode([])
|
||||||
|
])
|
||||||
|
|
||||||
|
printAddrs(node1, '1')
|
||||||
|
printAddrs(node2, '2')
|
||||||
|
|
||||||
|
node1.handle('/print', print)
|
||||||
|
node2.handle('/print', print)
|
||||||
|
|
||||||
|
const targetAddr = `${node1.multiaddrs[0]}/p2p/${node1.peerId.toB58String()}`;
|
||||||
|
|
||||||
|
// node 2 (Secure WebSockets) dials to node 1 (Secure Websockets)
|
||||||
|
const { stream } = await node2.dialProtocol(targetAddr, '/print', { websocket: { rejectUnauthorized: false } })
|
||||||
|
await pipe(
|
||||||
|
['node 2 dialed to node 1 successfully'],
|
||||||
|
stream
|
||||||
|
)
|
||||||
|
})();
|
@ -13,7 +13,7 @@ When using libp2p, you need properly configure it, that is, pick your set of mod
|
|||||||
You will need 4 dependencies total, so go ahead and install all of them with:
|
You will need 4 dependencies total, so go ahead and install all of them with:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
> npm install libp2p libp2p-tcp libp2p-noise
|
> npm install libp2p libp2p-tcp @chainsafe/libp2p-noise
|
||||||
```
|
```
|
||||||
|
|
||||||
Then, in your favorite text editor create a file with the `.js` extension. I've called mine `1.js`.
|
Then, in your favorite text editor create a file with the `.js` extension. I've called mine `1.js`.
|
||||||
@ -25,7 +25,7 @@ First thing is to create our own libp2p node! Insert:
|
|||||||
|
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const { NOISE } = require('libp2p-noise')
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
|
||||||
const createNode = async () => {
|
const createNode = async () => {
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
@ -91,7 +91,7 @@ const concat = require('it-concat')
|
|||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
```
|
```
|
||||||
|
|
||||||
We are going to reuse the `createNode` function from step 1, but this time add a stream multiplexer from `libp2p-mplex`.
|
We are going to reuse the `createNode` function from step 1, but this time add a stream multiplexer from `libp2p-mplex`.
|
||||||
```js
|
```js
|
||||||
const createNode = async () => {
|
const createNode = async () => {
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
|
38
examples/transports/test-1.js
Normal file
38
examples/transports/test-1.js
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
async function test () {
|
||||||
|
const deferStarted = pDefer()
|
||||||
|
const deferListen = pDefer()
|
||||||
|
|
||||||
|
process.stdout.write('1.js\n')
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '1.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
|
||||||
|
if (line.includes('node has started (true/false): true')) {
|
||||||
|
deferStarted.resolve()
|
||||||
|
} else if (line.includes('p2p')) {
|
||||||
|
deferListen.resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await Promise.all([
|
||||||
|
deferStarted.promise,
|
||||||
|
deferListen.promise
|
||||||
|
])
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
30
examples/transports/test-2.js
Normal file
30
examples/transports/test-2.js
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
async function test () {
|
||||||
|
const defer = pDefer()
|
||||||
|
process.stdout.write('2.js\n')
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '2.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (line.includes('Hello p2p world!')) {
|
||||||
|
defer.resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await defer.promise
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
41
examples/transports/test-3.js
Normal file
41
examples/transports/test-3.js
Normal file
@ -0,0 +1,41 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
async function test () {
|
||||||
|
const deferNode1 = pDefer()
|
||||||
|
const deferNode2 = pDefer()
|
||||||
|
const deferNode3 = pDefer()
|
||||||
|
|
||||||
|
process.stdout.write('3.js\n')
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '3.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (line.includes('node 1 dialed to node 2 successfully')) {
|
||||||
|
deferNode1.resolve()
|
||||||
|
} else if (line.includes('node 2 dialed to node 3 successfully')) {
|
||||||
|
deferNode2.resolve()
|
||||||
|
} else if (line.includes('node 3 failed to dial to node 1 with:')) {
|
||||||
|
deferNode3.resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await Promise.all([
|
||||||
|
deferNode1.promise,
|
||||||
|
deferNode2.promise,
|
||||||
|
deferNode3.promise
|
||||||
|
])
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
33
examples/transports/test-4.js
Normal file
33
examples/transports/test-4.js
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
|
||||||
|
async function test () {
|
||||||
|
const deferNode1 = pDefer()
|
||||||
|
|
||||||
|
process.stdout.write('4.js\n')
|
||||||
|
|
||||||
|
const proc = execa('node', [path.join(__dirname, '4.js')], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
|
||||||
|
proc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
const line = uint8ArrayToString(data)
|
||||||
|
|
||||||
|
if (line.includes('node 2 dialed to node 1 successfully')) {
|
||||||
|
deferNode1.resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await Promise.all([
|
||||||
|
deferNode1.promise,
|
||||||
|
])
|
||||||
|
proc.kill()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
15
examples/transports/test.js
Normal file
15
examples/transports/test.js
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const test1 = require('./test-1')
|
||||||
|
const test2 = require('./test-2')
|
||||||
|
const test3 = require('./test-3')
|
||||||
|
const test4 = require('./test-4')
|
||||||
|
|
||||||
|
async function test() {
|
||||||
|
await test1()
|
||||||
|
await test2()
|
||||||
|
await test3()
|
||||||
|
await test4()
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
32
examples/transports/test_certs/cert.pem
Normal file
32
examples/transports/test_certs/cert.pem
Normal file
@ -0,0 +1,32 @@
|
|||||||
|
-----BEGIN CERTIFICATE-----
|
||||||
|
MIIFlzCCA3+gAwIBAgIUMYedwb9L/BtvZ7Lhu71iSKrXsa4wDQYJKoZIhvcNAQEL
|
||||||
|
BQAwajELMAkGA1UEBhMCVVMxCzAJBgNVBAgMAlZBMREwDwYDVQQHDAhTb21lQ2l0
|
||||||
|
eTESMBAGA1UECgwJTXlDb21wYW55MRMwEQYDVQQLDApNeURpdmlzaW9uMRIwEAYD
|
||||||
|
VQQDDAkxMjcuMC4wLjEwHhcNMjEwNDI4MDIzMjA5WhcNMjIwNDI4MDIzMjA5WjBq
|
||||||
|
MQswCQYDVQQGEwJVUzELMAkGA1UECAwCVkExETAPBgNVBAcMCFNvbWVDaXR5MRIw
|
||||||
|
EAYDVQQKDAlNeUNvbXBhbnkxEzARBgNVBAsMCk15RGl2aXNpb24xEjAQBgNVBAMM
|
||||||
|
CTEyNy4wLjAuMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANNhXBu0
|
||||||
|
GH1Kzl9iaQxCxEnyyAShS5FYScdKxqpYsgJT4poLWLQBZQEFLEqbdillIlTZqMss
|
||||||
|
jWqkFL2xmjqdcnOKFEZUarntVE2hxFYYQex2Fi8MYwFj+Pvt74d02xPyfzFNFgyX
|
||||||
|
a1EakoGBwClaf3I7jW7raPudjcf4HnwQ7r/NwiO8FqHFZgLcTnwI8bk+cxDoDAqu
|
||||||
|
mhqMB5nnerqvKEyR9Fb2PoL+8PwOPJOOKTDVwLMeMJu2WLR8AU2FzOj5SVI2qsu9
|
||||||
|
Ps5azysD8KQAMcw4y9s6do36SaMQS85fbvXBV7XBqMD34HPBUbFiCoFoaCzK9Zfb
|
||||||
|
pCXyVJMUNmw5hyq9nbjUt4Kvr/58bU2gjUKSdPf6KhBxFnDZwl+2qqPdVIb/qtwz
|
||||||
|
HExtJWq3upklXNOg3HoR6vcr1O9ReJHrzLRMEb51WP1aN/qJ2/lRskcZ4A806qwr
|
||||||
|
W67BvnOg6s3ZtxHN9v3bsyfsvC66w8PEfCnCVxugC7cUW0gtW54AU75T3ukg7X+m
|
||||||
|
vECr/+qIzNEBIxxCPgefCG/JAdJhQ5SCvoARAVPStUIWDmigDeOt7go5nKbdVIJ4
|
||||||
|
7bbBFUhHT2mTHu30fHhRqSDcHzwE7Zz6YJIJmKq29UmzUazFnKlLU67MjLJwiDPm
|
||||||
|
fC3GyOdAWkkZE5hjtkiy+3yWoEHhaJYRI1u3AgMBAAGjNTAzMAsGA1UdDwQEAwIE
|
||||||
|
MDATBgNVHSUEDDAKBggrBgEFBQcDATAPBgNVHREECDAGhwR/AAABMA0GCSqGSIb3
|
||||||
|
DQEBCwUAA4ICAQCx/ynu4iCQAK8VId/QQe7GqgOpFgx+6Mce9GQC6ZVEjAPgapsS
|
||||||
|
Pl+l6+11cFjHKv0+Z/iN2JgkFmNXfwJcfYI0tHbMK+0U9hgKb1eFgiIwCqb4cPOz
|
||||||
|
wMwusZ95BjIbtcEbL/+pMUpNhmjPz1fOILJZtDVq++lqJCv7t8+SoAmMVYtlcLNg
|
||||||
|
muuV/UYR3uqvnAJmjgJVWs4otDGrxCYJE48M+9L2Gm05Htpi9WL1bZaQ+fJ85m85
|
||||||
|
daedLc6R1/ZRTIH6i73sD4rYs0bx1fCJvkbcgXtKMHEkiHuG/MzR7Pa4cJAVKCx9
|
||||||
|
lRTgrO7Gkllt2+jp4qg0YhdNq89e0DNA5cyB9H4udRgHQOcrlVRiX9OD/Kz+F5m/
|
||||||
|
fQwMdbnqdg3ar5DSa8Q5g3bdLbNSCcI9sjCLTkNxUC/XTWGdG03RCVIt1qvBvZHk
|
||||||
|
JaG6xGpbRZ5CN0T9eindd38JBrkPAPfgl6qhwvcqh6uVFYua+7KmF9K+mKarlmMw
|
||||||
|
6RWaw2j4sMgUyRIS6fR9vDc20SrtoNvKQM1U6+0VYs1nizfkmsqqqRODmERKbKwc
|
||||||
|
ahKJFubXfr8gz+PipAKFZbxr2EPAyoiNkx+0eM6Eedo55oP2BoGHEfXEoAonyMFM
|
||||||
|
F/xTbpFtdRYE2hwsZCk86fpbcPTmdCY8txeZ7+4Bme2d9XXsTAxF64usqQ==
|
||||||
|
-----END CERTIFICATE-----
|
52
examples/transports/test_certs/key.pem
Normal file
52
examples/transports/test_certs/key.pem
Normal file
@ -0,0 +1,52 @@
|
|||||||
|
-----BEGIN PRIVATE KEY-----
|
||||||
|
MIIJRAIBADANBgkqhkiG9w0BAQEFAASCCS4wggkqAgEAAoICAQDTYVwbtBh9Ss5f
|
||||||
|
YmkMQsRJ8sgEoUuRWEnHSsaqWLICU+KaC1i0AWUBBSxKm3YpZSJU2ajLLI1qpBS9
|
||||||
|
sZo6nXJzihRGVGq57VRNocRWGEHsdhYvDGMBY/j77e+HdNsT8n8xTRYMl2tRGpKB
|
||||||
|
gcApWn9yO41u62j7nY3H+B58EO6/zcIjvBahxWYC3E58CPG5PnMQ6AwKrpoajAeZ
|
||||||
|
53q6ryhMkfRW9j6C/vD8DjyTjikw1cCzHjCbtli0fAFNhczo+UlSNqrLvT7OWs8r
|
||||||
|
A/CkADHMOMvbOnaN+kmjEEvOX271wVe1wajA9+BzwVGxYgqBaGgsyvWX26Ql8lST
|
||||||
|
FDZsOYcqvZ241LeCr6/+fG1NoI1CknT3+ioQcRZw2cJftqqj3VSG/6rcMxxMbSVq
|
||||||
|
t7qZJVzToNx6Eer3K9TvUXiR68y0TBG+dVj9Wjf6idv5UbJHGeAPNOqsK1uuwb5z
|
||||||
|
oOrN2bcRzfb927Mn7LwuusPDxHwpwlcboAu3FFtILVueAFO+U97pIO1/prxAq//q
|
||||||
|
iMzRASMcQj4HnwhvyQHSYUOUgr6AEQFT0rVCFg5ooA3jre4KOZym3VSCeO22wRVI
|
||||||
|
R09pkx7t9Hx4Uakg3B88BO2c+mCSCZiqtvVJs1GsxZypS1OuzIyycIgz5nwtxsjn
|
||||||
|
QFpJGROYY7ZIsvt8lqBB4WiWESNbtwIDAQABAoICAQCpGV3iG7Trpohp7gQzdsYo
|
||||||
|
kjxI1+/oGkULVVqQs9vT2N+SdDlF50eyBT1lgfCJNQq97lIGF2IaSaD+D7Jd6c7B
|
||||||
|
d1i42pd2ndGvORYj+cvjKqSchsA9QIjSoYnZRzZrQrdV7WESOZ/0hdlmGTJs4qTJ
|
||||||
|
8bI3ZcPaZjQiIO/iOHmGn0gL5lAEojH1X+C5gT4+/yJ2B+x6LyvAyPzbtj6MUctf
|
||||||
|
VfOuDdf8W47VVV5IfJWfJ6C8qg4gw0M7P2ibZ8qBJcvuJSWFT6OK2UKaGtDLogw0
|
||||||
|
X8tVWfO1qOB3vnWmZtoRZ9aO5JnnpWS9tY1w5gmZdLjB/Kt0DJXIdZALCURwV6U0
|
||||||
|
q5XR0SETEgdRrNX92PA2lmxO9fAgXRSjP/OoeDjAVhnRfYyShDbEIb8GHk7nE+is
|
||||||
|
6ak5ufxKE53S8wB9L7MTPqTvxusBHi8saLevdnPBMQPvtEVkg2Iw/iPBsegUuUjD
|
||||||
|
uzXlq4WUMCUBJEMVPuYEsaQizxpp2oM6AZj/ecuTKFX5CirFFWKOQ4cp+O8lrfI5
|
||||||
|
ruwHrMkfjowDYcQaOLHq13anvt8+8LBlngVw+jiAGB/bGwrAwEZWUc8i1HbH/G8e
|
||||||
|
sm0kMuCqV1GbRyMCUO3pWjzrsz8LEy74Jr0z7KZn52vLWrTkiD4NRXahxTBhHpXb
|
||||||
|
AVclJ+a4BKk2rRJVRFRRQQKCAQEA7+uTl2ZHp1v7A8/I2zPIxoVz0fiwxwAjuv34
|
||||||
|
cV+uxG0n5Tko4PKMxavddRFKNeGvrz0aO/GNX8NIW7pDqZ2CwHyskgUX/bFAqGKF
|
||||||
|
Z/z2DmiZ2rdSUH89O3ysq+OF3RjX/FBNJ0SVdwtrpz3kCSWpa4PnmN7+IevL6zxY
|
||||||
|
8gLrs07Ge+ci94FZaDHBNrkGQ00krbOmwIvnc90hyRPCKfMS+u2/ejKZ5QDyRG+H
|
||||||
|
jbQ008ZV2OqUdS6h1twfoJ1Q4QhHijB6PegRLGdZGuUXIQfFP8dIUsQluKSUFyOy
|
||||||
|
bL9W2yBwtbn3EwYDHLJQnLICxfcTBWg/2vOIucsSjxG7KNY0yQKCAQEA4YwcVpi3
|
||||||
|
D+8OcnbpRBRlHo84DRZorp0RO8vhxevvB1CcBnkLRIYXlS2JIfrnhZAI/5jBk1ei
|
||||||
|
FmgRFyAjZ8gDdkDCiDMQMDUwUhLGSVurI9sk16B4TQKCM+iE0LDrXIy9ezJRJkj0
|
||||||
|
rOt8sqo2/TOttm2KEXY8Cco59tU4bMZg5Tr9l7SMTTj4skTO6Jn6/6hX3XuFkJw7
|
||||||
|
B0DsSzIqXyRHAzOidagIEoIr7k4cEGXsrSWoSiHg/eky1ihCyUw3vDDOmoViBR7s
|
||||||
|
h5nLjQNNAzOtyoKLqST7B7uXkdUo5nV2IUHSGD5LNxlTaNp0XL9Ph3EBtcuwNuB6
|
||||||
|
zyKXc+O5iNfMfwKCAQEA5/RJKCnRgsORxpif5xWEujIRzOHz/yFqagHarbnFHNEv
|
||||||
|
rhT6Kak2YnIL1H/X0IoWsYSQlX2uofQKQ+ysOBM5c2HV8gKMtFAnY+SEeAn/1eRZ
|
||||||
|
QzTTl1G84INj6Xc6V40KXD1CqoFLQ+G9vd4/Vnyb9H99bLXC2wa+ivo4QBqEyEGT
|
||||||
|
8fyAOOxMhUj9NSvjGzQ9DtbOk/9u0PztChtZL/d61TEAW2MKmHW2xGVTl7OvE0QA
|
||||||
|
gYwh5b0k6La+uSj/JeE8USUXOjzgRZ7RbggouV1q3YOMr8BFe+NZ7Zksiqjej1Io
|
||||||
|
xfk6H6FDZv4ao7QSrFR4hlTIz6V9/aqQkdOhsBSQyQKCAQEAzHwz4Qr5xVduGLbY
|
||||||
|
S6HV/7vHDI6Jf+3lBvqUidWa013w5yls3sZXsSckkgshRoVMszayIbystnXJMNcx
|
||||||
|
YlEDWn3iIItzHNHMKkzdOvsCETMIlvnkt6UTmK4xY+dSq4jp7Ty0N+qi8fdaCb2q
|
||||||
|
tyrYTnHHYId6bUHMBY5QZsYAaTNvYNAO96A0UaNyl42q84iTiLkJYg9SsQPad15W
|
||||||
|
7gU84Jk6rEMYdndQDvEAHpnZ1y0yA2vtySZYsbK0wj34tgTl+0/8izn7JgF4ezNH
|
||||||
|
6iQ7Z0OuDT763IrmIxBH0ZEi9YnwSYyIsr6iUYjlQIUuPFRnQYQXEdm5Xfw1pZsL
|
||||||
|
xhYoTwKCAQB9edDe4LX+0z9i4qr0iHV8H/WoyI5UD/Pc217PKkYM3+ewR9SL9D9z
|
||||||
|
TS78Sl7HgRgEmIu+MR/u5B2ePf7jkvB/oxyPwqAzJeJ72mV3Mevm27G/Ndd8lt5W
|
||||||
|
FBCGOx7ZeP4/Cv4mvPD979ix2IalDoWMSWJnpQPN+B1jGeCrUYAXQc1k/vU99gLa
|
||||||
|
8Tuu3WfBpVAsO7hAC9mu6tuLyfKVqiMOVs2aky9xLqiqW/6uIcGu+owrr+gkDDY/
|
||||||
|
JfBSUfxYKcjtJiHOEbFGrrRe93XsngmaTz/Hv9A/QLVCuJgWEHlt4WHSc+BtAtaV
|
||||||
|
9avp6VlyVNfe4KEKW7IekrI0cmfMdXkl
|
||||||
|
-----END PRIVATE KEY-----
|
@ -9,7 +9,7 @@ async function isExecutable (command) {
|
|||||||
await fs.access(command, fs.constants.X_OK)
|
await fs.access(command, fs.constants.X_OK)
|
||||||
|
|
||||||
return true
|
return true
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
if (err.code === 'ENOENT') {
|
if (err.code === 'ENOENT') {
|
||||||
return isExecutable(await which(command))
|
return isExecutable(await which(command))
|
||||||
}
|
}
|
||||||
@ -49,7 +49,7 @@ async function waitForOutput (expectedOutput, command, args = [], opts = {}) {
|
|||||||
|
|
||||||
try {
|
try {
|
||||||
await proc
|
await proc
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
if (!err.killed) {
|
if (!err.killed) {
|
||||||
throw err
|
throw err
|
||||||
}
|
}
|
||||||
|
33
examples/webrtc-direct/README.md
Normal file
33
examples/webrtc-direct/README.md
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
### Webrtc-direct example
|
||||||
|
|
||||||
|
An example that uses [js-libp2p-webrtc-direct](https://github.com/libp2p/js-libp2p-webrtc-direct) for connecting
|
||||||
|
nodejs libp2p and browser libp2p clients. To run the example:
|
||||||
|
|
||||||
|
## 0. Run a nodejs libp2p listener
|
||||||
|
|
||||||
|
When in the root folder of this example, type `node listener.js` in terminal. You should see an address that listens for
|
||||||
|
incoming connections. Below is just an example of such address. In your case the suffix hash (`peerId`) will be different.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ node listener.js
|
||||||
|
Listening on:
|
||||||
|
/ip4/127.0.0.1/tcp/9090/http/p2p-webrtc-direct/p2p/QmUKQCzEUhhhobcNSrXU5uzxTqbvF1BjMCGNGZzZU14Kgd
|
||||||
|
```
|
||||||
|
|
||||||
|
## 1. Prepare a browser libp2p dialer
|
||||||
|
Confirm that the above address is the same as the field `list` in `public/dialer.js`:
|
||||||
|
```js
|
||||||
|
peerDiscovery: {
|
||||||
|
[Bootstrap.tag]: {
|
||||||
|
enabled: true,
|
||||||
|
// paste the address into `list`
|
||||||
|
list: ['/ip4/127.0.0.1/tcp/9090/http/p2p-webrtc-direct/p2p/QmUKQCzEUhhhobcNSrXU5uzxTqbvF1BjMCGNGZzZU14Kgd']
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 2. Run a browser libp2p dialer
|
||||||
|
When in the root folder of this example, type `npm run dev` in terminal. You should see an address where you can browse
|
||||||
|
the running client. Open this address in your browser. In console
|
||||||
|
logs you should see logs about successful connection with the node client. In the output of node client you should see
|
||||||
|
a log message about successful connection as well.
|
57
examples/webrtc-direct/dialer.js
Normal file
57
examples/webrtc-direct/dialer.js
Normal file
@ -0,0 +1,57 @@
|
|||||||
|
import 'babel-polyfill'
|
||||||
|
const Libp2p = require('libp2p')
|
||||||
|
const WebRTCDirect = require('libp2p-webrtc-direct')
|
||||||
|
const Mplex = require('libp2p-mplex')
|
||||||
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
const Bootstrap = require('libp2p-bootstrap')
|
||||||
|
|
||||||
|
document.addEventListener('DOMContentLoaded', async () => {
|
||||||
|
// use the same peer id as in `listener.js` to avoid copy-pasting of listener's peer id into `peerDiscovery`
|
||||||
|
const hardcodedPeerId = '12D3KooWCuo3MdXfMgaqpLC5Houi1TRoFqgK9aoxok4NK5udMu8m'
|
||||||
|
const libp2p = await Libp2p.create({
|
||||||
|
modules: {
|
||||||
|
transport: [WebRTCDirect],
|
||||||
|
streamMuxer: [Mplex],
|
||||||
|
connEncryption: [NOISE],
|
||||||
|
peerDiscovery: [Bootstrap]
|
||||||
|
},
|
||||||
|
config: {
|
||||||
|
peerDiscovery: {
|
||||||
|
[Bootstrap.tag]: {
|
||||||
|
enabled: true,
|
||||||
|
list: [`/ip4/127.0.0.1/tcp/9090/http/p2p-webrtc-direct/p2p/${hardcodedPeerId}`]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
const status = document.getElementById('status')
|
||||||
|
const output = document.getElementById('output')
|
||||||
|
|
||||||
|
output.textContent = ''
|
||||||
|
|
||||||
|
function log (txt) {
|
||||||
|
console.info(txt)
|
||||||
|
output.textContent += `${txt.trim()}\n`
|
||||||
|
}
|
||||||
|
|
||||||
|
// Listen for new peers
|
||||||
|
libp2p.on('peer:discovery', (peerId) => {
|
||||||
|
log(`Found peer ${peerId.toB58String()}`)
|
||||||
|
})
|
||||||
|
|
||||||
|
// Listen for new connections to peers
|
||||||
|
libp2p.connectionManager.on('peer:connect', (connection) => {
|
||||||
|
log(`Connected to ${connection.remotePeer.toB58String()}`)
|
||||||
|
})
|
||||||
|
|
||||||
|
// Listen for peers disconnecting
|
||||||
|
libp2p.connectionManager.on('peer:disconnect', (connection) => {
|
||||||
|
log(`Disconnected from ${connection.remotePeer.toB58String()}`)
|
||||||
|
})
|
||||||
|
|
||||||
|
await libp2p.start()
|
||||||
|
status.innerText = 'libp2p started!'
|
||||||
|
log(`libp2p id is ${libp2p.peerId.toB58String()}`)
|
||||||
|
|
||||||
|
})
|
17
examples/webrtc-direct/index.html
Normal file
17
examples/webrtc-direct/index.html
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<title>js-libp2p parcel.js browser example</title>
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<header>
|
||||||
|
<h1 id="status">Starting libp2p...</h1>
|
||||||
|
</header>
|
||||||
|
<main>
|
||||||
|
<pre id="output"></pre>
|
||||||
|
</main>
|
||||||
|
<script src="./dialer.js" type="module"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
44
examples/webrtc-direct/listener.js
Normal file
44
examples/webrtc-direct/listener.js
Normal file
@ -0,0 +1,44 @@
|
|||||||
|
const Libp2p = require('libp2p')
|
||||||
|
const Bootstrap = require('libp2p-bootstrap')
|
||||||
|
const WebRTCDirect = require('libp2p-webrtc-direct')
|
||||||
|
const Mplex = require('libp2p-mplex')
|
||||||
|
const { NOISE } = require('@chainsafe/libp2p-noise')
|
||||||
|
const PeerId = require('peer-id')
|
||||||
|
|
||||||
|
;(async () => {
|
||||||
|
// hardcoded peer id to avoid copy-pasting of listener's peer id into the dialer's bootstrap list
|
||||||
|
// generated with cmd `peer-id --type=ed25519`
|
||||||
|
const hardcodedPeerId = await PeerId.createFromJSON({
|
||||||
|
"id": "12D3KooWCuo3MdXfMgaqpLC5Houi1TRoFqgK9aoxok4NK5udMu8m",
|
||||||
|
"privKey": "CAESQAG6Ld7ev6nnD0FKPs033/j0eQpjWilhxnzJ2CCTqT0+LfcWoI2Vr+zdc1vwk7XAVdyoCa2nwUR3RJebPWsF1/I=",
|
||||||
|
"pubKey": "CAESIC33FqCNla/s3XNb8JO1wFXcqAmtp8FEd0SXmz1rBdfy"
|
||||||
|
})
|
||||||
|
const node = await Libp2p.create({
|
||||||
|
peerId: hardcodedPeerId,
|
||||||
|
addresses: {
|
||||||
|
listen: ['/ip4/127.0.0.1/tcp/9090/http/p2p-webrtc-direct']
|
||||||
|
},
|
||||||
|
modules: {
|
||||||
|
transport: [WebRTCDirect],
|
||||||
|
streamMuxer: [Mplex],
|
||||||
|
connEncryption: [NOISE]
|
||||||
|
},
|
||||||
|
config: {
|
||||||
|
peerDiscovery: {
|
||||||
|
[Bootstrap.tag]: {
|
||||||
|
enabled: false,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
node.connectionManager.on('peer:connect', (connection) => {
|
||||||
|
console.info(`Connected to ${connection.remotePeer.toB58String()}!`)
|
||||||
|
})
|
||||||
|
|
||||||
|
await node.start()
|
||||||
|
|
||||||
|
console.log('Listening on:')
|
||||||
|
node.multiaddrs.forEach((ma) => console.log(`${ma.toString()}/p2p/${node.peerId.toB58String()}`))
|
||||||
|
|
||||||
|
})()
|
32
examples/webrtc-direct/package.json
Normal file
32
examples/webrtc-direct/package.json
Normal file
@ -0,0 +1,32 @@
|
|||||||
|
{
|
||||||
|
"name": "webrtc-direct",
|
||||||
|
"version": "0.0.1",
|
||||||
|
"private": true,
|
||||||
|
"description": "",
|
||||||
|
"scripts": {
|
||||||
|
"test": "echo \"Error: no test specified\" && exit 1",
|
||||||
|
"build": "parcel build index.html",
|
||||||
|
"start": "parcel index.html"
|
||||||
|
},
|
||||||
|
"license": "ISC",
|
||||||
|
"devDependencies": {
|
||||||
|
"@babel/cli": "^7.13.10",
|
||||||
|
"@babel/core": "^7.13.10",
|
||||||
|
"babel-plugin-syntax-async-functions": "^6.13.0",
|
||||||
|
"babel-plugin-transform-regenerator": "^6.26.0",
|
||||||
|
"babel-polyfill": "^6.26.0",
|
||||||
|
"parcel": "^2.0.1",
|
||||||
|
"util": "^0.12.3"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"libp2p": "../../",
|
||||||
|
"libp2p-bootstrap": "^0.13.0",
|
||||||
|
"libp2p-mplex": "^0.10.4",
|
||||||
|
"@chainsafe/libp2p-noise": "^4.1.0",
|
||||||
|
"libp2p-webrtc-direct": "^0.7.0",
|
||||||
|
"peer-id": "^0.16.0"
|
||||||
|
},
|
||||||
|
"browser": {
|
||||||
|
"ipfs": "ipfs/dist/index.min.js"
|
||||||
|
}
|
||||||
|
}
|
95
examples/webrtc-direct/test.js
Normal file
95
examples/webrtc-direct/test.js
Normal file
@ -0,0 +1,95 @@
|
|||||||
|
'use strict'
|
||||||
|
|
||||||
|
const path = require('path')
|
||||||
|
const execa = require('execa')
|
||||||
|
const pDefer = require('p-defer')
|
||||||
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
|
const { chromium } = require('playwright');
|
||||||
|
|
||||||
|
function startNode (name, args = []) {
|
||||||
|
return execa('node', [path.join(__dirname, name), ...args], {
|
||||||
|
cwd: path.resolve(__dirname),
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function startBrowser (name, args = []) {
|
||||||
|
return execa('parcel', [path.join(__dirname, name), ...args], {
|
||||||
|
preferLocal: true,
|
||||||
|
localDir: __dirname,
|
||||||
|
cwd: __dirname,
|
||||||
|
all: true
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
async function test () {
|
||||||
|
// Step 1, listener process
|
||||||
|
const listenerProcReady = pDefer()
|
||||||
|
let listenerOutput = ''
|
||||||
|
process.stdout.write('listener.js\n')
|
||||||
|
const listenerProc = startNode('listener.js')
|
||||||
|
|
||||||
|
listenerProc.all.on('data', async (data) => {
|
||||||
|
process.stdout.write(data)
|
||||||
|
listenerOutput += uint8ArrayToString(data)
|
||||||
|
if (listenerOutput.includes('Listening on:') && listenerOutput.includes('12D3KooWCuo3MdXfMgaqpLC5Houi1TRoFqgK9aoxok4NK5udMu8m')) {
|
||||||
|
listenerProcReady.resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await listenerProcReady.promise
|
||||||
|
process.stdout.write('==================================================================\n')
|
||||||
|
|
||||||
|
// Step 2, dialer process
|
||||||
|
process.stdout.write('dialer.js\n')
|
||||||
|
let dialerUrl = ''
|
||||||
|
const dialerProc = startBrowser('index.html')
|
||||||
|
|
||||||
|
dialerProc.all.on('data', async (chunk) => {
|
||||||
|
/**@type {string} */
|
||||||
|
const out = chunk.toString()
|
||||||
|
|
||||||
|
if (out.includes('Server running at')) {
|
||||||
|
dialerUrl = out.split('Server running at ')[1]
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
if (out.includes('Built in ')) {
|
||||||
|
|
||||||
|
try {
|
||||||
|
const browser = await chromium.launch();
|
||||||
|
const page = await browser.newPage();
|
||||||
|
await page.goto(dialerUrl);
|
||||||
|
await page.waitForFunction(selector => document.querySelector(selector).innerText === 'libp2p started!', '#status')
|
||||||
|
await page.waitForFunction(
|
||||||
|
selector => {
|
||||||
|
const text = document.querySelector(selector).innerText
|
||||||
|
return text.includes('libp2p id is') &&
|
||||||
|
text.includes('Found peer') &&
|
||||||
|
text.includes('Connected to')
|
||||||
|
},
|
||||||
|
'#output',
|
||||||
|
{ timeout: 10000 }
|
||||||
|
)
|
||||||
|
await browser.close();
|
||||||
|
} catch (/** @type {any} */ err) {
|
||||||
|
console.error(err)
|
||||||
|
process.exit(1)
|
||||||
|
} finally {
|
||||||
|
dialerProc.cancel()
|
||||||
|
listenerProc.kill()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
await Promise.all([
|
||||||
|
listenerProc,
|
||||||
|
dialerProc,
|
||||||
|
]).catch((err) => {
|
||||||
|
if (err.signal !== 'SIGTERM') {
|
||||||
|
throw err
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = test
|
@ -44,10 +44,10 @@
|
|||||||
|
|
||||||
"utilities",
|
"utilities",
|
||||||
["libp2p/js-libp2p-crypto", "libp2p-crypto"],
|
["libp2p/js-libp2p-crypto", "libp2p-crypto"],
|
||||||
["libp2p/js-libp2p-crypto-secp256k1", "libp2p-crypto-secp256k1"],
|
|
||||||
|
|
||||||
"data types",
|
"data types",
|
||||||
["libp2p/js-peer-id", "peer-id"],
|
["libp2p/js-peer-id", "peer-id"],
|
||||||
|
["libp2p/js-libp2p-record", "libp2p-record"],
|
||||||
|
|
||||||
"pubsub",
|
"pubsub",
|
||||||
["libp2p/js-libp2p-floodsub", "libp2p-floodsub"],
|
["libp2p/js-libp2p-floodsub", "libp2p-floodsub"],
|
||||||
|
218
package.json
218
package.json
@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "libp2p",
|
"name": "libp2p",
|
||||||
"version": "0.30.7",
|
"version": "0.35.0",
|
||||||
"description": "JavaScript implementation of libp2p, a modular peer to peer network stack",
|
"description": "JavaScript implementation of libp2p, a modular peer to peer network stack",
|
||||||
"leadMaintainer": "Jacob Heun <jacobheun@gmail.com>",
|
"leadMaintainer": "Jacob Heun <jacobheun@gmail.com>",
|
||||||
"main": "src/index.js",
|
"main": "src/index.js",
|
||||||
@ -20,10 +20,29 @@
|
|||||||
"scripts": {
|
"scripts": {
|
||||||
"lint": "aegir lint",
|
"lint": "aegir lint",
|
||||||
"build": "aegir build",
|
"build": "aegir build",
|
||||||
"test": "npm run test:node && npm run test:browser",
|
"build:proto": "npm run build:proto:circuit && npm run build:proto:identify && npm run build:proto:plaintext && npm run build:proto:address-book && npm run build:proto:proto-book && npm run build:proto:peer-record && npm run build:proto:envelope",
|
||||||
|
"build:proto:circuit": "pbjs -t static-module -w commonjs -r libp2p-circuit --force-number --no-verify --no-delimited --no-create --no-beautify --no-defaults --lint eslint-disable -o src/circuit/protocol/index.js ./src/circuit/protocol/index.proto",
|
||||||
|
"build:proto:identify": "pbjs -t static-module -w commonjs -r libp2p-identify --force-number --no-verify --no-delimited --no-create --no-beautify --no-defaults --lint eslint-disable -o src/identify/message.js ./src/identify/message.proto",
|
||||||
|
"build:proto:plaintext": "pbjs -t static-module -w commonjs -r libp2p-plaintext --force-number --no-verify --no-delimited --no-create --no-beautify --no-defaults --lint eslint-disable -o src/insecure/proto.js ./src/insecure/proto.proto",
|
||||||
|
"build:proto:address-book": "pbjs -t static-module -w commonjs -r libp2p-address-book --force-number --no-verify --no-delimited --no-create --no-beautify --no-defaults --lint eslint-disable -o src/peer-store/persistent/pb/address-book.js ./src/peer-store/persistent/pb/address-book.proto",
|
||||||
|
"build:proto:proto-book": "pbjs -t static-module -w commonjs -r libp2p-proto-book --force-number --no-verify --no-delimited --no-create --no-beautify --no-defaults --lint eslint-disable -o src/peer-store/persistent/pb/proto-book.js ./src/peer-store/persistent/pb/proto-book.proto",
|
||||||
|
"build:proto:peer-record": "pbjs -t static-module -w commonjs -r libp2p-peer-record --force-number --no-verify --no-delimited --no-create --no-beautify --no-defaults --lint eslint-disable -o src/record/peer-record/peer-record.js ./src/record/peer-record/peer-record.proto",
|
||||||
|
"build:proto:envelope": "pbjs -t static-module -w commonjs -r libp2p-envelope --force-number --no-verify --no-delimited --no-create --no-beautify --no-defaults --lint eslint-disable -o src/record/envelope/envelope.js ./src/record/envelope/envelope.proto",
|
||||||
|
"build:proto-types": "npm run build:proto-types:circuit && npm run build:proto-types:identify && npm run build:proto-types:plaintext && npm run build:proto-types:address-book && npm run build:proto-types:proto-book && npm run build:proto-types:peer-record && npm run build:proto-types:envelope",
|
||||||
|
"build:proto-types:circuit": "pbts -o src/circuit/protocol/index.d.ts src/circuit/protocol/index.js",
|
||||||
|
"build:proto-types:identify": "pbts -o src/identify/message.d.ts src/identify/message.js",
|
||||||
|
"build:proto-types:plaintext": "pbts -o src/insecure/proto.d.ts src/insecure/proto.js",
|
||||||
|
"build:proto-types:address-book": "pbts -o src/peer-store/persistent/pb/address-book.d.ts src/peer-store/persistent/pb/address-book.js",
|
||||||
|
"build:proto-types:proto-book": "pbts -o src/peer-store/persistent/pb/proto-book.d.ts src/peer-store/persistent/pb/proto-book.js",
|
||||||
|
"build:proto-types:peer-record": "pbts -o src/record/peer-record/peer-record.d.ts src/record/peer-record/peer-record.js",
|
||||||
|
"build:proto-types:envelope": "pbts -o src/record/envelope/envelope.d.ts src/record/envelope/envelope.js",
|
||||||
|
"test": "aegir test",
|
||||||
|
"test:ts": "aegir build --no-bundle && npm run test --prefix test/ts-use",
|
||||||
"test:node": "aegir test -t node -f \"./test/**/*.{node,spec}.js\"",
|
"test:node": "aegir test -t node -f \"./test/**/*.{node,spec}.js\"",
|
||||||
"test:browser": "aegir test -t browser",
|
"test:browser": "aegir test -t browser",
|
||||||
"test:examples": "cd examples && npm run test:all",
|
"test:examples": "cd examples && npm run test:all",
|
||||||
|
"test:interop": "LIBP2P_JS=$PWD npx aegir test -t node -f ./node_modules/libp2p-interop/test/*",
|
||||||
|
"prepare": "aegir build --no-bundle",
|
||||||
"release": "aegir release -t node -t browser",
|
"release": "aegir release -t node -t browser",
|
||||||
"release-minor": "aegir release --type minor -t node -t browser",
|
"release-minor": "aegir release --type minor -t node -t browser",
|
||||||
"release-major": "aegir release --type major -t node -t browser",
|
"release-major": "aegir release --type major -t node -t browser",
|
||||||
@ -47,152 +66,187 @@
|
|||||||
"homepage": "https://libp2p.io",
|
"homepage": "https://libp2p.io",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"engines": {
|
"engines": {
|
||||||
"node": ">=12.0.0",
|
"node": ">=15.0.0"
|
||||||
"npm": ">=6.0.0"
|
|
||||||
},
|
},
|
||||||
"browser": {
|
"browser": {
|
||||||
"@motrix/nat-api": false
|
"@motrix/nat-api": false
|
||||||
},
|
},
|
||||||
|
"eslintConfig": {
|
||||||
|
"extends": "ipfs",
|
||||||
|
"ignorePatterns": [
|
||||||
|
"!.aegir.js",
|
||||||
|
"test/ts-use",
|
||||||
|
"*.d.ts"
|
||||||
|
]
|
||||||
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@motrix/nat-api": "^0.3.1",
|
"@motrix/nat-api": "^0.3.1",
|
||||||
|
"@vascosantos/moving-average": "^1.1.0",
|
||||||
"abort-controller": "^3.0.0",
|
"abort-controller": "^3.0.0",
|
||||||
|
"abortable-iterator": "^3.0.0",
|
||||||
"aggregate-error": "^3.1.0",
|
"aggregate-error": "^3.1.0",
|
||||||
"any-signal": "^2.1.1",
|
"any-signal": "^2.1.1",
|
||||||
"bignumber.js": "^9.0.1",
|
"bignumber.js": "^9.0.1",
|
||||||
"cids": "^1.1.5",
|
|
||||||
"class-is": "^1.1.0",
|
"class-is": "^1.1.0",
|
||||||
"debug": "^4.3.1",
|
"debug": "^4.3.1",
|
||||||
"err-code": "^2.0.0",
|
"err-code": "^3.0.0",
|
||||||
"events": "^3.2.0",
|
"es6-promisify": "^7.0.0",
|
||||||
|
"events": "^3.3.0",
|
||||||
"hashlru": "^2.3.0",
|
"hashlru": "^2.3.0",
|
||||||
"interface-datastore": "^3.0.3",
|
"interface-datastore": "^6.0.2",
|
||||||
"ipfs-utils": "^6.0.0",
|
|
||||||
"it-all": "^1.0.4",
|
"it-all": "^1.0.4",
|
||||||
"it-buffer": "^0.1.2",
|
"it-buffer": "^0.1.2",
|
||||||
"it-drain": "^1.0.3",
|
"it-drain": "^1.0.3",
|
||||||
"it-filter": "^1.0.1",
|
"it-filter": "^1.0.1",
|
||||||
"it-first": "^1.0.4",
|
"it-first": "^1.0.4",
|
||||||
"it-handshake": "^1.0.2",
|
"it-handshake": "^2.0.0",
|
||||||
"it-length-prefixed": "^3.1.0",
|
"it-length-prefixed": "^5.0.2",
|
||||||
"it-map": "^1.0.4",
|
"it-map": "^1.0.4",
|
||||||
"it-merge": "1.0.0",
|
"it-merge": "^1.0.0",
|
||||||
"it-pipe": "^1.1.0",
|
"it-pipe": "^1.1.0",
|
||||||
"it-protocol-buffers": "^0.2.0",
|
"it-take": "^1.0.0",
|
||||||
"it-take": "1.0.0",
|
"libp2p-crypto": "^0.21.0",
|
||||||
"libp2p-crypto": "^0.19.0",
|
"libp2p-interfaces": "^2.0.1",
|
||||||
"libp2p-interfaces": "^0.8.1",
|
"libp2p-utils": "^0.4.0",
|
||||||
"libp2p-utils": "^0.2.2",
|
"mafmt": "^10.0.0",
|
||||||
"mafmt": "^8.0.0",
|
|
||||||
"merge-options": "^3.0.4",
|
"merge-options": "^3.0.4",
|
||||||
"moving-average": "^1.0.0",
|
"multiaddr": "^10.0.0",
|
||||||
"multiaddr": "^8.1.0",
|
"multiformats": "^9.0.0",
|
||||||
"multicodec": "^2.1.0",
|
"multistream-select": "^2.0.0",
|
||||||
"multihashing-async": "^2.0.1",
|
|
||||||
"multistream-select": "^1.0.0",
|
|
||||||
"mutable-proxy": "^1.0.0",
|
"mutable-proxy": "^1.0.0",
|
||||||
"node-forge": "^0.10.0",
|
"node-forge": "^0.10.0",
|
||||||
"p-any": "^3.0.0",
|
"p-any": "^3.0.0",
|
||||||
"p-fifo": "^1.0.0",
|
"p-fifo": "^1.0.0",
|
||||||
"p-retry": "^4.2.0",
|
"p-retry": "^4.4.0",
|
||||||
"p-settle": "^4.0.1",
|
"p-settle": "^4.1.1",
|
||||||
"peer-id": "^0.14.2",
|
"peer-id": "^0.16.0",
|
||||||
"private-ip": "^2.0.0",
|
"private-ip": "^2.1.0",
|
||||||
"promisify-es6": "^1.0.3",
|
"protobufjs": "^6.10.2",
|
||||||
"protons": "^2.0.0",
|
"retimer": "^3.0.0",
|
||||||
"retimer": "^2.0.0",
|
|
||||||
"sanitize-filename": "^1.6.3",
|
"sanitize-filename": "^1.6.3",
|
||||||
"set-delayed-interval": "^1.0.0",
|
"set-delayed-interval": "^1.0.0",
|
||||||
"streaming-iterables": "^5.0.2",
|
"streaming-iterables": "^6.0.0",
|
||||||
"timeout-abort-controller": "^1.1.1",
|
"timeout-abort-controller": "^2.0.0",
|
||||||
|
"uint8arrays": "^3.0.0",
|
||||||
"varint": "^6.0.0",
|
"varint": "^6.0.0",
|
||||||
"xsalsa20": "^1.0.2"
|
"wherearewe": "^1.0.0",
|
||||||
|
"xsalsa20": "^1.1.0"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
|
"@chainsafe/libp2p-noise": "^4.0.0",
|
||||||
"@nodeutils/defaults-deep": "^1.1.0",
|
"@nodeutils/defaults-deep": "^1.1.0",
|
||||||
"abortable-iterator": "^3.0.0",
|
"@types/es6-promisify": "^6.0.0",
|
||||||
"aegir": "^29.2.0",
|
"@types/node": "^16.0.1",
|
||||||
"chai-bytes": "^0.1.2",
|
"@types/node-forge": "^0.10.1",
|
||||||
"chai-string": "^1.5.0",
|
"@types/varint": "^6.0.0",
|
||||||
"delay": "^4.4.0",
|
"aegir": "^36.0.0",
|
||||||
"interop-libp2p": "^0.3.0",
|
"buffer": "^6.0.3",
|
||||||
|
"datastore-core": "^6.0.7",
|
||||||
|
"delay": "^5.0.0",
|
||||||
"into-stream": "^6.0.0",
|
"into-stream": "^6.0.0",
|
||||||
"ipfs-http-client": "^48.2.2",
|
"ipfs-http-client": "^54.0.2",
|
||||||
"it-concat": "^1.0.0",
|
"it-concat": "^2.0.0",
|
||||||
"it-pair": "^1.0.0",
|
"it-pair": "^1.0.0",
|
||||||
"it-pushable": "^1.4.0",
|
"it-pushable": "^1.4.0",
|
||||||
"libp2p": ".",
|
"libp2p": ".",
|
||||||
"libp2p-bootstrap": "^0.12.0",
|
"libp2p-bootstrap": "^0.14.0",
|
||||||
"libp2p-delegated-content-routing": "^0.9.0",
|
"libp2p-delegated-content-routing": "^0.11.0",
|
||||||
"libp2p-delegated-peer-routing": "^0.8.0",
|
"libp2p-delegated-peer-routing": "^0.11.0",
|
||||||
"libp2p-floodsub": "^0.24.0",
|
"libp2p-floodsub": "^0.27.0",
|
||||||
"libp2p-gossipsub": "^0.8.0",
|
"libp2p-gossipsub": "^0.11.0",
|
||||||
"libp2p-kad-dht": "^0.20.5",
|
"libp2p-interfaces-compliance-tests": "^2.0.1",
|
||||||
"libp2p-mdns": "^0.15.0",
|
"libp2p-interop": "^0.5.0",
|
||||||
|
"libp2p-kad-dht": "^0.27.1",
|
||||||
|
"libp2p-mdns": "^0.18.0",
|
||||||
"libp2p-mplex": "^0.10.1",
|
"libp2p-mplex": "^0.10.1",
|
||||||
"libp2p-noise": "^2.0.0",
|
"libp2p-tcp": "^0.17.0",
|
||||||
"libp2p-secio": "^0.13.1",
|
"libp2p-webrtc-star": "^0.25.0",
|
||||||
"libp2p-tcp": "^0.15.1",
|
"libp2p-websockets": "^0.16.0",
|
||||||
"libp2p-webrtc-star": "^0.20.0",
|
|
||||||
"libp2p-websockets": "^0.15.0",
|
|
||||||
"multihashes": "^3.0.1",
|
|
||||||
"nock": "^13.0.3",
|
"nock": "^13.0.3",
|
||||||
"p-defer": "^3.0.0",
|
"p-defer": "^3.0.0",
|
||||||
"p-times": "^3.0.0",
|
"p-times": "^3.0.0",
|
||||||
"p-wait-for": "^3.2.0",
|
"p-wait-for": "^3.2.0",
|
||||||
"rimraf": "^3.0.2",
|
"rimraf": "^3.0.2",
|
||||||
"sinon": "^9.2.4",
|
"sinon": "^12.0.1",
|
||||||
"uint8arrays": "^2.0.5"
|
"util": "^0.12.3"
|
||||||
},
|
},
|
||||||
"contributors": [
|
"contributors": [
|
||||||
|
"Vasco Santos <vasco.santos@moxy.studio>",
|
||||||
"David Dias <daviddias.p@gmail.com>",
|
"David Dias <daviddias.p@gmail.com>",
|
||||||
"Jacob Heun <jacobheun@gmail.com>",
|
"Jacob Heun <jacobheun@gmail.com>",
|
||||||
"Vasco Santos <vasco.santos@moxy.studio>",
|
|
||||||
"Alan Shaw <alan@tableflip.io>",
|
|
||||||
"Alex Potsides <alex@achingbrain.net>",
|
"Alex Potsides <alex@achingbrain.net>",
|
||||||
|
"Alan Shaw <alan@tableflip.io>",
|
||||||
"Cayman <caymannava@gmail.com>",
|
"Cayman <caymannava@gmail.com>",
|
||||||
"Pedro Teixeira <i@pgte.me>",
|
"Pedro Teixeira <i@pgte.me>",
|
||||||
"Friedel Ziegelmayer <dignifiedquire@gmail.com>",
|
"Friedel Ziegelmayer <dignifiedquire@gmail.com>",
|
||||||
"Maciej Krüger <mkg20001@gmail.com>",
|
"Maciej Krüger <mkg20001@gmail.com>",
|
||||||
"Hugo Dias <mail@hugodias.me>",
|
"Hugo Dias <mail@hugodias.me>",
|
||||||
"Volker Mische <volker.mische@gmail.com>",
|
|
||||||
"dirkmc <dirkmdev@gmail.com>",
|
"dirkmc <dirkmdev@gmail.com>",
|
||||||
|
"Chris Dostert <chrisdostert@users.noreply.github.com>",
|
||||||
|
"Volker Mische <volker.mische@gmail.com>",
|
||||||
|
"zeim839 <50573884+zeim839@users.noreply.github.com>",
|
||||||
"Richard Littauer <richard.littauer@gmail.com>",
|
"Richard Littauer <richard.littauer@gmail.com>",
|
||||||
"a1300 <matthias-knopp@gmx.net>",
|
"a1300 <matthias-knopp@gmx.net>",
|
||||||
"Ryan Bell <ryan@piing.net>",
|
"Ryan Bell <ryan@piing.net>",
|
||||||
"Andrew Nesbitt <andrewnez@gmail.com>",
|
"ᴠɪᴄᴛᴏʀ ʙᴊᴇʟᴋʜᴏʟᴍ <victorbjelkholm@gmail.com>",
|
||||||
"Elven <mon.samuel@qq.com>",
|
|
||||||
"Giovanni T. Parra <fiatjaf@gmail.com>",
|
"Giovanni T. Parra <fiatjaf@gmail.com>",
|
||||||
|
"acolytec3 <17355484+acolytec3@users.noreply.github.com>",
|
||||||
|
"Franck Royer <franck@royer.one>",
|
||||||
|
"Elven <mon.samuel@qq.com>",
|
||||||
|
"Robert Kiel <robert.kiel@hoprnet.org>",
|
||||||
|
"Andrew Nesbitt <andrewnez@gmail.com>",
|
||||||
"Samlior <samlior@foxmail.com>",
|
"Samlior <samlior@foxmail.com>",
|
||||||
"Thomas Eizinger <thomas@eizinger.io>",
|
"Thomas Eizinger <thomas@eizinger.io>",
|
||||||
"ᴠɪᴄᴛᴏʀ ʙᴊᴇʟᴋʜᴏʟᴍ <victorbjelkholm@gmail.com>",
|
"Didrik Nordström <didrik.nordstrom@gmail.com>",
|
||||||
"Didrik Nordström <didrik@betamos.se>",
|
|
||||||
"Irakli Gozalishvili <rfobic@gmail.com>",
|
|
||||||
"Joel Gustafson <joelg@mit.edu>",
|
|
||||||
"Julien Bouquillon <contact@revolunet.com>",
|
|
||||||
"Kevin Kwok <antimatter15@gmail.com>",
|
|
||||||
"Kevin Lacker <lacker@gmail.com>",
|
|
||||||
"Ethan Lam <elmemphis2000@gmail.com>",
|
|
||||||
"Nuno Nogueira <nunofmn@gmail.com>",
|
|
||||||
"Dmitriy Ryajov <dryajov@gmail.com>",
|
|
||||||
"RasmusErik Voel Jensen <github@solsort.com>",
|
|
||||||
"Diogo Silva <fsdiogo@gmail.com>",
|
|
||||||
"Smite Chow <xiaopengyou@live.com>",
|
"Smite Chow <xiaopengyou@live.com>",
|
||||||
"Soeren <nikorpoulsen@gmail.com>",
|
"Soeren <nikorpoulsen@gmail.com>",
|
||||||
"Sönke Hahn <soenkehahn@gmail.com>",
|
"Sönke Hahn <soenkehahn@gmail.com>",
|
||||||
|
"TJKoury <TJKoury@gmail.com>",
|
||||||
|
"TheStarBoys <41286328+TheStarBoys@users.noreply.github.com>",
|
||||||
"Tiago Alves <alvesjtiago@gmail.com>",
|
"Tiago Alves <alvesjtiago@gmail.com>",
|
||||||
"Daijiro Wachi <daijiro.wachi@gmail.com>",
|
"XiaoZhang <zxinmyth@gmail.com>",
|
||||||
"Yusef Napora <yusef@napora.org>",
|
"Yusef Napora <yusef@napora.org>",
|
||||||
"Zane Starr <zcstarr@gmail.com>",
|
"Zane Starr <zcstarr@gmail.com>",
|
||||||
"robertkiel <robert.kiel@validitylabs.org>",
|
|
||||||
"Cindy Wu <ciindy.wu@gmail.com>",
|
|
||||||
"Chris Bratlien <chrisbratlien@gmail.com>",
|
|
||||||
"ebinks <elizabethjbinks@gmail.com>",
|
"ebinks <elizabethjbinks@gmail.com>",
|
||||||
"Francis Gulotta <wizard@roborooter.com>",
|
"Aditya Bose <13054902+adbose@users.noreply.github.com>",
|
||||||
"Florian-Merle <florian.david.merle@gmail.com>",
|
|
||||||
"Bernd Strehl <bernd.strehl@gmail.com>",
|
|
||||||
"Henrique Dias <hacdias@gmail.com>",
|
|
||||||
"isan_rivkin <isanrivkin@gmail.com>",
|
"isan_rivkin <isanrivkin@gmail.com>",
|
||||||
|
"mayerwin <mayerwin@users.noreply.github.com>",
|
||||||
|
"mcclure <andi.m.mcclure@gmail.com>",
|
||||||
|
"patrickwoodhead <91056047+patrickwoodhead@users.noreply.github.com>",
|
||||||
|
"phillmac <phillmac@users.noreply.github.com>",
|
||||||
|
"robertkiel <robert.kiel@validitylabs.org>",
|
||||||
|
"shresthagrawal <34920931+shresthagrawal@users.noreply.github.com>",
|
||||||
|
"swedneck <40505480+swedneck@users.noreply.github.com>",
|
||||||
|
"greenSnot <greenSnot@users.noreply.github.com>",
|
||||||
|
"Alan Smithee <ggnore.alan.smithee@gmail.com>",
|
||||||
|
"Aleksei <vozhdb@gmail.com>",
|
||||||
|
"Bernd Strehl <bernd.strehl@gmail.com>",
|
||||||
|
"Chris Bratlien <chrisbratlien@gmail.com>",
|
||||||
|
"Cindy Wu <ciindy.wu@gmail.com>",
|
||||||
|
"Daijiro Wachi <daijiro.wachi@gmail.com>",
|
||||||
|
"Diogo Silva <fsdiogo@gmail.com>",
|
||||||
|
"Dmitriy Ryajov <dryajov@gmail.com>",
|
||||||
|
"Ethan Lam <elmemphis2000@gmail.com>",
|
||||||
|
"Fei Liu <liu.feiwood@gmail.com>",
|
||||||
"Felipe Martins <felipebrasil93@gmail.com>",
|
"Felipe Martins <felipebrasil93@gmail.com>",
|
||||||
"Fei Liu <liu.feiwood@gmail.com>"
|
"Florian-Merle <florian.david.merle@gmail.com>",
|
||||||
|
"Francis Gulotta <wizard@roborooter.com>",
|
||||||
|
"Guy Sviry <32539816+guysv@users.noreply.github.com>",
|
||||||
|
"Henrique Dias <hacdias@gmail.com>",
|
||||||
|
"Irakli Gozalishvili <rfobic@gmail.com>",
|
||||||
|
"Joel Gustafson <joelg@mit.edu>",
|
||||||
|
"John Rees <johnrees@users.noreply.github.com>",
|
||||||
|
"João Santos <joaosantos15@users.noreply.github.com>",
|
||||||
|
"Julien Bouquillon <contact@revolunet.com>",
|
||||||
|
"Kevin Kwok <antimatter15@gmail.com>",
|
||||||
|
"Kevin Lacker <lacker@gmail.com>",
|
||||||
|
"Lars Gierth <lgierth@users.noreply.github.com>",
|
||||||
|
"Leask Wong <i@leaskh.com>",
|
||||||
|
"Marcin Tojek <mtojek@users.noreply.github.com>",
|
||||||
|
"Michael Burns <5170+mburns@users.noreply.github.com>",
|
||||||
|
"Miguel Mota <miguelmota2@gmail.com>",
|
||||||
|
"Nuno Nogueira <nunofmn@gmail.com>",
|
||||||
|
"Philipp Muens <raute1337@gmx.de>",
|
||||||
|
"RasmusErik Voel Jensen <github@solsort.com>"
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
2
scripts/node-globals.js
Normal file
2
scripts/node-globals.js
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
// @ts-nocheck
|
||||||
|
export const { Buffer } = require('buffer')
|
@ -1,15 +1,9 @@
|
|||||||
'use strict'
|
'use strict'
|
||||||
|
|
||||||
/** @typedef {import('../types').EventEmitterFactory} Events */
|
const { EventEmitter } = require('events')
|
||||||
/** @type Events */
|
const { Multiaddr } = require('multiaddr')
|
||||||
const EventEmitter = require('events')
|
|
||||||
const multiaddr = require('multiaddr')
|
|
||||||
const PeerId = require('peer-id')
|
const PeerId = require('peer-id')
|
||||||
|
|
||||||
/**
|
|
||||||
* @typedef {import('multiaddr')} Multiaddr
|
|
||||||
*/
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @typedef {Object} AddressManagerOptions
|
* @typedef {Object} AddressManagerOptions
|
||||||
* @property {string[]} [listen = []] - list of multiaddrs string representation to listen.
|
* @property {string[]} [listen = []] - list of multiaddrs string representation to listen.
|
||||||
@ -47,7 +41,7 @@ class AddressManager extends EventEmitter {
|
|||||||
* @returns {Multiaddr[]}
|
* @returns {Multiaddr[]}
|
||||||
*/
|
*/
|
||||||
getListenAddrs () {
|
getListenAddrs () {
|
||||||
return Array.from(this.listen).map((a) => multiaddr(a))
|
return Array.from(this.listen).map((a) => new Multiaddr(a))
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -56,7 +50,7 @@ class AddressManager extends EventEmitter {
|
|||||||
* @returns {Multiaddr[]}
|
* @returns {Multiaddr[]}
|
||||||
*/
|
*/
|
||||||
getAnnounceAddrs () {
|
getAnnounceAddrs () {
|
||||||
return Array.from(this.announce).map((a) => multiaddr(a))
|
return Array.from(this.announce).map((a) => new Multiaddr(a))
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -65,7 +59,7 @@ class AddressManager extends EventEmitter {
|
|||||||
* @returns {Array<Multiaddr>}
|
* @returns {Array<Multiaddr>}
|
||||||
*/
|
*/
|
||||||
getObservedAddrs () {
|
getObservedAddrs () {
|
||||||
return Array.from(this.observed).map((a) => multiaddr(a))
|
return Array.from(this.observed).map((a) => new Multiaddr(a))
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -74,7 +68,7 @@ class AddressManager extends EventEmitter {
|
|||||||
* @param {string | Multiaddr} addr
|
* @param {string | Multiaddr} addr
|
||||||
*/
|
*/
|
||||||
addObservedAddr (addr) {
|
addObservedAddr (addr) {
|
||||||
let ma = multiaddr(addr)
|
let ma = new Multiaddr(addr)
|
||||||
const remotePeer = ma.getPeerId()
|
const remotePeer = ma.getPeerId()
|
||||||
|
|
||||||
// strip our peer id if it has been passed
|
// strip our peer id if it has been passed
|
||||||
@ -83,7 +77,7 @@ class AddressManager extends EventEmitter {
|
|||||||
|
|
||||||
// use same encoding for comparison
|
// use same encoding for comparison
|
||||||
if (remotePeerId.equals(this.peerId)) {
|
if (remotePeerId.equals(this.peerId)) {
|
||||||
ma = ma.decapsulate(multiaddr(`/p2p/${this.peerId}`))
|
ma = ma.decapsulate(new Multiaddr(`/p2p/${this.peerId}`))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -37,7 +37,7 @@ Libp2p circuit configuration can be seen at [Setup with Relay](../../doc/CONFIGU
|
|||||||
Once you have a circuit relay node running, you can configure other nodes to use it as a relay as follows:
|
Once you have a circuit relay node running, you can configure other nodes to use it as a relay as follows:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
const multiaddr = require('multiaddr')
|
const { Multiaddr } = require('multiaddr')
|
||||||
const Libp2p = require('libp2p')
|
const Libp2p = require('libp2p')
|
||||||
const TCP = require('libp2p-tcp')
|
const TCP = require('libp2p-tcp')
|
||||||
const MPLEX = require('libp2p-mplex')
|
const MPLEX = require('libp2p-mplex')
|
||||||
@ -47,7 +47,7 @@ const relayAddr = ...
|
|||||||
|
|
||||||
const node = await Libp2p.create({
|
const node = await Libp2p.create({
|
||||||
addresses: {
|
addresses: {
|
||||||
listen: [multiaddr(`${relayAddr}/p2p-circuit`)]
|
listen: [new Multiaddr(`${relayAddr}/p2p-circuit`)]
|
||||||
},
|
},
|
||||||
modules: {
|
modules: {
|
||||||
transport: [TCP],
|
transport: [TCP],
|
||||||
|
@ -5,9 +5,9 @@ const log = Object.assign(debug('libp2p:auto-relay'), {
|
|||||||
error: debug('libp2p:auto-relay:err')
|
error: debug('libp2p:auto-relay:err')
|
||||||
})
|
})
|
||||||
|
|
||||||
const uint8ArrayFromString = require('uint8arrays/from-string')
|
const { fromString: uint8ArrayFromString } = require('uint8arrays/from-string')
|
||||||
const uint8ArrayToString = require('uint8arrays/to-string')
|
const { toString: uint8ArrayToString } = require('uint8arrays/to-string')
|
||||||
const multiaddr = require('multiaddr')
|
const { Multiaddr } = require('multiaddr')
|
||||||
const PeerId = require('peer-id')
|
const PeerId = require('peer-id')
|
||||||
|
|
||||||
const { relay: multicodec } = require('./multicodec')
|
const { relay: multicodec } = require('./multicodec')
|
||||||
@ -31,6 +31,7 @@ const {
|
|||||||
*
|
*
|
||||||
* @typedef {Object} AutoRelayOptions
|
* @typedef {Object} AutoRelayOptions
|
||||||
* @property {number} [maxListeners = 1] - maximum number of relays to listen.
|
* @property {number} [maxListeners = 1] - maximum number of relays to listen.
|
||||||
|
* @property {(error: Error, msg?: string) => {}} [onError]
|
||||||
*/
|
*/
|
||||||
|
|
||||||
class AutoRelay {
|
class AutoRelay {
|
||||||
@ -40,7 +41,7 @@ class AutoRelay {
|
|||||||
* @class
|
* @class
|
||||||
* @param {AutoRelayProperties & AutoRelayOptions} props
|
* @param {AutoRelayProperties & AutoRelayOptions} props
|
||||||
*/
|
*/
|
||||||
constructor ({ libp2p, maxListeners = 1 }) {
|
constructor ({ libp2p, maxListeners = 1, onError }) {
|
||||||
this._libp2p = libp2p
|
this._libp2p = libp2p
|
||||||
this._peerId = libp2p.peerId
|
this._peerId = libp2p.peerId
|
||||||
this._peerStore = libp2p.peerStore
|
this._peerStore = libp2p.peerStore
|
||||||
@ -60,6 +61,15 @@ class AutoRelay {
|
|||||||
|
|
||||||
this._peerStore.on('change:protocols', this._onProtocolChange)
|
this._peerStore.on('change:protocols', this._onProtocolChange)
|
||||||
this._connectionManager.on('peer:disconnect', this._onPeerDisconnected)
|
this._connectionManager.on('peer:disconnect', this._onPeerDisconnected)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param {Error} error
|
||||||
|
* @param {string} [msg]
|
||||||
|
*/
|
||||||
|
this._onError = (error, msg) => {
|
||||||
|
log.error(msg || error)
|
||||||
|
onError && onError(error, msg)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -106,8 +116,8 @@ class AutoRelay {
|
|||||||
this._peerStore.metadataBook.set(peerId, HOP_METADATA_KEY, uint8ArrayFromString(HOP_METADATA_VALUE))
|
this._peerStore.metadataBook.set(peerId, HOP_METADATA_KEY, uint8ArrayFromString(HOP_METADATA_VALUE))
|
||||||
await this._addListenRelay(connection, id)
|
await this._addListenRelay(connection, id)
|
||||||
}
|
}
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
log.error(err)
|
this._onError(err)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -157,10 +167,10 @@ class AutoRelay {
|
|||||||
|
|
||||||
// Attempt to listen on relay
|
// Attempt to listen on relay
|
||||||
try {
|
try {
|
||||||
await this._transportManager.listen([multiaddr(listenAddr)])
|
await this._transportManager.listen([new Multiaddr(listenAddr)])
|
||||||
// Announce multiaddrs will update on listen success by TransportManager event being triggered
|
// Announce multiaddrs will update on listen success by TransportManager event being triggered
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
log.error(err)
|
this._onError(err)
|
||||||
this._listenRelays.delete(id)
|
this._listenRelays.delete(id)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -212,7 +222,7 @@ class AutoRelay {
|
|||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
|
|
||||||
const peerId = PeerId.createFromCID(id)
|
const peerId = PeerId.createFromB58String(id)
|
||||||
const connection = this._connectionManager.get(peerId)
|
const connection = this._connectionManager.get(peerId)
|
||||||
|
|
||||||
// If not connected, store for possible later use.
|
// If not connected, store for possible later use.
|
||||||
@ -231,8 +241,7 @@ class AutoRelay {
|
|||||||
|
|
||||||
// Try to listen on known peers that are not connected
|
// Try to listen on known peers that are not connected
|
||||||
for (const peerId of knownHopsToDial) {
|
for (const peerId of knownHopsToDial) {
|
||||||
const connection = await this._libp2p.dial(peerId)
|
await this._tryToListenOnRelay(peerId)
|
||||||
await this._addListenRelay(connection, peerId.toB58String())
|
|
||||||
|
|
||||||
// Check if already listening on enough relays
|
// Check if already listening on enough relays
|
||||||
if (this._listenRelays.size >= this.maxListeners) {
|
if (this._listenRelays.size >= this.maxListeners) {
|
||||||
@ -247,20 +256,31 @@ class AutoRelay {
|
|||||||
if (!provider.multiaddrs.length) {
|
if (!provider.multiaddrs.length) {
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
|
|
||||||
const peerId = provider.id
|
const peerId = provider.id
|
||||||
|
|
||||||
this._peerStore.addressBook.add(peerId, provider.multiaddrs)
|
this._peerStore.addressBook.add(peerId, provider.multiaddrs)
|
||||||
const connection = await this._libp2p.dial(peerId)
|
|
||||||
|
|
||||||
await this._addListenRelay(connection, peerId.toB58String())
|
await this._tryToListenOnRelay(peerId)
|
||||||
|
|
||||||
// Check if already listening on enough relays
|
// Check if already listening on enough relays
|
||||||
if (this._listenRelays.size >= this.maxListeners) {
|
if (this._listenRelays.size >= this.maxListeners) {
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
log.error(err)
|
this._onError(err)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param {PeerId} peerId
|
||||||
|
*/
|
||||||
|
async _tryToListenOnRelay (peerId) {
|
||||||
|
try {
|
||||||
|
const connection = await this._libp2p.dial(peerId)
|
||||||
|
await this._addListenRelay(connection, peerId.toB58String())
|
||||||
|
} catch (/** @type {any} */ err) {
|
||||||
|
this._onError(err, `could not connect and listen on known hop relay ${peerId.toB58String()}`)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -18,17 +18,17 @@ const { stop } = require('./stop')
|
|||||||
const multicodec = require('./../multicodec')
|
const multicodec = require('./../multicodec')
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @typedef {import('../../types').CircuitRequest} CircuitRequest
|
* @typedef {import('../protocol').ICircuitRelay} ICircuitRelay
|
||||||
* @typedef {import('libp2p-interfaces/src/connection').Connection} Connection
|
* @typedef {import('libp2p-interfaces/src/connection').Connection} Connection
|
||||||
* @typedef {import('./stream-handler')<CircuitRequest>} StreamHandlerT
|
* @typedef {import('libp2p-interfaces/src/stream-muxer/types').MuxedStream} MuxedStream
|
||||||
* @typedef {import('../transport')} Transport
|
* @typedef {import('../transport')} Transport
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @typedef {Object} HopRequest
|
* @typedef {Object} HopRequest
|
||||||
* @property {Connection} connection
|
* @property {Connection} connection
|
||||||
* @property {CircuitRequest} request
|
* @property {ICircuitRelay} request
|
||||||
* @property {StreamHandlerT} streamHandler
|
* @property {StreamHandler} streamHandler
|
||||||
* @property {Transport} circuit
|
* @property {Transport} circuit
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@ -54,10 +54,15 @@ async function handleHop ({
|
|||||||
// Validate the HOP request has the required input
|
// Validate the HOP request has the required input
|
||||||
try {
|
try {
|
||||||
validateAddrs(request, streamHandler)
|
validateAddrs(request, streamHandler)
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
return log.error('invalid hop request via peer %s', connection.remotePeer.toB58String(), err)
|
return log.error('invalid hop request via peer %s', connection.remotePeer.toB58String(), err)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (!request.dstPeer) {
|
||||||
|
log('HOP request received but we do not receive a dstPeer')
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
// Get the connection to the destination (stop) peer
|
// Get the connection to the destination (stop) peer
|
||||||
const destinationPeer = new PeerId(request.dstPeer.id)
|
const destinationPeer = new PeerId(request.dstPeer.id)
|
||||||
|
|
||||||
@ -88,7 +93,7 @@ async function handleHop ({
|
|||||||
connection: destinationConnection,
|
connection: destinationConnection,
|
||||||
request: stopRequest
|
request: stopRequest
|
||||||
})
|
})
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
return log.error(err)
|
return log.error(err)
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -113,8 +118,8 @@ async function handleHop ({
|
|||||||
*
|
*
|
||||||
* @param {object} options
|
* @param {object} options
|
||||||
* @param {Connection} options.connection - Connection to the relay
|
* @param {Connection} options.connection - Connection to the relay
|
||||||
* @param {CircuitRequest} options.request
|
* @param {ICircuitRelay} options.request
|
||||||
* @returns {Promise<Connection>}
|
* @returns {Promise<MuxedStream>}
|
||||||
*/
|
*/
|
||||||
async function hop ({
|
async function hop ({
|
||||||
connection,
|
connection,
|
||||||
@ -128,6 +133,10 @@ async function hop ({
|
|||||||
|
|
||||||
const response = await streamHandler.read()
|
const response = await streamHandler.read()
|
||||||
|
|
||||||
|
if (!response) {
|
||||||
|
throw errCode(new Error('HOP request had no response'), Errors.ERR_HOP_REQUEST_FAILED)
|
||||||
|
}
|
||||||
|
|
||||||
if (response.code === CircuitPB.Status.SUCCESS) {
|
if (response.code === CircuitPB.Status.SUCCESS) {
|
||||||
log('hop request was successful')
|
log('hop request was successful')
|
||||||
return streamHandler.rest()
|
return streamHandler.rest()
|
||||||
@ -159,7 +168,7 @@ async function canHop ({
|
|||||||
const response = await streamHandler.read()
|
const response = await streamHandler.read()
|
||||||
await streamHandler.close()
|
await streamHandler.close()
|
||||||
|
|
||||||
if (response.code !== CircuitPB.Status.SUCCESS) {
|
if (!response || response.code !== CircuitPB.Status.SUCCESS) {
|
||||||
return false
|
return false
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -171,7 +180,7 @@ async function canHop ({
|
|||||||
*
|
*
|
||||||
* @param {Object} options
|
* @param {Object} options
|
||||||
* @param {Connection} options.connection
|
* @param {Connection} options.connection
|
||||||
* @param {StreamHandlerT} options.streamHandler
|
* @param {StreamHandler} options.streamHandler
|
||||||
* @param {Transport} options.circuit
|
* @param {Transport} options.circuit
|
||||||
* @private
|
* @private
|
||||||
*/
|
*/
|
||||||
|
@ -13,8 +13,7 @@ const { validateAddrs } = require('./utils')
|
|||||||
/**
|
/**
|
||||||
* @typedef {import('libp2p-interfaces/src/connection').Connection} Connection
|
* @typedef {import('libp2p-interfaces/src/connection').Connection} Connection
|
||||||
* @typedef {import('libp2p-interfaces/src/stream-muxer/types').MuxedStream} MuxedStream
|
* @typedef {import('libp2p-interfaces/src/stream-muxer/types').MuxedStream} MuxedStream
|
||||||
* @typedef {import('../../types').CircuitRequest} CircuitRequest
|
* @typedef {import('../protocol').ICircuitRelay} ICircuitRelay
|
||||||
* @typedef {import('./stream-handler')<CircuitRequest>} StreamHandlerT
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -23,8 +22,8 @@ const { validateAddrs } = require('./utils')
|
|||||||
* @private
|
* @private
|
||||||
* @param {Object} options
|
* @param {Object} options
|
||||||
* @param {Connection} options.connection
|
* @param {Connection} options.connection
|
||||||
* @param {CircuitRequest} options.request - The CircuitRelay protobuf request (unencoded)
|
* @param {ICircuitRelay} options.request - The CircuitRelay protobuf request (unencoded)
|
||||||
* @param {StreamHandlerT} options.streamHandler
|
* @param {StreamHandler} options.streamHandler
|
||||||
* @returns {Promise<MuxedStream>|void} Resolves a duplex iterable
|
* @returns {Promise<MuxedStream>|void} Resolves a duplex iterable
|
||||||
*/
|
*/
|
||||||
module.exports.handleStop = function handleStop ({
|
module.exports.handleStop = function handleStop ({
|
||||||
@ -35,7 +34,7 @@ module.exports.handleStop = function handleStop ({
|
|||||||
// Validate the STOP request has the required input
|
// Validate the STOP request has the required input
|
||||||
try {
|
try {
|
||||||
validateAddrs(request, streamHandler)
|
validateAddrs(request, streamHandler)
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
return log.error('invalid stop request via peer %s', connection.remotePeer.toB58String(), err)
|
return log.error('invalid stop request via peer %s', connection.remotePeer.toB58String(), err)
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -54,7 +53,7 @@ module.exports.handleStop = function handleStop ({
|
|||||||
* @private
|
* @private
|
||||||
* @param {Object} options
|
* @param {Object} options
|
||||||
* @param {Connection} options.connection
|
* @param {Connection} options.connection
|
||||||
* @param {CircuitRequest} options.request - The CircuitRelay protobuf request (unencoded)
|
* @param {ICircuitRelay} options.request - The CircuitRelay protobuf request (unencoded)
|
||||||
* @returns {Promise<MuxedStream|void>} Resolves a duplex iterable
|
* @returns {Promise<MuxedStream|void>} Resolves a duplex iterable
|
||||||
*/
|
*/
|
||||||
module.exports.stop = async function stop ({
|
module.exports.stop = async function stop ({
|
||||||
@ -68,6 +67,10 @@ module.exports.stop = async function stop ({
|
|||||||
streamHandler.write(request)
|
streamHandler.write(request)
|
||||||
const response = await streamHandler.read()
|
const response = await streamHandler.read()
|
||||||
|
|
||||||
|
if (!response) {
|
||||||
|
return streamHandler.close()
|
||||||
|
}
|
||||||
|
|
||||||
if (response.code === CircuitPB.Status.SUCCESS) {
|
if (response.code === CircuitPB.Status.SUCCESS) {
|
||||||
log('stop request to %s was successful', connection.remotePeer.toB58String())
|
log('stop request to %s was successful', connection.remotePeer.toB58String())
|
||||||
return streamHandler.rest()
|
return streamHandler.rest()
|
||||||
|
@ -6,16 +6,15 @@ const log = Object.assign(debug('libp2p:circuit:stream-handler'), {
|
|||||||
})
|
})
|
||||||
|
|
||||||
const lp = require('it-length-prefixed')
|
const lp = require('it-length-prefixed')
|
||||||
|
// @ts-ignore it-handshake does not export types
|
||||||
const handshake = require('it-handshake')
|
const handshake = require('it-handshake')
|
||||||
const { CircuitRelay: CircuitPB } = require('../protocol')
|
const { CircuitRelay } = require('../protocol')
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @typedef {import('libp2p-interfaces/src/stream-muxer/types').MuxedStream} MuxedStream
|
* @typedef {import('libp2p-interfaces/src/stream-muxer/types').MuxedStream} MuxedStream
|
||||||
|
* @typedef {import('../protocol').ICircuitRelay} ICircuitRelay
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
|
||||||
* @template T
|
|
||||||
*/
|
|
||||||
class StreamHandler {
|
class StreamHandler {
|
||||||
/**
|
/**
|
||||||
* Create a stream handler for connection
|
* Create a stream handler for connection
|
||||||
@ -29,6 +28,7 @@ class StreamHandler {
|
|||||||
this.stream = stream
|
this.stream = stream
|
||||||
|
|
||||||
this.shake = handshake(this.stream)
|
this.shake = handshake(this.stream)
|
||||||
|
// @ts-ignore options are not optional
|
||||||
this.decoder = lp.decode.fromReader(this.shake.reader, { maxDataLength: maxLength })
|
this.decoder = lp.decode.fromReader(this.shake.reader, { maxDataLength: maxLength })
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -36,12 +36,11 @@ class StreamHandler {
|
|||||||
* Read and decode message
|
* Read and decode message
|
||||||
*
|
*
|
||||||
* @async
|
* @async
|
||||||
* @returns {Promise<T|undefined>}
|
|
||||||
*/
|
*/
|
||||||
async read () {
|
async read () {
|
||||||
const msg = await this.decoder.next()
|
const msg = await this.decoder.next()
|
||||||
if (msg.value) {
|
if (msg.value) {
|
||||||
const value = CircuitPB.decode(msg.value.slice())
|
const value = CircuitRelay.decode(msg.value.slice())
|
||||||
log('read message type', value.type)
|
log('read message type', value.type)
|
||||||
return value
|
return value
|
||||||
}
|
}
|
||||||
@ -54,13 +53,13 @@ class StreamHandler {
|
|||||||
/**
|
/**
|
||||||
* Encode and write array of buffers
|
* Encode and write array of buffers
|
||||||
*
|
*
|
||||||
* @param {CircuitPB} msg - An unencoded CircuitRelay protobuf message
|
* @param {ICircuitRelay} msg - An unencoded CircuitRelay protobuf message
|
||||||
* @returns {void}
|
* @returns {void}
|
||||||
*/
|
*/
|
||||||
write (msg) {
|
write (msg) {
|
||||||
log('write message type %s', msg.type)
|
log('write message type %s', msg.type)
|
||||||
// @ts-ignore lp.encode expects type type 'Buffer | BufferList', not 'Uint8Array'
|
// @ts-ignore lp.encode expects type type 'Buffer | BufferList', not 'Uint8Array'
|
||||||
this.shake.write(lp.encode.single(CircuitPB.encode(msg)))
|
this.shake.write(lp.encode.single(CircuitRelay.encode(msg).finish()))
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -73,6 +72,9 @@ class StreamHandler {
|
|||||||
return this.shake.stream
|
return this.shake.stream
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @param {ICircuitRelay} msg - An unencoded CircuitRelay protobuf message
|
||||||
|
*/
|
||||||
end (msg) {
|
end (msg) {
|
||||||
this.write(msg)
|
this.write(msg)
|
||||||
this.close()
|
this.close()
|
||||||
|
@ -1,18 +1,18 @@
|
|||||||
'use strict'
|
'use strict'
|
||||||
|
|
||||||
const multiaddr = require('multiaddr')
|
const { Multiaddr } = require('multiaddr')
|
||||||
const { CircuitRelay } = require('../protocol')
|
const { CircuitRelay } = require('../protocol')
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @typedef {import('./stream-handler')} StreamHandler
|
* @typedef {import('./stream-handler')} StreamHandler
|
||||||
* @typedef {import('../../types').CircuitStatus} CircuitStatus
|
* @typedef {import('../protocol').ICircuitRelay} ICircuitRelay
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Write a response
|
* Write a response
|
||||||
*
|
*
|
||||||
* @param {StreamHandler} streamHandler
|
* @param {StreamHandler} streamHandler
|
||||||
* @param {CircuitStatus} status
|
* @param {import('../protocol').CircuitRelay.Status} status
|
||||||
*/
|
*/
|
||||||
function writeResponse (streamHandler, status) {
|
function writeResponse (streamHandler, status) {
|
||||||
streamHandler.write({
|
streamHandler.write({
|
||||||
@ -24,15 +24,17 @@ function writeResponse (streamHandler, status) {
|
|||||||
/**
|
/**
|
||||||
* Validate incomming HOP/STOP message
|
* Validate incomming HOP/STOP message
|
||||||
*
|
*
|
||||||
* @param {*} msg - A CircuitRelay unencoded protobuf message
|
* @param {ICircuitRelay} msg - A CircuitRelay unencoded protobuf message
|
||||||
* @param {StreamHandler} streamHandler
|
* @param {StreamHandler} streamHandler
|
||||||
*/
|
*/
|
||||||
function validateAddrs (msg, streamHandler) {
|
function validateAddrs (msg, streamHandler) {
|
||||||
try {
|
try {
|
||||||
msg.dstPeer.addrs.forEach((addr) => {
|
if (msg.dstPeer && msg.dstPeer.addrs) {
|
||||||
return multiaddr(addr)
|
msg.dstPeer.addrs.forEach((addr) => {
|
||||||
})
|
return new Multiaddr(addr)
|
||||||
} catch (err) {
|
})
|
||||||
|
}
|
||||||
|
} catch (/** @type {any} */ err) {
|
||||||
writeResponse(streamHandler, msg.type === CircuitRelay.Type.HOP
|
writeResponse(streamHandler, msg.type === CircuitRelay.Type.HOP
|
||||||
? CircuitRelay.Status.HOP_DST_MULTIADDR_INVALID
|
? CircuitRelay.Status.HOP_DST_MULTIADDR_INVALID
|
||||||
: CircuitRelay.Status.STOP_DST_MULTIADDR_INVALID)
|
: CircuitRelay.Status.STOP_DST_MULTIADDR_INVALID)
|
||||||
@ -40,10 +42,12 @@ function validateAddrs (msg, streamHandler) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
try {
|
try {
|
||||||
msg.srcPeer.addrs.forEach((addr) => {
|
if (msg.srcPeer && msg.srcPeer.addrs) {
|
||||||
return multiaddr(addr)
|
msg.srcPeer.addrs.forEach((addr) => {
|
||||||
})
|
return new Multiaddr(addr)
|
||||||
} catch (err) {
|
})
|
||||||
|
}
|
||||||
|
} catch (/** @type {any} */ err) {
|
||||||
writeResponse(streamHandler, msg.type === CircuitRelay.Type.HOP
|
writeResponse(streamHandler, msg.type === CircuitRelay.Type.HOP
|
||||||
? CircuitRelay.Status.HOP_SRC_MULTIADDR_INVALID
|
? CircuitRelay.Status.HOP_SRC_MULTIADDR_INVALID
|
||||||
: CircuitRelay.Status.STOP_SRC_MULTIADDR_INVALID)
|
: CircuitRelay.Status.STOP_SRC_MULTIADDR_INVALID)
|
||||||
|
@ -8,13 +8,12 @@ const log = Object.assign(debug('libp2p:relay'), {
|
|||||||
const {
|
const {
|
||||||
setDelayedInterval,
|
setDelayedInterval,
|
||||||
clearDelayedInterval
|
clearDelayedInterval
|
||||||
|
// @ts-ignore set-delayed-interval does not export types
|
||||||
} = require('set-delayed-interval')
|
} = require('set-delayed-interval')
|
||||||
|
|
||||||
const AutoRelay = require('./auto-relay')
|
const AutoRelay = require('./auto-relay')
|
||||||
const { namespaceToCid } = require('./utils')
|
const { namespaceToCid } = require('./utils')
|
||||||
const {
|
const {
|
||||||
ADVERTISE_BOOT_DELAY,
|
|
||||||
ADVERTISE_TTL,
|
|
||||||
RELAY_RENDEZVOUS_NS
|
RELAY_RENDEZVOUS_NS
|
||||||
} = require('./constants')
|
} = require('./constants')
|
||||||
|
|
||||||
@ -45,12 +44,6 @@ class Relay {
|
|||||||
constructor (libp2p) {
|
constructor (libp2p) {
|
||||||
this._libp2p = libp2p
|
this._libp2p = libp2p
|
||||||
this._options = {
|
this._options = {
|
||||||
advertise: {
|
|
||||||
bootDelay: ADVERTISE_BOOT_DELAY,
|
|
||||||
enabled: true,
|
|
||||||
ttl: ADVERTISE_TTL,
|
|
||||||
...libp2p._config.relay.advertise
|
|
||||||
},
|
|
||||||
...libp2p._config.relay
|
...libp2p._config.relay
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -94,7 +87,7 @@ class Relay {
|
|||||||
try {
|
try {
|
||||||
const cid = await namespaceToCid(RELAY_RENDEZVOUS_NS)
|
const cid = await namespaceToCid(RELAY_RENDEZVOUS_NS)
|
||||||
await this._libp2p.contentRouting.provide(cid)
|
await this._libp2p.contentRouting.provide(cid)
|
||||||
} catch (err) {
|
} catch (/** @type {any} */ err) {
|
||||||
if (err.code === 'NO_ROUTERS_AVAILABLE') {
|
if (err.code === 'NO_ROUTERS_AVAILABLE') {
|
||||||
log.error('a content router, such as a DHT, must be provided in order to advertise the relay service', err)
|
log.error('a content router, such as a DHT, must be provided in order to advertise the relay service', err)
|
||||||
// Stop the advertise
|
// Stop the advertise
|
||||||
|
@ -1,10 +1,9 @@
|
|||||||
'use strict'
|
'use strict'
|
||||||
|
|
||||||
const { EventEmitter } = require('events')
|
const { EventEmitter } = require('events')
|
||||||
const multiaddr = require('multiaddr')
|
const { Multiaddr } = require('multiaddr')
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @typedef {import('multiaddr')} Multiaddr
|
|
||||||
* @typedef {import('libp2p-interfaces/src/transport/types').Listener} Listener
|
* @typedef {import('libp2p-interfaces/src/transport/types').Listener} Listener
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@ -24,7 +23,7 @@ module.exports = (libp2p) => {
|
|||||||
async function listen (addr) {
|
async function listen (addr) {
|
||||||
const addrString = String(addr).split('/p2p-circuit').find(a => a !== '')
|
const addrString = String(addr).split('/p2p-circuit').find(a => a !== '')
|
||||||
|
|
||||||
const relayConn = await libp2p.dial(multiaddr(addrString))
|
const relayConn = await libp2p.dial(new Multiaddr(addrString))
|
||||||
const relayedAddr = relayConn.remoteAddr.encapsulate('/p2p-circuit')
|
const relayedAddr = relayConn.remoteAddr.encapsulate('/p2p-circuit')
|
||||||
|
|
||||||
listeningAddrs.set(relayConn.remotePeer.toB58String(), relayedAddr)
|
listeningAddrs.set(relayConn.remotePeer.toB58String(), relayedAddr)
|
||||||
|
173
src/circuit/protocol/index.d.ts
vendored
Normal file
173
src/circuit/protocol/index.d.ts
vendored
Normal file
@ -0,0 +1,173 @@
|
|||||||
|
import * as $protobuf from "protobufjs";
|
||||||
|
/** Properties of a CircuitRelay. */
|
||||||
|
export interface ICircuitRelay {
|
||||||
|
|
||||||
|
/** CircuitRelay type */
|
||||||
|
type?: (CircuitRelay.Type|null);
|
||||||
|
|
||||||
|
/** CircuitRelay srcPeer */
|
||||||
|
srcPeer?: (CircuitRelay.IPeer|null);
|
||||||
|
|
||||||
|
/** CircuitRelay dstPeer */
|
||||||
|
dstPeer?: (CircuitRelay.IPeer|null);
|
||||||
|
|
||||||
|
/** CircuitRelay code */
|
||||||
|
code?: (CircuitRelay.Status|null);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Represents a CircuitRelay. */
|
||||||
|
export class CircuitRelay implements ICircuitRelay {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new CircuitRelay.
|
||||||
|
* @param [p] Properties to set
|
||||||
|
*/
|
||||||
|
constructor(p?: ICircuitRelay);
|
||||||
|
|
||||||
|
/** CircuitRelay type. */
|
||||||
|
public type: CircuitRelay.Type;
|
||||||
|
|
||||||
|
/** CircuitRelay srcPeer. */
|
||||||
|
public srcPeer?: (CircuitRelay.IPeer|null);
|
||||||
|
|
||||||
|
/** CircuitRelay dstPeer. */
|
||||||
|
public dstPeer?: (CircuitRelay.IPeer|null);
|
||||||
|
|
||||||
|
/** CircuitRelay code. */
|
||||||
|
public code: CircuitRelay.Status;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Encodes the specified CircuitRelay message. Does not implicitly {@link CircuitRelay.verify|verify} messages.
|
||||||
|
* @param m CircuitRelay message or plain object to encode
|
||||||
|
* @param [w] Writer to encode to
|
||||||
|
* @returns Writer
|
||||||
|
*/
|
||||||
|
public static encode(m: ICircuitRelay, w?: $protobuf.Writer): $protobuf.Writer;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Decodes a CircuitRelay message from the specified reader or buffer.
|
||||||
|
* @param r Reader or buffer to decode from
|
||||||
|
* @param [l] Message length if known beforehand
|
||||||
|
* @returns CircuitRelay
|
||||||
|
* @throws {Error} If the payload is not a reader or valid buffer
|
||||||
|
* @throws {$protobuf.util.ProtocolError} If required fields are missing
|
||||||
|
*/
|
||||||
|
public static decode(r: ($protobuf.Reader|Uint8Array), l?: number): CircuitRelay;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a CircuitRelay message from a plain object. Also converts values to their respective internal types.
|
||||||
|
* @param d Plain object
|
||||||
|
* @returns CircuitRelay
|
||||||
|
*/
|
||||||
|
public static fromObject(d: { [k: string]: any }): CircuitRelay;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a plain object from a CircuitRelay message. Also converts values to other types if specified.
|
||||||
|
* @param m CircuitRelay
|
||||||
|
* @param [o] Conversion options
|
||||||
|
* @returns Plain object
|
||||||
|
*/
|
||||||
|
public static toObject(m: CircuitRelay, o?: $protobuf.IConversionOptions): { [k: string]: any };
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts this CircuitRelay to JSON.
|
||||||
|
* @returns JSON object
|
||||||
|
*/
|
||||||
|
public toJSON(): { [k: string]: any };
|
||||||
|
}
|
||||||
|
|
||||||
|
export namespace CircuitRelay {
|
||||||
|
|
||||||
|
/** Status enum. */
|
||||||
|
enum Status {
|
||||||
|
SUCCESS = 100,
|
||||||
|
HOP_SRC_ADDR_TOO_LONG = 220,
|
||||||
|
HOP_DST_ADDR_TOO_LONG = 221,
|
||||||
|
HOP_SRC_MULTIADDR_INVALID = 250,
|
||||||
|
HOP_DST_MULTIADDR_INVALID = 251,
|
||||||
|
HOP_NO_CONN_TO_DST = 260,
|
||||||
|
HOP_CANT_DIAL_DST = 261,
|
||||||
|
HOP_CANT_OPEN_DST_STREAM = 262,
|
||||||
|
HOP_CANT_SPEAK_RELAY = 270,
|
||||||
|
HOP_CANT_RELAY_TO_SELF = 280,
|
||||||
|
STOP_SRC_ADDR_TOO_LONG = 320,
|
||||||
|
STOP_DST_ADDR_TOO_LONG = 321,
|
||||||
|
STOP_SRC_MULTIADDR_INVALID = 350,
|
||||||
|
STOP_DST_MULTIADDR_INVALID = 351,
|
||||||
|
STOP_RELAY_REFUSED = 390,
|
||||||
|
MALFORMED_MESSAGE = 400
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Type enum. */
|
||||||
|
enum Type {
|
||||||
|
HOP = 1,
|
||||||
|
STOP = 2,
|
||||||
|
STATUS = 3,
|
||||||
|
CAN_HOP = 4
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Properties of a Peer. */
|
||||||
|
interface IPeer {
|
||||||
|
|
||||||
|
/** Peer id */
|
||||||
|
id: Uint8Array;
|
||||||
|
|
||||||
|
/** Peer addrs */
|
||||||
|
addrs?: (Uint8Array[]|null);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Represents a Peer. */
|
||||||
|
class Peer implements IPeer {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new Peer.
|
||||||
|
* @param [p] Properties to set
|
||||||
|
*/
|
||||||
|
constructor(p?: CircuitRelay.IPeer);
|
||||||
|
|
||||||
|
/** Peer id. */
|
||||||
|
public id: Uint8Array;
|
||||||
|
|
||||||
|
/** Peer addrs. */
|
||||||
|
public addrs: Uint8Array[];
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Encodes the specified Peer message. Does not implicitly {@link CircuitRelay.Peer.verify|verify} messages.
|
||||||
|
* @param m Peer message or plain object to encode
|
||||||
|
* @param [w] Writer to encode to
|
||||||
|
* @returns Writer
|
||||||
|
*/
|
||||||
|
public static encode(m: CircuitRelay.IPeer, w?: $protobuf.Writer): $protobuf.Writer;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Decodes a Peer message from the specified reader or buffer.
|
||||||
|
* @param r Reader or buffer to decode from
|
||||||
|
* @param [l] Message length if known beforehand
|
||||||
|
* @returns Peer
|
||||||
|
* @throws {Error} If the payload is not a reader or valid buffer
|
||||||
|
* @throws {$protobuf.util.ProtocolError} If required fields are missing
|
||||||
|
*/
|
||||||
|
public static decode(r: ($protobuf.Reader|Uint8Array), l?: number): CircuitRelay.Peer;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a Peer message from a plain object. Also converts values to their respective internal types.
|
||||||
|
* @param d Plain object
|
||||||
|
* @returns Peer
|
||||||
|
*/
|
||||||
|
public static fromObject(d: { [k: string]: any }): CircuitRelay.Peer;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a plain object from a Peer message. Also converts values to other types if specified.
|
||||||
|
* @param m Peer
|
||||||
|
* @param [o] Conversion options
|
||||||
|
* @returns Plain object
|
||||||
|
*/
|
||||||
|
public static toObject(m: CircuitRelay.Peer, o?: $protobuf.IConversionOptions): { [k: string]: any };
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts this Peer to JSON.
|
||||||
|
* @returns JSON object
|
||||||
|
*/
|
||||||
|
public toJSON(): { [k: string]: any };
|
||||||
|
}
|
||||||
|
}
|
@ -1,46 +1,530 @@
|
|||||||
'use strict'
|
/*eslint-disable*/
|
||||||
const protobuf = require('protons')
|
"use strict";
|
||||||
|
|
||||||
/** @type {{CircuitRelay: import('../../types').CircuitMessageProto}} */
|
var $protobuf = require("protobufjs/minimal");
|
||||||
module.exports = protobuf(`
|
|
||||||
message CircuitRelay {
|
|
||||||
|
|
||||||
enum Status {
|
// Common aliases
|
||||||
SUCCESS = 100;
|
var $Reader = $protobuf.Reader, $Writer = $protobuf.Writer, $util = $protobuf.util;
|
||||||
HOP_SRC_ADDR_TOO_LONG = 220;
|
|
||||||
HOP_DST_ADDR_TOO_LONG = 221;
|
|
||||||
HOP_SRC_MULTIADDR_INVALID = 250;
|
|
||||||
HOP_DST_MULTIADDR_INVALID = 251;
|
|
||||||
HOP_NO_CONN_TO_DST = 260;
|
|
||||||
HOP_CANT_DIAL_DST = 261;
|
|
||||||
HOP_CANT_OPEN_DST_STREAM = 262;
|
|
||||||
HOP_CANT_SPEAK_RELAY = 270;
|
|
||||||
HOP_CANT_RELAY_TO_SELF = 280;
|
|
||||||
STOP_SRC_ADDR_TOO_LONG = 320;
|
|
||||||
STOP_DST_ADDR_TOO_LONG = 321;
|
|
||||||
STOP_SRC_MULTIADDR_INVALID = 350;
|
|
||||||
STOP_DST_MULTIADDR_INVALID = 351;
|
|
||||||
STOP_RELAY_REFUSED = 390;
|
|
||||||
MALFORMED_MESSAGE = 400;
|
|
||||||
}
|
|
||||||
|
|
||||||
enum Type { // RPC identifier, either HOP, STOP or STATUS
|
// Exported root namespace
|
||||||
HOP = 1;
|
var $root = $protobuf.roots["libp2p-circuit"] || ($protobuf.roots["libp2p-circuit"] = {});
|
||||||
STOP = 2;
|
|
||||||
STATUS = 3;
|
|
||||||
CAN_HOP = 4;
|
|
||||||
}
|
|
||||||
|
|
||||||
message Peer {
|
$root.CircuitRelay = (function() {
|
||||||
required bytes id = 1; // peer id
|
|
||||||
repeated bytes addrs = 2; // peer's known addresses
|
|
||||||
}
|
|
||||||
|
|
||||||
optional Type type = 1; // Type of the message
|
/**
|
||||||
|
* Properties of a CircuitRelay.
|
||||||
|
* @exports ICircuitRelay
|
||||||
|
* @interface ICircuitRelay
|
||||||
|
* @property {CircuitRelay.Type|null} [type] CircuitRelay type
|
||||||
|
* @property {CircuitRelay.IPeer|null} [srcPeer] CircuitRelay srcPeer
|
||||||
|
* @property {CircuitRelay.IPeer|null} [dstPeer] CircuitRelay dstPeer
|
||||||
|
* @property {CircuitRelay.Status|null} [code] CircuitRelay code
|
||||||
|
*/
|
||||||
|
|
||||||
optional Peer srcPeer = 2; // srcPeer and dstPeer are used when Type is HOP or STATUS
|
/**
|
||||||
optional Peer dstPeer = 3;
|
* Constructs a new CircuitRelay.
|
||||||
|
* @exports CircuitRelay
|
||||||
|
* @classdesc Represents a CircuitRelay.
|
||||||
|
* @implements ICircuitRelay
|
||||||
|
* @constructor
|
||||||
|
* @param {ICircuitRelay=} [p] Properties to set
|
||||||
|
*/
|
||||||
|
function CircuitRelay(p) {
|
||||||
|
if (p)
|
||||||
|
for (var ks = Object.keys(p), i = 0; i < ks.length; ++i)
|
||||||
|
if (p[ks[i]] != null)
|
||||||
|
this[ks[i]] = p[ks[i]];
|
||||||
|
}
|
||||||
|
|
||||||
optional Status code = 4; // Status code, used when Type is STATUS
|
/**
|
||||||
}
|
* CircuitRelay type.
|
||||||
`)
|
* @member {CircuitRelay.Type} type
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @instance
|
||||||
|
*/
|
||||||
|
CircuitRelay.prototype.type = 1;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* CircuitRelay srcPeer.
|
||||||
|
* @member {CircuitRelay.IPeer|null|undefined} srcPeer
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @instance
|
||||||
|
*/
|
||||||
|
CircuitRelay.prototype.srcPeer = null;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* CircuitRelay dstPeer.
|
||||||
|
* @member {CircuitRelay.IPeer|null|undefined} dstPeer
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @instance
|
||||||
|
*/
|
||||||
|
CircuitRelay.prototype.dstPeer = null;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* CircuitRelay code.
|
||||||
|
* @member {CircuitRelay.Status} code
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @instance
|
||||||
|
*/
|
||||||
|
CircuitRelay.prototype.code = 100;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Encodes the specified CircuitRelay message. Does not implicitly {@link CircuitRelay.verify|verify} messages.
|
||||||
|
* @function encode
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @static
|
||||||
|
* @param {ICircuitRelay} m CircuitRelay message or plain object to encode
|
||||||
|
* @param {$protobuf.Writer} [w] Writer to encode to
|
||||||
|
* @returns {$protobuf.Writer} Writer
|
||||||
|
*/
|
||||||
|
CircuitRelay.encode = function encode(m, w) {
|
||||||
|
if (!w)
|
||||||
|
w = $Writer.create();
|
||||||
|
if (m.type != null && Object.hasOwnProperty.call(m, "type"))
|
||||||
|
w.uint32(8).int32(m.type);
|
||||||
|
if (m.srcPeer != null && Object.hasOwnProperty.call(m, "srcPeer"))
|
||||||
|
$root.CircuitRelay.Peer.encode(m.srcPeer, w.uint32(18).fork()).ldelim();
|
||||||
|
if (m.dstPeer != null && Object.hasOwnProperty.call(m, "dstPeer"))
|
||||||
|
$root.CircuitRelay.Peer.encode(m.dstPeer, w.uint32(26).fork()).ldelim();
|
||||||
|
if (m.code != null && Object.hasOwnProperty.call(m, "code"))
|
||||||
|
w.uint32(32).int32(m.code);
|
||||||
|
return w;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Decodes a CircuitRelay message from the specified reader or buffer.
|
||||||
|
* @function decode
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @static
|
||||||
|
* @param {$protobuf.Reader|Uint8Array} r Reader or buffer to decode from
|
||||||
|
* @param {number} [l] Message length if known beforehand
|
||||||
|
* @returns {CircuitRelay} CircuitRelay
|
||||||
|
* @throws {Error} If the payload is not a reader or valid buffer
|
||||||
|
* @throws {$protobuf.util.ProtocolError} If required fields are missing
|
||||||
|
*/
|
||||||
|
CircuitRelay.decode = function decode(r, l) {
|
||||||
|
if (!(r instanceof $Reader))
|
||||||
|
r = $Reader.create(r);
|
||||||
|
var c = l === undefined ? r.len : r.pos + l, m = new $root.CircuitRelay();
|
||||||
|
while (r.pos < c) {
|
||||||
|
var t = r.uint32();
|
||||||
|
switch (t >>> 3) {
|
||||||
|
case 1:
|
||||||
|
m.type = r.int32();
|
||||||
|
break;
|
||||||
|
case 2:
|
||||||
|
m.srcPeer = $root.CircuitRelay.Peer.decode(r, r.uint32());
|
||||||
|
break;
|
||||||
|
case 3:
|
||||||
|
m.dstPeer = $root.CircuitRelay.Peer.decode(r, r.uint32());
|
||||||
|
break;
|
||||||
|
case 4:
|
||||||
|
m.code = r.int32();
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
r.skipType(t & 7);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return m;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a CircuitRelay message from a plain object. Also converts values to their respective internal types.
|
||||||
|
* @function fromObject
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @static
|
||||||
|
* @param {Object.<string,*>} d Plain object
|
||||||
|
* @returns {CircuitRelay} CircuitRelay
|
||||||
|
*/
|
||||||
|
CircuitRelay.fromObject = function fromObject(d) {
|
||||||
|
if (d instanceof $root.CircuitRelay)
|
||||||
|
return d;
|
||||||
|
var m = new $root.CircuitRelay();
|
||||||
|
switch (d.type) {
|
||||||
|
case "HOP":
|
||||||
|
case 1:
|
||||||
|
m.type = 1;
|
||||||
|
break;
|
||||||
|
case "STOP":
|
||||||
|
case 2:
|
||||||
|
m.type = 2;
|
||||||
|
break;
|
||||||
|
case "STATUS":
|
||||||
|
case 3:
|
||||||
|
m.type = 3;
|
||||||
|
break;
|
||||||
|
case "CAN_HOP":
|
||||||
|
case 4:
|
||||||
|
m.type = 4;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
if (d.srcPeer != null) {
|
||||||
|
if (typeof d.srcPeer !== "object")
|
||||||
|
throw TypeError(".CircuitRelay.srcPeer: object expected");
|
||||||
|
m.srcPeer = $root.CircuitRelay.Peer.fromObject(d.srcPeer);
|
||||||
|
}
|
||||||
|
if (d.dstPeer != null) {
|
||||||
|
if (typeof d.dstPeer !== "object")
|
||||||
|
throw TypeError(".CircuitRelay.dstPeer: object expected");
|
||||||
|
m.dstPeer = $root.CircuitRelay.Peer.fromObject(d.dstPeer);
|
||||||
|
}
|
||||||
|
switch (d.code) {
|
||||||
|
case "SUCCESS":
|
||||||
|
case 100:
|
||||||
|
m.code = 100;
|
||||||
|
break;
|
||||||
|
case "HOP_SRC_ADDR_TOO_LONG":
|
||||||
|
case 220:
|
||||||
|
m.code = 220;
|
||||||
|
break;
|
||||||
|
case "HOP_DST_ADDR_TOO_LONG":
|
||||||
|
case 221:
|
||||||
|
m.code = 221;
|
||||||
|
break;
|
||||||
|
case "HOP_SRC_MULTIADDR_INVALID":
|
||||||
|
case 250:
|
||||||
|
m.code = 250;
|
||||||
|
break;
|
||||||
|
case "HOP_DST_MULTIADDR_INVALID":
|
||||||
|
case 251:
|
||||||
|
m.code = 251;
|
||||||
|
break;
|
||||||
|
case "HOP_NO_CONN_TO_DST":
|
||||||
|
case 260:
|
||||||
|
m.code = 260;
|
||||||
|
break;
|
||||||
|
case "HOP_CANT_DIAL_DST":
|
||||||
|
case 261:
|
||||||
|
m.code = 261;
|
||||||
|
break;
|
||||||
|
case "HOP_CANT_OPEN_DST_STREAM":
|
||||||
|
case 262:
|
||||||
|
m.code = 262;
|
||||||
|
break;
|
||||||
|
case "HOP_CANT_SPEAK_RELAY":
|
||||||
|
case 270:
|
||||||
|
m.code = 270;
|
||||||
|
break;
|
||||||
|
case "HOP_CANT_RELAY_TO_SELF":
|
||||||
|
case 280:
|
||||||
|
m.code = 280;
|
||||||
|
break;
|
||||||
|
case "STOP_SRC_ADDR_TOO_LONG":
|
||||||
|
case 320:
|
||||||
|
m.code = 320;
|
||||||
|
break;
|
||||||
|
case "STOP_DST_ADDR_TOO_LONG":
|
||||||
|
case 321:
|
||||||
|
m.code = 321;
|
||||||
|
break;
|
||||||
|
case "STOP_SRC_MULTIADDR_INVALID":
|
||||||
|
case 350:
|
||||||
|
m.code = 350;
|
||||||
|
break;
|
||||||
|
case "STOP_DST_MULTIADDR_INVALID":
|
||||||
|
case 351:
|
||||||
|
m.code = 351;
|
||||||
|
break;
|
||||||
|
case "STOP_RELAY_REFUSED":
|
||||||
|
case 390:
|
||||||
|
m.code = 390;
|
||||||
|
break;
|
||||||
|
case "MALFORMED_MESSAGE":
|
||||||
|
case 400:
|
||||||
|
m.code = 400;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
return m;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a plain object from a CircuitRelay message. Also converts values to other types if specified.
|
||||||
|
* @function toObject
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @static
|
||||||
|
* @param {CircuitRelay} m CircuitRelay
|
||||||
|
* @param {$protobuf.IConversionOptions} [o] Conversion options
|
||||||
|
* @returns {Object.<string,*>} Plain object
|
||||||
|
*/
|
||||||
|
CircuitRelay.toObject = function toObject(m, o) {
|
||||||
|
if (!o)
|
||||||
|
o = {};
|
||||||
|
var d = {};
|
||||||
|
if (o.defaults) {
|
||||||
|
d.type = o.enums === String ? "HOP" : 1;
|
||||||
|
d.srcPeer = null;
|
||||||
|
d.dstPeer = null;
|
||||||
|
d.code = o.enums === String ? "SUCCESS" : 100;
|
||||||
|
}
|
||||||
|
if (m.type != null && m.hasOwnProperty("type")) {
|
||||||
|
d.type = o.enums === String ? $root.CircuitRelay.Type[m.type] : m.type;
|
||||||
|
}
|
||||||
|
if (m.srcPeer != null && m.hasOwnProperty("srcPeer")) {
|
||||||
|
d.srcPeer = $root.CircuitRelay.Peer.toObject(m.srcPeer, o);
|
||||||
|
}
|
||||||
|
if (m.dstPeer != null && m.hasOwnProperty("dstPeer")) {
|
||||||
|
d.dstPeer = $root.CircuitRelay.Peer.toObject(m.dstPeer, o);
|
||||||
|
}
|
||||||
|
if (m.code != null && m.hasOwnProperty("code")) {
|
||||||
|
d.code = o.enums === String ? $root.CircuitRelay.Status[m.code] : m.code;
|
||||||
|
}
|
||||||
|
return d;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts this CircuitRelay to JSON.
|
||||||
|
* @function toJSON
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @instance
|
||||||
|
* @returns {Object.<string,*>} JSON object
|
||||||
|
*/
|
||||||
|
CircuitRelay.prototype.toJSON = function toJSON() {
|
||||||
|
return this.constructor.toObject(this, $protobuf.util.toJSONOptions);
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Status enum.
|
||||||
|
* @name CircuitRelay.Status
|
||||||
|
* @enum {number}
|
||||||
|
* @property {number} SUCCESS=100 SUCCESS value
|
||||||
|
* @property {number} HOP_SRC_ADDR_TOO_LONG=220 HOP_SRC_ADDR_TOO_LONG value
|
||||||
|
* @property {number} HOP_DST_ADDR_TOO_LONG=221 HOP_DST_ADDR_TOO_LONG value
|
||||||
|
* @property {number} HOP_SRC_MULTIADDR_INVALID=250 HOP_SRC_MULTIADDR_INVALID value
|
||||||
|
* @property {number} HOP_DST_MULTIADDR_INVALID=251 HOP_DST_MULTIADDR_INVALID value
|
||||||
|
* @property {number} HOP_NO_CONN_TO_DST=260 HOP_NO_CONN_TO_DST value
|
||||||
|
* @property {number} HOP_CANT_DIAL_DST=261 HOP_CANT_DIAL_DST value
|
||||||
|
* @property {number} HOP_CANT_OPEN_DST_STREAM=262 HOP_CANT_OPEN_DST_STREAM value
|
||||||
|
* @property {number} HOP_CANT_SPEAK_RELAY=270 HOP_CANT_SPEAK_RELAY value
|
||||||
|
* @property {number} HOP_CANT_RELAY_TO_SELF=280 HOP_CANT_RELAY_TO_SELF value
|
||||||
|
* @property {number} STOP_SRC_ADDR_TOO_LONG=320 STOP_SRC_ADDR_TOO_LONG value
|
||||||
|
* @property {number} STOP_DST_ADDR_TOO_LONG=321 STOP_DST_ADDR_TOO_LONG value
|
||||||
|
* @property {number} STOP_SRC_MULTIADDR_INVALID=350 STOP_SRC_MULTIADDR_INVALID value
|
||||||
|
* @property {number} STOP_DST_MULTIADDR_INVALID=351 STOP_DST_MULTIADDR_INVALID value
|
||||||
|
* @property {number} STOP_RELAY_REFUSED=390 STOP_RELAY_REFUSED value
|
||||||
|
* @property {number} MALFORMED_MESSAGE=400 MALFORMED_MESSAGE value
|
||||||
|
*/
|
||||||
|
CircuitRelay.Status = (function() {
|
||||||
|
var valuesById = {}, values = Object.create(valuesById);
|
||||||
|
values[valuesById[100] = "SUCCESS"] = 100;
|
||||||
|
values[valuesById[220] = "HOP_SRC_ADDR_TOO_LONG"] = 220;
|
||||||
|
values[valuesById[221] = "HOP_DST_ADDR_TOO_LONG"] = 221;
|
||||||
|
values[valuesById[250] = "HOP_SRC_MULTIADDR_INVALID"] = 250;
|
||||||
|
values[valuesById[251] = "HOP_DST_MULTIADDR_INVALID"] = 251;
|
||||||
|
values[valuesById[260] = "HOP_NO_CONN_TO_DST"] = 260;
|
||||||
|
values[valuesById[261] = "HOP_CANT_DIAL_DST"] = 261;
|
||||||
|
values[valuesById[262] = "HOP_CANT_OPEN_DST_STREAM"] = 262;
|
||||||
|
values[valuesById[270] = "HOP_CANT_SPEAK_RELAY"] = 270;
|
||||||
|
values[valuesById[280] = "HOP_CANT_RELAY_TO_SELF"] = 280;
|
||||||
|
values[valuesById[320] = "STOP_SRC_ADDR_TOO_LONG"] = 320;
|
||||||
|
values[valuesById[321] = "STOP_DST_ADDR_TOO_LONG"] = 321;
|
||||||
|
values[valuesById[350] = "STOP_SRC_MULTIADDR_INVALID"] = 350;
|
||||||
|
values[valuesById[351] = "STOP_DST_MULTIADDR_INVALID"] = 351;
|
||||||
|
values[valuesById[390] = "STOP_RELAY_REFUSED"] = 390;
|
||||||
|
values[valuesById[400] = "MALFORMED_MESSAGE"] = 400;
|
||||||
|
return values;
|
||||||
|
})();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Type enum.
|
||||||
|
* @name CircuitRelay.Type
|
||||||
|
* @enum {number}
|
||||||
|
* @property {number} HOP=1 HOP value
|
||||||
|
* @property {number} STOP=2 STOP value
|
||||||
|
* @property {number} STATUS=3 STATUS value
|
||||||
|
* @property {number} CAN_HOP=4 CAN_HOP value
|
||||||
|
*/
|
||||||
|
CircuitRelay.Type = (function() {
|
||||||
|
var valuesById = {}, values = Object.create(valuesById);
|
||||||
|
values[valuesById[1] = "HOP"] = 1;
|
||||||
|
values[valuesById[2] = "STOP"] = 2;
|
||||||
|
values[valuesById[3] = "STATUS"] = 3;
|
||||||
|
values[valuesById[4] = "CAN_HOP"] = 4;
|
||||||
|
return values;
|
||||||
|
})();
|
||||||
|
|
||||||
|
CircuitRelay.Peer = (function() {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Properties of a Peer.
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @interface IPeer
|
||||||
|
* @property {Uint8Array} id Peer id
|
||||||
|
* @property {Array.<Uint8Array>|null} [addrs] Peer addrs
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Constructs a new Peer.
|
||||||
|
* @memberof CircuitRelay
|
||||||
|
* @classdesc Represents a Peer.
|
||||||
|
* @implements IPeer
|
||||||
|
* @constructor
|
||||||
|
* @param {CircuitRelay.IPeer=} [p] Properties to set
|
||||||
|
*/
|
||||||
|
function Peer(p) {
|
||||||
|
this.addrs = [];
|
||||||
|
if (p)
|
||||||
|
for (var ks = Object.keys(p), i = 0; i < ks.length; ++i)
|
||||||
|
if (p[ks[i]] != null)
|
||||||
|
this[ks[i]] = p[ks[i]];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Peer id.
|
||||||
|
* @member {Uint8Array} id
|
||||||
|
* @memberof CircuitRelay.Peer
|
||||||
|
* @instance
|
||||||
|
*/
|
||||||
|
Peer.prototype.id = $util.newBuffer([]);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Peer addrs.
|
||||||
|
* @member {Array.<Uint8Array>} addrs
|
||||||
|
* @memberof CircuitRelay.Peer
|
||||||
|
* @instance
|
||||||
|
*/
|
||||||
|
Peer.prototype.addrs = $util.emptyArray;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Encodes the specified Peer message. Does not implicitly {@link CircuitRelay.Peer.verify|verify} messages.
|
||||||
|
* @function encode
|
||||||
|
* @memberof CircuitRelay.Peer
|
||||||
|
* @static
|
||||||
|
* @param {CircuitRelay.IPeer} m Peer message or plain object to encode
|
||||||
|
* @param {$protobuf.Writer} [w] Writer to encode to
|
||||||
|
* @returns {$protobuf.Writer} Writer
|
||||||
|
*/
|
||||||
|
Peer.encode = function encode(m, w) {
|
||||||
|
if (!w)
|
||||||
|
w = $Writer.create();
|
||||||
|
w.uint32(10).bytes(m.id);
|
||||||
|
if (m.addrs != null && m.addrs.length) {
|
||||||
|
for (var i = 0; i < m.addrs.length; ++i)
|
||||||
|
w.uint32(18).bytes(m.addrs[i]);
|
||||||
|
}
|
||||||
|
return w;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Decodes a Peer message from the specified reader or buffer.
|
||||||
|
* @function decode
|
||||||
|
* @memberof CircuitRelay.Peer
|
||||||
|
* @static
|
||||||
|
* @param {$protobuf.Reader|Uint8Array} r Reader or buffer to decode from
|
||||||
|
* @param {number} [l] Message length if known beforehand
|
||||||
|
* @returns {CircuitRelay.Peer} Peer
|
||||||
|
* @throws {Error} If the payload is not a reader or valid buffer
|
||||||
|
* @throws {$protobuf.util.ProtocolError} If required fields are missing
|
||||||
|
*/
|
||||||
|
Peer.decode = function decode(r, l) {
|
||||||
|
if (!(r instanceof $Reader))
|
||||||
|
r = $Reader.create(r);
|
||||||
|
var c = l === undefined ? r.len : r.pos + l, m = new $root.CircuitRelay.Peer();
|
||||||
|
while (r.pos < c) {
|
||||||
|
var t = r.uint32();
|
||||||
|
switch (t >>> 3) {
|
||||||
|
case 1:
|
||||||
|
m.id = r.bytes();
|
||||||
|
break;
|
||||||
|
case 2:
|
||||||
|
if (!(m.addrs && m.addrs.length))
|
||||||
|
m.addrs = [];
|
||||||
|
m.addrs.push(r.bytes());
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
r.skipType(t & 7);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (!m.hasOwnProperty("id"))
|
||||||
|
throw $util.ProtocolError("missing required 'id'", { instance: m });
|
||||||
|
return m;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a Peer message from a plain object. Also converts values to their respective internal types.
|
||||||
|
* @function fromObject
|
||||||
|
* @memberof CircuitRelay.Peer
|
||||||
|
* @static
|
||||||
|
* @param {Object.<string,*>} d Plain object
|
||||||
|
* @returns {CircuitRelay.Peer} Peer
|
||||||
|
*/
|
||||||
|
Peer.fromObject = function fromObject(d) {
|
||||||
|
if (d instanceof $root.CircuitRelay.Peer)
|
||||||
|
return d;
|
||||||
|
var m = new $root.CircuitRelay.Peer();
|
||||||
|
if (d.id != null) {
|
||||||
|
if (typeof d.id === "string")
|
||||||
|
$util.base64.decode(d.id, m.id = $util.newBuffer($util.base64.length(d.id)), 0);
|
||||||
|
else if (d.id.length)
|
||||||
|
m.id = d.id;
|
||||||
|
}
|
||||||
|
if (d.addrs) {
|
||||||
|
if (!Array.isArray(d.addrs))
|
||||||
|
throw TypeError(".CircuitRelay.Peer.addrs: array expected");
|
||||||
|
m.addrs = [];
|
||||||
|
for (var i = 0; i < d.addrs.length; ++i) {
|
||||||
|
if (typeof d.addrs[i] === "string")
|
||||||
|
$util.base64.decode(d.addrs[i], m.addrs[i] = $util.newBuffer($util.base64.length(d.addrs[i])), 0);
|
||||||
|
else if (d.addrs[i].length)
|
||||||
|
m.addrs[i] = d.addrs[i];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return m;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates a plain object from a Peer message. Also converts values to other types if specified.
|
||||||
|
* @function toObject
|
||||||
|
* @memberof CircuitRelay.Peer
|
||||||
|
* @static
|
||||||
|
* @param {CircuitRelay.Peer} m Peer
|
||||||
|
* @param {$protobuf.IConversionOptions} [o] Conversion options
|
||||||
|
* @returns {Object.<string,*>} Plain object
|
||||||
|
*/
|
||||||
|
Peer.toObject = function toObject(m, o) {
|
||||||
|
if (!o)
|
||||||
|
o = {};
|
||||||
|
var d = {};
|
||||||
|
if (o.arrays || o.defaults) {
|
||||||
|
d.addrs = [];
|
||||||
|
}
|
||||||
|
if (o.defaults) {
|
||||||
|
if (o.bytes === String)
|
||||||
|
d.id = "";
|
||||||
|
else {
|
||||||
|
d.id = [];
|
||||||
|
if (o.bytes !== Array)
|
||||||
|
d.id = $util.newBuffer(d.id);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (m.id != null && m.hasOwnProperty("id")) {
|
||||||
|
d.id = o.bytes === String ? $util.base64.encode(m.id, 0, m.id.length) : o.bytes === Array ? Array.prototype.slice.call(m.id) : m.id;
|
||||||
|
}
|
||||||
|
if (m.addrs && m.addrs.length) {
|
||||||
|
d.addrs = [];
|
||||||
|
for (var j = 0; j < m.addrs.length; ++j) {
|
||||||
|
d.addrs[j] = o.bytes === String ? $util.base64.encode(m.addrs[j], 0, m.addrs[j].length) : o.bytes === Array ? Array.prototype.slice.call(m.addrs[j]) : m.addrs[j];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return d;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Converts this Peer to JSON.
|
||||||
|
* @function toJSON
|
||||||
|
* @memberof CircuitRelay.Peer
|
||||||
|
* @instance
|
||||||
|
* @returns {Object.<string,*>} JSON object
|
||||||
|
*/
|
||||||
|
Peer.prototype.toJSON = function toJSON() {
|
||||||
|
return this.constructor.toObject(this, $protobuf.util.toJSONOptions);
|
||||||
|
};
|
||||||
|
|
||||||
|
return Peer;
|
||||||
|
})();
|
||||||
|
|
||||||
|
return CircuitRelay;
|
||||||
|
})();
|
||||||
|
|
||||||
|
module.exports = $root;
|
||||||
|
42
src/circuit/protocol/index.proto
Normal file
42
src/circuit/protocol/index.proto
Normal file
@ -0,0 +1,42 @@
|
|||||||
|
syntax = "proto2";
|
||||||
|
|
||||||
|
message CircuitRelay {
|
||||||
|
|
||||||
|
enum Status {
|
||||||
|
SUCCESS = 100;
|
||||||
|
HOP_SRC_ADDR_TOO_LONG = 220;
|
||||||
|
HOP_DST_ADDR_TOO_LONG = 221;
|
||||||
|
HOP_SRC_MULTIADDR_INVALID = 250;
|
||||||
|
HOP_DST_MULTIADDR_INVALID = 251;
|
||||||
|
HOP_NO_CONN_TO_DST = 260;
|
||||||
|
HOP_CANT_DIAL_DST = 261;
|
||||||
|
HOP_CANT_OPEN_DST_STREAM = 262;
|
||||||
|
HOP_CANT_SPEAK_RELAY = 270;
|
||||||
|
HOP_CANT_RELAY_TO_SELF = 280;
|
||||||
|
STOP_SRC_ADDR_TOO_LONG = 320;
|
||||||
|
STOP_DST_ADDR_TOO_LONG = 321;
|
||||||
|
STOP_SRC_MULTIADDR_INVALID = 350;
|
||||||
|
STOP_DST_MULTIADDR_INVALID = 351;
|
||||||
|
STOP_RELAY_REFUSED = 390;
|
||||||
|
MALFORMED_MESSAGE = 400;
|
||||||
|
}
|
||||||
|
|
||||||
|
enum Type { // RPC identifier, either HOP, STOP or STATUS
|
||||||
|
HOP = 1;
|
||||||
|
STOP = 2;
|
||||||
|
STATUS = 3;
|
||||||
|
CAN_HOP = 4;
|
||||||
|
}
|
||||||
|
|
||||||
|
message Peer {
|
||||||
|
required bytes id = 1; // peer id
|
||||||
|
repeated bytes addrs = 2; // peer's known addresses
|
||||||
|
}
|
||||||
|
|
||||||
|
optional Type type = 1; // Type of the message
|
||||||
|
|
||||||
|
optional Peer srcPeer = 2; // srcPeer and dstPeer are used when Type is HOP or STATUS
|
||||||
|
optional Peer dstPeer = 3;
|
||||||
|
|
||||||
|
optional Status code = 4; // Status code, used when Type is STATUS
|
||||||
|
}
|
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user