Connecting with WalletConnect
Learn how to connect your wallet using WalletConnect and AppKit.
Zipwire uses Reown AppKit (formerly Web3Modal) to provide a seamless wallet connection experience. This allows you to connect not just via browser extensions, but also via mobile wallets and smart wallets.
What is WalletConnect?
WalletConnect is an open protocol that allows your wallet to communicate with decentralized applications (dApps). Unlike browser extensions that are "injected" into your browser, WalletConnect establishes a secure, encrypted connection between the Zipwire web app and your wallet app, regardless of whether they are on the same device.
How to Connect
When you click Connect Wallet in Zipwire, you will see the AppKit connection modal. You have several options:
1. Browser Extensions (Installed)
If you have a wallet extension like MetaMask, Coinbase Wallet, or Rabby installed, it will appear at the top of the list. Simply click it to connect.
2. Mobile Wallets (QR Code)
If you want to use a wallet on your phone (like Trust Wallet, Rainbow, or MetaMask Mobile):
Select the WalletConnect option in the modal.
A QR code will appear on your screen.
Open your wallet app on your phone and look for the "Scan" or "WalletConnect" icon.
Scan the QR code.
Confirm the connection request in your mobile app.
3. Search for Your Wallet
If your wallet isn't listed in the featured section, you can use the search bar to find it among the hundreds of supported wallets.
Supported Wallet Types
Externally Owned Accounts (EOAs)
Traditional wallets like MetaMask where you manage a 12 or 24-word seed phrase.
Smart Wallets
Zipwire supports modern smart wallets, including the Coinbase Smart Wallet. These wallets often use biometrics (FaceID/TouchID) via Passkeys and don't require you to manage a traditional seed phrase. Zipwire's backend is fully compatible with EIP-1271 and ERC-6492 signature standards used by these wallets.
Benefits of AppKit
No Extension Required: You can use Zipwire even if you don't want to install browser extensions.
Multi-Device Support: Use Zipwire on your desktop while your keys stay securely on your phone.
Universal Compatibility: Support for over 100+ different wallet apps.
Network Switching: AppKit will automatically prompt you to switch to the correct network (e.g., Base) if your wallet is on the wrong one.
Troubleshooting
Connection Dropped: If your connection remains idle for a long time, it may time out. Simply refresh the page and reconnect.
Wrong Account: Ensure the account selected in your wallet app matches the one you intend to use with Zipwire.
Mobile App Closing: Some mobile operating systems may put your wallet app to sleep. Ensure your wallet app stays open until the connection is confirmed.
Privacy Tip: Using WalletConnect doesn't give Zipwire access to your funds. It only allows Zipwire to see your public address and request your signature for specific actions like logging in or claiming attestations.
Last updated