How do I connect to dapps?

Freighter's flagship feature is the ability to connect and interact with decentralized applications (or dapps). This article will walk you through how to connect your Freighter wallet to these applications using both the browser extension and mobile app.

Once connected, dapps can view your selected account's public key and request transaction, message, or authorization entry signatures.

Freighter also maintains a list of dapps you've approved connection requests for. See How do I revoke access from dapps? for how to manage this list.

Using the browser extension

Connecting to a dapp using the Freighter extension starts with opening the dapp in your browser, or you can browse available dapps in the Stellar ecosystem by opening Freighter, selecting the "Discover" button in the top right corner, and selecting "Open" next to your dapp of choice.

Once you're on the site, look for a "Connect Wallet", "Sign In", or similar button or prompt. If the dapp supports multiple wallets, you may be asked to select your wallet first, in which case you can select Freighter.

If this is your first time connecting to this dapp, a Freighter popup will open displaying a connection request. Approving the connection enables the dapp to view your public key, and therefore view your account's activity on Stellar, as well as request transaction, message, and authorization entry signatures.

Using the mobile app

On mobile, you can connect to dapps from your desktop browser, mobile browser, or from within Freighter's in-app browser.

On your desktop browser

To connect to a dapp from your desktop browser, select the "Connect Wallet", "Sign In", or similar button or prompt on the website.

Importantly, select "WalletConnect" instead of "Freighter". Freighter mobile connects to dapps using WalletConnect, and in this context, "Freighter" refers to the extension.

The dapp should display a QR code for you to scan. Open your mobile app, select the icon in the top right to open the QR code scanner, and scan the QR code.

On your mobile browser

To connect to a dapp from your mobile browser, take the same approach of selecting "Connect Wallet" or "Sign In" and then "WalletConnect".

However, instead of scanning the QR code, copy the connection URI by selecting the copy button in the top-right corner. Switch to the Freighter mobile app, select the QR code scanner icon in the top right, and paste the URI in the input field.

From the in-app browser

The best way to connect to dapps using the mobile app is through our in-app browser.

To get started, open Freighter and navigate to the Discover tab by selecting the compass icon at the bottom of the screen. From here, you can browse available dapps in the Stellar ecosystem and select one to open it, or provide the dapp URL directly in the search bar at the top of the screen.

Select "Connect Wallet", "Sign In", or similar prompt on the dapp site. Some dapps detect that you're on a mobile device and will immediately show you the WalletConnect-hosted wallet selection menu, otherwise select "WalletConnect" instead of "Freighter" to proceed.

If this is the first time you've connected to this dapp from mobile, you may need to select "View All" and search "Freighter" in the search bar. Otherwise, select "Freighter".

Connection Requests

Regardless of how you connect to a dapp, Freighter will ultimately display a connection request for the dapp. Make sure domain matches the URL in the browser, and that the connection request is for the correct Stellar account and network.

If everything looks correct, select "Connect" to approve the connection request. Approving the connection enables the dapp to view your public key, and therefore view your account's activity on Stellar, as well as request transaction, message, and authorization entry signatures.