VexFi — Financial Infrastructure

VexFi is the protocol-level financial infrastructure layer of the Vexidus ecosystem. It unifies payments, trading, staking, custody, and natural-language portfolio management into a single interface, built entirely on Vexidus L1 primitives — no wrapped assets, no off-chain custody, no T+2 settlement.

VexFi is not a separate protocol. It is a purpose-built application layer that exposes the full power of IntentVM, VexiDEX, VSC-88 multi-sig, Dragonfly Stream, and the VNS name service through a clean API and SDK — making complex financial operations accessible with a single call.

---

What VexFi Provides

Capability	How It Works
Payments	Send VXS or any VSC token to a Vexidus address or .vex name. VNS resolution is automatic.
Trading	Spot swaps via VexiDEX AMM pools with TWAP-based price feeds.
Cross-chain settlement	Exit liquidity back to Solana, EVM chains, and others via Atomence — no reverse bridge required.
Staking and delegation	Stake VXS, delegate to validators, track rewards, and compound — all in one operation.
Multi-sig custody vaults	Create M-of-N vaults backed by VSC-88. Treasury management, team wallets, and enterprise custody.
Natural language intents	Express financial operations in plain language via IntentVM. One intent, one signature, atomic execution.
Synthetic assets	VSC-71 synthetic equities and perpetuals (coming soon) — oracle-priced, collateral-backed, self-custodial.
Portfolio management	Rebalance, DCA, conditional orders, and allocation targets expressed as intents.

---

SDK Overview

The VexFi SDK provides a typed interface for all financial operations. Install via npm:

npm install @vexidus/vexfi-sdk

Core Methods

import { VexFi } from '@vexidus/vexfi-sdk';

const vexfi = new VexFi({ rpc: 'https://api.vexfi.com' });

// Send payment — resolves .vex names automatically
await vexfi.pay({
  to: 'alice.vex',          // or a Vx address
  amount: '100',
  token: 'VXS',
});

// Get portfolio snapshot
const portfolio = await vexfi.portfolio({ address: 'Vx...' });

// Get a swap quote
const quote = await vexfi.quote({
  from: 'VXS',
  to: 'USDC',
  amount: '500',
});

// Execute a swap
await vexfi.swap({
  from: 'VXS',
  to: 'USDC',
  amount: '500',
  maxSlippage: 0.5,         // percent
});

// Settle cross-chain (Atomence)
await vexfi.settle({
  chain: 'solana',
  amount: '1000',
  token: 'VXS',
});

// Stake VXS
await vexfi.stake({
  validator: 'Vx...',
  amount: '10000',
});

// Delegate to a validator
await vexfi.delegate({
  validator: 'Vx...',
  amount: '5000',
});

// Create a multi-sig custody vault
await vexfi.createVault({
  signers: ['Vx...', 'Vx...', 'Vx...'],
  threshold: 2,             // M-of-N
  label: 'Team Treasury',
});

// Submit a natural language intent
await vexfi.intent({
  text: 'Rebalance my portfolio to 60% staked VXS and 40% USDC',
});

---

REST API

Base URL: https://api.vexfi.com

Endpoint	Method	Description
/v1/pay	POST	Send a payment (VNS-aware)
/v1/portfolio	GET	Portfolio snapshot for an address
/v1/market	GET	Market data — prices, volume, liquidity
/v1/quote	GET	Swap quote with price impact
/v1/swap	POST	Execute a spot swap
/v1/stake	POST	Stake or delegate VXS
/v1/custody	POST/GET	Create or query multi-sig vaults
/v1/intent	POST	Submit a natural language intent
/v1/prices	GET	Current and historical token prices

Example: Get a swap quote

curl "https://api.vexfi.com/v1/quote?from=VXS&to=USDC&amount=500"

{
  "from": "VXS",
  "to": "USDC",
  "inputAmount": "500",
  "outputAmount": "142.87",
  "priceImpact": "0.12%",
  "fee": "0.0003",
  "route": ["VXS/USDC"]
}

---

Real-Time Price Feed

VexFi exposes a WebSocket endpoint for real-time price updates:

wss://api.vexfi.com/v1/ws

const ws = new WebSocket('wss://api.vexfi.com/v1/ws');

ws.send(JSON.stringify({
  type: 'subscribe',
  pairs: ['VXS/USDC', 'VXS/USDT', 'BTC/VXS'],
}));

ws.onmessage = (event) => {
  const { pair, price, volume24h, timestamp } = JSON.parse(event.data);
  console.log(`${pair}: $${price}`);
};

Price data is TWAP-sourced from VexiDEX pools with external oracle integration planned for real-world asset feeds (equities, commodities, forex).

---

Synthetics and Perpetuals (Coming Soon)

VexFi will surface VSC-71 synthetic assets — tokenized equities, indices, and perpetual contracts — collateral-backed and oracle-priced, with self-custodial margin. Intent examples:

"Buy 10 AAPL with USDC"
"Open 5x long ETH perp with 100 USDC"
"DCA $200 weekly into my target allocation"

These are expressed as structured intents and executed atomically on-chain. No brokerage account. No counterparty custody. Instant settlement.

---

Key Links

Resource	URL
VexFi App	vexfi.com
API	api.vexfi.com
Wallet (VexSpark)	wallet.vexspark.com
IntentVM Guide	IntentVM Architecture
DEX (VexiDEX)	vexidex.com