@phoenix-wallet/solana

Solana blockchain support for Phoenix Wallet - comprehensive wallet adapter for Solana ecosystem.

Overview

This package provides full support for Solana blockchain, including wallet connectors compatible with Solana's wallet-standard and popular Solana wallets.

Features

• 🔌 Wallet-Standard Compatible: Full support for Solana wallet-standard
• 🦊 Popular Wallets: Phantom, Solflare, Backpack, and more via wallet-standard
• 🔄 Cluster Support: Mainnet, Devnet, Testnet, and custom clusters
• 📝 Transaction Support: Legacy and Versioned transactions
• 🔐 Signing: Message and transaction signing
• 💰 SPL Tokens: Built-in SPL token support
• ⚡ Fast: Optimized for Solana's high-speed transactions

Installation

# Using pnpm (recommended)
pnpm add @phoenix-wallet/core @phoenix-wallet/solana @solana/web3.js @solana/spl-token

# Using npm
npm install @phoenix-wallet/core @phoenix-wallet/solana @solana/web3.js @solana/spl-token

# Using yarn
yarn add @phoenix-wallet/core @phoenix-wallet/solana @solana/web3.js @solana/spl-token

Quick Start

Basic Setup

import { WalletProvider } from '@phoenix-wallet/core';
import { SolanaConnector, SolanaCluster } from '@phoenix-wallet/solana';
import { PhantomWalletAdapter } from '@solana/wallet-adapter-phantom';

const solanaChainConfigs = [
  {
    id: 'solana_mainnet',
    name: 'Solana Mainnet',
    chainId: 'mainnet-beta',
    rpcUrl: 'https://api.mainnet-beta.solana.com',
    nativeCurrency: {
      name: 'SOL',
      symbol: 'SOL',
      decimals: 9
    },
    blockExplorerUrl: 'https://explorer.solana.com'
  },
  {
    id: 'solana_devnet',
    name: 'Solana Devnet',
    chainId: 'devnet',
    rpcUrl: 'https://api.devnet.solana.com',
    nativeCurrency: {
      name: 'SOL',
      symbol: 'SOL',
      decimals: 9
    },
    blockExplorerUrl: 'https://explorer.solana.com?cluster=devnet'
  }
];

const connectors = [
  new SolanaConnector({
    id: 'phantom-solana',
    name: 'Phantom',
    logo: 'https://phantom.app/img/logo.png',
    adapter: new PhantomWalletAdapter(),
    cluster: SolanaCluster.MAINNET,
    dappMetadata: {
      name: 'My DApp',
      url: 'https://mydapp.com',
      icon: 'https://mydapp.com/icon.png'
    }
  })
];

function App() {
  return (
    <WalletProvider connectors={connectors} chainConfigs={solanaChainConfigs}>
      <YourApp />
    </WalletProvider>
  );
}

Using the Wallet

import { useWallet } from '@/hooks/useWallet';
import { 
  SystemProgram, 
  Transaction, 
  PublicKey,
  LAMPORTS_PER_SOL 
} from '@solana/web3.js';

function WalletComponent() {
  const { 
    wallet, 
    isConnected, 
    address, 
    connect, 
    disconnect 
  } = useWallet('phantom-solana');

  const handleConnect = async () => {
    await connect();
  };

  const handleSignMessage = async () => {
    if (!wallet) return;
    const message = new TextEncoder().encode('Hello, Solana!');
    const signature = await wallet.signMessage(message);
    console.log('Signature:', signature);
  };

  const handleSendSOL = async () => {
    if (!wallet) return;
    
    const transaction = new Transaction().add(
      SystemProgram.transfer({
        fromPubkey: new PublicKey(address),
        toPubkey: new PublicKey('recipient_address'),
        lamports: 0.1 * LAMPORTS_PER_SOL // 0.1 SOL
      })
    );
    
    const txHash = await wallet.sendTransaction(transaction);
    console.log('Transaction hash:', txHash);
  };

  return (
    <div>
      {!isConnected ? (
        <button onClick={handleConnect}>Connect Phantom</button>
      ) : (
        <div>
          <p>Connected: {address}</p>
          <button onClick={handleSignMessage}>Sign Message</button>
          <button onClick={handleSendSOL}>Send SOL</button>
          <button onClick={disconnect}>Disconnect</button>
        </div>
      )}
    </div>
  );
}

Supported Wallets

The package supports all wallets that implement Solana's wallet-standard:

• Phantom - Most popular Solana wallet
• Solflare - Feature-rich Solana wallet
• Backpack - Multi-chain wallet with Solana support
• Glow - Solana wallet with staking
• Slope - Mobile-first Solana wallet
• Coin98 - Multi-chain wallet
• And any other wallet-standard compatible wallet

Using Wallet-Standard

import { getWallets } from '@wallet-standard/core';
import { isWalletAdapterCompatibleWallet, StandardWalletAdapter } from '@solana/wallet-standard-wallet-adapter-base';
import { SolanaConnector, SolanaCluster } from '@phoenix-wallet/solana';

