Non-custodial lending and credit protocol built natively on Soroban smart contracts.
Vaultex is an on-chain, non-custodial money market on Stellar. Deposit assets to earn yield. Supply collateral, borrow against it, repay with interest — governed by transparent Soroban smart contracts, with no custodians and no intermediaries.
Live on testnet: contract
CBAPGTVW3IUEIGUEE4JPB35GLBTBRMJS7ZBYO7H75CFSOONIPF4TGG7T
(USDV / XLM market).
Stellar users with idle USDC or XLM can only hold or trade. There is no native, trustless way to put assets to work or access short-term credit without handing custody to a centralized exchange. Vaultex fills that gap with a DeFi credit primitive built for Stellar's deep stablecoin liquidity.
SUPPLY Lenders deposit the borrow asset → receive pool shares that
appreciate as borrowers pay interest
COLLATERAL Borrowers post collateral
BORROW Borrowers draw the asset up to their LTV limit
REPAY Borrowers repay principal + interest (interest accrues to lenders)
LIQUIDATE Positions below the liquidation threshold can be liquidated for a bonus
For MVP simplicity the borrow and collateral assets are valued 1:1 (a stablecoin pair), so no price oracle is required. The contract is the source of truth; no admin can move user funds.
Web (Next.js) ──wallet-signed tx──► lending-pool (Soroban) ◄── reads
supply / borrow / repay UI shares · positions · linear interest · liquidation
See docs/architecture.md for the full design and trust model.
| Layer | Technology |
|---|---|
| Contract | Rust · Soroban SDK 22 · wasm32v1-none · constructor-set market |
| Client | Typed TS bindings (@vaultex/lending-client) |
| Web | Next.js (App Router) · Tailwind · TanStack Query · Wallets Kit |
| Tooling | pnpm workspace · GitHub Actions · Conventional Commits |
# Prerequisites: Node 20+, pnpm 9+, Rust, Stellar CLI, wasm32v1-none target
git clone https://github.com/thefifthdev/vaultex.git
cd vaultex
make setup
cp web/.env.example web/.env.local
make dev # web on :3000Connect Freighter (Testnet), supply liquidity or post collateral and borrow. Full
steps: docs/local-runbook.md.
| Path | Description |
|---|---|
contracts/lending-pool/ |
Soroban lending contract + 19 unit tests. |
packages/lending-client/ |
Generated typed contract bindings. |
web/ |
Next.js dashboard wired to testnet. |
docs/ |
Architecture, deployment, contract API, security. |
- Lending pool: deposit/withdraw shares, collateralized borrow/repay
- Linear interest accrual to lenders
- Liquidation of unhealthy positions with a bonus
- Testnet deployment + typed client + web dashboard
- Price oracle for non-stablecoin pairs — good first issues open
- Utilization-curve interest rate model (jump rate)
- Multi-asset markets & isolated pools
- Audit + mainnet launch
Vaultex participates in the Stellar Wave Program via
Drips. Pick up an issue labeled Stellar Wave
or good first issue to earn contributor rewards. Start with
CONTRIBUTING.md.
MIT — see LICENSE.