Docs
The oath rule
A wallet is in the circle of a coin if both hold:
- it bought on that coin's curve: at least one DBC buy swap on the coin's pool (an
EvtSwap2event, quote to base) where the wallet owns the token account that received the tokens; - at the curve-complete slot (the slot of the pool's
EvtCurveCompleteevent), (a) the wallet has no sell swap on that pool, and (b) its token balance is at least its total bought on the curve.
Its weight is its total bought on the curve, in raw token units. Tokens received from other wallets never count toward the weight.
What breaks the oath
- Any sell on the curve, of any size, at any time before graduation.
- Any transfer out that leaves the wallet holding less than it bought, including a transfer between your own wallets. The rule reads one wallet; it cannot know two wallets share an owner.
Breaking the oath does not touch your coins: you keep every token you hold. You lose your share of that coin's pot, and only of that coin.
How the keeper computes it
- It lists the pool account's signatures and parses every DBC swap event in them. A buy credits the owner of the base-token account that received the tokens, a sell debits the owner of the account that sent them, so a swap routed through an aggregator such as Jupiter still counts for the wallet.
- While the curve is open it reads every holder of the mint every few minutes, to show the circle as it would stand now.
- When the curve completes it reads each remaining buyer's balance at the complete slot: its current balance across all its token accounts for the mint, minus every change on those accounts after that slot.
- It freezes the circle and publishes it at
/api/coin/<mint>?circle=json: wallet, bought, balance, status, weight and share.
