@bestinslot/wallet-kit 0.9.1 → 0.10.0

package/dist/types/api/wallet.d.ts

@@ -1,6 +1,7 @@
 import { WalletInfo } from '../types/wallet';
-export { getAllBalanceDetails, getCardinalBalance, getOrdinalsWallet, getPaymentWallet, getSession, sendBTC, sendInscription, setNetwork, signMessage, signMessageLocalVerify, signMessageLocalVerifyDeterministic, } from '../core/bis';
-export { getNetwork } from '../core/store-network';
+export { getAllBalanceDetails, getCardinalBalance, getOrdinalsWallet, getPaymentWallet, getSession, sendBTC, sendInscription, setNetwork, signMessage, signMessageLocalVerify, signMessageLocalVerifyDeterministic, subscribeToAccountChanges, WalletAccountChangedError, } from '../core/bis';
+export type { AccountChangeEvent } from '../core/bis';
 export type { WalletInfo };
+export { getNetwork } from '../core/store-network';
 export type { BISNetwork, BISSession, BISWallet, BISWalletProvider, BISWalletPurpose, } from '../types/common';
 export type { SendInscriptionResult } from '../types/inscription';

package/dist/types/core/bis.d.ts

@@ -2,7 +2,8 @@ import { BISWalletPurpose } from '../types/common';
 import { SendInscriptionResult } from '../types/inscription';
 import { WalletInfo } from '../types/wallet';
 export { getAllBalanceDetails, getCardinalBalance } from './helpers';
-export { getOrdinalsWallet, getPaymentWallet, sendBTC, signMessage, signMessageLocalVerify, signMessageLocalVerifyDeterministic, } from './providers';
+export { getOrdinalsWallet, getPaymentWallet, sendBTC, signMessage, signMessageLocalVerify, signMessageLocalVerifyDeterministic, subscribeToAccountChanges, WalletAccountChangedError, } from './providers';
+export type { AccountChangeEvent } from './providers';
 export { getWalletInfo as getSession } from './store';
 export { getNetwork, setNetwork } from './store-network';
 /**

package/dist/types/core/providers.d.ts

@@ -1,5 +1,29 @@
 import { BISProvider, SignFunction } from '../provider/api';
 import { BISSession, BISWallet, BISWalletProvider, BISWalletPurpose } from '../types/common';
+/**
+ * Thrown before signing when the account active in the wallet extension differs from the
+ * connected session (the user switched accounts inside the wallet after connecting). The stored
+ * session is cleared when this is thrown; the app should prompt the user to reconnect.
+ */
+export declare class WalletAccountChangedError extends Error {
+    readonly expectedAddress: string;
+    readonly accounts: string[];
+    readonly code = "WALLET_ACCOUNT_CHANGED";
+    /**
+     * @param expectedAddress The address of the connected session.
+     * @param accounts The addresses the wallet reports as active.
+     */
+    constructor(expectedAddress: string, accounts: string[]);
+}
+/**
+ * Emitted when the wallet's active account no longer matches the connected session. The stored
+ * session has already been cleared when listeners run.
+ */
+export interface AccountChangeEvent {
+    provider: BISWalletProvider;
+    previousAddresses: string[];
+    accounts: string[];
+}
 /**
  * Registry of wallet providers, populated per build via `registerProvider`. The
  * browser build registers the extension wallets; the server build registers only
@@ -24,6 +48,15 @@ export declare function registerProvider(name: BISWalletProvider, provider: BISP
  * @throws An error if the provider is not supported or if there is an error while fetching the wallets, with a message indicating the reason for the failure.
  */
 export declare function getWallets(provider: BISWalletProvider): Promise<BISSession>;
+/**
+ * Subscribes to account switches made inside the connected wallet extension (supported by
+ * Unisat and OKX). When the wallet's active account stops matching the session, the kit clears
+ * the stored session and calls the listener so the app can prompt a reconnect.
+ *
+ * @param listener Called with the provider, the session's previous addresses and the wallet's new accounts.
+ * @returns An unsubscribe function that removes the listener.
+ */
+export declare function subscribeToAccountChanges(listener: (event: AccountChangeEvent) => void): () => void;
 /**
  * Returns the currently connected ordinals wallet, or undefined if no ordinals wallet is connected. The function retrieves the wallet information from local storage and checks for a wallet with the purpose of 'ordinals'. If such a wallet is found, it is returned; otherwise, the function returns undefined.
  *

package/dist/types/provider/api.d.ts

@@ -48,6 +48,22 @@ export interface BISProvider {
      * @returns A promise that resolves to an array of BISWallet objects, each representing a wallet associated with the provider. This allows developers to access the wallets available through the provider and perform various operations with them. If there is an error in retrieving the wallets, the promise will be rejected with an appropriate error message.
      */
     getWallets: () => Promise<BISWallet[]>;
+    /**
+     * Returns the addresses of the account currently active in the wallet, without prompting the
+     * user. Implemented only by providers that expose this silently; the kit compares the result
+     * with the stored session before signing to detect an account switch made inside the wallet.
+     *
+     * @returns The active account's addresses, or an empty array when the wallet cannot tell (e.g. it is locked).
+     */
+    getAccounts?: () => Promise<string[]>;
+    /**
+     * Subscribes to account switches made inside the wallet. Implemented only by providers that
+     * emit such an event.
+     *
+     * @param handler Called with the newly active account's addresses (empty when the wallet cannot tell).
+     * @returns An unsubscribe function.
+     */
+    onAccountsChanged?: (handler: (accounts: string[]) => void) => () => void;
     /**
      * Signs a message using the provider. The signMessage method takes a message as a string and returns a promise that resolves to the signature of the message as a hexadecimal string. This method allows developers to sign messages using the wallets associated with the provider, enabling functionalities such as authentication or transaction signing. If there is an error in signing the message, the promise will be rejected with an appropriate error message.
      *

package/dist/types/types/global.d.ts

@@ -14,6 +14,9 @@ declare global {
 
 interface UniSat {
   requestAccounts: () => Promise<string[]>
+  getAccounts: () => Promise<string[]>
+  on: (event: 'accountsChanged', handler: (accounts: string[]) => void) => void
+  removeListener: (event: 'accountsChanged', handler: (accounts: string[]) => void) => void
   getNetwork: () => Promise<'livenet' | 'testnet'>
   switchNetwork: (network: string) => Promise<void>
   signMessage: (message: string, type?: 'ecdsa' | 'bip322-simple') => Promise<string>

package/dist/vue.js

@@ -1,13 +1,13 @@
 import { ref as s, onScopeDispose as i, watch as u } from "vue";
-import { d as r, w as c, i as w } from "./mint-BXVHw4CQ.js";
-function n() {
+import { d as r, R as c, i as a } from "./mint-CA_-62SJ.js";
+function w() {
   const e = s(r()), t = c((o) => {
     e.value !== o && (e.value = o);
   });
   return i(t, !0), u(e, (o) => {
-    o !== r() && w(o);
+    o !== r() && a(o);
   }), e;
 }
 export {
-  n as useNetwork
+  w as useNetwork
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bestinslot/wallet-kit",
   "type": "module",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "private": false,
   "description": "A lightweight JavaScript library for connecting Bitcoin wallets with a unified API.",
   "license": "MIT",