feat: add metrics around purchases and sells of currency creator tokens

bmc08gt · bmc08gt · commit e8b4e40f5074 · 2026-02-18T14:36:24.000-05:00
Signed-off-by: Brandon McAnsh &lt;git@bmcreations.dev&gt;
diff --git a/apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/navigation/AppScreenContent.kt b/apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/navigation/AppScreenContent.kt
@@ -81,7 +81,7 @@ internal fun AppScreenContent(content: @Composable () -> Unit) {
         }
 
         register<AppRoute.Token.Info> {
-            TokenInfoScreen(it.mint, it.forNeededFunds)
+            TokenInfoScreen(it.mint, it.forNeededFunds, it.fromDeeplink)
         }
 
         register<AppRoute.Token.Transactions> {
diff --git a/apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/AppRoute.kt b/apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/AppRoute.kt
@@ -65,7 +65,7 @@ sealed interface AppRoute : ScreenProvider, Parcelable {
 
     @Parcelize
     sealed interface Token: AppRoute {
-        data class Info(val mint: Mint, val forNeededFunds: Boolean = false): Token
+        data class Info(val mint: Mint, val forNeededFunds: Boolean = false, val fromDeeplink: Boolean = false): Token
         data class Transactions(val mint: Mint): Token
         data class SwapTransact(val purpose: TokenSwapPurpose, val forNeededFunds: Boolean = false): Token
         data class TxProcessing(val swapId: SwapId): Token
diff --git a/apps/flipcash/features/scanner/src/main/kotlin/com/flipcash/app/scanner/internal/NavigationStateRestorer.kt b/apps/flipcash/features/scanner/src/main/kotlin/com/flipcash/app/scanner/internal/NavigationStateRestorer.kt
@@ -21,7 +21,7 @@ class NavigationStateRestorer(
                 navigator.show(
                     listOf(
                         ScreenRegistry.get(AppRoute.Sheets.Wallet),
-                        ScreenRegistry.get(AppRoute.Token.Info(deeplink.mint))
+                        ScreenRegistry.get(AppRoute.Token.Info(deeplink.mint, fromDeeplink = true))
                     )
                 )
             }
diff --git a/apps/flipcash/features/tokens/build.gradle.kts b/apps/flipcash/features/tokens/build.gradle.kts
@@ -56,6 +56,7 @@ dependencies {
     implementation(Libs.haze)
     implementation(Libs.haze_materials)
 
+    implementation(project(":apps:flipcash:shared:analytics"))
     implementation(project(":apps:flipcash:shared:onramp:deeplinks"))
     implementation(project(":apps:flipcash:shared:shareable"))
     implementation(project(":apps:flipcash:shared:tokens"))
diff --git a/apps/flipcash/features/tokens/src/main/kotlin/com/flipcash/app/tokens/TokenInfoScreen.kt b/apps/flipcash/features/tokens/src/main/kotlin/com/flipcash/app/tokens/TokenInfoScreen.kt
@@ -10,17 +10,22 @@ 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.annotation.ExperimentalVoyagerApi
+import cafe.adriel.voyager.core.lifecycle.LifecycleEffectOnce
 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.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.ui.TokenIconWithName
 import com.flipcash.app.onramp.LocalExternalWalletState
 import com.flipcash.app.onramp.OnRampFlowTracker
 import com.flipcash.app.tokens.internal.TokenInfoScreen
 import com.flipcash.app.tokens.ui.TokenInfoViewModel
 import com.flipcash.features.tokens.R
 import com.flipcash.services.internal.model.thirdparty.OnRampProvider
+import com.getcode.libs.analytics.LocalAnalytics
 import com.getcode.navigation.core.LocalCodeNavigator
 import com.getcode.navigation.modal.ModalScreen
 import com.getcode.navigation.screens.AppScreen
@@ -42,11 +47,13 @@ import kotlinx.parcelize.Parcelize
 class TokenInfoScreen(
     private val mint: Mint,
     private val forNeededFunds: Boolean,
+    private val fromDeeplink: Boolean,
 ) : AppScreen(), ModalScreen, Parcelable {
 
     @IgnoredOnParcel
     override val key: ScreenKey = uniqueScreenKey
 
+    @OptIn(ExperimentalVoyagerApi::class)
     @Composable
     override fun ModalContent() {
         val navigator = LocalCodeNavigator.current
@@ -56,6 +63,7 @@ class TokenInfoScreen(
             modifier = Modifier.fillMaxSize(),
             horizontalAlignment = Alignment.CenterHorizontally,
         ) {
+            val analytics = LocalAnalytics.current as FlipcashAnalyticsService
             val viewModel = getViewModel<TokenInfoViewModel>()
             val state by viewModel.stateFlow.collectAsStateWithLifecycle()
             AppBarWithTitle(
@@ -88,6 +96,19 @@ class TokenInfoScreen(
                 },
             )
 
+            LifecycleEffectOnce {
+                val event = when {
+                    forNeededFunds -> AnalyticsEvent.OpenTokenInfoEvent.Give
+                    fromDeeplink -> AnalyticsEvent.OpenTokenInfoEvent.Deeplink
+                    else -> AnalyticsEvent.OpenTokenInfoEvent.Wallet
+                }
+
+                analytics.openTokenInfo(
+                    from = event,
+                    mint = mint
+                )
+            }
+
             TokenInfoScreen(viewModel, forNeededFunds)
 
             LaunchedEffect(Unit) {
diff --git a/apps/flipcash/features/tokens/src/main/kotlin/com/flipcash/app/tokens/internal/TokenInfoScreen.kt b/apps/flipcash/features/tokens/src/main/kotlin/com/flipcash/app/tokens/internal/TokenInfoScreen.kt
@@ -29,6 +29,8 @@ import androidx.compose.ui.res.painterResource
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.unit.dp
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
+import com.flipcash.app.analytics.Action
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.core.data.Loadable
 import com.flipcash.app.core.money.RegionSelectionKind
@@ -38,6 +40,7 @@ import com.flipcash.app.tokens.internal.components.info.MarketCapSection
 import com.flipcash.app.tokens.internal.components.info.TokenBalance
 import com.flipcash.app.tokens.internal.components.info.TokenDetailsSection
 import com.flipcash.features.tokens.R
+import com.getcode.libs.analytics.LocalAnalytics
 import com.getcode.theme.CodeTheme
 import com.getcode.ui.core.drawWithGradient
 import com.getcode.ui.core.measured
@@ -264,6 +267,7 @@ private fun BottomBarButtons(
     modifier: Modifier = Modifier,
     dispatch: (TokenInfoViewModel.Event) -> Unit
 ) {
+    val analytics = LocalAnalytics.current as FlipcashAnalyticsService
     when (val loadable = state.token) {
         is Loadable.Error -> Unit
         is Loadable.Loaded -> {
@@ -290,6 +294,7 @@ private fun BottomBarButtons(
                                 buttonState = ButtonState.Filled20,
                                 text = stringResource(R.string.action_sell),
                             ) {
+                                analytics.action(Action.Sell)
                                 dispatch(
                                     TokenInfoViewModel.Event.OpenScreen(
                                         AppRoute.Token.SwapTransact(
diff --git a/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Actions.kt b/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Actions.kt
@@ -30,4 +30,16 @@ sealed class Action : AppAction {
     data object CompletedOnboarding : Action() {
         override val value: String = "Complete Onboarding"
     }
+
+    data object BuyWithReserves : Action() {
+        override val value: String = "Button: Buy With Reserves"
+    }
+
+    data object BuyWithPhantom : Action() {
+        override val value: String = "Button: Buy With Phantom"
+    }
+
+    data object Sell : Action() {
+        override val value: String = "Button: Sell"
+    }
 }
diff --git a/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Analytics.kt b/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Analytics.kt
@@ -8,8 +8,9 @@ import com.getcode.libs.analytics.AppActionSource
 import com.getcode.opencode.model.financial.CurrencyCode
 import com.getcode.opencode.model.financial.Fiat
 import com.getcode.opencode.model.financial.LocalFiat
+import com.getcode.solana.keys.Mint
 
-interface FlipcashAnalyticsService: AnalyticsService {
+interface FlipcashAnalyticsService : AnalyticsService {
     fun transfer(
         event: AnalyticsEvent.Transfer,
         amount: LocalFiat? = null,
@@ -59,6 +60,21 @@ interface FlipcashAnalyticsService: AnalyticsService {
     fun transactionSubmittedToWallet(provider: OnRampProvider.UsesDeeplinks)
     fun walletTransactionFailed(provider: OnRampProvider.UsesDeeplinks)
     fun walletTransactionCancelled(provider: OnRampProvider.UsesDeeplinks)
+
+    fun openTokenInfo(from: AnalyticsEvent.OpenTokenInfoEvent, mint: Mint)
+    fun buy(
+        method: AnalyticsEvent.TokenTransactionEvent.Purchase,
+        amount: Fiat,
+        mint: Mint,
+        error: Throwable? = null
+    )
+
+    fun sell(
+        amount: Fiat,
+        feeAmount: Fiat,
+        mint: Mint,
+        error: Throwable? = null
+    )
 }
 
 class StubFlipcashAnalytics : FlipcashAnalyticsService {
@@ -103,4 +119,14 @@ class StubFlipcashAnalytics : FlipcashAnalyticsService {
     override fun transactionSubmittedToWallet(provider: OnRampProvider.UsesDeeplinks) = Unit
     override fun walletTransactionFailed(provider: OnRampProvider.UsesDeeplinks) = Unit
     override fun walletTransactionCancelled(provider: OnRampProvider.UsesDeeplinks) = Unit
+
+    override fun openTokenInfo(from: AnalyticsEvent.OpenTokenInfoEvent, mint: Mint) = Unit
+    override fun buy(
+        method: AnalyticsEvent.TokenTransactionEvent.Purchase,
+        amount: Fiat,
+        mint: Mint,
+        error: Throwable?
+    ) = Unit
+
+    override fun sell(amount: Fiat, feeAmount: Fiat, mint: Mint, error: Throwable?) = Unit
 }
diff --git a/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Events.kt b/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Events.kt
@@ -119,6 +119,40 @@ sealed interface AnalyticsEvent {
         }
     }
 
+    sealed interface OpenTokenInfoEvent : AnalyticsEvent {
+        data object Deeplink : OpenTokenInfoEvent {
+            override val name: String = "Token Info: Opened From Deeplink"
+        }
+
+        data object Wallet : OpenTokenInfoEvent {
+            override val name: String = "Token Info: Opened From Wallet"
+        }
+
+        data object Give : OpenTokenInfoEvent {
+            override val name: String = "Token Info: Opened From Give"
+        }
+    }
+
+    sealed interface TokenTransactionEvent: AnalyticsEvent {
+        sealed interface Purchase: TokenTransactionEvent {
+            data object Reserves: Purchase {
+                override val name: String = "Token Purchase With Reserves"
+            }
+
+            data object Phantom: Purchase {
+                override val name: String = "Token Purchase With Phantom"
+            }
+
+            data object Coinbase: Purchase {
+                override val name: String = "Token Purchase With Coinbase"
+            }
+        }
+
+        data object Sell: TokenTransactionEvent {
+            override val name: String = "Token Sell"
+        }
+    }
+
     sealed interface WalletEvent : AnalyticsEvent {
         val provider: OnRampProvider.UsesDeeplinks
     }
diff --git a/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/internal/MixpanelAnalyticsDelegate.kt b/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/internal/MixpanelAnalyticsDelegate.kt
@@ -10,6 +10,7 @@ import com.getcode.opencode.model.financial.CurrencyCode
 import com.getcode.opencode.model.financial.Fiat
 import com.getcode.opencode.model.financial.LocalFiat
 import com.getcode.services.flipcash.BuildConfig
+import com.getcode.solana.keys.Mint
 import com.getcode.solana.keys.base58
 import com.getcode.utils.TraceType
 import com.getcode.utils.base58
@@ -142,10 +143,40 @@ internal class MixpanelAnalyticsDelegate @Inject constructor(
         track(event.name, *properties.toList().toTypedArray())
     }
 
+    override fun openTokenInfo(from: AnalyticsEvent.OpenTokenInfoEvent, mint: Mint) {
+        val properties = from.properties(mint = mint)
+        track(from.name, *properties.toList().toTypedArray())
+    }
+
+    override fun buy(
+        method: AnalyticsEvent.TokenTransactionEvent.Purchase,
+        amount: Fiat,
+        mint: Mint,
+        error: Throwable?
+    ) {
+        val properties = method.properties(mint = mint, nativeAmount = amount, error = error)
+        track(method.name, *properties.toList().toTypedArray())
+    }
+
+    override fun sell(
+        amount: Fiat,
+        feeAmount: Fiat,
+        mint: Mint,
+        error: Throwable?
+    ) {
+        val event = AnalyticsEvent.TokenTransactionEvent.Sell
+        val properties = event.properties(mint = mint, nativeAmount = amount, error = error)
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
     private fun track(name: String, vararg properties: Pair<String, String>) {
         if (BuildConfig.DEBUG) {
+            val propsString = properties.joinToString { "${it.first} => ${it.second}" }
             trace(
-                "debug track ${name}, ${properties.joinToString { "${it.first} => ${it.second}" }}",
+                buildString {
+                    append("debug track $name")
+                    if (propsString.isNotEmpty()) append(", $propsString")
+                },
                 type = TraceType.Silent
             )
             return
@@ -162,6 +193,8 @@ internal class MixpanelAnalyticsDelegate @Inject constructor(
 private fun AnalyticsEvent.properties(
     localizedAmount: LocalFiat? = null,
     nativeAmount: Fiat? = null,
+    feeAmount: Fiat? = null,
+    mint: Mint? = null,
     grabTime: Long? = null,
     successful: Boolean? = null,
     error: Throwable? = null,
@@ -233,6 +266,17 @@ private fun AnalyticsEvent.properties(
             }
 
             is AnalyticsEvent.OnRampOpenEvent -> Unit
+            is AnalyticsEvent.OpenTokenInfoEvent -> {
+                put("Mint", mint?.base58().orEmpty())
+            }
+            is AnalyticsEvent.TokenTransactionEvent -> {
+                put("Mint", mint?.base58().orEmpty())
+                put("Fiat", nativeAmount?.decimalValue.toString())
+                if (feeAmount != null) {
+                    put("Fee", feeAmount.decimalValue.toString())
+                }
+                put("Currency", nativeAmount?.currencyCode?.name.orEmpty())
+            }
             is AnalyticsEvent.OnRampVerificationEvent -> Unit
             AnalyticsEvent.OnRampPurchaseEvent.Completed -> {
                 put("Fiat", nativeAmount?.decimalValue.toString())
diff --git a/apps/flipcash/shared/tokens/src/main/kotlin/com/flipcash/app/tokens/ui/BuySellSwapTokenViewModel.kt b/apps/flipcash/shared/tokens/src/main/kotlin/com/flipcash/app/tokens/ui/BuySellSwapTokenViewModel.kt
@@ -2,6 +2,8 @@ package com.flipcash.app.tokens.ui
 
 import androidx.lifecycle.viewModelScope
 import com.flipcash.app.activityfeed.ActivityFeedCoordinator
+import com.flipcash.app.analytics.AnalyticsEvent
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.extensions.onResult
 import com.flipcash.app.core.extensions.to
 import com.flipcash.app.core.tokens.TokenSwapPurpose
@@ -67,6 +69,7 @@ class BuySellSwapTokenViewModel @Inject constructor(
     resources: ResourceHelper,
     tokenCoordinator: TokenCoordinator,
     feedCoordinator: ActivityFeedCoordinator,
+    private val analytics: FlipcashAnalyticsService,
 ) : BaseViewModel2<BuySellSwapTokenViewModel.State, BuySellSwapTokenViewModel.Event>(
     initialState = State(),
     updateStateForEvent = updateStateForEvent,
@@ -540,11 +543,13 @@ class BuySellSwapTokenViewModel @Inject constructor(
                     amount = amount,
                     of = token,
                 ).onSuccess { swapId ->
+                    trackTransaction(token)
                     dispatchEvent(Event.OnPurchaseSubmitted(token, swapId))
                     dispatchEvent(Event.UpdateBuyState(loading = false, success = true))
                     // buy submitted from reserves, drop reserves balance
                     tokenCoordinator.subtract(Token.usdf, amount)
                 }.onFailure {
+                    trackTransaction(token, error = it)
                     dispatchEvent(Event.UpdateBuyState(loading = false, success = false))
                     BottomBarManager.showError(
                         title = resources.getString(R.string.error_title_buySellFailed),
@@ -569,11 +574,13 @@ class BuySellSwapTokenViewModel @Inject constructor(
                     amount = amount,
                     of = token,
                 ).onSuccess { swapId ->
+                    trackTransaction(token)
                     dispatchEvent(Event.OnSellSubmitted(token, swapId))
                     dispatchEvent(Event.UpdateSellState(loading = false, success = true))
                     // sell submitted, drop from balance
                     tokenCoordinator.subtract(token, amount)
                 }.onFailure {
+                    trackTransaction(token, error = it)
                     dispatchEvent(Event.UpdateSellState(loading = false, success = false))
                     BottomBarManager.showError(
                         title = resources.getString(R.string.error_title_buySellFailed),
@@ -617,6 +624,34 @@ class BuySellSwapTokenViewModel @Inject constructor(
             ).launchIn(viewModelScope)
     }
 
+    private fun trackTransaction(token: Token, error: Throwable? = null) {
+        val purpose = stateFlow.value.purpose
+        val method = when (purpose) {
+            is TokenSwapPurpose.Buy -> AnalyticsEvent.TokenTransactionEvent.Purchase.Reserves
+            is TokenSwapPurpose.FundWithWallet -> AnalyticsEvent.TokenTransactionEvent.Purchase.Phantom
+            else -> AnalyticsEvent.TokenTransactionEvent.Sell
+        }
+
+        when (method) {
+            AnalyticsEvent.TokenTransactionEvent.Sell -> {
+                analytics.sell(
+                    amount = stateFlow.value.netTransferAmount,
+                    feeAmount = stateFlow.value.feeAmount,
+                    mint = token.address,
+                    error = error
+                )
+            }
+            is AnalyticsEvent.TokenTransactionEvent.Purchase -> {
+                analytics.buy(
+                    method = method,
+                    amount = stateFlow.value.netTransferAmount,
+                    mint = token.address,
+                    error = error
+                )
+            }
+        }
+    }
+
     internal companion object {
         val updateStateForEvent: (Event) -> ((State) -> State) = { event ->
             when (event) {
diff --git a/apps/flipcash/shared/tokens/src/main/kotlin/com/flipcash/app/tokens/ui/TokenInfoViewModel.kt b/apps/flipcash/shared/tokens/src/main/kotlin/com/flipcash/app/tokens/ui/TokenInfoViewModel.kt

Original file line number	Diff line number	Diff line change
`@@ -81,7 +81,7 @@ internal fun AppScreenContent(content: @Composable () -> Unit) {`
`81`	`81`	`}`
`82`	`82`
`83`	`83`	`register<AppRoute.Token.Info> {`
`84`		`- TokenInfoScreen(it.mint, it.forNeededFunds)`
	`84`	`+ TokenInfoScreen(it.mint, it.forNeededFunds, it.fromDeeplink)`
`85`	`85`	`}`
`86`	`86`
`87`	`87`	`register<AppRoute.Token.Transactions> {`
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,7 @@ class NavigationStateRestorer(`
`21`	`21`	`navigator.show(`
`22`	`22`	`listOf(`
`23`	`23`	`ScreenRegistry.get(AppRoute.Sheets.Wallet),`
`24`		`- ScreenRegistry.get(AppRoute.Token.Info(deeplink.mint))`
	`24`	`+ ScreenRegistry.get(AppRoute.Token.Info(deeplink.mint, fromDeeplink = true))`
`25`	`25`	`)`
`26`	`26`	`)`
`27`	`27`	`}`