The statement — what the forge would charge an app
One app, one UTC calendar month (#508). No payment processor: every line is quantity × price, so anyone can check it by hand.
| line | quantity | price |
|---|---|---|
| Awake time | awake-hours, all environments | list $/awake-hour |
| Storage | GB-months (GB-hours / 730) | list $/GB-month |
| Crew spend at cost | USD of crew spend | 1 |
| Margin on crew spend (N%) | USD of crew spend | N / 100 |
The total is the unrounded sum, rounded once to the cent.
- Set the list prices in Settings → Economics, beside the costs, or with
PUT /api/v1/forge/economics (awakePriceHourUsd, storagePriceGbMonthUsd).
The margin is the one beside the profit slider.
- Read it at
GET /api/v1/repos/:owner/:name/statement?month=2026-10;
format=csv (or accept: text/csv) is the same lines as a table file.
Without month, this month so far.
- Download the ledger at
/:owner/:name/settings/app/statement.csv?month=2026-10
(the page's "CSV, every ledger entry" link): one row per ledger entry (date,kind,amount_usd,what),
then awake, storage and margin rows and a total row that is the page's total.
A field beginning = + - @ is prefixed with ' so a spreadsheet reads text, not a formula.
A bad month is 422.
- Print it from the repository's Settings → App → Statement
(/:owner/:name/settings/app/statement); printing hides the navigation.
- At the terminal, open the repository and pick
owner/name — Statement
from the : palette: the same lines and total. m takes a month
(YYYY-MM), [ and ] step back and forward.
The repository's admins and forge admins can read it; anyone else gets a 404.
- At the terminal,
lon the statement screen swaps the lines for the
ledger entries, one row per crew run (what it paid for, date, kind, cost).