Documentation

VEILO

All in one Privacy App on Solana.

01

Introduction

Veilo is a complete wallet ecosystem on Solana that supports both public and private transaction flows. The platform brings together a mobile wallet, a browser extension, a funding dApp, and core privacy infrastructure behind the scenes.

Break the chain, maintain your privacy. Veilo replaces address-based ownership with proof-based ownership, making transaction graph analysis impossible while maintaining full non-custodial control.

Shielded Wallets

Browser extension and mobile app with private balances. Transfer funds using usernames without revealing history.

Private Transaction Flows

When you use private actions, Veilo routes them through privacy-preserving flows designed to reduce on-chain linkability.

Funding dApp

Fund your public wallet quickly through the Funding dApp, then choose how you want to use funds next.

Multiple Wallets

Create and manage multiple wallets. Some support both private and public sections, while others are public-only.

Private Swap

Swap tokens directly inside your shielded wallet. Exchange assets without exposing your public address.

Mobile Wallet

Full-featured Android wallet app. Manage shielded balances, transfer, withdraw, and swap on the go.

Secure & Non-Custodial

Your keys, your crypto. Zero-knowledge cryptography ensures only you control your funds.

02

Getting Started

Veilo provides three user-facing products: the Mobile Wallet App (Android), the Browser Extension, and the Funding dApp. All three are interoperable and built around one account experience.

1. Create Your Wallet

Download the Veilo Wallet app (Android) or install the browser extension. Choose a unique username (e.g., @alice) and set a password. Your recovery phrase is stored locally, encrypted — only you have access.

Your username is how others send you private payments. It is not linked to your on-chain address.

2. Fund Your Public Wallet

Use the Funding dApp or send directly to your public wallet address to add funds. This is the default starting point. After funding, you can keep funds in public mode or move into private actions from inside Veilo.

3. Use Public or Private Actions

In the app or extension, choose the flow that matches your goal: public send, private transfer by username, private swap, or withdraw to a public address. Veilo shows clear review screens before you approve.

Start simple in public mode, then use private features when you need additional privacy.

03

How It Works

Veilo combines familiar wallet actions with privacy-focused flows. Most of the technical complexity is handled for you behind the scenes.

Ecosystem Architecture

Funding dApp

Deposits

Extension Wallet

Shielded Balance

Mobile Wallet

Android App

Relayer

Off-Chain

Privacy Program

On-Chain (Solana)

System Components

On-Chain Program

Smart contract on Solana that holds funds securely and verifies cryptographic proofs. Fully audited and non-custodial.

Relayer Server

Off-chain service that submits transactions on your behalf, breaking the link between your wallet and on-chain activity.

Funding dApp

Web interface to fund your public Veilo account. Once funds are available, you can use public actions or private actions from the app or extension.

Browser Extension

Desktop wallet with multiple-wallet support: private + public sections for privacy-enabled wallets, plus public-only wallets. Includes transfer, swap, withdraw, activity, and dApp approvals.

Mobile Wallet

Full Android wallet app with multiple wallets, public and private actions, in-app dApp browser, address book, notifications, and biometric unlock.

Transaction Flow

01

Fund Public Account

Start by funding your public Veilo wallet address through the Funding dApp or a regular transfer.

02

Choose Mode

Keep using public actions for normal transfers, or switch to private actions when you need stronger privacy.

03

Transfer

Send to another Veilo user by username through private transfer flows in mobile or extension.

04

Swap

Exchange tokens in private flows with clear quote and review screens before you confirm.

05

Withdraw or Send Publicly

Move funds to public addresses when needed, or continue using regular public sends for everyday transactions.

04

Wallet Experience

This section focuses on what you will actually see in Veilo day to day.

Wallet Types

Manage multiple wallets. Some include private + public sections, while others are public-only wallets.

Funding Flow

Fund your public wallet first using the Funding dApp or a regular transfer, then choose public or private actions.

dApp Approvals

Review connect, sign message, and sign transaction requests with clear approve/reject actions.

Connected dApps

See and manage connected apps anytime. Revoke access directly from wallet settings.

Address Book

Use recipient suggestions, recent contacts, favorites, and saved entries to reduce send mistakes.

Notifications & Activity

Track pending, submitted, completed, and failed operations so you always know transaction status.

Network & RPC

Switch between Mainnet and Devnet with clear warnings, and optionally set custom RPC endpoints.

Merge Notes

When prompted, merge notes to consolidate many small notes into fewer larger ones for smoother private actions.

Important Account Actions

Veilo includes account recovery, reset wallet, and account deletion flows. For account deletion details, visit Delete Account.

05

Markets & Trading

