@rimble/network-indicator

React component built with Rimble UI that will display the current Ethereum network name based on a given network ID and optionally display and icon and tooltip indicating whether the user is on the correct network for the application.

Installation

Install the package in your project directory with:

// with npm
npm install @rimble/network-indicator

// with yarn
yarn add @rimble/network-indicator

Usage Example

import NetworkIndicator from '@rimble/network-indicator';

// Default
<NetworkIndicator currentNetwork={3} />;

// Has requiredNetwork prop
<NetworkIndicator currentNetwork={3} requiredNetwork={1} />;

// Custom tooltips for default
<NetworkIndicator currentNetwork={1}>
  {{
    onNetworkMessage: 'Connected to correct network',
    noNetworkMessage: 'Not connected to anything'
  }}
</NetworkIndicator>

// Custom tooltips with requiredNetwork prop
<NetworkIndicator currentNetwork={null} requiredNetwork={1}>
  {{
    onNetworkMessage: 'Connected to correct network',
    noNetworkMessage: 'Not connected to anything',
    onWrongNetworkMessage: 'Wrong network',
  }}
</NetworkIndicator>

Props

| Name | Type | Default | Description | | ----------------------- | ------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | currentNetwork | integer | none | The network ID that the user is connected to, if available | | requiredNetwork | integer | none | The network ID that the dApp requires to function | | onNetworkMessage | string | none | Content of a hover tooltip when there is a currentNetwork prop and when requiredNetwork exists and matches currentNetwork prop | | noNetworkMessage | string | see default messages | Content of a hover tooltip when there is a null value for currentNetwork prop even when there is a requiredNetwork prop | | onWrongNetworkMessage | string | see default messages | Content of a hover tooltip when values do not match for currentNetwork and requiredNetwork props |

Default Messages

onNetworkMessage

Only when requiredNetwork exists and matches currentNetwork prop

You're on the right network

noNetworkMessage

You're not on an Ethereum network

onWrongNetworkMessage

You're on the wrong network

Issues

Open an issue for any bugs or feature requests

Contributing

We are open source and welcome your contributions !

License

MIT © ConsenSys