Skip to content

Commit e9a2985

Browse files
committed
Update context schema description
1 parent 7c67959 commit e9a2985

File tree

1 file changed

+14
-10
lines changed

1 file changed

+14
-10
lines changed

schemas/program/context.schema.yaml

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,21 @@ description: |
77
information about the high-level runtime execution state at a specific point
88
in a program's bytecode.
99
10-
This schema defines the structure for encoding compile-time knowledge about
11-
the high-level runtime state. Contexts are treated as units of information
12-
that may encompass multiple related or unrelated facts about the program's
13-
state. This may include, e.g., source mapping information (via the `"code"`
14-
property) or information about known variable allocations, etc.
10+
This schema provides a formal specification for this format's model of what
11+
information can be known at compile-time about the high-level runtime. This
12+
includes data such as a particular machine instruction's source mapping or
13+
what variables exist in runtime state following some instruction.
1514
16-
The interpretation of a context depends on its properties and its
17-
relationship to program elements such as instructions or control flow
18-
structures. For example, a context associated with an instruction may
19-
indicate that the specified conditions hold true following the execution of
20-
that instruction.
15+
The context object supports dynamic context combination and selection through
16+
the use of `gather`, and `pick` properties. This allows for flexible
17+
composition and extraction of context information.
18+
19+
Contexts serve as a bridge between low-level EVM execution and high-level
20+
language constructs. Debuggers can use these compile-time guarantees to
21+
maintain a coherent view of the high-level language runtime throughout
22+
program execution. This enables debugging tools to map execution points to
23+
source code, reconstruct variable states, provide meaningful stack traces,
24+
and offer insights into control flow and data structures.
2125
2226
type: object
2327

0 commit comments

Comments
 (0)