Skip to content

Add free-list allocator information. - #42

Merged
alexandratran merged 2 commits into
mainfrom
docs/free-list-allocator
Jul 21, 2026
Merged

alexandratran merged 2 commits into
mainfrom
docs/free-list-allocator

Conversation

@bgravenorst

@bgravenorst bgravenorst commented Jul 14, 2026

Copy link
Copy Markdown
Collaborator

Updated the docs to reflect that the rv64im guest defaults to the free-list allocator .

Fixes: #38


Note

Low Risk
Documentation-only changes with no runtime, build, or host integration code modified.

Overview
Updates documentation so the rv64im guest is described as defaulting to the free-list allocator (with build-time selection), instead of implying a bump-only heap.

Architecture now explains allocator choice at build time, why the free-list default helps on allocation-heavy blocks, and that the bump allocator remains in source as a non-default option.

Glossary (glossary.json and generated glossary.mdx) revises the bump allocator entry and adds Free-list allocator.

zkVM symbol reference generalizes runtime heap symbol wording and adds a note that default guest behavior uses the free-list allocator within [ZKVM_HEAP_POS, ZKVM_HEAP_TOP) while the host symbol contract is unchanged.

Reviewed by Cursor Bugbot for commit 75696db. Bugbot is set up for automated code reviews on this repo. Configure here.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
@bgravenorst
bgravenorst requested a review from a team as a code owner July 14, 2026 23:50
@vercel

vercel Bot commented Jul 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
doc-zesu Ready Ready Preview, Comment Jul 15, 2026 11:03pm

Request Review

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>

@garyschulte garyschulte left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚢 !

@alexandratran
alexandratran merged commit 493643f into main Jul 21, 2026
9 checks passed
@alexandratran
alexandratran deleted the docs/free-list-allocator branch July 21, 2026 23:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Doc updates for free-list allocator

3 participants