Skip to main content

​
Frequently Asked Questions

The Relayer estimates gas costs upfront and deducts them from the transaction. Users don’t need ETH on BOB to use Gateway.
Gateway automatically falls back to sending the wrapped BTC directly to the user’s EVM address. Always test thoroughly to avoid fallbacks.
Yes, your frontend needs Bitcoin wallet integration. See the wallet guide for implementation details.
Yes! Custom strategies can interact with multiple protocols in sequence. For example: stake WBTC → get staked BTC → deposit in lending → send receipt tokens to user.
  • Use SafeERC20 for token transfers
  • Consider reentrancy protection
  • Ensure proper access controls
  • Test thoroughly on testnet
You can earn fees on every transaction which is linked to your affiliate ID. The fee is deducted from the user’s input amount and sent directly to you.
Transaction time varies based on:
  • Bitcoin network confirmation time (typically 10-60 minutes)
  • Destination chain (cross-chain transactions take longer)
  • Current network congestion
The quote response includes an estimatedTimeInSecs field with the expected duration.
For offramp transactions, you can bump the transaction fee to speed up confirmation if Bitcoin network fees increase.
For offramp transactions, you can unlock an order if it gets stuck. This is irreversible - once unlocked, the order cannot be resumed.
Gateway supports:
  • Bitcoin → BOB (mainnet)
  • Bitcoin → Ethereum, Base, Arbitrum, Optimism (via LayerZero)
  • BOB → Bitcoin (offramp)
Check getRoutes() for the complete list of available routes.
Yes, BOB Gateway has been audited by Pashov and Common Prefix. The protocol uses atomic cross-chain swaps verified by an on-chain Bitcoin Light Client, making it trustless between users and market makers.View audit reports: docs.gobob.xyz/docs/reference/audits
Fees include:
  • Protocol fees: Fees applied by the protocol for processing and routing the swaps. Currently fees are set to merely cover routing and gas costs, with 0 markup. In the future, the BOB DAO may vote to activate a fee markup. Then, collected revenues will go to the BOB DAO treasury.
  • Solver spread: Solvers compete to offer the best quotes, typically charging a spread of a few basis points (1-20bps on average depending on the route and Solver). BOB Gateway automatically picks the best quote for each swap.
  • Broker fees: Most wallets and web apps apply a “convenience” fee for processing swaps. These are deducted from the swapped amount, on-chain by the protocol smart contracts.
  • Gas costs: The gas costs of the destination chain are included in the swap processing fees. The gas costs of the source chain (the chain where the swap was initiated) are handled out-of-protocol by the wallet.
All fees are shown transparently in the quote response.

​
Still Have Questions?

Discord Community

Get help from the BOB team and community

GitHub Issues

Report bugs or request features

Integration Guide

Step-by-step integration instructions

API Reference

Complete API documentation