Struct SolanaClient 

pub struct SolanaClient { /* private fields */ }

Solana blockchain client.

Supports balance queries via JSON-RPC and optional transaction history via Solscan API.

Implementations

impl SolanaClient

pub fn new(config: &ChainsConfig) -> Result<Self>

Creates a new Solana client with the given configuration.

Arguments

• config - Chain configuration containing RPC endpoint and API keys

Returns

Returns a configured SolanaClient instance.

Examples

use scope::chains::SolanaClient;
use scope::config::ChainsConfig;

let config = ChainsConfig::default();
let client = SolanaClient::new(&config).unwrap();

pub fn with_rpc_url(rpc_url: &str) -> Self

Creates a client with a custom RPC URL.

Arguments

• rpc_url - The Solana JSON-RPC endpoint URL

pub fn chain_name(&self) -> &str

Returns the chain name.

pub fn native_token_symbol(&self) -> &str

Returns the native token symbol.

pub async fn get_balance(&self, address: &str) -> Result<Balance>

Fetches the SOL balance for an address.

Arguments

• address - The Solana address (base58 encoded)

Returns

Returns a Balance struct with the balance in multiple formats.

Errors

Returns ScopeError::InvalidAddress if the address format is invalid. Returns ScopeError::Request if the API request fails.

pub async fn get_token_info(&self, mint_address: &str) -> Result<Token>

Fetches SPL token (mint) info from RPC.

Parses decimals from the mint account data. Symbol and name use placeholders (Solscan Pro API would provide full metadata).

pub async fn enrich_balance_usd(&self, balance: &mut Balance)

Enriches a balance with a USD value using DexScreener price lookup.

pub async fn get_token_balances( &self, address: &str, ) -> Result<Vec<TokenBalance>>

Fetches all SPL token balances for an address.

Arguments

• address - The Solana wallet address to query

Returns

Returns a vector of TokenBalance containing all SPL tokens held by the address.

Errors

Returns ScopeError::InvalidAddress if the address format is invalid. Returns ScopeError::Request if the API request fails.

pub async fn get_signatures( &self, address: &str, limit: u32, ) -> Result<Vec<String>>

Fetches recent transaction signatures for an address.

Arguments

• address - The Solana address to query
• limit - Maximum number of signatures to return

Returns

Returns a vector of transaction signatures.

pub async fn get_transaction(&self, signature: &str) -> Result<Transaction>

Fetches transaction details by signature.

Arguments

• signature - The transaction signature (base58 encoded)

Returns

Returns Transaction details.

pub async fn get_transactions( &self, address: &str, limit: u32, ) -> Result<Vec<Transaction>>

Fetches recent transactions for an address.

Arguments

• address - The address to query
• limit - Maximum number of transactions

Returns

Returns a vector of Transaction objects.

pub async fn get_slot(&self) -> Result<u64>

Fetches the current slot number (equivalent to block number).

Trait Implementations

impl ChainClient for SolanaClient

fn chain_name(&self) -> &str

Returns the name of the blockchain network.

fn native_token_symbol(&self) -> &str

Returns the native token symbol (e.g., “ETH”, “MATIC”).

fn get_balance<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Balance>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches the native token balance for an address.

fn enrich_balance_usd<'life0, 'life1, 'async_trait>( &'life0 self, balance: &'life1 mut Balance, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Enriches a balance with USD valuation via DexScreener.

fn get_transaction<'life0, 'life1, 'async_trait>( &'life0 self, hash: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Transaction>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches transaction details by hash.

fn get_transactions<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, limit: u32, ) -> Pin<Box<dyn Future<Output = Result<Vec<Transaction>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches recent transactions for an address.

fn get_block_number<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetches the current block number.

fn get_token_info<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches token information for a contract address.

fn get_token_balances<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<TokenBalance>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches token balances for an address.

fn get_token_holders<'life0, 'life1, 'async_trait>( &'life0 self, _address: &'life1 str, _limit: u32, ) -> Pin<Box<dyn Future<Output = Result<Vec<TokenHolder>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches top token holders for a contract address.

fn get_token_holder_count<'life0, 'life1, 'async_trait>( &'life0 self, _address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches total token holder count for a contract address.

fn get_code<'life0, 'life1, 'async_trait>( &'life0 self, _address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches bytecode at address (EVM: eth_getCode). Returns “0x” for EOA, non-empty hex for contracts. Default: not supported.

impl Clone for SolanaClient

fn clone(&self) -> SolanaClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SolanaClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SolanaClient

fn default() -> Self

Returns the “default value” for a type.