ForgeUSD Docs

Forged is an integrated financial platform for collateralized fUSD issuance, structured liquidity, perpetual trading, market intelligence, and onchain identity. The system is built around zkLTC collateral, fUSD-denominated activity, and a product layer that connects credit, liquidity, trading, analytics, and reputation.

Forged is organized around several connected product surfaces:

• Vaults for collateralized fUSD minting.
• Shield for vault and loop health analysis.
• Stability Pool for liquidation absorption and collateral redistribution.
• fUSD Swap for zkLTC/fUSD liquidity access.
• Perps for synthetic LTC exposure using fUSD collateral.
• Perps Pool for fUSD liquidity provision to the trading system.
• Loop for recursive collateralized exposure.
• DEX Terminal for token, pool, protocol, wallet, and route intelligence.
• Activity, analytics, profiles, missions, squads, badges, XP, and leaderboards for ecosystem visibility and reputation.

The platform is designed as a connected financial environment rather than a collection of isolated tools. Vault activity can create fUSD, fUSD can move into liquidity or trading systems, DEX and analytics surfaces make ecosystem activity legible, and the identity layer turns participation into persistent reputation.

Forged is organized by financial function. Each surface exposes a specific capability while sharing the same underlying collateral, accounting, activity, and reputation context.

Primary product paths

Vaults are the core fUSD issuance mechanism. zkLTC collateral is deposited into a vault, and fUSD debt can be minted against that collateral subject to protocol parameters.

Available actions

• Deposit zkLTC collateral.
• Mint fUSD.
• Repay fUSD debt.
• Withdraw available collateral.
• Close a vault once debt is cleared.
• Review collateral ratio, liquidation proximity, mint capacity, and withdrawal capacity.
• Preview the impact of adjustments before execution.

Key concepts

Collateral is the zkLTC locked inside a vault.

Debt is the outstanding fUSD minted against that collateral.

Collateral ratio measures the value of collateral relative to debt. A higher ratio indicates a larger collateral buffer.

Minimum collateral ratio defines the required health level for opening or adjusting a vault.

Liquidation ratio defines the threshold where a vault can be liquidated.

Minimum debt prevents vaults from carrying uneconomically small debt positions.

Debt ceiling caps total fUSD issuance through the vault system.

Page interpretation

The vault page centers on position health. The most important fields are current collateral, outstanding debt, collateral ratio, liquidation proximity, mintable fUSD, withdrawable collateral, and the oracle price used for valuation.

Minting fUSD increases debt and lowers the collateral ratio. Withdrawing collateral reduces the safety buffer in the same way. Repayment and additional collateral improve vault health.

Shield is the collateral-health analysis surface for vault and loop positions. It models how a position responds to adverse zkLTC price movement and shows the repayment or collateral adjustment required to maintain a target health profile.

Available analysis

• Price-crash simulation.
• Current and simulated collateral ratio.
• Estimated repayment required at a selected price level.
• Estimated collateral required at a selected price level.
• Vault and loop comparison where both are present.
• Liquidation proximity indicators.

Page interpretation

Shield is most useful when evaluating how far a position is from liquidation under changing market conditions. The key fields are crash percentage, simulated zkLTC price, current ratio, simulated ratio, collateral requirement, repayment requirement, and loop ratio where applicable.

The Stability Pool is the liquidation backstop for the vault system. fUSD deposited into the pool can be used to offset debt from liquidated vaults. In return, pool participants receive exposure to collateral distributed through the liquidation process.

Available actions

• Deposit fUSD.
• Withdraw available fUSD according to pool accounting.
• Track pool share.
• Track collateral gains.
• Review total pool size and pool value.

How the pool fits the system

The vault system requires a mechanism for resolving unhealthy debt. The Stability Pool provides pre-positioned fUSD that can absorb liquidated debt efficiently. This links fUSD holders with collateral liquidation flows and creates a structured role for passive capital inside the protocol.

Page interpretation

The Stability Pool page focuses on deposited fUSD, share of the pool, accumulated collateral gains, total pool liquidity, and recent liquidation activity. Pool share determines exposure to both fUSD usage during liquidation and collateral received from liquidation events.

fUSD Swap provides native liquidity between zkLTC and fUSD through the platform router.

Available actions

• Swap zkLTC into fUSD.
• Swap fUSD into zkLTC.
• Review quoted output.
• Review fee impact and size limits.
• Review router liquidity and availability.

Page interpretation

