Random Access Memory Table

The purpose of the RAM Table is to ensure that the RAM is accessed in a consistent manner. That is, all mutation of RAM happens explicitly through instruction write_mem, and any invocations of instruction read_mem return the values last written.

The fundamental principle is identical to that of the Op Stack Table. The main difference is the absence of a dedicated stack pointer. Instead, op stack element st0 is used as RAM pointer ram_pointer.

If some RAM address is read from before it is written to, the corresponding value is not determined. This is one of interfaces for non-deterministic input in Triton VM. Consecutive reads from any such address always returns the same value (until overwritten via write_mem).

Base Columns

The RAM Table has 7 base columns:

  1. the cycle counter clk,
  2. the executed instruction_type – 0 for “write”, 1 for “read”, 2 for padding rows,
  3. RAM pointer ram_pointer,
  4. RAM value ram_value,
  5. helper variable "inverse of ram_pointer difference" iord,
  6. Bézout coefficient polynomial coefficient 0 bcpc0,
  7. Bézout coefficient polynomial coefficient 1 bcpc1,

Column iord helps with detecting a change of ram_pointer across two RAM Table rows. The function of iord is best explained in the context of sorting the RAM Table's rows, which is what the next section is about.

The Bézout coefficient polynomial coefficients bcpc0 and bcpc1 represent the coefficients of polynomials that are needed for the contiguity argument. This argument establishes that all regions of constant ram_pointer are contiguous.

Extension Columns

The RAM Table has 6 extension columns:

  1. RunningProductOfRAMP, accumulating next row's ram_pointer as a root whenever ram_pointer changes between two rows,
  2. FormalDerivative, the (evaluated) formal derivative of RunningProductOfRAMP,
  3. BezoutCoefficient0, the (evaluated) polynomial with base column bcpc0 as coefficients,
  4. BezoutCoefficient1, the (evaluated) polynomial with base column bcpc1 as coefficients,
  5. RunningProductPermArg, the Permutation Argument with the Processor Table, and
  6. ClockJumpDifferenceLookupClientLogDerivative, part of memory consistency.

Columns RunningProductOfRAMP, FormalDerivative, BezoutCoefficient0, and BezoutCoefficient1 are part of the Contiguity Argument.

Sorting Rows

In the Hash Table, the rows are arranged such that they

  1. form contiguous regions of ram_pointer, and
  2. are sorted by cycle counter clk within each such region.

One way to achieve this is to sort by ram_pointer first, clk second.

Coming back to iord: if the difference between ram_pointer in row and row is 0, then iord in row is 0. Otherwise, iord in row is the multiplicative inverse of the difference between ram_pointer in row and ram_pointer in row . In the last row, there being no next row, iord is 0.

An example of the mechanics can be found below. To increase visual clarity, stack registers holding value “0” are represented by an empty cell. For illustrative purposes only, we use six stack registers st0 through st5 in the example. Triton VM has 16 stack registers, st0 through st15.

Processor Table:

clkciniast0st1st2st3st4st5
0push20
1push10020
2write_mem110020
3pop1101
4push5
5push65
6push765
7push8765
8push98765
9push4298765
10write_mem54298765
11pop147
12push42
13read_mem142
14pop2419
15push45
16read_mem345
17pop442876
18push17
19push1817
20push191817
21push43191817
22write_mem343191817
23pop146
24push46
25read_mem546
26pop14191918175
27pop591918175
28push42
29read_mem142
30pop2419
31push100
32read_mem1100
33pop29920
34halt

RAM Table:

clktypepointervalueiord
10write4290
13read4290
25read4290
29read4291
10write4380
16read4380
22write43190
25read43191
10write4470
16read4470
22write44180
25read44181
10write4560
16read4560
22write45170
25read45171
10write4650
25read465
2write100200
32read100200

Padding

The row used for padding the RAM Table is its last row, with the instruction_type set to 2.

If the RAM Table is empty, the all-zero row with the following modifications is used instead:

  • instruction_type is set to 2, and
  • bcpc1 is set to 1.

This ensures that the Contiguity Argument works correctly in the absence of any actual contiguous RAM pointer region.

The padding row is inserted below the RAM Table until the desired height is reached.

Row Permutation Argument

The permutation argument with the Processor Table establishes that the RAM Table's rows correspond to the Processor Table's sent and received RAM values, at the correct cycle counter and RAM address.

Arithmetic Intermediate Representation

Let all household items (🪥, 🛁, etc.) be challenges, concretely evaluation points, supplied by the verifier. Let all fruit & vegetables (🥝, 🥥, etc.) be challenges, concretely weights to compress rows, supplied by the verifier. Both types of challenges are X-field elements, i.e., elements of .

Initial Constraints

  1. The first coefficient of the Bézout coefficient polynomial 0 bcpc0 is 0.
  2. The Bézout coefficient 0 bc0 is 0.
  3. The Bézout coefficient 1 bc1 is equal to the first coefficient of the Bézout coefficient polynomial bcpc1.
  4. The running product polynomial RunningProductOfRAMP starts with 🧼 - ram_pointer.
  5. The formal derivative starts with 1.
  6. If the first row is not a padding row, the running product for the permutation argument with the Processor Table RunningProductPermArg has absorbed the first row with respect to challenges 🍍, 🍈, 🍎, and 🌽 and indeterminate 🛋.
    Else, the running product for the permutation argument with the Processor Table RunningProductPermArg is 1.
  7. The logarithmic derivative for the clock jump difference lookup ClockJumpDifferenceLookupClientLogDerivative is 0.

