useChain()

Use it to retrieve the current chain info.

INFO

When a dApp is running on one chain but the connected extension allows switching to a different one (e.g. Metamask), this hook can be useful for displaying an error message based on the chainData.error property.

Usage

When parameter multiSession={false}:

import { useChain } from '@buidlerlabs/hashgraph-react-wallets'

const App = () => {
  const { data: chainData } = useChain()

  if (chainData?.error) {
    return <span>{chainData.error}</span>
  }

  return <span>Chain: {chainData.chain.name ?? '-'}</span>
}

Parameters

interface IUseChainIdProps<Connector> {
  connector?: Connector | null
  autoFetch?: boolean
}

- connector

• Type: HWBridgeConnector
• Required: false

Request chain data for a specific wallet when multiSession={true}

import { MatamaskConnector } from '@buidlerlabs/hashgraph-react-wallets/connectors'
import { useChain } from '@buidlerlabs/hashgraph-react-wallets'

const App = () => {
  const { data: chainData } = useChain({ connector: MatamaskConnector }) 

  if (chainData?.error) {
    return <span>{chainData.error}</span>
  }

  return <span>Chain: {chainData.chain.name ?? '-'}</span>
}

---

- autoFetch

• Type: boolean
• Required: false

import { useWallet, useChain } from '@buidlerlabs/hashgraph-react-wallets'

const App = () => {
  const { isConnected } = useWallet()
  const { data: chainData } = useChain({ autoFetch: isConnected }) 

  if (chainData?.error) {
    return <span>{chainData.error}</span>
  }

  return <span>Chain: {chainData.chain.name ?? '-'}</span>
}

Return Type

type Promise<{ chain?: Chain | null; error: string | null } | null>