@ledgerhq/live-common 34.37.0 → 34.38.0-nightly.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ledgerhq/live-common",
   "description": "Common ground for the Ledger Live apps",
-  "version": "34.37.0",
+  "version": "34.38.0-nightly.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/LedgerHQ/ledger-live.git"
@@ -139,7 +139,7 @@
     "fuse.js": "^6.6.2",
     "invariant": "^2.2.2",
     "isomorphic-ws": "^4.0.1",
-    "jotai": "^2.10.1",
+    "jotai": "2.12.4",
     "json-rpc-2.0": "^0.2.19",
     "lodash": "^4.17.21",
     "minimatch": "^5.1.0",
@@ -162,70 +162,70 @@
     "xstate": "^5.19.2",
     "yargs": "^17.0.0",
     "zod": "^3.22.4",
-    "@ledgerhq/coin-algorand": "^0.9.9",
-    "@ledgerhq/coin-aptos": "^2.2.0",
-    "@ledgerhq/coin-bitcoin": "^0.16.0",
-    "@ledgerhq/coin-cardano": "^0.8.9",
-    "@ledgerhq/coin-casper": "^2.0.0",
-    "@ledgerhq/coin-celo": "^1.1.7",
-    "@ledgerhq/coin-evm": "^2.22.3",
-    "@ledgerhq/coin-cosmos": "^0.15.1",
-    "@ledgerhq/coin-filecoin": "^1.9.9",
-    "@ledgerhq/coin-framework": "^5.3.0",
-    "@ledgerhq/coin-hedera": "^1.7.1",
-    "@ledgerhq/coin-icon": "^0.10.9",
-    "@ledgerhq/coin-internet_computer": "^1.7.9",
-    "@ledgerhq/coin-mina": "^1.1.8",
-    "@ledgerhq/coin-multiversx": "^0.4.9",
-    "@ledgerhq/coin-polkadot": "^6.2.0",
-    "@ledgerhq/coin-near": "^0.11.9",
-    "@ledgerhq/coin-solana": "^0.25.1",
-    "@ledgerhq/coin-stacks": "^0.8.9",
-    "@ledgerhq/coin-stellar": "^5.2.0",
-    "@ledgerhq/coin-sui": "^0.5.0",
-    "@ledgerhq/coin-tezos": "^5.3.0",
-    "@ledgerhq/coin-ton": "^0.12.1",
-    "@ledgerhq/coin-tron": "^4.2.0",
-    "@ledgerhq/coin-vechain": "^2.7.9",
-    "@ledgerhq/coin-xrp": "^6.2.0",
-    "@ledgerhq/crypto-icons-ui": "^1.14.0",
+    "@ledgerhq/coin-algorand": "^0.9.10-nightly.0",
+    "@ledgerhq/coin-aptos": "^2.2.1-nightly.0",
+    "@ledgerhq/coin-bitcoin": "^0.16.1-nightly.0",
+    "@ledgerhq/coin-cardano": "^0.8.10-nightly.0",
+    "@ledgerhq/coin-casper": "^2.0.1-nightly.0",
+    "@ledgerhq/coin-celo": "^1.1.8-nightly.0",
+    "@ledgerhq/coin-cosmos": "^0.15.2-nightly.0",
+    "@ledgerhq/coin-evm": "^2.22.4-nightly.0",
+    "@ledgerhq/coin-filecoin": "^1.9.10-nightly.0",
+    "@ledgerhq/coin-framework": "^5.3.1-nightly.0",
+    "@ledgerhq/coin-hedera": "^1.7.2-nightly.0",
+    "@ledgerhq/coin-icon": "^0.10.10-nightly.0",
+    "@ledgerhq/coin-internet_computer": "^1.7.10-nightly.0",
+    "@ledgerhq/coin-mina": "^1.1.9-nightly.0",
+    "@ledgerhq/coin-multiversx": "^0.4.10-nightly.0",
+    "@ledgerhq/coin-near": "^0.11.10-nightly.0",
+    "@ledgerhq/coin-polkadot": "^6.2.1-nightly.0",
+    "@ledgerhq/coin-solana": "^0.26.0-nightly.0",
+    "@ledgerhq/coin-stacks": "^0.8.10-nightly.0",
+    "@ledgerhq/coin-stellar": "^5.2.1-nightly.0",
+    "@ledgerhq/coin-sui": "^0.5.1-nightly.0",
+    "@ledgerhq/coin-tezos": "^5.3.1-nightly.0",
+    "@ledgerhq/coin-ton": "^0.12.2-nightly.0",
+    "@ledgerhq/coin-tron": "^4.2.1-nightly.0",
+    "@ledgerhq/coin-vechain": "^2.7.10-nightly.0",
+    "@ledgerhq/coin-xrp": "^6.2.1-nightly.0",
+    "@ledgerhq/crypto-icons-ui": "^1.15.0-nightly.0",
     "@ledgerhq/cryptoassets": "^13.18.1",
