Implement kit-plugin-wallet store, types, and tests

.changeset/busy-clowns-stick.md

@@ -0,0 +1,5 @@
+---
+'@solana/kit-plugin-wallet': minor
+---
+
+Add `walletSigner`, `walletIdentity`, `walletPayer`, and `walletWithoutSigner` plugins for framework-agnostic wallet management using wallet-standard. Provides wallet discovery, connection lifecycle, signer creation, auto-connect persistence, subscribable state for UI frameworks, and dynamic payer/identity integration.

CONTRIBUTING.md

@@ -14,6 +14,7 @@ This is a monorepo managed with [pnpm](https://pnpm.io/) and [Turborepo](https:/
 | [`@solana/kit-plugin-signer`](./packages/kit-plugin-signer)                     | Signer, payer, and identity plugins.        |
 | [`@solana/kit-plugin-litesvm`](./packages/kit-plugin-litesvm)                   | LiteSVM support plugin.                     |
 | [`@solana/kit-plugin-instruction-plan`](./packages/kit-plugin-instruction-plan) | Transaction planning and execution plugins. |
+| [`@solana/kit-plugin-wallet`](./packages/kit-plugin-wallet)                     | Browser wallet support plugins.             |
 
 The repo also contains a deprecated umbrella package (`@solana/kit-plugins`) and several deprecated single-purpose packages (`@solana/kit-plugin-payer`, `@solana/kit-plugin-airdrop`, `@solana/kit-client-rpc`, `@solana/kit-client-litesvm`). They re-export from the active packages via `export *` for backward compatibility, but new code should import from the individual `kit-plugin-*` packages above directly.
 

README.md

@@ -126,6 +126,7 @@ This repo provides the following individual plugin packages. You can learn more
 | [`@solana/kit-plugin-signer`](./packages/kit-plugin-signer)                     | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-signer.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-signer)                     | Signer, payer, and identity plugins | `signer`, `payer`, `identity`, `signerFromFile`, `payerFromFile`, `identityFromFile`, `generatedSigner`, `generatedPayer`, `generatedIdentity`, `generatedSignerWithSol`, `generatedPayerWithSol`, `generatedIdentityWithSol`, `airdropSigner`, `airdropPayer`, `airdropIdentity` |
 | [`@solana/kit-plugin-litesvm`](./packages/kit-plugin-litesvm)                   | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-litesvm.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-litesvm)                   | LiteSVM support                     | `litesvm`, `litesvmConnection`, `litesvmAirdrop`, `litesvmGetMinimumBalance`, `litesvmTransactionPlanner`, `litesvmTransactionPlanExecutor`                                                                                                                                       |
 | [`@solana/kit-plugin-instruction-plan`](./packages/kit-plugin-instruction-plan) | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-instruction-plan.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-instruction-plan) | Transaction planning and execution  | `transactionPlanner`, `transactionPlanExecutor`, `planAndSendTransactions`                                                                                                                                                                                                        |
+| [`@solana/kit-plugin-wallet`](./packages/kit-plugin-wallet)                     | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-wallet.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-wallet)                     | Browser wallet support              | `walletSigner`, `walletIdentity`, `walletPayer`, `walletWithoutSigner`                                                                                                                                                                                                            |
 
 ## Community Plugins
 

packages/kit-plugin-wallet/README.md

@@ -137,6 +137,18 @@ All wallet state is accessed via `client.wallet.getState()`, which returns a ref
     const accounts = await client.wallet.connect(selectedWallet);
     ```
 
+    A successful call resolves only once the wallet is connected; any failure rejects. Connecting to a different wallet keeps the current one connected until the new connection succeeds — so if the attempt fails (the user declines the prompt, the wallet authorizes no accounts, or it becomes unavailable), the previous connection is left untouched rather than torn down. The same holds for `signIn`, which rejects rather than resolving with its sign-in output when the connection can't be established. While the attempt is in flight, `status` is `'connecting'` but `getState().connected` still describes the existing connection.
+
+    If another `connect` or `signIn` starts before this one resolves (e.g. an accidental double-click), the newer request wins and owns the connection — the superseded call rejects with a `DOMException` whose `name` is `'AbortError'`. Ignore it the way you'd ignore any aborted operation:
+
+    ```ts
+    try {
+        await client.wallet.connect(selectedWallet);
+    } catch (e) {
+        if ((e as Error).name !== 'AbortError') throw e; // a real failure
+    }
+    ```
+
 - **`disconnect()`** — Disconnect the active wallet.
 
 - **`selectAccount(account)`** — Switch to a different account within an already-authorized wallet without reconnecting.
@@ -234,6 +246,8 @@ By default the plugin uses `localStorage` to remember the last connected wallet
 
 All four wallet plugins are safe to include in a shared client that runs on both server and browser. On the server, `status` stays `'pending'` permanently, all actions throw, and no registry listeners or storage reads are made. In the browser the plugin initializes normally.
 
+React Native is treated the same way as the server: wallet-standard browser discovery is not available, so the plugin returns the same inert stub (`status` stays `'pending'`, actions throw). Native wallet integration would need a different discovery mechanism and is out of scope for this plugin.
+
 ```ts
 const client = createClient()
     .use(solanaRpc({ rpcUrl: 'https://api.mainnet-beta.solana.com' }))

packages/kit-plugin-wallet/package.json

@@ -49,26 +49,27 @@
     "scripts": {
         "build": "rimraf dist && tsup && tsc -p ./tsconfig.declarations.json",
         "dev": "vitest --project node",
-        "lint": "eslint . && prettier --check .",
-        "lint:fix": "eslint --fix . && prettier --write .",
-        "test": "pnpm test:types && pnpm test:treeshakability",
+        "test": "pnpm test:types && pnpm test:treeshakability && pnpm test:unit",
         "test:treeshakability": "for file in dist/index.*.mjs; do agadoo $file; done",
-        "test:types": "tsc --noEmit"
+        "test:types": "tsc --noEmit",
+        "test:unit": "vitest run"
     },
     "dependencies": {
         "@solana/wallet-account-signer": "^6.9.0",
         "@solana/wallet-standard-chains": "^1.1.1",
         "@solana/wallet-standard-features": "^1.3.0",
         "@wallet-standard/app": "^1.1.1",
         "@wallet-standard/base": "^1.1.1",
-        "@wallet-standard/errors": "^0.1.2",
         "@wallet-standard/features": "^1.1.1",
         "@wallet-standard/ui": "^1.0.3",
         "@wallet-standard/ui-features": "^1.0.3",
         "@wallet-standard/ui-registry": "^1.1.1"
     },
+    "devDependencies": {
+        "@wallet-standard/errors": "^0.1.2"
+    },
     "peerDependencies": {
-        "@solana/kit": "^6.6.0"
+        "@solana/kit": "^6.9.0"
     },
     "browserslist": [
         "supports bigint and not dead",