Testnet live
Xelis Vault
XELISVault
Documentation

Everything you need to build on XELIS Vault

Guides for every participant, the full specifications, and the live contract reference. All documentation is open-source and versioned with the protocol repository.

Guides

CLI_GUIDE.md
01Install Genesix

Download the official XELIS wallet for Windows, Linux or macOS. Create a fresh testnet wallet — never reuse a mainnet seed.

02Get testnet funds

Claim XEL from the official faucet (faucet.xelis.io) for gas and collateral. VLT is distributed to contributors via Discord.

03Connect to the app

Open the app, click Connect, approve XELIS Vault in Genesix. Balances load from your wallet, every transaction needs your approval.

04Try the protocol

Open a vault (deposit XEL, borrow xUSD), swap on the PSM, and watch the oracle aggregate update live.

Specifications

Whitepaper

The complete protocol design: confidentiality model, ten-layer oracle security, governance, economics.

18/18 audit findings remediated
MIT licensed
10-layer oracle security
docs/WHITEPAPER.md

Tokenomics

VLT fixed supply of 10,000,000. No presale, no seed, no VC — 55% funds oracle rewards.

55% oracle rewards (halving)
10% chat relayers
5% founder 4y + 5% 10y
1% bug bounty (Immunefi)
docs/TOKENOMICS_v10.3.md

Miner Economics

Bitcoin-style emission: 0.43593 VLT per block, halving every 6,307,200 blocks (one year).

0.43593 VLT/block initial
Yearly halving, 10+ years
New miner boost up to +50%
Concentration penalty 0.3×–1.0×
docs/MINER_ECONOMICS.md

VaultChat

E2E messaging: HKDF key derivation, X25519 exchange, ChaCha20-Poly1305, on-chain Merkle anchoring.

<1 s P2P delivery
50 msg/user ring buffer
Ephemeral messages 2h–24h
Payment requests
docs/CHAT_GUIDE.md

Audit Reports

Controlled-disclosure audit of v11.3 (18 findings: 2 critical, 5 high, 8 medium, 3 low) fully remediated in v11.5.

18/18 findings closed
Reentrancy guards on all mutators
Two-step emergency withdraws
Cross-call access control
docs/AUDIT_v11.5_REMEDIATION.md

User Guide

Every flow from a user perspective: vaults, swaps, savings, mixer, chat, with CLI walkthroughs.

Vault cycle walkthroughs
FAQ with 30+ answers
Hardware wallet notes
Troubleshooting
docs/USER_GUIDE.md

Protocol Reference

Contracts
51
34 core deployed · 13 Phase 5+ brainstorming · 4 vault engine variants
Entry functions
966
739 wallet-invokable chunks across 35 compiled contracts
Deployment
v12R
Live since 2026-08-24 · registry-resolved addresses
Block time
5 s
XELIS BlockDAG · 8-digit atomic precision everywhere

Key links

Protocol repositoryENTRY_IDS.md (966 entries)Deployment state (v12R)Testnet explorerXELIS faucetGenesix walletDiscord communityROADMAP.mdBug bounty (Immunefi)

Recent versions

v12R-9PrivacyMixer v2 + relayer officiel2026-08-27 → 29
  • ·PrivacyMixer v2 (v12R-7): note + nullifier + shared pool — the v1 sender/recipient link is gone
  • ·The mixer now mixes XEL (native), in addition to xUSD and VLT — any amount
  • ·Official VaultChat relayer configured on-chain (v12R-8): relay.xelisvault.io, free tier 100 msgs/day
  • ·CLI v12R-9: rich dashboard, Relayer & Airdrop screens, balance guards on every spend flow
v12RFull redeployment (canonical)2026-08-22 → 24
  • ·Discovered critical VM behavior: mutating entries must return 0
  • ·VLT asset recreated with hard 10M cap (Mintable mode)
  • ·PSM reserve seeded, VaultSwap XEL/xUSD pool created, faucet refilled
  • ·Registry 19161543… — all contract upgrades resolve through it
v11.5Audit remediation re-applied (18/18)2026-08-21
  • ·All controlled-disclosure findings fixed (were reverted by a compile fix)
  • ·PrivacyMixer rewritten: per-user thresholds, auto-mix, 0.1% admin fee
  • ·PSM mint_split/burn chunk fixes, relayer bond enforcement (F-13)
v11.4Miner economy hardening2026-08-17
  • ·REP_START 3,000 — new miners start Warning, prove themselves
  • ·Warning multiplier 0.5× → 0.7×, Critical 0.25× → 0.4×
  • ·New miner boost: +50% / +30% / +10% by network size, 30 days

Ready to dive in?

Install the full CLI toolkit — wallet, miner, relayer and community CLI — in one line. Uninstall anytime with -- --uninstall.

curl -fsSL https://xelisvault.github.io/xelis-vault/install | bash
irm https://xelisvault.github.io/xelis-vault/install.ps1 | iex