> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velumx.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Contract directory

# Contract Directory

VelumX maintains a minimal on-chain footprint. The only contract VelumX deploys is the reference paymaster for the VelumX DeFi frontend.

## Stacks Mainnet

| Contract                     | Address                                                             | Status    | Purpose                                |
| :--------------------------- | :------------------------------------------------------------------ | :-------- | :------------------------------------- |
| **VelumX DeFi Paymaster v1** | `SPKYNF473GQ1V0WWCF24TV7ZR1WYAKTC7AM8QGBW.velumx-defi-paymaster-v1` | 🟢 Active | Bitflow swaps + USDCx bridge reference |

### Deprecated Contracts

The following contracts are no longer used. They remain on-chain (Clarity contracts are immutable) but are not referenced by any active VelumX infrastructure.

| Contract               | Address                                                           | Status        |
| :--------------------- | :---------------------------------------------------------------- | :------------ |
| Universal Paymaster v5 | `SPKYNF473GQ1V0WWCF24TV7ZR1WYAKTC7AM8QGBW.universal-paymaster-v5` | 🔴 Deprecated |
| VelumX Registry v1     | `SPKYNF473GQ1V0WWCF24TV7ZR1WYAKTC7AM8QGBW.velumx-registry-v1`     | 🔴 Deprecated |
| VelumX Relayer v1      | `SPKYNF473GQ1V0WWCF24TV7ZR1WYAKTC7AM8QGBW.velumx-relayer-1`       | 🔴 Deprecated |
| VelumX Paymaster 1-1   | `SPKYNF473GQ1V0WWCF24TV7ZR1WYAKTC7AM8QGBW.velumx-paymaster-1-1`   | 🔴 Deprecated |

## Third-Party Contracts Used

### Bitflow StableSwap Pools

| Pool           | Contract                                                                 |
| :------------- | :----------------------------------------------------------------------- |
| STX / stSTX    | `SPQC38PW542EQJ5M11CR25P7BS1CA6QT4TBXGB3M.stableswap-stx-ststx-v-1-2`    |
| aeUSDC / sUSDT | `SPQC38PW542EQJ5M11CR25P7BS1CA6QT4TBXGB3M.stableswap-aeusdc-susdt-v-1-2` |
| USDA / aeUSDC  | `SPQC38PW542EQJ5M11CR25P7BS1CA6QT4TBXGB3M.stableswap-usda-aeusdc-v-1-4`  |
| aBTC / xBTC    | `SPQC38PW542EQJ5M11CR25P7BS1CA6QT4TBXGB3M.stableswap-abtc-xbtc-v-1-2`    |

### Bitflow Router Contracts

| Router                 | Contract                                                                           |
| :--------------------- | :--------------------------------------------------------------------------------- |
| STX/stSTX via ALEX     | `SPQC38PW542EQJ5M11CR25P7BS1CA6QT4TBXGB3M.router-stx-ststx-bitflow-alex-v-2-1`     |
| STX/stSTX via Velar    | `SPQC38PW542EQJ5M11CR25P7BS1CA6QT4TBXGB3M.router-stx-ststx-bitflow-velar-v-1-2`    |
| STX/stSTX via Arkadiko | `SPQC38PW542EQJ5M11CR25P7BS1CA6QT4TBXGB3M.router-stx-ststx-bitflow-arkadiko-v-1-1` |
| StableSwap/XYK         | `SPQC38PW542EQJ5M11CR25P7BS1CA6QT4TBXGB3M.router-stableswap-xyk-v-1-3`             |

### USDCx Bridge

| Contract | Address                                              |
| :------- | :--------------------------------------------------- |
| USDCx v1 | `SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx-v1` |

## Developer-Deployed Contracts

Developers who integrate USER\_PAYS deploy their own paymaster contracts. VelumX does not maintain a registry of these contracts — they are owned and operated entirely by the developer.

Use `velumx-defi-paymaster-v1` as your starting template. See [The Paymaster Pattern](/architecture/paymaster-pattern) for details.