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 in your TON Space.

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 Space. 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 Space 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 Space 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 Space

How to connect TON Space to an app

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

The app will prompt you to connect a TON 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 Space, 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 Space more quickly. See how to do it here.

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

To disconnect from an app:

  • Go to Wallet settings and select TON Space
  • 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 Space account. If you need to reconnect to an app later, you can always go to the app and connect your TON Space again.

I am not able to connect my TON Space 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 Space 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 use Wi-Fi, then switch to mobile data, or vice versa.

2. Restart your device and try again.

3. Enable "Set time automatically" feature on your device. It can be done in "Settings" → "Date and time" section.

If these steps didn’t help, try to log out of the TON Space wallet, clear your Telegram app cache, log in to TON Space 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 Space Secret Recovery Phrase or enable the email recovery function. You can find the Secret Recovery Phrase or enable email recovery in TON Space 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 Space 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 Space settings.

If it is listed there, try to disconnect it from TON Space. 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 TON 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 Space, it’s possible that a bug or interface error in the specific app is causing your TON wallet address to still appear there.

I connected an app to TON Space, 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 Space

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

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

Follow these instructions to find the cause of the problem.


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

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

1. You logged in to TON Space 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 Space addresses.

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


2) If your current and linked TON Space addresses match, but the transaction still cannot be created, try to reconnect TON Space. To do this, you need to enter the app where you are trying to perform the transaction, unbind your TON Space 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 Space, but now I don’t see it among the connected apps in TON Space

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

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 Space to the corresponding app.

I’ve connected my TON Space 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 Space settings.

If you see the app name, try to unbind it from TON Space 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 Space to it.

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

Is it possible for anyone to access my non-custodial wallet at TON Space 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 Space.

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

Below you can see an example of connecting the GetGems app to TON Space. 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 Space. 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 Space. 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 Space as quickly as possible by creating a new TON wallet.

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 Space to the new wallet address. After doing so, you should remove the compromised TON Space from your Wallet app. You can do so via these instructions.

After removing the compromised TON Space, you can create a new TON Space and transfer the funds back to it. Your new TON Space 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 Space 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 Space 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.

I created a TON Space to connect to an app, but I don’t need it anymore. How can I delete it

When you activated your TON Space you created a non-custodial TON wallet address. 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 Space > Remove TON Space.

After removal, your TON wallet address 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 Space again in the future if needed. You can also turn on email recovery, which makes it possible to log in to TON Space 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 Space 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 Space, and you need to understand and evaluate the risks of using such apps.