For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at the same URL with .md appended (or via Accept: text/markdown).
Skip to main content

Connect to Solana - Node.js quickstart

Get started with MetaMask Connect Solana in a Node.js application. The SDK displays a QR code in the terminal that you scan with the MetaMask mobile app to establish a connection.

Wallet Standard is browser-only

Wallet Standard features (getWallet, wallet.features[...]) are designed for browser environments. In Node.js, use the multichain core directly via client.core.connect and client.core.invokeMethod to interact with Solana.

Prerequisites​

Steps​

1. Install MetaMask Connect Solana​

Install the Solana client in an existing Node.js project:

npm install @metamask/connect-solana

2. Initialize MetaMask Connect Solana​

Create a file (index.mjs) and initialize the client using createSolanaClient. In Node.js, there is no window.location, so you must set dapp.url explicitly. The supportedNetworks map uses network names (mainnet, devnet) as keys:

index.mjs
import { createSolanaClient, getInfuraRpcUrls } from '@metamask/connect-solana'

const SOLANA_MAINNET = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp'

const solanaClient = await createSolanaClient({
  dapp: {
    name: 'My Node.js Solana App',
    url: 'https://myapp.com',
  },
  api: {
    supportedNetworks: getInfuraRpcUrls({
      infuraApiKey: 'YOUR_INFURA_API_KEY',
      networks: ['mainnet'],
    }),
  },
})
Async client

createSolanaClient returns a promise. Always await it before using the client. The client uses a singleton multichain core under the hood; calling it multiple times returns the same underlying session.

3. Connect to MetaMask​

Register a wallet_sessionChanged listener to capture session data, then connect with a Solana scope. A QR code appears in the terminal. Scan it with the MetaMask mobile app:

let session
solanaClient.core.on('wallet_sessionChanged', s => {
  session = s
})

await solanaClient.core.connect([SOLANA_MAINNET], [])

const accounts = session?.sessionScopes?.[SOLANA_MAINNET]?.accounts ?? []
const address = accounts[0]?.split(':').pop()
console.log('Connected:', address)

4. Sign a message​

Use invokeMethod to call the signMessage method on the Solana scope:

const message = Buffer.from('Hello from Node.js!', 'utf8').toString('base64')

const result = await solanaClient.core.invokeMethod({
  scope: SOLANA_MAINNET,
  request: {
    method: 'signMessage',
    params: {
      account: { address },
      message,
    },
  },
})
console.log('Signature:', result.signature)

5. Disconnect​

Use disconnect to revoke the Solana scopes. Any EVM or other scopes in the same multichain session stay active.

await solanaClient.disconnect()
console.log('Disconnected')

Listen for session events​

Step 3 captures the session with a minimal wallet_sessionChanged listener. For production use, expand the handler to track account changes throughout the session lifecycle:

solanaClient.core.on('wallet_sessionChanged', session => {
  if (session?.sessionScopes) {
    const solanaAccounts = session.sessionScopes[SOLANA_MAINNET]?.accounts ?? []
    console.log('Solana accounts:', solanaAccounts)
  } else {
    console.log('Session ended')
  }
})

Solana CAIP-2 scope reference​

NetworkCAIP-2 scope
Mainnetsolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Devnetsolana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1
Testnetsolana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z
note

Devnet and testnet are supported only in the MetaMask browser extension (such as MetaMask Flask). On mobile—including the QR code flow in this quickstart—only Solana mainnet is supported.

Full example​

index.mjs
import { createSolanaClient, getInfuraRpcUrls } from '@metamask/connect-solana'

const SOLANA_MAINNET = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp'

const solanaClient = await createSolanaClient({
  dapp: {
    name: 'My Node.js Solana App',
    url: 'https://myapp.com',
  },
  api: {
    supportedNetworks: getInfuraRpcUrls({
      infuraApiKey: 'YOUR_INFURA_API_KEY',
      networks: ['mainnet'],
    }),
  },
})

// Capture session data via event before connecting
let session
solanaClient.core.on('wallet_sessionChanged', s => {
  session = s
})

// Connect — scan the QR code with the MetaMask mobile app
await solanaClient.core.connect([SOLANA_MAINNET], [])

const accounts = session?.sessionScopes?.[SOLANA_MAINNET]?.accounts ?? []
const address = accounts[0]?.split(':').pop()
console.log('Connected:', address)

// Sign a message
const message = Buffer.from('Hello from Node.js!', 'utf8').toString('base64')
const result = await solanaClient.core.invokeMethod({
  scope: SOLANA_MAINNET,
  request: {
    method: 'signMessage',
    params: {
      account: { address },
      message,
    },
  },
})
console.log('Signature:', result.signature)

// Disconnect
await solanaClient.disconnect()
console.log('Disconnected')

Run it with:

node index.mjs

Next steps​

On this page