Docs

Circles

A Circle is a group that rebalances the same assets on a schedule. Rounds happen inside Circles.

Why groups

Matching works when enough people heading opposite ways meet at the same time. A Circle gathers them: the same assets, a known schedule, and a minimum number of members before a round can match.

Settings

SettingOptions
AccessPublic · By invitation · Private
AssetsAt least two from the allowlist. Members only match these inside the Circle
Round scheduleManual (organizer starts one) · Daily · Weekly
Sign-up window5 min · 15 min · 1 hour · 4 hours · 1 day
Members needed per round2 to 50
Default for leftoversCheapest route · Roll over · Skip

Invitations

Organizers create invite links. Each link works once, and only its hash is stored, so a leaked database cannot be turned back into working invites. Share it by copy, Telegram, WhatsApp or QR.

Privacy inside a Circle

  • Other members appear as "Peer 2", "Peer 3", never by address.
  • Receipts open only for members of the Circle.
  • Onchain, transfers are public as on any chain. Sama keeps its own views pseudonymous; it cannot hide the chain.