veillabs-python-sdk 0.3.0

Veil Labs Python SDK for private market data, swaps, and transfers.

Veil Labs Python SDK

The official Python SDK for Veil Labs, a privacy-first platform providing anonymous swaps (Private Swap), multi-destination distributions (Private Seed), and secure proxy transfers across multiple blockchain networks.

---

🚀 Features

• Private Swaps: Securely exchange tokens with built-in privacy.
• Private Seed Distribution: Distribute assets to multiple destination addresses in a single privacy-preserving transaction.
• Proxy Transfers: Anonymize your transfers via secure proxy nodes.
• Market Intelligence: Real-time access to supported currencies, pairs, and price estimates.
• Dual Support: Native support for both Synchronous and Asynchronous (asyncio) workflows.
• Type-Safe Models: Fully powered by Pydantic for robust data validation and IDE autocompletion.

---

📦 Installation

Install the SDK using pip:

pip install veillabs-python-sdk

Or using uv (recommended for modern workflows):

uv add veillabs-python-sdk

---

🏃 Quick Start

Synchronous Client

Ideal for scripts and quick automation tasks.

from veillabs import VeilLabsClient

# Connect using the synchronous client
with VeilLabsClient() as client:
    # 1. Fetch available currencies
    currencies = client.market.get_currencies()
    print(f"Supported Currencies: {len(currencies)}")

    # 2. Get an exchange estimate
    estimate = client.market.get_estimate({
        "ticker_from": "eth",
        "ticker_to": "usdc",
        "amount": "1.0",
        "network_from": "mainnet",
        "network_to": "mainnet"
    })
    print(f"1 ETH = {estimate.estimated_amount} USDC")

Asynchronous Client

Recommended for high-concurrency environments like web services (FastAPI, Django, etc.).

import asyncio
from veillabs import AsyncVeilLabsClient, SwapRequest

async def main():
    async with AsyncVeilLabsClient() as client:
        # Create a swap using a Pydantic model for full type safety
        req = SwapRequest(
            ticker_from="eth",
            ticker_to="usdt",
            amount="1.0",
            address_to="0x123...",
            network_from="mainnet",
            network_to="bsc"
        )
        swap = await client.swap.create(req)
        print(f"Swap created with ID: {swap.id}")

if __name__ == "__main__":
    asyncio.run(main())

---

🛠 Detailed Usage

1. Market Data (client.market)

Access real-time data about the platform's supported assets and trading pairs.

• get_currencies(): Retrieve list of all supported cryptocurrencies.
• get_pairs(ticker, net): Get valid trading destinations for a specific asset.
• get_estimate(params): Calculate real-time exchange rates. Accepts EstimateRequest or dict.
• get_ranges(params): Determine transaction limits. Accepts RangeRequest or dict.

2. Private Swaps (client.swap)

Initiate anonymous cross-chain or same-chain token exchanges.

from veillabs import SwapRequest

# Option A: Using the SwapRequest model (Recommended)
req = SwapRequest(
    ticker_from="eth",
    ticker_to="btc",
    amount="0.5",
    address_to="1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2",
    network_from="mainnet",
    network_to="mainnet"
)
swap = client.swap.create(req)

# Option B: Using a dictionary
swap = client.swap.create({
    "ticker_from": "eth",
    "ticker_to": "btc",
    ...
})

3. Private Seed Distribution (client.seed)

Distribute a fixed amount of cryptocurrency to multiple recipient addresses.

from veillabs import SeedRequest

seed = client.seed.create(SeedRequest(
    ticker_from="usdt",
    ticker_to="usdt",
    amount="1000",
    destinations=[
        {"address": "0x123...", "percentage": 50, "ticker": "usdt", "network": "bsc"},
        {"address": "0x456...", "percentage": 50, "ticker": "usdt", "network": "bsc"}
    ],
    network_from="bsc",
    network_to="bsc"
))

4. Proxy Transfers (client.transfer)

Move funds securely through the Veil Labs proxy nodes to obfuscate the transaction path.

• client.transfer.single(params): Secure transfer to one recipient.
• client.transfer.multi(params): Secure transfer to multiple recipients.

5. Unified Transaction Tracking (client.track)

Maintain full visibility of your transaction progress using the unified track method.

status = client.track("TRANSACTION_ID")
print(f"Current Status: {status.status}") # e.g., 'pending', 'completed'

---

📊 Models & Data Structures

The SDK uses Pydantic for both requests and responses, providing built-in validation and IDE autocompletion.

Request Models (Input)

Model	Purpose
EstimateRequest	Parameters for rate calculations.
SwapRequest	Parameters for creating a private swap.
SeedRequest	Parameters for asset distribution.
TransferRequest	Parameters for a single proxy transfer.

Response Models (Output)

Model	Purpose
Currency	Details about an asset (ticker, name, network, logo).
Pair	Details about available trading pairs.
Estimate	Rate and amount calculation results.
SwapResponse	Success response for new swaps.
TrackingResponse	Universal status check result.

---

🛡 Network & Error Handling

The SDK utilizes httpx and raises standard status exceptions for API errors.

import httpx
from veillabs import VeilLabsClient, EstimateRequest

try:
    with VeilLabsClient() as client:
        req = EstimateRequest(ticker_from="eth", ...)
        result = client.market.get_estimate(req)

except httpx.HTTPStatusError as e:
    print(f"API returned error: {e.response.status_code}")
except Exception as e:
    print(f"Connection error: {e}")

---

🔗 Links

• Official Website: veillabs.app
• GitHub Repository: Veillabsapp/veillabs-sdk-python
• PyPI Package: veillabs-python-sdk

---

📄 License

This SDK is open-source software licensed under the MIT License. See LICENSE for the full text.

---

Developed with privacy at its core by Veil Labs.