Skip to Content
On this page

This guide shows you how to open and test your dApp inside the MyDoge app before it’s listed. You don’t need a listing, an email allowlist or a developer mode.

What You Need#

  • MyDoge from the App Store or Google Play, up to date.
  • Your dApp on a public https:// URL. Staging sites and tunnels such as ngrok or Cloudflare Tunnel work. http://, localhost and LAN addresses don’t.
  • That origin registered on your Sandbox client ID in the developer console .
  • Testnet funds on DogeOS Chikyū Testnet if you’ll send transactions. See the faucets.

Open Your dApp#

  1. In MyDoge, open Settings → Advanced Settings and turn on Allow unlisted dApps. If you don’t see the setting, update MyDoge from the App Store or Google Play.
  2. From Home, tap Search, enter your full URL and submit it. If Search doesn’t accept a URL, fully close and reopen MyDoge to apply the latest update; it can take two restarts.
  3. Check the address on the intro screen and tap Open unofficial dApp.

An unlisted dApp gets wallet access only on the origin you opened. If your app moves to another origin, open that origin separately.

To send testers a link that opens your dApp directly, build a mydoge://dapp link with mode=unofficial, encoding each value once:

const fields = {
  mode: "unofficial",
  url: "https://staging.mydapp.xyz/",
  name: "My dApp Test", // optional, up to 80 characters
}
 
const link =
  "mydoge://dapp?" +
  Object.entries(fields)
    .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)
    .join("&")

For every field and the limits MyDoge enforces, see Test link parameters.

Testers still need Allow unlisted dApps turned on, and they always see the intro screen.

Test Checklist#

  • Open the dApp through Search and through a test link.
  • Connect from your connect button, and reject a connection request.
  • Confirm eth_chainId returns 0x5fdaf3 (6281971).
  • Sign a personal_sign message and verify the signature.
  • Sign typed data with a classic wallet. See the known limitation for social wallets.
  • Send a transaction on Chikyū, reject another, and confirm your dApp handles the rejection.
  • Switch the wallet or account while a request is pending. The request should be cancelled.
  • Disconnect, then close and reopen the dApp.

If something doesn’t work, see Testing an Unlisted dApp in Troubleshooting.