Skip to content

The Circles Stack

Rust crate view of the Circles stack (read-only today):

  • circles-types: Complete protocol types (avatars, trust, tokens, events, query DSL).
  • circles-pathfinder: Computes flow matrices and contract params for trust-based transfers.
  • circles-rpc: JSON-RPC client with query, balance, events, groups, trust helpers.
  • circles-profiles: Profile fetch helpers (backed by profile service / IPFS).
  • utils/abis: Supporting crates for contract ABI access and helpers.

Contracts (Gnosis Chain):

Pathfinder/Indexing:

  • Nethermind plugin indexes events and exposes RPC; pathfinder consumes the trust graph to route flows.

Use cases (read-only today):

  • Query profiles, balances, trust relations, groups, events.
  • Prepare flows for transfers (contract params ready; sending awaits runner).

Runner-based writes (invites, minting, transfers, wrapping) will be added once the Rust runner is available.