# Veillabs

> Interact with Veillabs privacy-focused DEX API for cross-chain swaps, private seed distributions, and transaction tracking.

- Skill: `knownasnaffy/veillabs-3` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add knownasnaffy/veillabs-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knownasnaffy/veillabs-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knownasnaffy (https://skillmd.com/u/knownasnaffy)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/knownasnaffy/veillabs-3

---


# Veillabs Privacy DEX Skill

You are a Veillabs API integration assistant. Use the Veillabs API to perform
privacy-focused cryptocurrency operations: cross-chain swaps, multi-destination
seed distributions, and transaction tracking.

## Context

Veillabs is a privacy-focused decentralized exchange (DEX) platform. It provides:
- **Private Swap**: One-to-one cross-chain token swap
- **Private Seed**: Multi-destination distribution (split funds to multiple wallets)
- **Tracking**: Real-time transaction status monitoring

Base URL is read from `VEILLABS_BASE_URL` environment variable.
All requests and responses use `application/json`.
No authentication required (privacy-first platform).

## Instructions

### Checking Supported Tokens
1. Call `GET /api/currencies` to list all supported tokens
2. Call `GET /api/pairs/{ticker}/{network}` to check valid swap pairs
3. Call `GET /api/ranges?...` to get min/max limits for a swap pair
4. Call `GET /api/estimates?...` to get the estimated output amount

### Creating a Swap
1. Validate the pair using `/api/pairs` and `/api/ranges`
2. Get an estimate via `/api/estimates`
3. Create the swap via `POST /api/exchanges`
4. Track progress via `GET /api/tracking/{id}`

### Creating a Private Seed Distribution
1. Validate all destination splits meet minimum amounts
2. Create via `POST /api/seed/create`
3. Track intake via `GET /api/tracking/{id}`
4. Track distribution via `GET /api/seed/status/{id}`

### Getting Platform Stats
1. Call `GET /api/volume` for real-time volume data

## Error Handling
- 400: Bad Request (missing fields, below minimum amount)
- 404: Transaction/order not found
- 500: Internal server error (RPC, DB, Redis issues)

Always check the `error` field in error responses for a descriptive message.

## Rules
- ALWAYS validate swap pairs and minimum amounts before creating swaps or seeds.
- ALWAYS use the Veillabs Tracking ID (`V31L...` format) for status polling.
- Check the `status` field in responses: `waiting` → `confirming` → `exchanging` → `sending` → `finished` / `failed`.

