feat(deposit): deposit-first user experience

Prioritize depositing funds as the primary entry point for new and
empty-wallet users. Balance, menu, send, messenger, and cash screens
now surface deposit options contextually, routing through the unified
Swap flow. Coinbase on-ramp gains phone-region resolution for better
availability detection. Phantom deposits swap USDC→USDF directly via
CoinbaseStableSwapper into the VM deposit PDA, eliminating the
server-side sweep.

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

Author: bmc08gt

apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/navigation/AppScreenContent.kt

@@ -46,7 +46,7 @@ import com.flipcash.app.shareapp.ShareAppScreen
 import com.flipcash.app.tokens.SwapFlowScreen
 import com.flipcash.app.tokens.TokenInfoScreen
 import com.flipcash.app.tokens.TokenSelectScreen
-import com.flipcash.app.tokens.TokenTxProcessingScreen
+
 import com.flipcash.app.transactions.TransactionHistoryScreen
 import com.flipcash.app.userflags.UserFlagsScreen
 import com.flipcash.app.withdrawal.WithdrawalFlowScreen
@@ -110,10 +110,6 @@ fun appEntryProvider(
     annotatedEntry<AppRoute.Token.Swap> { key ->
         SwapFlowScreen(route = key, resultStateRegistry = resultStateRegistry)
     }
-    // TODO: fold this into above entry
-    annotatedEntry<AppRoute.Token.TxProcessing> { key ->
-        TokenTxProcessingScreen(key.swapId, key.swapPurpose, key.amount, key.isFundingShortfall)
-    }
     annotatedEntry<AppRoute.Token.Discovery> { TokenDiscoveryScreen() }
     annotatedEntry<AppRoute.Token.CurrencyCreator> { key ->
         CurrencyCreatorFlowScreen(route = key, resultStateRegistry = resultStateRegistry)

apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/AppRoute.kt

@@ -15,15 +15,10 @@ import com.flipcash.app.core.verification.VerificationStep
 import com.flipcash.app.core.withdrawal.WithdrawalResult
 import com.flipcash.app.core.withdrawal.WithdrawalStep
 import com.flipcash.app.core.onboarding.OnboardingStep
-import com.getcode.navigation.NonDismissableRoute
-import com.getcode.navigation.NonDraggableRoute
 import com.getcode.navigation.flow.FlowRoute
 import com.getcode.navigation.flow.FlowRouteWithResult
-import com.getcode.opencode.exchange.VerifiedFiat
-import com.getcode.opencode.internal.solana.model.SwapId
 import com.getcode.opencode.model.financial.Fiat
 import com.getcode.solana.keys.Mint
-import com.getcode.solana.keys.PublicKey
 import com.getcode.ui.core.RestrictionType
 import kotlinx.parcelize.Parcelize
 import kotlinx.serialization.Serializable
@@ -189,13 +184,6 @@ sealed interface AppRoute : NavKey, Parcelable {
         @Serializable
         data object PhantomConfirmTransaction: Token
 
-        @Serializable
-        data class TxProcessing(
-            val swapId: SwapId,
-            val swapPurpose: SwapPurpose? = null,
-            val amount: VerifiedFiat? = null,
-            val isFundingShortfall: Boolean = false,
-        ) : Token, NonDismissableRoute, NonDraggableRoute
 
         @Serializable
         data object Discovery: AppRoute

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

@@ -66,9 +66,11 @@
     <string name="subtitle_balanceIsHeldInUsdStablecoins">Your balance is held in US dollar stablecoins</string>
     <string name="subtitle_currentValueOfAllCurrencies">The current value of your currencies</string>
     <string name="subtitle_ofUsdStablecoins">of US dollar stablecoins</string>
-    <string name="action_depositFunds">Deposit</string>
+    <string name="action_deposit">Deposit</string>
     <string name="title_deposit">Deposit</string>
     <string name="title_depositFunds">Deposit Funds</string>
+    <string name="action_depositFunds">Deposit Funds</string>
+
 
     <string name="title_withdraw">Withdraw</string>
     <string name="title_withdrawFunds">Withdraw Funds</string>
@@ -235,7 +237,7 @@
     <string name="title_tapAboveToAddCashToWallet">Tap above to Add Cash to your wallet</string>
     <string name="title_tapBelowToAddCashWallet">You don\'t have any cash yet.\nTap below to add cash to your wallet</string>
     <string name="title_noBalanceYet">No Balance Yet</string>
-    <string name="description_noBalanceYet">Buy a currency to get started, or get another Flipcash user to give you some cash</string>
+    <string name="description_noBalanceYet">Deposit funds to get started</string>
     <string name="description_noBalanceYetDiscover">Buy your first currency to get started</string>
     <string name="action_dismiss">Dismiss</string>
     <string name="title_success">Success</string>

apps/flipcash/features/balance/build.gradle.kts

@@ -13,6 +13,7 @@ dependencies {
 
     implementation(project(":apps:flipcash:shared:analytics"))
     implementation(project(":apps:flipcash:shared:featureflags"))
+    implementation(project(":apps:flipcash:shared:payments"))
     implementation(project(":apps:flipcash:shared:tokens"))
     implementation(project(":apps:flipcash:shared:userflags"))
     implementation(project(":libs:datetime"))

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

@@ -10,7 +10,7 @@ import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.navigationBarsPadding
 import androidx.compose.foundation.layout.padding
 import androidx.compose.foundation.shape.CircleShape
-import androidx.compose.material.Text
+import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.CompositionLocalProvider
 import androidx.compose.runtime.getValue
@@ -97,29 +97,23 @@ private fun BalanceScreenContent(
 
                         Text(
                             modifier = Modifier.fillMaxWidth(0.6f),
-                            text = if (tokenState.discoveryEnabled) {
-                                stringResource(R.string.description_noBalanceYetDiscover)
-                            } else {
-                                stringResource(R.string.description_noBalanceYet)
-                            },
+                            text = stringResource(R.string.description_noBalanceYet),
                             style = CodeTheme.typography.textSmall,
                             color = CodeTheme.colors.textSecondary,
                             textAlign = TextAlign.Center,
                         )
 
-                        if (tokenState.discoveryEnabled) {
-                            CodeButton(
-                                onClick = {
-                                    dispatchEvent(
-                                        BalanceViewModel.Event.OpenScreen(AppRoute.Token.Discovery)
-                                    )
-                                },
-                                modifier = Modifier.align(Alignment.CenterHorizontally),
-                                contentPadding = PaddingValues(),
-                                text = stringResource(R.string.action_discoverCurrencies),
-                                shape = CircleShape,
-                            )
-                        }
+                        CodeButton(
+                            onClick = {
+                                dispatchEvent(BalanceViewModel.Event.PresentDepositOptions)
+                            },
+                            modifier = Modifier
+                                .padding(top = CodeTheme.dimens.grid.x2)
+                                .align(Alignment.CenterHorizontally),
+                            contentPadding = PaddingValues(),
+                            text = stringResource(R.string.action_depositFunds),
+                            shape = CircleShape,
+                        )
                     }
                 }
             },

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

@@ -2,6 +2,7 @@ package com.flipcash.app.balance.internal
 
 import androidx.lifecycle.viewModelScope
 import com.flipcash.app.core.AppRoute
+import com.flipcash.app.payments.PurchaseMethodController
 import com.flipcash.app.userflags.UserFlagsCoordinator
 import com.flipcash.services.internal.model.thirdparty.OnRampProvider
 import com.flipcash.services.user.AuthState
@@ -23,6 +24,7 @@ internal class BalanceViewModel @Inject constructor(
     userManager: UserManager,
     userFlags: UserFlagsCoordinator,
     dispatchers: DispatcherProvider,
+    purchaseMethodController: PurchaseMethodController,
 ) : BaseViewModel<BalanceViewModel.State, BalanceViewModel.Event>(
     initialState = State(),
     updateStateForEvent = updateStateForEvent,
@@ -38,6 +40,7 @@ internal class BalanceViewModel @Inject constructor(
         data object OpenCurrencySelection : Event
 
         data class OpenScreen(val screen: AppRoute) : Event
+        data object PresentDepositOptions: Event
     }
 
     init {
@@ -46,9 +49,13 @@ internal class BalanceViewModel @Inject constructor(
             .flatMapLatest { userFlags.resolvedFlags }
             .mapNotNull { it.preferredOnRampProvider.effectiveValue }
             .filterIsInstance<OnRampProvider.Defined>()
-            .onEach { provider ->
-                dispatchEvent(Event.OnPreferredOnRampProviderChanged(provider))
-            }
+            .onEach { provider -> dispatchEvent(Event.OnPreferredOnRampProviderChanged(provider)) }
+            .launchIn(viewModelScope)
+
+        eventFlow
+            .filterIsInstance<Event.PresentDepositOptions>()
+            .mapNotNull { purchaseMethodController.presentDepositOptions() }
+            .onEach { route -> dispatchEvent(Event.OpenScreen(route)) }
             .launchIn(viewModelScope)
     }
 
@@ -59,6 +66,7 @@ internal class BalanceViewModel @Inject constructor(
                 is Event.OnPreferredOnRampProviderChanged -> { state ->
                     state.copy(preferredOnRampProvider = event.provider)
                 }
+                Event.PresentDepositOptions -> { state -> state }
                 is Event.OpenScreen -> { state -> state }
             }
         }

apps/flipcash/features/currency-creator/src/main/kotlin/com/flipcash/app/currencycreator/internal/CurrencyCreatorViewModel.kt

@@ -14,6 +14,7 @@ import com.flipcash.app.currencycreator.CurrencyCreatorCoordinator
 import com.flipcash.app.currencycreator.internal.components.CurrencyCreatorTopBarController
 import com.flipcash.app.onramp.DeeplinkError
 import com.flipcash.app.onramp.DeeplinkOnRampError
+import com.flipcash.app.onramp.PhantomSwapResult
 import com.flipcash.app.onramp.PhantomWalletController
 import com.flipcash.app.onramp.isAlert
 import com.flipcash.app.onramp.isNetworkCause
@@ -542,7 +543,8 @@ internal class CurrencyCreatorViewModel @Inject constructor(
                         amount = totalAmount,
                         fee = feeAmount,
                         token = token,
-                    ).onSuccess { swapId ->
+                    ).onSuccess { result ->
+                        val swapId = (result as PhantomSwapResult.WithSwapId).swapId
                         dispatchEvent(Event.PurchaseSubmitted(swapId, token.address))
                     }.onFailure { error ->
                         handlePhantomError(error)

apps/flipcash/features/direct-send/build.gradle.kts

@@ -19,6 +19,7 @@ dependencies {
     implementation(project(":libs:messaging"))
     implementation(project(":libs:permissions:bindings"))
     implementation(project(":apps:flipcash:shared:featureflags"))
+    implementation(project(":apps:flipcash:shared:payments"))
     implementation(project(":apps:flipcash:shared:permissions"))
     implementation(project(":apps:flipcash:shared:contacts"))
     implementation(project(":apps:flipcash:shared:tokens"))

apps/flipcash/features/direct-send/src/main/kotlin/com/flipcash/app/directsend/SendFlowScreen.kt

@@ -15,6 +15,7 @@ import com.flipcash.app.directsend.internal.screens.ContactListScreen
 import com.flipcash.app.directsend.internal.screens.ContactsPermissionGateScreen
 import com.flipcash.app.directsend.internal.screens.PhoneGateLandingScreen
 import com.getcode.navigation.annotatedEntry
+import com.getcode.navigation.core.LocalCodeNavigator
 import com.getcode.navigation.flow.FlowExitReason
 import com.getcode.navigation.flow.FlowHost
 import com.getcode.navigation.flow.flowSharedViewModel

apps/flipcash/features/direct-send/src/main/kotlin/com/flipcash/app/directsend/internal/SendFlowViewModel.kt

@@ -8,9 +8,11 @@ import com.flipcash.app.contacts.ContactCoordinator
 import com.flipcash.app.contacts.ContactCoordinator.ContactState
 import com.flipcash.app.contacts.device.DeviceContact
 import com.flipcash.app.contacts.device.PickedContactData
+import com.flipcash.app.core.AppRoute
 import com.flipcash.app.core.send.SendStep
 import com.flipcash.app.featureflags.FeatureFlag
 import com.flipcash.app.featureflags.FeatureFlagController
+import com.flipcash.app.payments.PurchaseMethodController
 import com.flipcash.app.permissions.PickedContact
 import com.flipcash.app.tokens.TokenCoordinator
 import com.flipcash.features.directsend.R
@@ -31,6 +33,7 @@ import kotlinx.coroutines.flow.launchIn
 import kotlinx.coroutines.flow.map
 import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.flow.take
+import kotlinx.coroutines.launch
 import javax.inject.Inject
 import kotlin.time.Duration.Companion.seconds
 
@@ -41,6 +44,7 @@ internal class SendFlowViewModel @Inject constructor(
     private val contactCoordinator: ContactCoordinator,
     private val tokenCoordinator: TokenCoordinator,
     private val resources: ResourceHelper,
+    purchaseMethodController: PurchaseMethodController,
 ) : BaseViewModel<SendFlowViewModel.State, SendFlowViewModel.Event>(
     initialState = State(),
     updateStateForEvent = updateStateForEvent,
@@ -75,7 +79,8 @@ internal class SendFlowViewModel @Inject constructor(
 
         data class NavigateToChat(val contact: DeviceContact) : Event
         data class NavigateToDirectSend(val contact: DeviceContact) : Event
-        data object NavigateToDiscovery : Event
+        data object PresentDepositOptions : Event
+        data class NavigateToUsdfDepositOption(val route: AppRoute): Event
     }
 
     private val messengerEnabled = featureFlags.observe(FeatureFlag.Messenger)
@@ -169,9 +174,9 @@ internal class SendFlowViewModel @Inject constructor(
                                 message = resources.getString(R.string.description_noBalanceYet),
                                 actions = listOf(
                                     BottomBarAction(
-                                        text = resources.getString(R.string.action_discoverCurrencies)
+                                        text = resources.getString(R.string.action_depositFunds)
                                     ) {
-                                        dispatchEvent(Event.NavigateToDiscovery)
+                                        dispatchEvent(Event.PresentDepositOptions)
                                     },
                                 ),
                                 showCancel = true,
@@ -185,6 +190,14 @@ internal class SendFlowViewModel @Inject constructor(
                 }
             }.launchIn(viewModelScope)
 
+        eventFlow
+            .filterIsInstance<Event.PresentDepositOptions>()
+            .onEach {
+                purchaseMethodController.presentDepositOptions()?.let { route ->
+                    dispatchEvent(Event.NavigateToUsdfDepositOption(route))
+                }
+            }.launchIn(viewModelScope)
+
         eventFlow
             .filterIsInstance<Event.ContactRemoved>()
             .onEach { event -> contactCoordinator.removeContact(event.e164) }
@@ -272,7 +285,8 @@ internal class SendFlowViewModel @Inject constructor(
                 is Event.SendInvite -> { state -> state }
                 is Event.NavigateToChat -> { state -> state }
                 is Event.NavigateToDirectSend -> { state -> state }
-                is Event.NavigateToDiscovery -> { state -> state }
+                is Event.PresentDepositOptions -> { state -> state }
+                is Event.NavigateToUsdfDepositOption -> { state -> state }
             }
         }
     }