chore: add analytics for external wallet connections

Signed-off-by: Brandon McAnsh <[email protected]>

Author: bmc08gt

apps/flipcash/shared/onramp/deeplinks/src/main/kotlin/com/flipcash/app/onramp/ExternalWalletOnRampHandler.kt

@@ -18,8 +18,11 @@ import com.flipcash.app.onramp.internal.ExternalWalletState
 import com.flipcash.app.onramp.internal.buildConnectDeeplink
 import com.flipcash.app.onramp.internal.buildTransactionDeeplink
 import com.flipcash.app.router.Router
+import com.flipcash.services.analytics.FlipcashAnalyticsManager
+import com.flipcash.services.analytics.FlipcashAnalyticsService
 import com.flipcash.services.internal.model.thirdparty.OnRampProvider
 import com.flipcash.shared.onramp.deeplinks.R
+import com.getcode.libs.analytics.LocalAnalytics
 import com.getcode.manager.BottomBarAction
 import com.getcode.manager.BottomBarManager
 import com.getcode.navigation.core.CodeNavigator
@@ -46,6 +49,7 @@ fun ExternalWalletOnRampHandler(
 ) {
     val permissions = LocalPermissionChecker.current
     val composeScope = rememberCoroutineScope()
+    val analytics = LocalAnalytics.current as FlipcashAnalyticsService
 
     fun close(exit: Boolean) {
         if (exit) {
@@ -91,6 +95,13 @@ fun ExternalWalletOnRampHandler(
                         null -> ""
                     }
                 )
+
+                if (error is DeeplinkOnRampError.WalletProvidedError && error.code == DeeplinkError.UserRejectedRequest.code) {
+                    analytics.walletTransactionCancelled(state.provider!!)
+                } else if (error is DeeplinkOnRampError.FailedToSendTransaction) {
+                    analytics.walletTransactionFailed(state.provider!!)
+                }
+
                 trace(
                     tag = TAG,
                     message = "Something went wrong during deeplink onramp",
@@ -149,6 +160,7 @@ fun ExternalWalletOnRampHandler(
                     message = "wallet connect uri: $uri",
                     type = TraceType.Process
                 )
+                analytics.connectWallet(state.provider!!)
                 uriHandler.openUri(uri.toString())
                 state.deeplinkState = ExternalWalletState.CONNECTING
             }
@@ -185,6 +197,7 @@ fun ExternalWalletOnRampHandler(
                     message = "wallet transact uri: $uri",
                     type = TraceType.Process
                 )
+                analytics.amountSelectedForWalletTransfer(state.provider!!, state.amount!!)
                 uriHandler.openUri(uri.toString())
             }
 
@@ -211,6 +224,7 @@ fun ExternalWalletOnRampHandler(
                     message = "transaction complete",
                     type = TraceType.Process
                 )
+                analytics.transactionSubmittedToWallet(state.provider!!)
                 state.reset()
                 val hasPushPerms = permissions.isGranted(Manifest.permission.POST_NOTIFICATIONS)
                 BottomBarManager.showMessage(

services/flipcash/src/main/kotlin/com/flipcash/services/analytics/Analytics.kt

@@ -1,5 +1,6 @@
 package com.flipcash.services.analytics
 
+import com.flipcash.services.internal.model.thirdparty.OnRampProvider
 import com.getcode.ed25519.Ed25519.KeyPair
 import com.getcode.libs.analytics.AnalyticsService
 import com.getcode.libs.analytics.AppAction
@@ -46,6 +47,17 @@ interface FlipcashAnalyticsService : AnalyticsService {
     fun poolCreated(id: ID)
     fun placedBidInPool(id: ID)
     fun declaredOutcomeInPool(id: ID)
+
+    fun connectWallet(
+        provider: OnRampProvider.UsesDeeplinks
+    )
+    fun amountSelectedForWalletTransfer(
+        provider: OnRampProvider.UsesDeeplinks,
+        amount: Fiat
+    )
+    fun transactionSubmittedToWallet(provider: OnRampProvider.UsesDeeplinks)
+    fun walletTransactionFailed(provider: OnRampProvider.UsesDeeplinks)
+    fun walletTransactionCancelled(provider: OnRampProvider.UsesDeeplinks)
 }
 
 class FlipcashAnalyticsManager @Inject constructor(
@@ -122,6 +134,38 @@ class FlipcashAnalyticsManager @Inject constructor(
         track(event.name, *properties.toList().toTypedArray())
     }
 
+    override fun connectWallet(provider: OnRampProvider.UsesDeeplinks) {
+        val event = AnalyticsEvent.WalletConnect(provider)
+        val properties = event.properties()
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
+    override fun amountSelectedForWalletTransfer(provider: OnRampProvider.UsesDeeplinks, amount: Fiat) {
+        val event = AnalyticsEvent.WalletRequestAmount(provider)
+        val properties = event.properties(
+            nativeAmount = amount
+        )
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
+    override fun transactionSubmittedToWallet(provider: OnRampProvider.UsesDeeplinks) {
+        val event = AnalyticsEvent.WalletSubmitTransaction(provider)
+        val properties = event.properties()
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
+    override fun walletTransactionFailed(provider: OnRampProvider.UsesDeeplinks) {
+        val event = AnalyticsEvent.WalletTransactionFailed(provider)
+        val properties = event.properties()
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
+    override fun walletTransactionCancelled(provider: OnRampProvider.UsesDeeplinks) {
+        val event = AnalyticsEvent.WalletTransactionCancelled(provider)
+        val properties = event.properties()
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
     private fun track(name: String, vararg properties: Pair<String, String>) {
         if (BuildConfig.DEBUG) {
             trace(
@@ -219,6 +263,30 @@ sealed interface AnalyticsEvent {
     data class DeclaredOutcome(override val id: ID) : PoolEvent {
         override val name: String = "Pool: Declared Outcome"
     }
+
+    sealed interface WalletEvent : AnalyticsEvent {
+        val provider: OnRampProvider.UsesDeeplinks
+    }
+
+    data class WalletConnect(override val provider: OnRampProvider.UsesDeeplinks) : WalletEvent {
+        override val name: String = "Wallet: Connect"
+    }
+
+    data class WalletRequestAmount(override val provider: OnRampProvider.UsesDeeplinks) : WalletEvent {
+        override val name: String = "Wallet: Request Amount"
+    }
+
+    data class WalletSubmitTransaction(override val provider: OnRampProvider.UsesDeeplinks) : WalletEvent {
+        override val name: String = "Wallet: Transactions Submitted"
+    }
+
+    data class WalletTransactionFailed(override val provider: OnRampProvider.UsesDeeplinks) : WalletEvent {
+        override val name: String = "Wallet: Transactions Failed"
+    }
+
+    data class WalletTransactionCancelled(override val provider: OnRampProvider.UsesDeeplinks) : WalletEvent {
+        override val name: String = "Wallet: Cancel"
+    }
 }
 
 private fun AnalyticsEvent.properties(
@@ -236,6 +304,16 @@ private fun AnalyticsEvent.properties(
             }
         }
 
+        val providerName = if (this@properties is AnalyticsEvent.WalletEvent) {
+            when (provider) {
+                OnRampProvider.Backpack -> "Backpack"
+                OnRampProvider.Solflare -> "Solflare"
+                OnRampProvider.Phantom -> "Phantom"
+            }
+        } else {
+            ""
+        }
+
         when (val event = this@properties) {
             is AnalyticsEvent.SentCashLink -> {
                 if (event.clipboard == true) {
@@ -259,6 +337,24 @@ private fun AnalyticsEvent.properties(
             is AnalyticsEvent.PoolEvent -> {
                 put("ID", event.id.base58)
             }
+
+            is AnalyticsEvent.WalletConnect -> {
+                put("Provider", providerName)
+            }
+            is AnalyticsEvent.WalletRequestAmount -> {
+                put("Provider", providerName)
+                put("Fiat", nativeAmount?.doubleValue.toString())
+                put("Currency", nativeAmount?.currencyCode?.name.orEmpty())
+            }
+            is AnalyticsEvent.WalletSubmitTransaction -> {
+                put("Provider", providerName)
+            }
+            is AnalyticsEvent.WalletTransactionCancelled -> {
+                put("Provider", providerName)
+            }
+            is AnalyticsEvent.WalletTransactionFailed -> {
+                put("Provider", providerName)
+            }
         }
 
         if (localizedAmount != null) {