Skip to content

feat: add BOB Gateway BTC offramp action provider#983

Open
nud3l wants to merge 1 commit intocoinbase:mainfrom
bob-collective:feat/bob-gateway-action-provider
Open

feat: add BOB Gateway BTC offramp action provider#983
nud3l wants to merge 1 commit intocoinbase:mainfrom
bob-collective:feat/bob-gateway-action-provider

Conversation

@nud3l
Copy link

@nud3l nud3l commented Mar 5, 2026

Summary

  • Adds a new bob-gateway action provider that enables swapping EVM tokens to native BTC via BOB Gateway
  • Three actions: get_supported_routes (discover available tokens/chains), swap_to_btc (execute EVM-to-BTC swaps with balance checks, approval, and gateway registration), get_orders (check order status by ID or list all orders for the connected wallet)
  • Includes a GatewayClient wrapping all BOB Gateway REST API endpoints with timeout, size limits, and route caching
  • Dynamic source chain resolution from wallet network ID against the Gateway routes API
  • Slippage in basis points (default 300 = 3%, max 1000 = 10%)

Notes

  • The BTC recipient address is provided by the agent or user as an input parameter, since agentkit does not currently have BTC wallet support
  • Once agentkit adds BTC wallet support, we'd like to extend this provider with BTC-to-EVM onramping as well

Test plan

  • 44 unit tests covering action provider (22 tests) and gateway client (22 tests)
  • Schema validation tests for BTC address formats, amount strings, slippage bounds, and order ID
  • Error handling: insufficient balance, reverted transactions, registration failures, unsupported routes
  • TypeScript compiles with zero errors
  • Prettier formatting passes
  • Rebased on latest main with no conflicts

🤖 Generated with Claude Code

@nud3l nud3l requested a review from murrlincoln as a code owner March 5, 2026 19:22
@cb-heimdall
Copy link

cb-heimdall commented Mar 5, 2026

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@github-actions github-actions bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Mar 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants