@noir-lang/acvm_js 1.0.0-beta.3-f0c1c7b.nightly → 1.0.0-beta.3-826b18a.nightly

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,151 +1,143 @@
1
1
  /* tslint:disable */
2
2
  /* eslint-disable */
3
3
  /**
4
- * Executes an ACIR circuit to generate the solved witness from the initial witness.
5
- *
6
- * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
7
- * @param {WitnessMap} initial_witness - The initial witness map defining all of the inputs to `circuit`..
8
- * @param {ForeignCallHandler} foreign_call_handler - A callback to process any foreign calls from the circuit.
9
- * @returns {WitnessMap} The solved witness calculated by executing the circuit on the provided inputs.
10
- */
4
+ * Executes an ACIR circuit to generate the solved witness from the initial witness.
5
+ *
6
+ * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
7
+ * @param {WitnessMap} initial_witness - The initial witness map defining all of the inputs to `circuit`..
8
+ * @param {ForeignCallHandler} foreign_call_handler - A callback to process any foreign calls from the circuit.
9
+ * @returns {WitnessMap} The solved witness calculated by executing the circuit on the provided inputs.
10
+ */
11
11
  export function executeCircuit(program: Uint8Array, initial_witness: WitnessMap, foreign_call_handler: ForeignCallHandler): Promise<WitnessMap>;
12
12
  /**
13
- * Executes an ACIR circuit to generate the solved witness from the initial witness.
14
- * This method also extracts the public return values from the solved witness into its own return witness.
15
- *
16
- * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
17
- * @param {WitnessMap} initial_witness - The initial witness map defining all of the inputs to `circuit`..
18
- * @param {ForeignCallHandler} foreign_call_handler - A callback to process any foreign calls from the circuit.
19
- * @returns {SolvedAndReturnWitness} The solved witness calculated by executing the circuit on the provided inputs, as well as the return witness indices as specified by the circuit.
20
- */
13
+ * Executes an ACIR circuit to generate the solved witness from the initial witness.
14
+ * This method also extracts the public return values from the solved witness into its own return witness.
15
+ *
16
+ * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
17
+ * @param {WitnessMap} initial_witness - The initial witness map defining all of the inputs to `circuit`..
18
+ * @param {ForeignCallHandler} foreign_call_handler - A callback to process any foreign calls from the circuit.
19
+ * @returns {SolvedAndReturnWitness} The solved witness calculated by executing the circuit on the provided inputs, as well as the return witness indices as specified by the circuit.
20
+ */
21
21
  export function executeCircuitWithReturnWitness(program: Uint8Array, initial_witness: WitnessMap, foreign_call_handler: ForeignCallHandler): Promise<SolvedAndReturnWitness>;
22
22
  /**
23
- * Executes an ACIR circuit to generate the solved witness from the initial witness.
24
- *
25
- * @param {Uint8Array} program - A serialized representation of an ACIR program
26
- * @param {WitnessMap} initial_witness - The initial witness map defining all of the inputs to `program`.
27
- * @param {ForeignCallHandler} foreign_call_handler - A callback to process any foreign calls from the program.
28
- * @returns {WitnessStack} The solved witness calculated by executing the program on the provided inputs.
29
- */
23
+ * Executes an ACIR circuit to generate the solved witness from the initial witness.
24
+ *
25
+ * @param {Uint8Array} program - A serialized representation of an ACIR program
26
+ * @param {WitnessMap} initial_witness - The initial witness map defining all of the inputs to `program`.
27
+ * @param {ForeignCallHandler} foreign_call_handler - A callback to process any foreign calls from the program.
28
+ * @returns {WitnessStack} The solved witness calculated by executing the program on the provided inputs.
29
+ */
30
30
  export function executeProgram(program: Uint8Array, initial_witness: WitnessMap, foreign_call_handler: ForeignCallHandler): Promise<WitnessStack>;
31
31
  /**
32
- * Returns the `BuildInfo` object containing information about how the installed package was built.
33
- * @returns {BuildInfo} - Information on how the installed package was built.
34
- */
35
- export function buildInfo(): BuildInfo;
32
+ * Sets the package's logging level.
33
+ *
34
+ * @param {LogLevel} level - The maximum level of logging to be emitted.
35
+ */
36
+ export function initLogLevel(filter: string): void;
36
37
  /**
37
- * Extracts a `WitnessMap` containing the witness indices corresponding to the circuit's return values.
38
- *
39
- * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
40
- * @param {WitnessMap} witness_map - The completed witness map after executing the circuit.
41
- * @returns {WitnessMap} A witness map containing the circuit's return values.
42
- * @param {Uint8Array} program
43
- * @param {WitnessMap} witness_map
44
- * @returns {WitnessMap}
45
- */
38
+ * Extracts a `WitnessMap` containing the witness indices corresponding to the circuit's return values.
39
+ *
40
+ * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
41
+ * @param {WitnessMap} witness_map - The completed witness map after executing the circuit.
42
+ * @returns {WitnessMap} A witness map containing the circuit's return values.
43
+ */
46
44
  export function getReturnWitness(program: Uint8Array, witness_map: WitnessMap): WitnessMap;
