> ## Documentation Index > Fetch the complete documentation index at: https://whalescorp.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # User settings in Tonhub In Tonhub, users can change the app's appearance, language, display currency, address format, spam filter, security settings, and personal data for each wallet. Below are **all available settings**, where they are located, and how they are saved.\ **Where to open settings:** main screen → "Settings" tab. Some options apply to the entire app, while others apply to the selected wallet (name, avatar, color are set in wallet settings / by tapping on the wallet card). 2026 02 2015 57 03 # Theme (light / dark / system) **Screen:** Settings → "Theme".\ **Options:** * **Light** — light background, dark text. * **Dark** — dark background, light text. * **System** — automatically follows the device's system theme (light/dark depending on OS settings). **Where stored:** locally on device (`themeStyle` key in app storage). When changing theme, the navigation bar (NavBar) color is also updated.\ **Default:** "System". # Interface Language **Screen:** Settings → "Language".\ **Available languages:** * English * Русский * Українська * Español * Deutsch * Français * Italiano * Português Codes: en, ru, uk, es, de, fr, it, pt. The list is defined in the app (`langResources`). On first launch, if no language is selected, the system language may be used (`getLocales()[0].languageCode`).\ **Where stored:** locally (`languageState` key). After changing language, the app restarts to apply translations to all screens.\ **Default:** system language or saved value. # Search Engine (in browser) **Screen:** Settings → "Search engine".\ **Options:** * **Google** — search through Google when entering a query in the app browser address bar (WebView). * **DuckDuckGo** — search through DuckDuckGo. **Where stored:** in app shared storage (`searchEngine` key, shared storage). Used when substituting search URL when user enters text in the app browser address field.\ **Default:** DuckDuckGo. # Primary Currency (for amount display) **Screen:** Settings → "Primary currency".\ **Options:** USD, EUR, RUB, GBP, CHF, CNY, KRW, IDR, INR, JPY. The interface displays currency symbol and label (e.g., U.S. Dollar for USD).\ **Where stored:** in **Tonhub cloud storage** (by `primaryCurrency-v1` key), linked to device/account. This allows preserving currency choice when reinstalling the app (if using the same key).\ **Default:** USD.\ **Usage:** balances, transaction amounts, fees, and fiat equivalents are displayed in the selected currency (using exchange rates from backend). # TON Address Format (bounceable / non-bounceable) **Screen:** Settings → "New address format".\ **Options:** * **Bounceable.** If the recipient is a contract that is not yet deployed or cannot process the request, TON is returned minus the processing fee. * **Non-bounceable.** If the contract doesn't exist, TON will be lost (spent on network fees). **Where stored:** locally (`bounceableWalletFormat` key). Affects how TON addresses are displayed and copied (when receiving, in contacts, in data provided to dApps, etc.).\ **Default:** `true` (bounceable). In code for "new" scenarios, non-bounceable may be used by default; actual value is taken from storage. # Spam Filter **Screen:** Settings → "Spam filter".\ **Settings:** * **Minimum amount:** TON transactions with amounts **below** the specified threshold (in TON) are automatically marked as spam. User enters value in TON; it's saved in nano-TON. Used only for **TON** (and TON tokens); Solana transactions are not marked by this rule. * **Don't show comments on SPAM transactions:** toggle. If enabled, comments (payload) on transactions marked as spam are not displayed in the list. * **Manual list (deny list):** addresses that the user manually added to "spam". Such addresses show a spam badge when sending, but **sending is not blocked** — user can confirm the transfer. In the spam filter screen, you can view the list and remove addresses from blocking ("unblock"). **Where stored:** minimum amount and "don't show comments" flag — locally (or in app shared storage); deny list is stored in address book context (contacts/deny list). Deny list synchronization between devices depends on implementation (e.g., cloud storage by key).\ **Note:** "spam" marking by amount and deny list applies only to TON network operations (and token display). Solana transactions don't go through this filter. # Wallet Settings (name, avatar, color) **Screen:** tapping on selected wallet card on main screen or in switcher → "Wallet settings" (or wallet editing screen).\ **Parameters (per wallet):** * **Name:** arbitrary wallet name (text). Displayed on card and in wallet list. For Ledger, device name can be set. * **Avatar:** selecting avatar image from set (index). For Ledger, avatar doesn't change (remains null). * **Color:** selecting color from palette (index in color array). Used for wallet card styling. **Where stored:** in app shared storage by `walletsSettings` key; value is object like `{ [addressKey]: { name, avatar, color } }`. Key is linked to wallet address (or Ledger identifier). Data is local.\ **Default:** name — "Wallet N" (N = number in list) or Ledger name; avatar and color are computed from address hash (deterministically) if user hasn't changed them. # Security (PIN, biometrics, app lock) **Screen:** Settings → "Security". Available only for regular wallets (not for Ledger-only scenario).\ **Settings:** * **PIN code:** setting, changing, or removing PIN for unlocking key access and confirming operations. Status (set / not set) is stored in secure storage (SecureStore / Keychain). * **Biometrics:** enabling/disabling login and operation confirmation via Face ID (iOS) or fingerprint / face (Android). Available only if PIN is already set. Status stored in app (useBiometricsState). * **Lock app with auth:** when enabled, app requests PIN or biometrics when returning from background (or when opening). Separate toggle in "Security" section. **Where stored:** PIN and keys — in OS secure storage (Keychain / Keystore); "use biometrics" and "lock on exit" flags — in app settings (locally).\ **Note:** these options don't "configure" the backend — they only affect local unlocking and operation confirmation on the device. # Contacts (address book) **Screen:** Settings → "Contacts".\ **What it is:** list of saved contacts — name and TON or Solana address. User can add, edit, and delete contacts. When transferring, selecting a contact substitutes the address and displays the name; contacts are also used for "known wallet" marking and connection with deny list (if address is added to spam, it remains in contacts/deny list with marking).\ **Where stored:** in address book context (AddressBookContext); data can be saved locally and synchronized when needed (depends on implementation). Deny list (manual spam) is linked to this same section. # Other Settings The "Settings" section also includes items that are not user "options" but lead to important screens: * **Key backup** — go to seed phrase and backup instructions. * **Holders accounts** — go to Holders (cards, accounts); visible when Holders product is available. * **Legacy wallet migration** — shown if there's balance on old addresses; go to migration. * **Support** — links to Telegram, support form, Holders, Tonhub. * **Rate app** — go to app store (rating/review). * **Terms of Service** and **Privacy Policy** — opening corresponding pages. * **Delete account / disconnect wallet** — removing wallet from app or disconnecting Ledger (depending on context). * **Developer tools** — appears after several taps on app version; access to debug screens (logs, storage, etc.). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.