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:

StageWhat happens
FormingMembers 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.
ActiveEvery round: each member contributes, one member (in a fixed order set at creation) receives the pot. Repeats until every member has been paid once.
CompletedEvery member has received a payout. The circle's outcome is recorded to each member's Trust Score.
CancelledOnly 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.