Skip to main content

​
XYZ Bridge

The XYZ Bridge enables cross-chain transfers between Solana and XYZ Chain. It uses a Pool Bridge architecture with a custom Anchor program on Solana, ensuring proper custody and supply conservation across both chains.

​
How It Works

The bridge operates through a liquidity pool on Solana and the x/bridge module on XYZ Chain:
  • Deposit (Solana to XYZ Chain) — Lock tokens in the pool vault, mint equivalent tokens on XYZ Chain
  • Withdraw (XYZ Chain to Solana) — Burn tokens on XYZ Chain, release from pool vault on Solana
┌─────────────────────────────────────────────────────────┐
│                        SOLANA                            │
│                                                          │
│   xyz-bridge program (Anchor)                            │
│   ├── BridgePool (admin, relayer, vault, totals)         │
│   ├── UserAccount (owner, xyz_chain_address, tracking)   │
│   └── Pool vault (holds all deposited XYZ)               │
│                                                          │
└─────────────────────────────────────────────────────────┘
                            │
                     Relayer Service
                            │
┌─────────────────────────────────────────────────────────┐
│                       XYZ CHAIN                          │
│                                                          │
│   x/bridge module                                        │
│   ├── MsgMintFromBridge (relayer-controlled)             │
│   └── MsgBurnForBridgeOut (user-initiated)               │
│                                                          │
└─────────────────────────────────────────────────────────┘

​
Supply Conservation

The bridge maintains a strict invariant — no tokens are created or destroyed in transit: 
Solana Circulating + Pool Vault + XYZ Chain Supply = 1,000,000,000 XYZ
DirectionSolana CirculatingPool VaultXYZ Chain Supply
Before depositX00
After depositX - amount+amount+amount
After withdrawX + amount-amount-amount
The total across all three locations never changes.

​
Key Features

Self-Custody

Your tokens are held in an auditable on-chain pool vault, not a centralized treasury.

User-Initiated Burns

You sign your own burn transactions on XYZ Chain — the relayer cannot move your funds.

Rate Limiting

Governance-controlled limits prevent abuse: max 1M XYZ per transaction, 10 burns per block.

Finality Confirmation

The relayer waits for 32-slot finality on Solana before processing deposits.

​
Supported Wallets

ChainSupported Wallets
SolanaPhantom, Solflare, and other Solana Wallet Adapter-compatible wallets
XYZ ChainKeplr, Leap, XYZ Wallet

​
Next Steps

Deposit

Transfer tokens from Solana to XYZ Chain

Withdraw

Transfer tokens from XYZ Chain to Solana

Architecture

Technical deep-dive into the bridge system

Fees & Limits

Rate limits, minimums, and gas requirements