TON Connect and how to connect apps

What is TON Connect

TON Connect is a service that allows you to connect TON blockchain wallets to third-party bots, apps or websites. This way, you’ll be able to perform transactions quickly, as well as participate in promotions and receive rewards straight to the specified non-custodial TON Wallet.

Is it safe to connect my TON address via TON Connect

It is your responsibility to do your own due diligence review of any third-party app to which you are trying to connect. 

The process of connecting an app does not give access to your wallet assets - it only gives you the means to confirm transactions.

Below you can see an example of connecting Yescoin app to TON Wallet. Please note that this example is provided for illustrative purpose only, and is neither intended as, nor shall be considered or construed as a recommendation or advice.

After connecting, an app may ask for your confirmation to complete a transaction. All transactions sent via apps require your personal confirmation to proceed. This provides additional security — allowing you to check the validity of data prior to completing a transaction. 

Remember that TON Wallet does not verify, curate or control other app’s content and utilities. You access, rely upon and use any app at your own risk. 

Below you can see an example of confirming a transaction in the Catizen app.

Important: always check transactions prior to confirming them. Check the transaction amount and make sure that you know and trust the recipient or service where you are sending your cryptocurrency.

What are the benefits of TON Connect authorization

By connecting your TON Wallet to other apps via TON Connect, you can:

  • Securely and conveniently connect your wallet address on the TON blockchain
  • Swiftly create and confirm transactions — no need to input an address, sum, and other transfer details
  • Participate in promotions within the TON ecosystem and receive rewards straight to your TON Wallet

How to connect TON Wallet to an app

Remember to do your own prior due diligence review of any app to which you are trying to connect your TON Wallet.

The app will prompt you to connect a TON-based wallet to their service. In the next window, confirm the connection by tapping on ‘Open Wallet in Telegram’.

If you did not already create a TON Wallet, you will be able to do that in the process of connection. Make sure to save your 24-word secret phrase securely. Without it, you may lose access to the wallet you just created.

We also recommend that you turn on email recovery to log in to TON Wallet more quickly. See how to do it here.

How to disconnect TON Wallet from an app / from several apps

To disconnect from an app:

  • Go to Crypto Wallet settings and select TON Wallet
  • After that, enter the ‘Connected Apps’ section
  • Tap on the disconnect icon

You can also tap ‘Disconnect All Apps’ to close all connections to your TON Wallet account. If you need to reconnect to an app later, you can always go to the app and connect your TON Wallet again.

I am not able to connect my TON Wallet to an app. I receive an App Manifest Error

It is likely that the error is on the side of the app you tried to connect to your TON Wallet. Firstly, we recommend that you try fixing the error with the following technical advice:

1. Try connecting the app using a different Internet connection. For example, if you used Wi-Fi, switch to mobile data instead or vice versa.

2. Restart your device and try again.

3. Enable the ‘Set time automatically’ feature on your device. It can be done in the ‘Date and Time’ section of your device settings.

If these steps didn’t help, try to log out of TON Wallet, clear your Telegram app cache, log in to TON Wallet again and repeat the transaction.


How to clear the app cache?

- For iOS: Go to Telegram Settings > Data and Storage > Storage Usage > Clear cache.

- For Android: Go to Settings > Apps > Telegram > Clear cache, and then Settings > Apps > Android System WebView > Clear cache.

Important: Before clearing cache, be sure to save your TON Wallet Secret Recovery Phrase or enable the email recovery function. You can find the Secret Recovery Phrase or enable email recovery in TON Wallet settings, by tapping on the 3 dots in the app’s upper right corner.


I followed the instructions but still get the error

If you have followed the instructions above but the error persists, you need to contact the support of the app you failed to connect to, and discuss possible solutions with them.

You can also copy the error details by tapping the button on the error page. This information will help the app support to get a better understanding of the failure reason and advise you further.

I disconnected TON Wallet from an app, but I still see my wallet address when I open the app

First, check if the app is listed in the ‘Connected Apps’ section of your TON Wallet settings.

If it is listed there, try to disconnect it from TON Wallet. Tap on the app name in ‘Connected Apps’, and then tap on ‘Disconnect’ to confirm the action.

If you do not see the app in your 'Connected Apps' section, but you still see your wallet address in the app interface, you will need to contact support of the app directly. Even though you disconnected the app from your TON Wallet, it’s possible that a bug or interface error in the specific app is causing your wallet address to still appear there.

I connected an app to TON Wallet, but now I can’t confirm a transaction in the app. I see a blank screen or an error 'No request received' after being redirected to TON Wallet

In this situation, the transaction cannot be created due to one of the following reasons:

  • TON Connect error
  • Your current non-custodial TON Wallet address differs from the address linked earlier

Follow these instructions to find the cause of the problem.


1) Check your current TON Wallet address matches the one you linked.

It is possible that the linked address is different from your main TON Wallet address. This can happen in the following cases:

1. You logged in to TON Wallet from another device and created a new address in the app. Read how to change a wallet address here.

2. You use different Telegram accounts, with different TON Wallet addresses.

3. You are seeing your blockchain address for your Crypto Wallet account, not your TON Wallet. The address that gets bound to apps is visible in the TON Wallet tab on Crypto Wallet's main page. Read about the differences between Crypto Wallet and TON Wallet here.


