An asynchronous Helius Rust SDK for building the future of Solana

The latest documentation can be found here on docs.rs

Interested in contributing to the Helius Rust SDK? Read the following contributions guide before opening up a pull request!

To start using the Helius Rust SDK in your project, add it as a dependency via cargo. Open your project's Cargo.toml and add the following line under [dependencies]:

helius = "x.y.z"

where x.y.z is your desired version. Alternatively, use cargo add helius to add the dependency directly via the command line. This will automatically find the latest version compatible with your project and add it to your Cargo.toml.

Remember to run cargo update regularly to fetch the latest version of the SDK.

The SDK provides a Helius instance that can be configured with an API key and a given Solana cluster. Developers can generate a new API key on the Helius Developer Dashboard. This instance acts as the main entry point for interacting with the SDK by providing methods to access different Solana and RPC client functionalities. The following code is an example of how to use the SDK to fetch info on Mad Lad #8420:

use helius::error::HeliusError;
use helius::types::{Cluster, DisplayOptions, GetAssetRequest, GetAssetResponseForAsset};

#[tokio::main]
async fn main() -> Result<(), HeliusError> {
    let api_key: &str = "YOUR_API_KEY";
    let cluster: Cluster = Cluster::MainnetBeta;

    let helius: Helius = Helius::new(api_key, cluster).unwrap();

    let request: GetAssetRequest = GetAssetRequest {
        id: "F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk".to_string(),
        display_options: Some(DisplayOptions {
            show_unverified_collections: false,
            show_collection_metadata: false,
            show_fungible: false,
            show_inscription: false,
        }),
    };

    let response: Result<Option<GetAssetResponseForAsset>, HeliusError> = helius.rpc().get_asset(request).await;

    match response {
        Ok(Some(asset)) => {
            println!("Asset: {:?}", asset);
        },
        Ok(None) => println!("No asset found."),
        Err(e) => println!("Error retrieving asset: {:?}", e),
    }

    Ok(())
}

The Helius client has an embedded Solana client that can be accessed via helius.connection().request_name() where request_name() is a given RPC method. A full list of all Solana RPC HTTP methods can be found here.

More examples of how to use the SDK can be found in the examples directory.

You may encounter several error codes when working with the Helius Rust SDK. Below is a table detailing some of the common error codes along with additional information to aid with troubleshooting:

If you encounter any of these errors:

• Refer to errors.rs for a list of all possible errors returned by the Helius client
• Refer to the Helius documentation for further guidance
• Reach out to the Helius support team for more detailed assistance

Our SDK is designed to provide a seamless developer experience when building on Solana. We've separated the core functionality into various segments:

• get_asset - Gets an asset by its ID
• get_asset_batch - Gets multiple assets by their ID
• get_asset_proof - Gets a merkle proof for a compressed asset by its ID
• get_asset_proof_batch - Gets multiple asset proofs by their IDs
• get_assets_by_owner - Gets a list of assets owned by a given address
• get_assets_by_authority - Gets a list of assets of a given authority
• get_assets_by_creator - Gets a list of assets of a given creator
• get_assets_by_group - Gets a list of assets by a group key and value
• search_assets - Gets assets based on the custom search criteria passed in
• get_signatures_for_asset - Gets transaction signatures for a given asset
• get_token_accounts - Gets information about all token accounts for a specific mint or owner
• get_nft_edition - Gets all the NFT editions associated with a specific master NFT
• get_rwa_asset - Gets a Real-World Asset (RWA) based on its mint address

• mint_compressed_nft - The easiest way to mint a compressed NFT (cNFT)

• parse_transactions - Parses transactions given an array of transaction IDs
• parsed_transaction_history - Retrieves a parsed transaction history for a specific address

• append_addresses_to_webhook - Appends a set of addresses to a given webhook
• create_webhook - Creates a webhook given account addresses
• delete_webhook - Deletes a given Helius webhook programmatically
• edit_webhook - Edits a Helius webhook programmatically
• get_all_webhooks - Retrieves all Helius webhooks programmatically
• get_webhook_by_id - Gets a webhook config given a webhook ID
• remove_addresses_from_webhook - Removes a list of addresses from an existing webhook by its ID

• get_priority_fee_estimate - Gets an estimate of the priority fees required for a transaction to be processed more quickly
• deserialize_str_to_number - Deserializes a String to a Number
• is_valid_solana_address - Returns whether a given string slice is a valid Solana address
• make_keypairs - Generates a specified number of keypairs