AppKit FAQs

1. Create a valid project ID at https://dashboard.reown.com/
2. Add it to your AppKit configuration:

const modal = createAppKit({
  ...
  projectId: "..." // Add your valid projectId here
});

3. Ensure that you have added your domain to the allowed domains in your project settings. If you have not done so, you can do so by navigating to “Project Domains” on the Dashboard, clicking on “Configure Domains” and adding your domain.

SocketException: Failed host lookup: 'relay.walletconnect.org' (OS Error: No address associated with hostname, errno = 7)

​

Common causes and steps to resolve:

1. VPN or Firewall settings

• Some VPNs may block access to the relay service.
• If you are using a VPN (e.g., Windscribe), try:
  • Switching the VPN protocol to WStunnel.
  • Turning off the Firewall toggle in your VPN settings.

2. Network restrictions

• If you’re on a restricted network (e.g., public Wi-Fi, corporate network, or in a restricted country), the relay service may be blocked.
• Try switching to a different ISP or network.

3. Connectivity issues

• Confirm that you can reach relay.walletconnect.org.
• A 100% packet loss when pinging may indicate the service is blocked on your network.

1. Version Mismatch: Ensure all @reown libraries use the same version in your package.json:

{
  "dependencies": {
    "@reown/appkit": "1.7.8",
    "@reown/appkit-adapter-wagmi": "1.7.8"
    // ... other dependencies
  }
}

2. Initialization Location: Call createAppKit outside of your component to ensure proper initialization:

// Create modal
createAppKit({
  adapters: [wagmiAdapter],
  ...generalConfig,
  features: {
    analytics: true // Optional - defaults to your Cloud configuration
  }
})

export function App() {
  return (
    <WagmiProvider ...>
      <QueryClientProvider ...>
        <appkit-button />
      </QueryClientProvider>
    </WagmiProvider>
  )
}

• Live Demo
• Source Code

import { useAppKitAccount } from '@reown/appkit/react'

// Get account states for different chains
const eip155AccountState = useAppKitAccount({ namespace: 'eip155' })
const solanaAccountState = useAppKitAccount({ namespace: 'solana' })

<>
  EVM Address: {eip155AccountState.address}<br />
  Solana Address: {solanaAccountState.address}<br />
</>

​

Why this happens

​

Workarounds for users

1. Open in external browser: Most in-app browsers have an option to open the current page in the device’s default browser (usually accessible via a menu or “Open in Browser” button). From the external browser, wallet deep links will work as expected.
2. Copy the link and paste in browser: Users can copy the dApp URL and paste it into their preferred mobile browser (Chrome, Firefox, etc.).
3. Use QR code scanning: If the user has their wallet app open, they can use the wallet’s built-in QR code scanner to scan the WalletConnect QR code displayed in the AppKit modal, which bypasses the need for deep linking entirely.
4. Use the wallet’s built-in browser: Many wallet apps (MetaMask, Trust Wallet, etc.) have their own built-in dApp browsers. Users can navigate to the dApp directly within their wallet app for a seamless experience.

​

For app developers embedding WebViews