Zcash: Add Ironwood migration entry points

Three condition-gated surfaces, all dormant until the engine reports the wallet needs (or is running/erred on) the migration - no fork-date gating needed: a warning card on the wallet scene under the sync status card, a per-wallet notification-center card (ironwoodMigration-<walletId>, armed by a new ZcashMigrationService poller; the condition mechanism automatically re-surfaces it if new Orchard funds arrive after completion), and a kebab menu item gated to the zcash plugin.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: peachbits

src/actions/WalletListMenuActions.tsx

@@ -45,6 +45,7 @@ export type WalletListMenuKey =
   | 'getRawKeys'
   | 'rawDelete'
   | 'togglePause'
+  | 'ironwoodMigration'
   | string // for split keys like splitbitcoincash, splitethereum, etc.
 
 export function walletListMenuAction(
@@ -76,6 +77,14 @@ export function walletListMenuAction(
       }
     }
 
+    case 'ironwoodMigration': {
+      return async (dispatch, getState) => {
+        navigation.navigate('zcashMigrationOptions' as any, {
+          walletId
+        })
+      }
+    }
+
     case 'rawDelete': {
       return async (dispatch, getState) => {
         const state = getState()

src/components/modals/WalletListMenuModal.tsx

@@ -120,6 +120,11 @@ export const WALLET_LIST_MENU: Array<{
     label: lstrings.fragment_wallets_view_private_view_key,
     value: 'viewPrivateViewKey'
   },
+  {
+    pluginIds: ['zcash'],
+    label: lstrings.zcash_migration_menu_item,
+    value: 'ironwoodMigration'
+  },
   {
     label: lstrings.string_get_raw_keys,
     value: 'getRawKeys'

src/components/notification/NotificationView.tsx

@@ -26,6 +26,7 @@ import { config } from '../../theme/appConfig'
 import { useDispatch, useSelector } from '../../types/reactRedux'
 import type { NavigationBase } from '../../types/routerTypes'
 import { getThemedIconUri } from '../../util/CdnUris'
+import { getWalletName } from '../../util/CurrencyWalletHelpers'
 import { showOtpReminderModal } from '../../util/otpReminder'
 import { openBrowserUri } from '../../util/WebUtils'
 import { styled } from '../hoc/styled'
@@ -174,6 +175,18 @@ export const NotificationView: React.FC<Props> = props => {
       }
     })
 
+    // Zcash Ironwood migration cards per wallet
+    Object.keys(wallets).forEach(walletId => {
+      const migrationKey = `ironwoodMigration-${walletId}`
+      if (
+        notifState[migrationKey] != null &&
+        !notifState[migrationKey].isBannerHidden &&
+        !notifState[migrationKey].isCompleted
+      ) {
+        visibleIds.push(migrationKey)
+      }
+    })
+
     if (!otpReminder.isBannerHidden && !account.isDuressAccount)
       visibleIds.push('otpReminder')
 
@@ -327,9 +340,40 @@ export const NotificationView: React.FC<Props> = props => {
         )
       }
 
