規矩 The rules, in plain words
How Biu Wui works
A group pays the same share every round, and each round one member takes the whole pot. Who takes it is decided by an auction: the highest discount wins, and the discount is shared by everyone as a dividend. People who need money early pay for it; patient people earn it.
Nobody can change the rules 合約
The contract is the whole rulebook. Nobody, including the organiser and us, can change a circle after it opens. There is no owner, no admin key and no upgrade.
Members only sign 蓋印
Every action is a signature in your wallet (your chop). Our relayer submits it and pays the gas. Members never need a gas token.
The rules
1. Opening and joining: a pledge 入會
- An organiser opens a circle: the share per round, 2 to 50 members, how long joining stays open, how long each round's bidding lasts, a grace period, the payee-change delay, the highest discount (at most 40% of the pot), the organiser's fee (at most 5%) and the approval quorum (over 50%).
- Joining is a pledge. You pay your first share when you join and name your payee: the name and address your pot and refunds go to.
- You can leave before the circle is full and get your pledge back.
- If the circle isn't full by the join deadline, anyone can cancel it and every pledge comes back in full.
- When the last member joins, round 1 starts. Everyone has already paid round 1.
2. Every round 每輪
- Pay your share before bidding ends: by a signed message (no gas) or by your standing order.
- Bid the discount you accept. Only members who paid this round and haven't won yet can bid; a new bid must beat the best one.
- Close: after bidding ends, anyone closes the auction. The highest bid wins. With no bids, the earliest-joined member who hasn't won takes the pot at no discount. Past winners who didn't pay are covered from their held security.
- The payee is fixed at close. A payee change that matures later cannot touch this pot.
- Approve: more than half of the members (the circle's quorum) approve the release.
- Release: anyone submits it. The pot goes to the winner's fixed payee, minus the discount (the organiser's fee comes out of it, the rest is the dividend shared by all) and minus the security held back to cover the winner's future shares.
- The next round starts. After the last round the circle is completed and held security is paid back.
3. Standing orders 月供
- Let the circle collect your share each round: exactly one share, at most once per round, at most N rounds, until a date you choose.
- Anyone can trigger the collection (our secretary bot does), but it can only move one share from you into this circle.
- Revoke it any time with one signature.
4. Payee lock 收款
- Your payee has a name and an address. Members see both before they approve a release.
- A change only takes effect after the circle's payee delay. While it waits, everyone sees it, and you can cancel it with one signature. A stolen key cannot quietly redirect a pot.
- Refunds and dividends also go to your payee, never to whoever calls the function.
5. When things go wrong 出事
- A round stalls (not closed, or closed but not released, for longer than the grace period): anyone can dissolve the circle. Everything left, except dividends already earned, goes back in proportion to what each member put in minus took out.
- A member stops paying: if they already won, their held security pays for them. If not, they can't bid, and the earliest-joined paying member wins instead.
6. Limits we chose 上限
- At most 50 members, so every loop over members has bounded gas.
- Discount at most 40% and organiser fee at most 5% of the pot, borrowed from India's Chit Funds Act 1982 as sensible defaults, not as a legal claim for any country.
- Payee names are 1 to 32 bytes.
What a member signs
A relayer cannot change any signed detail: the signature would fail. A signature cannot be replayed (nonces) or used in another circle (the circle's address is in every message). Smart-account (EIP-1271) signatures work too.
| Action | What the member signs |
|---|---|
| Open a circle | EIP-712 OpenCircle to the factory: every parameter, a nonce and a deadline. |
| Join (with pledge) | EIP-3009 ReceiveWithAuthorization on tUSD8 for exactly one share; its nonce binds this circle, the member, the payee address and the payee name. |
| Pay a round | EIP-3009 ReceiveWithAuthorization; its nonce binds this circle, the member and the round. |
| Standing order | EIP-712 StandingOrder + EIP-2612 Permit for share × maxRounds, spender = this circle. |
| Bid, approve, revoke, change or cancel payee, leave | EIP-712 with a per-member nonce and a deadline (at most one hour ahead at the relayer). |
| Close, release, cancel unfilled, dissolve, collect, withdraw | Nothing: anyone may call them; the rules decide what happens and money only moves along fixed paths. |
The demo circle, step by step
Ah Ming, Kitty and Wing ran a 3-round circle of 0.5 tUSD8 a round on Aevum testnet. They held no gas token at all; every one of their actions was a signature our relayer submitted.
| Loading… |