4.2.1

Author: mytonwalletorg

changelogs/4.2.0.txt

@@ -1,3 +1,3 @@
 · Handy Widgets · Track balances and view NFTs right from your home screen.
 · Live Fiat Previews · See the total balance in multiple fiat currencies at once.
-· New Welcome Flow · Easier onboarding with confetti.
+· New Welcome Flow · Easier onboarding with confetti 🎉

changelogs/4.2.1.txt

@@ -0,0 +1,3 @@
+· Handy Widgets · Track balances and view NFTs right from your home screen.
+· Live Fiat Previews · See the total balance in multiple fiat currencies at once.
+· New Welcome Flow · Easier onboarding with confetti.

docs/add-chain.md

@@ -0,0 +1,97 @@
+# Adding a New Blockchain (Chain) Guide
+
+This short guide lists the minimum required code touch-points to register a new chain in the project.
+For deeper architectural rules (stubs, UI gating, import boundaries, etc.) please see [the multichain Cursor rule](../.cursor/rules/multichain.mdc).
+
+## Required Code Changes (Single Source Spots)
+
+Update all of the following in one PR:
+
+1. Add the chain literal to `ApiChain` in `src/api/types/misc.ts`.
+2. Extend `ApiWalletByChain` (and add a wallet type) in `src/api/types/storage.ts`.
+3. Add a config entry to `CHAIN_CONFIG` in `src/util/chain.ts` (title, flags, regexes, native token, explorer, optional `formatTransferUrl`, etc.).
+4. Add per‑chain style variables in `$byChain` inside `src/styles/scssVariables.scss` (colors, accents, etc.).
+5. Create the SDK folder `src/api/chains/<chain>/` and export `const <chain>Sdk: ChainSdk<'<chain>'>` from its `index.ts` (all interface methods present; unsupported ones throw `Not supported in <ChainName>`, see `src/api/chains/tron/index.ts` as example).
+6. Register the SDK in the map `chains` in `src/api/chains/index.ts`.
+7. Add a font icon: `src/assets/font-icons/chain-<chain>.svg` (match size & baseline of existing chain icons).
+8. (Optional) Map the native token icon in `TOKEN_FONT_ICONS` in `src/config.ts` if a custom glyph is needed.
+
+## Minimum Viable Feature Set (Recommended Order)
+
+Implement these first so the chain is actually usable.
+
+### Authentication (Importing / Viewing Wallets)
+
+- Importing from a BIP39 mnemonic
+- Importing from an address (view-only)
+
+Nice to have later:
+- Importing from a Ledger hardware wallet
+
+### Token List
+
+- Native token is required
+- Prices
+- Jettons can be added later
+
+### Balances
+
+- The SDK chain polling methods must update the balance of the supported tokens
+
+### Activity History
+
+- Fetching activity history slices
+- Fetching activity fee
+- The SDK chain polling methods must check for new transactions and add them to the start of the list
+
+Nice to have later:
+- Comment decryption (if applicable)
+
+### Sending Tokens
+
+- Fetching the fee in the Send form
+- Sending
+
+Nice to have later:
+- Comment
+- Encrypted comment (if applicable)
+- Sending with a Ledger hardware wallet
+
+## UI Gating Basics
+
+Only surface features that are actually supported:
+- If your chain has no `formatTransferUrl`, it must not appear in Deposit Link flows.
+- Use flags from `CHAIN_CONFIG` (e.g. `isTransferCommentSupported`, `isLedgerSupported`) instead of hard-coded `if (chain === ...)`.
+
+## Stubs & Unsupported Features
+
+Provide throwing stubs (`function notSupported(): never`) for every `ChainSdk` method you cannot implement yet.
+
+## Backend & Infrastructure Coordination
+
+A new chain is not only a client concern. It also requires backend support:
+
+What you need from backend:
+- Access to a reliable node / RPC endpoint (or cluster) for the new chain
+- Indexing & enrichment for activity
+- Real-time activity notifications via our backend socket (set by `CHAIN_CONFIG[chain].doesBackendSocketSupport`)
+
+`doesBackendSocketSupport` flag:
+- Set to `false` only temporarily while backend adds socket activity support.
+- Once backend provides notifications, switch it to `true` so the client receives push updates instead of relying solely on polling.
+- Do not leave it `false` long-term; stale value means unnecessary latency and extra battery consumption from polling.
+
+Reach out to the backend team early (ideally before starting client implementation) with the chain’s requirements: activity feed shape, fee estimation endpoints (if any), token metadata plans, and any staking / NFT / domain features you plan to enable soon.
+Clearly mark in the PR description whether backend socket support is already live or pending.
+
+If in doubt about what backend exposes, ask — do *not* guess or scrape public explorers.
+
+## Common Pitfalls
+
+| Pitfall | Fix |
+|---------|-----|
+| Added chain but missed `$byChain` styles | Add style map entry before shipping |
+| Added special-case UI `if (chain === '<name>')` | Replace with a config flag in `CHAIN_CONFIG` |
+| Method missing in one chain SDK | Add stub throwing `Not supported in <ChainName>` |
+| Catching stub error to hide feature | Gate the feature in UI instead |
+| Left `doesBackendSocketSupport` = false after backend enabled | Set it to true and remove temporary polling-only logic |

