Visit the Ecosystem Wallets dashboard and enter the name of your ecosystem and choose your logo.

When your ecosystem wallet is deployed, you'll receive an Ecosystem ID derived from your ecosystem name. You will use this ID to specify your wallet during integration (see Step 4 below).

There are two permission options depending on whether you’d like an open or exclusive ecosystem wallet.

If you want to allow anyone to integrate your ecosystem wallet, no other changes are required. You can protect your ecosystem against malicious actors by adding unwanted domains to your blocklist.

If you’re looking to create an ecosystem wallet for select partners, you can head to the Ecosystem Wallet dashboard, navigate to Permissions, and select “Allowlist”. All apps and games, added to your ecosystem, including your own app, will receive a unique Partner ID.

Add Applications to Your Allowlist

For each application on your allowlist, you'll need to specify a name, a list of allowed domains, wallet signing settings, and an optional bundle ID (for mobile applications). The list of domains will determine where a partner will be able to display your ecosystem as a login option. Once a partner is added, a Partner ID will be generated.

Once you've set up your ecosystem wallet, you can specify it using your Ecosystem ID.

import { ecosystemWallet } from "thirdweb/wallets";
 
// Create a wallet for a non-gated "Anyone" ecosystem
const wallet = ecosystemWallet("ecosystem.your-ecosystem-id");

If you set your ecosystem wallet to Allowlist, you'll also need to specify your Partner ID.

import { ecosystemWallet } from "thirdweb/wallets";
 
// Create a wallet for "Allowlist" ecosystems restricted to partners
const wallet = ecosystemWallet("ecosystem.your-ecosystem-id", {
  partnerId: "...",
});

Once you've instantiated your ecosystem wallet, you can add it to your Sign In flow.

<ConnectButton
  client={THIRDWEB_CLIENT}
  wallets={[wallet]} // Pass a non-gated or restricted wallet to the ConnectButton
  {...props}
/>;

You and your partners can integrate your ecosystem wallet either as a full login system or as a single login option. You can read more in our integrating partners guide.

Visit the Reown Dashboard and select "Create Project"

• Enter your Ecosystem Wallet's Explorer page URL as the Homepage URL and proceed.
• Choose Wallet as the project type and select "Create"

Navigate to the WalletGuide tab and fill out the following form:

• Wallet Name: Provide your wallet's name.
• Wallet Category: Select "Web App Wallets"
• Web App URL: Use your Ecosystem Wallet's Explorer page URL.
• Supported Chains: Choose Ethereum and any other chains your wallet supports.
• Logo: Upload your wallet’s logo (this will appear on the WalletConnect Explorer).
• Testing Instructions: Provide clear testing instructions for the Reown team. For example: "Log in via the specified URL and select an authentication method."

Once you've completed the form, click "Submit Review"

• After approval, your wallet will appear live on the WalletConnect Explorer.

Visit a platform like OpenSea and use WalletConnect to log in.

• Select your registered wallet from the list and authenticate.
• Your wallet should now seamlessly connect, allowing you to interact with the platform.