ethagent 1.1.1 → 2.0.0

package/src/identity/hub/flows/ens/EnsEditReviewScreens.tsx

@@ -0,0 +1,471 @@
+import React from 'react'
+import { Box, Text } from 'ink'
+import { getAddress, type Address } from 'viem'
+import { Surface } from '../../../../ui/Surface.js'
+import { Select, type SelectOption } from '../../../../ui/Select.js'
+import { theme } from '../../../../ui/theme.js'
+import {
+  formatRecordValue,
+  recordLabel,
+  type AgentEnsRecords,
+  type AgentRecordDiff,
+} from '../../../ens/agentRecords.js'
+import type { EnsValidation } from '../../../ens/ensLookup.js'
+import type {
+  EnsSetupBlockedPlan,
+  EnsSetupPlan,
+} from '../../../ens/ensAutomation.js'
+import { createErc8004PublicClient, type Erc8004RegistryConfig } from '../../../registry/erc8004.js'
+import {
+  displayCustodyMode,
+  type CustodyMode,
+} from '../../model/custody.js'
+import { ensValidationReasonText } from '../../model/ens.js'
+import { shortAddress } from '../../model/format.js'
+import {
+  manualReasonTitle,
+  modeSwitchHeading,
+  setupSwitchNotice,
+} from './ensEditCopy.js'
+import {
+  EnsSetupRow,
+  footerHint,
+  renderRecordValue,
+} from './EnsEditShared.js'
+import type { EnsIssueValidation } from './ensEditTypes.js'
+
+type SimpleEnsIssueScreenProps = {
+  fullName: string
+  validation: EnsIssueValidation
+  onCreate: () => void
+  onCheckAgain: () => void
+  onChange: () => void
+  onBack: () => void
+}
+
+export const SimpleEnsIssueScreen: React.FC<SimpleEnsIssueScreenProps> = ({
+  fullName,
+  validation,
+  onCreate,
+  onCheckAgain,
+  onChange,
+  onBack,
+}) => {
+  type Action = 'create' | 'check-again' | 'change' | 'back'
+  const reason = ensValidationReasonText(validation.reason)
+  const showDetail = validation.detail && validation.detail !== reason
+  return (
+    <Surface
+      title="ENS Name Not Found"
+      footer={footerHint('enter select · esc back')}
+    >
+      <Box flexDirection="column">
+        <Text color={theme.dim}>The subdomain is not on Ethereum Mainnet yet. You can create it from here.</Text>
+        <Text>
+          <Text color={theme.dim}>{'Name'.padEnd(12)}</Text>
+          <Text color={theme.text} bold>{fullName}</Text>
+        </Text>
+        <Text>
+          <Text color={theme.dim}>{'Reason'.padEnd(12)}</Text>
+          <Text color={theme.accentError}>{reason}</Text>
+        </Text>
+        {showDetail ? <Text color={theme.dim}>{validation.detail}</Text> : null}
+      </Box>
+      <Box marginTop={1}>
+        <Select<Action>
+          options={[
+            { value: 'create', role: 'section', label: 'Create Subdomain' },
+            { value: 'create', label: 'Create This ENS Name', hint: 'Connected wallet creates it and sets the required records' },
+            { value: 'change', label: 'Pick A Different Name', hint: 'Return to subdomain entry with this name still filled in' },
+            { value: 'back', role: 'section', label: 'Navigation' },
+            { value: 'back', label: 'Back', hint: 'Return to subdomain entry', role: 'utility' },
+          ]}
+          hintLayout="inline"
+          onSubmit={choice => {
+            if (choice === 'create') return onCreate()
+            if (choice === 'check-again') return onCheckAgain()
+            if (choice === 'change') return onChange()
+            return onBack()
+          }}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}
+
+type EnsSetupReviewScreenProps = {
+  setup: EnsSetupPlan
+  currentEnsName: string
+  currentMode: CustodyMode | undefined
+  registry: Erc8004RegistryConfig
+  onBegin: () => void
+  onBack: () => void
+}
+
+export const EnsSetupReviewScreen: React.FC<EnsSetupReviewScreenProps> = ({
+  setup,
+  currentEnsName,
+  currentMode,
+  registry,
+  onBegin,
+  onBack,
+}) => {
+  type Action = 'begin' | 'back'
+  const isSimple = setup.mode === 'simple'
+  const [ownerIsSmartAccount, setOwnerIsSmartAccount] = React.useState(false)
+  React.useEffect(() => {
+    if (isSimple) return
+    let cancelled = false
+    const client = createErc8004PublicClient(registry)
+    client.getBytecode({ address: getAddress(setup.ownerAddress) })
+      .then(code => {
+        if (cancelled) return
+        if (code && code !== '0x') setOwnerIsSmartAccount(true)
+      })
+      .catch(() => {})
+    return () => { cancelled = true }
+  }, [isSimple, registry, setup.ownerAddress])
+  const signerLabel = isSimple ? 'Connected wallet' : 'Owner wallet'
+  const switchNotice = setupSwitchNotice(currentEnsName, currentMode, setup.fullName, setup.mode)
+  const createLabel = setup.registryAction === 'create-subdomain'
+    ? 'Create Subdomain'
+    : setup.registryAction === 'create-wrapped-subdomain'
+      ? 'Create Wrapped Subdomain'
+    : setup.registryAction === 'set-resolver'
+      ? 'Set Resolver'
+      : setup.registryAction === 'set-wrapped-resolver'
+        ? 'Set Wrapped Resolver'
+        : 'Subdomain Ready'
+  const beginHint = setup.registryAction === 'none'
+    ? 'Ethereum Mainnet: subdomain already ready'
+    : 'Ethereum Mainnet: create or prepare subdomain'
+  const reusingExistingSubdomain = setup.registryAction === 'none'
+  return (
+    <Surface
+      title={isSimple ? 'Create Simple ENS Name' : 'Create ENS Name'}
+      footer={footerHint('enter select · esc back')}
+    >
+      {reusingExistingSubdomain ? (
+        <Box marginBottom={1}>
+          <Text color={theme.accentPeriwinkle}>Subdomain detected from a prior attempt, reusing.</Text>
+        </Box>
+      ) : null}
+      <Box flexDirection="column">
+        <Text color={theme.dim}>{modeSwitchHeading(currentEnsName, currentMode, setup.fullName, setup.mode)}</Text>
+        {switchNotice ? <Text color={theme.dim}>{switchNotice}</Text> : null}
+        <EnsSetupRow label="ENS name" value={setup.fullName} />
+        <EnsSetupRow label="Parent root" value={setup.rootName} />
+        <EnsSetupRow label="Subdomain label" value={setup.label} />
+        <EnsSetupRow label="ENS network" value="Ethereum Mainnet" />
+        <EnsSetupRow label="Signer wallet" value={`${shortAddress(setup.ownerAddress)} (${signerLabel.toLowerCase()})`} />
+        <EnsSetupRow label="Registry action" value={createLabel} />
+        {ownerIsSmartAccount ? (
+          <Box marginTop={1}>
+            <Text color={theme.accentError}>Owner wallet appears to be a smart account. Resolver delegation may require special handling depending on your wallet provider; if the operator wallet later cannot write ENS records, run "Fix Records" to retry.</Text>
+          </Box>
+        ) : null}
+      </Box>
+      <Box marginTop={1}>
+        <Select<Action>
+          options={[
+            { value: 'begin', role: 'section', label: 'Subdomain' },
+            { value: 'begin', label: 'Continue Setup', hint: beginHint },
+            { value: 'back', role: 'section', label: 'Navigation' },
+            { value: 'back', label: 'Back', hint: isSimple ? 'Return to subdomain entry' : 'Return to operator wallet', role: 'utility' },
+          ]}
+          hintLayout="inline"
+          onSubmit={choice => {
+            if (choice === 'begin') return onBegin()
+            return onBack()
+          }}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}
+
+type EnsSetupBlockedScreenProps = {
+  fallback: EnsSetupBlockedPlan
+  onCheckAgain: () => void
+  onBack: () => void
+}
+
+export const EnsSetupBlockedScreen: React.FC<EnsSetupBlockedScreenProps> = ({
+  fallback,
+  onCheckAgain,
+  onBack,
+}) => {
+  type Action = 'check' | 'back'
+  const isSimple = fallback.mode === 'simple'
+  return (
+    <Surface
+      title="ENS Setup Blocked"
+      footer={footerHint('enter select · esc back')}
+    >
+      <Box flexDirection="column">
+        <Text color={theme.accentError}>{manualReasonTitle(fallback.reason)}</Text>
+        <Text color={theme.dim}>{fallback.detail}</Text>
+        <Box marginTop={1} flexDirection="column">
+          <EnsSetupRow label="Agent ENS" value={fallback.fullName} />
+          {isSimple
+            ? <EnsSetupRow label="Wallet" value={fallback.ownerAddress ? shortAddress(fallback.ownerAddress) : shortAddress(fallback.operatorAddress)} />
+            : (fallback.ownerAddress ? <EnsSetupRow label="Owner wallet" value={shortAddress(fallback.ownerAddress)} /> : null)}
+          {fallback.nextRecords?.token ? <EnsSetupRow label="Token link" value={fallback.nextRecords.token} /> : null}
+          <EnsSetupRow label="Address" value={`Set the subdomain address record to the ${isSimple ? 'connected wallet' : 'owner wallet'}.`} />
+          {!isSimple
+            ? (
+              <>
+                <Box marginTop={1} flexDirection="column">
+                  <Text color={theme.text}>To proceed: the owner wallet signs ENS records and must hold this token at setup time. Once setup is done you can deposit the token into the operator delegation vault while the ENS subdomain stays with the owner wallet.</Text>
+                </Box>
+                <Text color={theme.dim}>Operator wallets have no authority on this name; they only rotate the onchain ERC-8004 URI via the operator delegation vault.</Text>
+              </>
+              )
+            : null}
+        </Box>
+      </Box>
+      <Box marginTop={1}>
+        <Select<Action>
+          options={[
+            { value: 'check', role: 'section', label: 'Automation' },
+            { value: 'check', label: 'Check Again', hint: isSimple ? 'Re-run the simple ENS automation check' : 'Re-read ENS after the token is back with the owner wallet' },
+            { value: 'back', role: 'section', label: 'Navigation' },
+            { value: 'back', label: 'Back', hint: isSimple ? 'Return to subdomain entry' : 'Return to the previous setup step', role: 'utility' },
+          ]}
+          hintLayout="inline"
+          onSubmit={choice => {
+            if (choice === 'check') return onCheckAgain()
+            return onBack()
+          }}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}
+
+type UnlinkEnsReviewScreenProps = {
+  fullName: string
+  currentMode: CustodyMode | undefined
+  registryNetworkLabel: string
+  recordsDiff: AgentRecordDiff[]
+  onUnlink: () => void
+  onBack: () => void
+}
+
+export const UnlinkEnsReviewScreen: React.FC<UnlinkEnsReviewScreenProps> = ({
+  fullName,
+  currentMode,
+  registryNetworkLabel,
+  recordsDiff,
+  onUnlink,
+  onBack,
+}) => {
+  type Action = 'unlink' | 'back'
+  const changedDiffs = recordsDiff.filter(diff => diff.current.trim())
+  const recordsAlreadyEmpty = changedDiffs.length === 0
+  return (
+    <Surface
+      title="Unlink ENS"
+      footer={footerHint('enter select · esc back')}
+    >
+      <Box flexDirection="column">
+        <EnsSetupRow label="ENS name" value={fullName} />
+        <EnsSetupRow label="Custody" value={displayCustodyMode(currentMode)} />
+        <Text color={theme.dim}>
+          Records on Ethereum Mainnet, then token URI on {registryNetworkLabel}.
+        </Text>
+        {recordsAlreadyEmpty ? (
+          <Box marginTop={1}>
+            <Text color={theme.dim}>
+              All ethagent ENS records are already empty. Unlink removes only the token URI link.
+            </Text>
+          </Box>
+        ) : (
+          <Box marginTop={1} flexDirection="column">
+            <Text color={theme.textSubtle}>Will be cleared:</Text>
+            {changedDiffs.map(diff => (
+              <Text key={diff.key}>
+                <Text color={theme.dim}>{`  ${diff.key}  `}</Text>
+                <Text color={theme.accentPeriwinkle}>{formatRecordValue(diff.field, diff.current)}</Text>
+              </Text>
+            ))}
+          </Box>
+        )}
+      </Box>
+      <Box marginTop={1}>
+        <Select<Action>
+          options={[
+            { value: 'unlink', role: 'section', label: 'Unlink' },
+            {
+              value: 'unlink',
+              label: 'Unlink ENS',
+              hint: recordsAlreadyEmpty
+                ? 'Skip the records transaction and remove only the token URI link'
+                : 'Clear ethagent-owned records, then remove the token URI link',
+            },
+            { value: 'back', role: 'section', label: 'Navigation' },
+            { value: 'back', label: 'Back', hint: 'Return to ENS setup', role: 'utility' },
+          ]}
+          hintLayout="inline"
+          onSubmit={choice => {
+            if (choice === 'unlink') return onUnlink()
+            return onBack()
+          }}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}
+
+type ReviewScreenProps = {
+  fullName: string
+  ownerAddress: Address
+  validation: EnsValidation
+  recordsDiff: AgentRecordDiff[]
+  nextRecords: AgentEnsRecords
+  currentEnsName: string
+  currentMode: CustodyMode | undefined
+  registryNetworkLabel: string
+  mode: 'simple' | 'advanced'
+  onContinue: () => void
+  onCheckAgain: () => void
+  onChange: () => void
+  onCreate?: () => void
+  onBack: () => void
+}
+
+export const ReviewScreen: React.FC<ReviewScreenProps> = ({
+  fullName,
+  ownerAddress,
+  validation,
+  recordsDiff,
+  nextRecords,
+  currentEnsName,
+  currentMode,
+  registryNetworkLabel,
+  mode,
+  onContinue,
+  onCheckAgain,
+  onChange,
+  onCreate,
+  onBack,
+}) => {
+  void ownerAddress
+  void nextRecords
+  type ReviewAction = 'continue' | 'create' | 'check-again' | 'change' | 'back'
+  const changedDiffs = recordsDiff.filter(d => d.changed)
+  const hasRecordChanges = changedDiffs.length > 0
+  const reviewSubtitle = 'Review Ethereum Mainnet ENS address and text records before saving this ENS link. No token approval is requested.'
+  const switchNotice = setupSwitchNotice(currentEnsName, currentMode, fullName, mode)
+
+  if (!validation.ok) {
+    const reason = ensValidationReasonText(validation.reason)
+    const showDetail = validation.detail && validation.detail !== reason
+    return (
+      <Surface
+        title="ENS Issue"
+        subtitle={`${fullName} could not be verified on Ethereum mainnet.`}
+        footer={footerHint('enter select · esc back')}
+      >
+        <Box flexDirection="column">
+          <Text>
+            <Text color={theme.dim}>{'Name'.padEnd(12)}</Text>
+            <Text color={theme.text} bold>{fullName}</Text>
+          </Text>
+          <Text>
+            <Text color={theme.dim}>{'Reason'.padEnd(12)}</Text>
+            <Text color={theme.accentError}>{reason}</Text>
+          </Text>
+          {showDetail
+            ? <Text color={theme.dim}>{validation.detail}</Text>
+            : null}
+        </Box>
+        <Box marginTop={1}>
+          <Select<ReviewAction>
+            options={[
+              ...(onCreate
+                ? [
+                    { value: 'create' as ReviewAction, role: 'section' as const, label: 'Create Subdomain' },
+                    { value: 'create' as ReviewAction, label: 'Create This ENS Name', hint: 'Use ethagent to create it and set the required records' },
+                  ]
+                : []),
+              { value: 'check-again', label: 'Check Again', hint: 'Re-verify on Ethereum mainnet' },
+              { value: 'change', label: 'Pick A Different Name', hint: 'Return to the name picker' },
+              { value: 'back', role: 'section', label: 'Navigation' },
+              { value: 'back', label: 'Back', hint: 'Return to subdomain entry', role: 'utility' },
+            ]}
+            hintLayout="inline"
+            onSubmit={choice => {
+              if (choice === 'create' && onCreate) return onCreate()
+              if (choice === 'check-again') return onCheckAgain()
+              if (choice === 'change') return onChange()
+              return onBack()
+            }}
+            onCancel={onBack}
+          />
+        </Box>
+      </Surface>
+    )
+  }
+
+  const options: Array<SelectOption<ReviewAction>> = [
+    { value: 'continue', role: 'section', label: modeSwitchHeading(currentEnsName, currentMode, fullName, mode) },
+    { value: 'continue', label: 'Continue Setup', hint: hasRecordChanges ? `Ethereum Mainnet: sign ${changedDiffs.length} ENS record value${changedDiffs.length === 1 ? '' : 's'}; ${registryNetworkLabel}: save token URI` : `ENS records already match; ${registryNetworkLabel}: save token URI` },
+    { value: 'change', label: 'Pick A Different Name', hint: 'Return to the name picker' },
+    { value: 'back', role: 'section', label: 'Navigation' },
+    { value: 'back', label: 'Back', hint: 'Return to Identity Hub', role: 'utility' },
+  ]
+
+  return (
+    <Surface
+      title={`Update ENS records for ${fullName}?`}
+      subtitle={reviewSubtitle}
+      footer={footerHint('enter select · esc back')}
+    >
+      <Box flexDirection="column">
+        {currentEnsName || currentMode
+          ? (
+            <Box marginBottom={1} flexDirection="column">
+              <Text color={theme.dim}>Current: <Text color={currentEnsName ? theme.text : theme.dim}>{currentEnsName || 'None'}</Text></Text>
+              <Text color={theme.dim}>Next: <Text color={theme.text}>{fullName}</Text></Text>
+              {switchNotice ? <Text color={theme.dim}>{switchNotice}</Text> : null}
+            </Box>
+            )
+          : null}
+        {recordsDiff.map(diff => (
+          <Text key={diff.key}>
+            <Text color={theme.dim}>{`- ${recordLabel(diff.field)}: `}</Text>
+            {diff.changed
+              ? (
+                <>
+                  {renderRecordValue(diff.field, diff.current)}
+                  <Text color={theme.dim}>{' → '}</Text>
+                  {renderRecordValue(diff.field, diff.next)}
+                </>
+              )
+              : renderRecordValue(diff.field, diff.next)}
+          </Text>
+        ))}
+        {!hasRecordChanges
+          ? <Box marginTop={1}><Text color={theme.dim}>All ENS records already match. Link this ENS name to the token URI.</Text></Box>
+          : null}
+      </Box>
+      <Box marginTop={1}>
+        <Select<ReviewAction>
+          options={options}
+          hintLayout="inline"
+          onSubmit={choice => {
+            if (choice === 'continue') return onContinue()
+            if (choice === 'change') return onChange()
+            return onBack()
+          }}
+          onCancel={onBack}
+        />
+      </Box>
+    </Surface>
+  )
+}

package/src/identity/hub/flows/ens/EnsEditRunners.tsx

@@ -0,0 +1,198 @@
+import React from 'react'
+import { Box, Text } from 'ink'
+import type { Address } from 'viem'
+import { mainnet } from 'viem/chains'
+import { Surface } from '../../../../ui/Surface.js'
+import { useAppInput } from '../../../../app/input/AppInputProvider.js'
+import {
+  createMainnetClient,
+} from '../../../ens/ensLookup.js'
+import {
+  buildCommitment,
+  encodeCommitTransaction,
+  encodeRegisterTransaction,
+  MIN_COMMIT_AGE_SECONDS,
+  ONE_YEAR_SECONDS,
+} from '../../../ens/ensRegistration.js'
+import type { EnsSubdomainDeletePlan } from '../../../ens/ensAutomation.js'
+import {
+  sendBrowserWalletTransaction,
+  type BrowserWalletReady,
+} from '../../../wallet/browserWallet.js'
+import { WalletApprovalScreen } from '../../components/WalletApprovalScreen.js'
+import { footerHint } from './EnsEditShared.js'
+import type { RegisterCommitPhase } from './ensEditTypes.js'
+import { theme } from '../../../../ui/theme.js'
+
+export const EscCancel: React.FC<{ onCancel: () => void }> = ({ onCancel }) => {
+  useAppInput((_input, key) => {
+    if (key.escape) onCancel()
+  })
+  return null
+}
+
+export const RegisterRootCommitRunner: React.FC<{
+  phase: RegisterCommitPhase
+  ownerAddress: Address
+  walletSession: BrowserWalletReady | null
+  onWalletReady: (session: BrowserWalletReady | null) => void
+  onCommitted: () => void
+  onError: (msg: string) => void
+}> = ({ phase, ownerAddress, walletSession, onWalletReady, onCommitted, onError }) => {
+  const startedRef = React.useRef(false)
+  React.useEffect(() => {
+    if (startedRef.current) return
+    startedRef.current = true
+    const built = buildCommitment({ label: phase.label, owner: ownerAddress, durationSeconds: BigInt(ONE_YEAR_SECONDS), secret: phase.secret })
+    const tx = encodeCommitTransaction(built.commitment)
+    sendBrowserWalletTransaction({
+      chainId: mainnet.id,
+      expectedAccount: ownerAddress,
+      to: tx.to,
+      data: tx.data,
+      purpose: 'register-root-commit',
+      onReady: ready => onWalletReady(ready),
+    })
+      .then(async result => {
+        onWalletReady(null)
+        const client = createMainnetClient()
+        await client.waitForTransactionReceipt({ hash: result.txHash })
+        onCommitted()
+      })
+      .catch((err: unknown) => {
+        onWalletReady(null)
+        onError(err instanceof Error ? err.message : String(err))
+      })
+  }, [])
+  return (
+    <WalletApprovalScreen
+      title="Commit ENS Name"
+      subtitle={`Submitting the first of two transactions for ${phase.label}.eth on Ethereum mainnet. Wait for confirmation.`}
+      walletSession={walletSession}
+      label="waiting for connected wallet transaction..."
+      onCancel={() => onError('Commit cancelled. Restart from the name input.')}
+    />
+  )
+}
+
+export const RegisterRootWaitScreen: React.FC<{
+  phase: RegisterCommitPhase & { commitMinedAt: number }
+  onReady: () => void
+  onCancel: () => void
+}> = ({ phase, onReady, onCancel }) => {
+  const [, setTick] = React.useState(0)
+  React.useEffect(() => {
+    const interval = setInterval(() => setTick(t => t + 1), 500)
+    return () => clearInterval(interval)
+  }, [])
+  const elapsedSec = Math.floor((Date.now() - phase.commitMinedAt) / 1000)
+  const remaining = Math.max(0, MIN_COMMIT_AGE_SECONDS + 1 - elapsedSec)
+  React.useEffect(() => {
+    if (remaining === 0) onReady()
+  }, [remaining])
+  return (
+    <Surface
+      title="Commit Confirmed, Waiting"
+      subtitle={`Anti-frontrun delay before registering ${phase.label}.eth. ENS requires a 60-second wait between commit and register.`}
+      footer={footerHint('esc cancel registration')}
+    >
+      <Box marginTop={1} flexDirection="column">
+        <Text color={theme.text}>{remaining > 0 ? `${remaining} seconds remaining...` : 'Ready, advancing to the registration transaction...'}</Text>
+        <Text color={theme.dim}>Keep this window open. The commit expires after 24 hours if you walk away.</Text>
+      </Box>
+      <EscCancel onCancel={onCancel} />
+    </Surface>
+  )
+}
+
+export const DeleteSubdomainTxRunner: React.FC<{
+  plan: EnsSubdomainDeletePlan
+  ownerAddress: Address
+  walletSession: BrowserWalletReady | null
+  onWalletReady: (session: BrowserWalletReady | null) => void
+  onDeleted: () => void
+  onError: (msg: string) => void
+}> = ({ plan, ownerAddress, walletSession, onWalletReady, onDeleted, onError }) => {
+  const startedRef = React.useRef(false)
+  React.useEffect(() => {
+    if (startedRef.current) return
+    startedRef.current = true
+    sendBrowserWalletTransaction({
+      chainId: mainnet.id,
+      expectedAccount: ownerAddress,
+      to: plan.transaction.to,
+      data: plan.transaction.data,
+      purpose: 'delete-ens-subdomain',
+      onReady: ready => onWalletReady(ready),
+    })
+      .then(async result => {
+        onWalletReady(null)
+        const client = createMainnetClient()
+        await client.waitForTransactionReceipt({ hash: result.txHash })
+        onDeleted()
+      })
+      .catch((err: unknown) => {
+        onWalletReady(null)
+        onError(err instanceof Error ? err.message : String(err))
+      })
+  }, [])
+  return (
+    <WalletApprovalScreen
+      title="Delete ENS Subdomain"
+      subtitle={`Clearing the subnode for ${plan.fullName} at ${plan.parentName} on Ethereum mainnet.`}
+      walletSession={walletSession}
+      label="waiting for owner wallet transaction..."
+      onCancel={() => onError('Subdomain deletion cancelled.')}
+    />
+  )
+}
+
+export const RegisterRootTxRunner: React.FC<{
+  phase: RegisterCommitPhase
+  ownerAddress: Address
+  walletSession: BrowserWalletReady | null
+  onWalletReady: (session: BrowserWalletReady | null) => void
+  onRegistered: () => void
+  onError: (msg: string) => void
+}> = ({ phase, ownerAddress, walletSession, onWalletReady, onRegistered, onError }) => {
+  const startedRef = React.useRef(false)
+  React.useEffect(() => {
+    if (startedRef.current) return
+    startedRef.current = true
+    const tx = encodeRegisterTransaction({
+      label: phase.label,
+      owner: ownerAddress,
+      durationSeconds: BigInt(ONE_YEAR_SECONDS),
+      secret: phase.secret,
+      rentPrice: phase.price,
+    })
+    sendBrowserWalletTransaction({
+      chainId: mainnet.id,
+      expectedAccount: ownerAddress,
+      to: tx.to,
+      data: tx.data,
+      value: tx.value,
+      purpose: 'register-root-tx',
+      onReady: ready => onWalletReady(ready),
+    })
+      .then(async result => {
+        onWalletReady(null)
+        const client = createMainnetClient()
+        await client.waitForTransactionReceipt({ hash: result.txHash })
+        onRegistered()
+      })
+      .catch((err: unknown) => {
+        onWalletReady(null)
+        onError(err instanceof Error ? err.message : String(err))
+      })
+  }, [])
+  return (
+    <WalletApprovalScreen
+      title="Register ENS Name"
+      subtitle={`Paying 1 year of rent and registering ${phase.label}.eth on Ethereum mainnet.`}
+      walletSession={walletSession}
+      label="waiting for connected wallet transaction..."
+      onCancel={() => onError('Registration cancelled. The commit will expire in 24 hours; restart from the name input to retry.')}
+    />
+  )
+}