Struct GoldRushClient 

pub struct GoldRushClient { /* private fields */ }

The main GoldRush client for interacting with the API.

Implementations

impl GoldRushClient

pub fn new<S: Into<String>>( api_key: S, config: ClientConfig, ) -> Result<Self, Error>

Create a new GoldRush client with the provided API key and configuration.

Arguments

• api_key - Your GoldRush API key
• config - Client configuration options

Example

use goldrush_sdk::{GoldRushClient, ClientConfig};

let client = GoldRushClient::new("your-api-key", ClientConfig::default())?;

pub fn with_key<S: Into<String>>(api_key: S) -> Result<Self, Error>

Create a new GoldRush client with default configuration.

Arguments

• api_key - Your GoldRush API key

Example

use goldrush_sdk::GoldRushClient;

let client = GoldRushClient::with_key("your-api-key")?;

pub fn metrics(&self) -> Option<&Arc<MetricsCollector>>

Get access to the metrics collector (if enabled).

impl GoldRushClient

pub async fn get_token_balances_for_wallet_address( &self, chain_name: &str, address: &str, options: Option<BalancesOptions>, ) -> Result<BalancesResponse, Error>

Get token balances for a wallet address.

Arguments

• chain_name - The blockchain name (e.g., “eth-mainnet”, “matic-mainnet”)
• address - The wallet address to query
• options - Optional query parameters

Example

use goldrush_sdk::{GoldRushClient, BalancesOptions};

let options = BalancesOptions::new()
    .quote_currency("USD")
    .no_spam(true);
     
let balances = client
    .get_token_balances_for_wallet_address(
        "eth-mainnet",
        "0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de",
        Some(options)
    )
    .await?;

pub async fn get_historical_portfolio_for_wallet_address( &self, chain_name: &str, address: &str, options: Option<BalancesOptions>, ) -> Result<BalancesResponse, Error>

Get historical portfolio balances for an address.

Arguments

• chain_name - The blockchain name
• address - The wallet address to query
• options - Optional query parameters

Example

use goldrush_sdk::GoldRushClient;

let portfolio = client
    .get_historical_portfolio_for_wallet_address(
        "eth-mainnet",
        "0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de",
        None
    )
    .await?;

impl GoldRushClient

pub async fn get_all_transactions_for_address( &self, chain_name: &str, address: &str, options: Option<TxOptions>, ) -> Result<TransactionsResponse, Error>

Get all transactions for an address.

Arguments

• chain_name - The blockchain name (e.g., “eth-mainnet”, “matic-mainnet”)
• address - The wallet address to query
• options - Optional query parameters

Example

use goldrush_sdk::{GoldRushClient, TxOptions};

let options = TxOptions::new()
    .page_size(10)
    .quote_currency("USD");
     
let transactions = client
    .get_all_transactions_for_address(
        "eth-mainnet",
        "0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de",
        Some(options)
    )
    .await?;

pub async fn get_transaction( &self, chain_name: &str, tx_hash: &str, ) -> Result<TransactionResponse, Error>

Get a specific transaction by hash.

Arguments

• chain_name - The blockchain name
• tx_hash - The transaction hash

Example

use goldrush_sdk::GoldRushClient;

let transaction = client
    .get_transaction(
        "eth-mainnet",
        "0x1234567890abcdef..."
    )
    .await?;

pub async fn get_transactions_between_addresses( &self, chain_name: &str, from_address: &str, to_address: &str, options: Option<TxOptions>, ) -> Result<TransactionsResponse, Error>

Get transactions between two addresses.

Arguments

• chain_name - The blockchain name
• from_address - The sender address
• to_address - The recipient address
• options - Optional query parameters

Example

use goldrush_sdk::GoldRushClient;

let transactions = client
    .get_transactions_between_addresses(
        "eth-mainnet",
        "0xfrom...",
        "0xto...",
        None
    )
    .await?;

impl GoldRushClient

pub async fn get_nfts_for_address( &self, chain_name: &str, address: &str, options: Option<NftOptions>, ) -> Result<NftsResponse, Error>

Get NFTs owned by an address.

Arguments

• chain_name - The blockchain name (e.g., “eth-mainnet”, “matic-mainnet”)
• address - The wallet address to query
• options - Optional query parameters

Example

use goldrush_sdk::{GoldRushClient, NftOptions};

let options = NftOptions::new()
    .page_size(10)
    .with_metadata(true)
    .no_spam(true);
     
let nfts = client
    .get_nfts_for_address(
        "eth-mainnet",
        "0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de",
        Some(options)
    )
    .await?;

pub async fn get_nft_metadata( &self, chain_name: &str, contract_address: &str, token_id: &str, ) -> Result<NftMetadataResponse, Error>

Get metadata for a specific NFT.

Arguments

• chain_name - The blockchain name
• contract_address - The NFT collection contract address
• token_id - The specific token ID

Example

use goldrush_sdk::GoldRushClient;

let metadata = client
    .get_nft_metadata(
        "eth-mainnet",
        "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
        "1"
    )
    .await?;

pub async fn get_nfts_for_collection( &self, chain_name: &str, contract_address: &str, options: Option<NftOptions>, ) -> Result<NftsResponse, Error>

Get all NFTs from a specific collection.

Arguments

• chain_name - The blockchain name
• contract_address - The NFT collection contract address
• options - Optional query parameters

Example

use goldrush_sdk::GoldRushClient;

let collection_nfts = client
    .get_nfts_for_collection(
        "eth-mainnet",
        "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
        None
    )
    .await?;

pub async fn get_nft_owners_for_collection( &self, chain_name: &str, contract_address: &str, options: Option<NftOptions>, ) -> Result<NftsResponse, Error>

Get NFT owners for a specific collection.

Arguments

• chain_name - The blockchain name
• contract_address - The NFT collection contract address
• options - Optional query parameters

Example

use goldrush_sdk::GoldRushClient;

let owners = client
    .get_nft_owners_for_collection(
        "eth-mainnet",
        "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
        None
    )
    .await?;