Skip to content

A browser plugin that lets you inspect a running libp2p node

Notifications You must be signed in to change notification settings

libp2p/js-libp2p-devtools

Repository files navigation

js-libp2p DevTools

A browser plugin that lets you inspect a running libp2p node

A DevTools plugin that adds a "libp2p" tab to your developer tools that contacts a libp2p node running on the current page.

Works with @libp2p/devtools-metrics which supplies metrics and allows us to interact with the running node.

image

Installation instructions

1. Browser installation

Until this plugin is published on the relevant browser plugin stores, please run this locally.

  1. Clone this repo
  2. Run npm i && npm run build
  3. Install as an unpacked/temporary add on for your browser:

2. App installation

Configure @libp2p/devtools-metrics as your metrics implementation:

import { createLibp2p } from 'libp2p'
import { devToolsMetrics } from '@libp2p/devtools-metrics'

const node = await createLibp2p({
  metrics: devToolsMetrics(),
  //... other options here
})

3. Permissions

With the move to Manifest v3, users must now opt in to running content scripts on a page.

Chrome

Please click the extensions button, then grant the extension permission to run:

Firefox

Please click the extensions button, then grant the extension permission to run:

4. Go!

Browse to your webapp and open the DevTools, you should see a "libp2p" tab towards the right hand side of the toolbar. Click it to see stats about the running node.

What's next?

  1. Tests
  • There aren't a lot of tests here yet
  1. Better UI
  • It's quite rough
  1. Graphs
  • We don't do much with the collected metrics yet. It would be nice to use Chart.js or similar to show some useful graphs
  • Bonus points for letting the user define their own graphs a la Grafana/Prometheus
  • More bonus points for being able to export/import graph configs
  1. Dynamic panels
  • We should be able to inspect the libp2p node's configured services (or protocols?) and, for example, only show a DHT tab if the DHT is configured
  1. Light theme support
  • There are partial overrides for light theme font/background/border colours but we need better detection of when it's enabled
  1. ??? more features here

About

A browser plugin that lets you inspect a running libp2p node

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages