Technical Master Blueprint

Architecture v2.0 | Last Updated: December 9, 2025

🔹 Protocol Vision

VIBE Protocol is architected to be the most advanced, sovereign, and modular DeFi protocol within the EVM and Polkadot ecosystems.

We combine the efficiency of established lending markets with the resilience of a unified liquidity architecture. VIBE acts as the financial nervous system connecting Soneium and Astar Network.

🚀 Live Status (Dec 9, 2025):
The protocol is fully operational on Soneium Mainnet and Astar EVM Mainnet.

⚙️ 1. Core: Lending Layer (Phase A)

The foundation of the protocol, handling asset pools, interest rates, and solvency.

Contract Module	Functionality	Status
V_cERC20_ExtendedInterest	Handles ERC-20 markets (mint, redeem, borrow, repay, liquidate). Includes extension for supply/borrow caps and reward hooks.	✅ Live & Stable
V_MasterEnhanced	The Comptroller V3. Coordinates all markets, calculates account health, and enforces global risk parameters.	✅ Live & Stable
InterestRateModelDynamic	Modular interest model based on kink utilization curves. Upgradable via governance without market migration.	✅ Live

🧠 2. Governance & VIBE Token (Phase B)

Decentralized control and incentives mechanism.

Token Name: VIBE Governance Token
Max Supply: 1,000,000 VIBE (Soneium)
Utility: Voting rights, Boosting rewards, Safety Module staking.

Tokenomics Distribution

Community

60%

Lenders, Borrowers, LM

Treasury

20%

Protocol Safety

Team

No allocations

Eco/Liquidity

20%

Cross-chain Reserves

💵 3. Stablecoin Layer — VIBEUSD (Phase C)

A native, over-collateralized stablecoin mintable directly via the borrow module. Inspired by modern debt-based stablecoin designs.

VIBEUSDStabilityModule (VSM): Maintains peg via asymmetric mint/burn mechanics and market making.
Parameters: LTV Max: 75%, Liquidation Threshold: 80%, Stability Fee: 0.5%.

🪙 4. Omnipool & Liquidity Router (Phase D)

SoneVibeLiquidityRouter: An internal swap router that seeks the best execution path across SoneSwap, UniswapV3, and Curve.

Omnipool Adapter: Allows liquidators to instantly swap seized collateral into debt assets within the same transaction, reducing slippage and increasing system health.

⚡ Protocol Yellow Paper: Core Logic & Differentiation

Detailed architectural breakdown for researchers and auditors. Defining the VIBE deviation from standard lending forks.

1. Protocol Genealogy & Security

VIBE Finance is not a raw fork. It implements a Hybrid Architecture:

Core Solvency Engine: Based on Compound V2 (Unitroller/Comptroller pattern) for its battle-tested mathematical reliability over 5 years.
Risk Management: Implements Aave V3-style caps (Supply Caps, Borrow Caps) and Isolation Mode logic directly into the Comptroller.
Price Feeds: Custom oracle wrappers supporting DIA (Astar) and Chainlink (Soneium) with fallback mechanisms.

2. Anti-Manipulation: The `internalCash` Mechanism

Standard cTokens (Compound V2) rely on balanceOf(address(this)) to calculate interest rates. This is vulnerable to "Donation Attacks" where an attacker sends underlying tokens directly to the contract to manipulate the exchange rate or force liquidations.

The VIBE Solution (V_cERC20_ExtendedInterest.sol):

            // Core Innovation in VIBE cTokens

            uint256 public internalCash;

            function mint(uint256 amount) external nonReentrant {

              ...

              // 1. Calculate actual transfer (Support fee-on-transfer tokens)

              uint256 balanceBefore = ERC20(underlying).balanceOf(this);

              transferFrom(msg.sender, this, amount);

              uint256 received = ERC20(underlying).balanceOf(this) - balanceBefore;

              // 2. Sync Internal Accounting

              internalCash += received;

              ...

            }

By strictly tracking internalCash on every Mint, Redeem, Borrow, and Repay, VIBE creates a hermetic accounting system. External donations are ignored by the interest rate model, protecting users from exchange rate manipulation.

3. Future Outlook: Startale Vault Routing

Current lending protocols leave idle liquidity (Cash - Reserves) unproductive. Following community feedback (RFC-9213), we are architecting a Yield Router Module.

Conceptual Logic: Instead of idle capital sitting in the cToken contract earning 0%, the protocol will utilize an "Idle Strategy Strategy" to route excess liquidity into Startale App Vaults or Soneium Staking, generating 'Real Yield' that flows back to the Reserves, increasing the APY for suppliers organically without token emissions.

