@solana/react-hooks 1.1.10 → 1.1.12

package/README.md

@@ -46,7 +46,7 @@ These snippets assume a parent already handled wallet connection and can pass an
 
 ```tsx
 function WalletPanel() {
-  const { connectors, connect, disconnect, wallet, status } =
+  const { connectors, connect, disconnect, wallet, status, currentConnector } =
     useWalletConnection();
   const address = wallet?.account.address;
   const balance = useBalance(address);
@@ -54,6 +54,7 @@ function WalletPanel() {
   if (status === "connected") {
     return (
       <div>
+        <p>Connected via {currentConnector?.name}</p>
         <p>{address?.toString()}</p>
         <p>Lamports: {balance.lamports?.toString() ?? "loading…"}</p>
         <button onClick={disconnect}>Disconnect</button>
@@ -85,6 +86,24 @@ function BalanceCard({ address }: { address: string }) {
 }
 ```
 
+### Read account data (auto fetch + watch)
+
+```tsx
+import { useAccount } from "@solana/react-hooks";
+
+function AccountInfo({ address }: { address: string }) {
+  const account = useAccount(address);
+  if (!account || account.fetching) return <p>Loading…</p>;
+  return (
+    <div>
+      <p>Lamports: {account.lamports?.toString() ?? "0"}</p>
+      <p>Owner: {account.owner ?? "—"}</p>
+      <p>Slot: {account.slot?.toString() ?? "—"}</p>
+    </div>
+  );
+}
+```
+
 ### Send SOL
 
 ```tsx
@@ -97,7 +116,7 @@ function SendSol({ destination }: { destination: string }) {
       <button
         disabled={isSending}
         onClick={() =>
-          send({ destination, lamports: 100_000_000n /* 0.1 SOL */ })
+          send({ destination, amount: 100_000_000n /* 0.1 SOL */ })
         }
       >
         {isSending ? "Sending…" : "Send 0.1 SOL"}
@@ -129,7 +148,7 @@ function TokenPanel({
       <p>Balance: {balance?.uiAmount ?? "0"}</p>
       <button
         disabled={isSending || !owner}
-        onClick={() => send({ amount: 1n, destinationOwner })}
+        onClick={() => send({ amount: 1n, destinationOwner, amountInBaseUnits: true })}
       >
         {isSending ? "Sending…" : "Send 1 token"}
       </button>
@@ -138,6 +157,8 @@ function TokenPanel({
 }
 ```
 
+> **Note:** Use `amountInBaseUnits: true` when passing raw bigint amounts. For human-readable decimal strings like `"1.5"`, omit the flag.
+
 ### Fetch address lookup tables
 
 ```tsx
@@ -178,34 +199,61 @@ function NonceInfo({ address }: { address: string }) {
 
 ```tsx
 import type { TransactionInstructionInput } from "@solana/client";
-import { useTransactionPool } from "@solana/react-hooks";
+import { useTransactionPool, useWalletSession } from "@solana/react-hooks";
 
 function TransactionFlow({ ix }: { ix: TransactionInstructionInput }) {
-  const pool = useTransactionPool();
+  const session = useWalletSession();
+  const {
+    addInstruction,
+    prepareAndSend,
+    isSending,
+    sendSignature,
+    sendError,
+    latestBlockhash,
+  } = useTransactionPool();
+
   return (
     <div>
-      <button onClick={() => pool.addInstruction(ix)}>Add instruction</button>
-      <button disabled={pool.isSending} onClick={() => pool.prepareAndSend()}>
-        {pool.isSending ? "Sending…" : "Prepare & Send"}
+      <button onClick={() => addInstruction(ix)}>Add instruction</button>
+      <button
+        disabled={isSending || !session}
+        onClick={() => prepareAndSend({ authority: session })}
+      >
+        {isSending ? "Sending…" : "Prepare & Send"}
       </button>
-      <p>Blockhash: {pool.latestBlockhash.blockhash ?? "loading…"}</p>
+      <p>Blockhash: {latestBlockhash.blockhash ?? "loading…"}</p>
+      {sendSignature ? <p>Signature: {sendSignature}</p> : null}
+      {sendError ? <p role="alert">{String(sendError)}</p> : null}
     </div>
   );
 }
 ```
 
+**Available properties:**
+- `addInstruction(ix)` / `addInstructions(ixs)` — queue instructions
+- `removeInstruction(index)` / `clearInstructions()` / `replaceInstructions(ixs)` — manage queue
+- `instructions` — current instruction queue
+- `prepare(opts)` / `prepareAndSend(opts)` — build and optionally send
+- `send(opts)` / `sign(opts)` — send or sign prepared transaction
+- `isPreparing` / `prepareStatus` / `prepareError` — prepare state
+- `isSending` / `sendStatus` / `sendError` / `sendSignature` — send state
+- `latestBlockhash` — current blockhash for lifetime
+- `prepared` / `toWire()` — access prepared transaction
+- `reset()` — clear all state
+
 ### Simple mutation helper (when you already have instructions)
 
 ```tsx
 import { useSendTransaction } from "@solana/react-hooks";
 
 function SendPrepared({ instructions }) {
-  const { send, isSending, signature, error } = useSendTransaction();
+  const { send, isSending, status, signature, error } = useSendTransaction();
   return (
     <div>
       <button disabled={isSending} onClick={() => send({ instructions })}>
         {isSending ? "Submitting…" : "Send transaction"}
       </button>
+      <p>Status: {status}</p>
       {signature ? <p>Signature: {signature}</p> : null}
       {error ? <p role="alert">{String(error)}</p> : null}
     </div>
@@ -213,6 +261,14 @@ function SendPrepared({ instructions }) {
 }
 ```
 
+> **Note:** This hook automatically uses the connected wallet session — no need to pass `authority` explicitly.
+
+**Available properties:**
+- `send(request, opts?)` — build and send transaction
+- `sendPrepared(prepared, opts?)` — send already-prepared transaction
+- `isSending` / `status` / `signature` / `error` — transaction state
+- `reset()` — clear state for new transaction
+
 ### Track confirmations for a signature
 
 ```tsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/react-hooks",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "React hooks for the @solana/client Solana client",
   "exports": {
     "browser": "./dist/index.browser.mjs",