Skip to content

Latest commit

 

History

History
58 lines (39 loc) · 2.45 KB

README.md

File metadata and controls

58 lines (39 loc) · 2.45 KB

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. 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
})
  1. That's it! 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.

Running on Firefox

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

This tiny green dot shows that granting permissions is required:

More info: https://blog.mozilla.org/addons/2022/11/17/unified-extensions-button-and-how-to-handle-permissions-in-manifest-v3/

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 Graphana/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