> ## Documentation Index
> Fetch the complete documentation index at: https://companyname-a7d5b98e-wallet-ton-org.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# wallet.ton.org

export const Image = ({src, darkSrc, alt = "", darkAlt, href, target, height = 342, width = 608}) => {
  const isSVG = src.match(/\.svg(?:[#?].*?)?$/i) !== null;
  const shouldInvert = isSVG && !darkSrc;
  const shouldCreateLink = href !== undefined;
  const minPx = 9;
  const maxPx = 608;
  const expectedPx = `a number or a string with a number that is greater than ${minPx - 1} and less than or equal to ${maxPx}`;
  const createInvalidPropCallout = (title, received, expected) => {
    return <Danger>
        <span className="font-bold">
          Invalid <code>{title.toString()}</code> passed!
        </span>
        <br />
        <span className="font-bold">Received: </span>
        {received.toString()}
        <br />
        <span className="font-bold">Expected: </span>
        {expected.toString()}
        {}
      </Danger>;
  };
  const checkValidDimensionValue = value => {
    switch (typeof value) {
      case "string":
      case "number":
        const num = Number(value);
        return Number.isSafeInteger(num) && num >= minPx && num <= maxPx;
      default:
        return false;
    }
  };
  let callouts = [];
  if (height && !checkValidDimensionValue(height)) {
    callouts.push(createInvalidPropCallout("height", height, expectedPx));
  }
  if (width && !checkValidDimensionValue(width)) {
    callouts.push(createInvalidPropCallout("width", width, expectedPx));
  }
  if (callouts.length !== 0) {
    return callouts;
  }
  const heightPx = Number(height);
  const widthPx = Number(width);
  const images = <>
      <img className="block dark:hidden" src={src} alt={alt} {...height && ({
    height: heightPx
  })} {...width && ({
    width: widthPx
  })} {...(shouldCreateLink || shouldInvert) && ({
    noZoom: "true"
  })} />
      <img className={`hidden dark:block ${shouldInvert ? "invert" : ""}`} src={darkSrc ?? src} alt={darkAlt ?? alt} {...height && ({
    height: heightPx
  })} {...width && ({
    width: widthPx
  })} {...(shouldCreateLink || shouldInvert) && ({
    noZoom: "true"
  })} />
    </>;
  if (shouldCreateLink) {
    return <a href={href} target={target ?? "_self"}>
        {images}
      </a>;
  }
  return images;
};

export const Aside = ({type = "note", title = "", icon = "", iconType = "regular", children}) => {
  const asideVariants = ["note", "tip", "caution", "danger"];
  const asideComponents = {
    note: {
      outerStyle: "border-sky-500/20 bg-sky-50/50 dark:border-sky-500/30 dark:bg-sky-500/10",
      innerStyle: "text-sky-900 dark:text-sky-200",
      calloutType: "note",
      icon: <svg width="14" height="14" viewBox="0 0 14 14" fill="currentColor" xmlns="http://www.w3.org/2000/svg" className="w-4 h-4 text-sky-500" aria-label="Note">
          <path fill-rule="evenodd" clip-rule="evenodd" d="M7 1.3C10.14 1.3 12.7 3.86 12.7 7C12.7 10.14 10.14 12.7 7 12.7C5.48908 12.6974 4.0408 12.096 2.97241 11.0276C1.90403 9.9592 1.30264 8.51092 1.3 7C1.3 3.86 3.86 1.3 7 1.3ZM7 0C3.14 0 0 3.14 0 7C0 10.86 3.14 14 7 14C10.86 14 14 10.86 14 7C14 3.14 10.86 0 7 0ZM8 3H6V8H8V3ZM8 9H6V11H8V9Z"></path>
        </svg>
    },
    tip: {
      outerStyle: "border-emerald-500/20 bg-emerald-50/50 dark:border-emerald-500/30 dark:bg-emerald-500/10",
      innerStyle: "text-emerald-900 dark:text-emerald-200",
      calloutType: "tip",
      icon: <svg width="11" height="14" viewBox="0 0 11 14" fill="currentColor" xmlns="http://www.w3.org/2000/svg" className="text-emerald-600 dark:text-emerald-400/80 w-3.5 h-auto" aria-label="Tip">
          <path d="M3.12794 12.4232C3.12794 12.5954 3.1776 12.7634 3.27244 12.907L3.74114 13.6095C3.88471 13.8248 4.21067 14 4.46964 14H6.15606C6.41415 14 6.74017 13.825 6.88373 13.6095L7.3508 12.9073C7.43114 12.7859 7.49705 12.569 7.49705 12.4232L7.50055 11.3513H3.12521L3.12794 12.4232ZM5.31288 0C2.52414 0.00875889 0.5 2.26889 0.5 4.78826C0.5 6.00188 0.949566 7.10829 1.69119 7.95492C2.14321 8.47011 2.84901 9.54727 3.11919 10.4557C3.12005 10.4625 3.12175 10.4698 3.12261 10.4771H7.50342C7.50427 10.4698 7.50598 10.463 7.50684 10.4557C7.77688 9.54727 8.48281 8.47011 8.93484 7.95492C9.67728 7.13181 10.1258 6.02703 10.1258 4.78826C10.1258 2.15486 7.9709 0.000106649 5.31288 0ZM7.94902 7.11267C7.52078 7.60079 6.99082 8.37878 6.6077 9.18794H4.02051C3.63739 8.37878 3.10743 7.60079 2.67947 7.11294C2.11997 6.47551 1.8126 5.63599 1.8126 4.78826C1.8126 3.09829 3.12794 1.31944 5.28827 1.3126C7.2435 1.3126 8.81315 2.88226 8.81315 4.78826C8.81315 5.63599 8.50688 6.47551 7.94902 7.11267ZM4.87534 2.18767C3.66939 2.18767 2.68767 3.16939 2.68767 4.37534C2.68767 4.61719 2.88336 4.81288 3.12521 4.81288C3.36705 4.81288 3.56274 4.61599 3.56274 4.37534C3.56274 3.6515 4.1515 3.06274 4.87534 3.06274C5.11719 3.06274 5.31288 2.86727 5.31288 2.62548C5.31288 2.38369 5.11599 2.18767 4.87534 2.18767Z"></path>
        </svg>
    },
    caution: {
      outerStyle: "border-amber-500/20 bg-amber-50/50 dark:border-amber-500/30 dark:bg-amber-500/10",
      innerStyle: "text-amber-900 dark:text-amber-200",
      calloutType: "warning",
      icon: <svg className="flex-none w-5 h-5 text-amber-400 dark:text-amber-300/80" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" aria-label="Warning">
          <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"></path>
        </svg>
    },
    danger: {
      outerStyle: "border-red-500/20 bg-red-50/50 dark:border-red-500/30 dark:bg-red-500/10",
      innerStyle: "text-red-900 dark:text-red-200",
      calloutType: "danger",
      icon: <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" fill="currentColor" className="text-red-600 dark:text-red-400/80 w-4 h-4" aria-label="Danger">
          <path d="M17.1 292c-12.9-22.3-12.9-49.7 0-72L105.4 67.1c12.9-22.3 36.6-36 62.4-36l176.6 0c25.7 0 49.5 13.7 62.4 36L494.9 220c12.9 22.3 12.9 49.7 0 72L406.6 444.9c-12.9 22.3-36.6 36-62.4 36l-176.6 0c-25.7 0-49.5-13.7-62.4-36L17.1 292zm41.6-48c-4.3 7.4-4.3 16.6 0 24l88.3 152.9c4.3 7.4 12.2 12 20.8 12l176.6 0c8.6 0 16.5-4.6 20.8-12L453.4 268c4.3-7.4 4.3-16.6 0-24L365.1 91.1c-4.3-7.4-12.2-12-20.8-12l-176.6 0c-8.6 0-16.5 4.6-20.8 12L58.6 244zM256 128c13.3 0 24 10.7 24 24l0 112c0 13.3-10.7 24-24 24s-24-10.7-24-24l0-112c0-13.3 10.7-24 24-24zM224 352a32 32 0 1 1 64 0 32 32 0 1 1 -64 0z"></path>
        </svg>
    }
  };
  let variant = type;
  let gotInvalidVariant = false;
  if (!asideVariants.includes(type)) {
    gotInvalidVariant = true;
    variant = "danger";
  }
  const iconVariants = ["regular", "solid", "light", "thin", "sharp-solid", "duotone", "brands"];
  if (!iconVariants.includes(iconType)) {
    iconType = "regular";
  }
  return <>
      <div className={`callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border ${asideComponents[variant].outerStyle}`} data-callout-type={asideComponents[variant].calloutType}>
        <div className="mt-0.5 w-4" data-component-part="callout-icon">
          {}
          {icon === "" ? asideComponents[variant].icon : <Icon icon={icon} iconType={iconType} size={14} />}
        </div>
        <div className={`text-sm prose min-w-0 w-full ${asideComponents[variant].innerStyle}`} data-component-part="callout-content">
          {gotInvalidVariant ? <p>
              <span className="font-bold">
                Invalid <code>type</code> passed!
              </span>
              <br />
              <span className="font-bold">Received: </span>
              {type}
              <br />
              <span className="font-bold">Expected one of: </span>
              {asideVariants.join(", ")}
            </p> : <>
              {title && <p className="font-bold">{title}</p>}
              {children}
            </>}
        </div>
      </div>
    </>;
};

[wallet.ton.org](https://github.com/ton-blockchain/ton-wallet) is the self-custodial wallet developed by TON Core.
It supports jettons, NFTs, [TON DNS](/services/dns), [TON Sites](/services/sites), [TON Proxy](/services/proxy), and is available as a web app and browser extension.

## Key features

* **Testnet support:** accepts the `testnet` parameter in the browser.
* **Supports [W5](/standard/wallets/v5)**: the latest wallet smart contract standard for TON Blockchain.

## Wallet setup

To get started, set up your [wallet.ton.org](https://wallet.ton.org/), a web-based wallet interface.

1. Open [wallet.ton.org](https://wallet.ton.org/).

2. Click "Create Wallet" to create a new wallet.

<Image src="/resources/images/wallets/wallet-ton-org/welcome_page_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/welcome_page_dark.png" alt="Web wallet welcome page" />

3. Next, choose "Use Password" to protect your wallet:

<Image src="/resources/images/wallets/wallet-ton-org/password_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/password_dark.png" alt="Password option" />

4. Set and confirm your password.
   Ensure you use a *strong and unique* password to protect your wallet.

<Image src="/resources/images/wallets/wallet-ton-org/creating_password_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/creating_password_dark.png" alt="Password setup" />

5. Read the "Use Responsibly" notice and check the box to *confirm that you have read and accepted this information*.

<Image src="/resources/images/wallets/wallet-ton-org/responsibility_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/responsibility_dark.png" alt="Use responsibility notice" />

6. After confirming, you’ll be prompted to manually back up your secret key.
   This key is the **only** way to recover access to your wallet if you lose your password or device.
   Click "Back Up Now" to continue.

<Image src="/resources/images/wallets/wallet-ton-org/backup_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/backup_dark.png" alt="Back up your password" />

7. Read the "Safety Rules" carefully, check all the boxes to confirm that you understand them. Then click "Understood" to continue.

<Image src="/resources/images/wallets/wallet-ton-org/safety_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/safety_dark.png" alt="Safety rules" />

8. Write down your 24 recovery words and store them in **a safe place**.
   *Never share them with anyone or enter them anywhere else.*

<Aside type="danger" title="Secrets at risk">
  Anyone who sees your recovery words can take control of your wallet and move funds.
  If you suspect exposure, create a new wallet and transfer all funds immediately.
  Do not store recovery words digitally; write them down and keep them offline.
  Applies to both Testnet and Mainnet.
</Aside>

Once you’re ready, click "Let’s Check" to verify your recovery phrase.

<Image src="/resources/images/wallets/wallet-ton-org/secret_words_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/secret_words_dark.png" alt="Recovery words" />

9. In the "Let’s Check" step, enter the requested words to make sure your recovery phrase was saved correctly.

Then click "Continue" to finish the setup.

<Image src="/resources/images/wallets/wallet-ton-org/verify_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/verify_dark.png" alt="Verify your secret words" />

**Congratulations!** *Your wallet is now ready to use.*

### Interface overview

The main screen of the wallet displays essential account information and actions.

* **Account balance (yellow box)** displays the total amount of Toncoin and other tokens held on your account.
* **Account address (red box)** is your unique account identifier, shown both as a QR code and as a base64-encoded string.

For example: `UQDDKXleckOm6CTbab3CPz0TkvbSkrlUFum_YMIa-IIfGmXk`.
You can share this address to receive TON, jettons, or NFTs.

* The **send button (green box)** opens the transfer form, allowing you to send TON or jettons to another account address.

<Image src="/resources/images/wallets/wallet-ton-org/ui_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/ui_dark.png" alt="Wallet interface" />

### Wallet contract version

To check which [wallet contract version](/standard/wallets/comparison) is used:

1. Click the "Settings" icon.

<Image src="/resources/images/wallets/wallet-ton-org/settings_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/settings_dark.png" alt="Settings button" />

2. In the "Wallet Versions", you can see which contract your wallet uses.

<Image src="/resources/images/wallets/wallet-ton-org/wallet_version_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/wallet_version_dark.png" alt="Settings button" />

3. Click the field to view the current version, for example, *W5*.

If you previously used older wallet contracts, such as v3 or v4, you can import them using your mnemonic phrase.

<Image src="/resources/images/wallets/wallet-ton-org/contract_type_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/contract_type_dark.png" alt="Settings button" />

### Testnet

In wallet.ton.org, the **Testnet account** is derived from the **Mainnet wallet’s mnemonic**. The Testnet account is generated with the same [subwallet ID](/standard/wallets/how-it-works#subwallet-id) as Mainnet.

<Aside type="caution">
  Make sure the selected network matches your intent — Testnet for testing, Mainnet for real transfers.
  Verify the network before sending funds.
</Aside>

To add a Testnet account:

1. Click the "Settings" icon.

<Image src="/resources/images/wallets/wallet-ton-org/settings_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/settings_dark.png" alt="Settings button" />

2. In the settings window, **double-click** the wallet version number to open developer options.

<Image src="/resources/images/wallets/wallet-ton-org/version_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/version_dark.png" alt="Click on version" />

3. In the "Developer options" panel, locate the "Networks" section and select "Testnet".

<Image src="/resources/images/wallets/wallet-ton-org/testnet_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/testnet_dark.png" alt="Choose Testnet" />

4. The app automatically returns to the main screen, where the interface indicates that you’re now using **the Testnet version**.

<Aside type="note">
  Mainnet and Testnet use different user-friendly address formats —the raw address is the same, but its text representation differs.

  See [How to read and write TON addresses](/foundations/addresses/serialize#using-online-converter) for details on address formats and conversion.
</Aside>

<Image src="/resources/images/wallets/wallet-ton-org/testnet_version_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/testnet_version_dark.png" alt="Choose Testnet" />

*You can also check the wallet contract version in **Testnet** — the settings UI displays [the same version information](/ecosystem/wallet-apps/web#wallet-contract-version) as on Mainnet.*

## Deploy a wallet

A wallet must be **deployed** before use — its account state must be `active`.

Newly created wallets have the default state `nonexist`, meaning the account has *no code, data, or balance*.

### Check the account state

Use a [blockchain explorer](/ecosystem/explorers/overview) to inspect the account. For **Testnet**, use [Tonviewer Testnet](https://testnet.tonviewer.com/).

1. Paste your address into the search bar.

<Image src="/resources/images/wallets/wallet-ton-org/tonviewer_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/tonviewer_dark.png" alt="Insert your address in Tonviewer search" />

2. The account details will appear. In a newly created wallet, the status is `nonexist`, indicating the wallet is not deployed.

<Image src="/resources/images/wallets/wallet-ton-org/address_nonexist_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/address_nonexist_dark.png" alt="Account status: nonexist" />

### Fund the wallet

A wallet must receive funds before deployment.

* On Testnet, request free Testnet Toncoins from the TON Testnet Faucet.

After receiving funds, the wallet enters the `uninit` state. This means the account has a balance, but the smart contract is not yet deployed.

<Image src="/resources/images/wallets/wallet-ton-org/address_uninit_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/address_uninit_dark.png" alt="Account status: uninit" />

### Send the first transaction

With TON in the account, the wallet can be deployed. Deployment occurs when *the wallet processes its first transaction*.
In this example, we send TON to the account itself on Testnet to observe the transaction and wallet deployment on-chain.

<Aside type="caution" title="Funds at risk">
  On-chain transfers are irreversible — verify the recipient and amount before confirming. Use the Testnet for practice; only use the Mainnet when you intend to make a real transfer.
</Aside>

To send TON to your own account:

1. Click "Send", enter your wallet address in "Recipient Address", and the "Amount" of TON. Optionally, add a comment. Click "Send TON".

<Image src="/resources/images/wallets/wallet-ton-org/send_coins_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/send_coins_dark.png" alt="Sending coins" />

2. In the confirmation popup, verify the transaction details and click "Confirm" if correct; otherwise, "Edit".

<Image src="/resources/images/wallets/wallet-ton-org/confirm_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/confirm_dark.png" alt="Confirm transaction" />

3. After confirmation, the wallet will display a notification: "Coins have been sent!"

<Image src="/resources/images/wallets/wallet-ton-org/notification_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/notification_dark.png" alt="Notification" />

Next, check your wallet status in the blockchain explorer.

The wallet should appear as `active`. *Congratulations, you have successfully deployed your contract!*

<Image src="/resources/images/wallets/wallet-ton-org/active_light.png" darkSrc="/resources/images/wallets/wallet-ton-org/active_dark.png" alt="Account status: active" />

You will also see a "Contract Type" field indicating `v5`.
For details, see [Wallet v5](/standard/wallets/v5).
