From 9665f39dea86e20729884411b5568bbf691efe17 Mon Sep 17 00:00:00 2001
From: Florent Tapponnier <160007691+Flotapponnier@users.noreply.github.com>
Date: Sun, 30 Aug 2026 00:45:26 +0200
Subject: [PATCH 1/2] =?UTF-8?q?fix(fee-compare):=20rename=20Volume?=
 =?UTF-8?q?=E2=86=92Position=20size=20+=20clearer=20vault=20fee=20label?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/fee-compare-client.tsx | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/components/fee-compare-client.tsx b/src/components/fee-compare-client.tsx
index a7ada7a7..06abef26 100644
--- a/src/components/fee-compare-client.tsx
+++ b/src/components/fee-compare-client.tsx
@@ -741,7 +741,7 @@ function WalletSide({
         return (
           <div className="bg-ink/4 rounded-xl p-3 space-y-2">
             <div className="flex items-center justify-between">
-              <p className="text-[10px] uppercase tracking-[0.14em] text-ink-faint">Volume</p>
+              <p className="text-[10px] uppercase tracking-[0.14em] text-ink-faint">Position size</p>
               <p className="font-mono text-xs font-semibold text-ink">{fmtUsd(volume)}</p>
             </div>
             <div className="border-t border-ink/8 pt-2 space-y-1.5">
@@ -751,9 +751,9 @@ function WalletSide({
               </div>
               {hasVault && (
                 <div className="flex items-center justify-between">
-                  <p className="text-[11px] text-ink-faint">
-                    OI vault fee{" "}
-                    <span className="text-[9px] text-ink-faint/50 italic">OI imbalance surcharge</span>
+                  <p className="text-[11px] text-ink-faint" title="Extra fee paid to GNS vault LPs when your trade increases the long/short imbalance. Gains-specific — Hyperliquid uses funding rates instead.">
+                    Vault fee{" "}
+                    <span className="text-[9px] text-ink-faint/50 italic">LP spread surcharge ↗</span>
                   </p>
                   <p className="font-mono text-xs font-semibold text-amber-500">
                     +{fmtUsd(gW.vaultFeesUsdc)}
@@ -1220,7 +1220,7 @@ function GainsTradeTable({
                   <p className="font-mono text-xs font-bold text-ink">{fmtUsd(netCost)}</p>
                   <p className="text-[10px] text-ink-faint/70 mt-0.5 whitespace-nowrap">
                     {fmtUsd(t.tradingFee)} taker
-                    {hasVault ? ` +${fmtUsd(t.vaultFee)} vault` : ""}
+                    {hasVault ? ` +${fmtUsd(t.vaultFee)} vault LP` : ""}
                     {t.borrowingFee > 0.001 ? ` +${fmtUsd(t.borrowingFee)} borrow` : ""}
                     {Math.abs(t.fundingFee) > 0.001
                       ? ` ${t.fundingFee > 0 ? "+" : "−"}${fmtUsd(Math.abs(t.fundingFee))} fund`

From e089b59d2118a928697dd4cb5623195fed3c2b3c Mon Sep 17 00:00:00 2001
From: Florent Tapponnier <160007691+Flotapponnier@users.noreply.github.com>
Date: Sun, 30 Aug 2026 00:48:05 +0200
Subject: [PATCH 2/2] fix(fee-compare): show total position value + inline
 vault fee explanation

---
 src/components/fee-compare-client.tsx | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/src/components/fee-compare-client.tsx b/src/components/fee-compare-client.tsx
index 06abef26..59c816dd 100644
--- a/src/components/fee-compare-client.tsx
+++ b/src/components/fee-compare-client.tsx
@@ -741,24 +741,29 @@ function WalletSide({
         return (
           <div className="bg-ink/4 rounded-xl p-3 space-y-2">
             <div className="flex items-center justify-between">
-              <p className="text-[10px] uppercase tracking-[0.14em] text-ink-faint">Position size</p>
+              <p className="text-[10px] uppercase tracking-[0.14em] text-ink-faint">Total position value</p>
               <p className="font-mono text-xs font-semibold text-ink">{fmtUsd(volume)}</p>
             </div>
+            <p className="text-[10px] text-ink-faint/60 leading-snug">
+              Sum of (collateral × leverage) across all trades in the period.
+            </p>
             <div className="border-t border-ink/8 pt-2 space-y-1.5">
               <div className="flex items-center justify-between">
                 <p className="text-[11px] text-ink-faint">Taker fees</p>
                 <p className="font-mono text-xs font-semibold text-ink">{fmtUsd(gW.feesUsdc)}</p>
               </div>
               {hasVault && (
-                <div className="flex items-center justify-between">
-                  <p className="text-[11px] text-ink-faint" title="Extra fee paid to GNS vault LPs when your trade increases the long/short imbalance. Gains-specific — Hyperliquid uses funding rates instead.">
-                    Vault fee{" "}
-                    <span className="text-[9px] text-ink-faint/50 italic">LP spread surcharge ↗</span>
-                  </p>
-                  <p className="font-mono text-xs font-semibold text-amber-500">
-                    +{fmtUsd(gW.vaultFeesUsdc)}
+                <>
+                  <div className="flex items-center justify-between">
+                    <p className="text-[11px] text-ink-faint">Vault fee</p>
+                    <p className="font-mono text-xs font-semibold text-amber-500">
+                      +{fmtUsd(gW.vaultFeesUsdc)}
+                    </p>
+                  </div>
+                  <p className="text-[10px] text-ink-faint/60 leading-snug">
+                    Gains charges an extra fee to LPs when your trade increases the long/short imbalance. Hyperliquid does not have this — it uses funding rates instead.
                   </p>
-                </div>
+                </>
               )}
               {hasFunding && (
                 <div className="flex items-center justify-between">