Reforge
Architecture

Frontend Views

Next.js frontend interfaces, real-time dashboards, liquidator console, and empirical research laboratory

The Reforge frontend is a modular, high-performance web application built with Next.js 16, Tailwind CSS, and Fumadocs. It delivers four dedicated interfaces tailored for observers, MEV liquidator searchers, and protocol researchers.


Views Overview


1. Protocol Dashboard (/dashboard)

The Protocol Dashboard serves as the central command center for monitoring systemic risk, collateralization ratios, and global protocol health across all asset pools.

Key Metrics Monitored

MetricCategoryDescription
Total Value Locked (TVL)LiquidityAggregate value of collateral deposited across all lending pools (ETH, WBTC, wstETH) priced via real-time Chainlink feeds.
Outstanding DebtSolvencyTotal synthetic and stablecoin debt borrowed against active collateral positions (USDC, USDT, DAI).
Active PositionsRiskTotal count of live borrower debt positions continuously scanned for solvency.
Liquidatable PositionsAlertImmediate alert counter showing all positions currently crossing the threshold where HF < 1.00.
Settled VolumeThroughputCumulative dollar volume of liquidations settled deterministically through Reforge batch auctions.
Bad Debt PreventedSecurityTotal protocol insolvency prevented compared to baseline mempool congestion failure rates.

Protocol Solvency Telemetry

MetricCalculation / SourceUpdate FrequencyPurpose
Global Collateral RatioTotal Collateral Value / Total Borrowed DebtPer block (12s)Measures macro protocol solvency buffer.
At-Risk Debt (HF < 1.05)Sum of debt for positions with HF ∈ [1.00, 1.05)Real-time WebSocketEarly warning queue for incoming liquidation volume.
Protocol Recovery Rate(Recovered Collateral / Defaulted Debt) × 100%Per settled auctionEvaluates liquidation execution efficiency.
Average Auction DurationBlock timestamp delta (End - Start)Historical indexerMonitors batch clearance latency against volatility.

2. Liquidation Marketplace (/marketplace)

The Liquidation Marketplace is a live feed of underwater loans where liquidators, automated searchers, and users can discover liquidation opportunities.

Live Opportunities Explorer

A real-time reactive table displaying open auction events and eligible borrower positions:

Position IDCollateral AssetDebt ValueHealth FactorEst. Gross ProfitAuction StatusAction
0x7A29...b4F14.50 ETH ($13,500)$9,200 USDC0.97+$460.00🟢 Bidding OpenInspect / Bid
0x19E4...88c21.20 WBTC ($72,000)$51,400 USDT0.94+$2,570.00🟡 1 Block LeftPlace Bid
0x42B0...179A18.00 wstETH ($61,200)$44,800 USDC0.99+$1,344.00🔵 CalculatingView Details

Position Deep-Dive Inspector

Selecting any position opens the comprehensive Position Inspector Panel, giving liquidators full transparency before committing capital.

Total Collateral10.00 ETH ($30,000.00)
Total Borrowed Debt$21,400.00 USDC
Current Health Factor0.941 (Liquidatable)
Liquidation Bonus Margin+5.00% ($1,070.00)

3. Liquidator Console (/liquidator)

The Liquidator Console is an institutional execution workstation allowing searchers and bot operators to monitor their capital efficiency, active commitments, and realized P&L.

Searcher Cockpit Telemetry

  • Connected Wallet: 0x94B...28aF (Mainnet / Sepolia)
  • Available Liquidity: $150,000.00 USDC
  • Active Capital in Transit: $32,400.00 USDC

Historical Performance Metrics

  • Auctions Won: 142 / 168 (84.5% Win Rate)
  • Total Net Profit: +$18,420.50
  • Total Gas Expended: $1,240.10 (vs. $9,800+ in baseline PGA)
  • Effective Net ROI: +14.85%

Zero Gas Bribery Overhead: Because Reforge awards settlements based on Net Economic Value rather than priority gas placement, searchers keep up to 90% of their gross profit instead of paying it to block proposers.


4. Research Laboratory (/research)

The Research Laboratory is the cornerstone academic interface of Reforge. It enables researchers to configure simulation scenarios, run comparative benchmarks between conventional first-come liquidations and MEV-aware batch auctions, and visualize empirical results.

Interactive Experiment Configuration

Simulation Parameter Matrix

Liquidation Mechanism
Conventional PGAMEV-Aware Batch Auction
Competing Liquidators

10 Active Searcher Bots

Configurable between 2 to 100 automated agents
Network Gas Price

50 Gwei (Base: 35, Priority: 15)

Simulates normal vs. congested mempool conditions
Collateral Shock Volatility

5.0% Flash Drop

Geometric Brownian motion with jump-diffusion events

Comparative Benchmark Results

Simulated execution across 1,000 synthetic liquidation events demonstrates substantial economic advantages:

Performance MetricConventional PGAReforge Batch AuctionVarianceEconomic Impact
Gas Cost / Liquidation$142.00$61.00-57.0%Massive reduction in network congestion and wasted compute.
Liquidator Net Profit$321.00$402.00+25.2%Liquidators retain value instead of paying block proposers.
Borrower Loss$718.00$531.00-26.0%Borrowers preserve substantially more leftover equity.
Settlement Latency1.8 blocks2.1 blocks+0.3 blocksAcceptable micro-delay safely offset by protocol buffers.
Protocol Debt Recovery96.2%97.1%+0.9%Higher debt clearance rate with lower bad debt risk.

Technical Specifications

For in-depth architectural component designs, interface schemas, and state management models, explore the living specifications:

On this page