logo
VELIXIRREPUTATION FINANCE
Velixir Documentation

Docs & Protocol Guide

A complete guide to the Velixir protocol — a reputation-powered lending system on Solana Devnet where digital trust is treated as real collateral.

01 — Overview

Your Reputation Is Your Collateral

Velixir is a DeFi protocol that redefines lending. Instead of relying solely on traditional over-collateralization, Velixir uses a verified Trust Score to increase borrowing power and capital efficiency. A strong reputation raises your effective liquidation threshold — it never triggers liquidation by itself.

02 — Quickstart

Getting Started

1
1

Connect Wallet

Connect Phantom or Solflare for real on-chain transactions on Solana Devnet. Other wallets run as a simulated session.

2
2

Fund Devnet SOL

Use the Airdrop button in the wallet menu or faucet.solana.com to get Devnet SOL for paying fees.

3
3

Build Reputation

Verify your credentials via ZK-Identity to raise your Trust Score, then borrow with lower collateral requirements.

03 — Trust Layer

Reputation Engine

Reputation Factor R = TrustScore / 1000. The Trust Score raises your Effective Liquidation Threshold (ELT) in a piecewise-linear way between the following anchors:

Score
≤ 300
ELT
85%
Score
500
ELT
93.6%
Score
700
ELT
102.1%
Score
850
ELT
108.6%
Score
1000
ELT
115.0%

Linear interpolation between the two nearest anchors (e.g. score 600 → 86%, score 925 → 91%). A higher Trust Score → higher ELT → greater borrow power & capital efficiency.

04 — Core Protocol

Lending & Borrow

Max Borrow Power

A 5% safety buffer below the liquidation line:

MaxBorrowLTV = ELT − 0.05
MaxBorrow = Collateral × MaxBorrowLTV

Example: Collateral $10,000 · Score 850 → ELT 90% → MaxBorrow $8,500.

Liquidation Rule

Liquidation occurs if and only if:

LTV > ELT  ⟺  BorrowHealth < 1.0

No other trigger exists. The Trust Score never causes liquidation directly.

05 — Risk Dashboard

Borrow Health Monitor

Market Health
1.60×

Baseline safety from Collateral × 0.80 ÷ Debt. Liquidates at the 1.0× line.

Reputation Health
85%

Borrowing strength from Trust Score & verified credentials (R = Score / 1000).

Borrow Health
2.17×

Headline metric: (Collateral × ELT) ÷ Debt. Collateral strengthened by reputation.

🟢 Healthy > 1.5×🟡 Warning 1.0–1.5×🔴 Risk < 1.0×$5,000 / $8,500 borrowed · $3,500 available · Effective LT 90%
06 — Trading

Market & Swap

The Market module provides Solana Devnet token trading with lightweight-charts and swap routing via Raydium SDK v2. Price feeds are fetched through an internal API route, with a mock fallback when the endpoint is blocked.

07 — Yield

Liquidity & Staking

Provide liquidity and stake assets to earn rewards while strengthening your on-chain reputation profile. Consistent staking activity contributes to your Trust Score, which in turn increases your borrow power in the Lending module.

08 — Under the Hood

ZK-Proof Architecture

Node-01

Off-Chain Credentials

FICO score, KYC hash, bank links, & Web3 wallet history.

Node-02

ZK Prover Client

Plonky2 builds the circuit to guarantee score validity privately.

Node-03

On-Chain Verifier

The Solana Devnet verifier program validates the ZK proof.

Node-04

Lending Protocol

ELT & LTV are recalibrated based on the verified score.

See the interactive ZK-Proof pipeline and circuit code inspector on the Project page.

Open System Architecture