Beyond private payments, Veilo includes a full on-chain trading suite built right into the wallet. Trade tokenized stocks, perpetual futures, and prediction markets without leaving the app — all settled on Solana and powered by Jupiter.

Stocks (xStocks)

Buy and sell tokenized stocks, ETFs, and commodities — from Tesla and Apple to the S&P 500 and Gold — using USDC or USDT.

Perpetuals

Go long or short on SOL, ETH, and BTC with up to 100x leverage, with take-profit and stop-loss controls.

Prediction Markets

Take a Yes or No position on real-world events across crypto, sports, politics, and more.

How Trading Works in Veilo

Funded From Your Public Wallet

Trades use the public balance of your Veilo wallet — fund it first, then buy stocks, open positions, or place predictions.

Powered by Jupiter

Stocks route through Jupiter swaps, perps through Jupiter Perpetuals, and predictions through Jupiter's prediction markets.

Non-Custodial

You sign every trade from your own keys. Veilo never takes custody of your assets or positions.

Right From the Home Screen

Stocks, Perps, and Predictions each have a preview on your dashboard — tap through to the full market any time.

Trading uses your public balance

Stocks, perps, and predictions are public on-chain activities that run on your public Veilo wallet — not your shielded private balance. They are currently available on Solana mainnet.

06

Stocks (xStocks)

Veilo lets you trade xStocks — real-world stocks, ETFs, and commodities tokenized on Solana. Each xStock is a token you hold in your own wallet whose price tracks the underlying asset, so you can get exposure to names like Tesla, Apple, NVIDIA, the S&P 500, or Gold with on-chain settlement.

Tokenized Equities

Trade dozens of popular stocks — Tesla, Apple, NVIDIA, Coinbase, MicroStrategy, Google, Meta, Microsoft, Amazon and more — plus newer names like SpaceX and Circle.

ETFs & Indices

Get broad exposure through tokenized ETFs such as the S&P 500 (SPYx), Nasdaq 100 (QQQx), Vanguard Total Market, and sector funds.

Commodities

Hold tokenized Gold (GLDx) and Silver (SLVx) alongside the rest of your portfolio.

Live Charts & Market Data

Every stock has a candlestick chart across multiple time ranges, plus market cap, liquidity, 24h volume, your holdings, and a live trade feed.

Buy & Sell With Stablecoins

Buy any xStock with USDC or USDT, and sell back to either — swaps are routed automatically for the best available price.

Watchlist & Filters

Browse by All, Popular, ETFs, Commodities, Top Gainers, or My Stocks, and star the assets you want to keep an eye on.

Buying or Selling a Stock

01

Open Stocks from your dashboard and tap any asset to see its live price, chart, and details.

02

Choose Buy or Sell, pick USDC or USDT, and enter an amount (or tap MAX).

03

Review the amount you'll receive, then slide to confirm. The stock token settles directly into your wallet.

Self-custodial, always

You hold xStock tokens in your own wallet and control your private keys. A small swap fee applies and is reflected in your quote before you confirm. Occasionally an asset's sell liquidity is limited — Veilo shows a clear note when that happens.

07

Perpetuals

Perpetuals (perps) let you trade price movements on SOL, ETH, and BTC with leverage — going long if you think a market will rise, or short if you think it will fall. Veilo's perps are powered by Jupiter Perpetuals, trading against its on-chain liquidity pool.

Long or Short

Open a long to profit when a market rises, or a short to profit when it falls. Longs are backed by the asset itself; shorts by USDC or USDT.

Adjustable Leverage

Scale your position size with leverage from 1.1x up to 100x, with quick presets at 2x, 5x, 10x, 25x, 50x, and 100x.

Take Profit & Stop Loss

Attach optional TP and SL triggers when you open a position so it can close automatically at your chosen prices.

SOL, ETH & BTC Markets

Trade the three core crypto markets against USD, each with a live price and candlestick chart.

Clear Order Preview

Before you confirm, see your entry price, position size, estimated liquidation price, and the open fee.

Manage Your Positions

Track everything under Positions, Open Orders, and History — close part or all of a position, or update its TP/SL at any time.

Opening a Position

01

Open Perps, pick a market (SOL, ETH, or BTC), and choose Long or Short.

02

Enter how much you want to pay, set your leverage, and optionally add take-profit and stop-loss prices.

03

Review the order preview and slide to confirm. Your order is executed on-chain, and the position appears under Positions once it's filled.

Leverage increases risk

Higher leverage amplifies both gains and losses and brings your liquidation price closer to the current price — if the market moves against you past that level, the position can be liquidated. Only trade with funds you can afford to lose, and consider using a stop loss.

08

Prediction Markets

