[WIP] Swap to New Token

@shared/api/internal.ts

@@ -2514,3 +2514,35 @@ export const dismissDiscoverWelcome = async (): Promise<boolean> => {
 
   return !!hasSeenDiscoverWelcome;
 };
+
+export const getCachedSwapTopTokens = async (
+  network: string,
+): Promise<{ tokens: unknown[]; updatedAt: number } | null> => {
+  const { cachedSwapTopTokens, error } = await sendMessageToBackground({
+    activePublicKey: null,
+    type: SERVICE_TYPES.GET_CACHED_SWAP_TOP_TOKENS,
+    network,
+  });
+
+  if (error) {
+    throw new Error(error);
+  }
+
+  return cachedSwapTopTokens || null;
+};
+
+export const cacheSwapTopTokens = async (
+  network: string,
+  tokens: unknown[],
+): Promise<void> => {
+  const { error } = await sendMessageToBackground({
+    activePublicKey: null,
+    type: SERVICE_TYPES.CACHE_SWAP_TOP_TOKENS,
+    network,
+    tokens,
+  });
+
+  if (error) {
+    throw new Error(error);
+  }
+};

@shared/api/types/message-request.ts

@@ -325,6 +325,18 @@ export interface CacheAssetIconMessage extends BaseMessage {
   iconUrl: string;
 }
 
+export interface GetCachedSwapTopTokensMessage extends BaseMessage {
+  type: SERVICE_TYPES.GET_CACHED_SWAP_TOP_TOKENS;
+  network: string;
+}
+
+export interface CacheSwapTopTokensMessage extends BaseMessage {
+  type: SERVICE_TYPES.CACHE_SWAP_TOP_TOKENS;
+  network: string;
+  // Opaque to the background — the popup owns the trending-asset schema.
+  tokens: unknown[];
+}
+
 export interface GetCachedDomainMessage extends BaseMessage {
   type: SERVICE_TYPES.GET_CACHED_ASSET_DOMAIN;
   assetCanonical: string;
@@ -524,6 +536,8 @@ export type ServiceMessageRequest =
   | GetCachedAssetIconListMessage
   | GetCachedAssetIconMessage
   | CacheAssetIconMessage
+  | GetCachedSwapTopTokensMessage
+  | CacheSwapTopTokensMessage
   | GetCachedDomainMessage
   | CacheDomainMessage
   | GetMemoRequiredAccountsMessage

@shared/api/types/types.ts

@@ -130,6 +130,7 @@ export interface Response {
   overriddenBlockaidResponse: string | null;
   recentProtocols: RecentProtocolEntry[];
   hasSeenDiscoverWelcome: boolean;
+  cachedSwapTopTokens: { tokens: unknown[]; updatedAt: number } | null;
 }
 
 export interface MemoRequiredAccount {

@shared/constants/services.ts

@@ -70,6 +70,8 @@ export enum SERVICE_TYPES {
   CLEAR_RECENT_PROTOCOLS = "CLEAR_RECENT_PROTOCOLS",
   GET_DISCOVER_WELCOME_SEEN = "GET_DISCOVER_WELCOME_SEEN",
   DISMISS_DISCOVER_WELCOME = "DISMISS_DISCOVER_WELCOME",
+  GET_CACHED_SWAP_TOP_TOKENS = "GET_CACHED_SWAP_TOP_TOKENS",
+  CACHE_SWAP_TOP_TOKENS = "CACHE_SWAP_TOP_TOKENS",
   USER_ACTIVITY = "USER_ACTIVITY",
   SESSION_LOCKED = "SESSION_LOCKED",
   SESSION_UNLOCKED = "SESSION_UNLOCKED",

config/shims/webextension-polyfill.ts

@@ -1,5 +1,42 @@
+/**
+ * Dev-only stub for `webextension-polyfill`, swapped in by webpack.dev.js
+ * (NormalModuleReplacementPlugin). The popup served at localhost:9000 runs as a
+ * plain web page with no extension runtime, so `browser.*` APIs the UI touches
+ * at mount must resolve to no-ops — otherwise listeners registered in effects
+ * (e.g. SessionLockListener's `runtime.onMessage`, SidebarSigningListener's
+ * `runtime.connect`) throw and the error boundary takes down the whole app.
+ *
+ * This only makes the UI render for fast iteration — real messaging requires
+ * loading the unpacked extension.
+ */
+
+const noopEvent = {
+  addListener: () => undefined,
+  removeListener: () => undefined,
+  hasListener: () => false,
+};
+
+const makePort = (name = "") => ({
+  name,
+  onMessage: noopEvent,
+  onDisconnect: noopEvent,
+  postMessage: () => undefined,
+  disconnect: () => undefined,
+});
+
 export default {
   tabs: {
     create: ({ url }: { url: string }) => window.open(url),
   },
+  runtime: {
+    onMessage: noopEvent,
+    onMessageExternal: noopEvent,
+    connect: ({ name }: { name?: string } = {}) => makePort(name),
+    sendMessage: () =>
+      Promise.reject(
+        new Error(
+          "webextension-polyfill dev shim: runtime messaging is unavailable at localhost:9000 — load the unpacked extension for full functionality",
+        ),
+      ),
+  },
 };