Skip to content

doc: expand runtime.adoc with gas tokens, builtins, and cairo-native#9768

Closed
eytan-starkware wants to merge 1 commit into
mainfrom
eytan_graphite/doc_expand_runtime.adoc_with_gas_tokens_builtins_and_cairo-native
Closed

doc: expand runtime.adoc with gas tokens, builtins, and cairo-native#9768
eytan-starkware wants to merge 1 commit into
mainfrom
eytan_graphite/doc_expand_runtime.adoc_with_gas_tokens_builtins_and_cairo-native

Conversation

@eytan-starkware
Copy link
Copy Markdown
Contributor

No description provided.

@reviewable-StarkWare
Copy link
Copy Markdown

This change is Reviewable

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@eytan-starkware eytan-starkware force-pushed the eytan_graphite/doc_expand_runtime.adoc_with_gas_tokens_builtins_and_cairo-native branch from c776937 to ba93d10 Compare May 14, 2026 12:22
@eytan-starkware eytan-starkware marked this pull request as ready for review May 14, 2026 12:22
@cursor
Copy link
Copy Markdown

cursor Bot commented May 14, 2026

PR Summary

Low Risk
Low risk documentation-only change; no runtime or compiler behavior is modified.

Overview
Updates runtime.adoc to document an additional native execution option via cairo-native (Sierra → LLVM → machine code).

Clarifies Starknet gas accounting by explicitly listing tracked token types and describing static gas cost computation and withdraw_gas() usage, and expands the builtins section with per-builtin descriptions plus notes about dedicated memory segments and implicit-argument access.

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

Copy link
Copy Markdown
Collaborator

@orizi orizi left a comment

Choose a reason for hiding this comment

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

@orizi reviewed all commit messages and made 1 comment.
Reviewable status: 0 of 1 files reviewed, 1 unresolved discussion (waiting on eytan-starkware and TomerStarkware).


docs/reference/src/components/cairo/modules/language_semantics/pages/runtime.adoc line 73 at r2 (raw file):

- **Blake** — Blake2s hash computation
- **RangeCheck96** — 96-bit range checking (used by circuit operations)
- **AddMod**, **MulMod** — modular arithmetic for circuit builtins

Suggestion:

- **RangeCheck** — validates that values fall within a given range (used by integer operations)
- **Pedersen** — Pedersen hash computation
- **Poseidon** — Poseidon hash computation
- **Bitwise** — bitwise AND, OR, XOR operations
- **EcOp** — elliptic curve point operations
- **Blake** — Blake2s hash computation
- **RangeCheck96** — 96-bit range checking (used by circuit operations)
- **AddMod**, **MulMod** — modular arithmetic for circuit builtins

@eytan-starkware eytan-starkware force-pushed the eytan_graphite/doc_expand_runtime.adoc_with_gas_tokens_builtins_and_cairo-native branch from ba93d10 to 39df217 Compare May 14, 2026 12:34
Copy link
Copy Markdown
Contributor Author

@eytan-starkware eytan-starkware left a comment

Choose a reason for hiding this comment

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

@eytan-starkware made 1 comment.
Reviewable status: 0 of 1 files reviewed, 1 unresolved discussion (waiting on orizi and TomerStarkware).


docs/reference/src/components/cairo/modules/language_semantics/pages/runtime.adoc line 73 at r2 (raw file):

- **Blake** — Blake2s hash computation
- **RangeCheck96** — 96-bit range checking (used by circuit operations)
- **AddMod**, **MulMod** — modular arithmetic for circuit builtins

Done.

Copy link
Copy Markdown
Collaborator

@orizi orizi left a comment

Choose a reason for hiding this comment

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

@orizi reviewed all commit messages and made 1 comment.
Reviewable status: 0 of 1 files reviewed, 2 unresolved discussions (waiting on eytan-starkware and TomerStarkware).


docs/reference/src/components/cairo/modules/language_semantics/pages/runtime.adoc line 70 at r3 (raw file):

- **Bitwise** — bitwise AND, OR, XOR operations
- **EcOp** — elliptic curve point operations
- **Blake** — Blake2s compression function

blake is an opcode extension - not a builtin.

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.

3 participants