Skip to main content

Nothing due this quarter

Status: Built, runs on simulator

Nothing is due from the income formula when year-to-date covered income has not passed the threshold. A zero calculated payment is a normal outcome, not evidence of lateness.

The threshold is applied across the year​

The calculation uses the increase in the amount owed year to date. It does not grant a new annual threshold for every quarter, and it does not apply the share rate to all income as soon as the threshold is crossed.

O(Y)=⌊rNmax⁡(0,Y−θ)W⌋,Pq=O(Yq)−O(Yq−1)O(Y)=\left\lfloor\frac{rN\max(0,Y-\theta)}{W}\right\rfloor,\qquad P_q=O(Y_q)-O(Y_{q-1})
Formula

Y is year-to-date income, theta is the threshold, N is the unit count and r is the fixed-point rate per unit. When both income figures remain below the threshold, both owed amounts are zero. Their difference is also zero. The source math additionally requires the reported income chain not to decrease within the year.

Illustrative example

Example: two normal zero-payment quarters

The numbers here are computed by Stage 1's reference math from made-up inputs. They are not a forecast.

The example threshold is $40,000.00. First-quarter income year to date is $15,000.00, producing a payment of $0.00. At the second quarter it is $35,000.00, still producing $0.00. At the third quarter it reaches $60,000.00, and the payment becomes $1,200.00.

Source: fixture canonical, computed by scripts/sync/steps/fixtures.ts@c70cd2627598dddf6badc4fd2a9749445f203276 at Stage 1 commit bafe1fb.

A calculation and a report are different​

The code still has an accepted-report record when its due amount is zero. It updates the income commitment chain and records that period as paid without opening a payment due. A zero result is therefore not a reason to confuse “nothing to transfer” with “no report exists.” This page explains that result; detailed report sequencing remains subject to the review recorded in D-007.

The generated program reference shows the report arguments, and events shows the accepted-report and payment fields. Those structures distinguish a report from a money transfer.

What a backer sees​

Payment amounts are public onchain, including a reported zero. Backers do not receive income documents or hardship reasons through the backend's holder view. A zero alone cannot establish why someone's covered income had that result, and it should not be presented as a personal assessment.

What can go wrong​

Using a quarterly threshold instead of the year-to-date calculation would give a different amount. So would treating the share rate as applying to all income after the threshold is crossed. The example assumes its stated inputs and does not decide which income belongs in the signed agreement.