Skip to content

Circles SDK Overview (Rust)

The Rust SDK mirrors the TS SDK surface with strong typing and Alloy integration. Status: read-only (no runner writes yet).

Crates and roles:

  • circles-types: avatars, trust, tokens, events, query DSL, runner traits.
  • circles-pathfinder: pathfinding + contract-ready flow params.
  • circles-rpc: RPC client with methods for query, balances, events, groups, trust, tokens.
  • circles-profiles: profile helpers.
  • abis / utils: contract ABIs and helpers.

What works now:

  • Query profiles, balances, trust relations, groups, memberships, token balances.
  • Pathfinding and flow matrix preparation.
  • Event fetching/decoding (HTTP; WS with feature flag).

Coming with runner support:

  • Invites, minting (personal/group), transfers, wrapping/unwrapping, trust updates as writes.