Options - Reown Docs

Featured wallets

Select wallets that are going to be shown on the modal’s main view. Array of wallet IDs defined will be prioritized (order is respected). These wallets will also show up first in All Wallets view. You can find the wallet IDs in WalletGuide.

await AppKit.InitializeAsync(new AppKitConfig
{
    featuredWalletIds = new []
    {
        "1ae92b26df02f0abca6304df07debccd18262fdf5fe82daa81593582dac9a369", // Rainbow
        "4622a2b2d6af1c9844944291e5e7351a6aa24cd7b23099efac1b2fd875da31a0", // Trust
    }
});

Explorer included wallets

Allows to set included wallets that are fetched from WalletGuide. You can define a list of wallets ids you’d like to prioritize (order is respected). You can get these ids from the explorer link mentioned before by clicking on a copy icon of your desired wallet card.

await AppKit.InitializeAsync(new AppKitConfig
{
    includedWalletIds = new []
    {
        "c57ca95...74e97267d96",
    }
});

Explorer excluded wallets

Allows to set excluded wallets that are fetched from WalletGuide. You can get these ids from the explorer link mentioned before by clicking on a copy icon of your desired wallet card.

await AppKit.InitializeAsync(new AppKitConfig
{
    excludedWalletIds = new []
    {
        "c57ca95...74e97267d96",
    }
});

Supported Chains

Allows to set supported chains for the application. Can use predefined chain constants from ChainConstants.Chains or custom Chain objects.

await AppKit.InitializeAsync(new AppKitConfig
{
    supportedChains = new[]
    {
        ChainConstants.Chains.Ethereum,
        ChainConstants.Chains.Polygon,
        ChainConstants.Chains.Ronin,

        new Chain(ChainConstants.Namespaces.Evm,
            chainReference: "713715",
            name: "Sei Devnet",
            nativeCurrency: new Currency("Sei", "SEI", 18),
            blockExplorer: new BlockExplorer("Seitrace", "https://seitrace.com"),
            rpcUrl: "https://evm-rpc-arctic-1.sei-apis.com",
            isTestnet: true,
            imageUrl: $"https://imagedelivery.net/_aTEfDRm7z3tKgu9JhfeKA/692ed6ba-e569-459a-556a-776476829e00/md"
        )
    }
});

Enable Installed Wallet Detection

To enable AppKit to detect wallets installed on mobile devices, you need to make specific changes to the native side of the project.

Android
iOS

In Unity override Android Manifest.
Add your <queries>...</queries> schemes outside of <application /> scope in the manifest file.
Refer to Android Specs for more information.

Example:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <queries>
        <package android:name="io.metamask"/>
        <package android:name="com.wallet.crypto.trustapp"/>
        <package android:name="com.skymavis.genesis"/>
        <package android:name="io.gnosis.safe"/>
        <package android:name="me.rainbow"/>
        <!-- Add other wallet schemes names here -->
    </queries>

    <application>
        ...
    </application>
</manifest>

More wallet package names can be found in our sample AndroidManifest.xml.

Wallet detection may produce inaccurate results on iOS Simulator. It is recommended to test on a real device.

Make an iOS build.
In the generated Xcode project, find Info.plist file and open it with a external editor (i.e. not Xcode).
Locate or create <key>LSApplicationQueriesSchemes</key> section.
Add the desired wallet schemes as string entries within the <array>. These schemes represent the wallets you want to detect.

Example:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        ...

        <key>LSApplicationQueriesSchemes</key>
        <array>
            <string>metamask</string>
            <string>trust</string>
            <string>safe</string>
            <string>roninwallet</string>
            <string>rainbow</string>
            <string>uniswap</string>
            <string>zerion</string>
            <string>imtokenv2</string>
            <string>spot</string>
            <string>omni</string>
            <string>dfw</string>
            <string>tpoutside</string>
            <string>robinhood-wallet</string>
        </array>

        ...
    </dict>
</plist>

Fullscreen in WebGL

The default unityInstance.SetFullscreen(1) method enables fullscreen for the canvas node by pushing it to the top layer. This causes the modal to be rendered behind the canvas, making it invisible to the user when fullscreen is enabled. To fix this, AppKit creates a container around the canvas node and appends the modal UI to it. By requesting fullscreen on the container, the modal will always be rendered on top of the canvas.

// Use this instead of unityInstance.SetFullscreen(1) to enable full screen
document.querySelector('#canvas-container').requestFullscreen();

Redirect from Wallet to App

After a connection or request approval, most wallets attempt to redirect back to the app. To ensure reliability, particularly on iOS, it is recommended to register a custom URL scheme and provide it to AppKit.

// AppKit configuration
var appKitConfig = new AppKitConfig
{
    projectId = "884a........2cc",
    metadata = new Metadata(
        "My app",
        "My app",
        "https://example.com",
        "https://..../appkit-icon.png",
        new RedirectData
        {
            // Used by native wallets to redirect back to the app after approving requests
            Native = "my-url-schema://"
        }
    ),
};


await AppKit.InitializeAsync(
    appKitConfig
);

​Featured wallets

​Explorer included wallets

​Explorer excluded wallets

​Supported Chains

​Enable Installed Wallet Detection

​Fullscreen in WebGL

​Redirect from Wallet to App