Documentation

Comprehensive guides and technical documentation for building on Xolium

Quick Start

Getting Started with Xolium

Xolium provides a Solana-native network utility layer that enables priority execution, adaptive liquidity routing, and infrastructure fee capture. This guide will help you integrate Xolium into your Solana applications.

1. Installation

npm install @xolium/sdk @solana/web3.js

2. Initialize Client

import { XoliumClient } from '@xolium/sdk'
import { Connection } from '@solana/web3.js'

const connection = new Connection('https://api.mainnet-beta.solana.com')
const client = new XoliumClient({ 
  connection,
  network: 'mainnet-beta',
  apiKey: process.env.XOLIUM_API_KEY // Optional
})

3. Execute Your First Transaction

const signature = await client.executePriorityTransaction({
  instructions: [/* your instructions */],
  priorityLevel: 'high',
  maxRetries: 3
})

View SDK Documentation

Core Concepts

Overview

Understanding Xolium's architecture and network utility model

Learn about the core components of Xolium's infrastructure layer, including execution credits, liquidity routing, and value accrual mechanisms.

Network Layers:

• Execution Layer: Priority transaction processing with MEV protection
• Routing Layer: Cross-DEX liquidity aggregation and optimization
• Settlement Layer: Fee capture and value redistribution

Read Architecture Guide →

Token Utility

How XOL powers the network and creates value

XOL serves as the utility token for network operations, fee payment, and value capture across the Xolium infrastructure.

Execution Credits

Burn XOL to obtain priority execution credits. 1 XOL = 100 credits. Credits are non-transferable and consumed per transaction.

Fee Capture & Buyback

25% of protocol fees used for XOL buyback and burn. Creates deflationary pressure and sustainable token economics.

Staking Rewards

Stake XOL for 7-365 days to earn yield from protocol revenue. APY ranges from 12-45% based on lock duration.

Governance Rights

Staked XOL grants voting power for protocol parameters, fee structures, and treasury allocation (Q3 2025).

Integration Guide

Step-by-step integration instructions for developers

Prerequisites

Node.js 18+, @solana/web3.js v1.87+, TypeScript 5.0+ (recommended)

Setup Steps

1. Install SDK and dependencies
2. Configure RPC endpoints and network
3. Initialize XoliumClient instance
4. Implement error handling and retry logic

Best Practices

Use connection pooling, implement exponential backoff, cache route calculations, monitor transaction status.

View SDK Docs

Security Model

Security architecture and risk management

Audit Status

Complete audits by OtterSec (Jan 2025) and Sec3 (Feb 2025). All critical findings resolved.

On-Chain Security

• Multi-signature treasury (3/5 threshold)
• Time-locked admin functions (48h delay)
• Emergency pause mechanism
• Rate limiting on withdrawals

Monitoring

24/7 monitoring with automated alerts, anomaly detection, and circuit breakers for unusual activity.

Bug Bounty

Active program on Immunefi with rewards up to $500,000 for critical vulnerabilities.

Advanced Topics

Transaction Priority Mechanisms

Priority Levels

LOW (1-5 credits)

Standard execution, 95th percentile confirmation time ~8s. Suitable for non-time-sensitive operations.

MEDIUM (6-15 credits)

Enhanced priority, 90th percentile confirmation time ~4s. Recommended for most DeFi operations.

HIGH (16-50 credits)

Premium execution, 80th percentile confirmation time ~2s. Ideal for arbitrage and time-sensitive trades.

ULTRA (51-100 credits)

Maximum priority with MEV protection, 70th percentile confirmation time ~1s. For critical, high-value transactions.

Dynamic Fee Adjustment

Xolium's smart fee engine automatically adjusts priority fees based on real-time network congestion, block production rates, and historical confirmation times to optimize for both cost and speed.

Liquidity Routing Algorithm

Multi-Hop Optimization

Xolium's routing engine evaluates up to 1000+ possible paths across major Solana DEXs (Raydium, Orca, Meteora, Phoenix) to find optimal execution routes. The algorithm considers:

• Pool liquidity depth and slippage curves
• Historical execution success rates
• Gas costs for multi-hop routes
• Real-time price impact simulation

Split Routing

For large trades, Xolium automatically splits orders across multiple pools to minimize price impact. Example: A 100K USDC → SOL swap might be split 60% Orca, 40% Raydium for optimal execution.

const route = await client.findOptimalRoute({
  inputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
  outputMint: 'So11111111111111111111111111111111111111112', // SOL
  amount: 100_000_000000, // 100K USDC
  slippageBps: 50, // 0.5% slippage tolerance
  options: {
    splitRoutes: true,
    maxHops: 3,
    excludeDexes: [] // Optional: exclude specific DEXs
  }
})

// Returns: { 
//   route: RouteInfo[], 
//   expectedOutput: bigint,
//   priceImpact: number,
//   executionSteps: Step[]
// }

Technical Reference

API Reference

Complete REST and WebSocket API documentation for real-time interaction with Xolium infrastructure.

POST /v1/execute

Submit priority transactions with execution guarantees

GET /v1/route

Calculate optimal swap routes across DEX aggregators

POST /v1/stake

Stake XOL tokens with lock period selection

GET /v1/analytics

Historical metrics, TVL, volume, and APY data

WS /v1/stream

Real-time transaction updates and network events

Rate Limits: 1000 req/min for authenticated, 100 req/min for public endpoints

Smart Contracts

On-chain program addresses and interaction specifications for direct integration.

Main Program

XoLmG7k1QfK3Jv9z6P2wN8cR4tY5uI6oH9jM3nK1pL2q

Staking Program

XoLsT9aK3bV2cW7eR5tY6uI8oP0mN1jK4qL5zX8hG3fD

Router Program

XoLrT3eR7tY9uI0pA1sD4fG6hJ8kL2qW5eR7tY9uI0pA

Key Instructions:

• ExecutePriority: Submit priority transaction
• Stake: Lock XOL for yield
• Unstake: Withdraw after lock period
• ClaimRewards: Harvest staking rewards
• Route: Execute optimized swap

Verified Source: All programs verified on Solana Explorer with reproducible builds