2) If your current and linked TON Wallet addresses match, but the transaction still cannot be created, try to reconnect TON Wallet. To do this, you need to enter the app where you are trying to perform the transaction, unbind your TON Wallet address via a special button and then to rebind it once again. If you have trouble doing so, contact the app support for further assistance.

I connected an app to my TON Wallet, but now I don’t see it among the connected apps in TON Wallet

Check the device from which you connected the app to your TON Wallet.

Connected apps are only visible on the device that made the connection.

For example, if you connect the app on your smartphone, it will be visible exclusively on your smartphone, and not on your PC or in a browser.

If you are using the same device, but still do not see the connection in ‘Connected Apps’, then you need to reconnect your TON Wallet to the corresponding app.

I’ve connected my TON Wallet to an app, but there’s no wallet address in the app

Check if you see the app listed in the ‘Connected Apps’ section in TON Wallet settings.

If you see the app name, try to unbind it from TON Wallet and reconnect again. Tap on the corresponding name in ‘Connected Apps’, and then tap on ‘Disconnect’ to confirm the action. After that, return to the app and reconnect your TON Wallet to it.

If you do not see the app listed at all, return to the app and reconnect your TON Wallet to it again.

Is it possible for anyone to access my non-custodial TON Wallet using TON Connect

It is the responsibility of a non-custodial wallet’s owner to keep it secure. The owner has the only means to access the wallet because they are the only party that has access to its Secret Recovery Phrase. This gives you full ownership of your assets, but also requires you to be careful while using your TON Wallet.

You should always check carefully any transaction requests sent to you in TON Wallet.

Below you can see an example of connecting the GetGems app to TON Wallet. The example does not serve as a recommendation and is provided for illustrative purposes only.

This action itself doesn’t give the app permission to move funds inside the non-custodial wallet.


With TON Connect, you give an app the permission to send transaction confirmation requests to your TON Wallet. Only you can confirm the transaction, so it’s important to do your own prior due diligence review of the app and verify all the transfer information before confirming the transaction, to avoid potential mistakes or losses.

Below you can see an example of confirming a transaction in GetGems.

Also, it’s important to keep in mind that a Secret Recovery Phrase grants access to TON Wallet. Therefore, keep your Recovery Phrase in a safe place, accessible only to you and never share it with anyone.

I accidentally shared my Recovery Phrase with a third-party app

In this situation, you should replace your TON Wallet as quickly as possible by creating a new TON-blockchain wallet address.

Once you create the new wallet, write down its Recovery Phrase (don’t share it with anyone!) and immediately transfer all the funds from your previous TON Wallet to the new wallet address. After doing so, you should remove the compromised TON Wallet from your Crypto Wallet app. You can do so via these instructions.

After removing the compromised TON Wallet, you can create a new TON Wallet and transfer the funds back to it. Your new TON Wallet will have a new Recovery Phrase and be completely separate and safe from the one you removed.

Under no circumstances should you ever share your Recovery Phrase with anyone. There is never a technical reason to share it — if someone tries to persuade you to do so, ignore them and block their account on whichever platform they’re using to contact you.

I connected my TON Wallet to an unknown app. I tapped on the ‘Confirm’ button and lost my funds. Can I get them back

Once the transfer is successfully initiated, it is impossible to return any funds — as blockchain transactions are irreversible.

By tapping the ‘Confirm’ button, you confirm the transfer of funds, so please always check who you’re sending funds to, and the details of the transaction, as the amount might be different than expected. Similarly, you should never send cryptocurrency or collectibles to unknown people or services.

To keep your TON Wallet secure, do not connect to unverified apps and never share your Recovery Phrase or account details with anyone.

Read more about fake bots on Telegram here.

Can I delete a TON Wallet if I created it to connect to an app and don't need it anymore

When you activated your TON Wallet you created a non-custodial wallet address in the TON blockchain. This address can not be deleted because any blockchain address exists as part of the blockchain ledger. 

Though, if you do not need it, you can remove your non-custodial TON address from your account by going to Settings > TON Wallet > Remove TON Wallet.

After removal, your TON Wallet will still be available if you have your Secret Recovery Phrase saved, or if you have account recovery via email enabled.

We recommend you save your Secret Recovery Phrase, so that you can access your TON Wallet again in the future if needed. You can also turn on email recovery, which makes it possible to log in to TON Wallet from a linked Telegram account without needing to input your 24-word Recovery Phrase every time. Read more on how email recovery works here.

You can see instructions on how to use TON Wallet here.

Which services can I connect to via TON Connect

There is a broad range of apps that you can connect to from within Telegram or from your browser.

However, please remember that you must do your own prior due diligence review of every app before connecting it through TON Connect to your TON Wallet, and you need to understand and evaluate the risks of using such apps.

Disclaimer: this article is created for informational purposes only.

No communication or information provided to you by TON Wallet is intended as, or shall be considered or construed as, investment advice, financial advice, trading advice, or any other sort of advice.

You are solely responsible for determining whether any protocol, cryptocurrency, investment strategy or related transaction is appropriate for you according to your personal investment objectives, financial circumstances and risk tolerance. 

TON Wallet does not endorse or guarantee the accuracy, reliability, or security of any external content or services that may be accessible through or interact with TON Wallet.