-    "@ledgerhq/device-core": "^0.4.27",
-    "@ledgerhq/devices": "8.4.6",
-    "@ledgerhq/hw-app-algorand": "^6.31.2",
-    "@ledgerhq/hw-app-aptos": "^6.34.2",
-    "@ledgerhq/errors": "^6.21.0",
-    "@ledgerhq/hw-app-btc": "^10.9.2",
-    "@ledgerhq/hw-app-celo": "^6.33.5",
-    "@ledgerhq/hw-app-cosmos": "^6.32.2",
-    "@ledgerhq/hw-app-exchange": "^0.10.2",
-    "@ledgerhq/hw-app-eth": "^6.45.7",
-    "@ledgerhq/hw-app-hedera": "^1.2.2",
-    "@ledgerhq/hw-app-icon": "^1.3.2",
-    "@ledgerhq/hw-app-multiversx": "^6.24.2",
-    "@ledgerhq/hw-app-near": "^6.31.2",
-    "@ledgerhq/hw-app-str": "^7.2.2",
+    "@ledgerhq/device-core": "^0.4.28-nightly.0",
+    "@ledgerhq/devices": "8.4.7-nightly.0",
+    "@ledgerhq/errors": "^6.22.0-nightly.0",
+    "@ledgerhq/hw-app-algorand": "^6.31.3-nightly.0",
+    "@ledgerhq/hw-app-aptos": "^6.34.3-nightly.0",
+    "@ledgerhq/hw-app-btc": "^10.9.3-nightly.0",
+    "@ledgerhq/hw-app-celo": "^6.33.6-nightly.0",
+    "@ledgerhq/hw-app-cosmos": "^6.32.3-nightly.0",
+    "@ledgerhq/hw-app-eth": "^6.45.8-nightly.0",
+    "@ledgerhq/hw-app-exchange": "^0.10.3-nightly.0",
+    "@ledgerhq/hw-app-hedera": "^1.2.3-nightly.0",
+    "@ledgerhq/hw-app-icon": "^1.3.3-nightly.0",
+    "@ledgerhq/hw-app-multiversx": "^6.24.3-nightly.0",
+    "@ledgerhq/hw-app-near": "^6.31.3-nightly.0",
+    "@ledgerhq/hw-app-polkadot": "^6.34.3-nightly.0",
+    "@ledgerhq/hw-app-str": "^7.2.3-nightly.0",
     "@ledgerhq/hw-app-sui": "^1.1.0",
-    "@ledgerhq/hw-app-polkadot": "^6.34.2",
-    "@ledgerhq/hw-app-tezos": "^6.31.2",
-    "@ledgerhq/hw-app-trx": "^6.31.2",
+    "@ledgerhq/hw-app-tezos": "^6.31.3-nightly.0",
+    "@ledgerhq/hw-app-trx": "^6.31.3-nightly.0",
     "@ledgerhq/hw-app-vet": "^0.5.6",
     "@ledgerhq/hw-app-xrp": "^6.32.0",
