# Circles Documentation

## Home

- [Welcome to Circles](https://docs.aboutcircles.com/readme.md)
- [Understanding Personal and Group Currencies](https://docs.aboutcircles.com/overview/how-it-works.md): In Circles, money is generated collectively by many individuals over time rather than by a central authority at specific events.
- [Personal Currencies](https://docs.aboutcircles.com/overview/how-it-works/personal-currency.md)
- [Group Currencies](https://docs.aboutcircles.com/overview/how-it-works/group-currencies.md)
- [Why Build on Circles?](https://docs.aboutcircles.com/overview/why-build-on-circles.md)
- [Circles Architecture](https://docs.aboutcircles.com/overview/circles-architecture.md): An overview of different components of circles architecture.
- [The Circles Stack](https://docs.aboutcircles.com/circles-sdk/the-circles-protocol.md): Developers Hub for building with Circles.
- [Circles SDK Overview](https://docs.aboutcircles.com/circles-sdk/circles-sdk-overview.md)
- [Quickstart Guide for Circles SDK](https://docs.aboutcircles.com/circles-sdk/getting-started-with-the-sdk.md)
- [Setting Circles Profiles](https://docs.aboutcircles.com/circles-sdk/circles-profiles.md)
- [Building with different Circles Avatars](https://docs.aboutcircles.com/circles-sdk/circles-avatars.md): An avatar represents a Circles user.
- [Personal / Human Avatars](https://docs.aboutcircles.com/circles-sdk/circles-avatars/personal-human-avatars.md)
- [Inviting and accepting human avatars](https://docs.aboutcircles.com/circles-sdk/circles-avatars/personal-human-avatars/inviting-and-accepting-human-avatars.md)
- [Mint personal tokens](https://docs.aboutcircles.com/circles-sdk/circles-avatars/personal-human-avatars/mint-personal-tokens.md)
- [Fetching profile of an human avatar](https://docs.aboutcircles.com/circles-sdk/circles-avatars/personal-human-avatars/handle-profile-of-an-avatar.md): This section is dedicated to handling/updating the profiles of an avatar.
- [Manage trust connections](https://docs.aboutcircles.com/circles-sdk/circles-avatars/personal-human-avatars/manage-trust-connections.md)
- [Get token balances of an avatar](https://docs.aboutcircles.com/circles-sdk/circles-avatars/personal-human-avatars/get-token-balances-of-an-avatar.md)
- [Transfer personal Circles tokens to different avatar](https://docs.aboutcircles.com/circles-sdk/circles-avatars/personal-human-avatars/transfer-personal-circles-tokens-to-different-avatar.md)
- [Group Avatars](https://docs.aboutcircles.com/circles-sdk/circles-avatars/group-avatars.md)
- [Create Base Groups for your community](https://docs.aboutcircles.com/circles-sdk/circles-avatars/group-avatars/create-base-groups-for-your-community.md)
- [Mint group tokens](https://docs.aboutcircles.com/circles-sdk/circles-avatars/group-avatars/mint-group-tokens.md)
- [Managing group invites](https://docs.aboutcircles.com/circles-sdk/circles-avatars/group-avatars/managing-group-invites.md)
- [Find groups and memberships](https://docs.aboutcircles.com/circles-sdk/circles-avatars/group-avatars/find-groups-and-memberships.md)
- [Getting total supply of group tokens available](https://docs.aboutcircles.com/circles-sdk/circles-avatars/group-avatars/getting-total-supply-of-group-tokens-available.md)
- [Organization Avatars](https://docs.aboutcircles.com/circles-sdk/circles-avatars/organization-avatars.md)
- [Creation of Organizations](https://docs.aboutcircles.com/circles-sdk/circles-avatars/organization-avatars/creation-of-organizations.md)
- [Managing trust connections via Org avatar account](https://docs.aboutcircles.com/circles-sdk/circles-avatars/organization-avatars/managing-trust-connections-via-org-avatar-account.md)
- [Wrapping and Unwrapping](https://docs.aboutcircles.com/circles-sdk/wrapping-and-unwrapping.md)
- [Pathfinder](https://docs.aboutcircles.com/circles-sdk/pathfinder.md)
- [Invitations and Referrals](https://docs.aboutcircles.com/circles-sdk/invitations-and-referrals.md)
- [Setting up Circles SDK with React](https://docs.aboutcircles.com/tutorials-and-examples/setting-up-circles-sdk-with-react-and-javascript.md)
- [Using CrcV2\_TransferData for verifying annotated data](https://docs.aboutcircles.com/tutorials-and-examples/circles-x-gnosis-app-starter-kit.md): Annotating Circles transactions with arbitrary data and utilizing CrcV2\_TransferData rpc method to build Gnosis App compatible payment links and QR codes with annotation.
- [Query Circles Data](https://docs.aboutcircles.com/querying-circles-profiles-and-data/query-data.md): The CirclesData class provides an easy-to-use selection of common queries that are suitable for most use cases.
- [Subscribing to Avatar events](https://docs.aboutcircles.com/querying-circles-profiles-and-data/subscribing-to-avatar-events.md): The Circles SDK let's you subscribe to protocol events. Either filtered for an avatar or as a complete stream. There is also a way to query all past events in a block range.
- [Utilising CirclesQuery Class](https://docs.aboutcircles.com/querying-circles-profiles-and-data/utilising-circlesquery-class.md): The CirclesQuery class allows you to execute custom queries against the Circles RPC api.
- [Query Circles profiles](https://docs.aboutcircles.com/querying-circles-profiles-and-data/query-circles-profiles.md)
- [Circles SDK interface](https://docs.aboutcircles.com/circles-sdk-reference/circles-sdk-interface.md)
- [SDK Methods](https://docs.aboutcircles.com/circles-sdk-reference/sdk-methods.md)
- [Circles Events Types](https://docs.aboutcircles.com/circles-sdk-reference/circles-events-types.md)
- [Glossary](https://docs.aboutcircles.com/developer-support/glossary.md): This glossary contains terms and definitions used throughout the Circles documentation.
- [Circles Tools](https://docs.aboutcircles.com/developer-support/circles-tools.md)
- [Past Hackathon Projects on Circles](https://docs.aboutcircles.com/developer-support/past-hackathon-projects-on-circles.md)

## API Reference

- [Circles API](https://docs.aboutcircles.com/api-reference/circles-api.md)

## User Guides

- [User Guides](https://docs.aboutcircles.com/user-guides/readme.md)
- [Invitation Link Manager Mini App Guide](https://docs.aboutcircles.com/user-guides/invitation-link-manager-mini-app-guide.md)
- [What are Circles groups?](https://docs.aboutcircles.com/user-guides/circles-groups/what-are-circles-groups.md)
- [Create a Circles Group using Group manager MiniApp](https://docs.aboutcircles.com/user-guides/circles-groups/create-a-circles-group-using-group-manager-miniapp.md)
- [Create a Circles Group using Circles Core App](https://docs.aboutcircles.com/user-guides/circles-groups/create-a-circles-group-using-circles-core-app.md)
- [Migrate your group and update its details](https://docs.aboutcircles.com/user-guides/circles-groups/migrate-your-group-and-update-its-details.md): How to migrate your group so you can edit it, and how to fill in the new group contract properties as an admin.
- [Technical Group Details](https://docs.aboutcircles.com/user-guides/circles-groups/technical-group-details.md): This section is for developers, advanced users, and those curious about the underlying mechanics of Circles Groups.
- [Validation and Use Cases](https://docs.aboutcircles.com/user-guides/circles-groups/validation-and-use-cases.md)
- [Migrate Circles v1 account to v2](https://docs.aboutcircles.com/user-guides/migrate-v1-account/migrate-circles-v1-account-to-v2.md)
- [Circles Transfer and Rule of Trust](https://docs.aboutcircles.com/user-guides/circles-features/circles-transfer-and-rule-of-trust.md): This guide will help you understand balances, send limits, and how the Pathfinder finds a route
- [Daily Burn (Demurrage)](https://docs.aboutcircles.com/user-guides/circles-features/daily-burn-demurrage.md): This guide will help you understand what the “burn” events mean, how they work, and why they exist
- [Trust Score](https://docs.aboutcircles.com/user-guides/circles-features/trust-score.md): This guide will help you understand what it means, how it’s calculated, and how to use it safely

## Mini Apps

- [What are Circles Mini Apps?](https://docs.aboutcircles.com/miniapps/what-are-circles-mini-apps.md)
- [Embedded Mini Apps](https://docs.aboutcircles.com/miniapps/embedded-mini-apps.md)
- [Intermediate Embedded Mini App Guide](https://docs.aboutcircles.com/miniapps/embedded-mini-apps/intermediate-embedded-mini-app-guide.md)
- [Standalone Mini Apps](https://docs.aboutcircles.com/miniapps/standalone-mini-apps.md)
- [Simple Vibecoding Tutorial](https://docs.aboutcircles.com/miniapps/standalone-mini-apps/simple-vibecoding-tutorial.md)
- [Create or Connect a Circles Account from a Mini App](https://docs.aboutcircles.com/miniapps/create-or-connect-a-circles-account-from-a-mini-app.md)
- [Contribute Mini Apps](https://docs.aboutcircles.com/miniapps/contribute-mini-apps.md)
- [Circles Mini Apps Launchpad](https://docs.aboutcircles.com/miniapps/circles-mini-apps-launchpad.md): A rolling developer incentive program for builders creating useful, production-ready Mini Apps for the Circles ecosystem.
- [Agentic Setup for Circles](https://docs.aboutcircles.com/miniapps/agentic-setup-for-circles.md): Build Circles dApps and miniapps using AI coding assistants grounded in always-fresh, version-aware Circles documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on a page URL with the `ask` query parameter:
```
GET https://docs.aboutcircles.com/readme.md?ask=<question>
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.