Skip to content

docs: state the fixed-point bound and how a non-converging build reports #136

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thedavidmeister merged 5 commits into from
Aug 17, 2026
Merged

docs: state the fixed-point bound and how a non-converging build reports #136

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d5a046c
docs: state the fixed-point bound and how a non-converging build reports
claude Aug 16, 2026
a98376b
Merge main, cutting the paragraph the removed worked example anchored
thedavidmeister Aug 17, 2026
4570391
Merge remote-tracking branch 'origin/main' into 2026-08-16-issue-81
thedavidmeister Aug 17, 2026
01255b1
Merge main into 2026-08-16-issue-81
thedavidmeister Aug 17, 2026
0bba9fa
Replace the false bound with what the regeneration loop actually does
claude Aug 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,15 @@ pointers, which pointers feed back into the generation. This cycle means
pointers may need to be regenerated several times until they reach a fixed point
where neither pointer values nor the codehash of any consuming contract shift.

Reaching that fixed point is the consumer's job: nothing bounds or iterates the
loop. A tree that has not settled fails the currency check exactly as a tree
nobody regenerated does — see
[`rainix-copy-artifacts.yaml`](https://github.com/rainlanguage/rainix/blob/main/.github/workflows/rainix-copy-artifacts.yaml)
— so regenerate until the working tree stops changing before committing, and
read a tree that never stops changing as a cycle that does not converge rather
than one more pass to run. Committing part-way records a deployed-bytecode hash
for a contract compiled against a different pass of the same file.

## Formatter requirements

`LibCodeGen` wraps the declarations it emits itself, deciding against
Expand Down
Loading