Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
119 changes: 2 additions & 117 deletions cloud/explorer-submission.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,121 +2,6 @@
title: WalletGuide Submission
---

<Note>
Wallet submissions are now handled through the [WalletConnect Dashboard](https://dashboard.walletconnect.com/).

Submitting a project to the Reown Dashboard Explorer is recommended but optional. You can still use Reown services without submitting your project.
However, doing so ensures that your project is listed under [WalletGuide](https://walletguide.walletconnect.network/?utm_source=walletconnect-docs&utm_medium=cloud&utm_campaign=github) and [Cloud Explorer API](./explorer.md).

</Note>

## Creating a New Project

First, open the Reown Dashboard by navigating to [dashboard.reown.com](https://dashboard.reown.com/?utm_source=blog&utm_medium=devrel&utm_campaign=conversion) and signing in. If you don’t have an account yet, please create one before proceeding.

- Once you're logged in, go to the "**Projects**" section under **Cloud** and click on "**+ Project**".

<Frame>
<img src="/images/cloud/1.png" />
</Frame>

- Give a suitable name for your project, select Wallet (WalletKit) and click the "Create" button. You can change the name for your project later.

<Frame>
<img src="/images/cloud/2.png" />
</Frame>


## Project Details

- Click on “WalletGuide” to proceed to fill in the details of your wallet.

<Frame>
<img src="/images/cloud/3.png" />
</Frame>

- You will now see an option to publish your wallet to WalletGuide. Click "Publish" to proceed.

<Frame>
<img src="/images/cloud/4.png" />
</Frame>

- You will now see a form to fill in the details of your wallet as shown below.

| Field | Description | Required |
|------------------------------|-----------------------------------------------------------------------------|----------|
| Name | The name to display in the explorer | yes |
| Description | A short description explaining your project (dapp/wallet) | yes |
| Type | Whether your project is a dapp or a wallet | yes |
| Category | Appropriate category for your project. This field is dependent on the type of your project | yes |
| Homepage | The URL of your project | yes |
| Web App | The URL of your web app. This field is only applicable for dapps | yes |
| Chains | Chains supported by your project | yes |
| Logo | The logo of your project. Further requirements are provided in the explorer submission form | yes |
| Testing Instructions | Instructions on how to test your Reown Integration | yes |
| Download Links | Links to download your project (if applicable) | no |
| Mobile Linking | Required for mobile wallets targeting AppKit. Deep Link is recommended over Universal Link | no |
| Desktop Linking | Required for desktop wallets targeting AppKit. | no |
| Injected Wallet Identifiers | Required for injected wallets targeting AppKit. RDNS (from EIP-6963 metadata) is recommended over Provider Flags(Legacy) | no |
| Metadata | User-facing UI metadata for your project. Only Short Name is required. | no |


## Project Submission

- Once you've filled the applicable fields, click the "Submit" button to submit your project for review. Alternatively, you can save your changes and submit later. Additional information will be visible in the modal that appears after clicking the "Submit" button.

<Frame>
<img src="/images/cloud/5.png" />
</Frame>

## How do we test wallets?

In order to offer a great user experience in our APIs and SDKs every Cloud submission goes through a QA process to make sure that the integration of the WalletConnect protocol is working correctly.

The following list details our QA flow and how to reproduce it:

| Test Case | Steps | Expected Results |
|-----------------------------------------------|-------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| **Set Up** | 1. Download the wallet <br/> 2. Install the wallet app <br/> 3. Sign up for an account <br/> 4. Create one or more accounts | 1. N/A <br/> 2. The app is installed <br/> 3. I have an account <br/> 4. I have one or more accounts |
| **Connect to dapp via web browser** | 1. Open the Reown connection page [appkit-lab.reown.com](https://appkit-lab.reown.com/) from a PC <br/> 2. Press "Connect Wallet" and select Reown. <br/> 3. Open the wallet app and scan QR code. <br/> 4. Accept the connection request. | 1. The app is set up correctly <br/> 2. A modal with wallet options appears <br/> 3. A QR code is shown and scanned <br/> 4. Connection established, wallet data displayed on site |
| **Connect to dapp via mobile browser (Deep-link)** | 1. Open [appkit-lab.reown.com](https://appkit-lab.reown.com/) on mobile. <br/> 2. Select a default option (e.g., Wagmi for EVM chains), click "Custom Wallet," enter wallet name and deep link, then add it. Press "Connect Wallet" and select the new wallet. <br/> 3. Accept connection request in the wallet app. | 1. N/A <br/> 2. A form appears to enter wallet data, new wallet option is visible. <br/> 3. User is redirected to the wallet app, sees a connection request, and successfully connects. On Android, user is redirected back to the website. |
| **Switch chains - dapp side** | 1. After connecting, click the modal button (top right of website). <br/> 2. Click the first button in the modal to switch chains. <br/> 3. Select a chain, close the modal, and press "Send Transaction." | 1. Modal with account info appears. <br/> 2. A new view with supported chains appears. <br/> 3. The transaction request in the wallet shows the correct chain. |
| **Switch Chains - wallet side (if supported)** | 1. Check if wallet supports chain switching. If so, switch to a different chain. | 1. The chain change is reflected on the website. The first card displays the current chain ID. |
| **Accounts Switching - wallet side** | 1. Switch accounts in the wallet app. | 1. The account switch is reflected in the modal’s account view on the website. |
| **Disconnect a wallet** | 1. Press "Disconnect" in the Wallet App (if available). <br/> 2. Alternatively, press "Disconnect" from the dApp. | 1. The session disappears from both the dApp and Wallet App. <br/> 2. The session disappears from both the dApp and Wallet App. |
| **Verify API** | 1. Open [malicious-app-verify-simulation.vercel.app](https://malicious-app-verify-simulation.vercel.app/). <br/> 2. Select a wallet-supported chain, press "Connect." <br/> 3. Scan the QR code with the wallet. | 1. N/A <br/> 2. A QR code modal appears. <br/> 3. The wallet flags the site as malicious. |


### Chain Specific

The following test cases only apply for wallets supporting a particular set of chains.

<Tabs>
<Tab title="EVM">

| Test Case | Steps | Expected Results |
|-------------------------------------|-----------------------------------------------------------------------|----------------------------------------------------------------------|
| **Supporting personal_sign** | 1. Connect the wallet.<br/>2. Press the “Sign Message” button.<br/>3. Accept the signature request on the wallet. | 1. N/A<br/>2. A modal should popup on the wallet app requesting a signature.<br/>3. Once accepted and signed, the hash should show up on the website. |
| **Supporting eth_signTypedData_v4** | 1. Connect the wallet.<br/>2. Press the “Sign Typed Data” button.<br/>3. Accept the signature request on the wallet. | 1. N/A<br/>2. A modal should popup on the wallet app requesting a signature.<br/>3. Once accepted and signed, the hash should show up on the website. |
| **Supporting eth_sendTransaction** | 1. Connect the wallet.<br/>2. Press the “Send Transaction” button. | 1. N/A<br/>2. A modal should popup on the wallet app requesting a signature. |


</Tab>

<Tab title="Solana">

| Test Case | Steps | Expected Results |
|-------------------------------------|------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
| **Supporting solana_signMessage** | 1. Connect the wallet to [appkit-lab.reown.com/appkit/?name=solana](https://appkit-lab.reown.com/appkit/?name=solana).<br/>2. Press the "Sign Message" button.<br/>3. Accept the signature request on the wallet. | 1. N/A.<br/>2. A modal should pop up on the wallet app requesting a signature.<br/>3. Once accepted and signed, the hash should show up on the website. |e. |
| **Supporting solana_signTransaction** | 1. Connect the wallet to [appkit-lab.reown.com/appkit/?name=solana](https://appkit-lab.reown.com/appkit/?name=solana).<br/>2. Press the "Sign Transaction" button.<br/>3. Accept the signature request on the wallet. | 1. N/A.<br/>2. A modal should pop up on the wallet app requesting a signature.<br/>3. Once accepted and signed, the hash should show up on the website. |e. |
| **Supporting v0 Transactions** | 1. Connect the wallet to [appkit-lab.reown.com/appkit/?name=solana](https://appkit-lab.reown.com/appkit/?name=solana).<br/>2. Press the "Sign Versioned Transaction" button.<br/>3. Accept the signature request on the wallet. | 1. N/A.<br/>2. A modal should pop up on the wallet app requesting a signature.<br/>3. Once accepted and signed, the hash should show up on the website. |e. |


</Tab>
</Tabs>

## What's Next?

Now depending on whether or not your submission met all parameters, you will receive an email from the Reown team with the status of your submission. This change will also be reflected with more directions in the "Explorer" tab of your project.
If your submission was not accepted, you can make the necessary changes and resubmit your project for review. The reason for rejection will be mentioned in the email and in the "Explorer" tab of your project.

In case of any questions, feel free to ask on [Github Discussions](https://github.com/orgs/WalletConnect/discussions/categories/explorer-support)
For more information on how to submit your wallet, please visit the [WalletConnect WalletGuide Submission documentation](https://docs.walletconnect.network/walletguide/explorer-submission).