About Circles

What is a circle?

A circle is a ledger record that represents a role or group of signers.

{
   "data": {
     "handle": "admin",
     "custom": {
       ...
     },
     "access": [...],
   },   
   "hash": "...",
   "meta": {...}
}

Signer assignment

The relation between circle and signer is N:N which means one circle can have multiple signers assigned to it as well as a signer can be part of many circles.

A circle can be useful for grouping signers and easing access rules management since access can be granted to circles instead of specific signer handles or public keys. See About Authorization for more details.

{
   "action": "create",
   "record": "wallet",
   "signer": {
      "$circle": "admin"
   }
}