4. Mathematical Specifications

Metric	Formula
Exchange Rate	`(internalCash + totalBorrows - totalReserves) / totalSupply`
Utilization Rate	`totalBorrows / (internalCash + totalBorrows - totalReserves)`
Health Factor	`(Σ Collateral_USD * LiquidationThreshold) / TotalBorrows_USD`

📜 Protocol Whitepaper & Math Specifications

The underlying mathematical models governing the VIBE Protocol solvency, interest rates, and liquidation logic.

1. The Jump Rate Model (Interest Logic)

VIBE utilizes a dynamic algorithmic interest rate model derived from the Utilization Rate (U) of each market. This ensures liquidity is always available for withdrawals while optimizing yield for suppliers.

// 1. Utilization Rate Formula

U = TotalBorrows / (Cash + TotalBorrows - Reserves)

The Borrow Rate changes based on a "Kink" point (optimal utilization). This incentivizes borrowers when liquidity is abundant and protects the protocol when liquidity is scarce.

If U < Kink:

Rate = BaseRate + (U * Multiplier)

Slow increase to encourage borrowing.

If U > Kink:

Rate = RateAtKink + (U - Kink) * JumpMultiplier

Rapid spike to force repayments.

2. cToken Exchange Rate

cTokens (e.g., cASTR) are interest-bearing wrappers. Their value relative to the underlying asset increases every block as interest accrues.

ExchangeRate =
(Cash + TotalBorrows - Reserves) / TotalSupply_cTokens

* Cash: Underlying balance held in the contract.
* Reserves: Protocol profit set aside for safety.

3. Solvency & Liquidation

To ensure protocol solvency, accounts with a Health Factor (HF) below 1.0 are subject to liquidation.

Health Factor Formula

HF = ( Σ Collateral_i * CF_i ) / TotalBorrows_USD

Collateral_i: Value of asset i in USD.
CF_i: Collateral Factor (e.g., 0.75 for ASTR).

Liquidation Incentive

When HF < 1.0, liquidators repay up to 50% of the debt (Close Factor) and receive collateral plus a bonus.

Bonus (Incentive): 8% - 10%

Calculated as: SeizeAmount = RepayAmount * (1 + Incentive)

🛡️ 5. Security Architecture (The Nucleus)

VIBE Protocol implements a proprietary "Defense-in-Depth" security model designed to protect against modern DeFi vectors like donation attacks and price manipulation.

A. The Nucleus Mechanism (`internalCash`)

Unlike standard lending forks that rely on balanceOf(this), VIBE uses an isolated accounting variable called internalCash.

Anti-Inflation: Prevents attackers from artificially inflating the exchange rate by sending direct token transfers to the contract.
Donation Sweep: Any surplus tokens sent to the contract (donations) are separated from the lending pool and routed to the Protocol Reserves via the sweepDonations() function, benefitting VIBE stakers instead of attackers.

B. Guarded Launch Parameters

Security Module	Description
Supply/Borrow Caps	Hard limits on total liquidity per asset. Prevents infinite minting attacks or over-exposure to a single asset class.
Guardian Pauses	The `PauseGuardian` multisig can instantly freeze Minting, Borrowing, or Liquidations globally or per market in case of on-chain anomalies.
Oracle Thresholds	Price updates are rejected if they deviate >20% from the previous checkpoint without manual validation (Circuit Breaker).

C. Asset Listing Strategy

We prioritize solvency over volume. New assets are listed in tiers:

Tier 1 (Live): Majors & Native Gas (ASTR, USDC). Max LTV: 75%. (ASTR LTV: 30% DOT LTV: 60%)
Tier 2 (Upcoming): Bridged Bluechips (WBTC, WETH). Requires 30-day bridge stability.
Tier 3 (Governance): Ecosystem tokens (LSDs, DEX Gov tokens). Isolated mode with Debt Ceilings.

🧭 Roadmap 2025 – 2026

Q1 2025 (Completed)

Consolidate Lending Core (cERC20 + cNative + Comptroller V3 Fixed).

Q2 2025 (Completed)

VIBE Token Launch + Governance DAO activation.

Q3-Q4 2025 (Current)

Integration of VIBEUSD Stablecoin & Treasury System.
Deployment of Omnipool Router and Oracle Hub.

Q1 2026

Cross-chain Bridge Layer (Soneium ↔ Astar). RiskManager AI Beta.

“Liquidity is life.”

SoneVibe is becoming the financial nervous system between Soneium, Astar, and Polkadot — a network where collateral, credit, and governance flow freely with total transparency.