Privy’s wallets on Solana natively integrate with `@solana/kit` via the `@privy-io/node` SDK, allowing you to use the library’s signer interfaces for signing messages and transactions, as well as sending those transactions to the blockchain. Setup To integrate with `@solana/kit`, first install the library as a peer dependency: ```sh theme={"system"} npm i @solana/kit ``` Then, use Privy’s `createSolanaKitSigner` method to initialize a signer for a Solana wallet. To this method, pass the following fields: The ID of the wallet to sign with. The address of the wallet to sign with. The authorization context for the wallet. Refer to the [authorization context](/controls/authorization-context) guide for more details. The CAIP-2 identifier for the Solana network. This is only required when sending transactions with the Signer. Example usage As an example, you can initialize a signer like so: ```ts theme={"system"} import {PrivyClient} from '@privy-io/node'; import {createSolanaKitSigner} from '@privy-io/node/solana-kit'; import {address} from '@solana/kit'; // Set up the Privy client and signer const privy = new PrivyClient({appId: 'your-app-id', appSecret: 'your-app-secret'}); const signer = createSolanaKitSigner(privy, { walletId: 'insert-wallet-id', address: address('insert-wallet-address') }); ``` If your wallet requires an [authorization context](/controls/authorization-context), you should pass it to the `createSolanaKitSigner` method like so, and it will be used throughout the lifetime of the signer: ```ts theme={"system"} import {PrivyClient} from '@privy-io/node'; import {createSolanaKitSigner} from '@privy-io/node/solana-kit'; import {address} from '@solana/kit'; // Set up the Privy client and signer const privy = new PrivyClient({appId: 'your-app-id', appSecret: 'your-app-secret'}); const signer = createSolanaKitSigner(privy, { walletId: 'insert-wallet-id', address: address('insert-wallet-address'), authorizationContext: { authorization_private_keys: ['authorization-key'] } }); ``` Signing messages You can sign messages using helper functions provided by `@solana/kit`, or by calling the `signMessages` method directly: ```ts Ergonomic theme={"system"} import {PrivyClient} from '@privy-io/node'; import {createSolanaKitSigner} from '@privy-io/node/solana-kit'; import {address, signOffchainMessageWithSigners, type OffchainMessage} from '@solana/kit'; // Set up the Privy client and signer const privy = new PrivyClient({appId: 'your-app-id', appSecret: 'your-app-secret'}); const signer = createSolanaKitSigner(privy, { walletId: 'insert-wallet-id', address: address('insert-wallet-address') }); const offchainMessage: OffchainMessage = { version: 1, content: 'Hello, world!', requiredSignatories: [signer] }; const signedEnvelope = await signOffchainMessageWithSigners(offchainMessage); ``` ```ts Direct theme={"system"} import {PrivyClient} from '@privy-io/node'; import {createSolanaKitSigner} from '@privy-io/node/solana-kit'; import {address, createSignableMessage} from '@solana/kit'; // Set up the Privy client and signer const privy = new PrivyClient({appId: 'your-app-id', appSecret: 'your-app-secret'}); const signer = createSolanaKitSigner(privy, { walletId: 'insert-wallet-id', address: address('insert-wallet-address') }); const message = createSignableMessage('Hello, world!'); const signatures = await signer.signMessages([message]); ``` Signing transactions You can sign transactions using `@solana/kit`’s transaction building utilities: ```ts theme={"system"} import {PrivyClient} from '@privy-io/node'; import {createSolanaKitSigner} from '@privy-io/node/solana-kit'; import { address, createTransactionMessage, pipe, setTransactionMessageFeePayerSigner, signTransactionMessageWithSigners } from '@solana/kit'; // Set up the Privy client and signer const privy = new PrivyClient({appId: 'your-app-id', appSecret: 'your-app-secret'}); const signer = createSolanaKitSigner(privy, { walletId: 'insert-wallet-id', address: address('insert-wallet-address') }); const transactionMessage = pipe( createTransactionMessage({version: 0}), // This sets both the fee payer address *and* uses the underlying signer. (m) => setTransactionMessageFeePayerSigner(signer, m) // Add instructions, lifetime, etc. ); const signedTransaction = await signTransactionMessageWithSigners(transactionMessage); ``` Signing and sending transactions To sign and send transactions, you must provide the `caip2` parameter when creating the signer: ```ts theme={"system"} import {PrivyClient} from '@privy-io/node'; import {createSolanaKitSigner} from '@privy-io/node/solana-kit'; import { address, createTransactionMessage, pipe, setTransactionMessageFeePayerSigner, signAndSendTransactionMessageWithSigners } from '@solana/kit'; // Set up the Privy client and signer const privy = new PrivyClient({appId: 'your-app-id', appSecret: 'your-app-secret'}); const signer = createSolanaKitSigner(privy, { walletId: 'insert-wallet-id', address: address('insert-wallet-address'), caip2: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1' // Solana Devnet }); // The signer can now be used with signAndSendTransactionMessageWithSigners const transactionMessage = pipe( createTransactionMessage({version: 0}), (m) => setTransactionMessageFeePayerSigner(signer, m) // Add instructions, lifetime, etc. ); const signedTransaction = await signAndSendTransactionMessageWithSigners(transactionMessage); ``` Common CAIP-2 identifiers for Solana: * Mainnet: `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` * Testnet: `solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z` * Devnet: `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1`

Embedded wallets

Using wallets

Custodial wallets

External wallets

Global wallets