// Automatically detect all installed wallets
const wallets = getWallets();
const solanaConnectors = wallets
  .get()
  .filter(isWalletAdapterCompatibleWallet)
  .map(wallet => {
    const adapter = new StandardWalletAdapter({ wallet });
    return new SolanaConnector({
      id: `${wallet.name.toLowerCase()}-solana`,
      name: wallet.name,
      logo: wallet.icon,
      adapter: adapter,
      cluster: SolanaCluster.MAINNET,
      dappMetadata: {
        name: 'My DApp',
        url: 'https://mydapp.com'
      }
    });
  });

Cluster Configuration

Available Clusters

enum SolanaCluster {
  MAINNET = 'mainnet-beta',
  DEVNET = 'devnet',
  TESTNET = 'testnet',
  CUSTOM = 'custom'
}

Custom RPC Configuration

const connector = new SolanaConnector({
  id: 'phantom-solana',
  name: 'Phantom',
  logo: 'https://phantom.app/img/logo.png',
  adapter: new PhantomWalletAdapter(),
  cluster: SolanaCluster.CUSTOM,
  customRpcUrl: 'https://your-custom-rpc.com',
  dappMetadata: { /* ... */ }
});

Transaction Types

Legacy Transactions

import { Transaction, SystemProgram, PublicKey } from '@solana/web3.js';

const transaction = new Transaction().add(
  SystemProgram.transfer({
    fromPubkey: new PublicKey(fromAddress),
    toPubkey: new PublicKey(toAddress),
    lamports: amount
  })
);

const signature = await wallet.sendTransaction(transaction);

Versioned Transactions

import { 
  VersionedTransaction, 
  TransactionMessage,
  PublicKey 
} from '@solana/web3.js';

const message = new TransactionMessage({
  payerKey: new PublicKey(address),
  recentBlockhash: blockhash,
  instructions: [/* your instructions */]
}).compileToV0Message();

const transaction = new VersionedTransaction(message);
const signature = await wallet.sendTransaction(transaction);

Sign Multiple Transactions

const transactions = [transaction1, transaction2, transaction3];
const signedTransactions = await wallet.signAllTransactions(transactions);

SPL Token Operations

Transfer SPL Tokens

import { 
  getAssociatedTokenAddress,
  createTransferInstruction 
} from '@solana/spl-token';
import { Transaction, PublicKey } from '@solana/web3.js';

async function transferToken(
  wallet: SolanaWallet,
  mintAddress: string,
  toAddress: string,
  amount: number
) {
  const fromTokenAccount = await getAssociatedTokenAddress(
    new PublicKey(mintAddress),
    new PublicKey(wallet.address)
  );
  
  const toTokenAccount = await getAssociatedTokenAddress(
    new PublicKey(mintAddress),
    new PublicKey(toAddress)
  );
  
  const transaction = new Transaction().add(
    createTransferInstruction(
      fromTokenAccount,
      toTokenAccount,
      new PublicKey(wallet.address),
      amount
    )
  );
  
  return await wallet.sendTransaction(transaction);
}

Contract Interactions

Using SolanaContract

import { SolanaContract } from '@phoenix-wallet/solana';

const contract = new SolanaContract(
  programId,
  wallet
);

// Call program
const result = await contract.call('methodName', [param1, param2]);

// Send transaction to program
const txHash = await contract.send('methodName', [param1, param2]);

API Reference

SolanaWallet

class SolanaWallet {
  address: string;
  chain: SolanaChain;
  connector: SolanaConnector;
  walletClient: SolanaWalletClient;
  
  // Get SOL balance
  getBalance(): Promise<string>;
  
  // Sign message
  signMessage(message: Uint8Array): Promise<Uint8Array>;
  
  // Sign transaction
  signTransaction(transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
  
  // Sign multiple transactions
  signAllTransactions(transactions: (Transaction | VersionedTransaction)[]): Promise<(Transaction | VersionedTransaction)[]>;
  
  // Send transaction
  sendTransaction(transaction: Transaction | VersionedTransaction): Promise<string>;
  
  // Send raw transaction
  sendRawTransaction(signedTx: string): Promise<string>;
}

SolanaChain

class SolanaChain {
  id: string;
  name: string;
  cluster: SolanaCluster;
  rpcUrl: string;
  provider: Connection;
  
  getBalance(address: string): Promise<string>;
  getLatestBlockhash(): Promise<{ blockhash: string; lastValidBlockHeight: number }>;
}

Error Handling

try {
  await wallet.sendTransaction(transaction);
} catch (error) {
  if (error.code === 4001) {
    console.log('User rejected the transaction');
  } else if (error.code === -32603) {
    console.log('Transaction simulation failed');
  } else {
    console.error('Transaction failed:', error);
  }
}

TypeScript Support

Full TypeScript support with comprehensive type definitions:

import type { 
  SolanaWallet, 
  SolanaChain, 
  SolanaConnector,
  SolanaWalletClient 
} from '@phoenix-wallet/solana';

Related Packages

• @phoenix-wallet/core - Core interfaces and types
• @phoenix-wallet/evm - EVM blockchain support
• @phoenix-wallet/aptos - Aptos blockchain support
• @phoenix-wallet/sui - Sui blockchain support
• @phoenix-wallet/privy - Privy authentication integration

Resources

• Solana Documentation
• Solana Web3.js
• SPL Token Documentation
• Wallet-Standard

License

MIT

Support

For issues and questions, please visit our GitHub repository.