awesome-circles
Awesome Circles: a curated list of resources for the Circles trust-based currency ecosystem on Gnosis Chain.
https://github.com/hellno/awesome-circles
Last synced: 12 days ago
JSON representation
-
APIs & Infrastructure
-
Developer Demos
- Circles JSON-RPC - `https://rpc.aboutcircles.com/`. Public RPC: `circles_query`, `circlesV2_findPath`, `circlesV2_getTotalBalance`, `circles_events`, and more.
- Pathfinder Service - Optimal routing through the trust graph, available via SDK or raw RPC.
- Circles Indexer / Query - SQL-style queries over indexed avatars, trust edges, balances, and transfers.
- circles-nethermind-plugin - Nethermind execution-client plugin that exposes the Circles RPC namespace from a self-hosted node.
- circles-spaceneth - Standalone Nethermind node bundled with indexer and contracts for local testing.
- crc-faucet - CRC faucet for testnets / demos.
- circles-migration-tool - Tooling for migrating accounts and balances from v1 to v2.
- invite-api - Express/TypeScript HTTP API for issuing and auditing Circles invitations, with optional Slack webhook integration.
- marketplace-api - Product-catalog aggregator and order API for the Circles Marketplace.
- Avatar event subscriptions - Stream balance, trust, and group events in real time.
-
-
Background Reading
-
Developer Demos
- Circles v2 Whitepaper - Canonical protocol whitepaper (PDF in repo).
- Glossary - Avatars, demurrage, hubs, mint policies, vaults, and more.
- Trust Score - How trust reputation is computed.
- Daily Burn / Demurrage - Why your balance shrinks 7%/year.
- Rule of Trust - How transitive trust enables strangers to pay each other.
-
-
Build a Mini App
- What are Circles Mini Apps - Embedded vs standalone, when to pick which.
- Embedded Mini App guide - Build a mini app that ships inside the official store.
- Intermediate Embedded guide - Advanced patterns for embedded apps.
- Standalone Mini App guide - Run anywhere, sign via QR or deep link.
- Contribute a Mini App - Slug, code at `src/routes/apps/<slug>/`, logo, `miniapps.json` entry, PR.
- Mini Apps Launchpad - Rolling bounties: $500 App of the Week, $1,000 Winner of the Month.
- CirclesMiniapps repo - The host SvelteKit app and the registry. Submit PRs here.
- oic_apps - Open Internet Club mini-app framework: metadata-driven configs, QR-code payments, real-time Circles RPC event monitoring.
-
Community
-
Developer Demos
- Telegram - About Circles - Main builders + users chat.
- @aboutcircles on X - Announcements and ecosystem updates.
- GitHub - aboutcircles - All official repositories.
-
-
Developer Tools
-
Developer Demos
- CirclesTools - Hub of browser utilities: Profile Checker, Group Checker / Creator / Manager, Trust Graph & Trust Path Visualizers, Personal CRC Replenisher, Circles Backing dApp, LBP Starter, Token Distribution Checker, Safe State & Tx Hash Checker, Equilibrium Analysis, Onboarding Helper, and Legacy Safe Creator.
- Pathfinder App - Compute and visualize optimal transfer routes through the trust network.
- CirclesTools source - Repository for the tools hub.
- flow-visualization - Source for the pathfinder flow visualizer.
- group-tms - Trust-Management Service: keeps a group's trust set in sync with declarative conditions.
- Developer Tools docs - Annotated index of every tool in the hub.
-
-
Explorers & Indexers
-
Developer Demos
- circles-explorer - Block-explorer-style UI for Circles transactions, events, humans, groups, and orgs.
- profile-service - Stores and retrieves avatar profile metadata via IPFS.
-
-
For AI Agents
-
Developer Demos
- Agentic Setup for Circles - Official guide: install [Context7 MCP](https://github.com/upstash/context7), point your agent at the `aboutcircles/circles-docs` and `aboutcircles/sdk` libraries, drop a `CLAUDE.md` / `.cursorrules` in the project root.
- llms.txt - Compact index of the docs, formatted for LLM ingestion.
- llms-full.txt - Full doc corpus in one file. Paste into a prompt or fetch from an agent.
- Doc query endpoint - `GET https://docs.aboutcircles.com/<path>.md?ask=<question>` returns an answer grounded in that page. Works for any doc page.
- Sitemap - Machine-readable index of every doc URL.
- Autonomous agent build branch - Reference mini-app build instructions written for autonomous agents.
-
-
Hackathon Projects
-
Developer Demos
- BraceBuddy - NFC bracelet onboarding for Circles (ETHGlobal Brussels 2024, 1st prize).
- Woleth - Telegram-embedded EVM wallet using Circles invite mechanics (ETHGlobal Brussels 2024, runner-up).
- Famjam - Family currency that rewards kids for good behavior (ETHGlobal Brussels 2024, runner-up).
- Voting with UBI - DAO voting weighted by Circles group tokens (ETHGlobal Singapore 2024).
- Circles Subscriptz - Trustless recurring payments in CRC (ETHGlobal Prague 2025).
- Raila Circles - Trust-graph-based P2P uncollateralized lending with a Safe module and relayer margins (ETHGlobal Buenos Aires 2025, 1st place).
- Inner Circles - No-collateral CRC lending where 3+ community vouchers escrow trust; interest drops as vouchers grow (ETHGlobal Buenos Aires 2025, 2nd place).
- Past Hackathon Projects index - Maintained list with descriptions.
-
-
Mini Apps
-
Consumer Mini Apps
- Coinflip Game - Bet 1 CRC on heads or tails; the reference embedded mini app.
- XMTP Demo - End-to-end encrypted DMs and group chat between Circles accounts via XMTP.
- Merch Shop - Reference checkout flow for selling merch in CRC.
-
Developer Demos
- Sign Message Demo - Minimal example of requesting a signature via the Mini App postMessage protocol.
- ERC20 Transfer Demo - Minimal example of requesting a wallet transaction.
-
Group & Admin Tools
- Invitations Manager - Mint, share, and track Circles invite links from one dashboard.
- Circles Groups - Create and manage group currencies and their member trust sets.
- Group Liquidity Bootstrapper - Spin up an LBP to seed liquidity for a group currency on Gnosis Chain.
- MiniApps Builders Org Manager - Manage builder-org accounts that ship mini apps.
- Test Account Flag - Mark an avatar as a test account so it doesn't pollute ecosystem analytics.
-
-
Pathfinders
-
Developer Demos
- pathfinder - Original Circles pathfinder.
- pathfinder2 - Rewrite in Rust, used by the production pathfinder service.
- pyfinder - Python pathfinder implementation.
- pathfinder-proxy - Proxy layer in front of the pathfinder RPC.
-
-
Protocol & Architecture
-
Developer Demos
- Gnosis Chain
- Circles Architecture Overview - Hub V2, vaults, treasury, mint policies, and name registry on one diagram.
- circles-contracts-v2 - Solidity source for the Hub V2 (ERC-1155), Migration contract, Name Registry, Standard Treasury, Vaults, and Base Mint Policy.
- circles-groups - Reference group-template contracts (membership conditions, custom mint policies).
- circles-social-recovery - Foundry contracts for a Safe SocialRecoveryModule letting GApp users recover passkey access via human guardians.
- Personal Currencies - Per-avatar minting, demurrage math, and the rule of trust.
- Group Currencies - How communities pool personal CRC into a fungible group token.
-
-
Research, Simulation & Reputation
-
Developer Demos
- PyCircleSim - Agent-based simulator for Circles network dynamics in Python.
- pyfinder-dgen - Synthetic Circles data generator for pathfinder benchmarking.
- circles_arbbots - Arbitrage bots that help equilibrate prices across CRC tokens.
- Universal basic income on blockchain: the case of Circles UBI - Peer-reviewed analysis of Circles as a UBI mechanism (Frontiers in Blockchain).
-
-
SDKs & Libraries
-
Developer Demos
- @aboutcircles/sdk - Current TypeScript SDK. Simplified surface over avatars, trust, pathfinding, profiles, and Safe execution. Published as `@aboutcircles/sdk` on npm.
- circles-rs - Rust workspace mirroring the TS SDK: RPC client, pathfinder, flow-matrix, transfer planning, and a higher-level `circles-sdk` crate.
- circles-sdk (legacy) - Earlier full-surface TypeScript SDK. Still referenced by many existing tutorials.
- @aboutcircles/sdk-core - Low-level contract bindings for Hub V2.
- @aboutcircles/sdk-rpc - Typed client for the Circles JSON-RPC methods.
- @aboutcircles/sdk-pathfinder - Pathfinder client used by the SDK.
- @aboutcircles/sdk-profiles - Read and write avatar profile metadata.
- @aboutcircles/sdk-runner - Execute operations through a Safe smart account.
- @aboutcircles/sdk-transfers - Build transfer payloads from pathfinder output.
- @aboutcircles/sdk-types - Shared TypeScript types.
- @aboutcircles/sdk-utils - Demurrage math and helpers.
- 5ecret-garden - Circles Marketplace monorepo: `circles-market-sdk`, auth, cart, catalog, orders, offers, and profile packages plus a SvelteKit app.
- SDK Reference - Full method and event surface for the current SDK.
-
-
Starter Kits & Tutorials
-
Developer Demos
- circles-gnosisApp-starter-kit - Official TypeScript starter for Gnosis × Circles apps.
- circles-dev-kit - Guided, hands-on tour of the Circles SDK.
- Circles-starter-kit - Hacker guide for developers to learn Circles and build projects.
- circles-vite-app - Vite playground for both Circles v1 and v2.
- mycircles - Third-party SvelteKit reference combining `@aboutcircles/sdk`, Auth.js, and Safe protocol-kit for profile and trust management.
- SDK Quickstart - Install, connect a wallet, and mint your first CRC.
- Setting up the SDK with React + JavaScript - End-to-end React integration.
- Gnosis App Starter Kit Tutorial - Walkthrough of the official starter.
- Vibecoding a Standalone Mini App - Ship a standalone mini app with no protocol expertise.
-
-
Start Here
- Circles World - Earn CRC by inviting friends, create a group, build an app, or host an event.
- Circles World - Mini Apps - Browse the live mini-app gallery from any Gnosis App wallet.
- About Circles homepage - Manifesto, whitepaper, FAQ, and ecosystem overview.
- How Circles Works - Personal currencies, group currencies, trust, and demurrage in one page.
- Introducing Circles v2 - The v2 launch announcement on the Gnosis blog explaining design rationale.
-
Wallets & Apps
- Metri - The official Circles v2 wallet. Passkey login, Safe smart account, fiat on/off-ramps via CoW Swap, and real-world spending via Gnosis Pay.
- Gnosis App - Gnosis super-app that hosts Circles accounts, invite links, and the Mini App store.
- Gnosis Pay - Visa-compatible card that lets you spend CRC and other Gnosis Chain assets at any merchant.
Programming Languages
Categories
SDKs & Libraries
13
APIs & Infrastructure
10
Mini Apps
10
Starter Kits & Tutorials
9
Build a Mini App
8
Hackathon Projects
8
Protocol & Architecture
7
Developer Tools
6
For AI Agents
6
Start Here
5
Background Reading
5
Research, Simulation & Reputation
4
Pathfinders
4
Community
3
Wallets & Apps
3
Explorers & Indexers
2
Sub Categories
Keywords