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):
- Hub V2 (ERC-1155), Name Registry, Migration, Base Mint Policy, Vaults, Standard Treasury.
- Contract sources: https://github.com/aboutcircles/circles-contracts-v2
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.