feat(accounts): add usd cost basis to support currency appreciation

bmc08gt · bmc08gt · commit a28add8a1a11 · 2026-01-26T14:19:17.000-05:00
Signed-off-by: Brandon McAnsh &lt;git@bmcreations.dev&gt;
diff --git a/apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/ui/TokenBalanceRow.kt b/apps/flipcash/core/src/main/kotlin/com/flipcash/app/core/ui/TokenBalanceRow.kt
@@ -60,7 +60,7 @@ fun TokenBalanceRow(
     contentPadding: PaddingValues = PaddingValues(vertical = CodeTheme.dimens.inset),
     onClick: (() -> Unit)? = null,
 ) {
-    val (token, balance, displayName) = tokenWithBalance
+    val (token, balance, _, displayName) = tokenWithBalance
     TokenBalanceRow(
         token = token,
         displayName = displayName,
@@ -92,7 +92,7 @@ fun TokenBalanceRow(
     contentPadding: PaddingValues = PaddingValues(vertical = CodeTheme.dimens.inset),
     onClick: (() -> Unit)? = null,
 ) {
-    val (token, balance, displayName) = tokenWithBalance
+    val (token, balance, _, displayName) = tokenWithBalance
     TokenBalanceRow(
         token = token,
         displayName = displayName,
diff --git a/apps/flipcash/core/src/main/res/values/strings.xml b/apps/flipcash/core/src/main/res/values/strings.xml
@@ -400,4 +400,8 @@
 
     <string name="error_title_buySellFailed">Something Went Wrong</string>
     <string name="error_description_buySellFailed">Please try again</string>
+
+    <string name="label_fromCurrencyAppreciation">from currency appreciation</string>
+    <string name="label_fromCurrencyDepreciation">from currency depreciation</string>
+
 </resources>
diff --git a/apps/flipcash/features/balance/src/main/kotlin/com/flipcash/app/balance/internal/BalanceScreenContent.kt b/apps/flipcash/features/balance/src/main/kotlin/com/flipcash/app/balance/internal/BalanceScreenContent.kt
@@ -63,7 +63,8 @@ private fun BalanceScreenContent(
         BalanceHeader(
             modifier = Modifier
                 .fillMaxWidth(),
-            balance = tokenState.totalBalance
+            balance = tokenState.totalBalance,
+            appreciation = tokenState.aggregateAppreciation,
         ) {
             dispatchEvent(BalanceViewModel.Event.OpenCurrencySelection)
         }
diff --git a/apps/flipcash/features/balance/src/main/kotlin/com/flipcash/app/balance/internal/components/BalanceHeader.kt b/apps/flipcash/features/balance/src/main/kotlin/com/flipcash/app/balance/internal/components/BalanceHeader.kt
@@ -1,25 +1,36 @@
 package com.flipcash.app.balance.internal.components
 
 import androidx.compose.animation.Crossfade
+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.fillMaxWidth
 import androidx.compose.foundation.layout.padding
+import androidx.compose.material.MaterialTheme
+import androidx.compose.material.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.alpha
 import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.unit.dp
+import com.flipcash.app.tokens.data.Period
 import com.flipcash.features.balance.R
 import com.getcode.opencode.compose.LocalExchange
 import com.getcode.opencode.model.financial.CurrencyCode
+import com.getcode.opencode.model.financial.Fiat
 import com.getcode.opencode.model.financial.LocalFiat
 import com.getcode.theme.CodeTheme
+import com.getcode.theme.extraSmall
 import com.getcode.ui.components.text.AmountArea
 import com.getcode.ui.theme.CodeCircularProgressIndicator
 
 @Composable
 internal fun BalanceHeader(
     balance: LocalFiat?,
+    appreciation: LocalFiat?,
     modifier: Modifier = Modifier,
     onClick: () -> Unit
 ) {
@@ -28,6 +39,7 @@ internal fun BalanceHeader(
         modifier = modifier
             .padding(horizontal = CodeTheme.dimens.inset)
             .padding(vertical = CodeTheme.dimens.grid.x9),
+        horizontalAlignment = Alignment.CenterHorizontally,
     ) {
         if (balance == null) {
             Box(modifier = Modifier.fillMaxWidth(), contentAlignment = Alignment.Center) {
@@ -45,6 +57,50 @@ internal fun BalanceHeader(
                     onClick = onClick
                 )
             }
+
+            if (appreciation != null) {
+                Crossfade(appreciation.nativeAmount) { amount ->
+                    val hasAppreciation = amount.decimalValue >= 0
+                    val changeColor = if (hasAppreciation) {
+                        CodeTheme.colors.successText
+                    } else {
+                        CodeTheme.colors.errorText
+                    }
+
+                    Row(
+                        verticalAlignment = Alignment.CenterVertically,
+                        horizontalArrangement = Arrangement.spacedBy(CodeTheme.dimens.grid.x1),
+                    ) {
+                        Text(
+                            modifier = Modifier
+                                .background(
+                                    color = changeColor.copy(0.20f),
+                                    shape = MaterialTheme.shapes.extraSmall,
+                                )
+                                .padding(
+                                    vertical = 2.dp,
+                                    horizontal = CodeTheme.dimens.grid.x1
+                                ),
+                            text = amount.formatted(
+                                extraPrefix = if (hasAppreciation) "+" else "-",
+                            ),
+                            style = CodeTheme.typography.textSmall,
+                            color = changeColor,
+                        )
+
+                        val label = if (hasAppreciation) {
+                            stringResource(R.string.label_fromCurrencyAppreciation)
+                        } else {
+                            stringResource(R.string.label_fromCurrencyDepreciation)
+                        }
+                        Text(
+                            text = label,
+                            style = CodeTheme.typography.textSmall,
+                            color = changeColor,
+                        )
+                    }
+                }
+            }
         }
     }
 }
diff --git a/apps/flipcash/shared/tokens/src/main/kotlin/SelectTokenViewModel.kt b/apps/flipcash/shared/tokens/src/main/kotlin/SelectTokenViewModel.kt
@@ -57,6 +57,9 @@ class SelectTokenViewModel @Inject constructor(
     ) {
         val totalBalance: LocalFiat
             get() = tokens.orEmpty().map { it.balance }.sum()
+
+        val aggregateAppreciation: LocalFiat?
+            get() = tokens?.map { it.appreciation }?.sum()
     }
 
     sealed interface Event {
@@ -115,7 +118,11 @@ class SelectTokenViewModel @Inject constructor(
                                 balance = LocalFiat(
                                     usdf = it.balance,
                                     nativeAmount = it.balance.convertingTo(rate),
-                                )
+                                ),
+                                appreciation = LocalFiat(
+                                    usdf = it.appreciation,
+                                    nativeAmount = it.appreciation.convertingTo(rate),
+                                ),
                             )
                         }
                         .sortedWith(compareByDescending { item ->
diff --git a/definitions/opencode/protos/src/main/proto/account/v1/account_service.proto b/definitions/opencode/protos/src/main/proto/account/v1/account_service.proto
@@ -207,4 +207,8 @@ message TokenAccountInfo {
     // For REMOTE_SEND_GIFT_CARD, if requesting_owner was provided, was
     // requesting_owner the issuer of the account.
     bool is_gift_card_issuer = 14;
+
+    // The USD cost basis for this account, which can be used to compute currency
+    // appreciation/depreciation
+    double usd_cost_basis = 15;
 }
diff --git a/services/opencode/src/main/kotlin/com/getcode/opencode/controllers/TokenController.kt b/services/opencode/src/main/kotlin/com/getcode/opencode/controllers/TokenController.kt
@@ -44,7 +44,6 @@ import kotlinx.coroutines.flow.map
 import kotlinx.coroutines.flow.mapNotNull
 import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.flow.update
-import org.checkerframework.checker.units.qual.min
 import javax.inject.Inject
 import javax.inject.Singleton
 import kotlin.concurrent.atomics.AtomicBoolean
@@ -82,13 +81,16 @@ class TokenController @Inject constructor(
         return tokenFetchState[mint]?.load() ?: false
     }
 
+    private val mintUsdAppreciationMap = MutableStateFlow(mapOf<Mint, Fiat>())
+
     private val mintBalances = MutableStateFlow(mapOf<Mint, Fiat>())
     val tokens = MutableStateFlow(emptyList<Token>())
 
     val tokenBalances: Flow<List<TokenWithBalance>> = mintBalances.map {
         it.mapNotNull { (mint, balance) ->
             val token = tokens.value.find { it.address == mint } ?: return@mapNotNull null
-            TokenWithBalance(token, balance)
+            val appreciation = mintUsdAppreciationMap.value[mint] ?: Fiat.Zero
+            TokenWithBalance(token, balance, appreciation)
         }
     }
 
@@ -242,18 +244,25 @@ class TokenController @Inject constructor(
                         .firstOrNull() ?: return@mapNotNull null
 
                     val tokenBalance = Fiat.tokenBalance(account.balance, token = token)
+                    val costBasis = Fiat(fiat = account.usdCostBasis)
+
+                    TokenWithBalance(
+                        token = token,
+                        balance = tokenBalance,
+                        appreciation = tokenBalance - costBasis
 
-                    TokenWithBalance(token, tokenBalance)
+                    )
                 }
         }?.onSuccess { tokensWithBalance ->
-            tokensWithBalance.onEach { (token, balance) ->
+            tokensWithBalance.onEach { (token, balance, appreciation) ->
                 trace(
                     tag = "Tokens",
                     message = "Updated balance for ${token.symbol} is ${balance.formatted()} USD",
                     type = TraceType.Process
                 )
 
                 mintBalances.update { it + (token.address to balance) }
+                mintUsdAppreciationMap.update { it + (token.address to appreciation) }
                 tokens.update { (it + token).distinctBy { t -> t.address } }
             }
 
diff --git a/services/opencode/src/main/kotlin/com/getcode/opencode/model/accounts/AccountInfo.kt b/services/opencode/src/main/kotlin/com/getcode/opencode/model/accounts/AccountInfo.kt
@@ -94,7 +94,12 @@ data class AccountInfo(
      * For REMOTE_SEND_GIFT_CARD, if requesting_owner was provided, was
      * requesting_owner the issuer of the account.
      */
-    val isGiftCardIssuer: Boolean
+    val isGiftCardIssuer: Boolean,
+
+    /**
+     * The USD cost basis for this account, which can be used to compute currency appreciation/depreciation
+     */
+    val usdCostBasis: Double,
 ) {
     companion object {
         fun newInstance(info: AccountService.TokenAccountInfo): AccountInfo? {
@@ -126,7 +131,9 @@ data class AccountInfo(
                 originalExchangeData = exchangeData,
                 mint = info.mint.toMint(),
                 createdAt = info.createdAt.seconds * 1000L,
-                isGiftCardIssuer = info.isGiftCardIssuer
+                isGiftCardIssuer = info.isGiftCardIssuer,
+                usdCostBasis = info.usdCostBasis,
+
             )
         }
     }
diff --git a/services/opencode/src/main/kotlin/com/getcode/opencode/model/financial/MintMetadata.kt b/services/opencode/src/main/kotlin/com/getcode/opencode/model/financial/MintMetadata.kt
@@ -15,6 +15,7 @@ import kotlin.time.Instant
 data class TokenWithBalance(
     val token: Token,
     val balance: Fiat,
+    val appreciation: Fiat = Fiat.Zero,
     val displayName: String = token.name,
 ) {
     val isReserves: Boolean
@@ -24,6 +25,7 @@ data class TokenWithBalance(
 data class TokenWithLocalizedBalance(
     val token: Token,
     val balance: LocalFiat,
+    val appreciation: LocalFiat = LocalFiat.Zero,
     val displayName: String = token.name,
 ) {
     val isReserves: Boolean

Original file line number	Diff line number	Diff line change
`@@ -207,4 +207,8 @@ message TokenAccountInfo {`
`207`	`207`	`// For REMOTE_SEND_GIFT_CARD, if requesting_owner was provided, was`
`208`	`208`	`// requesting_owner the issuer of the account.`
`209`	`209`	`bool is_gift_card_issuer = 14;`
	`210`	`+`
	`211`	`+ // The USD cost basis for this account, which can be used to compute currency`
	`212`	`+ // appreciation/depreciation`
	`213`	`+ double usd_cost_basis = 15;`
`210`	`214`	`}`