Documentation

How SoneVibe works

Everything you need to trade, provide liquidity, lend, borrow, mint SVUSD and trade NFTs with SoneVibe — the formulas, the fees, the risk parameters and every contract address. Values marked live are read from the blockchain when you open this page.

Live parametersHome chain: SoneiumAlso on BNB Chain · Astar · Polkadot HubReading chain…

Overview #

SoneVibe is a non-custodial DeFi protocol whose home is Soneium. It combines six products in one app:

You always interact with the smart contracts directly from your own wallet. SoneVibe never holds your private keys, and there is no off-chain order book or database: balances, prices and statistics in the app come from the chain.

Networks #

Soneium runs the full suite. The DEX is also deployed on BNB Chain, Astar and Polkadot Hub, and the NFT market runs on Soneium and Astar. Testnets are used to ship new features before mainnet.

NetworkChain IDStatusProductsExplorer
Loading networks…

Getting started #

  1. Install a wallet. SoneVibe supports MetaMask, Trust Wallet and Nova Wallet (browser extension or the wallet's in-app browser on mobile).
  2. Get gas. Transactions on Soneium are paid in ETH; on BNB Chain in BNB; on Astar in ASTR. Bridge ETH to Soneium through the official bridge listed on soneium.org.
  3. Connect. Press Connect Wallet in the app. If your wallet is on another network, the app asks it to switch or add the network for you.
  4. Approve, then act. The first time you use a token, your wallet asks for an approval so the contract can move that token. After that, swaps, deposits and repayments need a single confirmation.
Always check that you are on sonevibe.github.io/Lending and that contract addresses in your wallet match the ones in Contracts. SoneVibe will never ask for your seed phrase.

Swap #

The SoneVibe DEX is a Uniswap V2-style constant-product AMM. Each pool holds two tokens and keeps x · y = k after every trade (minus the fee), so the price moves with the size of your order relative to the pool.

// Output of a swap, with the 0.25% fee taken from the input
amountInWithFee = amountIn × 9975
amountOut       = amountInWithFee × reserveOut / (reserveIn × 10000 + amountInWithFee)

Settings and protections

SettingValueWhat it does
Swap fee0.25%Charged on the input amount and left inside the pool.
Slippage tolerance0.5% default · 0.1% / 1% / 5%The transaction reverts if you would receive less than quote × (1 − slippage).
Deadline20 minutesThe swap reverts if it is mined later than this, so a stuck transaction cannot fill at a stale price.
Price impactWarning > 1% · Danger > 5%How far your trade moves the pool price. Shown before you confirm.
Wrap / unwrap1 : 1, no feeETH ↔ WETH (or BNB ↔ WBNB) goes straight through the wrapped-token contract, not a pool.

Routing

The app swaps through the direct pool between the two tokens you pick (for example ASTR → USDC). If a pair has no pool, swap through a common token such as ETH or USDC in two steps. The router contract itself supports multi-hop paths, and automatic routing in the app is on the roadmap.

Token approvals from the Swap page are unlimited, so you only approve each token once. You can review or revoke them at any time from your wallet or the block explorer's token-approval tool.

Liquidity & APR #

Deposit both tokens of a pair in equal value and you receive LP tokens that represent your share of the pool. Fees accumulate inside the pool, so the value of each LP token grows as people trade. Nothing to claim: fees are auto-compounded and paid out when you remove liquidity.

Where the 0.25% goes

RecipientShare of feeShare of volume
Liquidity providers5/60.2083%
Protocol treasury (feeTo)1/60.0417%

The protocol share is minted as LP tokens to the treasury only when liquidity is added or removed (_mintFee), exactly like Uniswap V2. The first deposit in every new pool permanently locks 100,000 wei of LP tokens to prevent share-price manipulation.

How APR and APY are calculated

Fee APR = (7-day volume × 0.2083%) / 7 × 365 / pool TVL
APY     = (1 + APR / 365)^365 − 1

This is the same method used by the large DEXs: it is based on real fees from the last 7 days, not a target. It changes every day with volume and liquidity. The Analytics page shows APR per pool and a calculator for your own position.

Impermanent loss

When the price of one token changes relative to the other, the pool rebalances and you end up with less value than if you had simply held both tokens. Fees offset this over time.

Price change of one token1.25×1.5×2×3×5×
Loss vs. holding−0.6%−2.0%−5.7%−13.4%−25.5%

Formula: IL = 2·√r / (1 + r) − 1, where r is the price ratio change. The same numbers apply if the price falls by the same factor.

Lending & borrowing #

SoneVibe lending follows the proven Compound V2 design. When you supply an asset you receive interest-bearing cTokens (e.g. cASTR). Supplied assets can be enabled as collateral to borrow other assets. Interest accrues every block.

Live markets on Soneium

MarketSuppliedBorrowedUtilizationSupply APRBorrow APR
Reading markets…

Risk parameters

ParameterValueMeaning
Collateral factorPer market, shown in the appShare of a collateral's value you can borrow against. $100 of collateral with a 60% factor supports $60 of debt.
Close factorMaximum share of a borrow that can be repaid in a single liquidation.
Liquidation incentiveBonus collateral a liquidator receives on top of the debt repaid.
Reserve factorShare of borrow interest kept as protocol reserves instead of paid to suppliers.

Formulas

Utilization U    = borrows / (cash + borrows − reserves)
Borrow rate      = base + U × multiplier                      (U ≤ kink)
                 = base + kink × multiplier + (U − kink) × jump (U > kink)
Supply rate      = borrow rate × U × (1 − reserve factor)
Exchange rate    = (cash + borrows − reserves) / cToken supply
Health factor    = Σ (collateral USD × collateral factor) / total borrows USD

SoneVibe cTokens track internalCash instead of reading the contract's token balance. Tokens sent directly to a market ("donations") therefore cannot move the exchange rate — a known attack on standard Compound forks.

Liquidation

If your health factor falls below 1.0, anyone can repay up to the close factor of your debt and receive your collateral plus the liquidation incentive. Keep a buffer: prices move, and interest keeps growing your debt.

// Example with the live parameters
Debt $1,000 · HF 0.97 → liquidator repays up to $500
Liquidator receives $500 × 1.10 = $550 of your collateral

Prices come from the SoneVibe oracle contract (), shown in Contracts.

SVUSD stablecoin #

SVUSD is SoneVibe's dollar stablecoin. It can only be minted by approved facilitators, and each facilitator has a hard bucket cap on how much it can create. Two facilitators exist:

1 · Stability module (PSM)

Swap USDC and SVUSD 1:1 minus a small fee. This is what holds the peg: when SVUSD trades above $1, minting through the module is profitable; below $1, redeeming is.

ActionFunctionFee
USDC → SVUSD (mint)buySVUSD(amountUSDC)
SVUSD → USDC (redeem)sellSVUSD(amountSVUSD)

The module holds the USDC reserves itself, up to a reserve cap of . SVUSD in circulation on Soneium: .

2 · Borrowing (mintable market)

Supply collateral in the lending markets and borrow SVUSD from the cSVUSD market. Borrowing mints new SVUSD to your wallet and repaying burns it. Because no one supplies SVUSD, interest on SVUSD debt goes to the protocol treasury. Positions follow the same health-factor and liquidation rules as any other borrow.

Open the SVUSD console →

Farms & staking #

Farms (MasterChef). Stake LP tokens to earn LIGHT. A fixed amount of LIGHT is emitted per block and split between farms by their allocation points. There is no bonus multiplier (1×), and emergencyWithdraw always lets you take your LP tokens out, giving up pending rewards.

Pools (SousChef). Stake a single token and earn another (for example stake LIGHT, earn DOT). Rewards are pre-funded in each pool contract; the owner cannot withdraw the staked token or the reward token from it.

Farms and staking pools are live on Soneium Minato testnet. Mainnet farms will be announced on @Sonevibe with their emission schedule before launch.

NFT market #

List ERC-721 and ERC-1155 NFTs at a fixed price and buy them in one transaction. Prices are set in an ERC-20 payment token per network, so buyers approve the token once and then call buyItem. Sellers can cancelListing at any time.

NetworkPayment tokenMarket feeCollectionsIndexer
Loading markets…

The market fee is deducted from the sale price and sent to the treasury; the seller receives the rest. Listing and cancelling are free apart from gas.

Tokens #

TokenRoleSupply
LIGHTFarm reward and ecosystem token. Mintable only by its owner (the MasterChef once farms go live), never above the max supply.Max 1,000,000,000
Minted:
SVUSDDollar stablecoin minted by facilitators (stability module and mintable market).
LP tokensYour share of a SoneVibe DEX pool, ERC-20, redeemable at any time.Per pool
cTokensYour deposit in a lending market, growing in value as interest accrues.Per market

At deployment 1,000,000 LIGHT (0.1% of max supply) were minted to the deployer for initial liquidity. Every future mint is visible on-chain.

Fees #

ActionFeeGoes to
Swap0.25%0.2083% liquidity providers · 0.0417% treasury
Wrap / unwrap0%—
Add / remove liquidity0%—
Supply / withdraw (lending)0%—
Borrow interestVariableSuppliers, minus the reserve factor
Liquidation bonusLiquidator (paid from the liquidated collateral)
SVUSD mint / redeem (PSM) / Treasury
SVUSD borrow interestVariableTreasury
NFT saleTreasury (paid by seller from the sale price)

Gas is paid to the network, not to SoneVibe.

Contracts #

Generated from the same configuration the app uses, so this list is always in sync. Open any address on the explorer or copy it.

ContractAddress
Loading contracts…

Security & admin controls #

Good DeFi protocols tell you exactly who can change what. This section is read live from the contracts.

RoleControlled byTypeCan do
Reading admin roles…

Design protections

  • Donation-proof lending accounting with internalCash.
  • Reentrancy guards on farms, staking pools and the NFT market.
  • Bucket caps limit how much SVUSD each facilitator can mint, and the stability module has a USDC reserve cap.
  • Hard cap of 1B LIGHT enforced in the token contract.
  • Emergency withdraw in farms and staking pools always returns your deposit.

Audits

No third-party audit report has been published yet. Contracts are verified on the block explorers so anyone can read the code. Audit reports will be linked here when available.

Found a vulnerability? Contact @Sonevibe by direct message before disclosing publicly.

Risks #

  • Smart-contract risk. Bugs can lead to loss of funds, even in forks of well-tested code.
  • Admin risk. The roles listed in Security can change parameters. Check who controls them.
  • Oracle risk. A wrong price can cause unfair liquidations or bad debt.
  • Liquidation risk. Borrowers can lose part of their collateral if their health factor drops below 1.0.
  • Impermanent loss. Liquidity providers can end up with less value than holding.
  • Low-liquidity pools. Small pools have high price impact and can be moved by a single trade.
  • Stablecoin risk. SVUSD and USDC can lose their peg.
  • Bridge and network risk. Assets bridged between chains depend on the bridge's security; networks can halt or reorganize.

Nothing on this site is financial advice. Only deposit what you can afford to lose.

FAQ #

Why is my swap failing with "slippage"?

The price moved more than your slippage tolerance between quoting and mining. Try a smaller amount, or raise tolerance to 1% for volatile or thin pools. Be careful with 5% — it leaves room for front-running.

Do I need to claim or compound LP fees?

No. Swap fees stay in the pool and increase the value of your LP tokens automatically. You receive them when you remove liquidity.

Why does the APR change every day?

It is based on the last 7 days of real swap volume divided by the liquidity in the pool. More volume or less liquidity means higher APR, and the reverse.

What happens if my health factor drops below 1?

Your position becomes liquidatable. A liquidator repays up to half of your debt and receives the same value of your collateral plus a 10% bonus. Add collateral or repay debt to raise your health factor.

Is SoneVibe on BNB Chain the same protocol?

Yes. The same DEX contracts are deployed on BNB Chain, controlled by the same team. Lending, SVUSD and the NFT market are currently on Soneium (and NFTs also on Astar).

How do I revoke token approvals?

Use your wallet's permissions page or the token-approval tool on Blockscout / BscScan and revoke the router, market or pool contract you approved.

© 2026 SoneVibe · Docs are updated with every protocol change. HomeAnalyticsGitHubX · @SonevibeX · @Real_Dennis_S_FTelegram