mobile/android/air/SubModules/AirAsFramework/src/main/java/org/mytonwallet/app_air/airasframework/AirAsFrameworkApplication.kt

@@ -9,16 +9,16 @@ import org.mytonwallet.app_air.uicomponents.helpers.FontManager
 import org.mytonwallet.app_air.walletbasecontext.WBaseStorage
 import org.mytonwallet.app_air.walletbasecontext.localization.LocaleController
 import org.mytonwallet.app_air.walletbasecontext.logger.Logger
+import org.mytonwallet.app_air.walletbasecontext.theme.ThemeManager
+import org.mytonwallet.app_air.walletbasecontext.theme.ThemeManager.setAccentColor
+import org.mytonwallet.app_air.walletbasecontext.theme.ThemeManager.setNftAccentColor
+import org.mytonwallet.app_air.walletbasecontext.utils.ApplicationContextHolder
 import org.mytonwallet.app_air.walletcontext.cacheStorage.WCacheStorage
 import org.mytonwallet.app_air.walletcontext.globalStorage.IGlobalStorageProvider
 import org.mytonwallet.app_air.walletcontext.globalStorage.WGlobalStorage
-import org.mytonwallet.app_air.walletcontext.helpers.ApplicationContextHolder
 import org.mytonwallet.app_air.walletcontext.helpers.DevicePerformanceClassifier
 import org.mytonwallet.app_air.walletcontext.helpers.LauncherIconController
 import org.mytonwallet.app_air.walletcontext.secureStorage.WSecureStorage
-import org.mytonwallet.app_air.walletbasecontext.theme.ThemeManager
-import org.mytonwallet.app_air.walletbasecontext.theme.ThemeManager.setAccentColor
-import org.mytonwallet.app_air.walletbasecontext.theme.ThemeManager.setNftAccentColor
 import org.mytonwallet.app_air.walletcore.WalletCore
 import org.mytonwallet.app_air.walletcore.stores.AccountStore
 import org.mytonwallet.app_air.walletcore.stores.ActivityStore
