Documentation

VEILO

Privacy-first token transfers on Solana. Send assets without a trace.

01

Introduction

Veilo is a complete privacy ecosystem on Solana that enables private transactions through zero-knowledge proofs. The platform consists of four components working together: an on-chain program, an off-chain relayer, a funding dApp, and a browser extension wallet for shielded transfers.

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 Wallet

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

Anonymous Transactions

Transactions submitted through relayers. Your wallet never signs on-chain, preserving your identity.

Funding dApp

Deposit SOL and SPL tokens into privacy pools. Send funds privately to any Veilo username.

Secure & Non-Custodial

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

02

Getting Started

Veilo provides two main user experiences: the Funding dApp for deposits and the Browser Extension for managing shielded balances and private transfers.

1. Create Account & Install Extension

Choose a unique username (e.g., @alice). Set a password to secure your wallet. Your recovery phrase is stored locally and encrypted — only you have access.

💡 Your username is how others can send you private payments.

2. Deposit via Funding dApp

Connect your Solana wallet, enter recipient username and amount. Funds are deposited to the privacy pool and the recipient receives a notification in their extension. Only they can access the funds.

3. Private Transfers via Extension

Your shielded balance appears in the extension. Send to other Veilo users instantly using their username. Completely private — no link between sender and receiver on the blockchain.

⚡ Transfers are instant and private. Withdraw to any wallet when ready.

03

How It Works

Veilo's architecture consists of several core components working together to provide cryptographic privacy on Solana.

Ecosystem Architecture

Funding dApp

Deposits

Extension Wallet

Shielded Balance

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 for deposits. Connect public wallet, enter recipient username, generate proof, deposit to pool. Sends encrypted note to recipient.

Browser Extension

Shielded wallet: manage private balances, send to usernames (e.g., @alice), generate proofs locally, withdraw to public addresses. Non-custodial.

Transaction Flow

01

Deposit

Funds move from your public wallet into the privacy pool. Recipient is notified in their extension.

02

Receive

Funds appear in recipient's shielded balance. Only they can access or move the funds.

03

Transfer

Send to another Veilo user by username. Instant and completely private.

04

Withdraw

Move funds to any public Solana address. Breaks all connection to the original deposit.

04

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.

05

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.

Relayer Network

Gas-less withdrawals for enhanced anonymity. No need to have SOL in your receiving wallet.

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.

06

API Reference

Veilo provides simple interfaces for private transactions. All cryptographic complexity is abstracted away.

Core Operations

Deposit

Transfer tokens from your public wallet to the privacy pool. A commitment is created and stored on-chain.

Private Transfer

Send to another Veilo user by username. Proof generated locally, submitted via relayer. Instant and private.

Withdraw

Unshield funds to any public Solana address. Breaks the link between deposit and withdrawal.

Relayer Submit

Transactions submitted by relayer on your behalf. Your wallet never signs on-chain, preserving anonymity.

How Withdrawals Work

1

Your extension selects notes from your shielded balance

2

A zero-knowledge proof is generated locally (10-20 seconds)

3

Proof is sent to the relayer, which verifies and submits on-chain

4

Program verifies proof, marks notes as spent, releases funds to recipient

Privacy Guarantee

The relayer submits your transaction but cannot link your identity to the withdrawal. All sensitive data is encrypted and only you hold the keys.

07

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.