Prediction markets let you take a Yes or No position on whether a real-world event will happen. Each share you buy pays out $1 if you're right and nothing if you're wrong — and the price you pay reflects the market's implied odds. Veilo's prediction markets are powered by Jupiter.

Yes / No Outcomes

Every market is a simple binary bet. Pick the side you believe in and buy shares in that outcome.

Price Equals Probability

Prices are shown in cents — a 65¢ Yes share means the market implies a 65% chance. Cheaper shares mean longer odds and bigger potential upside.

$1 Per Winning Share

Each share settles to $1 if your outcome wins. Your potential payout and number of shares are shown before you buy.

Many Categories

Browse markets across Crypto, Sports, Politics, Esports, Culture, Economics, and Tech.

Pay With USDC or JupUSD

Fund predictions with USDC or JupUSD. The minimum order is $5, and winnings are paid out automatically.

Sell Early or Claim

Exit a position any time by selling at the current price, or claim your payout once a market resolves in your favor.

Placing a Prediction

01

Open Predictions, choose a category, and tap an event to see its outcomes, chart, and rules.

02

Pick Yes or No, enter an amount (at least $5), and check the implied odds and projected payout.

03

Slide to confirm, then track it under My Positions — where you can sell early or claim your payout after the market resolves.

Payouts after resolution

When an event closes and a result is finalized, winning positions become claimable — payouts are typically available within about 24 hours of the market closing.

09

What Are Notes

When you hold a private balance in Veilo, that balance isn't a single number stored under your address. It's made up of individual notes — think of them like the cash bills in your wallet. Each note holds a hidden amount that only you can unlock and spend.

Like Digital Cash

Your private balance is a collection of notes, the same way the money in your wallet is a collection of bills and coins.

Only You Can Spend Them

Every note is encrypted and tied to your keys. No one else can see the amount or use it — not even Veilo.

Created When You Receive

Each time you receive a private payment, a new note is added to your wallet.

Used When You Send

Sending privately spends one or more notes and creates new ones — including a 'change' note back to you, just like paying with cash.

Why Veilo Merges Your Notes

Over time, lots of small notes pile up — for example, after receiving many small payments. Having too many tiny notes makes private actions slower and a little more expensive, because your wallet has to work through each one.

To keep things fast, Veilo can merge many small notes into fewer, larger ones. You may see an “Auto-Merge Notes” prompt when you open the app. Turning it on lets Veilo tidy up your notes quietly in the background. You can change this anytime in Settings.

You don't need to manage notes yourself

Veilo handles notes for you behind the scenes. You just send, receive, and swap as normal — notes are simply how your private balance works under the hood.

10

Stars & Rewards

Stars are Veilo's way of recognizing its most active users. The more you use Veilo, the more stars you collect. Your star count is a simple reflection of how active you've been across the wallet.

How to Earn Stars

You earn stars automatically when you use Veilo. Qualifying actions include:

Swaps

Earn stars each time you swap one token for another.

Transfers

Send funds to another Veilo user and collect stars for the activity.

Bridging

Move assets across networks and earn stars along the way.

Withdrawals & More

Withdrawals and other supported actions all add to your star count.

Where to Find Your Stars

01

Your current star count is shown in the star pill at the top of your wallet dashboard.

02

Tap the star pill to open your Activity screen, where you can see every action you've earned stars for.

03

Each entry shows what you did, when you did it, and how many stars it earned.

Stars are tracked per wallet

Each wallet keeps its own star count. Keep using Veilo and your stars will keep growing — there's nothing extra you need to do.

11

Referrals

Veilo's referral program gives you a personal in-app referral code you can share with friends. When someone joins Veilo using your code, you both become part of the same referral network — and you start earning from their activity.

What You Earn

A Share of Their Fees

Every time someone you invited makes a transaction, you earn a percentage of the fee on that transaction — automatically, for as long as they keep using Veilo.

More Stars

When the people you refer transact, it earns you stars too — adding to your own activity rewards on top of the fee share.

Unlocking Your Code

Your personal referral code unlocks once you've earned 50 stars. Just keep transacting on Veilo — swaps, transfers, withdrawals and other actions all earn stars (see Stars & Rewards). Until then, the Invite Friends screen shows your progress toward unlocking it.

Gating the code behind stars keeps the network made up of real, active users — and rewards you for being one.

Customizing & Sharing

01

Open Invite Friends from your wallet to see your code. Tap the copy icon to copy it, or Share invite link to send it through any app.

02

Want something memorable? Tap Edit to set a custom code — 4–12 characters, using letters and numbers (the easily-confused I, O, 0 and 1 are excluded).

03