@@ -68,6 +68,8 @@ class AirAsFrameworkApplication {
 
             t = System.currentTimeMillis()
             WBaseStorage.init(applicationContext)
+            WBaseStorage.setActiveLanguage(WGlobalStorage.getLangCode())
+            WBaseStorage.setBaseCurrency(WGlobalStorage.getBaseCurrency())
             Logger.i(
                 Logger.LogTag.AIR_APPLICATION,
                 "WBaseStorage.init: ${System.currentTimeMillis() - t}ms"

mobile/android/air/SubModules/AirAsFramework/src/main/java/org/mytonwallet/app_air/airasframework/MainWindow.kt

@@ -10,12 +10,13 @@ import androidx.core.content.ContextCompat
 import org.mytonwallet.app_air.airasframework.splash.SplashVC
 import org.mytonwallet.app_air.uicomponents.base.WNavigationController
 import org.mytonwallet.app_air.uicomponents.base.WWindow
+import org.mytonwallet.app_air.uiwidgets.configurations.WidgetsConfigurations
+import org.mytonwallet.app_air.walletbasecontext.logger.Logger
 import org.mytonwallet.app_air.walletcontext.WalletContextManager
 import org.mytonwallet.app_air.walletcontext.globalStorage.WGlobalStorage
 import org.mytonwallet.app_air.walletcontext.helpers.AutoLockHelper
 import org.mytonwallet.app_air.walletcore.WalletCore
 import org.mytonwallet.app_air.walletcore.pushNotifications.AirPushNotifications
-import org.mytonwallet.app_air.walletbasecontext.logger.Logger
 
 class MainWindow : WWindow() {
     private val splashVC by lazy {
@@ -86,6 +87,16 @@ class MainWindow : WWindow() {
         AutoLockHelper.appResumed()
     }
 
+    var lastWidgetUpdate: Long = 0
+    override fun onPause() {
+        super.onPause()
+        val currentDt = System.currentTimeMillis()
+        if (currentDt - lastWidgetUpdate > 60 * 1000) {
+            lastWidgetUpdate = currentDt
+            WidgetsConfigurations.reloadWidgets(applicationContext)
+        }
+    }
+
     override fun onDestroy() {
         super.onDestroy()
         destroyBridge()

mobile/android/air/SubModules/AirAsFramework/src/main/java/org/mytonwallet/app_air/airasframework/WidgetConfigurationWindow.kt

@@ -32,7 +32,7 @@ class WidgetConfigurationWindow : WWindow() {
                 ActionsWidgetConfigurationVC(this, appWidgetId, onResult)
             }
 
-            "org.mytonwallet.app_air.widgets.actionsWidget.PriceWidget" -> {
+            "org.mytonwallet.app_air.widgets.priceWidget.PriceWidget" -> {
                 PriceWidgetConfigurationVC(this, appWidgetId, onResult)
             }
 

mobile/android/air/SubModules/Ledger/src/main/java/org/mytonwallet/app_air/ledger/connectionManagers/LedgerUsbManager.kt

@@ -7,7 +7,6 @@ import org.mytonwallet.app_air.ledger.LedgerManager.ConnectionState
 import org.mytonwallet.app_air.ledger.usb.HIDDevice
 import org.mytonwallet.app_air.ledger.usb.USBManager
 import org.mytonwallet.app_air.walletcore.WalletCore
-import org.mytonwallet.app_air.walletcore.models.LedgerAppInfo
 import org.mytonwallet.app_air.walletcore.models.MBlockchain
 import org.mytonwallet.app_air.walletcore.moshi.api.ApiMethod
 
@@ -107,15 +106,15 @@ object LedgerUsbManager : ILedgerConnectionManager {
             ApiMethod.Other.WaitForLedgerApp(chain = MBlockchain.ton),
             callback = { res, error ->
                 if (res != true || error != null) {
-                    onUpdate(ConnectionState.Done(LedgerDevice.Usb(device)))
+                    onUpdate(
+                        ConnectionState.Error(
+                            step = ConnectionState.Error.Step.TON_APP,
+                            shortMessage = null
+                        )
+                    )
                     return@call
                 }
-                onUpdate(
-                    ConnectionState.Error(
-                        step = ConnectionState.Error.Step.TON_APP,
-                        shortMessage = null
-                    )
-                )
+                onUpdate(ConnectionState.Done(LedgerDevice.Usb(device)))
             }
         )
     }

mobile/android/air/SubModules/Ledger/src/main/java/org/mytonwallet/app_air/ledger/screens/ledgerConnect/LedgerConnectVC.kt

@@ -831,7 +831,8 @@ class LedgerConnectVC(
         super.viewWillAppear()
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
             configureTryAgainButton(
-                toOpenSettings = !LedgerBleManager.isPermissionGranted() &&
+                toOpenSettings = LedgerManager.activeMode == LedgerManager.ConnectionMode.BLE &&
+                    !LedgerBleManager.isPermissionGranted() &&
                     !ActivityCompat.shouldShowRequestPermissionRationale(
                         window!!,
                         Manifest.permission.BLUETOOTH_SCAN

mobile/android/air/SubModules/Ledger/src/main/java/org/mytonwallet/app_air/ledger/screens/ledgerWallets/LedgerWalletsVC.kt

@@ -255,7 +255,7 @@ class LedgerWalletsVC(
             else -> {
                 LedgerLoadMoreCell(context).apply {
                     onTap = {
-                        homeVM.loadMore(items.size - 1)
+                        homeVM.loadMore(items.size)
                     }
                 }
             }

mobile/android/air/SubModules/UIAssets/src/main/java/org/mytonwallet/app_air/uiassets/viewControllers/renew/RenewVC.kt

@@ -30,7 +30,7 @@ import org.mytonwallet.app_air.walletbasecontext.localization.LocaleController
 import org.mytonwallet.app_air.walletbasecontext.theme.ViewConstants
 import org.mytonwallet.app_air.walletbasecontext.theme.WColor
 import org.mytonwallet.app_air.walletbasecontext.theme.color
-import org.mytonwallet.app_air.walletcontext.utils.formatDateAndTime
+import org.mytonwallet.app_air.walletbasecontext.utils.formatDateAndTime
 import org.mytonwallet.app_air.walletbasecontext.utils.smartDecimalsCount
 import org.mytonwallet.app_air.walletbasecontext.utils.toString
 import org.mytonwallet.app_air.walletcore.TONCOIN_SLUG