← Back to Hub Aggregator

TON Wallet Setup Guide 2025-2026

Updated: February 2026 • Setup guide • Related: TON × Telegram integrationSecurity & scam guide
Hub Aggregator experience: Wallet setup guidance in this guide is informed by Hub Aggregator's experience connecting 1,200+ Telegram mini apps to TON wallets since 2024 — including common connection patterns, permission structures, and security incidents observed in our catalog.

A TON wallet is your gateway to the direct crypto-earning layer of Telegram. Without one, you're limited to Stars-based apps that require an extra conversion step to access real money. With a TON wallet, you can receive direct TON payouts from mini apps, use DeFi platforms, stake TON for passive yield, and cash out to exchanges — all from inside Telegram.

This guide covers both main wallet options (TON Space and Tonkeeper), walks through the complete setup process, and explains how to connect to mini apps safely. Setup takes 5–10 minutes. Getting the seed phrase backup right takes an extra 2 minutes — and is the most important part of the entire process.

Wallet Options: TON Space vs Tonkeeper

FeatureTON SpaceTonkeeper
LocationBuilt into TelegramSeparate app (iOS/Android)
Custodial?No (non-custodial)No (non-custodial)
Setup time2–3 minutes5–10 minutes
Mini app connectionSeamless (in-app)Via TON Connect (QR/deep link)
DeFi accessBasicFull (STON.fi, DeDust, staking)
Multi-accountLimitedYes — multiple wallets
NFT managementBasic viewingFull management
Best forDaily mini app earningsDeFi, savings, long-term storage
Recommended setup: Use both. TON Space for daily mini app connections and quick transfers inside Telegram. Tonkeeper for larger balances, DeFi activity, and as your primary non-Telegram wallet. Treat them as current account (TON Space) and savings account (Tonkeeper).

Setting Up TON Space (Built-in Telegram Wallet)

  1. Open Telegram and search for @wallet or tap the Wallet tab if visible in your main menu
  2. Follow the onboarding prompts to create your TON Space wallet
  3. When shown your 24-word seed phrase: write it down on paper immediately — do not screenshot, do not type in notes, do not photograph
  4. Verify you've written it correctly by entering it back when prompted
  5. Enable biometric authentication (fingerprint/Face ID) for quick access
  6. Send a small test amount (0.01 TON from an exchange or friend) to confirm your address receives correctly

TON Space is now available in most regions. If the Wallet tab doesn't appear in your Telegram, search "@wallet" in the app search bar and start the bot. Regional availability may require a VPN in some markets.

Setting Up Tonkeeper

  1. Download Tonkeeper from the official App Store or Google Play. Verify it's the official app — search "Tonkeeper" and check the developer is "TON Foundation"
  2. Open the app and tap Create new wallet
  3. Your 24-word recovery phrase appears — write all 24 words in order on paper. Then store the paper in two different physical locations (e.g., home and a trusted secondary location)
  4. Complete the seed phrase verification quiz Tonkeeper presents
  5. Set up a passcode and enable biometrics
  6. Your wallet address appears — it starts with "UQ..." or "EQ..." and looks like UQBvW8Y...
  7. Send a test receive: transfer 0.05 TON to this address from an exchange and confirm it arrives
Seed phrase is everything: If you lose your phone and have no seed phrase, your funds are gone permanently. There is no "forgot password" for a non-custodial wallet. Write it down. Store it offline. Test that you can read your own handwriting. Never store it digitally — not in iCloud, Google Drive, notes apps, photos, or anywhere a hack could access it.

Connecting Your Wallet to Telegram Mini Apps

Connecting Tonkeeper via TON Connect

  1. Open the mini app in Telegram and look for a Connect Wallet button
  2. The app will display a QR code or a deep link button
  3. In Tonkeeper, tap the scanner icon and scan the QR code — OR tap the deep link button which opens Tonkeeper automatically
  4. Tonkeeper shows you exactly what permissions the app is requesting — read this carefully
  5. Tap Connect to approve. Your wallet address is now linked to the app for payouts

Connecting TON Space

For apps that support native Telegram Wallet integration, tap Connect Wallet inside the mini app — TON Space connects automatically without leaving Telegram. Some apps show a "Connect via Telegram Wallet" option specifically for TON Space users.

What Permissions to Watch For

A legitimate earning app only needs to read your wallet address. Be cautious if the connection request asks for:

Address-only connections are completely safe. Any additional permissions require careful evaluation of whether you trust that specific app.

Complete Security Checklist

Common Setup Mistakes

Receiving Payouts from Earning Apps

Once your wallet is connected, most earning apps send TON payouts automatically when you request a withdrawal — typically to the address you connected during setup. The process is:

  1. Reach the app's withdrawal minimum
  2. Tap "Withdraw" or "Cash out" inside the app
  3. Confirm the amount and destination address
  4. TON arrives in your wallet within seconds to minutes (TON blockchain is fast)
  5. Verify receipt in your wallet and on tonviewer.com
Connect Wallet and Earn TON in Hub Aggregator →

Frequently Asked Questions

Which is better: Tonkeeper or TON Space?

Both serve different purposes. TON Space (built into Telegram) is best for daily mini app interactions — no app switching required. Tonkeeper is better for DeFi, multi-account management, and storing larger balances. Most experienced earners use both: TON Space for daily earning, Tonkeeper for savings and DeFi activity.

How long does TON wallet setup take?

TON Space takes 2–3 minutes inside Telegram. Tonkeeper takes 5–10 minutes including download, wallet creation, and seed phrase backup. Don't rush the seed phrase backup step — it's the most important part of the entire process and should be done carefully.

What happens if I lose my seed phrase?

If you lose your seed phrase and lose access to your device, your wallet funds are permanently unrecoverable. No customer support, no password reset, no way to restore access. This is why offline backup in two physical locations is non-negotiable — treat it like cash in an envelope.

How do I connect my TON wallet to Telegram mini apps?

Most mini apps show a Connect Wallet button that initiates a TON Connect request. In Tonkeeper, scan the QR code or tap the deep link and approve in the app. In TON Space, connection happens within Telegram automatically. Always review what permissions the connection is requesting before approving.

Is using a TON wallet inside Telegram safe?

Using a non-custodial wallet (Tonkeeper or TON Space) is safe when you follow basic practices: never share your seed phrase, review connection permissions before approving, revoke old connections, keep large balances on a separate wallet from your daily earning wallet, and back up your seed phrase offline.