Solana Connection

Overview

The Solana connection allows you to interact with the Solana blockchain, query data, and prepare transactions using the Flutter Solana package.

Prerequisites

Dynamic SDK initialized (see Quickstart)
User authenticated (see Authentication)
Solana wallets enabled in your Dynamic dashboard
dynamic_sdk_solana package installed

Create Connection

import 'package:dynamic_sdk/dynamic_sdk.dart';

final sdk = DynamicSDK.instance;

void createConnection() {
  final connection = sdk.solana.createConnection();
  print('Solana connection created');
}

Get Latest Blockhash

Required for building transactions:

import 'package:dynamic_sdk/dynamic_sdk.dart';
import 'package:solana/solana.dart';

final sdk = DynamicSDK.instance;

Future<String> getBlockhash() async {
  final connection = sdk.solana.createConnection();
  final result = await connection.getLatestBlockhash();
  print('Latest blockhash: ${result.blockhash}');
  return result.blockhash;
}

Query Account Balance

import 'package:dynamic_sdk/dynamic_sdk.dart';
import 'package:solana/solana.dart';

final sdk = DynamicSDK.instance;

Future<int> getBalance(String address) async {
  try {
    final connection = sdk.solana.createConnection();
    final pubkey = Pubkey.fromString(address);
    final balance = await connection.getBalance(pubkey);
    return balance;
  } catch (e) {
    print('Failed to get balance: $e');
    rethrow;
  }
}

Get Solana Wallets

import 'package:dynamic_sdk/dynamic_sdk.dart';

final sdk = DynamicSDK.instance;

List<BaseWallet> getSolanaWallets() {
  final solanaWallets = sdk.wallets.userWallets.where(
    (wallet) => wallet.chain.toUpperCase() == 'SOL',
  ).toList();

  for (final wallet in solanaWallets) {
    print('Address: ${wallet.address}');
  }

  return solanaWallets;
}

Solana Networks

Access configured Solana networks:

final sdk = DynamicSDK.instance;

void displaySolanaNetworks() {
  final solanaNetworks = sdk.networks.solana;

  for (final network in solanaNetworks) {
    print('Network: ${network.name}');
  }
}

import 'package:flutter/material.dart';
import 'package:dynamic_sdk/dynamic_sdk.dart';
import 'package:solana/solana.dart';

class SolanaBalanceWidget extends StatefulWidget {
  final BaseWallet wallet;

  const SolanaBalanceWidget({Key? key, required this.wallet}) : super(key: key);

  @override
  State<SolanaBalanceWidget> createState() => _SolanaBalanceWidgetState();
}

class _SolanaBalanceWidgetState extends State<SolanaBalanceWidget> {
  final sdk = DynamicSDK.instance;
  int? balance;
  bool isLoading = false;
  String? error;

  @override
  void initState() {
    super.initState();
    _fetchBalance();
  }

  Future<void> _fetchBalance() async {
    setState(() {
      isLoading = true;
      error = null;
    });

    try {
      final connection = sdk.solana.createConnection();
      final pubkey = Pubkey.fromString(widget.wallet.address);
      final balanceValue = await connection.getBalance(pubkey);

      setState(() => balance = balanceValue);
    } catch (e) {
      setState(() => error = 'Failed to fetch balance: $e');
    } finally {
      setState(() => isLoading = false);
    }
  }

  String formatBalance(int lamports) {
    final sol = lamports / 1e9;
    return '${sol.toStringAsFixed(4)} SOL';
  }

  @override
  Widget build(BuildContext context) {
    return Card(
      child: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Row(
              mainAxisAlignment: MainAxisAlignment.spaceBetween,
              children: [
                const Text(
                  'Balance',
                  style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
                ),
                IconButton(
                  icon: const Icon(Icons.refresh),
                  onPressed: _fetchBalance,
                ),
              ],
            ),
            const SizedBox(height: 8),
            if (isLoading)
              const Center(child: CircularProgressIndicator())
            else if (balance != null)
              Text(
                formatBalance(balance!),
                style: const TextStyle(
                  fontSize: 24,
                  fontWeight: FontWeight.bold,
                ),
              )
            else if (error != null)
              Text(
                error!,
                style: const TextStyle(color: Colors.red, fontSize: 12),
              ),
          ],
        ),
      ),
    );
  }
}

