@usearete/react 0.46.0 → 0.47.0

package/dist/wallet-standard.d.ts

@@ -0,0 +1,73 @@
+import { WalletStandardWallet, WalletStandardAccount, AdapterTransportSelection, KitWalletAdapter, WalletStandardSignerError } from '@usearete/adapter-kit';
+export { KitWalletAdapter, WalletStandardAccount, WalletStandardSignerError, WalletStandardSignerErrorCode, WalletStandardWallet, isWalletStandardSignerError } from '@usearete/adapter-kit';
+import { UiWalletAccount } from '@wallet-standard/ui-core';
+
+/**
+ * `@usearete/react/wallet-standard`: the connected Wallet Standard account as
+ * the wallet Arete signs with.
+ *
+ * Kept out of the main entry so apps that do not use Wallet Standard do not
+ * need its packages: this entry needs `@usearete/adapter-kit` (and its
+ * `@solana/kit` peer) and `@wallet-standard/ui-registry`, which every
+ * `@wallet-standard/react` app already has.
+ */
+
+/** A Wallet Standard wallet and one of its accounts, outside React's UI handles. */
+interface WalletStandardSelection {
+    readonly wallet: WalletStandardWallet;
+    readonly account: WalletStandardAccount;
+}
+interface UseWalletStandardWalletOptions {
+    /** CAIP-2 chain the wallet signs for, e.g. `solana:mainnet`. */
+    readonly chain?: string;
+    /**
+     * Where the signed transaction is submitted. Defaults to `'auto'`: the
+     * Arete client's or session's transaction transport.
+     */
+    readonly transport?: AdapterTransportSelection;
+}
+interface UseWalletStandardWalletResult {
+    /**
+     * The sign-only wallet for `AreteProvider wallet={...}`, `createSession`
+     * or `execute(prepared, { wallet })`. `undefined` while nothing is
+     * connected or when the account cannot be used (see `error`).
+     */
+    readonly wallet: KitWalletAdapter | undefined;
+    /** The connected account's address. */
+    readonly address: string | null;
+    /** The wallet's approval prompt is open: show "check your wallet". */
+    readonly isPromptOpen: boolean;
+    /**
+     * Why the account cannot sign for Arete; switch on `error.code`:
+     *
+     * - `sign_transaction_unsupported`: the wallet lacks
+     *   `solana:signTransaction` (it only signs and sends in one step).
+     * - `chain_unsupported`: the account does not sign for `options.chain`.
+     * - `account_unavailable`: the account could not be read, or its wallet is
+     *   no longer registered.
+     *
+     * A declined prompt is not reported here: it fails the run
+     * (`useOperationMutation`'s `wallet-rejected`), and the wallet stays usable.
+     */
+    readonly error: WalletStandardSignerError | null;
+}
+/**
+ * The connected Wallet Standard account as the wallet the Arete provider and
+ * sessions sign with. Sign only: the wallet signs (`solana:signTransaction`)
+ * and Arete submits the signed bytes through the transport it already uses.
+ *
+ * ```tsx
+ * const { wallets } = useWallets(); // @wallet-standard/react
+ * const account = selectedWallet?.accounts[0] ?? null;
+ * const { wallet, isPromptOpen, error } = useWalletStandardWallet(account, { chain: 'solana:mainnet' });
+ * return <AreteProvider wallet={wallet}>…{isPromptOpen && 'Check your wallet'}</AreteProvider>;
+ * ```
+ *
+ * Accepts a `UiWalletAccount` from `@wallet-standard/react`, or a raw
+ * `{ wallet, account }` pair. The returned adapter is stable while the
+ * account, chain and transport stay the same.
+ */
+declare function useWalletStandardWallet(source: UiWalletAccount | WalletStandardSelection | null | undefined, options?: UseWalletStandardWalletOptions): UseWalletStandardWalletResult;
+
+export { useWalletStandardWallet };
+export type { UseWalletStandardWalletOptions, UseWalletStandardWalletResult, WalletStandardSelection };

package/dist/wallet-standard.esm.js

