@gnosis.pm/safe-apps-web3-react

Web3-react connector for Safe Apps

Usage no npm install needed!

<script type="module">
  import gnosisPmSafeAppsWeb3React from 'https://cdn.skypack.dev/@gnosis.pm/safe-apps-web3-react';
</script>

README

Safe Apps Web3-react connector

npm

A connector to be used with web3-react package

Installation

yarn add @gnosis.pm/safe-apps-web3-react

npm install @gnosis.pm/safe-apps-web3-react

Usage

import { SafeAppConnector } from '@gnosis.pm/safe-apps-web3-react';

The connector follows web3-react's connectors API convention. Visit web3-react repo for more details

Helper hook

You can use our helper hook to automatically connect to a safe, it will automatically connect to the Safe if it detects that it's loaded in Safe App context:

import { useSafeAppConnection, SafeAppConnector } from '@gnosis.pm/safe-apps-web3-react';

const safeMultisigConnector = new SafeAppConnector();

const App = () => {
  const triedToConnectToSafe = useSafeAppConnection(safeMultisigConnector);

  React.useEffect(() => {
    if (triedToConnectToSafe) {
      // fallback to other providers
    }
  }, [triedToConnectToSafe]);
};

More scenarios

For the SDK overview documentation, please refer to the safe-apps-sdk documentation