Actions are functions that will help you control the modal, subscribe to wallet events and interact with them and smart contracts.

​
Open and close the modal

const modal = createAppKit({
  adapters: [wagmiAdapter],
  networks: [mainnet, arbitrum],
  projectId,
});

modal.open();

modal.close();

You can also select the modal’s view when calling the open function

modal.open({ view: "Account" });

// to connect and show multi wallets view
modal.open({ view: "Connect" });

// to connect and show only solana wallets
modal.open({ view: "Connect", namespace: "solana" });

// to connect and show only bitcoin wallets
modal.open({ view: "Connect", namespace: "bip122" });

// to connect and show only ethereum wallets
modal.open({ view: "Connect", namespace: "eip155" });

// to open swap with arguments
open({
  view: 'Swap',
  arguments: {
    amount: '321.123',
    fromToken: 'USDC',
    toToken: 'ETH'
  }
})

List of views you can select

VariableDescription
ConnectPrincipal view of the modal - default view when disconnected. A namespace can be selected to connect to a specific network (solana, bip122, or eip155).
AccountUser profile - default view when connected.
AllWalletsShows the list of all available wallets.
NetworksList of available networks - you can select and target a specific network before connecting.
WhatIsANetwork”What is a network” onboarding view.
WhatIsAWallet”What is a wallet” onboarding view.
OnRampProvidersOn-Ramp main view.
SwapSwap main view.

​
Disconnect

modal.adapter?.connectionControllerClient?.disconnect();

​
WalletInfo

Metadata information from the connected wallet

function handler({ name, icon }) {
  console.log(name, icon);
}

modal.subscribeWalletInfo(handler);

//or

const { name, icon } = modal.getWalletInfo();

​
Ethereum Library

You can use Wagmi actions to sign messages, interact with smart contracts, and much more.

​
getAccount

Action for accessing account data and connection status.

import { getAccount } from "@wagmi/core";
import { wagmiConfig } from "./main";

const account = getAccount(wagmiConfig);

​
signMessage

Action for signing messages with connected account.

import { signMessage } from "@wagmi/core";
import { wagmiConfig } from "./main";

await signMessage(wagmiConfig, { message: "hello world" });

Learn More

Get the current value of the modal’s state

const modal = createAppKit({
  adapters: [wagmiAdapter],
  networks: [mainnet, arbitrum],
  projectId,
});

const { open, selectedNetworkId } = modal.getState();

The modal state is an object of two properties:

PropertyDescriptionType
openOpen state will be true when the modal is open and false when closed.boolean
selectedNetworkIdThe current chain id selected by the user.number

You can also subscribe to the modal’s state changes.

const modal = createAppKit({ wagmiConfig, projectId });

modal.subscribeState((newState) => console.log(newState));

​
ThemeMode

Set the themeMode after creating the modal

const modal = createAppKit({ wagmiConfig, projectId });

modal.setThemeMode("dark");

Get the current themeMode value by calling the getThemeMode function

const modal = createAppKit({ wagmiConfig, projectId });

const themeMode = modal.getThemeMode();

​
themeVariables

Set the themeVariables after creating the modal

const modal = createAppKit({ wagmiConfig, projectId })

modal.setThemeVariables({ ... })

Get the current themeVariables value by calling the getThemeVariables function

const modal = createAppKit({ wagmiConfig, projectId });

const themeMode = modal.getThemeVariables();

​
Subscribe to theme changes

const unsubscribe = modal.subscribeTheme((newTheme) => console.log(newTheme));

​
Track modal events

modal.getEvent(); // get last event
modal.subscribeEvents((event) => console.log(event)); // subscribe to events

Was this page helpful?