@@ -0,0 +1,120 @@
+import { useState, useRef, useEffect, useMemo } from 'react';
+import { WalletStandardSignerError, createWalletStandardWalletAdapter, isWalletStandardSignerError } from '@usearete/adapter-kit';
+export { WalletStandardSignerError, isWalletStandardSignerError } from '@usearete/adapter-kit';
+import { getWalletForHandle, getWalletAccountForUiWalletAccount } from '@wallet-standard/ui-registry';
+
+/**
+ * `@usearete/react/wallet-standard`: the connected Wallet Standard account as
+ * the wallet Arete signs with.
+ *
+ * Kept out of the main entry so apps that do not use Wallet Standard do not
+ * need its packages: this entry needs `@usearete/adapter-kit` (and its
+ * `@solana/kit` peer) and `@wallet-standard/ui-registry`, which every
+ * `@wallet-standard/react` app already has.
+ */
+function isSelection(source) {
+    return 'wallet' in source && 'account' in source;
+}
+function resolveSelection(source) {
+    if (isSelection(source))
+        return source;
+    // The registry hands back the wallet's own objects: the wallet may compare
+    // the account it is asked to sign for by identity.
+    return {
+        wallet: getWalletForHandle(source),
+        account: getWalletAccountForUiWalletAccount(source),
+    };
+}
+/**
+ * The connected Wallet Standard account as the wallet the Arete provider and
+ * sessions sign with. Sign only: the wallet signs (`solana:signTransaction`)
+ * and Arete submits the signed bytes through the transport it already uses.
+ *
+ * ```tsx
+ * const { wallets } = useWallets(); // @wallet-standard/react
+ * const account = selectedWallet?.accounts[0] ?? null;
+ * const { wallet, isPromptOpen, error } = useWalletStandardWallet(account, { chain: 'solana:mainnet' });
+ * return <AreteProvider wallet={wallet}>…{isPromptOpen && 'Check your wallet'}</AreteProvider>;
+ * ```
+ *
+ * Accepts a `UiWalletAccount` from `@wallet-standard/react`, or a raw
+ * `{ wallet, account }` pair. The returned adapter is stable while the
+ * account, chain and transport stay the same.
+ */
+function useWalletStandardWallet(source, options = {}) {
+    // Open prompts, counted per adapter. Each adapter only moves its own
+    // count, so a prompt the previous account's adapter closes late cannot
+    // hide one the current adapter has open.
+    const [prompts, setPrompts] = useState(() => new Map());
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    let selection = null;
+    let resolveError = null;
+    if (source) {
+        try {
+            selection = resolveSelection(source);
+        }
+        catch (cause) {
+            resolveError = new WalletStandardSignerError('account_unavailable', cause instanceof Error && cause.message
+                ? cause.message
+                : 'The wallet account is not available', { cause });
+        }
+    }
+    const wallet = selection?.wallet;
+    const account = selection?.account;
+    const { chain, transport } = options;
+    const created = useMemo(() => {
+        if (!wallet || !account)
+            return { error: null };
+        let adapter = null;
+        const adjust = (delta) => {
+            if (!mountedRef.current || !adapter)
+                return;
+            const owner = adapter;
+            setPrompts((current) => {
+                const open = Math.max(0, (current.get(owner) ?? 0) + delta);
+                if (open === (current.get(owner) ?? 0))
+                    return current;
+                const next = new Map(current);
+                if (open === 0)
+                    next.delete(owner);
+                else
+                    next.set(owner, open);
+                return next;
+            });
+        };
+        try {
+            adapter = createWalletStandardWalletAdapter({
+                wallet,
+                account,
+                chain,
+                transport,
+                onPromptOpen: () => adjust(1),
+                onPromptClose: () => adjust(-1),
+            });
+            return { adapter, error: null };
+        }
+        catch (error) {
+            return {
+                error: isWalletStandardSignerError(error)
+                    ? error
+                    : new WalletStandardSignerError('account_unavailable', error instanceof Error ? error.message : String(error), { cause: error }),
+            };
+        }
+    }, [wallet, account, chain, transport]);
+    return {
+        wallet: created.adapter,
+        address: account?.address ?? null,
+        isPromptOpen: created.adapter !== undefined
+            && (prompts.get(created.adapter) ?? 0) > 0,
+        error: resolveError ?? created.error,
+    };
+}
+
+export { useWalletStandardWallet };
+//# sourceMappingURL=wallet-standard.esm.js.map

package/dist/wallet-standard.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-standard.esm.js","sources":["../src/wallet-standard.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usearete/react",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "type": "module",
   "description": "React SDK for the Arete Solana developer platform",
   "main": "dist/index.cjs",
@@ -17,6 +17,11 @@
       "import": "./dist/testing.esm.js",
       "require": "./dist/testing.cjs"
     },
+    "./wallet-standard": {
+      "types": "./dist/wallet-standard.d.ts",
+      "import": "./dist/wallet-standard.esm.js",
+      "require": "./dist/wallet-standard.cjs"
+    },
     "./eslint-plugin.cjs": "./eslint-plugin.cjs",
     "./eslint-rules/*": "./eslint-rules/*",
     "./package.json": "./package.json"
@@ -25,6 +30,9 @@
     "*": {
       "testing": [
         "./dist/testing.d.ts"
+      ],
+      "wallet-standard": [
+        "./dist/wallet-standard.d.ts"
       ]
     }
   },
@@ -61,9 +69,23 @@
     "node": ">=16.0.0"
   },
   "peerDependencies": {
-    "@usearete/sdk": "^0.46.0",
+    "@usearete/adapter-kit": "^0.47.0",
+    "@usearete/sdk": "^0.47.0",
+    "@wallet-standard/ui-core": "^1.0.1",
+    "@wallet-standard/ui-registry": "^1.1.0",
     "react": "^18.0.0 || ^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "@usearete/adapter-kit": {
+      "optional": true
+    },
+    "@wallet-standard/ui-core": {
+      "optional": true
+    },
+    "@wallet-standard/ui-registry": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "zustand": "^4.0.0 || ^5.0.0"
   },
@@ -71,12 +93,17 @@
     "@rollup/plugin-commonjs": "^28.0.9",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^11.0.0",
+    "@solana/kit": "^8.3.0",
     "@types/jest": "^29.0.0",
     "@types/react": "^19.0.0",
     "@types/react-test-renderer": "^19.1.0",
     "@typescript-eslint/eslint-plugin": "^6.21.0",
     "@typescript-eslint/parser": "^6.21.0",
-    "@usearete/sdk": "^0.46.0",
+    "@usearete/adapter-kit": "^0.47.0",
+    "@usearete/sdk": "^0.47.0",
+    "@wallet-standard/base": "^1.1.1",
+    "@wallet-standard/ui-core": "^1.0.1",
+    "@wallet-standard/ui-registry": "^1.1.1",
     "eslint": "^8.0.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "jest": "^29.0.0",