Skip to content

Configuration files

The following document describes why Polynomial Identity Language uses a special configuration file.

In order for PIL to securely enable modularity, especially in complex settings such as the Polygon zkEVM’s, where the Main SM has several secondary state machines executing different computations, a dependency inclusion feature among different .pil files needed to be developed.

Dependency inclusion feature

Let’s consider a scenario. If the PIL code of Secondary SMs reflects unique properties such as the maximum length (for example, the length \(\mathtt{2^{10}}\) of the Multiplier SM as seen in the first line of the multiplier.pil code), such properties can easily become magic numbers which attackers could use as distinguishers of which computation is running at a given point in time.

This is where the dependency inclusion feature comes in.

In order to circumvent such possible attacks, a common configuration file written in PIL called config.pil, is created to contain configuration-related properties shared among various programs.

Therefore, the file config.pil gets included in the PIL codes of relevant programs, and constants are no longer declared by their values but with keywords or symbols.

Below is the PIL code of the Optimized Multiplier SM, with the config.pil file.

include "config.pil"; 

namespace Multiplier(%N);

// Constant Polynomials
pol constant RESET;

// Committed Polynomials
pol commit freeIn; pol commit out;

// Intermediate Polynomials
pol carry = out*freeIn; 

// Constraints
out' = RESET*freeIn + (1-RESET)*carry;

Observe that the number \(\mathtt{2^{10}}\) does not appear in the PIL code but the symbol “\(\texttt{\%N}\)”. In this particular example, it means the config.pil file contains the value \(\mathtt{2^{10}}\) as indicated below.

constant %N = 2**10;

The compiler distinguishes between constant’s identifiers and other identifiers via the percent symbol (%). Therefore, all constant identifiers in PIL should be preceded by the percent symbol (%).


Last update: December 5, 2023
Authors: EmpieichO (4.88%), Nadim Kobeissi (95.12%)