metaMask ​

Connector for the MetaMask SDK.

import { useSendTransaction, parseEther } from 'wagmi'

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

import { useSendTransaction, parseEther } from 'wagmi'

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

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 { 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 ​

import { metaMask } from 'wagmi/connectors'

import { metaMask } from 'wagmi/connectors'

Usage ​

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(),
  },
})

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 ​

import { type MetaMaskParameters } from 'wagmi/connectors'

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.

openDeeplink ​

((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.

useDeeplink ​

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.