emergency-withdraw: human-readable vUSDCx amounts + plainer copy

vUSDCx amounts were shown and entered as raw 1e12-scaled integers
(e.g. "3000000000000"). They now display in human units ("3") and the
Withdraw field accepts a plain decimal, converted internally — with a
balance hint and percent shortcuts adjusted to match.

The Withdraw and CommunitySunset descriptions are rewritten in plain
depositor language; the validator-level detail moves into a collapsible
"Technical details" section. EN / 繁體中文 / 日本語 all updated.

Author: optivaults-fi

emergency-withdraw/src/App.tsx

@@ -55,6 +55,40 @@ function fmtMicro(n: bigint, dec: bigint = DECIMALS): string {
   return (neg ? '-' : '') + Number(head).toLocaleString() + '.' + tail
 }
 
+/** vUSDCx is stored at 1e12 raw per display unit (≈ 1 USDCx of value). */
+const SHARE_SCALE = 1_000_000_000_000n
+
+/** Format a raw vUSDCx amount as a human-readable string (up to 6 dp). */
+function fmtShares(n: bigint): string {
+  const neg = n < 0n
+  const abs = neg ? -n : n
+  const whole = abs / SHARE_SCALE
+  const frac = ((abs % SHARE_SCALE) / 1_000_000n).toString().padStart(6, '0').replace(/0+$/, '')
+  return (neg ? '-' : '') + Number(whole).toLocaleString() + (frac ? '.' + frac : '')
+}
+
+/** Raw vUSDCx → plain comma-free decimal string, for the input field. */
+function rawSharesToInput(n: bigint): string {
+  if (n <= 0n) return ''
+  const whole = n / SHARE_SCALE
+  const frac = (n % SHARE_SCALE).toString().padStart(12, '0').replace(/0+$/, '')
+  return whole.toString() + (frac ? '.' + frac : '')
+}
+
+/** Parse a human vUSDCx input string → raw bigint. Returns -1n on invalid. */
+function parseShares(input: string): bigint {
+  const s = input.trim()
+  if (!s) return 0n
+  if (!/^\d*\.?\d*$/.test(s) || s === '.') return -1n
+  const [whole, frac = ''] = s.split('.')
+  if (frac.length > 12) return -1n
+  try {
+    return BigInt(whole || '0') * SHARE_SCALE + BigInt((frac + '000000000000').slice(0, 12))
+  } catch {
+    return -1n
+  }
+}
+
 function fmtTime(ms: bigint, never: string): string {
   if (ms <= 0n) return never
   return new Date(Number(ms)).toISOString().replace('T', ' ').slice(0, 19) + ' UTC'
@@ -433,14 +467,7 @@ export default function App() {
   }
 
   // ── Withdraw ──
-  const sharesParsed = (() => {
-    if (!sharesInput.trim()) return 0n
-    try {
-      return BigInt(sharesInput.trim())
-    } catch {
-      return -1n
-    }
-  })()
+  const sharesParsed = parseShares(sharesInput)
   const sharesValid = sharesParsed > 0n && sharesParsed <= userShares
   const quote = (() => {
     if (!vault || !sharesValid) return null
@@ -456,12 +483,12 @@ export default function App() {
     const cap = vault.totalShares - 1n
     const base = userShares > cap ? cap : userShares
     const v = pct >= 100 ? base : (base * BigInt(pct)) / 100n
-    setSharesInput(v.toString())
+    setSharesInput(rawSharesToInput(v))
   }
 
   async function handleWithdraw() {
     if (!lucid || !config || !vault || !networkResolved || !sharesValid) return
-    if (!confirm(t('wd.confirmNative', { n: sharesParsed.toString() }))) return
+    if (!confirm(t('wd.confirmNative', { n: fmtShares(sharesParsed) }))) return
     setBusy(true)
     setTxHash('')
     setStatus({ kind: 'info', text: t('st.buildingWd') })
@@ -721,7 +748,7 @@ export default function App() {
                   <div className="text-xs uppercase tracking-wide text-slate-500">
                     {t('vault.yourShares')}
                   </div>
-                  <div className="font-mono text-lg sm:text-xl mt-0.5">{userShares.toString()}</div>
+                  <div className="font-mono text-lg sm:text-xl mt-0.5">{fmtShares(userShares)}</div>
                 </div>
                 <div className="text-right">
                   <div className="text-xs uppercase tracking-wide text-slate-500">
@@ -736,7 +763,7 @@ export default function App() {
             <DataPanel className="space-y-2.5">
               <InfoRow label={t('vault.version')} value={`V${vault.vaultVersion.toString()}`} />
               <InfoRow label={t('vault.totalDeposited')} value={fmtMicro(vault.totalDeposited)} />
-              <InfoRow label={t('vault.totalShares')} value={vault.totalShares.toString()} />
+              <InfoRow label={t('vault.totalShares')} value={fmtShares(vault.totalShares)} />
               <InfoRow label={t('vault.idleBuffer')} value={fmtMicro(vault.idleBuffer)} />
               <InfoRow label={t('vault.nonDeposit')} value={fmtMicro(vault.nonDepositValue)} />
               <InfoRow
@@ -787,18 +814,31 @@ export default function App() {
             iconPath={ICON.download}
             accent="emerald"
           >
-            <p className="text-xs sm:text-sm text-slate-400 leading-relaxed">{renderRich(t('wd.desc'))}</p>
+            <div className="space-y-2">
+              <p className="text-xs sm:text-sm text-slate-400 leading-relaxed">{t('wd.desc')}</p>
+              <details className="group">
+                <summary className="text-xs text-slate-500 cursor-pointer hover:text-slate-300 select-none">
+                  {t('wd.techToggle')}
+                </summary>
+                <p className="mt-2 text-xs text-slate-400 leading-relaxed">{renderRich(t('wd.techDetail'))}</p>
+              </details>
+            </div>
 
             <div className="space-y-2">
-              <label className="block text-xs uppercase tracking-wide text-slate-400">
-                {t('wd.sharesLabel')}
-              </label>
+              <div className="flex items-baseline justify-between gap-3">
+                <label className="text-xs uppercase tracking-wide text-slate-400">
+                  {t('wd.sharesLabel')}
+                </label>
+                <span className="text-xs text-slate-500">
+                  {t('wd.balanceHint', { bal: fmtShares(userShares) })}
+                </span>
+              </div>
               <input
                 type="text"
-                inputMode="numeric"
+                inputMode="decimal"
                 value={sharesInput}
                 onChange={(e) => setSharesInput(e.target.value)}
-                placeholder="0"
+                placeholder="0.0"
               />
               <div className="grid grid-cols-4 gap-1.5">
                 {[25, 50, 75, 100].map((pct) => (
@@ -814,7 +854,7 @@ export default function App() {
               {sharesParsed === -1n && <p className="text-xs text-red-400">{t('wd.invalid')}</p>}
               {sharesParsed > userShares && (
                 <p className="text-xs text-red-400">
-                  {t('wd.exceeds', { bal: userShares.toString() })}
+                  {t('wd.exceeds', { bal: fmtShares(userShares) })}
                 </p>
               )}
             </div>
@@ -871,9 +911,19 @@ export default function App() {
             accent={sunset.available || sunset.alreadyTriggered ? 'amber' : 'slate'}
             danger={sunset.available || sunset.alreadyTriggered}
           >
-            <p className="text-xs sm:text-sm text-slate-400 leading-relaxed">
-              {renderRich(t('sunset.desc'), 'text-amber-400')}
-            </p>
+            <div className="space-y-2">
+              <p className="text-xs sm:text-sm text-slate-400 leading-relaxed">
+                {renderRich(t('sunset.desc'), 'text-amber-400')}
+              </p>
+              <details className="group">
+                <summary className="text-xs text-slate-500 cursor-pointer hover:text-slate-300 select-none">
+                  {t('sunset.techToggle')}
+                </summary>
+                <p className="mt-2 text-xs text-slate-400 leading-relaxed">
+                  {renderRich(t('sunset.techDetail'), 'text-amber-400')}
+                </p>
+              </details>
+            </div>
 
             {/* Countdown headline */}
             {!sunset.alreadyTriggered && (
@@ -913,7 +963,7 @@ export default function App() {
               />
               <InfoRow
                 label={t('sunset.callerShares')}
-                value={userShares.toString()}
+                value={fmtShares(userShares)}
                 tone={userShares > 0n ? 'good' : 'bad'}
               />
             </DataPanel>

emergency-withdraw/src/i18n.tsx

@@ -103,10 +103,13 @@ const translations: Record<Lang, Translations> = {
     wd: {
       step: 'Step 2',
       title: 'Withdraw',
-      desc: 'Burns vUSDCx for a proportional share of vault USDCx via the V1 Withdraw-Zero path (proxy spend + `vault_user` staking withdrawal). The quote is `shares × TD ÷ TS` minus the early-withdraw fee — the fee is waived automatically once the keeper has been inactive 7+ days.',
-      sharesLabel: 'Shares to burn — raw vUSDCx',
+      desc: 'Burn your vUSDCx to receive a proportional share of USDCx from the vault. If the keeper has been inactive for 7+ days, the early-withdraw fee is waived automatically.',
+      techToggle: 'Technical details',
+      techDetail: 'V1 Withdraw-Zero path: proxy spend + `vault_user` staking withdrawal + vUSDCx burn. Quote = `shares × total_deposited ÷ total_shares` minus the early-withdraw fee.',
+      sharesLabel: 'Amount of vUSDCx to withdraw',
+      balanceHint: 'Balance: {bal}',
       max: 'Max',
-      invalid: 'Invalid integer',
+      invalid: 'Invalid number',
       exceeds: 'Exceeds your balance ({bal})',
       gross: 'Gross withdraw',
       fee: 'Early fee',
@@ -122,7 +125,9 @@ const translations: Record<Lang, Translations> = {
       eyeActive: 'Active',
       eyeAvail: 'Available now',
       eyeCountdown: 'Dead-man-switch · countdown',
-      desc: 'The 90-day dead-man-switch. After ≥90 days of operational inactivity (no Compound, no realloc) any vUSDCx holder can flip `frozen=1 + community_sunset_triggered=1`, opening the permissionless `vault_recall.RecallFromLiqwid` + `vault_protocol.DeployToProtocol` Layer 2 paths so depositors can recover their full proportional USDCx share without keeper or governance intervention. *The flag is one-way — irreversible.*',
+      desc: 'If the vault sees no operational activity for 90 days, the operator may have failed. At that point any vUSDCx holder can flip this dead-man-switch, letting every depositor recover their full USDCx share without the operator, keeper, or governance. *This is one-way — it cannot be undone.*',
+      techToggle: 'Technical details',
+      techDetail: 'The 90-day threshold is measured from `max(last_compound, last_realloc)`. Triggering sets `frozen=1 + community_sunset_triggered=1`, opening the permissionless `vault_recall.RecallFromLiqwid` + `vault_protocol.DeployToProtocol` Layer 2 paths.',
       cdReached: 'Threshold reached',
       cdLabel: 'Days until sunset unlocks',
       availNow: 'AVAILABLE NOW',
@@ -273,10 +278,13 @@ const translations: Record<Lang, Translations> = {
     wd: {
       step: '步驟 2',
       title: '提取',
-      desc: '透過 V1 Withdraw-Zero 路徑（花費 proxy 加上 `vault_user` staking withdrawal）銷毀 vUSDCx，換回金庫 USDCx 中按比例的份額。報價為 `份額 × TD ÷ TS` 減去提前提取手續費；keeper 停擺達 7 天以上時，手續費會自動豁免。',
-      sharesLabel: '要銷毀的份額（原始 vUSDCx）',
+      desc: '燒掉你的 vUSDCx，按金庫目前的兌換比例換回等值的 USDCx。若 keeper 已停擺超過 7 天，提前提取手續費會自動免除。',
+      techToggle: '技術細節',
+      techDetail: 'V1 Withdraw-Zero 路徑：proxy spend + `vault_user` staking withdrawal + 銷毀 vUSDCx。報價 = `份額 × total_deposited ÷ total_shares` 減去提前提取手續費。',
+      sharesLabel: '要提取的 vUSDCx 數量',
+      balanceHint: '餘額：{bal}',
       max: '最大',
-      invalid: '整數格式無效',
+      invalid: '數字格式無效',
       exceeds: '超過你的餘額（{bal}）',
       gross: '提取總額',
       fee: '提前手續費',
@@ -292,7 +300,9 @@ const translations: Record<Lang, Translations> = {
       eyeActive: '已啟用',
       eyeAvail: '現可使用',
       eyeCountdown: 'dead-man-switch · 倒數中',
-      desc: '這是為期 90 天的 dead-man-switch。當營運停擺達 90 天以上（無 Compound、無 realloc），任何 vUSDCx 持有者都可將 `frozen=1 + community_sunset_triggered=1` 設定生效，開啟無需許可的 `vault_recall.RecallFromLiqwid` 與 `vault_protocol.DeployToProtocol` Layer 2 路徑，讓存款人無需 keeper 或治理介入，即可依比例取回完整的 USDCx 份額。*此旗標為單向，無法復原。*',
+      desc: '如果金庫連續 90 天沒有任何營運活動，代表營運方可能已經失效。屆時任何 vUSDCx 持有者都能啟動這個無人值守開關，讓每位存款人不需經過營運方、keeper 或治理，就能取回自己應得的全部 USDCx。*此操作為單向，無法復原。*',
+      techToggle: '技術細節',
+      techDetail: '90 天門檻以 `max(last_compound, last_realloc)` 計算。觸發後會設定 `frozen=1 + community_sunset_triggered=1`，開啟無需許可的 `vault_recall.RecallFromLiqwid` 與 `vault_protocol.DeployToProtocol` Layer 2 路徑。',
       cdReached: '已達門檻',
       cdLabel: '距 sunset 解鎖的天數',
       availNow: '現可使用',
@@ -443,10 +453,13 @@ const translations: Record<Lang, Translations> = {
     wd: {
       step: 'ステップ 2',
       title: '引出',
-      desc: 'V1 Withdraw-Zero パス（proxy の消費と `vault_user` staking withdrawal）を通じて vUSDCx をバーンし、ヴォールト USDCx を比例配分で受け取ります。見積もりは `シェア × TD ÷ TS` から早期引出手数料を引いた額です。keeper が 7 日以上停止している場合、手数料は自動的に免除されます。',
-      sharesLabel: 'バーンするシェア（生の vUSDCx）',
+      desc: 'vUSDCx をバーンし、ヴォールトの USDCx から比例配分された分を受け取ります。keeper が 7 日以上停止している場合、早期引出手数料は自動的に免除されます。',
+      techToggle: '技術詳細',
+      techDetail: 'V1 Withdraw-Zero パス：proxy spend + `vault_user` staking withdrawal + vUSDCx バーン。見積もり = `シェア × total_deposited ÷ total_shares` から早期引出手数料を引いた額。',
+      sharesLabel: '引き出す vUSDCx の数量',
+      balanceHint: '残高：{bal}',
       max: '最大',
-      invalid: '整数の形式が正しくありません',
+      invalid: '数値の形式が正しくありません',
       exceeds: '残高を超えています（{bal}）',
       gross: '引出総額',
       fee: '早期手数料',
@@ -462,7 +475,9 @@ const translations: Record<Lang, Translations> = {
       eyeActive: '有効',
       eyeAvail: '利用可能',
       eyeCountdown: 'デッドマンスイッチ · カウントダウン',
-      desc: 'これは 90 日間のデッドマンスイッチです。運用停止が 90 日以上（Compound なし・realloc なし）続くと、すべての vUSDCx 保有者が `frozen=1 + community_sunset_triggered=1` を立てられます。これにより許可不要の `vault_recall.RecallFromLiqwid` と `vault_protocol.DeployToProtocol` の Layer 2 パスが開き、預入者は keeper やガバナンスの介入なしに、比例配分された USDCx 全額を回収できます。*このフラグは一方向で、元に戻せません。*',
+      desc: 'ヴォールトに 90 日間運用活動がない場合、運用者が機能を停止した可能性があります。その時点で、いずれの vUSDCx 保有者もこのデッドマンスイッチを作動させることができ、すべての預入者が運用者・keeper・ガバナンスを介さずに自分の USDCx 全額を回収できます。*これは一方向で、元に戻せません。*',
+      techToggle: '技術詳細',
+      techDetail: '90 日の閾値は `max(last_compound, last_realloc)` から計算されます。作動すると `frozen=1 + community_sunset_triggered=1` が設定され、許可不要の `vault_recall.RecallFromLiqwid` と `vault_protocol.DeployToProtocol` の Layer 2 パスが開きます。',
       cdReached: '閾値に到達',
       cdLabel: 'sunset 解放までの日数',
       availNow: '利用可能',