Creating a Solana wallet

To create a Solana embedded wallet for your user, call the createSolanaWallet method on your PrivyUser instance.

public protocol PrivyUser {
  // Other privy user methods

  /// Creates an embedded Solana wallet for the user.
  func createSolanaWallet() async throws -> EmbeddedSolanaWallet
}

If a wallet is successfully created for the user, an EmbeddedSolanaWallet object is returned as an encapsulated value of Result.success.

This method will throw if:

• The user is not authenticated
• The user already has a Solana wallet
• If the network call to create the wallet fails

The Solana wallet

An EmbeddedSolanaWallet is defined as follows:

public protocol EmbeddedSolanaWallet {
 // The wallet's address
 var address: String { get }

 // Recovery method type
 var recoveryMethod: String? { get }

 // HD wallet index
 var hdWalletIndex: Int { get }

 // Chain type - in this case, ChainType.solana
 var chainType: ChainType { get }

 // A hook to an EmbeddedSolanaWalletProvider instance for this wallet
 var provider: EmbeddedSolanaWalletProvider { get }
}

Using the wallet

Privy supports requesting signatures on messages and transactions from a user's Solana embedded wallet using the signMessage RPC. To request a signature, get the Solana embedded wallet provider and call the signMessage method on it with a base-64 encoded message to sign. If the signature is computed successfully, signMessage will return it as a base64-encoded string.

public protocol EmbeddedSolanaWalletProvider {
  /**
   * Request a signature on a Base64 encoded message or transaction
   *
   * @param message Base64 encoded message or transaction
   * @return The Base64 encoded computed signature
   */
  func signMessage(message: String) async throws -> String
}

Example usage:

// Get current auth state
val user = privy.user

// check if user is authenticated
if (user != null) {
    // Retrieve list of user's Solana wallet
    val solanaWallet = user.embeddedSolanaWallets.first()

    if (solanaWallet != null) {
        // Sign a message
        val result = solanaWallet.provider.signMessage("SGVsbG8hIEkgYW0gdGhlIGJhc2U2NCBlbmNvZGVkIG1lc3NhZ2UgdG8gYmUgc2lnbmVkLg==")
    }
}

// check if user is authenticated
if let user = privy.user {
  // Retrieve list of user's embedded Solana wallets
  let solanaWallets = user.embeddedSolanaWallets
  // Grab the desired wallet. Here, we retrieve the first wallet
  guard let solanaWallet = solanaWallets.first else {
    // No SOL wallets
    return
  }

  try await solanaWallet.provider.signMessage("SGVsbG8hIEkgYW0gdGhlIGJhc2U2NCBlbmNvZGVkIG1lc3NhZ2UgdG8gYmUgc2lnbmVkLg==")
}

Retrieving a user's Solana wallets

To retrieve all of a user's Solana wallets:

1. Ensure the user is authenticated
2. Grab the user's Solana wallets.

// check if user is authenticated
guard let user = privy.user { return }

// Retrieve list of user's embedded Solana wallet
let solanaWallets = user.embeddedSolanaWallets