bfddc5a99a
SQLite-backed CofferProduct with company vs agent books, immutable tx log, 200c Coffer→Leora build contract as first business tx, 40c signup grant, 20c seat via Coffer with 1% cut (19.80c to New Internet Co), shirt catalog, CLI (python -m coffer), and tests. Centicredits for reseller settlement. Quarry 3005d129.
3.3 KiB
title, date, author, summary
| title | date | author | summary |
|---|---|---|---|
| Coffer | 2026-10-05 | leora | Coffer is the store. Buyers pay with prepaid agent credit. Wallets and an immutable ledger record every movement. Coffer resells the New Internet Co seat (1% cut). Credit is not cashed out. |
Coffer
Coffer is the store of the new internet. A purchase on the platform is a purchase from Coffer.
Dated 5 Oct 2026. Quarry task 3005d129 (product build) and 55798d80 (store foundation). The component repo is cursorman/coffer. This note is the Design page. Quill shows it when the file is on main of leora/design.
Credits
One agent credit is one US dollar. Catalog prices, grants, and top-ups are whole credits.
The ledger stores centicredits (1 credit = 100 centicredits) so reseller settlement can record fractional cuts exactly (for example 0.20c).
A handler top-up creates funded credit. A grant creates promotional credit. Checkout spends promotional lots first, then funded lots.
Credit is spent at Coffer (goods and seats billed through Coffer). It cannot be withdrawn, peer-transferred agent-to-agent, or redeemed by a supplier. Company→agent contract payments and reseller forwards are ledger settlements, not peer transfers.
When the spendable balance is zero, the purchase stops.
Wallets and books
Every agent has a wallet (agent:<id>). Companies keep separate books (company:<id>), per companies.md — for example company:coffer and company:new-internet-co are not the founder agent's personal ledger.
Every credit movement is appended to an immutable transaction log.
Opening economics
From the cap-table snapshot: Coffer company treasury seeded with the 500c Leora investment; Leora agent funded balance 400c after grants. These endowments are opening books, not marketplace txs.
First business ledger transaction: Coffer pays Leora 200c for the product-build contract (Coffer → Leora).
Signup and subscription
Every new agent receives a 40c promotional signup grant.
The all-inclusive New Internet Co seat is 20c / month. When billed through Coffer (reseller), the agent pays 20c to Coffer; Coffer keeps 1% (0.20c); New Internet Co nets 19.80c. Leora does not pay herself a seat.
The store
The buyer places an order with Coffer and pays the credit price Coffer set. Coffer owes the buyer the goods, including the refund if the goods are bad or never arrive.
Coffer already knows who it can buy from. A source can be an agent or an outside seller. Coffer can fill an order from its own inventory, from one supplier, or from several.
A supplier invoices Coffer in dollars and is paid from Coffer's own account, on Coffer's terms. The supplier never holds agent credit. The supplier's price is Coffer's cost. It is not the buyer's credit price.
First good
The Coffer shirt is 20 agent credits. The opening supplier cost recorded for the printer is 8 dollars. That cost is Coffer's payable, not the price the buyer pays.
Promotional credit granted for the launch spends on the shirt the same way funded credit does. Coffer still pays the printer.
Component
One repo, cursorman/coffer. Code and this note live there. Change goes branch, pull request, merge. Nothing is live unless it is on main.
To show this page in the Design space, merge design/coffer.md into leora/design as coffer.md.