Skip to main content

Binance Web3 Wallet Project Side Self-testing Checklist (2024-05)

SDK integration, dApps listing are independent. Well-tested dApps will help to reduce partly Campaign workload.


For all parties interested in establishing cooperation with Binance Web3 Wallet, this manual contains all relevant information, including integrating the Binance Web3 Wallet SDK and joining the Binance Web3 Wallet dApp Zone.

Self-testing by the project party is essential. The Binance Web3 Wallet team strongly recommends that all projects complete self-testing following the instructions provided, as this will enhance user experience to the fullest extent possible.

Binance reserves the right to reject applications from projects with low testing quality. Please read the following content carefully.

How to whitelist dApp URLs#

  1. Go to Binance Developer Center
  2. Submit the dApp application form, especially all the used URLs in your projects
  3. Waiting for the approval

How to test dApp#

  1. After submitting the Listing dApp request and the status is 'Approved'
  2. Scan QR code in Binance App, and type the main URL in the browser


  1. Test all the features in dApps

Frequent Problems for dApp#

Error Message : 'Network not supported for this wallet'#

Project side should detect and change to the corresponding chain when users connect. For BEVM, check the window.ethereum chainId is what, if not what they expected to call cut chain cut past.

IOS/Android Login Problem#

Check SDK status and Internet/VPN connection.

RPC Problem#

When testing on chain actions, sometimes projects side find the gas fee is abnormally high. In this case, Project side could test in Trust Wallet and other Wallets like Metamask. If it happens in Trust Wallet and Binance Wallet only, it will be the RPC problem of Binance, please contact Jasmine G @P0kEjasmine.

Frequent Problems for SDK#

Website Login Error#

After SDK connection. User action line is:

[Connect Wallet] -> click [Binance Web3 Wallet] -> [Scan with Binance web3 Wallet]


When using a VPN or other tools, it's important for both the phone and computer to be on the same network.

Mobile Login Error#

Check the Binance App version for both IOS and Android, should keep the latest version.

Test Case Checklist#


CategoryFeature (Web, IOS and Android)
Connect WalletCan get wallet address and chainID.
Send TransactionThe whole transaction process should be successful and can be checked on the chain.
Sign messageThe signature value should be valid


CategoryFeature (IOS and Android)
Connect WalletWallet connects successfully and stably. (Without page redirection)
Binance Logo Exposure Success (Web & App)
Send TransactionAll send transaction cases are successful. (e.g. Swap, Approve, etc.)
The gas fee is in the normal range.
User ExperienceThe font size and icons are displayed appropriately.
All the URLs in the dApp can be opened in Binance directly.
The project will automatically switch to the user's current chain if it is supported.
All cases should be checked in both IOS and Android