# Telegram Money — the native Gram wallet (https://ton-blockchain.github.io/docs/llms/onboarding/wallet-apps/telegram/content.md)



Telegram Money is a [mainnet](https://ton-blockchain.github.io/docs/llms/start-here/content.md) wallet on The Open Network (TON) for receiving assets and connecting to decentralized apps (dApps) through [TON Connect](https://ton-blockchain.github.io/docs/llms/applications/ton-connect/overview/content.md).

* **On-chain transfers:** send Gram to Telegram users, including those who have not opened the wallet yet. Transfers execute on TON through the [WalletTg smart contract](https://ton-blockchain.github.io/docs/llms/contracts/standard/wallets/telegram/overview/content.md).

* **Sponsored fees:** Telegram covers network fees for a daily allowance of five free transfers through [gasless transactions](https://ton-blockchain.github.io/docs/llms/contracts/standard/wallets/gasless/content.md).

* **One wallet across devices:** an [encrypted cloud backup](#disable-backup-or-update-the-phrase) allows using the same wallet across devices without manual imports. It splits the wallet key into **three** parts stored in data centers on **three** continents.

* **Connect dApps once:** TON Connect connections sync across devices without reconnecting each one. Each device needs the current wallet key, restored from the cloud backup or the recovery phrase.

* **Control the keys:** disable cloud backup or [rotate the signing key](#disable-backup-or-update-the-phrase) without changing the wallet address. The current recovery phrase also allows importing the wallet into another compatible wallet app.

* **Shared contract upgrades:** validators can vote to [upgrade the shared wallet implementation](https://ton-blockchain.github.io/docs/llms/contracts/standard/wallets/telegram/overview/content.md) to add features and improvements for all Telegram Money users at once, without user action. These upgrades require more than 75% of the total validator weight — neither Telegram nor anyone else can bypass validator approval to perform them.

<Callout type="note">
  For *testnet* wallets, use [wallet.ton.org](https://ton-blockchain.github.io/docs/llms/onboarding/wallet-apps/web/content.md) or [manage development wallets](https://ton-blockchain.github.io/acton/docs/wallets) with the [Acton toolchain](https://ton-blockchain.github.io/docs/llms/contracts/acton/content.md).
</Callout>

## Open or restore a wallet [#open-or-restore-a-wallet]

In Telegram Desktop, open the main menu and select <kbd>Money</kbd>. This entry appears only when Telegram enables wallet access for the account.

* To restore access on a device, use the recovery phrase:

  1. Open the Money menu and select <kbd>Keys & Backup</kbd>.
  2. Select <kbd>Restore from recovery phrase</kbd> when Telegram offers phrase-based restoration, then enter the current phrase.

* To display the phrase in Telegram Desktop, open Money's menu, select <kbd>Keys & Backup</kbd>, then <kbd>Show Recovery Phrase</kbd>.

  <Callout type="danger">
    The recovery phrase gives control of the wallet and funds. Store it securely — never share the recovery phase in plain text.
  </Callout>

* To import the phrase in another app, use an app that supports the [WalletTg](https://ton-blockchain.github.io/docs/llms/contracts/standard/wallets/telegram/overview/content.md) contract and its [rotation mnemonic format](https://ton-blockchain.github.io/docs/llms/contracts/standard/wallets/mnemonics/content.md).

## Confirm the address and connect a dApp [#confirm-the-address-and-connect-a-dapp]

1. Copy the wallet address from Telegram Money and check it in a [mainnet explorer](https://ton-blockchain.github.io/docs/llms/onboarding/explorers/content.md).
2. Start a [TON Connect](https://ton-blockchain.github.io/docs/llms/applications/ton-connect/overview/content.md) session from the dApp and confirm its name in Telegram Money.
3. Review each transaction or signing request before approving it. A connection alone does not authorize a transaction.

## Disable backup or update the phrase [#disable-backup-or-update-the-phrase]

An encrypted backup splits the wallet key into 3 parts stored across 3 continents, and then reassembles it on devices. It is done off-chain, so this backup is unavailable for wallets imported from the recovery phrase.

To disable the backup, select <kbd>Keys & Backup</kbd>, then <kbd>Disable Backup</kbd>. This reveals the phrase and asks for confirmation of selected words. When key rotation is available, <kbd>Update Secret Phrase</kbd> is optional and unchecked by default.

* Without the phrase update, Telegram disables backup after the current phrase passes the word check. The signing key does not change, so existing copies remain current.
* With the phrase update, Telegram shows the rotation fee. It prepares and displays a new phrase, then checks selected words. It disables backup only after the key rotation succeeds. Words 1-12 keep the address anchor, and words 13-24 become the new signing key.

<Callout type="note">
  If rotation fails or is canceled, the current key and backup remain unchanged.
</Callout>

If rotation succeeds but the following backup-disable request fails, the new phrase becomes the current while the backup may remain enabled with the old phrase. Keep the new phrase and verify the backup state until the request succeeds.

## Create TON Connect links [#create-ton-connect-links]

To direct users from a dApp to Telegram Money, prepare a payload for its [TON Connect link formats](https://ton-blockchain.github.io/docs/llms/onboarding/wallet-apps/deep-links/content.md):

1. Build the [standard connection query](https://ton-blockchain.github.io/docs/llms/applications/ton-connect/core-concepts/content.md) using `v`, `id`, `r`, and optional `trace_id`. For Telegram Money, use a lowercase `id`, include `ton_addr` in the [connection request](https://ton-blockchain.github.io/docs/llms/applications/ton-connect/api-reference/protocol/content.md), and use an HTTPS `manifestUrl` without credentials or a fragment.
2. Start with the percent-encoded query without its leading `?`. Encode any remaining literal `-`, `.`, `_`, and `~` as `%2D`, `%2E`, `%5F`, and `%7E`, respectively. Preserve existing percent-encoded bytes.
3. Replace `&` with `-`, `=` with `__`, and `%` with `--`.
4. Use the result as `<PACKED>` in the link format. The templates already include the `tonconnect-` prefix.

To reopen a pending request, omit `r` and include `v=2`, the existing connection's lowercase `id`, and the UUID `trace_id` sent with that request. Apply the same packing steps. The request data must already have been sent through the connection.

To decode a payload, restore `--` to `%`, then `__` to `=`, then `-` to `&`, before parsing the query.

## Learn more [#learn-more]

* [WalletTg contract](https://ton-blockchain.github.io/docs/llms/contracts/standard/wallets/telegram/overview/content.md)
