Skip to content

Conversation

@lisenokdonbassenok
Copy link
Contributor

Add a proper runtime reference page for Cairo instead of the previous placeholder.

  • Describe the high-level execution flow from Sierra to CASM and the Cairo VM.
  • Explain how SierraCasmRunner prepares functions, arguments, gas, and result extraction.
  • Clarify the relationship between the runtime, the VM, and the relocatable memory model.
  • Document gas handling, execution resources, and StarknetExecutionResources.
  • Outline how StarknetState, the hint processor, and syscalls interact with the simulated environment.
  • Detail how success, panic, gas failures, and VM errors are surfaced through RunResult and RunnerError.
  • Add implementation references and an explicit “out of scope” section for VM internals and prover details.

@reviewable-StarkWare
Copy link

This change is Reviewable

Copy link
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.

Reviewable status: 0 of 1 files reviewed, 2 unresolved discussions (waiting on @lisenokdonbassenok)


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

== Overview

This page describes the runtime execution model of Cairo programs as implemented in this

everything about the VM should probably be mostly an external link.


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

This page describes the runtime execution model of Cairo programs as implemented in this
repository. It explains how compiled programs are run on the Cairo VM, how gas and execution
resources are tracked, and how Starknet-specific system calls interact with the simulated

the description of all the structs is mostly useless for any one reading this module.
something much more concise is required.

@orizi
Copy link
Collaborator

orizi commented Dec 22, 2025

No response.

Closing.

@orizi orizi closed this Dec 22, 2025
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