feat: rebrand USDC as Cash Reserves in Wallet (behind beta flag)

Signed-off-by: Brandon McAnsh <git@bmcreations.dev>

Author: bmc08gt

apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/onramp/deeplinks/WalletDeeplinkConnectionResult.kt

@@ -5,6 +5,7 @@ import com.flipcash.app.core.AppRoute
 import com.getcode.ed25519.Ed25519
 import com.getcode.opencode.model.core.ID
 import com.getcode.opencode.utils.base64
+import com.getcode.solana.keys.Mint
 import com.getcode.solana.keys.PublicKey
 import com.getcode.solana.keys.base58
 import com.getcode.utils.base58
@@ -40,6 +41,9 @@ sealed class OnRampDeeplinkOrigin: Parcelable {
     @Parcelize
     data object Wallet: OnRampDeeplinkOrigin()
 
+    @Parcelize
+    data object Reserves: OnRampDeeplinkOrigin()
+
     @Parcelize
     data class PoolWithId(val id: ID) : OnRampDeeplinkOrigin()
 
@@ -51,8 +55,9 @@ sealed class OnRampDeeplinkOrigin: Parcelable {
             is PoolWithId -> "pool-id_${id.base58}"
             is PoolWithRendezvous -> "pool-seed_${keyPair.seed.base64}"
             Menu -> "menu"
-            is Give -> "give-${tokenAddress?.base58()}"
+            is Give -> "give-${tokenAddress.base58()}"
             Wallet -> "wallet"
+            Reserves -> "reserves"
         }.lowercase()
     }
 
@@ -66,6 +71,9 @@ sealed class OnRampDeeplinkOrigin: Parcelable {
                     route.poolId?.let { id -> PoolWithId(id) }
                 }
                 is AppRoute.Sheets.Wallet -> Wallet
+                is AppRoute.Token.Info -> {
+                    if (route.mint == Mint.usdc) Reserves else null
+                }
 
                 else -> null
             }
@@ -82,6 +90,7 @@ sealed class OnRampDeeplinkOrigin: Parcelable {
                     Give(mint)
                 }
                 value == "wallet" -> Wallet
