Skip to content

metaMask

Connector for the MetaMask SDK.

WARNING

This connector has limitations on iOS as Safari cancels Universal Link connections if they do not occur within ~500ms of user interaction (ie. a button click). For a reliable iOS linking experience, it is recommended to use the walletConnect connector.

Alternatively, to prevent Universal Link issues with this connector, you can skip transaction validation by setting gas: null (for transactions) or __mode: 'prepared' (for contract writes).

tsx
import { useSendTransaction, parseEther } from 'wagmi'

function Example() {
  const { sendTransaction } = useSendTransaction()
  
  return (
    <button 
      onClick={() => sendTransaction({ 
        gas: null,
        to: '0xd2135CfB216b74109775236E36d4b433F1DF507B',
        value: parseEther('0.01'), 
      })}
    >
      Transfer
    </button>
  )
}
tsx
import { useWriteContract } from 'wagmi'
import { abi } from './abi'

function Example() {
  const { writeContract } = useWriteContract()
  
  return (
    <button 
      disabled={!isSuccess}
      onClick={() => writeContract({
        __mode: 'prepared',
        abi,
        address: '0x6b175474e89094c44da98b954eedeac495271d0f',
        functionName: 'mint',
      })}
    >
      Mint
    </button>
  )
}

Import

ts
import { metaMask } from 'wagmi/connectors'

Usage

ts
import { createConfig, http } from 'wagmi'
import { mainnet, sepolia } from 'wagmi/chains'
import { metaMask } from 'wagmi/connectors'

export const config = createConfig({
  chains: [mainnet, sepolia],
  connectors: [metaMask()],
  transports: {
    [mainnet.id]: http(),
    [sepolia.id]: http(),
  },
})

Parameters

ts
import { type MetaMaskParameters } from 'wagmi/connectors'

Check out the MetaMask SDK docs for more info. A few options are omitted that Wagmi manages internally.

communicationLayerPreference

CommunicationLayerPreference | undefined

The preferred communication layer to use for the SDK.

communicationServerUrl

string | undefined

The URL of the communication server to use for the SDK.

dappMetadata

DappMetadata | undefined

  • Metadata about the dapp using the SDK.
  • Defaults to { name: 'wagmi' }.

enableAnalytics

boolean | undefined

  • Send anonymous analytics to MetaMask to help us improve the SDK.
  • Defaults to false.

extensionOnly

boolean | undefined

  • If MetaMask browser extension is detected, directly use it.
  • Defaults to true.

forceDeleteProvider

boolean | undefined

If true, the SDK will force delete the provider from the global window object.

forceInjectProvider

boolean | undefined

If true, the SDK will force inject the provider into the global window object.

infuraAPIKey

string | undefined

The Infura API key to use for RPC requests.

injectProvider

boolean | undefined

If true, the SDK will inject the provider into the global window object.

logging

SDKLoggingOptions | undefined

Options for customizing the logging behavior of the SDK.

modals

RemoteConnectionProps['modals'] | undefined

An object that allows you to customize or translate each of the displayed modals. See the nodejs example for more information.

((arg: string) => void) | undefined

A function that will be called to open a deeplink to the MetaMask Mobile app.

preferDesktop

boolean | undefined

If true, the SDK will prefer the desktop version of MetaMask over the mobile version.

shouldShimWeb3

boolean | undefined

If true, the SDK will shim the window.web3 object with the provider returned by the SDK (useful for compatibility with older browser).

storage

StorageManagerProps | undefined

Options for customizing the storage manager used by the SDK.

timer

any | undefined

A timer object to use for scheduling tasks.

transports

string[] | undefined

An array of transport protocols to use for communication with the MetaMask wallet.

ui

SDKUIOptions | undefined

Options for customizing the SDK UI.

boolean | undefined

  • If true, the SDK will use deeplinks to connect with MetaMask Mobile. If false, the SDK will use universal links to connect with MetaMask Mobile.
  • Defaults to true.

wakeLockType

WakeLockStatus | undefined

The type of wake lock to use when the SDK is running in the background.

Released under the MIT License.