Connection Methods

Method	Description
`createConnection()`	Create a Solana connection instance
`getLatestBlockhash()`	Get the latest blockhash for transactions
`getBalance(pubkey)`	Get account balance in lamports
`getAccountInfo(pubkey)`	Get detailed account information

Balance Conversion Helpers

class SolanaConverter {
  /// Convert lamports to SOL
  static double lamportsToSol(int lamports) {
    return lamports / 1e9;
  }

  /// Convert SOL to lamports
  static int solToLamports(double sol) {
    return (sol * 1e9).toInt();
  }

  /// Format balance for display
  static String formatBalance(int lamports, {int decimals = 4}) {
    final sol = lamportsToSol(lamports);
    return '${sol.toStringAsFixed(decimals)} SOL';
  }
}

// Usage
final lamports = 1500000000; // 1.5 SOL
final formatted = SolanaConverter.formatBalance(lamports);
print(formatted); // "1.5000 SOL"

Complete Balance Display

import 'package:flutter/material.dart';
import 'package:dynamic_sdk/dynamic_sdk.dart';
import 'package:solana/solana.dart';

class SolanaAccountInfo extends StatelessWidget {
  final BaseWallet wallet;

  const SolanaAccountInfo({Key? key, required this.wallet}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<Map<String, dynamic>>(
      future: _getAccountInfo(),
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(child: CircularProgressIndicator());
        }

        if (snapshot.hasError) {
          return Text(
            'Error: ${snapshot.error}',
            style: const TextStyle(color: Colors.red),
          );
        }

        if (snapshot.hasData) {
          final data = snapshot.data!;
          return Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Text('Address: ${data['address']}'),
              const SizedBox(height: 8),
              Text(
                'Balance: ${data['balance']}',
                style: const TextStyle(
                  fontSize: 20,
                  fontWeight: FontWeight.bold,
                ),
              ),
              const SizedBox(height: 8),
              Text('Blockhash: ${data['blockhash']}'),
            ],
          );
        }

        return const Text('No data available');
      },
    );
  }

  Future<Map<String, dynamic>> _getAccountInfo() async {
    final sdk = DynamicSDK.instance;
    final connection = sdk.solana.createConnection();

    final pubkey = Pubkey.fromString(wallet.address);
    final balance = await connection.getBalance(pubkey);
    final blockhash = await connection.getLatestBlockhash();

    return {
      'address': wallet.address,
      'balance': SolanaConverter.formatBalance(balance),
      'blockhash': blockhash.blockhash,
    };
  }
}

Error Handling

Future<int?> getBalanceSafely(String address) async {
  try {
    final sdk = DynamicSDK.instance;
    final connection = sdk.solana.createConnection();
    final pubkey = Pubkey.fromString(address);
    return await connection.getBalance(pubkey);
  } catch (e) {
    print('Failed to get balance: $e');
    return null;
  }
}

Dependencies

To build Solana transactions, ensure you have the required package:

dependencies:
  dynamic_sdk_solana: ^1.0.0
  solana: ^0.30.0

Next Steps

Send Solana Transactions - Transfer SOL
Sign Solana Messages - Sign messages
Token Balances - Get SOL balance

Getting Started

Authentication

Wallets

Gasless

Flutter Specific

SDK Reference

Solana Connection

Overview

Prerequisites

Create Connection

Get Latest Blockhash

Query Account Balance

Get Solana Wallets

Solana Networks

Flutter Widget Example

Connection Methods

Balance Conversion Helpers

Complete Balance Display

Error Handling

Dependencies

Next Steps

​Overview

​Prerequisites

​Create Connection

​Get Latest Blockhash

​Query Account Balance

​Get Solana Wallets

​Solana Networks

​Flutter Widget Example

​Connection Methods

​Balance Conversion Helpers

​Complete Balance Display

​Error Handling

​Dependencies

​Next Steps

Overview

Prerequisites

Create Connection

Get Latest Blockhash

Query Account Balance

Get Solana Wallets

Solana Networks

Flutter Widget Example

Connection Methods

Balance Conversion Helpers

Complete Balance Display

Error Handling

Dependencies

Next Steps