fix(bitcoin): add Signet support and network-aware OKX/Unisat connectors #5347
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…96-babylon-bug-signet-network-not-working-correctly-in-bitcoin
🦋 Changeset detectedLatest commit: c777d18 The changes in this PR will be included in the next version bump. This PR includes changesets to release 25 packages
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
|
The latest updates on your projects. Learn more about Vercel for GitHub.
10 Skipped Deployments
|
Copilot finished reviewing on behalf of
tomiir
November 12, 2025 11:08
Contributor
Visual Regression Test Results ✅ Passed✨ No visual changes detected Chromatic Build: https://www.chromatic.com/build?appId=6493191bf4b10fed8ca7353f&number=405 |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR adds Signet support to Bitcoin flows and makes connectors network-aware. It fixes issues where Signet network was not working correctly with OKX, by standardizing how caipNetworkId is passed through the connection flow.
Key changes:
- Extended type interfaces to accept optional
caipNetworkIdfor network-scoped operations - Refactored OKX connector to resolve wallet handles per network at call time rather than storing a single instance
- Updated adapters to pass
caipNetworkIdthrough connect and account retrieval flows
Reviewed Changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| packages/controllers/src/utils/TypeUtil.ts | Extended Provider.connect interface to accept optional caipNetworkId |
| packages/controllers/src/controllers/AdapterController/ChainAdapterBlueprint.ts | Added caipNetworkId to GetAccountsParams for network-scoped account retrieval |
| packages/appkit-utils/src/bitcoin/BitcoinTypesUtil.ts | Extended getAccountAddresses to accept optional caipNetworkId parameter |
| packages/adapters/bitcoin/src/connectors/UnisatConnector/index.ts | Added chainChanged event emission after network switch |
| packages/adapters/bitcoin/src/connectors/OKXConnector.ts | Major refactor: added Signet support, made connector network-aware with dynamic wallet resolution |
| packages/adapters/bitcoin/src/adapter.ts | Updated to pass caipNetworkId through connect/getAccounts calls and improved onChainChanged flow |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Contributor
📦 Bundle Size Check✅ All bundles are within size limits 📊 View detailed bundle sizes> @reown/[email protected] size /home/runner/work/appkit/appkit > size-limit |
tomiir
commented
Nov 12, 2025
enesozturk
reviewed
Nov 12, 2025
enesozturk
reviewed
Nov 12, 2025
magiziz
approved these changes
Nov 12, 2025
enesozturk
reviewed
Nov 12, 2025
enesozturk
reviewed
Nov 12, 2025
…ot-working-correctly-in-bitcoin
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Context
Addresses APKT-4196: Signet network was not working correctly in Bitcoin flows, particularly with OKX. This PR standardizes network awareness across connectors and adapters, adds Signet support, and fixes event emission and account fetching across networks.
What’s Changed
controllers
AdapterController/ChainAdapterBlueprint.tsGetAccountsParamswith optionalcaipNetworkIdto allow network-scoped account retrieval.utils/TypeUtil.tsProvider.connectto accept optional{ caipNetworkId, onUri }for network-aware connections.appkit-utils
bitcoin/BitcoinTypesUtil.tsBitcoinConnector.getAccountAddressesaccepts optional{ caipNetworkId }to fetch accounts for a specific network.adapters/bitcoin
adapter.tscaipNetworkIdwhen callingconnector.connectandgetAccountsto ensure correct network context.onChainChanged: resolve the chain, reconnect to obtainaddress, fetch accounts for that specificcaipNetworkId, update connection, then emitswitchNetworkwith the resolvedchain.id.connectors/UnisatConnectorswitchChain, find the chain and emitchainChangedwithchain.idfor consistent event semantics.connectors/OKXConnectorbitcoinSignet.caipNetworkIdtowindow.okxwallet.bitcoinSignet._connect(caipNetworkId)andconnect({ caipNetworkId? }).getWallet({ requestedCaipNetworkId })at call time.getAccountAddresses({ caipNetworkId? }): for Signet, returnselectedAccount; otherwise usegetAccounts+getPublicKey.sendTransferandsignPSBTnow resolve the wallet for the active/requested network before acting.switchNetwork: unbind current listeners and emitchainChangedwith the resolvedchain.id(OKX lacks a true switch RPC), relying on reconnect flow for actual wallet context.bitcoinSignetimport and mapping; extendwindow.okxwallettyping for Signet.getWalletto an instance method returning the wallet handle (not a new connector).Why
caipNetworkIdacross connect/account flows so adapters and connectors operate on the intended network.chainChangedandswitchNetworkare emitted with the correctchain.idand timing after state updates.Behavior Notes
caipNetworkIdinconnectandgetAccountAddresses. If ignored, they continue to work as before; implementing the hint enables correct multi-network behavior.selectedAccount.BitcoinAdapter.switchNetworknow awaits provider switching and relies on subsequent events to complete the flow; functional behavior unchanged for consumers.Breaking/Surface Changes
Provider.connect(params?: { caipNetworkId?: CaipNetworkId; onUri?: fn })BitcoinConnector.getAccountAddresses(params?: { caipNetworkId?: CaipNetworkId })caipNetworkIdto be multi-network correct.Type of change
Associated Issues
Closes APKT-4196
Checklist
Note
Adds Signet support and network-scoped connections for Bitcoin by passing
caipNetworkId, refactors OKX to resolve per-network wallets, standardizes events, and updates types; minor Solana connect optimization.packages/adapters/bitcoin/src/adapter.ts):caipNetworkIdtoconnector.connectandgetAccounts; short-circuit if already connected toparams.address.OKXConnectorvianew OKXConnector({ requestedChains, requestedCaipNetworkId }).onChainChanged: resolvechain, reconnect, fetch accounts withcaipNetworkId, update connection, emitswitchNetworkwithchain.id.packages/adapters/bitcoin/src/connectors/OKXConnector.ts):bitcoinSignet) and window typings; expose icon viawindow.okxwallet.cardano.icon.connect({ caipNetworkId? }),getAccountAddresses({ caipNetworkId? }),sendTransfer,signPSBTresolve wallet per network; for Signet, returnselectedAccount.getWallet(...), bind/unbind events per wallet;switchNetworkunbinds and emitschainChangedwith resolvedchain.id.packages/adapters/bitcoin/src/connectors/UnisatConnector/index.ts):switchChain, emitchainChangedwith resolvedchain.id; include Signet in chains.packages/appkit-utils/src/bitcoin/BitcoinTypesUtil.ts:BitcoinConnector.getAccountAddresses({ caipNetworkId? }).packages/controllers/src/utils/TypeUtil.ts:Provider.connect({ caipNetworkId?, onUri? }).packages/controllers/src/controllers/AdapterController/ChainAdapterBlueprint.ts: extendGetAccountsParamswithcaipNetworkId.packages/adapters/solana/src/client.ts: short-circuit connect path whenparams.addressmatches existing connection.chainChangedsemantics.@reown/appkit-adapter-bitcoin,@reown/appkit-utils,@reown/appkit-controllers.Written by Cursor Bugbot for commit c777d18. This will update automatically on new commits. Configure here.