Page cover

System Architecture

Vestra Labs™ is built on a modular architecture that combines visual tooling, AI intent detection, and blockchain execution. This design makes it possible for both developers and non-technical users to interact with Solana efficiently.

High-Level Overview

flowchart TD
  U[User] --> F[Forge UI]
  U --> G[VestraGPT Chat]
  F --> A[API Gateway]
  G --> A
  A --> R[RPC Layer (Helius / QuickNode)]
  A --> D[Data Layer (Birdeye API, Pump.fun feeds)]
  R --> S[Solana Network]
  D --> S

Components

1. Frontend Layer

  • Vestra Forge UI → drag-and-drop contract builder with canvas graphs.

  • VestraGPT Chat → conversational interface for querying balances, swaps, and deployments.

  • Wallet Integration → Phantom, Solflare, and other Solana wallets via Sign-In With Solana (SIWS).

2. API Gateway

  • Routes all frontend actions (Forge builds, GPT prompts) into structured API calls.

  • Handles authentication (JWT for user endpoints, wallet signatures for sensitive actions).

  • Exposes REST + WebSocket endpoints for real-time logs, project sync, and job tracking.

3. Processing Layer

  • Forge Engine

    • Converts canvas JSON graphs into Anchor/Rust programs.

    • Runs code generation and validation (IDLs, schema, PDA constraints).

  • GPT Engine

    • Intent detection (balance, price, swap, governance).

    • Calls external RPCs/APIs and formats human-readable responses.

  • Simulation Engine

    • Provides dry-run execution of transactions.

    • Calculates compute units, rent, and balance diffs.

4. RPC Layer

  • Helius RPC → optimized Solana API provider.

  • QuickNode RPC → backup provider with load balancing.

  • All sensitive RPC calls routed server-side (never exposed to client).

5. Data Layer

  • Birdeye API → token prices, liquidity pools, trading history.

  • Pump.fun Feeds → memecoin launches, tickers, metadata.

  • Vestra Indexer (Planned) → in-house indexer for faster on-chain queries.

6. Deployment & Security

  • Programs compiled in sandboxed environments (AppArmor, seccomp).

  • Only whitelisted outbound traffic (crates.io, Solana RPCs).

  • Wallet authority required for deploys and upgrades.

  • Per-tenant encryption for generated IDLs and build artifacts.

7. Token Integration ($VST)

  • $VST used for premium API calls, advanced Forge modules, and governance.

  • Gateway enforces rate limits and feature access based on $VST balance or stake.

  • Governance layer planned for DAO-controlled roadmap evolution.

Data Flow Example: "Deploy a Token Mint"

  1. User adds SPL Token Mint in Forge.

  2. Forge → API Gateway → Canvas JSON.

  3. Engine validates → generates Anchor code → compiles.

  4. User signs deployment with Phantom.

  5. API Gateway → RPC Layer → Solana Network.

  6. On success → IDL stored → explorer link returned.

Data Flow Example: "Check Wallet Balance" (GPT)

  1. User types: “Show me the balance for wallet FAicX…”

  2. VestraGPT → API Gateway → Helius RPC.

  3. RPC returns parsed accounts.

  4. GPT Engine formats JSON → human-friendly reply.

PreviousProductsNextGetting Started