@libp2p/multidim-interop NPM

@libp2p/multidim-interop

Multidimensional interop tests

Usage

The multidim interop tests use random high ports for listeners. Since you need to know which port will be listened on ahead of time to EXPOSE a port in a Docker image to the host machine, this means everything has to be run in Docker.

Build js-libp2p

This must be repeated every time you make a change to the js-libp2p source code.

node.js

$ npm run build
$ docker build . -f ./interop/Dockerfile -t js-libp2p-node

Browsers

$ npm run build
$ docker build . -f ./interop/BrowserDockerfile -t js-libp2p-browsers

Build another libp2p implementation

Clone the test-plans repo somewhere

$ git clone https://github.com/libp2p/test-plans.git

(Optional) If you are running an M1 Mac you may need to override the build platform.
- Edit /multidim-interop/dockerBuildWrapper.sh
- Add --platform linux/arm64/v8 to the docker buildx build command
```
docker buildx build \
  --platform linux/arm64/v8 \    <-- add this line
  --load \
  -t $IMAGE_NAME $CACHING_OPTIONS "$@"
```
(Optional) Enable some sort of debug output
- nim-libp2p
  - edit /multidim-interop/impl/nim/$VERSION/Dockerfile
  - Change -d:chronicles_log_level=WARN to -d:chronicles_log_level=DEBUG
- rust-libp2p
  - When starting the docker container add -e RUST_LOG=debug
- go-libp2p
  - When starting the docker container add -e GOLOG_LOG_LEVEL=debug

Build the version you want to test against

$ cd multidim-interop/impl/$IMPL/$VERSION
$ make
...

Running Redis

Redis is used to allow inter-container communication, exchanging listen addresses etc. It must be started as a Docker container:

$ docker run --name redis --rm -p 6379:6379 redis:7-alpine

Start libp2p

node.js

$ docker run -e transport=tcp -e muxer=yamux -e security=noise -e is_dialer=true -e redis_addr=redis:6379 --link redis:redis js-libp2p-node

Browsers

$ docker run -e transport=webtransport -e muxer=yamux -e security=noise -e is_dialer=true -e redis_addr=redis:6379 --link redis:redis js-libp2p-browsers

Start another libp2p implementation

Change go-v0.29 to the implementation you wish to use.
Ensure one docker run has is_dialer=false and the other has is_dialer=true
Ensure the transport option is the same for both implementations

$ docker run -e transport=tcp -e muxer=yamux -e security=noise -e is_dialer=false -e redis_addr=redis:6379 --link redis:redis go-v0.29

License

Licensed under either of

Apache 2.0, (LICENSE-APACHE / http://www.apache.org/licenses/LICENSE-2.0)
MIT (LICENSE-MIT / http://opensource.org/licenses/MIT)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

@chainsafe/libp2p-noise @chainsafe/libp2p-yamux @libp2p/circuit-relay-v2 @libp2p/identify @libp2p/mplex @libp2p/ping @libp2p/tcp @libp2p/webrtc @libp2p/websockets @libp2p/webtransport @multiformats/mafmt @multiformats/multiaddr aegir libp2p redis

@everything-registry/sub-chunk-546

1 day ago

1 day ago

1 day ago

1 day ago

1 day ago

1 day ago

7 days ago

7 days ago

8 days ago

8 days ago

7 days ago

8 days ago

9 days ago

9 days ago

12 days ago

12 days ago

13 days ago

14 days ago

15 days ago

14 days ago

15 days ago

16 days ago

17 days ago

22 days ago

22 days ago

23 days ago

26 days ago

26 days ago

26 days ago

29 days ago

29 days ago

29 days ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

@libp2p/multidim-interop v2.0.31