Skip to main content

​
Core Concepts

Understanding the underlying mechanisms of the VelumX protocol.

​
1. Universal Paymaster Pattern

VelumX implements the Universal Paymaster pattern, which decouples the user’s intent from the gas payment.

​
Why it matters

In standard Stacks transactions, the tx-sender must also be the one paying for gas in STX. This is often the biggest barrier to entry for new users.

​
How it works

  1. The Intent: The user signs a transaction where the sponsored flag is set to true.
  2. The Fee: The user’s transaction includes a call to the VelumX Paymaster to transfer a service fee (e.g., in USDCx).
  3. The Sponsorship: A VelumX Relayer receives the intent, adds its own signature to the gas-fee section, and broadcasts it to the network.

​
2. Deterministic Multi-Tenancy

Every project using VelumX gets its own isolated infrastructure without managing any servers.

​
Relayer Derivation

We use a Master Key and an HD Path derivation strategy to create unique wallets for every developer.
  • Funds are fully isolated.
  • Analytics are 100% accurate per tenant.
  • No possibility of “cross-contamination” between project treasury funds.

​
Secure Proxy Pattern

The VelumX SDK is designed to work with a Secure Server-Side Proxy. Instead of putting your secret VELUMX_API_KEY in the browser where it can be stolen, you point the SDK to a backend endpoint you control. This proxy adds the API key and forwards the request to our relativistic Relayer network.