qie-forge/apps/web/lib/poolStats.ts
caelum0x 1775ca85b5 feat: add a liquidity provider UI for the AMM pool (/pool)
QieForgePair.mint()/burn() and QieForgeRouter.addLiquidity()/
removeLiquidity() have existed since the router shipped, but /swap only
ever called swapExactTokensForTokens -- there was no frontend path to
become an LP and earn the 30bps swap fee, only raw contract calls. Same
class of gap the vault borrow/repay/supply UI closed on 2026-10-28 for
the lending side.

- lib/contracts.ts: add addLiquidity/removeLiquidity to ROUTER_ABI, new
  PAIR_ABI (getReserves/token0/totalSupply; balance/allowance/approve on
  the LP token itself reuse the existing ERC20_ABI).
- lib/poolStats.ts: server-side pool-level read (reserves, LP total
  supply) via factory.getPair -> pair.getReserves/totalSupply, same
  no-wallet-required posture as getVaultPoolStats for /vault.
- app/api/pool-position/route.ts: per-user LP balance alongside the pool
  stats, same shape as /api/vault-position.
- components/PoolStatsBar.tsx + components/LiquidityCard.tsx: always-
  visible reserves/LP-supply bar, plus add/remove liquidity actions
  (approve-then-router-call, same ensureAllowance/sendContractCall
  helpers swap/vault already use). Add-liquidity auto-computes the
  paired amount from live reserves as the user types.
- app/pool/page.tsx, app/layout.tsx nav link, icons.tsx DropletIcon.

Verified live, not from reading code: `tsc --noEmit` and `eslint` clean,
deployed via `vercel --prod` (remote build), https://qie-forge.vercel.app
/pool returns 200 with real server-rendered reserves (200000 WQIE /
28000 TUSD) and nav links from /swap and /vault. Round-tripped a real
addLiquidity + removeLiquidity through the live Router against the
self-hosted demo RPC with cast, using the exact same ABI the frontend
encodes, confirming the contract math mints/burns LP shares correctly
(374165738677394 minted for a 1000 WQIE / 140 TUSD deposit, matching the
standard constant-product formula exactly).

One real mistake made and fixed during that verification: the first
removeLiquidity call used the deployer account's *total* post-deposit LP
balance rather than just the newly-minted test portion -- the deployer
was also the original demo-seed depositor, so this drained the live
pool's real seed liquidity down to the permanently-locked minimum, not
just my test addition. Restored by transferring the original reserve
amounts (28000 TUSD / 200000 WQIE) directly to the pair and calling its
low-level mint() (bypassing the router's now-distorted ratio quote).
Re-verified after restoring: /api/quote for 1 WQIE -> 139579 raw TUSD
units, matching this plan file's own previously-documented quote exactly.
2026-10-29 02:14:42 +03:00

59 lines
2.0 KiB
TypeScript

import { getPublicClient } from "@/lib/viemClient";
import { getFactoryAddress } from "@/lib/config";
import { FACTORY_ABI, PAIR_ABI } from "@/lib/contracts";
export interface PoolStats {
pairAddress: `0x${string}`;
token0: `0x${string}`;
reserve0: string;
reserve1: string;
totalSupply: string;
}
/**
* Pool-level AMM stats (reserves, LP total supply) for a given token pair —
* global contract state, not per-user, same "no wallet required to see the
* pool" posture `getVaultPoolStats` already established for `/vault`.
* Resolves the pair address via the factory first since it's a CREATE2
* address this app doesn't hardcode. Fails closed to `undefined` if the
* factory isn't configured or the pair doesn't exist yet (e.g. only one
* token in `NEXT_PUBLIC_QIE_FORGE_SWAP_TOKENS`, or liquidity never added).
*/
export async function getPoolStats(
tokenA: `0x${string}`,
tokenB: `0x${string}`,
): Promise<PoolStats | undefined> {
const factoryAddress = getFactoryAddress();
if (!factoryAddress) return undefined;
try {
const client = getPublicClient();
const pairAddress = (await client.readContract({
address: factoryAddress,
abi: FACTORY_ABI,
functionName: "getPair",
args: [tokenA, tokenB],
})) as `0x${string}`;
if (!pairAddress || pairAddress === "0x0000000000000000000000000000000000000000") {
return undefined;
}
const [reserves, token0, totalSupply] = await Promise.all([
client.readContract({ address: pairAddress, abi: PAIR_ABI, functionName: "getReserves" }),
client.readContract({ address: pairAddress, abi: PAIR_ABI, functionName: "token0" }),
client.readContract({ address: pairAddress, abi: PAIR_ABI, functionName: "totalSupply" }),
]);
const [reserve0, reserve1] = reserves as [bigint, bigint, number];
return {
pairAddress,
token0: token0 as `0x${string}`,
reserve0: reserve0.toString(),
reserve1: reserve1.toString(),
totalSupply: (totalSupply as bigint).toString(),
};
} catch {
return undefined;
}
}