47
45
  /**
48
- * Extracts a `WitnessMap` containing the witness indices corresponding to the circuit's public parameters.
49
- *
50
- * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
51
- * @param {WitnessMap} witness_map - The completed witness map after executing the circuit.
52
- * @returns {WitnessMap} A witness map containing the circuit's public parameters.
53
- * @param {Uint8Array} program
54
- * @param {WitnessMap} solved_witness
55
- * @returns {WitnessMap}
56
- */
46
+ * Extracts a `WitnessMap` containing the witness indices corresponding to the circuit's public parameters.
47
+ *
48
+ * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
49
+ * @param {WitnessMap} witness_map - The completed witness map after executing the circuit.
50
+ * @returns {WitnessMap} A witness map containing the circuit's public parameters.
51
+ */
57
52
  export function getPublicParametersWitness(program: Uint8Array, solved_witness: WitnessMap): WitnessMap;
58
53
  /**
59
- * Extracts a `WitnessMap` containing the witness indices corresponding to the circuit's public inputs.
60
- *
61
- * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
62
- * @param {WitnessMap} witness_map - The completed witness map after executing the circuit.
63
- * @returns {WitnessMap} A witness map containing the circuit's public inputs.
64
- * @param {Uint8Array} program
65
- * @param {WitnessMap} solved_witness
66
- * @returns {WitnessMap}
67
- */
54
+ * Extracts a `WitnessMap` containing the witness indices corresponding to the circuit's public inputs.
55
+ *
56
+ * @param {Uint8Array} circuit - A serialized representation of an ACIR circuit
57
+ * @param {WitnessMap} witness_map - The completed witness map after executing the circuit.
58
+ * @returns {WitnessMap} A witness map containing the circuit's public inputs.
59
+ */
68
60
  export function getPublicWitness(program: Uint8Array, solved_witness: WitnessMap): WitnessMap;
69
61
  /**
70
- * Performs a bitwise AND operation between `lhs` and `rhs`
71
- * @param {string} lhs
72
- * @param {string} rhs
73
- * @returns {string}
74
- */
62
+ * Returns the `BuildInfo` object containing information about how the installed package was built.
63
+ * @returns {BuildInfo} - Information on how the installed package was built.
64
+ */
65
+ export function buildInfo(): BuildInfo;
66
+ /**
67
+ * Performs a bitwise AND operation between `lhs` and `rhs`
68
+ */
75
69
  export function and(lhs: string, rhs: string): string;
76
70
  /**
77
- * Performs a bitwise XOR operation between `lhs` and `rhs`
78
- * @param {string} lhs
79
- * @param {string} rhs
80
- * @returns {string}
81
- */
71
+ * Performs a bitwise XOR operation between `lhs` and `rhs`
72
+ */
82
73
  export function xor(lhs: string, rhs: string): string;
83
74
  /**
84
- * Sha256 compression function
85
- * @param {Uint32Array} inputs
86
- * @param {Uint32Array} state
87
- * @returns {Uint32Array}
88
- */
75
+ * Sha256 compression function
76
+ */
89
77
  export function sha256_compression(inputs: Uint32Array, state: Uint32Array): Uint32Array;
90
78
  /**
91
- * Calculates the Blake2s256 hash of the input bytes
92
- * @param {Uint8Array} inputs
93
- * @returns {Uint8Array}
94
- */
79
+ * Calculates the Blake2s256 hash of the input bytes
80
+ */
95
81
  export function blake2s256(inputs: Uint8Array): Uint8Array;
96
82
  /**
97
- * Verifies a ECDSA signature over the secp256k1 curve.
98
- * @param {Uint8Array} hashed_msg
99
- * @param {Uint8Array} public_key_x_bytes
100
- * @param {Uint8Array} public_key_y_bytes
101
- * @param {Uint8Array} signature
102
- * @returns {boolean}
103
- */
83
+ * Verifies a ECDSA signature over the secp256k1 curve.
84
+ */
104
85
  export function ecdsa_secp256k1_verify(hashed_msg: Uint8Array, public_key_x_bytes: Uint8Array, public_key_y_bytes: Uint8Array, signature: Uint8Array): boolean;
