From 6e0b563a546149a7f1d1ca5e72f682bf4f737982 Mon Sep 17 00:00:00 2001
From: gomes <17035424+gomesalexandre@users.noreply.github.com>
Date: Tue, 16 Dec 2025 03:12:52 +0300
Subject: [PATCH] fix: popular asset fixes for second-class chains

---
 .claude/skills/chain-integration/SKILL.md     | 39 +++++++++++++++++++
 .../hooks/useGetPopularAssetsQuery.tsx        | 17 +++++++-
 2 files changed, 55 insertions(+), 1 deletion(-)

diff --git a/.claude/skills/chain-integration/SKILL.md b/.claude/skills/chain-integration/SKILL.md
index 4b66d803bd6..bf5719724ad 100644
--- a/.claude/skills/chain-integration/SKILL.md
+++ b/.claude/skills/chain-integration/SKILL.md
@@ -1395,6 +1395,45 @@ Follow similar patterns for other swappers (CowSwap, 0x, etc.) - see `swapper-in
 
 **Reference**: Plasma added to Relay swapper for swap support
 
+### Step 5.5: Add Native Asset to Popular Assets
+
+**CRITICAL**: Second-class citizen chains are not in CoinGecko's top 100 by market cap, so they won't appear in the popular assets list by default. This causes the native asset to be missing when users filter by that chain.
+
+**File**: `src/components/TradeAssetSearch/hooks/useGetPopularAssetsQuery.tsx`
+
+```typescript
+// Add import at the top
+import {
+  hyperEvmAssetId,
+  mayachainAssetId,
+  monadAssetId,
+  plasmaAssetId,  // example for Plasma
+  [chainLower]AssetId,  // Add your chain's asset ID
+  thorchainAssetId,
+  tronAssetId,
+  suiAssetId,
+} from '@shapeshiftoss/caip'
+
+// Add to the queryFn, after the mayachain check (around line 37)
+// add second-class citizen chains to popular assets for discoverability
+if (enabledFlags.HyperEvm) assetIds.push(hyperEvmAssetId)
+if (enabledFlags.Monad) assetIds.push(monadAssetId)
+if (enabledFlags.Plasma) assetIds.push(plasmaAssetId)
+if (enabledFlags.[ChainName]) assetIds.push([chainLower]AssetId)  // Add your chain
+if (enabledFlags.Tron) assetIds.push(tronAssetId)
+if (enabledFlags.Sui) assetIds.push(suiAssetId)
+```
+
+**Why this is needed:**
+- Popular assets are fetched from CoinGecko's top 100 by market cap
+- New/small chains aren't in the top 100
+- Without this, when filtering by your chain, only tokens appear (via relatedAssetIds)
+- The native asset won't show up, which is confusing for users
+- Example: Searching "monad" in MetaMask (doesn't support Monad) shows Monad tokens but not MON itself
+
+**Reference PRs:**
+- See how Monad, Tron, Sui, Plasma, and HyperEVM were added in the same PR
+
 ---
 
 ## Phase 6: Ledger Support (Optional)
diff --git a/src/components/TradeAssetSearch/hooks/useGetPopularAssetsQuery.tsx b/src/components/TradeAssetSearch/hooks/useGetPopularAssetsQuery.tsx
index 173da51e965..db53d433c18 100644
--- a/src/components/TradeAssetSearch/hooks/useGetPopularAssetsQuery.tsx
+++ b/src/components/TradeAssetSearch/hooks/useGetPopularAssetsQuery.tsx
@@ -1,5 +1,13 @@
 import type { ChainId } from '@shapeshiftoss/caip'
-import { mayachainAssetId, thorchainAssetId } from '@shapeshiftoss/caip'
+import {
+  hyperEvmAssetId,
+  mayachainAssetId,
+  monadAssetId,
+  plasmaAssetId,
+  suiAssetId,
+  thorchainAssetId,
+  tronAssetId,
+} from '@shapeshiftoss/caip'
 import type { Asset } from '@shapeshiftoss/types'
 import { useQuery } from '@tanstack/react-query'
 
@@ -25,6 +33,13 @@ export const queryFn = async () => {
   assetIds.push(thorchainAssetId)
   if (enabledFlags.Mayachain) assetIds.push(mayachainAssetId)
 
+  // add second-class citizen chains to popular assets for discoverability
+  if (enabledFlags.HyperEvm) assetIds.push(hyperEvmAssetId)
+  if (enabledFlags.Monad) assetIds.push(monadAssetId)
+  if (enabledFlags.Plasma) assetIds.push(plasmaAssetId)
+  if (enabledFlags.Tron) assetIds.push(tronAssetId)
+  if (enabledFlags.Sui) assetIds.push(suiAssetId)
+
   for (const assetId of assetIds) {
     const asset = primaryAssets[assetId]
     const relatedAssetIds = selectRelatedAssetIds(store.getState(), { assetId })