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

# Connect to Solana quickstart

This quickstart gets you up and running with MetaMask Connect Solana in a JavaScript dapp.

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

- [Node.js](https://nodejs.org/) version 19 or later installed.
- A package manager installed, such as [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm), [Yarn](https://yarnpkg.com/), [pnpm](https://pnpm.io/installation), or [bun](https://bun.sh/).
- [MetaMask](https://metamask.io/) installed in your browser or on mobile.
- An [Infura API key](/developer-tools/dashboard/get-started/create-api/) from the Infura dashboard.

## Steps[​](#steps "Direct link to Steps")

### 1\. Install MetaMask Connect Solana[​](#1-install-metamask-connect-solana "Direct link to 1. Install MetaMask Connect Solana")

Install the Solana Client in an existing JavaScript project:

- npm
- Yarn
- pnpm
- Bun

```
npm install @metamask/connect-solana

```

```
yarn add @metamask/connect-solana

```

```
pnpm add @metamask/connect-solana

```

```
bun add @metamask/connect-solana

```

### 2\. Initialize MetaMask Connect Solana[​](#2-initialize-metamask-connect-solana "Direct link to 2. Initialize MetaMask Connect Solana")

Initialize the Solana client using [createSolanaClient](/metamask-connect/solana/reference/methods/#createsolanaclient). The following is an example of initializing the client in a JavaScript project:

```
import { createSolanaClient, getInfuraRpcUrls } from '@metamask/connect-solana'

const solanaClient = await createSolanaClient({
  dapp: {
    name: 'Example JavaScript Solana dapp',
    url: window.location.href,
    iconUrl: 'https://mydapp.com/icon.png', // Optional
  },
  api: {
    supportedNetworks: getInfuraRpcUrls({
      infuraApiKey: 'YOUR_INFURA_API_KEY',
      networks: ['devnet'],
    }),
  },
})

```

info

[createSolanaClient](/metamask-connect/solana/reference/methods/#createsolanaclient) is async and uses a singleton multichain core under the hood. Calling it multiple times returns the same underlying session, so you can safely call it during initialization without worrying about duplicate connections.

This example configures MetaMask Connect Solana with the following options:

- `dapp` - Ensures trust by showing your dapp's `name`, `url`, and `iconUrl` during connection.
- `api.supportedNetworks` - A map of network names (`mainnet`, `devnet`, `testnet`) to RPC URLs for all networks supported by the dapp.

### 3\. Connect and use the wallet[​](#3-connect-and-use-the-wallet "Direct link to 3. Connect and use the wallet")

Get the [Wallet Standard](https://github.com/wallet-standard/wallet-standard) wallet instance and connect:

```
const wallet = solanaClient.getWallet()

const { accounts } = await wallet.features['standard:connect'].connect()
console.log('Connected account:', accounts[0].address)

```

The client handles cross-platform connection (desktop and mobile), including deeplinking.

## Solana client methods at a glance[​](#solana-client-methods-at-a-glance "Direct link to Solana client methods at a glance")

| Method                                                                       | Description                                                                                                |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| [getWallet](/metamask-connect/solana/reference/methods/#getwallet)           | Returns a [Wallet Standard](https://github.com/wallet-standard/wallet-standard) compatible wallet instance |
| [registerWallet](/metamask-connect/solana/reference/methods/#registerwallet) | Registers MetaMask with the Wallet Standard registry (no-op if auto-registered)                            |
| [disconnect](/metamask-connect/solana/reference/methods/#disconnect)         | Disconnects Solana scopes without terminating the broader multichain session                               |

## Usage example[​](#usage-example "Direct link to Usage example")

```
const wallet = solanaClient.getWallet()

// 1. Connect and get accounts
try {
  const { accounts } = await wallet.features['standard:connect'].connect()
  console.log('Connected:', accounts[0].address)

  // 2. Sign a message
  const message = new TextEncoder().encode('Hello from my dapp')
  const [{ signature }] = await wallet.features['solana:signMessage'].signMessage({
    account: accounts[0],
    message,
  })
  console.log('Signature:', signature)
} catch (err) {
  if (err.code === 4001) {
    console.log('User rejected the request')
  } else if (err.code === -32002) {
    console.log('A request is already pending — check MetaMask')
  } else {
    console.error('Unexpected error:', err)
  }
}

// 3. Disconnect
await solanaClient.disconnect()

```

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

- [Use the Wallet Adapter](/metamask-connect/solana/guides/use-wallet-adapter/) to integrate MetaMask with Solana's standard wallet discovery in a React dapp.
- [Send a legacy transaction](/metamask-connect/solana/guides/send-transactions/legacy/) to transfer SOL or interact with programs.
- [Sign messages](/metamask-connect/solana/guides/sign-data/sign-message/) to verify wallet ownership or authorize offchain actions.