Initial Constraints as Polynomials

  1. bcpc0
  2. bc0
  3. bc1 - bcpc1
  4. RunningProductOfRAMP - 🧼 + ram_pointer
  5. FormalDerivative - 1
  6. (RunningProductPermArg - 🛋 - 🍍·clk - 🍈·ram_pointer - 🍎·ram_value - 🌽·previous_instruction)·(instruction_type - 2)
    (RunningProductPermArg - 1)·(instruction_type - 1)·(instruction_type - 0)
  7. ClockJumpDifferenceLookupClientLogDerivative

Consistency Constraints

None.

Transition Constraints

  1. If the current row is a padding row, then the next row is a padding row.
  2. The “inverse of ram_pointer difference” iord is 0 or iord is the inverse of the difference between current and next row's ram_pointer.
  3. The ram_pointer changes or iord is the inverse of the difference between current and next row's ram_pointer.
  4. The ram_pointer changes or instruction_type is “write” or the ram_value remains unchanged.
  5. The bcbp0 changes if and only if the ram_pointer changes.
  6. The bcbp1 changes if and only if the ram_pointer changes.
  7. If the ram_pointer changes, the RunningProductOfRAMP accumulates next ram_pointer.
    Otherwise, it remains unchanged.
  8. If the ram_pointer changes, the FormalDerivative updates under the product rule of differentiation.
    Otherwise, it remains unchanged.
  9. If the ram_pointer changes, Bézout coefficient 0 bc0 updates according to the running evaluation rules with respect to bcpc0.
    Otherwise, it remains unchanged.
  10. If the ram_pointer changes, Bézout coefficient 1 bc1 updates according to the running evaluation rules with respect to bcpc1.
    Otherwise, it remains unchanged.
  11. If the next row is not a padding row, the RunningProductPermArg accumulates the next row.
    Otherwise, it remains unchanged.
  12. If the ram_pointer does not change and the next row is not a padding row, the ClockJumpDifferenceLookupClientLogDerivative accumulates the difference of clk.
    Otherwise, it remains unchanged.

Transition Constraints as Polynomials

  1. (instruction_type - 0)·(instruction_type - 1)·(instruction_type' - 2)
  2. (iord·(ram_pointer' - ram_pointer) - 1)·iord
  3. (iord·(ram_pointer' - ram_pointer) - 1)·(ram_pointer' - ram_pointer)
  4. (iord·(ram_pointer' - ram_pointer) - 1)·(instruction_type - 0)·(ram_value' - ram_value)
  5. (iord·(ram_pointer' - ram_pointer) - 1)·(bcpc0' - bcpc0)
  6. (iord·(ram_pointer' - ram_pointer) - 1)·(bcpc1' - bcpc1)
  7. (iord·(ram_pointer' - ram_pointer) - 1)·(RunningProductOfRAMP' - RunningProductOfRAMP)
    + (ram_pointer' - ram_pointer)·(RunningProductOfRAMP' - RunningProductOfRAMP·(ram_pointer'-🧼))
  8. (iord·(ram_pointer' - ram_pointer) - 1)·(FormalDerivative' - FormalDerivative)
    + (ram_pointer' - ram_pointer)·(FormalDerivative' - FormalDerivative·(ram_pointer'-🧼) - RunningProductOfRAMP)
  9. (iord·(ram_pointer' - ram_pointer) - 1)·(bc0' - bc0)
    + (ram_pointer' - ram_pointer)·(bc0' - bc0·🧼 - bcpc0')
  10. (iord·(ram_pointer' - ram_pointer) - 1)·(bc1' - bc1)
    + (ram_pointer' - ram_pointer)·(bc1' - bc1·🧼 - bcpc1')
  11. (RunningProductPermArg' - RunningProductPermArg·(🛋 - 🍍·clk' - 🍈·ram_pointer' - 🍎·ram_value' - 🌽·previous_instruction'))·(instruction_type' - 2)
    (RunningProductPermArg' - RunningProductPermArg)·(instruction_type - 1)·(instruction_type - 0))
  12. (iord·(ram_pointer' - ram_pointer) - 1)·(instruction_type' - 2)·((ClockJumpDifferenceLookupClientLogDerivative' - ClockJumpDifferenceLookupClientLogDerivative) · (🪞 - clk' + clk) - 1)
    + (ram_pointer' - ram_pointer)·(ClockJumpDifferenceLookupClientLogDerivative' - ClockJumpDifferenceLookupClientLogDerivative)
    + (instruction_type' - 1)·(instruction_type' - 0)·(ClockJumpDifferenceLookupClientLogDerivative' - ClockJumpDifferenceLookupClientLogDerivative)

Terminal Constraints

  1. The Bézout relation holds between RunningProductOfRAMP, FormalDerivative, bc0, and bc1.

Terminal Constraints as Polynomials

  1. RunningProductOfRAMP·bc0 + FormalDerivative·bc1 - 1