Using Cadence/Circles, deposits & payouts
Circles, deposits & payouts
The full lifecycle of a circle, from creation to its last payout.
The cycle#
A circle moves through four stages:
| Stage | What happens |
|---|---|
| Forming | Members join one at a time, each posting a security deposit. A circle that never fills gets 30 days before anyone can cancel it and members reclaim their deposits. |
| Active | Every round: each member contributes, one member (in a fixed order set at creation) receives the pot. Repeats until every member has been paid once. |
| Completed | Every member has received a payout. The circle's outcome is recorded to each member's Trust Score. |
| Cancelled | Only possible if the circle never filled before its forming deadline. Deposits are returned; nothing was ever at risk. |
Why the deposit is 2x the contribution#
Every member posts a security deposit worth two rounds' contributions, not one. That floor is enforced by the contract at creation, not just a frontend suggestion. It exists so a deposit can survive more than one consecutive missed contribution before another member has to step in — see Default protection for what happens when it doesn't.
Creating a circle doesn't make you a member#
createCircle() deploys the circle and sets its terms, but it doesn't enroll the creator. Joining — with your own deposit — is a separate, explicit step, identical to how anyone else joins via an invite link. A circle you created but haven't joined yet won't appear in your own Overview or My Circles, though it's fully live and joinable by anyone with the link.
Terms are immutable#
Contribution amount, member count, round length, and payout order are set once, at deployment. There is no admin function to change them afterward — not for Cadence, not for the circle's creator. What the contract says at creation is what runs for the life of the circle.
Naming a circle#
The name entered when creating a circle has nowhere to live onchain — createCircle() takes no name parameter — so Cadence stores it off-chain instead, tied to the circle's address. Any current member (or the creator, even before they've joined) can set or change it; it shows up on the circle's dashboard header and in the circle switcher wherever you belong to more than one.