Skip to content

Circles Architecture

Circles architecture flow

Circles V2 Core Components

  • Hub V2 (ERC-1155): Registers human, group, and organization avatars; manages trust, minting of personal CRC tokens, group currencies, and demurrage.
  • Migration: Transitions legacy V1 hub avatars to V2; locks V1 CRC, stops V1 mint, and converts balances to V2.
  • Name Registry: Manages names, symbols, and metadata (base58, 12 chars) for avatars.
  • Base Mint Policy: Reference implementation for group minting, burning, and redeeming; policy address is immutable per group, custom policies allowed.
  • Vaults: Hold personal CRC collateral for group currencies; deployed per group by Standard Treasury and used during redemption.
  • Standard Treasury: Manages mint/redeem flows and routes collateral to the correct vault based on Hub data; verifies redemption data before releasing/burning collateral.

Rust crates map onto these components as follows:

  • circles-rpc for RPC/query/events/group/invitation/history access
  • circles-pathfinder for trust-graph routing and flow matrices
  • circles-transfers for ordered transaction assembly
  • circles-sdk for typed avatars, registration, invitations/referrals, and optional runner-backed execution
  • circles-types for shared protocol/query/event/config types