x402agent/SolanaOS / skills/solana-dev
solana-dev
FlaggedUse when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "deploy to devnet", or "explain Solana concepts" (rent, accounts, PDAs, CPIs, etc.). End-to-end Solana development playbook covering wallet connection, Anchor/Pinocchio programs, Codama client generation, LiteSVM/Mollusk/Surfpool testing, and security checklists. Integrates with the Solana MCP server for live documentation search. Prefers framework-kit (@solana/client + @solana/react-hooks) for UI, wallet-standard-first connection (incl. ConnectorKit), @solana/kit for client/RPC code, and @solana/web3-compat for legacy boundaries.
references/kit/react.md
View on GitHub---
title: React Hooks Reference
description: Low-level wallet hooks from @solana/react for wallet selection, signing, and transaction sending in React apps.
---
# Solana Kit React Reference
`@solana/react` provides low-level wallet hooks for Solana Kit.
## Setup
```tsx
import {
SelectedWalletAccountContextProvider,
useSelectedWalletAccount,
useSignAndSendTransaction,
} from '@solana/react';
```
## Provider
```tsx
const STORAGE_KEY = 'wallet-account';
function App() {
return (
<SelectedWalletAccountContextProvider
filterWallet={(wallet) => wallet.accounts.length > 0}
stateSync={{
getSelectedWallet: () => localStorage.getItem(STORAGE_KEY),
storeSelectedWallet: (k) => localStorage.setItem(STORAGE_KEY, k),
deleteSelectedWallet: () => localStorage.removeItem(STORAGE_KEY),
}}
>
<YourApp />
</SelectedWalletAccountContextProvider>
);
}
```
## Wallet Selection
```tsx
function WalletSelector() {
const [account, setAccount, wallets] = useSelectedWalletAccount();
if (!account) {
return (
<div>
{wallets.map((wallet) => (
<div key={wallet.name}>
{wallet.accounts.map((acc) => (
<button key={acc.address} onClick={() => setAccount(acc)}>
{wallet.name}: {acc.address.slice(0, 8)}...
</button>
))}
</div>
))}
</div>
);
}
return (
<div>
<p>Connected: {account.address}</p>
<button onClick={() => setAccount(undefined)}>Disconnect</button>
</div>
);
}
```
## Sign In With Solana
```tsx
const signIn = useSignIn(wallet);
const handleSignIn = async () => {
const { account, signedMessage, signature } = await signIn({
requestId: csrfToken,
});
// Verify on server
};
```
## Sign Message
```tsx
const signMessage = useSignMessage(account);
const { signature, signedMessage } = await signMessage({
message: new TextEncoder().encode('Hello'),
});
```
## Sign Transaction
```tsx
const signTx = useSignTransaction(account, 'solana:devnet');
const { signedTransaction } = await signTx({
transaction: txBytes,
options: { minContextSlot },
});
```
## Sign & Send
```tsx
const signAndSend = useSignAndSendTransaction(account, 'solana:devnet');
const { signature } = await signAndSend({ transaction: txBytes });
const base58Sig = getBase58Decoder().decode(signature);
```
## Transaction Signer Hook
```tsx
const signer = useWalletAccountTransactionSendingSigner(account, 'solana:devnet');
const message = pipe(
createTransactionMessage({ version: 0 }),
m => setTransactionMessageFeePayerSigner(signer, m),
m => setTransactionMessageLifetimeUsingBlockhash(blockhash, m),
m => appendTransactionMessageInstruction(instruction, m),
);
const sig = await signAndSendTransactionMessageWithSigners(message);
```
## Chain Identifiers
```ts
'solana:mainnet'
'solana:devnet'
'solana:testnet'
'solana:localnet'
```
## Signer Types
| Hook | Returns |
|------|---------|
| `useWalletAccountMessageSigner` | `MessageModifyingSigner` |
| `useWalletAccountTransactionSigner` | `TransactionModifyingSigner` |
| `useWalletAccountTransactionSendingSigner` | `TransactionSendingSigner` |
All return modifying signers (wallets may modify before signing).
## Complete Example
```tsx
function App() {
return (
<SelectedWalletAccountContextProvider
filterWallet={(w) => w.accounts.length > 0}
stateSync={{
getSelectedWallet: () => localStorage.getItem('wallet'),
storeSelectedWallet: (k) => localStorage.setItem('wallet', k),
deleteSelectedWallet: () => localStorage.removeItem('wallet'),
}}
>
<WalletApp />
</SelectedWalletAccountContextProvider>
);
}
function WalletApp() {
const [account, setAccount, wallets] = useSelectedWalletAccount();
const signAndSend = useSignAndSendTransaction(account, 'solana:devnet');
if (!account) {
return wallets.map((w) =>
w.accounts.map((a) => (
<button key={a.address} onClick={() => setAccount(a)}>
{w.name}: {a.address.slice(0, 8)}...
</button>
))
);
}
return (
<div>
<p>{account.address}</p>
<button onClick={() => setAccount(undefined)}>Disconnect</button>
</div>
);
}
```Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |