Skip to content

SDK Methods (Rust)

Method namespaces available via circles-rpc (all read-only today):

  • QueryMethods: circles_query, paged_query (tables: profiles, groups, groupMemberships, trustRelations, tokenBalances, etc.).
  • BalanceMethods: get_total_balance (v1/v2, raw or time-circles).
  • EventsMethods: circles_events (HTTP), subscribe_parsed_events / subscribe_circles_events (WS feature).
  • PathfinderMethods: RPC pathfinding endpoints (alternate to local circles-pathfinder crate).
  • AvatarMethods, GroupMethods, TokenMethods, TokenInfoMethods, TrustMethods, InvitationMethods, NetworkMethods, SearchMethods, TablesMethods, HealthMethods (stubs aligned with TS; many are wrappers over circles_query/RPC endpoints).

For transfers/writes, the runner layer will mirror TS methods once implemented.

Example: token info lookup (read-only)

use circles_rpc::{RpcClient, TokenInfoMethods};
use reqwest::Url;
 
#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let client = RpcClient::http(Url::parse("https://rpc.aboutcircles.com/")?);
    let tokens = TokenInfoMethods::new(client);
 
    let info = tokens.get_token_info("0xTokenAddressHere".parse()?).await?;
    println!("token info: {:?}", info);
    Ok(())
}