sats-connect 4.2.1 → 4.3.0-0a6bd22

package/README.md

@@ -58,6 +58,10 @@ await request('sendTransfer', {...});
 await Wallet.disconnect();
 ```
 
+### SIP-030 network discovery and listeners
+
+The default `Wallet` object supports `Wallet.request('stx_getNetworks', null)` and synchronous `Wallet.listen(event, callback)` subscriptions for `stx_networkChange` and `stx_accountChange`. The named Core APIs are also re-exported. See [SIP-030 listener usage and rollout](SIP030_LISTENERS.md) for provider selection, cleanup, compatibility and Xverse's deliberate Gaia placeholder policy.
+
 ## 💻 Development
 ### Build the package
 ```bash

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { SupportedWallet, Requests, Params, RpcResult, AddListener } from '@sats-connect/core';
+import { SupportedWallet, Method, RpcRequestParams, RequestReturn, Listen, AddListener } from '@sats-connect/core';
 export * from '@sats-connect/core';
 import { Config } from '@sats-connect/ui';
 
@@ -10,7 +10,9 @@ declare class Wallet {
     setCreateCustomConfig(createCustomConfig: (providers: SupportedWallet[]) => Config): void;
     selectProvider(): Promise<void>;
     disconnect(): Promise<void>;
-    request<Method extends keyof Requests>(method: Method, params: Params<Method>): Promise<RpcResult<Method>>;
+    request<M extends Method>(method: M, params: RpcRequestParams<M>): Promise<RequestReturn<M>>;
+    /** SIP-030 subscriptions never open selection/approval UI or change legacy listeners. */
+    listen: Listen;
     addListener: AddListener;
 }
 

package/dist/index.mjs

@@ -5,6 +5,7 @@ import {
   defaultAdapters,
   getDefaultProvider,
   getSupportedWallets,
+  listen as listenProvider,
   removeDefaultProvider,
   setDefaultProvider
 } from "@sats-connect/core";
@@ -84,6 +85,18 @@ var Wallet = class {
     }
     return response;
   }
+  /** SIP-030 subscriptions never open selection/approval UI or change legacy listeners. */
+  listen = (event, callback) => {
+    const providerId = this.providerId ?? getDefaultProvider();
+    if (!providerId) {
+      throw new Error("Select a wallet provider before registering SIP-030 listeners.");
+    }
+    this.providerId = providerId;
+    const Adapter = this.defaultAdapters[providerId];
+    const adapter = Adapter ? new Adapter() : void 0;
+    if (adapter?.listen) return adapter.listen(event, callback);
+    return listenProvider(event, callback, providerId);
+  };
   addListener = (...rawArgs) => {
     const listenerInfo = (() => {
       if (rawArgs.length === 1) return rawArgs[0];

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "sats-connect",
-  "version": "4.2.1",
+  "version": "4.3.0-0a6bd22",
   "main": "dist/index.mjs",
   "files": [
     "dist"
   ],
   "scripts": {
     "test": "jest",
+    "test:listeners": "npm run build && node --test tests/listeners.test.mjs",
+    "check-types": "tsc --noEmit && tsc --noEmit -p tests/tsconfig.json",
     "build": "npm run clean && tsup src/index.ts --format esm --dts",
     "build:watch": "npm run clean && tsup src/index.ts --format esm --dts --watch",
     "dev:build": "tsup src/index.ts --format esm --dts --watch",
@@ -24,10 +26,10 @@
     ]
   },
   "dependencies": {
-    "@sats-connect/core": "0.10.0",
+    "@sats-connect/core": "0.19.0-d1718be",
     "@sats-connect/make-default-provider-config": "0.0.10",
     "@sats-connect/ui": "0.0.7",
-    "valibot": "1.1.0"
+    "valibot": "1.2.0"
   },
   "devDependencies": {
     "husky": "9.1.7",