You can invite up to 10 friends. The screen tracks how many invites you've used and how many you have left.

Tracking Your Invites

Everyone who joins with your code appears in your invite list, with a status that updates as they get started:

Pending

Your friend has joined with your code but hasn't completed the activity needed to fully qualify yet.

Completed

Your friend is fully onboarded and active — their transactions now earn you a fee share and stars.

How a Friend Joins With Your Code

When someone you invited sets up Veilo, they enter your referral code during onboarding (they can choose “Have a referral code? Use it instead” on the code screen). That links their account to yours, so your rewards start flowing as they use the app.

The more they use Veilo, the more you earn

There's nothing extra to claim — fee share and stars from your referrals are credited automatically. Share your code, invite active friends, and your rewards grow with them.

12

Security & Privacy

Veilo provides cryptographic privacy guarantees under specific threat models. Understand what is protected and what requires additional precautions.

Privacy Guarantees

Unlinkable Transactions

Deposits and withdrawals cannot be connected. No on-chain trail between sender and receiver.

Hidden Amounts

Transaction amounts are obscured within privacy pools. No amount-based correlation possible.

Timing Protection

Relayer network prevents timing analysis. Transactions are batched and delayed automatically.

Cryptographic Security

Industry-standard zero-knowledge proofs ensure mathematical guarantees of privacy.

Best Practices

01

Back Up Your Seed Phrase

Store your recovery phrase securely offline. This is your only way to recover funds.

02

Use Fresh Addresses

When withdrawing, use a new wallet address for maximum privacy.

03

Wait Before Withdrawing

Let your funds mix in the pool for stronger anonymity.

04

Verify Official Links

Always access Veilo through official channels to avoid phishing.

Tips for Maximum Privacy

For enhanced security, consider using a VPN when accessing Veilo, keep your device secure, and always verify you're on the official Veilo website before connecting your wallet.

13

Technology Stack

Built with battle-tested cryptographic primitives and Solana-native architecture for maximum security and performance.

Native SOL Support

Full privacy support for Solana's native token with low fees and fast transactions.

SPL Token Support

Privacy pools for popular tokens including USDC, USDT, and more.

Private Swap

Token swaps inside your shielded balance. No public address exposed during the exchange.

Mobile & Extension

Available as an Android app on Google Play and as a browser extension for desktop.

Relayer Network

Private actions can be submitted through relayer infrastructure to support privacy-focused transaction flows.

Low Fees

Competitive transaction fees with transparent pricing. No hidden costs.

Technical Stack

Solana Program

Smart contract built with Anchor framework. Secure, audited, and optimized for Solana.

Zero-Knowledge Proofs

Industry-standard ZK-SNARK technology for cryptographic privacy guarantees.

Client-Side Proofs

Proofs generated locally on your device. Private data never leaves your browser.

Merkle Trees

Cryptographic data structure for efficient proof-of-inclusion without revealing identity.

14

API Reference

Veilo gives you familiar wallet actions with clear review steps. You do not need to understand cryptography to use these features.

Core Operations

Deposit

Add funds to your public wallet through the Funding dApp or by sending to your public address.

Private Transfer

Send to another Veilo user by username with private transaction flows and confirmation steps.

Swap

Swap supported tokens with quote and review screens before submitting.

Withdraw

Move funds to a public Solana address when you need standard on-chain access.

Private Submission

Private actions can be routed through relayer infrastructure to support privacy-focused execution.

Private Withdraw Flow

1

Select token, destination address, and amount in your wallet

2

Review fees and confirmation details shown in the wallet

3

Approve and submit. Veilo processes the private withdraw flow and updates your activity feed.

4

Track the final status in Notifications and Activity.

User Control

You control when to use public actions versus private actions. Veilo always keeps review and confirmation steps visible before submission.

15

SDK

Coming Soon

Veilo SDK

Integrate private transactions into your dApp with our JavaScript/TypeScript SDK. Build privacy-preserving applications on Solana with just a few lines of code.

Planned Features

Easy Integration

Simple API for deposits, transfers, and withdrawals. Works with any Solana wallet adapter.

WASM Proof Generation

Client-side zero-knowledge proof generation using WebAssembly for browser compatibility.

TypeScript Support

Full TypeScript definitions for type-safe development and better IDE integration.

Relayer Integration

Built-in relayer selection and transaction submission for seamless privacy.

Preview

// Coming soon...
import { Veilo } from '@veilo/sdk'

const veilo = new Veilo(connection)

// Deposit to privacy pool
await veilo.deposit({
  recipient: '@alice',
  amount: 1.5,
  token: 'SOL'
})

Stay Updated

Follow us on Twitter/X for SDK release announcements and developer updates.