-    "@ledgerhq/hw-transport": "^6.31.6",
+    "@ledgerhq/hw-transport": "^6.31.7-nightly.0",
+    "@ledgerhq/hw-transport-mocker": "^6.29.7-nightly.0",
     "@ledgerhq/ledger-cal-service": "^0.5.1",
-    "@ledgerhq/hw-transport-mocker": "^6.29.6",
     "@ledgerhq/live-config": "^3.1.0",
-    "@ledgerhq/live-countervalues": "^0.5.9",
-    "@ledgerhq/live-dmk-shared": "^0.9.0",
-    "@ledgerhq/live-countervalues-react": "^0.2.38",
+    "@ledgerhq/live-countervalues": "^0.5.10-nightly.0",
+    "@ledgerhq/live-dmk-shared": "^0.9.1-nightly.0",
+    "@ledgerhq/live-countervalues-react": "^0.2.39-nightly.0",
     "@ledgerhq/live-env": "^2.10.0",
     "@ledgerhq/live-hooks": "0.1.0",
     "@ledgerhq/live-network": "^2.0.10",
-    "@ledgerhq/live-nft": "^0.8.9",
+    "@ledgerhq/live-nft": "^0.8.10-nightly.0",
     "@ledgerhq/live-promise": "^0.1.1",
-    "@ledgerhq/live-signer-evm": "^0.5.2",
-    "@ledgerhq/live-signer-solana": "^0.2.1",
-    "@ledgerhq/live-wallet": "^0.11.0",
+    "@ledgerhq/live-signer-evm": "^0.5.3-nightly.0",
+    "@ledgerhq/live-signer-solana": "^0.3.0-nightly.0",
+    "@ledgerhq/live-wallet": "^0.11.1-nightly.0",
     "@ledgerhq/logs": "^6.13.0",
     "@ledgerhq/speculos-transport": "^0.2.3",
     "@ledgerhq/wallet-api-acre-module": "^0.5.0",
@@ -239,7 +239,7 @@
     "@tanstack/react-query": "^5.28.9",
     "@testing-library/react": "^14.1.2",
     "@types/bs58": "^4.0.1",
-    "@types/cbor": "^6.0.0",
+    "@types/cbor": "6.0.0",
     "@types/invariant": "^2.2.36",
     "@types/jest": "^29.5.10",
     "@types/lodash": "^4.14.179",
@@ -265,8 +265,8 @@
     "nock": "^13.0.5",
     "react": "18.3.1",
     "react-dom": "18.3.1",
-    "react-native": "0.74.5",
-    "react-native-svg": "13.14.0",
+    "react-native": "0.77.2",
+    "react-native-svg": "15.11.2",
     "react-redux": "^7.2.9",
     "react-test-renderer": "^18.2.0",
     "redux-actions": "2.6.5",
@@ -277,10 +277,10 @@
     "undici": "6.19.2",
     "uuid": "^8.3.2",
     "ws": "7",
+    "@ledgerhq/device-react": "^0.2.34-nightly.0",
     "@ledgerhq/types-cryptoassets": "^7.23.0",
     "@ledgerhq/types-devices": "^6.25.3",
