Frequently Asked Questions
Who pays the gas fees?
Who pays the gas fees?
The Relayer estimates gas costs upfront and deducts them from the transaction. Users don’t need ETH on BOB to use Gateway.
What happens if my DeFi action fails?
What happens if my DeFi action fails?
Gateway automatically falls back to sending the wrapped BTC directly to the user’s EVM address. Always test thoroughly to avoid fallbacks.
Do I need Bitcoin wallet support?
Do I need Bitcoin wallet support?
Yes, your frontend needs Bitcoin wallet integration. See the wallet guide for implementation details.
Can I chain multiple protocols?
Can I chain multiple protocols?
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.
Security considerations?
Security considerations?
- Use SafeERC20 for token transfers
- Consider reentrancy protection
- Ensure proper access controls
- Test thoroughly on testnet
How does affiliate fee monetization work?
How does affiliate fee monetization work?
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.
How long do transactions take?
How long do transactions take?
Transaction time varies based on:
- Bitcoin network confirmation time (typically 10-60 minutes)
- Destination chain (cross-chain transactions take longer)
- Current network congestion
estimatedTxTime field with the expected duration.What happens if Bitcoin fees spike after I submit?
What happens if Bitcoin fees spike after I submit?
For offramp transactions, you can bump the transaction fee to speed up confirmation if Bitcoin network fees increase.
Can I cancel a transaction?
Can I cancel a transaction?
For offramp transactions, you can unlock an order if it gets stuck. This is irreversible - once unlocked, the order cannot be resumed.
What chains are supported?
What chains are supported?
Gateway supports:
- Bitcoin → BOB (mainnet)
- Bitcoin → Ethereum, Base, Arbitrum, Optimism (via LayerZero)
- BOB → Bitcoin (offramp)
getRoutes() for the complete list of available routes.Is Gateway audited?
Is Gateway audited?
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
What are the fees?
What are the fees?
Fees include:
- Protocol fee: Charged by Gateway (included in quote)
- Gas fees: Estimated and deducted upfront (no ETH required from users)
- Affiliate fees: Optional fees you set (if monetizing your integration)
- Bridge fees: For cross-chain transactions
Where can I get help?
Where can I get help?
- Discord: Join our community at discord.gg/gobob
- GitHub: Report issues at github.com/bob-collective/bob
- Documentation: Browse guides at docs.gobob.xyz