105
86
  /**
106
- * Verifies a ECDSA signature over the secp256r1 curve.
107
- * @param {Uint8Array} hashed_msg
108
- * @param {Uint8Array} public_key_x_bytes
109
- * @param {Uint8Array} public_key_y_bytes
110
- * @param {Uint8Array} signature
111
- * @returns {boolean}
112
- */
87
+ * Verifies a ECDSA signature over the secp256r1 curve.
88
+ */
113
89
  export function ecdsa_secp256r1_verify(hashed_msg: Uint8Array, public_key_x_bytes: Uint8Array, public_key_y_bytes: Uint8Array, signature: Uint8Array): boolean;
114
90
  /**
115
- * Compresses a `WitnessMap` into the binary format outputted by Nargo.
116
- *
117
- * @param {WitnessMap} witness_map - A witness map.
118
- * @returns {Uint8Array} A compressed witness map
119
- */
91
+ * Compresses a `WitnessMap` into the binary format outputted by Nargo.
92
+ *
93
+ * @param {WitnessMap} witness_map - A witness map.
94
+ * @returns {Uint8Array} A compressed witness map
95
+ */
120
96
  export function compressWitness(witness_map: WitnessMap): Uint8Array;
121
97
  /**
122
- * Decompresses a compressed witness as outputted by Nargo into a `WitnessMap`.
123
- * This should be used to only fetch the witness map for the main function.
124
- *
125
- * @param {Uint8Array} compressed_witness - A compressed witness.
126
- * @returns {WitnessMap} The decompressed witness map.
127
- */
98
+ * Decompresses a compressed witness as outputted by Nargo into a `WitnessMap`.
99
+ * This should be used to only fetch the witness map for the main function.
100
+ *
101
+ * @param {Uint8Array} compressed_witness - A compressed witness.
102
+ * @returns {WitnessMap} The decompressed witness map.
103
+ */
128
104
  export function decompressWitness(compressed_witness: Uint8Array): WitnessMap;
129
105
  /**
130
- * Compresses a `WitnessStack` into the binary format outputted by Nargo.
131
- *
132
- * @param {WitnessStack} witness_stack - A witness stack.
133
- * @returns {Uint8Array} A compressed witness stack
134
- */
106
+ * Compresses a `WitnessStack` into the binary format outputted by Nargo.
107
+ *
108
+ * @param {WitnessStack} witness_stack - A witness stack.
109
+ * @returns {Uint8Array} A compressed witness stack
110
+ */
135
111
  export function compressWitnessStack(witness_stack: WitnessStack): Uint8Array;
136
112
  /**
137
- * Decompresses a compressed witness stack as outputted by Nargo into a `WitnessStack`.
138
- *
139
- * @param {Uint8Array} compressed_witness - A compressed witness.
140
- * @returns {WitnessStack} The decompressed witness stack.
141
- */
113
+ * Decompresses a compressed witness stack as outputted by Nargo into a `WitnessStack`.
114
+ *
115
+ * @param {Uint8Array} compressed_witness - A compressed witness.
116
+ * @returns {WitnessStack} The decompressed witness stack.
117
+ */
142
118
  export function decompressWitnessStack(compressed_witness: Uint8Array): WitnessStack;
143
- /**
144
- * Sets the package's logging level.
145
- *
146
- * @param {LogLevel} level - The maximum level of logging to be emitted.
147
- */
148
- export function initLogLevel(filter: string): void;
119
+
120
+ export type RawAssertionPayload = {
121
+ selector: string;
122
+ data: string[];
123
+ };
124
+
125
+ export type ExecutionError = Error & {
126
+ callStack?: string[];
127
+ rawAssertionPayload?: RawAssertionPayload;
128
+ brilligFunctionId?: number;
129
+ };
130
+
131
+
132
+
133
+ export type StackItem = {
134
+ index: number;
135
+ witness: WitnessMap;
136
+ }
137
+
138
+ export type WitnessStack = Array<StackItem>;
139
+
140
+
149
141
 
150
142
  // Map from witness index to hex string value of witness.
151
143
  export type WitnessMap = Map<number, string>;
@@ -176,28 +168,6 @@ export type BuildInfo = {
176
168
 
177
169
 
178
170
 
179
- export type RawAssertionPayload = {
180
- selector: string;
181
- data: string[];
182
- };
183
-
184
- export type ExecutionError = Error & {
185
- callStack?: string[];
186
- rawAssertionPayload?: RawAssertionPayload;
187
- brilligFunctionId?: number;
188
- };
189
-
190
-
191
-
192
- export type StackItem = {
193
- index: number;
194
- witness: WitnessMap;
195
- }
196
-
197
- export type WitnessStack = Array<StackItem>;
198
-
199
-
200
-
201
171
  export type ForeignCallInput = string[]
202
172
  export type ForeignCallOutput = string | string[]
203
173