-    "@ledgerhq/types-live": "^6.73.0",
-    "@ledgerhq/device-react": "^0.2.33"
+    "@ledgerhq/types-live": "^6.74.0-nightly.0"
   },
   "scripts": {
     "build": "zx ./scripts/build-ts.mjs",

package/src/e2e/enum/Provider.ts

@@ -9,7 +9,7 @@ export class Provider {
   static readonly CHANGELLY = new Provider("changelly", "Changelly", false, true, true);
   static readonly EXODUS = new Provider("exodus", "Exodus", false, true, true);
   static readonly ONE_INCH = new Provider("oneinch", "1inch", false, false, true);
-  static readonly PARASWAP = new Provider("paraswap", "Paraswap", false, false, true);
+  static readonly VELORA = new Provider("velora", "Velora", false, false, true);
   static readonly MOONPAY = new Provider("moonpay", "MoonPay", true, false, true);
   static readonly THORCHAIN = new Provider("thorswap", "THORChain", false, true, false);
   static readonly UNISWAP = new Provider("uniswap", "Uniswap", false, false, false);

package/src/e2e/speculos.ts

@@ -569,6 +569,9 @@ export async function expectValidAddressDevice(account: Account, addressDisplaye
     case Currency.ATOM:
       deviceLabels = [DeviceLabels.ADDRESS, DeviceLabels.CAPS_APPROVE, DeviceLabels.CAPS_REJECT];
       break;
+    case Currency.BTC:
+      deviceLabels = [DeviceLabels.ADDRESS, DeviceLabels.CONFIRM, DeviceLabels.CANCEL];
+      break;
     default:
       deviceLabels = [DeviceLabels.ADDRESS, DeviceLabels.APPROVE, DeviceLabels.REJECT];
       break;

package/src/e2e/speculosCI.ts

@@ -58,7 +58,7 @@ async function githubApiRequest<T = unknown>({
   }
 }
 
-function waitForSpeculosReady(url: string, { interval = 2000, timeout = 120_000 } = {}) {
+function waitForSpeculosReady(url: string, { interval = 2000, timeout = 300_000 } = {}) {
   return new Promise((resolve, reject) => {
     const startTime = Date.now();
 

package/src/e2e/swap.ts

@@ -3,7 +3,7 @@ import axios from "axios";
 
 export async function getMinimumSwapAmount(AccountFrom: Account, AccountTo: Account) {
   try {
-    const { data } = await axios({
+    const requestConfig = {
       method: "GET",
       url: `https://swap-stg.ledger-test.com/v5/quote`,
       params: {
@@ -24,16 +24,17 @@ export async function getMinimumSwapAmount(AccountFrom: Account, AccountTo: Acco
       headers: {
         accept: "application/json",
       },
-    });
+    };
 
-    const minimumAmounts = data.map((item: any) => {
-      return parseFloat(item.parameter.minAmount);
-    });
+    const { data } = await axios(requestConfig);
+
+    const minimumAmounts = data
+      .filter((item: any) => item.parameter?.minAmount !== undefined)
+      .map((item: any) => parseFloat(item.parameter.minAmount));
 
     const validMinimumAmounts = minimumAmounts.filter((amount: number) => !isNaN(amount));
 
-    const maxMinAmount = Math.max(...validMinimumAmounts);
-    return maxMinAmount;
+    return Math.max(...validMinimumAmounts);
   } catch (error) {
     console.error(error);
   }

package/src/exchange/providers/swap.integration.test.ts

@@ -1,19 +1,4 @@
-import { fetchAndMergeProviderData, findExchangeCurrencyData } from "./swap";
-
-describe("findExchangeCurrencyData", () => {
-  it("returns all data in expected format", async () => {
-    // When
-    const currencies = await findExchangeCurrencyData("arbitrum");
-
-    // Then
-    expect(currencies).toEqual({
-      config: "0345544808457468657265756d0d0345544812000000000000a4b1",
-      id: "arbitrum",
-      signature:
-        "30450221008ca557e4acc2fa290a6a44c2b0eb5232712ba69b23df93645a320bcff9789fd9022017e6e05582806a9d4b7b2aaaedbcc3471bd26e10ad686e4f313fc0b1068b5d64",
-    });
-  });
-});
+import { fetchAndMergeProviderData } from "./swap";
 
 describe("fetchAndMergeProviderData", () => {
   it("returns all data in expected format", async () => {
@@ -31,6 +16,11 @@ describe("fetchAndMergeProviderData", () => {
         mainUrl: "https://changelly.com/",
         name: "Changelly",
         needsKYC: false,
+        usefulUrls: [
+          "https://changelly.com/terms-of-use",
+          "https://changelly.com/aml-kyc",
+          "https://support.changelly.com/en/support/tickets/new",
+        ],
         publicKey: {
           curve: "secp256k1",
           data: Buffer.from(
@@ -47,6 +37,33 @@ describe("fetchAndMergeProviderData", () => {
         type: "CEX",
         version: 1,
       },
+      changelly_v2: {
+        displayName: "Changelly",
+        name: "Changelly",
+        useInExchangeApp: true,
+        publicKey: {
+          curve: "secp256k1",
+          data: Buffer.from(
+            "0480d7c0d3a9183597395f58dda05999328da6f18fabd5cda0aff8e8e3fc633436a2dbf48ecb23d40df7c3c7d3e774b77b4b5df0e9f7e08cf1cdf2dba788eb085b",
+            "hex",
+          ),
+        },
+        signature: Buffer.from(
+          "3045022100c2db00da651cfcc84702f75ab5f131a3f037592080ea750a6f665a8cb36797c802200e594938cdf2c836b34717f57487002a0588f2088f64f00a6c4d320fd37db6fa",
+          "hex",
+        ),
+        needsKYC: false,
+        type: "CEX",
+        usefulUrls: [
+          "https://changelly.com/terms-of-use",
+          "https://changelly.com/aml-kyc",
+          "https://support.changelly.com/en/support/tickets/new",
+        ],
+        termsOfUseUrl: "https://changelly.com/terms-of-use",
+        supportUrl: "https://support.changelly.com/en/support/home",
+        mainUrl: "https://changelly.com/",
+        version: 2,
+      },
       changenow: {
         name: "ChangeNOW",
         publicKey: {

package/src/exchange/providers/swap.ts

@@ -15,6 +15,7 @@ export type AdditionalProviderConfig = SwapProviderConfig & { type: "DEX" | "CEX
   version?: number;
   termsOfUseUrl: string;
   supportUrl: string;
+  usefulUrls?: string[];
   mainUrl: string;
   useInExchangeApp: boolean;
   displayName: string;
@@ -39,10 +40,41 @@ const DEFAULT_SWAP_PROVIDERS: Record<string, ProviderConfig & Partial<Additional
     needsKYC: false,
     needsBearerToken: false,
     type: "CEX",
+    usefulUrls: [
+      "https://changelly.com/terms-of-use",
+      "https://changelly.com/aml-kyc",
+      "https://support.changelly.com/en/support/tickets/new",
+    ],
     termsOfUseUrl: "https://changelly.com/terms-of-use",
     supportUrl: "https://support.changelly.com/en/support/home",
     mainUrl: "https://changelly.com/",
   },
+  changelly_v2: {
+    name: "Changelly",
+    publicKey: {
+      curve: "secp256k1",
+      data: Buffer.from(
+        "0480d7c0d3a9183597395f58dda05999328da6f18fabd5cda0aff8e8e3fc633436a2dbf48ecb23d40df7c3c7d3e774b77b4b5df0e9f7e08cf1cdf2dba788eb085b",
+        "hex",
+      ),
+    },
+    signature: Buffer.from(
+      "3045022100c2db00da651cfcc84702f75ab5f131a3f037592080ea750a6f665a8cb36797c802200e594938cdf2c836b34717f57487002a0588f2088f64f00a6c4d320fd37db6fa",
+      "hex",
+    ),
+    needsKYC: false,
+    needsBearerToken: false,
+    type: "CEX",
+    usefulUrls: [
+      "https://changelly.com/terms-of-use",
+      "https://changelly.com/aml-kyc",
+      "https://support.changelly.com/en/support/tickets/new",
+    ],
+    termsOfUseUrl: "https://changelly.com/terms-of-use",
+    supportUrl: "https://support.changelly.com/en/support/home",
+    mainUrl: "https://changelly.com/",
+    version: 2,
+  },
   exodus: {
     name: "exodus",
     publicKey: {

package/src/families/evm/config.ts

@@ -104,7 +104,7 @@ const evmConfig: CurrencyLiveConfigDefinition = {
         type: "ledger",
         explorerId: "eth",
       },
-      showNfts: true,
+      showNfts: false,
     },
   },
   config_currency_sonic: {
@@ -266,7 +266,7 @@ const evmConfig: CurrencyLiveConfigDefinition = {
         type: "ledger",
         explorerId: "matic",
       },
-      showNfts: true,
+      showNfts: false,
     },
   },
   config_currency_reosc: {

package/src/featureFlags/defaultFeatures.ts

@@ -396,6 +396,13 @@ export const DEFAULT_FEATURES: Features = {
     },
   },
 
+  buySellLoader: {
+    enabled: false,
+    params: {
+      durationMs: 0,
+    },
+  },
+
   buySellShortcut: {
     enabled: false,
   },
@@ -422,6 +429,10 @@ export const DEFAULT_FEATURES: Features = {
     },
   },
 
+  ptxSwapLiveAppKycWarning: {
+    enabled: false,
+  },
+
   llmAnalyticsOptInPrompt: {
     enabled: false,
     params: {
@@ -605,6 +616,7 @@ export const DEFAULT_FEATURES: Features = {
       live_app: true,
       receive_flow: true,
       send_flow: true,
+      enableModularization: false,
     },
   },
   llNftSupport: DEFAULT_FEATURE,
@@ -620,6 +632,30 @@ export const DEFAULT_FEATURES: Features = {
   lldNetworkBasedAddAccount: DEFAULT_FEATURE,
   llmOfacGeoBlocking: DEFAULT_FEATURE,
   lldOfacGeoBlocking: DEFAULT_FEATURE,
+  llmDatadog: {
+    ...DEFAULT_FEATURE,
+    params: {
+      batchProcessingLevel: "MEDIUM",
+      batchSize: "MEDIUM",
+      bundleLogsWithRum: true,
+      bundleLogsWithTraces: true,
+      longTaskThresholdMs: 0,
+      nativeInteractionTracking: false,
+      nativeLongTaskThresholdMs: 0,
+      nativeViewTracking: false,
+      resourceTracingSamplingRate: 0,
+      serviceName: "Ledger Live Mobile (default)",
+      sessionSamplingRate: 0,
+      trackBackgroundEvents: false,
+      trackFrustrations: true,
+      trackErrors: false,
+      trackResources: false,
+      trackInteractions: false,
+      trackWatchdogTerminations: false,
+      uploadFrequency: "AVERAGE",
+      vitalsUpdateFrequency: "AVERAGE",
+    },
+  },
 };
 
 // Firebase SDK treat JSON values as strings

package/src/featureFlags/stakePrograms/index.test.ts

@@ -35,13 +35,13 @@ const feature_stake_programs_json: Feature_StakePrograms = {
 
 describe("stakeProgramsToEarnParam", () => {
   it("should return `undefined` when there are no redirects", () => {
-    const result = stakeProgramsToEarnParam(feature_stake_programs_empty_json);
-    expect(result).toEqual(undefined);
+    const { stakeProgramsParam } = stakeProgramsToEarnParam(feature_stake_programs_empty_json);
+    expect(stakeProgramsParam).toEqual(undefined);
   });
 
   it("should return a record of stake earn params", () => {
-    const result = stakeProgramsToEarnParam(feature_stake_programs_json);
-    expect(result).toEqual({
+    const { stakeProgramsParam } = stakeProgramsToEarnParam(feature_stake_programs_json);
+    expect(stakeProgramsParam).toEqual({
       "ethereum/erc20/usd__coin": "kiln-widget",
       "ethereum/erc20/usd_tether__erc20_": "earn",
       tron: "stakekit",

package/src/featureFlags/stakePrograms/index.ts

@@ -1,19 +1,18 @@
-import type { Feature_StakePrograms, PlatformManifestId } from "@ledgerhq/types-live";
+import type { Feature_StakePrograms } from "@ledgerhq/types-live";
 
-export const stakeProgramsToEarnParam = (
-  stakePrograms: Feature_StakePrograms | null,
-): Record<PlatformManifestId, string> | undefined => {
+export const stakeProgramsToEarnParam = (stakePrograms: Feature_StakePrograms | null) => {
+  const list = stakePrograms?.params?.list ?? [];
   const redirects = stakePrograms?.params?.redirects ?? {};
   const result: Record<string, string> = {};
   const keys = Object.keys(redirects);
   if (keys.length === 0) {
-    return undefined;
+    return { stakeProgramsParam: undefined, stakeCurrenciesParam: [] };
   }
   keys.forEach(key => {
     result[key] = redirects[key].platform;
   });
 
-  return result;
+  return { stakeProgramsParam: result, stakeCurrenciesParam: list };
 };
 
 type StablecoinYield = "dapp" | "api" | "inactive";

package/src/hooks/useOFACGeoBlockCheck.ts

@@ -20,7 +20,7 @@ export const useOFACGeoBlockCheck = ({
     queryKey: ["ofac-geo-block", geoBlockingFeatureFlagKey],
     queryFn: async () => {
       if (!platformOfacGeoBlocking?.enabled) return false;
-      const res = await fetch(`${baseURL()}/v3/market`);
+      const res = await fetch(`${baseURL()}/v3/markets`);
       return res.status === 451;
     },
   });

package/src/hooks/useShowProviderLoadingTransition.test.ts

@@ -0,0 +1,112 @@
+/**
+ * @jest-environment jsdom
+ */
+
+import { renderHook } from "@testing-library/react";
+import { LiveAppManifest } from "../platform/types";
+import { INTERNAL_APP_IDS } from "../wallet-api/constants";
+import { useFeature } from "../featureFlags";
+import { useInternalAppIds } from "./useInternalAppIds";
+
+import { useShowProviderLoadingTransition } from "./useShowProviderLoadingTransition";
+
+jest.mock("../featureFlags", () => ({
+  useFeature: jest.fn(),
+}));
+jest.mock("../wallet-api/constants", () => ({
+  INTERNAL_APP_IDS: ["internal-app-id-1", "internal-app-id-2"],
+}));
+jest.mock("./useInternalAppIds", () => ({
+  useInternalAppIds: jest.fn(),
+}));
+
+describe("useShowProviderLoadingTransition", () => {
+  const mockUseFeature = useFeature as jest.Mock;
+  const mockUseInternalAppIds = useInternalAppIds as jest.Mock;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it("should return false when feature is disabled", () => {
+    mockUseFeature.mockReturnValue({ enabled: false, params: {} });
+    const { result } = renderHook(() =>
+      useShowProviderLoadingTransition({
+        manifest: { id: "test-app-id" } as LiveAppManifest,
+        isLoading: true,
+      }),
+    );
+    expect(result.current).toBe(false);
+  });
+
+  it("should return false for internal apps", () => {
+    mockUseFeature.mockReturnValue({ enabled: true, params: {} });
+    mockUseInternalAppIds.mockReturnValue(INTERNAL_APP_IDS);
+    const { result } = renderHook(() =>
+      useShowProviderLoadingTransition({
+        manifest: { id: "internal-app-id-1" } as LiveAppManifest,
+        isLoading: true,
+      }),
+    );
+    expect(result.current).toBe(false);
+  });
+
+  it("should return true when loading and feature is enabled", () => {
+    mockUseFeature.mockReturnValue({ enabled: true, params: {} });
+    mockUseInternalAppIds.mockReturnValue([]);
+    const { result } = renderHook(() =>
+      useShowProviderLoadingTransition({
+        manifest: { id: "test-app-id" } as LiveAppManifest,
+        isLoading: true,
+      }),
+    );
+    expect(result.current).toBe(true);
+  });
+
+  it("should handle extended loading state", () => {
+    jest.useFakeTimers();
+    mockUseFeature.mockReturnValue({ enabled: true, params: { durationMs: 1000 } });
+    mockUseInternalAppIds.mockReturnValue([]);
+
+    const { result, rerender } = renderHook(
+      ({ isLoading }) =>
+        useShowProviderLoadingTransition({
+          manifest: { id: "test-app-id" } as LiveAppManifest,
+          isLoading,
+        }),
+      {
+        initialProps: { isLoading: true },
+      },
+    );
+
+    expect(result.current).toBe(true);
+
+    // Simulate the timeout
+    jest.advanceTimersByTime(1000);
+
+    rerender({ isLoading: false });
+
+    expect(result.current).toBe(false);
+
+    jest.useRealTimers();
+  });
+  it("should clear timeout on unmount", () => {
+    jest.useFakeTimers();
+    mockUseFeature.mockReturnValue({ enabled: true, params: { durationMs: 1000 } });
+    mockUseInternalAppIds.mockReturnValue([]);
+
+    const { unmount } = renderHook(() =>
+      useShowProviderLoadingTransition({
+        manifest: { id: "test-app-id" } as LiveAppManifest,
+        isLoading: true,
+      }),
+    );
+
+    unmount();
+
+    // Advance timers to ensure no memory leaks
+    jest.advanceTimersByTime(1000);
+
+    jest.useRealTimers();
+  });
+});

package/src/hooks/useShowProviderLoadingTransition.ts

@@ -0,0 +1,57 @@
+import { useEffect, useRef, useState } from "react";
+
+import { useFeature } from "../featureFlags/index";
+import { INTERNAL_APP_IDS } from "../wallet-api/constants";
+import { useInternalAppIds } from "./useInternalAppIds";
+import { LiveAppManifest } from "../platform/types";
+
+export function useShowProviderLoadingTransition({
+  isLoading,
+  manifest,
+}: {
+  manifest: LiveAppManifest;
+  isLoading: boolean;
+}) {
+  const isEnabled = useProviderInterstitalEnabled({ manifest });
+  const [extendedInitialLoading, setExtendedInitialLoading] = useState(false);
+
+  const timeoutRef = useRef<NodeJS.Timeout | null>(null);
+  const buySellLoaderFF = useFeature("buySellLoader");
+  const durationMs = buySellLoaderFF?.params?.durationMs ?? 0;
+  const internalAppIds = useInternalAppIds() || INTERNAL_APP_IDS;
+  const isAppInternal = internalAppIds.includes(manifest.id);
+
+  useEffect(() => {
+    if (isEnabled && isLoading && !extendedInitialLoading) {
+      setExtendedInitialLoading(true);
+
+      if (timeoutRef.current) clearTimeout(timeoutRef.current);
+
+      timeoutRef.current = setTimeout(() => {
+        setExtendedInitialLoading(false);
+      }, durationMs);
+    }
+  }, [durationMs, extendedInitialLoading, isAppInternal, isEnabled, isLoading]);
+
+  useEffect(() => {
+    return () => {
+      if (timeoutRef.current) clearTimeout(timeoutRef.current);
+    };
+  }, []);
+
+  return isEnabled && (isLoading || extendedInitialLoading);
+}
+
+export function useProviderInterstitalEnabled({ manifest }: { manifest?: LiveAppManifest }) {
+  const buySellLoaderFF = useFeature("buySellLoader");
+  const internalAppIds = useInternalAppIds() || INTERNAL_APP_IDS;
+
+  if (!manifest) {
+    return false;
+  }
+
+  const isAppInternal = internalAppIds.includes(manifest.id);
+  const isEnabled = buySellLoaderFF?.enabled && !isAppInternal;
+
+  return isEnabled;
+}