# @truffle/dashboard-message-bus > Message bus that handles communication between the Dashboard and its components Latest version **0.1.12** (published 2023-09-07) · MIT license · 0 weekly downloads > **Deprecated.** This package is deprecated. ## Install ```sh npm install @truffle/dashboard-message-bus pnpm add @truffle/dashboard-message-bus yarn add @truffle/dashboard-message-bus bun add @truffle/dashboard-message-bus ``` ## Health **Score 10/100 (F)** — status: deprecated. Negative: deprecated. ## Facts | | | |---|---| | Version | 0.1.12 | | Published | 2023-09-07 | | First published | 2022-02-01 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Node | ^16.20 \|\| ^18.16 \|\| >=20 | | Dependencies | 6 | | Unpacked size | 28.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 13905 | | Author | Rosco Kalis | | Maintainers | rizedr, joshuafernandes, cliffoo, kevinbluer, gnidan, haltman, eggplantzzz, fainashalts, cds-amal | ## Links - npm: https://www.npmjs.com/package/@truffle/dashboard-message-bus - Repository: https://github.com/trufflesuite/truffle - Homepage: https://github.com/trufflesuite/truffle/tree/master/packages/dashboard-message-bus#readme - Issues: https://github.com/trufflesuite/truffle/issues - npm.io page: https://npm.io/package/@truffle/dashboard-message-bus ## Dependencies (6) - [ws](https://npm.io/package/ws.md) ^7.2.0 - [delay](https://npm.io/package/delay.md) ^5.0.0 - [@types/ws](https://npm.io/package/@types/ws.md) ^7.2.0 - [promise.any](https://npm.io/package/promise.any.md) ^2.0.2 - [isomorphic-ws](https://npm.io/package/isomorphic-ws.md) ^4.0.1 - [@truffle/dashboard-message-bus-common](https://npm.io/package/@truffle/dashboard-message-bus-common.md) ^0.1.7 ## Recent versions - 0.1.12 (latest) — 2023-09-07 - 0.1.9-hardhat-error.0 (hardhat-error) — 2022-08-25 - 0.1.4-alpha.2 (signTypedData_v4) — 2022-06-24 - 0.1.1-dashboard.1 (dashboard) — 2022-02-01 - 0.1.11 — 2023-06-06 - 0.1.10 — 2022-12-08 - 0.1.9 — 2022-11-23 - 0.1.8 — 2022-08-24 - 0.1.8-hardhat-error.1 — 2022-08-22 - 0.1.8-hardhat-error.0 — 2022-08-20 - 0.1.7 — 2022-08-17 - 0.1.6 — 2022-07-15 - 0.1.5 — 2022-07-01 - 0.1.4 — 2022-06-23 - 0.1.4-alpha.0 — 2022-06-23 - … 5 more at https://npm.io/package/@truffle/dashboard-message-bus/versions ## README # @truffle/dashboard-message-bus :warning: **This is a middleware package and should only be used when developing integrations for the truffle dashboard** :warning: The `@truffle/dashboard-message-bus` manages the communication between the Truffle Dashboard and any other Truffle components via a specialized proxy RPC server instance. ## Installation End users should never have to install this message bus as it is used under the hood by other packages. If you are building a package that needs to interface with the Dashboard or message bus, you can install this package from NPM. ``` npm install @truffle/dashboard-message-bus ``` ``` yarn add @truffle/dashboard-message-bus ``` ## Usage A new message bus can be started by instantiating a new `DashboardMessageBus` and calling the `start()` function on it. This should almost always be done in combination with starting a new dashboard, so you probably don't want to do this directly. Instead you should start a new dashboard, which automatically starts its corresponding message bus. The `@truffle/dashboard-message-bus` does contain a bunch of exported utilities used for connecting and communicating with the message bus that can be used directly by other packages, although this should still only be used when developing new packages that interface with the dashboard, rather than end-user applications. ## Development ### Architecture The message bus works by running two separate WebSocket servers. One server is for publishers to connect to and send requests, while the other server is for subscribers (dashboards) to connect to and receive requests. The subscribers respond to these requests by sending a message to the message bus with an ID that corresponds to the request. Any requests from publishers are sent to all subscribers, but only the first response will be returned to the publisher. When new subscribers connect, any "unfulfilled" requests will be sent to the newly connected subscribers as well. The message bus stays running as long as there is at least one publisher _or_ subscriber connected. As soon as the last one disconnects, the message bus shuts down. ### Testing This package is meant to be used with the `@truffle/dashboard` package. So manual testing is most likely done through the dashboard package. Some automated tests are defined in the `test/` folder, but these still need to be expanded. ### Adding new message types Right now there are very few message types. The most important one is `"provider"`, which sends RPC requests to the `@truffle/dashboard` so that they can be handled by the injected web3 provider that your wallet (e.g. MetaMask) providers. Other message types are `"invalidate"`, which can be sent to invalidate earlier messages, and `"log"`, which is sent by the message bus to send log messages over the wire. See the [`@truffle/dashboard-message-bus-common` README](https://github.com/trufflesuite/truffle/tree/master/packages/dashboard-message-bus-common#readme) for details about adding new message types. --- _Source: https://npm.io/package/@truffle/dashboard-message-bus · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._