+      if (id.startsWith('ironwoodMigration-')) {
+        const walletId = id.slice('ironwoodMigration-'.length)
+        const wallet = wallets[walletId]
+        if (wallet == null) return null
+
+        const handleCloseMigration = async (): Promise<void> => {
+          await writeAccountNotifInfo(account, id, { isBannerHidden: true })
+        }
+        const handlePressMigration = async (): Promise<void> => {
+          navigationDebounced.navigate('zcashMigrationOptions' as any, {
+            walletId
+          })
+        }
+
+        return (
+          <NotificationCard
+            key={id}
+            type="warning"
+            title={lstrings.zcash_migration_notif_title}
+            message={sprintf(
+              lstrings.zcash_migration_notif_body_1s,
+              getWalletName(wallet)
+            )}
+            onPress={handlePressMigration}
+            onDismiss={handleCloseMigration}
+            isPriority={isPriority}
+          />
+        )
+      }
+
       return null
     },
     [
+      account,
       dispatch,
       detectedTokensRedux,
       handle2FaEnabledClose,

src/components/scenes/NotificationCenterScene.tsx

@@ -15,6 +15,7 @@ import { config } from '../../theme/appConfig'
 import { useDispatch, useSelector } from '../../types/reactRedux'
 import type { EdgeAppSceneProps, NavigationBase } from '../../types/routerTypes'
 import { getThemedIconUri } from '../../util/CdnUris.ts'
+import { getWalletName } from '../../util/CurrencyWalletHelpers'
 import { showOtpReminderModal } from '../../util/otpReminder.tsx'
 import { openBrowserUri } from '../../util/WebUtils.ts'
 import { SceneWrapper } from '../common/SceneWrapper'
@@ -242,6 +243,31 @@ export const NotificationCenterScene = (props: Props) => {
                 onClose={completeNotif(key)}
               />
             )
+          } else if (key.includes('ironwoodMigration')) {
+            const { params } = notifState[key]
+            if (params == null) return null
+            const { walletId } = params
+            if (walletId == null || wallets[walletId] == null) return null
+            const wallet = wallets[walletId]
+
+            const handlePressMigration = async () => {
+              navigation.navigate('zcashMigrationOptions' as any, { walletId })
+            }
+
+            return (
+              <NotificationCenterRow
+                key={key}
+                date={date}
+                type="warning"
+                title={lstrings.zcash_migration_notif_title}
+                message={sprintf(
+                  lstrings.zcash_migration_notif_body_1s,
+                  getWalletName(wallet)
+                )}
+                onPress={handlePressMigration}
+                onClose={completeNotif(key)}
+              />
+            )
           } else if (key.includes('promoCard-')) {
             // Handle promo card notifications
             const { promoCard } = notifState[key].params ?? {}

src/components/services/Services.tsx

@@ -44,6 +44,7 @@ import { SortedWalletList } from './SortedWalletList'
 import { WalletConnectService } from './WalletConnectService'
 import { WalletLifecycle } from './WalletLifecycle'
 import { WipeLogsService } from './WipeLogsService'
+import { ZcashMigrationService } from './ZcashMigrationService'
 
 interface Props {
   navigation: NavigationBase
@@ -160,6 +161,7 @@ export const Services: React.FC<Props> = props => {
     <>
       {ENV.BETA_FEATURES ? <ActionQueueService /> : null}
       {account == null ? null : <NotificationService account={account} />}
+      {account == null ? null : <ZcashMigrationService account={account} />}
       <AutoLogout />
       <ContactsLoader />
       {account == null ? null : (

src/components/services/ZcashMigrationService.tsx

@@ -0,0 +1,57 @@
+import type { EdgeAccount } from 'edge-core-js'
+import * as React from 'react'
+
+import { useWatch } from '../../hooks/useWatch'
+import { getZcashMigrationStatus } from '../../util/zcashMigration'
+import { updateNotificationInfo } from './NotificationService'
+
+interface Props {
+  account: EdgeAccount
+}
+
+const POLL_DELAY_MS = 60000
+
+/**
+ * Watches Zcash wallets for the Orchard -> Ironwood migration condition and
+ * arms the per-wallet notification-center card (`ironwoodMigration-<id>`).
+ * The condition mechanism in updateNotificationInfo re-activates the card
+ * automatically if new Orchard funds arrive after a completed migration.
+ */
+export const ZcashMigrationService: React.FC<Props> = props => {
+  const { account } = props
+  const currencyWallets = useWatch(account, 'currencyWallets')
+
+  React.useEffect(() => {
+    let stopped = false
+
+    const check = async (): Promise<void> => {
+      for (const walletId of Object.keys(currencyWallets)) {
+        const wallet = currencyWallets[walletId]
+        if (wallet.currencyInfo.pluginId !== 'zcash') continue
+        const status = await getZcashMigrationStatus(wallet)
+        if (stopped || status == null) continue
+        const isActive = status.state === 'required' || status.state === 'error'
+        // 'scheduled' is deliberately not a notification: progress lives on
+        // the wallet scene banner; the center card is the call to action.
+        await updateNotificationInfo(
+          account,
+          `ironwoodMigration-${walletId}`,
+          isActive,
+          { walletId }
+        ).catch(() => {})
+      }
+    }
+
+    const timerId = setInterval(() => {
+      check().catch(() => {})
+    }, POLL_DELAY_MS)
+    check().catch(() => {})
+
+    return () => {
+      stopped = true
+      clearInterval(timerId)
+    }
+  }, [account, currencyWallets])
+
+  return null
+}

src/components/themed/TransactionListTop.tsx

@@ -24,6 +24,7 @@ import { useAsyncValue } from '../../hooks/useAsyncValue'
 import { useHandler } from '../../hooks/useHandler'
 import { useWalletName } from '../../hooks/useWalletName'
 import { useWatch } from '../../hooks/useWatch'
+import { useZcashMigrationStatus } from '../../hooks/useZcashMigrationStatus'
 import { formatNumber, toPercentString } from '../../locales/intl'
 import { lstrings } from '../../locales/strings'
 import { getStakePlugins } from '../../plugins/stake-plugins/stakePlugins'
@@ -106,6 +107,7 @@ interface Props {
 export const TransactionListTop: React.FC<Props> = props => {
   const { isEmpty, searching, tokenId, wallet } = props
   const navigation = useAsyncNavigation(props.navigation)
+  const migrationStatus = useZcashMigrationStatus(wallet)
 
   const dispatch = useDispatch()
   const account = useSelector(state => state.core.account)
@@ -665,6 +667,47 @@ export const TransactionListTop: React.FC<Props> = props => {
     )
   }
 
+  /**
+   * Orchard -> Ironwood migration banner (Zcash only; dormant until the
+   * engine reports the wallet needs, is running, or erred on the migration).
+   */
+  function renderZcashMigrationCard(): React.ReactElement | null {
+    if (tokenId != null || migrationStatus == null) return null
+    const { state, completedTransfers, totalTransfers } = migrationStatus
+    if (state !== 'required' && state !== 'scheduled' && state !== 'error')
+      return null
+
+    const body =
+      state === 'required'
+        ? lstrings.zcash_migration_required_body
+        : state === 'error'
+        ? lstrings.zcash_migration_error_body
+        : sprintf(
+            lstrings.zcash_migration_scheduled_body_2s,
+            completedTransfers,
+            totalTransfers
+          )
+    return (
+      <AlertCardUi4
+        body={body}
+        marginRem={[0.5, 0.5, 0, 0.5]}
+        title={lstrings.zcash_migration_required_title}
+        type={state === 'error' ? 'error' : 'warning'}
+        button={{
+          label:
+            state === 'required'
+              ? lstrings.zcash_migration_title
+              : lstrings.zcash_migration_view_progress,
+          onPress: () => {
+            navigation.navigate('zcashMigrationOptions' as any, {
+              walletId: wallet.id
+            })
+          }
+        }}
+      />
+    )
+  }
+
   function renderButtons(): React.ReactElement {
     const styles = getStyles(theme)
     const hideStaking = !isStakingAvailable
@@ -795,6 +838,7 @@ export const TransactionListTop: React.FC<Props> = props => {
             {!isStakingAvailable ? null : renderStakedBalance()}
           </EdgeCard>
           {renderSyncStatus()}
+          {renderZcashMigrationCard()}
           {renderButtons()}
         </>
       )}