@usebutr/bitcoin 1.1.0 → 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,255 @@
+# @usebutr/bitcoin
+
+## 2.0.0
+
+### Major Changes
+
+- [#203](https://github.com/pedroapfilho/usebutr/pull/203) [`1263f86`](https://github.com/pedroapfilho/usebutr/commit/1263f8666afd43b4f7dbf8df1763709c3edf09d9) Thanks [@pedroapfilho](https://github.com/pedroapfilho)! - Adapters now say what they can do by having the method: `capabilities` is gone, and an optional method (`sendTx`, `signMessage`, `getBalance`, `switchChain`, …) exists only when it works for that wallet. No adapter returns a placeholder balance or a receipt that stays pending anymore.
+
+  - `sendTx(tx, { account, chain })` replaces `sendTx` and `sendTxToChain`, and `signMessage`, `signTransaction` and `getBalance` take options objects. `chain` is a `ChainBase`. An adapter either routes the call to that chain, switches the wallet to it, or rejects; none ignores it.
+  - An `account` the wallet does not expose now rejects instead of signing with the first account. `chain.name` is the chain's name, never the wallet's.
+  - `getAccounts()` resolves the active account first. `getAccount` and `switchAccount` are removed.
+  - `getSigner()` resolves a tagged `WalletSigner` (`eip1193`, `wallet-standard`, `walletconnect`, `ledger-*`, …), so it can be narrowed with `switch (signer.kind)` instead of cast.
+  - `createWalletManager(config, { initialState })` owns discovery, hydration and persistence, and works without React. `config.sources` replaces the `discovery`, `connectors` and `createConnector` props. `fromAdapters` registers WalletConnect, Ledger and hand-built adapters, which now also appear in `useDiscoveredWallets()`.
+  - `WalletManagerProvider` takes `config` and `initialState`. `useSigner(wallet)` and `useBalance(wallet, { token, account })` take the wallet entry itself, and id-taking hooks read the active wallet only when the id is omitted (`null` reads none). The hooks are `useWalletManager`, `useWalletState`, `useConnect`, `useWallet`, `useSelectedWallet` (now typed per platform), `useAccounts`, `useConnectionStatus`, `useIsHydrated`, `useIsReconnecting`, `useDiscoveredWallets`, `useConnectedWallets`, the `…ByPlatform` groupings, `useBalance` and `useSigner`.
+  - `manager.connect()` and `useConnect().connectAsync()` resolve the `ConnectedWallet` and reject with a `ConnectionError`, now an `Error` subclass with a `kind` and a new `WalletNotFound` kind. `useConnect().connect()` never rejects: the failure lands in its `error`.
+  - `WalletPersistence` is `load()` / `save(state)`, and `createWalletStorage` replaces `new WalletStorage`. Storage keys are unchanged.
+  - Chain registries (`EVM_CHAINS`, `SVM_CHAINS`, …, `CHAINS_BY_PLATFORM`) move to `@usebutr/core`, and `BITCOIN_CHAINS` gains `testnet4`. `@usebutr/wallets` loads every platform's signer kinds, so an app that imports only it can narrow `signer.kind`.
+  - `@usebutr/react` requires React 19, which its `use()` call already needed.
+  - WalletConnect requests on Solana, Sui and Bitcoin now carry their chain, so they no longer fall through to the first namespace in a multi-namespace session. Solana takes `SVM_CHAINS` chains and maps them to the genesis-hash ids WalletConnect sessions use.
+  - Ledger's Solana `signTransaction` returns the full signed transaction, Sui signs the intent message, and Bitcoin `signMessage` returns a BIP-137 signature.
+  - `@usebutr/testing`'s fake adapter resolves a `signer` you pass instead of registering a test-only signer kind.
+  - `setAccount` selects an exposed account without changing any account's chain. Unknown accounts are ignored; chain changes come from the adapter.
+  - WalletConnect EVM events use the namespace in `session_event`, including empty account lists that end the connection. Local chain switches still update the manager.
+  - Failed persistence saves wait for every key write to finish before reporting failure, so delayed writes cannot overwrite a later disconnect.
+  - `@usebutr/svm/transaction` provides the shared legacy/v0 signing codec used by Ledger and WalletConnect, with consistent layout and signature validation.
+
+  See the migration guide at https://docs.usebutr.com/migration.
+
+### Patch Changes
+
+- [#199](https://github.com/pedroapfilho/usebutr/pull/199) [`5d1f234`](https://github.com/pedroapfilho/usebutr/commit/5d1f23403263f7a1f8a48be061727972fe749b5f) Thanks [@pedroapfilho](https://github.com/pedroapfilho)! - Raise the zod dependency floor to 4.6.1.
+- Updated dependencies [[`1263f86`](https://github.com/pedroapfilho/usebutr/commit/1263f8666afd43b4f7dbf8df1763709c3edf09d9), [`5d1f234`](https://github.com/pedroapfilho/usebutr/commit/5d1f23403263f7a1f8a48be061727972fe749b5f)]:
+  - @usebutr/core@3.0.0
+  - @usebutr/wallet-standard-shared@2.0.0
+
+## 1.1.2
+
+### Patch Changes
+
+- Updated dependencies [[`bc5b58c`](https://github.com/pedroapfilho/usebutr/commit/bc5b58cd87601be38dbb77a14e16eaaa36e8f012), [`bc5b58c`](https://github.com/pedroapfilho/usebutr/commit/bc5b58cd87601be38dbb77a14e16eaaa36e8f012)]:
+  - @usebutr/wallet-standard-shared@1.0.0
+  - @usebutr/core@2.0.1
+
+## 1.1.1
+
+### Patch Changes
+
+- Updated dependencies [302ae4a]
+  - @usebutr/wallet-standard-shared@0.5.1
+
+## 1.1.0
+
+### Minor Changes
+
+- 9b1caa2: Correctness pass across the storage, hydration and connector layers. Several of
+  these change observable behaviour; the ones worth knowing about before upgrading:
+
+  **Breaking**
+
+  - `SuiWallet.signTransaction` now returns `{ bytes, signature }` instead of
+    `Uint8Array`. Sui's `executeTransactionBlock` needs both, and each connector
+    previously returned a different half, so the old value could not be broadcast
+    and a consumer could not tell which half they held. SVM and Bitcoin keep their
+    single-`Uint8Array` shape.
+  - `@usebutr/svm`'s `sendTx` returns the signature base58-encoded, matching the
+    WalletConnect namespace, the Ledger app, Solana explorers and
+    `getSignatureStatuses`. It previously returned base64.
+  - `@usebutr/sui`'s feature input types drop the `string` arm from
+    `transaction`; wallets only ever accepted the `toJSON()` form. Strings and BCS
+    bytes are now wrapped for you, so `sendTx` accepts strictly more than before.
+
+  **Behaviour fixes**
+
+  - `WalletStorage.setPool` and `removePoolEntry` could self-deadlock on a corrupt
+    pool payload, leaving `connectWallet` unresolved and every later pool write
+    jammed for the page's life. Both are fixed, and `readWalletSnapshot` now shares
+    one codec with `WalletStorage` so the server and client decodes cannot drift.
+  - A seeded (SSR) entry whose silent reconnect failed used to stay in the pool
+    backed by a placeholder connector forever, so `useSigner`/`useBalance`
+    reported an error and `useConnectionStatus` reported `"reconnecting"`
+    permanently. Those entries are now dropped.
+  - `useSigner` and `useBalance` stay `idle` for a wallet that is still
+    reconnecting instead of surfacing a placeholder rejection as `status: "error"`.
+  - `useConnectionStatus` lets a live `"connecting"`/`"error"` take precedence over
+    the derived `"reconnecting"`, so an in-flight attempt and a connection error
+    are no longer hidden. New `useIsReconnecting(connectorId?)` answers the
+    per-wallet question directly.
+  - A background restore no longer writes the connect-attempt status or steals
+    `activeConnectorId`, and a superseded `CONNECT_FAILED` no longer overwrites the
+    current attempt.
+  - An externally-disconnected connector is now torn down, not just dropped from
+    the pool, so a cached adapter is not reused while still holding a session.
+  - EVM: a malformed provider response is treated as absent rather than `""`, which
+    previously produced chain `eip155:0`, zero-length signatures, empty transaction
+    hashes and a confident `0 ETH`. `switchChain` gained the same-chain
+    short-circuit `sendTxToChain` already had.
+  - WalletConnect: accounts carry their own chain instead of all being stamped with
+    the active one, so a multi-chain session no longer returns a wrong-chain
+    address. One pairing now covers every configured namespace, the pairing URI
+    survives a reconnect, and concurrent connects share one pairing.
+  - Bitcoin: the sats-connect (Xverse) adapter honours `silent`, so a reload no
+    longer triggers an unsolicited approval prompt, and exposes the payment address
+    as its single account instead of also presenting the ordinals address as
+    spendable.
+  - Polkadot: the injected adapter actually delivers events to subscribers,
+    `switchChain` notifies like its Wallet Standard sibling, and chain resolution
+    prefers the mainnets rather than whatever the wallet listed first.
+  - Ledger: the device session is committed atomically, so a locked device no
+    longer leaves an open transport that reports itself connected, and concurrent
+    connects open one transport.
+  - SVM: `sendTxToChain` submits to the chain you asked for instead of the
+    adapter's current one, and rejects a chain the wallet does not advertise.
+  - `@usebutr/svm`'s `switchChain` capability now counts only `solana:` chains, so
+    a multi-namespace wallet no longer advertises a method that always throws.
+
+  **Testing**
+
+  - `createFakePersistence` is now the real `WalletStorage` over memory drivers
+    rather than a parallel implementation, so it inherits upsert semantics,
+    validation and JSON round-tripping. Two divergences are fixed as a result:
+    `setPool` upserts rather than replaces, and `clearAll` leaves the
+    user-disconnected flag alone.
+  - `createFakeConnectedWallet` rejects being given both an `adapter` and explicit
+    `addresses`/`accounts`, a combination whose halves could disagree.
+
+### Patch Changes
+
+- Updated dependencies [9b1caa2]
+  - @usebutr/wallet-standard-shared@0.5.0
+  - @usebutr/core@2.0.0
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [8ecaf89]
+  - @usebutr/core@1.1.0
+  - @usebutr/wallet-standard-shared@0.4.1
+
+## 1.0.0
+
+### Major Changes
+
+- f0a5116: **Breaking:** the `platform` field is gone from the `PlatformDiscoverer` type in `@usebutr/core`, and from the `evmDiscoverer`, `svmDiscoverer`, `suiDiscoverer`, `bitcoinDiscoverer` and `polkadotDiscoverer` objects that implement it. Nothing read it: the aggregator keys discoverers by `ChainPlatform` in its own registry, so the field only restated the key.
+
+  Migration: read the platform from the `KNOWN_DISCOVERERS` key in `@usebutr/wallets` (`Object.entries(KNOWN_DISCOVERERS)`), or from `adapter.chainPlatform` on a discovered adapter. Custom `PlatformDiscoverer` implementations must drop the `platform` property; keeping it is now an excess-property error.
+
+- f0a5116: **Breaking:** `slugify` is no longer exported from `@usebutr/svm`, `@usebutr/sui` or `@usebutr/bitcoin`. Each package exported a one-argument wrapper that only bound a platform prefix onto the canonical two-argument helper, so three names shadowed one implementation.
+
+  Migration: import `slugify` from `@usebutr/wallet-standard-shared` and pass the platform prefix as the first argument. `slugify(name)` from `@usebutr/svm` becomes `slugify("svm", name)`; the `@usebutr/sui` prefix is `"sui"` and the `@usebutr/bitcoin` prefix is `"btc"`. Adapter ids are byte-for-byte the same.
+
+### Patch Changes
+
+- 7887cf0: Resolve capabilities through `buildWalletCapabilities` from `@usebutr/wallet-standard-shared` instead of a per-package copy of the same object literal. Resolver names, input types and returned flags are unchanged. The injected Polkadot profile now derives its chain count from `POLKADOT_CHAINS_LIST` rather than asserting `switchChain: true` directly; the result is the same.
+- 7887cf0: Move each package's `discover*Adapters` function next to the adapter builder it wraps and drop the single-function `wallet-standard.ts` module. The functions are still exported from the package root under the same names; only an internal file boundary went away.
+- Updated dependencies [7887cf0]
+- Updated dependencies [7887cf0]
+- Updated dependencies [f0a5116]
+- Updated dependencies [f0a5116]
+- Updated dependencies [7887cf0]
+  - @usebutr/core@1.0.0
+  - @usebutr/wallet-standard-shared@0.4.0
+
+## 0.2.7
+
+### Patch Changes
+
+- efe4550: Share the session plumbing behind the Wallet Standard and WalletConnect CAIP adapters. `@usebutr/wallet-standard-shared` now exports `createWalletStandardCore`, which the Bitcoin, Polkadot, Sui and SVM adapters build on; the WalletConnect Bitcoin, Sui and SVM namespaces share an equivalent CAIP core. Every package's public API is unchanged. The one visible difference is a dev-console warning: a failed SVM disconnect now logs `[butr] SVM Wallet Standard disconnect threw:` instead of `[butr] Wallet Standard disconnect threw:`.
+- Updated dependencies [efe4550]
+- Updated dependencies [4467a5e]
+  - @usebutr/wallet-standard-shared@0.3.0
+  - @usebutr/core@0.5.0
+
+## 0.2.6
+
+### Patch Changes
+
+- 99eaef0: Restore guards that the type-aware lint pass narrowed away.
+
+  - `@usebutr/bitcoin`: the sats-connect `getAccounts` reader dropped its optional
+    chain on the RPC payload. The declared shape is an assertion over an untyped
+    bridge, so a wallet answering without a `result` threw a `TypeError` instead
+    of reporting no accounts.
+  - `@usebutr/walletconnect`: the Sui and Solana signing paths treated an
+    empty-string `transaction` / `transactionBytes` / `bytes` field as a real
+    value and decoded it to zero bytes. They now fall through to the signature
+    path (Sui `signPersonalMessage`) or the original message, matching the
+    previous truthiness checks.
+  - `@usebutr/ledger`: the unknown-platform rejection lost the platform name from
+    its message, which is the only detail that made the error actionable.
+
+- Updated dependencies [c1309ee]
+  - @usebutr/core@0.4.2
+  - @usebutr/wallet-standard-shared@0.2.6
+
+## 0.2.5
+
+### Patch Changes
+
+- 937dfae: Bump runtime dependency floors (`@wallet-standard/app` 1.1.1, `@ledgerhq/*` latest minors, `@walletconnect/universal-provider` 2.23.10) and modernize public type declarations from method signatures to property function types (oxlint `method-signature-style`). Type-level only — no runtime behavior change.
+- Updated dependencies [937dfae]
+  - @usebutr/core@0.4.1
+  - @usebutr/wallet-standard-shared@0.2.5
+
+## 0.2.4
+
+### Patch Changes
+
+- a46eecd: Ship unminified ESM so downstream bundlers (Vite/esbuild dep pre-bundling) process the package correctly; fixes a ReferenceError in consumer dev servers. The consuming app minifies once at its own build.
+- Updated dependencies [b5322ae]
+- Updated dependencies [d5f32c7]
+- Updated dependencies [a46eecd]
+- Updated dependencies [3f26776]
+  - @usebutr/core@0.4.0
+  - @usebutr/wallet-standard-shared@0.2.4
+
+## 0.2.3
+
+### Patch Changes
+
+- Updated dependencies [886ee1d]
+  - @usebutr/core@0.3.0
+  - @usebutr/wallet-standard-shared@0.2.3
+
+## 0.2.2
+
+### Patch Changes
+
+- Updated dependencies [db5d7e9]
+  - @usebutr/core@0.2.2
+  - @usebutr/wallet-standard-shared@0.2.2
+
+## 0.2.1
+
+### Patch Changes
+
+- f846e77: Wallet-announced icons are trimmed of surrounding whitespace on ingestion. Some wallets ship data-URI icons with a leading newline, which strict consumers reject — Next.js's `<Image>` throws because `src` must not start with a control character. `@usebutr/core` exports a `sanitizeIcon` helper; the EIP-6963 and Wallet Standard adapters apply it, and an all-whitespace icon now resolves to `undefined` rather than a blank string.
+- Updated dependencies [f846e77]
+  - @usebutr/core@0.2.1
+  - @usebutr/wallet-standard-shared@0.2.1
+
+## 0.2.0
+
+### Minor Changes
+
+- b77a477: Shared Wallet Standard protocol types (`WalletStandardWallet`, `WalletStandardWalletAccount`, `WalletStandardAppModule`, `WalletsApp`, `StandardConnectFeature`, `StandardDisconnectFeature`, `StandardEventsFeature`, `StandardEventsListener`) are imported from `@usebutr/wallet-standard-shared` directly — they are no longer re-exported from `@usebutr/svm`, `@usebutr/sui`, or `@usebutr/bitcoin`. Platform-specific feature shapes still ship from their own packages.
+
+  `@usebutr/svm` adapter ids are now platform-prefixed (`wallet-standard:svm-<slug>`), consistent with the `sui-` and `btc-` prefixes. `slugify` in `@usebutr/wallet-standard-shared` requires a non-empty platform prefix.
+
+### Patch Changes
+
+- Updated dependencies [b77a477]
+- Updated dependencies [b77a477]
+  - @usebutr/core@0.2.0
+  - @usebutr/wallet-standard-shared@0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pedro Filho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @usebutr/bitcoin
+
+Wallet Standard + injected (sats-connect / Unisat / OKX) wallet discovery and adapters for butr (Bitcoin).
+
+Part of [butr](https://www.usebutr.com), a multi-chain wallet discovery and
+connection-state library. Your application owns the picker UI and chain client.
+
+## Install
+
+```bash
+npm install @usebutr/react @usebutr/core @usebutr/bitcoin zustand @wallet-standard/app
+```
+
+React 19 is a peer dependency of the provider. Discovery does not render a connect modal; add your picker as the provider child. `@wallet-standard/app` is required for Wallet Standard discovery.
+
+## Usage
+
+```tsx
+import type { ReactNode } from "react";
+import type { WalletManagerConfig } from "@usebutr/core";
+import { discoverBitcoinAdapters } from "@usebutr/bitcoin";
+import { WalletManagerProvider } from "@usebutr/react";
+
+const config: WalletManagerConfig = { sources: [discoverBitcoinAdapters] };
+
+export const WalletProvider = ({ children }: { children: ReactNode }) => (
+  <WalletManagerProvider config={config}>{children}</WalletManagerProvider>
+);
+```
+
+`discoverInjectedBitcoinAdapter` covers wallets that never announce through
+Wallet Standard (`window.unisat`, `window.okxwallet.bitcoin`, Xverse's
+sats-connect provider, `window.btc`). `bitcoinDiscoverer` pairs both channels
+so the injected one stays quiet once Wallet Standard found a Bitcoin wallet;
+`autoDiscovery(["bitcoin"])` from `@usebutr/wallets` wires it for you.
+
+## Transactions
+
+A method exists only when the wallet can back it, so check before calling:
+
+```ts
+import { BITCOIN_CHAINS } from "@usebutr/core";
+
+if (wallet.connector.sendTx) {
+  const txid = await wallet.connector.sendTx(
+    { amount: 10_000n, recipient: "tb1q…" }, // satoshis
+    { account: wallet.account, chain: BITCOIN_CHAINS.testnet },
+  );
+}
+```
+
+- `sendTx(transfer, { account?, chain? })` asks the wallet to build, sign and
+  broadcast a transfer and resolves the txid.
+- `signTransaction(psbt, { account?, chain? })` signs PSBT bytes
+  (`psbt.toBuffer()`) without broadcasting them.
+- `signMessage(message, { account? })` signs a UTF-8 message.
+
+Wallet Standard wallets route `chain` per call and gain `switchChain` when they
+advertise more than one Bitcoin network. Injected wallets have one network for
+the whole wallet: they switch it before acting (Unisat through
+`switchNetwork`, Xverse through `wallet_changeNetwork`), or reject with a
+`ChainMismatch` `ConnectionError` when the provider cannot switch (OKX,
+`window.btc`). Unisat-style wallets sign with their active account only, and
+Xverse sends from its payment address only; any other `account` rejects.
+
+Balances and receipts need an Esplora or Electrum client, which butr does not
+ship, so these adapters define neither.
+
+## Signers
+
+`getSigner()` resolves the object the adapter drives, tagged by transport:
+
+```ts
+const signer = await wallet.connector.getSigner();
+switch (signer.kind) {
+  case "wallet-standard": // signer.wallet
+  case "unisat": // signer.provider, the UniSat-style provider
+  case "sats-connect": // signer.provider, Xverse's BitcoinProvider
+}
+```
+
+## Documentation
+
+- [Package reference](https://docs.usebutr.com/api/bitcoin)
+- [Getting started](https://docs.usebutr.com/getting-started/quickstart)
+- [Examples and source](https://github.com/pedroapfilho/usebutr)
+- [Report an issue](https://github.com/pedroapfilho/usebutr/issues)
+
+## License
+
+[MIT](./LICENSE), copyright 2026 Pedro Filho.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
+import { BitcoinAdapter, PlatformDiscoverer, WalletAdapter } from "@usebutr/core";
 import { WalletStandardWallet, WalletStandardWalletAccount } from "@usebutr/wallet-standard-shared";
-import { ChainBase, PlatformDiscoverer, WalletAdapter, WalletCapabilities } from "@usebutr/core";
 //#region src/wallet-standard-types.d.ts
 type BitcoinSignMessageInput = {
   account: WalletStandardWalletAccount;
@@ -11,6 +11,7 @@ type BitcoinSignMessageOutput = {
 };
 type BitcoinSignMessageFeature = {
   signMessage: (input: BitcoinSignMessageInput) => Promise<BitcoinSignMessageOutput>;
+  version?: string;
 };
 type BitcoinSignPsbtInput = {
   account: WalletStandardWalletAccount;
@@ -29,6 +30,7 @@ type BitcoinSignPsbtOutput = {
 };
 type BitcoinSignPsbtFeature = {
   signPsbt: (input: BitcoinSignPsbtInput) => Promise<BitcoinSignPsbtOutput>;
+  version?: string;
 };
 type BitcoinSendTransferInput = {
   account: WalletStandardWalletAccount;
@@ -42,92 +44,61 @@ type BitcoinSendTransferOutput = {
 };
 type BitcoinSendTransferFeature = {
   sendTransfer: (input: BitcoinSendTransferInput) => Promise<BitcoinSendTransferOutput>;
+  version?: string;
 };
 //#endregion
 //#region src/wallet-standard-adapter.d.ts
 /**
- * `sendTx` takes `{ amount, recipient }` for `bitcoin:sendTransfer` and
- * `signTransaction` takes raw PSBT bytes for `bitcoin:signPsbt`. Balance
- * and receipt reads would need an Esplora/Electrum client butr doesn't ship.
+ * `bitcoin:sendTransfer` backs `sendTx` and `bitcoin:signPsbt` backs
+ * `signTransaction`, both routing `options.chain` per call. Balance and
+ * receipt reads would need an Esplora/Electrum client butr doesn't ship.
  */
 declare const buildBitcoinAdapter: (wallet: WalletStandardWallet,
 /** Optional. Called with a function that pushes a synthetic
  *  `disconnected` event to all current subscribers. The discovery
  *  layer invokes it on Wallet Standard `unregister`. */
-registerDisconnector?: (emit: () => void) => void) => WalletAdapter | null;
+registerDisconnector?: (emit: () => void) => void) => BitcoinAdapter | null;
 /** Requires the optional `@wallet-standard/app` peer dep. */
 declare const discoverBitcoinAdapters: (onAdapter: (adapter: WalletAdapter) => void) => (() => void);
 //#endregion
-//#region src/chains.d.ts
-/**
- * CAIP-2 Bitcoin references are the first 8 bytes of each network's
- * genesis block hash, which is what wallets advertise in `wallet.chains`.
- * No major wallet exposes a switch-chain RPC, so chain stays local state.
- */
-declare const BITCOIN_CHAINS: {
-  readonly mainnet: {
-    readonly id: "bip122:000000000019d6689c085ae165831e93";
-    readonly name: "Bitcoin";
-    readonly namespace: "bip122";
-    readonly reference: "000000000019d6689c085ae165831e93";
-  };
-  readonly signet: {
-    readonly id: "bip122:00000008819873e925422c1ff0f99f7c";
-    readonly name: "Bitcoin Signet";
-    readonly namespace: "bip122";
-    readonly reference: "00000008819873e925422c1ff0f99f7c";
-  };
-  readonly testnet: {
-    readonly id: "bip122:000000000933ea01ad0ee984209779ba";
-    readonly name: "Bitcoin Testnet";
-    readonly namespace: "bip122";
-    readonly reference: "000000000933ea01ad0ee984209779ba";
-  };
-};
-declare const BITCOIN_CHAINS_LIST: ReadonlyArray<ChainBase>;
-//#endregion
-//#region src/capabilities.d.ts
-type BitcoinCapabilityInput = {
-  chainCount: number;
-  features: {
-    events: boolean;
-    sendTransfer: boolean;
-    signMessage: boolean;
-    signPsbt: boolean;
-  };
-};
-/**
- * `signIn` is false: there is no Sign-In-With-Bitcoin standard, and BIP-322
- * is message-signing oriented rather than auth. `sendTransfer` leaves UTXO
- * selection, fees and broadcast to the wallet; `signPsbt` is sign-only.
- */
-declare const resolveBitcoinCapabilities: (input: BitcoinCapabilityInput) => WalletCapabilities;
-//#endregion
 //#region src/injected/sats-connect.d.ts
 /** sats-connect (Xverse) shape; a JSON-RPC-ish `request(method, params)`. */
+type RpcValue = boolean | number | string | null | ReadonlyArray<RpcValue> | {
+  readonly [key: string]: RpcValue | undefined;
+};
 type SatsConnectProvider = {
-  request: (method: string, params?: Record<string, unknown>) => Promise<{
+  request: (method: string, params?: Readonly<Record<string, RpcValue>>) => Promise<{
     error?: {
       message: string;
     };
-    result?: unknown;
+    result?: RpcValue;
   }>;
 };
 //#endregion
 //#region src/injected/unisat.d.ts
+type UnisatNetwork = "livenet" | "mainnet" | "signet" | "testnet";
+/** The only networks UniSat's `switchNetwork` accepts. */
+type SwitchableNetwork = "livenet" | "testnet";
 /** UniSat-style provider: a single object on `window.unisat` with the
  *  same four methods every UniSat-derivative wallet exposes (UniSat
  *  itself, OKX Wallet's Bitcoin path at `window.okxwallet.bitcoin`). */
 type UnisatProvider = {
   getAccounts: () => Promise<ReadonlyArray<string>>;
-  getNetwork?: () => Promise<"livenet" | "mainnet" | "testnet" | "signet">;
-  on?: (event: "accountsChanged" | "networkChanged", listener: (...args: Array<unknown>) => void) => void;
+  getNetwork?: () => Promise<UnisatNetwork>;
+  on?: (event: "accountsChanged" | "networkChanged", listener: (...args: Array<UnisatEventValue>) => void) => void;
   pushPsbt?: (psbtHex: string) => Promise<string>;
-  removeListener?: (event: "accountsChanged" | "networkChanged", listener: (...args: Array<unknown>) => void) => void;
+  removeListener?: (event: "accountsChanged" | "networkChanged", listener: (...args: Array<UnisatEventValue>) => void) => void;
   requestAccounts: () => Promise<ReadonlyArray<string>>;
   sendBitcoin?: (recipient: string, amount: number) => Promise<string>;
   signMessage: (message: string, type?: "ecdsa" | "bip322-simple") => Promise<string>;
-  signPsbt: (psbtHex: string, options?: Record<string, unknown>) => Promise<string>;
+  signPsbt: (psbtHex: string, options?: UnisatSignPsbtOptions) => Promise<string>;
+  /** UniSat has it; OKX's `window.okxwallet.bitcoin` is pinned to mainnet. */
+  switchNetwork?: (network: SwitchableNetwork) => Promise<void>;
+};
+type UnisatEventItem = number | string | null;
+type UnisatEventValue = ReadonlyArray<UnisatEventItem> | string | undefined;
+type UnisatSignPsbtOptions = {
+  autoFinalized?: boolean;
 };
 //#endregion
 //#region src/injected/icon.d.ts
@@ -148,6 +119,18 @@ type InjectedHost = {
     BitcoinProvider?: SatsConnectProvider;
   };
 };
+declare global {
+  interface Window {
+    btc?: UnisatProvider;
+    okxwallet?: {
+      bitcoin?: UnisatProvider;
+    };
+    unisat?: UnisatProvider;
+    XverseProviders?: {
+      BitcoinProvider?: SatsConnectProvider;
+    };
+  }
+}
 type InjectedBitcoinDiscoveryOptions = {
   /** Suppresses emission when Wallet Standard discovery has already
    *  registered a Bitcoin adapter for the same browser session. */
@@ -175,29 +158,20 @@ declare const bitcoinDiscoverer: PlatformDiscoverer;
 //#endregion
 //#region src/signer-augmentation.d.ts
 /**
- * Bitcoin's signer surface is fragmented: `getSigner()` returns a
- * `WalletStandardWallet`, a UniSat-shaped provider, or a sats-connect
- * `BitcoinProvider` depending on which adapter discovered the wallet.
+ * The injected adapters hand back the raw provider they drive. Wallet
+ * Standard adapters register `"wallet-standard"` through
+ * `@usebutr/wallet-standard-shared`.
  */
-type UnisatLike = {
-  getAccounts: () => Promise<ReadonlyArray<string>>;
-  requestAccounts: () => Promise<ReadonlyArray<string>>;
-  signMessage: (message: string, type?: string) => Promise<string>;
-  signPsbt: (psbtHex: string, options?: Record<string, unknown>) => Promise<string>;
-};
-type SatsConnectLike = {
-  request: (method: string, params?: Record<string, unknown>) => Promise<{
-    error?: {
-      message: string;
-    };
-    result?: unknown;
-  }>;
-};
 declare module "@usebutr/core" {
-  interface SignerForPlatform {
-    bitcoin: SatsConnectLike | UnisatLike | WalletStandardWallet;
+  interface WalletSignerRegistry {
+    "sats-connect": {
+      provider: SatsConnectProvider;
+    };
+    unisat: {
+      provider: UnisatProvider;
+    };
   }
 }
 //#endregion
-export { BITCOIN_CHAINS, BITCOIN_CHAINS_LIST, type BitcoinCapabilityInput, type BitcoinSendTransferFeature, type BitcoinSendTransferInput, type BitcoinSendTransferOutput, type BitcoinSignMessageFeature, type BitcoinSignMessageInput, type BitcoinSignMessageOutput, type BitcoinSignPsbtFeature, type BitcoinSignPsbtInput, type BitcoinSignPsbtOutput, GENERIC_BITCOIN_ICON, type InjectedBitcoinDiscoveryOptions, bitcoinDiscoverer, buildBitcoinAdapter, discoverBitcoinAdapters, discoverInjectedBitcoinAdapter, resolveBitcoinCapabilities };
+export { type BitcoinSendTransferFeature, type BitcoinSendTransferInput, type BitcoinSendTransferOutput, type BitcoinSignMessageFeature, type BitcoinSignMessageInput, type BitcoinSignMessageOutput, type BitcoinSignPsbtFeature, type BitcoinSignPsbtInput, type BitcoinSignPsbtOutput, GENERIC_BITCOIN_ICON, type InjectedBitcoinDiscoveryOptions, bitcoinDiscoverer, buildBitcoinAdapter, discoverBitcoinAdapters, discoverInjectedBitcoinAdapter };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/wallet-standard-types.ts","../src/wallet-standard-adapter.ts","../src/chains.ts","../src/capabilities.ts","../src/injected/sats-connect.ts","../src/injected/unisat.ts","../src/injected/icon.ts","../src/injected/index.ts","../src/discoverer.ts","../src/signer-augmentation.ts"],"mappings":";;;KAQK;EACH,SAAS;EACT,SAAS;;KAGN;EACH,WAAW;EACX,eAAe;;KAGZ;EACH,cAAc,OAAO,4BAA4B,QAAQ;;KAGtD;EACH,SAAS;;EAET;;EAEA,MAAM;;;EAGN,aAAa;;KAGV;;;EAGH,YAAY;;KAGT;EACH,WAAW,OAAO,yBAAyB,QAAQ;;KAGhD;EACH,SAAS;EACT;EACA;EACA;;KAGG;;EAEH;;KAGG;EACH,eAAe,OAAO,6BAA6B,QAAQ;;;;;;;;;cC/BvD,sBACJ,QAAQ,sBAIR;;;;AAAA,wBAAwB,8BACvB;;cAyIG,0BAA2B,YAAY,SAAS;;;;;;;;cCjKhD;;;;;;;;;;;;;;;;;;;;cAqBA,qBAAqB,cAAc;;;KCzBpC;EACH;EACA;IACE;IACA;IACA;IACA;;;;;;;;cASE,6BAA8B,OAAO,2BAAyB;;;;KCT/D;EACH,UACE,gBACA,SAAS,4BACN;IAAU;MAAU;;IAAmB;;;;;;;;KCFzC;EACH,mBAAmB,QAAQ;EAC3B,mBAAmB;EACnB,MACE,6CACA,cAAc,MAAM;EAEtB,YAAY,oBAAoB;EAChC,kBACE,6CACA,cAAc,MAAM;EAEtB,uBAAuB,QAAQ;EAC/B,eAAe,mBAAmB,mBAAmB;EACrD,cAAc,iBAAiB,qCAAqC;EACpE,WAAW,iBAAiB,UAAU,4BAA4B;;;;;;;;cCtB9D;;;KCKD;EACH,MAAM;EACN;IAAc,UAAU;;EACxB,SAAS;EACT;IAAoB,kBAAkB;;;KAGnC;;;EAGH;;;EAGA;;EAEA,SAAS;;;;;;;cAqDL,iCACJ,YAAY,SAAS,wBACrB,UAAS;;;;;;;;cCrEL,mBAAmB;;;;;;;;KCHpB;EACH,mBAAmB,QAAQ;EAC3B,uBAAuB,QAAQ;EAC/B,cAAc,iBAAiB,kBAAkB;EACjD,WAAW,iBAAiB,UAAU,4BAA4B;;KAG/D;EACH,UACE,gBACA,SAAS,4BACN;IAAU;MAAU;;IAAmB;;;;YAKlC;IACR,SAAS,kBAAkB,aAAa"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/wallet-standard-types.ts","../src/wallet-standard-adapter.ts","../src/injected/sats-connect.ts","../src/injected/unisat.ts","../src/injected/icon.ts","../src/injected/index.ts","../src/discoverer.ts","../src/signer-augmentation.ts"],"mappings":";;;KAQK;EACH,SAAS;EACT,SAAS;;KAGN;EACH,WAAW;EACX,eAAe;;KAGZ;EACH,cAAc,OAAO,4BAA4B,QAAQ;EACzD;;KAGG;EACH,SAAS;;EAET;;EAEA,MAAM;;;EAGN,aAAa;;KAGV;;;EAGH,YAAY;;KAGT;EACH,WAAW,OAAO,yBAAyB,QAAQ;EACnD;;KAGG;EACH,SAAS;EACT;EACA;EACA;;KAGG;;EAEH;;KAGG;EACH,eAAe,OAAO,6BAA6B,QAAQ;EAC3D;;;;;;;;;cChCI,sBAAmB,QACf,sBAIe;;;;AAAA,wBAAC,8BACvB;;cAgEG,0BAAuB,YAAgB,SAAS;;;;KC3EjD,8CAKD,cAAc;YACF,cAAc;;KAEzB;EACH,UACE,gBACA,SAAS,SAAS,eAAe,eAC9B;IAAU;MAAU;;IAAmB,SAAS;;;;;KCZlD;;KAGA;;;;KAKA;EACH,mBAAmB,QAAQ;EAC3B,mBAAmB,QAAQ;EAC3B,MACE,6CACA,cAAc,MAAM,MAAM;EAE5B,YAAY,oBAAoB;EAChC,kBACE,6CACA,cAAc,MAAM,MAAM;EAE5B,uBAAuB,QAAQ;EAC/B,eAAe,mBAAmB,mBAAmB;EACrD,cAAc,iBAAiB,qCAAqC;EACpE,WAAW,iBAAiB,UAAU,0BAA0B;;EAEhE,iBAAiB,SAAS,sBAAsB;;KAG7C;KACA,mBAAmB,cAAc;KAEjC;EACH;;;;;;;;cClDI;;;KCKD;EACH,MAAM;EACN;IAAc,UAAU;;EACxB,SAAS;EACT;IAAoB,kBAAkB;;;QAGhC;YAEI;IACR,MAAM;IACN;MAAc,UAAU;;IACxB,SAAS;IACT;MAAoB,kBAAkB;;;;KAIrC;;;EAGH;;;EAGA;;EAEA,SAAS;;;;;;;cAiDL,iCAA8B,YACtB,SAAS,wBAAsB,UAClC;;;;;;;;cC3EL,mBAAmB;;;;;;;;;YCAb;IACR;MAAkB,UAAU;;IAC5B;MAAU,UAAU"}