> For the complete documentation index, see [llms.txt](/llms.txt).

# Integrate Embedded Wallets with the Solana Blockchain in React Native

The React Native SDK v9 exposes a `TransactionSigner` from `@solana/signers` through `useWeb3Auth().web3Auth.signer`. Use it with [@solana/web3.js](https://solana.com/docs/clients/official/javascript#solana-web3js) for balances, signing, and sending transactions. This replaces the v8 `SolanaWallet` class from `@web3auth/solana-provider`.

Migration from v8

If your app still uses `SolanaWallet`, `SolanaPrivateKeyProvider`, or `@web3auth/solana-provider`, follow [React Native migration guide](/embedded-wallets/migration-guides/react-native/).

## Prerequisites[​](#prerequisites "Direct link to Prerequisites")

Complete the [React Native SDK get started](/embedded-wallets/sdk/react-native/) guide first:

- Install `@web3auth/react-native-sdk@^9` and configure Metro, Babel, and the entry-point setup import.
- Export a `Web3AuthContextConfig` from `web3authConfig.ts` and wrap your app in `Web3AuthProvider`.
- Sign users in with `useWeb3AuthConnect().connectTo()` before you read the signer.

## Chain details for Solana[​](#chain-details-for-solana "Direct link to Chain details for Solana")

- Mainnet
- Testnet
- Devnet

- Chain Namespace: SOLANA
- Chain ID: 0x1
- Public RPC URL: `https://api.mainnet-beta.solana.com` (avoid public RPC in production; prefer managed services)
- Display Name: Solana Mainnet
- Block Explorer Link: `https://explorer.solana.com`
- Ticker: SOL
- Ticker Name: Solana
- Logo: <https://images.toruswallet.io/solana.svg>

- Chain Namespace: SOLANA
- Chain ID: 0x2
- Public RPC URL: `https://api.testnet.solana.com` (avoid public RPC in production; prefer managed services)
- Display Name: Solana Testnet
- Block Explorer Link: `https://explorer.solana.com`
- Ticker: SOL
- Ticker Name: Solana
- Logo: <https://images.toruswallet.io/solana.svg>

- Chain Namespace: SOLANA
- Chain ID: 0x3
- Public RPC URL: `https://api.devnet.solana.com` (avoid public RPC in production; prefer managed services)
- Display Name: Solana Devnet
- Block Explorer Link: `https://explorer.solana.com?cluster=devnet`
- Ticker: SOL
- Ticker Name: Solana
- Logo: <https://images.toruswallet.io/solana.svg>

## Installation[​](#installation "Direct link to Installation")

v9 does not require `@web3auth/solana-provider`. Install `@solana/web3.js` for RPC calls such as balance lookups and transaction broadcast:

- npm
- Yarn
- pnpm
- Bun

```
npm install @solana/web3.js

```

```
yarn add @solana/web3.js

```

```
pnpm add @solana/web3.js

```

```
bun add @solana/web3.js

```

The SDK bundles `@solana/signers` types for `web3Auth.signer`.

## SDK configuration[​](#sdk-configuration "Direct link to SDK configuration")

Add a Solana chain to the `chains` array in `web3authConfig.ts`. Do not pass `SolanaPrivateKeyProvider` or `privateKeyProvider` in v9.

web3authConfig.ts

```
import {
  CHAIN_NAMESPACES,
  WEB3AUTH_NETWORK,
  type Web3AuthContextConfig,
} from '@web3auth/react-native-sdk'

const web3AuthConfig: Web3AuthContextConfig = {
  web3AuthOptions: {
    clientId: 'YOUR_CLIENT_ID',
    redirectUrl: 'yourapp://auth',
    network: WEB3AUTH_NETWORK.SAPPHIRE_MAINNET,
    chains: [
      {
        chainNamespace: CHAIN_NAMESPACES.SOLANA,
        chainId: '0x1', // Mainnet (use 0x2 for Testnet, 0x3 for Devnet)
        rpcTarget: 'https://api.mainnet-beta.solana.com',
        displayName: 'Solana Mainnet',
        blockExplorerUrl: 'https://explorer.solana.com',
        ticker: 'SOL',
        tickerName: 'Solana',
        logo: 'https://images.toruswallet.io/solana.svg',
      },
    ],
    defaultChainId: '0x1',
  },
}

export default web3AuthConfig

```

## Get the signer[​](#get-the-signer "Direct link to Get the signer")

After the user connects, read `isConnected` and access the signer through `useWeb3Auth()`:

```
import { useWeb3Auth } from '@web3auth/react-native-sdk'
import type { TransactionSigner } from '@solana/signers'

function useSolanaSigner() {
  const { isConnected, web3Auth } = useWeb3Auth()
  if (!isConnected) return null
  return web3Auth?.signer as TransactionSigner | null
}

```

## Get accounts[​](#get-accounts "Direct link to Get accounts")

```
import { Text } from 'react-native'
import { useWeb3Auth } from '@web3auth/react-native-sdk'
import type { TransactionSigner } from '@solana/signers'

function SolanaAddress() {
  const { web3Auth } = useWeb3Auth()
  const signer = web3Auth?.signer as TransactionSigner | null
  const address = signer ? String(signer.address) : null

  return <Text>{address ?? 'Not connected'}</Text>
}

```

## Get balance[​](#get-balance "Direct link to Get balance")

```
import { useWeb3Auth } from '@web3auth/react-native-sdk'
import type { TransactionSigner } from '@solana/signers'
import { Connection, PublicKey, LAMPORTS_PER_SOL } from '@solana/web3.js'

function useSolanaBalance(rpcUrl = 'https://api.mainnet-beta.solana.com') {
  const { web3Auth } = useWeb3Auth()
  const signer = web3Auth?.signer as TransactionSigner | null

  const getBalance = async () => {
    if (!signer) return null
    const connection = new Connection(rpcUrl, 'confirmed')
    const lamports = await connection.getBalance(new PublicKey(String(signer.address)))
    return lamports / LAMPORTS_PER_SOL
  }

  return { getBalance }
}

```

## Sign a transaction[​](#sign-a-transaction "Direct link to Sign a transaction")

```
import type { TransactionSigner } from '@solana/signers'
import {
  Connection,
  PublicKey,
  Transaction,
  SystemProgram,
  LAMPORTS_PER_SOL,
} from '@solana/web3.js'

async function signSolanaTransaction(signer: TransactionSigner, to: string) {
  const connection = new Connection('https://api.mainnet-beta.solana.com', 'confirmed')
  const address = new PublicKey(String(signer.address))
  const { blockhash } = await connection.getRecentBlockhash('finalized')

  const transaction = new Transaction({
    recentBlockhash: blockhash,
    feePayer: address,
  }).add(
    SystemProgram.transfer({
      fromPubkey: address,
      toPubkey: new PublicKey(to),
      lamports: 0.01 * LAMPORTS_PER_SOL,
    })
  )

  const signedTransaction = await signer.signTransaction(transaction)
  return signedTransaction
}

```

## Send a transaction[​](#send-a-transaction "Direct link to Send a transaction")

```
import type { TransactionSigner } from '@solana/signers'
import {
  Connection,
  PublicKey,
  Transaction,
  SystemProgram,
  LAMPORTS_PER_SOL,
} from '@solana/web3.js'

async function sendSolanaTransaction(signer: TransactionSigner, to: string) {
  const connection = new Connection('https://api.mainnet-beta.solana.com', 'confirmed')
  const address = new PublicKey(String(signer.address))
  const block = await connection.getLatestBlockhash('finalized')

  const transaction = new Transaction({
    blockhash: block.blockhash,
    lastValidBlockHeight: block.lastValidBlockHeight,
    feePayer: address,
  }).add(
    SystemProgram.transfer({
      fromPubkey: address,
      toPubkey: new PublicKey(to),
      lamports: 0.01 * LAMPORTS_PER_SOL,
    })
  )

  const signedTransaction = await signer.signTransaction(transaction)
  const signature = await connection.sendRawTransaction(signedTransaction.serialize())
  return signature
}

```

## Sign a message[​](#sign-a-message "Direct link to Sign a message")

```
import type { TransactionSigner } from '@solana/signers'
import { signBytes } from '@solana/signers'

async function signSolanaMessage(signer: TransactionSigner, message: string) {
  const encoded = new TextEncoder().encode(message)
  const signature = await signBytes(signer, encoded)
  return Buffer.from(signature).toString('base64')
}

```

## Next steps[​](#next-steps "Direct link to Next steps")

- [React Native SDK get started](/embedded-wallets/sdk/react-native/)
- [React Native migration guide](/embedded-wallets/migration-guides/react-native/) if you are upgrading from v8 or earlier
- [React Native hooks reference](/embedded-wallets/sdk/react-native/hooks/)