The swap surface is centered on execution quality and available liquidity. Quoted output, fee impact, maximum trade size, router liquidity, outflow limits, and oracle availability define whether a swap is executable and economically sensible.

Perps provide synthetic LTC exposure using fUSD collateral. Positions can be opened long or short, with leverage defining notional exposure relative to posted margin.

Available actions

• Open a long position.
• Open a short position.
• Select margin and leverage.
• Review notional exposure.
• Monitor equity, PnL, funding, and liquidation price.
• Close an open position.
• Participate in liquidation flows where available.

Core trading concepts

Margin is the fUSD collateral committed to a position.

Notional is the total synthetic exposure controlled by the position.

Leverage is the ratio between notional exposure and margin.

PnL reflects the gain or loss produced by price movement after position entry.

Equity is margin plus or minus unrealized PnL after relevant funding and fees.

Liquidation price is the price level where the position no longer satisfies required margin conditions.

Funding transfers value between long and short exposure depending on market skew and protocol parameters.

Settlement pricing

The live price stream provides market context. Settlement-sensitive actions rely on fresh signed price data verified by the protocol. This distinction matters because visual price feeds and enforceable settlement prices serve different roles.

Page interpretation

The perps page is driven by position structure: side, margin, leverage, entry price, notional, liquidation price, equity, PnL, fees, and funding. Position sizing should be evaluated against liquidation proximity and available fUSD margin.

The Perps Pool supplies fUSD liquidity to the perpetual trading system. Liquidity providers receive pool shares whose value changes with fees, trader PnL, protocol reserves, and pool accounting.

Available actions

• Deposit fUSD into the pool.
• Receive pool shares.
• Review pool NAV and share value.
• Request withdrawal.
• Execute withdrawal after the configured cooldown.
• Track pending withdrawal state.

Pool mechanics

Pool shares represent proportional ownership of the pool rather than a fixed claim to the original deposit amount. Trader losses, fees, and protocol flows can increase pool value. Trader profits and settlement outflows can reduce pool value. Pending withdrawals remain part of the pool until execution.

Page interpretation

The core fields are deposited liquidity, pool share balance, pool NAV, share price, utilization, pending withdrawal amount, withdrawal timer, and available execution state.

Loop creates recursive collateralized exposure by combining vault debt, swap execution, and position-specific management. It is distinct from perps: loop positions are collateral/debt structures, while perps are synthetic derivative positions settled against signed prices.

Available actions

• Open a loop position.
• Increase an existing loop.
• Decrease exposure.
• Exit the loop.
• Add collateral.
• Repay debt.
• Withdraw available collateral.
• Review loop health and liquidation proximity.

Position interpretation

Loop positions amplify exposure through repeated borrowing and conversion. This increases sensitivity to collateral-price movement. The most important fields are collateral, debt, collateral ratio, loop size, execution assumptions, and liquidation proximity.

The DEX Terminal is the market intelligence surface for Forged. It organizes token, pool, protocol, trade, transfer, wallet, and route data into a research and execution environment.

Market overview

The overview surface summarizes active tokens, liquidity, recent trades, market movement, and notable activity. It provides a broad read on where attention and volume are concentrated.

Token screener

The token screener supports discovery by liquidity, volume, price movement, age, holder distribution, activity, and other market attributes. It is designed for fast comparison across listed or discovered assets.

Token pages

Token detail pages consolidate price, liquidity, volume, pools, trades, holders, transfers, contract metadata, and route availability. These pages are the primary research surface for individual assets.

Pool explorer

The pool explorer shows liquidity venues, reserves, trade activity, fee context, and protocol/factory relationships. Pool pages help distinguish between apparent token interest and actual executable liquidity.

Protocol views

Protocol/factory views group pools and activity by originating DEX or factory. This helps identify where liquidity is concentrated and which venues are active.

Wallet intelligence

Wallet pages aggregate balances, activity, labels, trading behavior, PnL where available, and interaction history. This provides a market-participant view rather than only a token-centric view.

Route builder

Route information shows available paths, expected execution, liquidity depth, and confidence indicators. Backend-built routing keeps executable paths aligned with indexed pool data and supported venue logic.

Page interpretation

The DEX Terminal should be read through liquidity quality, trade recency, holder concentration, route confidence, pool depth, protocol venue, and wallet behavior. Market data is most valuable when these signals are considered together rather than in isolation.

Activity and analytics surfaces make protocol and market movement legible across Forged.

Activity

Activity views organize events such as vault actions, fUSD flows, perps events, swaps, faucet claims, DEX trades, transfers, and profile-related actions. Global feeds show ecosystem movement; address-level feeds show account-specific history.

Analytics

Analytics views aggregate platform behavior across collateral, debt, pool liquidity, trading volume, perps activity, fees, revenue-style metrics, active accounts, and DEX movement. These surfaces provide a higher-level read on platform usage and economic activity.

Page interpretation

The most relevant analytics depend on the product surface. Vault health is tied to collateral and debt. Stability Pool health is tied to available fUSD and liquidation activity. Perps health is tied to open interest, pool liquidity, utilization, volume, fees, and trader PnL. DEX health is tied to liquidity, volume, transfers, holders, and route quality.

Forged includes a progression and identity layer that turns platform activity into visible reputation.

Profiles

Profiles create a public identity surface for addresses. Profile data can connect activity, badges, XP, missions, squads, and leaderboard placement into a single presence.

XP

XP tracks progression across configured activities and seasons. It gives activity a durable score beyond isolated transactions.

Badges

Badges represent achievements, roles, or completed milestones. Some badges are one-time achievements; others may be repeatable depending on configuration.

Missions

Missions guide participation across the platform. They can be based on direct onchain activity, app-level verification, or admin-verified completion depending on the mission type.

Page interpretation

The identity layer is best understood as a reputation graph over protocol usage. Activity produces signals; missions structure those signals; XP and badges preserve them; profiles make them visible.

Squads introduce group identity and competition. Leaderboards rank activity across configured categories and seasons.

Squads

Squads allow addresses to join a collective identity. Squad membership can influence group rankings, seasonal competition, and social positioning across the platform.

Leaderboards

Leaderboards can rank perps activity, vault activity, fUSD usage, pool participation, faucet activity, ecosystem activity, or other configured metrics. Ranking categories depend on indexed activity and season configuration.

Page interpretation

Leaderboard value comes from comparison. Individual ranks show account-level performance; squad ranks show collective performance. Seasonal context determines which activity matters during a given period.

The Faucet distributes platform assets according to configured limits and authorization rules.

Available actions

• Claim fUSD where available.
• Claim zkLTC where available.
• Review cooldowns and claim availability.
• Use Telegram-linked faucet flows where enabled.

Page interpretation

The faucet page is governed by eligibility, cooldowns, wallet limits, available faucet balance, and authorization checks. Claims are meant to bootstrap platform interaction and provide access to core product surfaces.

Payments allow payment requests and settlement flows inside the Forged ecosystem.

Available actions

• Create a payment request.
• Pay an open request using supported assets.
• Cancel an open request.
• Review payment status.

Page interpretation

The payments surface is built around requester, payer, asset, amount, status, and completion state. It extends fUSD and supported assets beyond trading and collateral into direct account-to-account settlement.

The bridge surface demonstrates cross-environment asset movement for supported assets and relayer flows.

Available actions

• Initiate a supported bridge flow.
• Complete or finalize a relayed bridge action where available.
• Review asset, amount, direction, and completion state.

Page interpretation

Bridge flows depend on asset support, relayer configuration, source/destination direction, and replay protection. The page should be interpreted as an asset-movement module rather than a general-purpose canonical bridge abstraction.

Forged includes restricted controls for parameter management, indexing operations, faucet configuration, mission administration, and system notices. Public-facing status information helps explain whether a surface is active, paused, degraded, or restricted.

Page interpretation

Notices and visible status indicators provide operational context. Paused states, restricted actions, delayed indexing, unavailable liquidity, or parameter changes can affect what is currently executable across the platform.

Collateral: Asset locked to support debt or exposure.

Collateral ratio: Collateral value divided by outstanding debt.

Debt: fUSD obligation created through minting.

fUSD / ForgedUSD: The stable asset and accounting unit of Forged.

Liquidation: Resolution of an undercollateralized or under-margined position.

Margin: fUSD collateral committed to a perps position.

Notional: Total synthetic exposure of a perps position.

Pool share: Proportional claim on a pool’s net asset value.

Signed price: Price data signed by an authorized signer and verified by the protocol for settlement-sensitive perps actions.

Stability Pool: fUSD pool used to absorb liquidated vault debt and distribute collateral gains.

Vault: Collateralized debt position used to mint fUSD against zkLTC.

zkLTC: Native asset of litVM and core collateral asset in Forged.