+                value == "reserves" -> Reserves
                 value?.startsWith("pool-") == true -> {
                     val idStringWithPrefix = value.removePrefix("pool-")
                     val splits = idStringWithPrefix.split("_")

apps/flipcash/core/src/main/res/values/strings.xml

@@ -448,6 +448,12 @@
     <string name="label_blendModeColorDodge">Color Dodge</string>
     <string name="label_blendModePlusLighter">Plus Lighter</string>
 
+    <string name="title_cashReserves">Cash Reserves</string>
+    <string name="action_buyMore">Buy More</string>
+    <string name="description_cashReserves">
+        Your cash reserves are held in USDF, a fully backed digital dollar supported 1:1 by U.S. dollars. This ensures your funds retain the same value and stability as traditional USD, while benefiting from faster, more transparent transactions on modern financial infrastructure. You can deposit additional funds at any time, or withdraw your USDF for U.S. dollars whenever you like.
+    </string>
+
 
 
 

apps/flipcash/features/balance/src/main/kotlin/com/flipcash/app/balance/internal/BalanceScreenContent.kt

@@ -4,8 +4,11 @@ import androidx.compose.foundation.background
 import androidx.compose.foundation.layout.Arrangement
 import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
 import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.padding
+import androidx.compose.material.Icon
 import androidx.compose.material.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.CompositionLocalProvider
@@ -15,11 +18,13 @@ import androidx.compose.runtime.remember
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.res.painterResource
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.tooling.preview.Preview
 import com.flipcash.app.balance.internal.components.BalanceHeader
 import com.flipcash.app.core.AppRoute
+import com.flipcash.app.core.money.formatted
 import com.flipcash.app.core.tokens.TokenPurpose
 import com.flipcash.app.onramp.AddCashRow
 import com.flipcash.app.theme.FlipcashDesignSystem
@@ -31,6 +36,7 @@ import com.getcode.opencode.compose.LocalExchange
 import com.getcode.opencode.model.financial.CurrencyCode
 import com.getcode.opencode.model.financial.Rate
 import com.getcode.theme.CodeTheme
+import com.getcode.ui.core.rememberedClickable
 
 @Composable
 internal fun BalanceScreen(
@@ -73,6 +79,7 @@ private fun BalanceScreenContent(
 
         TokenList(
             modifier = Modifier.weight(1f),
+            reservesEnabled = tokenState.reservesEnabled,
             emptyState = {
                 Box(
                     modifier = Modifier
@@ -96,6 +103,46 @@ private fun BalanceScreenContent(
                     }
                 }
             },
+            footer = { mint, reserves ->
+                Row(
+                    modifier = Modifier
+                        .fillMaxWidth()
+                        .rememberedClickable {
+                            dispatchEvent(
+                                BalanceViewModel.Event.OpenScreen(
+                                    AppRoute.Token.Info(mint)
+                                )
+                            )
+                        }
+                        .padding(
+                            vertical = CodeTheme.dimens.grid.x3,
+                            horizontal = CodeTheme.dimens.inset),
+                    verticalAlignment = Alignment.CenterVertically,
+                ) {
+                    Text(
+                        text = stringResource(R.string.title_cashReserves),
+                        style = CodeTheme.typography.textMedium,
+                        color = CodeTheme.colors.textSecondary,
+                    )
+
+                    Icon(
+                        modifier = Modifier
+                            .padding(vertical = CodeTheme.dimens.grid.x1)
+                            .padding(start = CodeTheme.dimens.grid.x1),
+                        painter = painterResource(id = R.drawable.ic_chevron_right),
+                        contentDescription = null,
+                        tint = CodeTheme.colors.secondary,
+                    )
+
+                    Spacer(Modifier.weight(1f))
+
+                    Text(
+                        text = reserves.formatted(),
+                        style = CodeTheme.typography.screenTitle,
+                        color = CodeTheme.colors.textMain,
+                    )
+                }
+            },
             tokens = tokens,
             onTokenSelected = {
                 dispatchEvent(

apps/flipcash/features/scanner/src/main/kotlin/com/flipcash/app/scanner/internal/NavigationStateRestorer.kt

@@ -6,6 +6,7 @@ import com.flipcash.app.core.navigation.DeeplinkType
 import com.flipcash.app.core.onramp.deeplinks.OnRampDeeplinkOrigin
 import com.flipcash.app.core.verification.email.EmailDeeplinkOrigin
 import com.getcode.navigation.core.CodeNavigator
+import com.getcode.solana.keys.Mint
 import com.getcode.ui.core.scaled
 import kotlinx.coroutines.delay
 
@@ -42,6 +43,7 @@ class NavigationStateRestorer(
                     is OnRampDeeplinkOrigin.PoolWithRendezvous -> buildOnRampScreenFlow(AppRoute.Pool.Details(rendezvous = origin.keyPair))
                     is OnRampDeeplinkOrigin.Give -> buildOnRampScreenFlow(AppRoute.Main.Give(origin.tokenAddress))
                     OnRampDeeplinkOrigin.Wallet -> buildOnRampScreenFlow(AppRoute.Sheets.Wallet)
+                    OnRampDeeplinkOrigin.Reserves -> buildOnRampScreenFlow(AppRoute.Token.Info(Mint.usdc))
                 } + ScreenRegistry.get(AppRoute.OnRamp.AmountEntry)
 
                 navigator.show(screens)
@@ -101,7 +103,9 @@ class NavigationStateRestorer(
     }
 }
 
-private fun buildOnRampScreenFlow(origin: AppRoute) = listOf(
-    ScreenRegistry.get(origin),
-    ScreenRegistry.get(AppRoute.OnRamp.ProviderList(origin)),
-)
+private fun buildOnRampScreenFlow(origin: List<AppRoute>) =
+    origin.dropLast(1).map { ScreenRegistry.get(it) } +
+    ScreenRegistry.get(AppRoute.OnRamp.ProviderList(origin.last())
+)
+
+private fun buildOnRampScreenFlow(origin: AppRoute) = buildOnRampScreenFlow(listOf(origin))

apps/flipcash/features/tokens/src/main/kotlin/com/flipcash/app/tokens/TokenInfoScreen.kt

@@ -8,13 +8,15 @@ import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.getValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import cafe.adriel.voyager.core.registry.ScreenRegistry
 import cafe.adriel.voyager.core.screen.ScreenKey
 import cafe.adriel.voyager.core.screen.uniqueScreenKey
 import cafe.adriel.voyager.hilt.getViewModel
 import com.flipcash.app.core.ui.TokenIconWithName
 import com.flipcash.app.tokens.internal.TokenInfoScreen
+import com.flipcash.features.tokens.R
 import com.getcode.navigation.core.LocalCodeNavigator
 import com.getcode.navigation.modal.ModalScreen
 import com.getcode.solana.keys.Mint
@@ -47,20 +49,26 @@ class TokenInfoScreen(private val mint: Mint) : ModalScreen, Parcelable {
                 isInModal = true,
                 title = {
                     state.token?.let { token ->
-                        TokenIconWithName(
-                            token = token,
-                            imageSize = CodeTheme.dimens.staticGrid.x5,
-                            spacing = CodeTheme.dimens.grid.x1,
-                        )
+                        if (state.isCashReserve && state.cashReservesEnabled) {
+                            AppBarDefaults.Title(text = stringResource(R.string.title_cashReserves))
+                        } else {
+                            TokenIconWithName(
+                                token = token,
+                                imageSize = CodeTheme.dimens.staticGrid.x5,
+                                spacing = CodeTheme.dimens.grid.x1,
+                            )
+                        }
                     }
                 },
                 titleAlignment = Alignment.CenterHorizontally,
                 leftIcon = {
                     AppBarDefaults.UpNavigation { navigator.pop() }
                 },
                 rightContents = {
-                    AppBarDefaults.Share {
-                        viewModel.dispatchEvent(TokenInfoViewModel.Event.Share)
+                    if (state.isCashReserve && state.cashReservesEnabled) {
+                        AppBarDefaults.Share {
+                            viewModel.dispatchEvent(TokenInfoViewModel.Event.Share)
+                        }
                     }
                 },
             )