Struct LightspeedClientBuilder 

pub struct LightspeedClientBuilder { /* private fields */ }

Builder for creating Lightspeed client instances

Provides a fluent interface for configuring the client before initialization.

Example

use lightspeed_sdk::{LightspeedClientBuilder, Priority};
use std::time::Duration;
 
let client = LightspeedClientBuilder::new("your-api-key")
    .svs_rpc_url("https://basic.rpc.solanavibestation.com") 
    .default_priority(Priority::Standard)
    .timeout(Duration::from_secs(60))
    .debug(true)
    .build()?;

Implementations

impl LightspeedClientBuilder

pub fn new(api_key: impl Into<String>) -> Self

Creates a new builder with the required API key

Arguments

• api_key - Your Lightspeed API key from Solana Vibe Station

pub fn svs_rpc_url(self, url: impl Into<String>) -> Self

Sets the SVS RPC URL

Arguments

• url - Your SVS RPC endpoint URL (e.g., “https://basic.rpc.solanavibestation.com”)

The URL will be automatically converted to the Lightspeed endpoint format.

pub fn default_priority(self, priority: Priority) -> Self

Sets the default priority for transactions

Transactions sent without specifying priority will use this setting.

Arguments

• priority - Default priority level

pub fn timeout(self, timeout: Duration) -> Self

Sets the HTTP request timeout

Arguments

• timeout - Maximum duration for HTTP requests

pub fn keep_alive_interval(self, interval: Duration) -> Self

Sets the keep-alive interval

Determines how frequently keep-alive requests are sent when automatic keep-alive is enabled.

Arguments

• interval - Duration between keep-alive requests

pub fn use_https(self, enabled: bool) -> Self

Enables or disables HTTPS

Arguments

• enabled - Whether to use HTTPS (recommended for production)

pub fn debug(self, enabled: bool) -> Self

Enables or disables debug logging

Arguments

• enabled - Whether to enable debug output

pub fn custom_endpoint(self, endpoint: impl Into<String>) -> Self

Sets a custom endpoint URL

This is primarily intended for testing or connecting to alternative Lightspeed deployments. When set, this overrides the SVS RPC URL processing.

Arguments

• endpoint - Custom endpoint URL

pub fn balance_check_rpc_url(self, url: impl Into<String>) -> Self

Sets the Solana RPC URL for balance checks

This RPC endpoint is used to query account balances before sending transactions (when balance checking is enabled). Defaults to the public SVS endpoint.

Arguments

• url - Solana RPC endpoint URL

pub fn check_balance_before_send(self, enabled: bool) -> Self

Enables or disables balance checking before sending transactions

When enabled, the client will verify sufficient balance via RPC before submitting transactions. This prevents wasting transaction fees on transactions that will fail due to insufficient funds.

Arguments

• enabled - Whether to check balance before sending

pub fn build(self) -> Result<LightspeedClient, LightspeedError>

Builds and returns the configured Lightspeed client

Errors

Returns an error if client initialization fails due to invalid configuration or network issues.