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

# Gateway Overview

> Introduction to BOB Gateway - the best swaps engine for native BTC

## Why Gateway?

Gateway is the cheapest and easiest way to integrate native BTC swaps into your app, wallet, or aggregator.

Integrate once via the SDK or API to offer your users best-in-market prices for native BTC swaps — across stablecoins, tokenized gold, wBTC, and more — without building or maintaining swap infrastructure. Gateway handles routing, solver liquidity, on-chain verification, and cross-chain settlement. You earn configurable revenue on every swap. No custody at any point.

The market opportunity is significant. BTC↔stablecoin is the single largest trading pair in crypto — accounting for 90% of all BTC swap volume. But almost all of it still flows through centralised exchanges, because competitive onchain infrastructure for native BTC hasn't existed until now. Gateway closes that gap.

## What is BOB Gateway?

BOB Gateway is a permissionless, intents- and RFQ-based protocol for native BTC swaps and 1-click BTCFi.

It is currently offers the cheapest rates for BTC↔stablecoin (USDT, USDC), BTC↔wBTC swaps, and BTC↔tokenized gold swaps for all the most popular trade sizes — helping drive higher conversion rates for integrators.

<CardGroup cols={2}>
  <Card title="Integration Guide" icon="code" href="/gateway/integration">
    Get started with the SDK and integrate Gateway into your app
  </Card>

  <Card title="Routes & Assets" icon="layer-group" href="/gateway/supported-routes">
    See all available routes and assets
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/overview">
    Explore the complete API documentation
  </Card>

  <Card title="Bitcoin Wallets" icon="wallet" href="/gateway/wallets">
    Learn how to integrate Bitcoin wallet support
  </Card>
</CardGroup>

## Key Features

<AccordionGroup>
  <Accordion icon="arrow-right-arrow-left" title="Best-in-Market Quotes">
    Gateway delivers the best prices for BTC↔stablecoin, wBTC and tokenized gold swaps. Better quotes mean higher conversion for your integration and more volume over time.
  </Accordion>

  <Accordion icon="coins" title="BTC↔EVM and EVM↔EVM support">
    One integration gives your users access to swaps across stablecoins (USDC, USDT), tokenized gold (XAUT, PAXG), ETH, wBTC. Call `getRoutes()` for the current full list of supported routes and assets.
  </Accordion>

  <Accordion icon="hand-holding-dollar" title="Configurable Revenue">
    Set a custom fee on every swap your integration processes. Gateway handles routing, execution, and settlement — you earn on volume without infrastructure overhead.
  </Accordion>

  <Accordion icon="shield-halved" title="Non-Custodial">
    Atomic cross-chain swaps and an on-chain Bitcoin Light Client mean neither your app nor BOB ever holds user funds. Solvers cannot claim Bitcoin without completing the swap. Users retain custody throughout.
  </Accordion>

  <Accordion icon="download" title="Simple Integration">
    SDK and API with white-label options. Minimal integration effort to support native Bitcoin wallets, hardware wallets (Ledger, Trezor, OneKey), and CEX-to-onchain flows via QR swap.
  </Accordion>
</AccordionGroup>

## How It Works

<Steps>
  <Step title="Quote Request">
    Your app calls the Gateway API with the user's desired swap — for example, BTC to USDT on Base. Gateway returns a quote with routing, fees, and estimated output.
  </Step>

  <Step title="Solver Locks Liquidity">
    A solver locks the output asset in a smart contract, committing to complete the swap before the user sends any Bitcoin.
  </Step>

  <Step title="User Sends the Asset">
    The user signs a single Bitcoin or EVM transaction. Gas on the destination chain is estimated upfront and deducted automatically.
  </Step>

  <Step title="On-Chain Verification">
    BOB's Bitcoin Light Client verifies the transaction on-chain and triggers settlement.
  </Step>

  <Step title="Asset Delivery">
    The user receives the target asset on the destination chain. Average completion time: 5–10 minutes.
  </Step>
</Steps>

## What You Can Build

<CardGroup cols={3}>
  <Card title="BTC ↔ Stablecoin Swaps" icon="arrow-right-arrow-left">
    Add best-in-market BTC to USDT and USDC swaps. The #1 BTC use case by trading volume.
  </Card>

  <Card title="BTC ↔ Tokenized Gold" icon="coins">
    Enable native BTC swaps into Tether Gold (XAUT) and PAX Gold (PAXG) on Ethereum.
  </Card>

  <Card title="BTC ↔ wBTC" icon="arrows-split-up-and-left">
    Offer wBTC delivery via a single native BTC transaction.
  </Card>

  <Card title="Staking Flows" icon="layer-group">
    Let users move from native BTC into staked BTC LSTs and yield positions in one transaction.
  </Card>

  <Card title="Lending Integrations" icon="hand-holding-dollar">
    Deposit native BTC directly into lending protocols without intermediate steps.
  </Card>

  <Card title="Custom BTC Workflows" icon="wand-magic-sparkles">
    Build any BTC-native flow via the open API — from DeFi positions to bespoke routing logic.
  </Card>
</CardGroup>

## Ready to Build?

<Card title="Start Integration" icon="rocket" href="/gateway/integration" horizontal>
  Follow our step-by-step integration guide to add Gateway to your app
</Card>