zkevm-rom 0.0.1-security → 6.0.1

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.

Potentially problematic release.


This version of zkevm-rom might be problematic. Click here for more details.

Files changed (232) hide show
  1. package/.eslintrc.js +33 -0
  2. package/.github/CODEOWNERS +14 -0
  3. package/.github/ISSUE_TEMPLATE/bug.yml +38 -0
  4. package/.github/ISSUE_TEMPLATE/feature.yml +26 -0
  5. package/.github/ISSUE_TEMPLATE/question.yml +26 -0
  6. package/.github/workflows/main.yaml +40 -0
  7. package/LICENSE +636 -0
  8. package/README.md +23 -5
  9. package/audits/Hexens_Polygon_zkEVM_PUBLIC_27.02.23.pdf +0 -0
  10. package/audits/Polygon-zkEVM-Public-v1.1-verichains-19-03-2024.pdf +0 -0
  11. package/audits/zkEVM-ROM-upgrade-1-Spearbit-30-May.pdf +0 -0
  12. package/audits/zkEVM-ROM-upgrade-2-Spearbit-21-August.pdf +0 -0
  13. package/audits/zkEVM-engagement-1-Spearbit-27-March.pdf +0 -0
  14. package/audits/zkEVM-engagement-2-Spearbit-27-March.pdf +0 -0
  15. package/audits/zkEVM-engagement-3-Spearbit-6-April.pdf +0 -0
  16. package/counters/README.md +45 -0
  17. package/counters/counters-executor.js +80 -0
  18. package/counters/countersConstants.zkasm +370 -0
  19. package/counters/endIncludes.zkasm +18 -0
  20. package/counters/initIncludes.zkasm +2 -0
  21. package/counters/tests/MLOAD32.zkasm +27 -0
  22. package/counters/tests/MLOADX.zkasm +30 -0
  23. package/counters/tests/MSTORE32.zkasm +32 -0
  24. package/counters/tests/MSTOREX.zkasm +36 -0
  25. package/counters/tests/SHLarith.zkasm +28 -0
  26. package/counters/tests/SHLarithBit.zkasm +28 -0
  27. package/counters/tests/SHRarith.zkasm +28 -0
  28. package/counters/tests/SHRarithBit.zkasm +28 -0
  29. package/counters/tests/abs.zkasm +29 -0
  30. package/counters/tests/addBatchHashByteByByte.zkasm +31 -0
  31. package/counters/tests/computeGasSendCall.zkasm +30 -0
  32. package/counters/tests/divArith.zkasm +27 -0
  33. package/counters/tests/expAD.zkasm +30 -0
  34. package/counters/tests/getLenBits.zkasm +30 -0
  35. package/counters/tests/getLenBytes.zkasm +32 -0
  36. package/counters/tests/isEmptyAccount.zkasm +30 -0
  37. package/counters/tests/mulARITH.zkasm +28 -0
  38. package/counters/tests/offsetUtil.zkasm +29 -0
  39. package/counters/tests/opADDMOD.zkasm +28 -0
  40. package/counters/tests/opAdd.zkasm +27 -0
  41. package/counters/tests/opBLOCKHASH.zkasm +28 -0
  42. package/counters/tests/opCALL.zkasm +41 -0
  43. package/counters/tests/opCALLCODE.zkasm +41 -0
  44. package/counters/tests/opCALLDATACOPY.zkasm +28 -0
  45. package/counters/tests/opCALLDATALOAD.zkasm +27 -0
  46. package/counters/tests/opCODECOPY.zkasm +28 -0
  47. package/counters/tests/opCREATE.zkasm +35 -0
  48. package/counters/tests/opCREATE2.zkasm +35 -0
  49. package/counters/tests/opDELEGATECALL.zkasm +35 -0
  50. package/counters/tests/opDIV.zkasm +27 -0
  51. package/counters/tests/opEXP.zkasm +29 -0
  52. package/counters/tests/opEXTCODECOPY.zkasm +29 -0
  53. package/counters/tests/opMOD.zkasm +27 -0
  54. package/counters/tests/opMUL.zkasm +27 -0
  55. package/counters/tests/opMULMOD.zkasm +28 -0
  56. package/counters/tests/opRETURN.zkasm +32 -0
  57. package/counters/tests/opRETURNDATACOPY.zkasm +29 -0
  58. package/counters/tests/opREVERT.zkasm +32 -0
  59. package/counters/tests/opSDIV.zkasm +28 -0
  60. package/counters/tests/opSHA3.zkasm +28 -0
  61. package/counters/tests/opSIGNEXTEND.zkasm +27 -0
  62. package/counters/tests/opSMOD.zkasm +28 -0
  63. package/counters/tests/opSTATICCALL.zkasm +35 -0
  64. package/counters/tests/opSUB.zkasm +27 -0
  65. package/counters/tests/saveMem.zkasm +31 -0
  66. package/docs/opcode-cost-zk-counters.md +315 -0
  67. package/docs/usage-ecrecover.md +51 -0
  68. package/index.js +43 -0
  69. package/main/block-info.zkasm +204 -0
  70. package/main/constants.zkasm +145 -0
  71. package/main/ecrecover/addFpEc.zkasm +31 -0
  72. package/main/ecrecover/checkSqrtFpEc.zkasm +1558 -0
  73. package/main/ecrecover/constEc.zkasm +13 -0
  74. package/main/ecrecover/ecrecover.zkasm +280 -0
  75. package/main/ecrecover/invFnEc.zkasm +44 -0
  76. package/main/ecrecover/invFpEc.zkasm +45 -0
  77. package/main/ecrecover/mulFnEc.zkasm +36 -0
  78. package/main/ecrecover/mulFpEc.zkasm +36 -0
  79. package/main/ecrecover/mulPointEc.zkasm +311 -0
  80. package/main/ecrecover/sqFpEc.zkasm +38 -0
  81. package/main/ecrecover/sqrtFpEc.zkasm +70 -0
  82. package/main/end.zkasm +4 -0
  83. package/main/l2-tx-hash.zkasm +159 -0
  84. package/main/load-change-l2-block-utils.zkasm +11 -0
  85. package/main/load-change-l2-block.zkasm +28 -0
  86. package/main/load-tx-rlp-utils.zkasm +72 -0
  87. package/main/load-tx-rlp.zkasm +431 -0
  88. package/main/main.zkasm +237 -0
  89. package/main/map-opcodes.zkasm +274 -0
  90. package/main/modexp/array_lib/array_add_AGTB.zkasm +123 -0
  91. package/main/modexp/array_lib/array_add_short.zkasm +85 -0
  92. package/main/modexp/array_lib/array_div.zkasm +215 -0
  93. package/main/modexp/array_lib/array_div_long.zkasm +284 -0
  94. package/main/modexp/array_lib/array_div_short.zkasm +222 -0
  95. package/main/modexp/array_lib/array_mul.zkasm +97 -0
  96. package/main/modexp/array_lib/array_mul_long.zkasm +156 -0
  97. package/main/modexp/array_lib/array_mul_short.zkasm +127 -0
  98. package/main/modexp/array_lib/array_square.zkasm +246 -0
  99. package/main/modexp/array_lib/unused/array_add.zkasm +100 -0
  100. package/main/modexp/array_lib/unused/array_is_odd.zkasm +23 -0
  101. package/main/modexp/array_lib/unused/array_is_one.zkasm +33 -0
  102. package/main/modexp/array_lib/unused/array_is_zero.zkasm +34 -0
  103. package/main/modexp/array_lib/unused/array_sub_AGTB.zkasm +111 -0
  104. package/main/modexp/array_lib/unused/array_unshift.zkasm +37 -0
  105. package/main/modexp/array_lib/utils/array_compare.zkasm +82 -0
  106. package/main/modexp/array_lib/utils/array_trim.zkasm +49 -0
  107. package/main/modexp/constants.zkasm +5 -0
  108. package/main/modexp/modexp.zkasm +296 -0
  109. package/main/modexp/modexp_utils.zkasm +230 -0
  110. package/main/opcodes/arithmetic.zkasm +357 -0
  111. package/main/opcodes/block.zkasm +163 -0
  112. package/main/opcodes/calldata-returndata-code.zkasm +619 -0
  113. package/main/opcodes/comparison.zkasm +446 -0
  114. package/main/opcodes/context-information.zkasm +169 -0
  115. package/main/opcodes/create-terminate-context.zkasm +1011 -0
  116. package/main/opcodes/crypto.zkasm +96 -0
  117. package/main/opcodes/flow-control.zkasm +126 -0
  118. package/main/opcodes/logs.zkasm +193 -0
  119. package/main/opcodes/stack-operations.zkasm +658 -0
  120. package/main/opcodes/storage-memory.zkasm +313 -0
  121. package/main/pairings/BN254/addPointBN254.zkasm +245 -0
  122. package/main/pairings/BN254/ecAdd.zkasm +312 -0
  123. package/main/pairings/BN254/ecMul.zkasm +159 -0
  124. package/main/pairings/BN254/escalarMulBN254.zkasm +155 -0
  125. package/main/pairings/BN254/lineDiffPointsBN254.zkasm +83 -0
  126. package/main/pairings/BN254/lineSamePointsBN254.zkasm +96 -0
  127. package/main/pairings/FP12BN254/CYCLOFP12BN254/compressFp12BN254.zkasm +49 -0
  128. package/main/pairings/FP12BN254/CYCLOFP12BN254/decompressFp12BN254.zkasm +236 -0
  129. package/main/pairings/FP12BN254/CYCLOFP12BN254/expByXCompCycloFp12BN254.zkasm +444 -0
  130. package/main/pairings/FP12BN254/CYCLOFP12BN254/squareCompCycloFp12BN254.zkasm +212 -0
  131. package/main/pairings/FP12BN254/CYCLOFP12BN254/squareCycloFp12BN254.zkasm +228 -0
  132. package/main/pairings/FP12BN254/CYCLOFP12BN254/xBinDecompBN254.zkasm +64 -0
  133. package/main/pairings/FP12BN254/frob2Fp12BN254.zkasm +80 -0
  134. package/main/pairings/FP12BN254/frob3Fp12BN254.zkasm +96 -0
  135. package/main/pairings/FP12BN254/frobFp12BN254.zkasm +96 -0
  136. package/main/pairings/FP12BN254/inverseFp12BN254.zkasm +289 -0
  137. package/main/pairings/FP12BN254/mulFp12BN254.zkasm +408 -0
  138. package/main/pairings/FP12BN254/sparseMulAFp12BN254.zkasm +296 -0
  139. package/main/pairings/FP12BN254/sparseMulBFp12BN254.zkasm +291 -0
  140. package/main/pairings/FP12BN254/squareFp12BN254.zkasm +376 -0
  141. package/main/pairings/FP2BN254/addFp2BN254.zkasm +19 -0
  142. package/main/pairings/FP2BN254/escalarMulFp2BN254.zkasm +20 -0
  143. package/main/pairings/FP2BN254/invFp2BN254.zkasm +66 -0
  144. package/main/pairings/FP2BN254/mulFp2BN254.zkasm +19 -0
  145. package/main/pairings/FP2BN254/squareFp2BN254.zkasm +21 -0
  146. package/main/pairings/FP2BN254/subFp2BN254.zkasm +19 -0
  147. package/main/pairings/FP4BN254/squareFp4BN254.zkasm +76 -0
  148. package/main/pairings/FP6BN254/addFp6BN254.zkasm +59 -0
  149. package/main/pairings/FP6BN254/escalarMulFp6BN254.zkasm +51 -0
  150. package/main/pairings/FP6BN254/inverseFp6BN254.zkasm +208 -0
  151. package/main/pairings/FP6BN254/mulFp6BN254.zkasm +201 -0
  152. package/main/pairings/FP6BN254/sparseMulAFp6BN254.zkasm +65 -0
  153. package/main/pairings/FP6BN254/sparseMulBFp6BN254.zkasm +134 -0
  154. package/main/pairings/FP6BN254/sparseMulCFp6BN254.zkasm +128 -0
  155. package/main/pairings/FP6BN254/squareFp6BN254.zkasm +147 -0
  156. package/main/pairings/FP6BN254/subFp6BN254.zkasm +59 -0
  157. package/main/pairings/FPBN254/addFpBN254.zkasm +29 -0
  158. package/main/pairings/FPBN254/invFpBN254.zkasm +55 -0
  159. package/main/pairings/FPBN254/mulFpBN254.zkasm +29 -0
  160. package/main/pairings/FPBN254/reduceFpBN254.zkasm +25 -0
  161. package/main/pairings/FPBN254/squareFpBN254.zkasm +31 -0
  162. package/main/pairings/FPBN254/subFpBN254.zkasm +36 -0
  163. package/main/pairings/FRBN254/reduceFrBN254.zkasm +25 -0
  164. package/main/pairings/constants.zkasm +62 -0
  165. package/main/pairings/ecPairing.zkasm +244 -0
  166. package/main/pairings/finalExpBN254.zkasm +2095 -0
  167. package/main/pairings/halfPairingBN254.zkasm +428 -0
  168. package/main/pairings/loopLengthBN254.zkasm +75 -0
  169. package/main/pairings/millerLoopBN254.zkasm +741 -0
  170. package/main/pairings/pairingBN254.zkasm +481 -0
  171. package/main/pairings/unused/addFp12BN254.zkasm +130 -0
  172. package/main/pairings/unused/expByXCycloFp12BN254.zkasm +411 -0
  173. package/main/pairings/unused/expFp12BN254.zkasm +333 -0
  174. package/main/pairings/unused/subFp12BN254.zkasm +130 -0
  175. package/main/pairings/unused/xPseudoBinDecompBN254.zkasm +68 -0
  176. package/main/pairings/utilsTests/expCycloFp12BN254.zkasm +334 -0
  177. package/main/precompiled/end.zkasm +42 -0
  178. package/main/precompiled/identity.zkasm +99 -0
  179. package/main/precompiled/pre-ecAdd.zkasm +84 -0
  180. package/main/precompiled/pre-ecMul.zkasm +82 -0
  181. package/main/precompiled/pre-ecPairing.zkasm +72 -0
  182. package/main/precompiled/pre-ecrecover.zkasm +71 -0
  183. package/main/precompiled/pre-modexp.zkasm +367 -0
  184. package/main/precompiled/pre-sha2-256.zkasm +125 -0
  185. package/main/precompiled/revert-precompiled.zkasm +25 -0
  186. package/main/precompiled/selector.zkasm +77 -0
  187. package/main/process-change-l2-block.zkasm +147 -0
  188. package/main/process-tx.zkasm +587 -0
  189. package/main/tables/2-exp.zkasm +260 -0
  190. package/main/touched.zkasm +118 -0
  191. package/main/utils.zkasm +2335 -0
  192. package/main/vars.zkasm +117 -0
  193. package/package.json +62 -3
  194. package/test/bytes-length.zkasm +39 -0
  195. package/test/ecrecover.zkasm +538 -0
  196. package/test/lt4-test.zkasm +38 -0
  197. package/test/mstorex.zkasm +191 -0
  198. package/test/opcalldatacopy.ignore.zkasm +331 -0
  199. package/test/performance/read-push.zkasm +71 -0
  200. package/test/read-push.zkasm +304 -0
  201. package/test/testArrayArith.zkasm +1099 -0
  202. package/test/testArrayUtils.zkasm +335 -0
  203. package/test/testCycloFp12ArithBN254.zkasm +548 -0
  204. package/test/testEcAdd.zkasm +252 -0
  205. package/test/testEcMul.zkasm +231 -0
  206. package/test/testEcPairing.zkasm +436 -0
  207. package/test/testFinalExpBn254.zkasm +139 -0
  208. package/test/testFp12ArithBN254.zkasm +692 -0
  209. package/test/testFp2ArithBN254.zkasm +185 -0
  210. package/test/testFp4ArithBN254.zkasm +128 -0
  211. package/test/testFp6ArithBN254.zkasm +260 -0
  212. package/test/testFpArithBN254.zkasm +159 -0
  213. package/test/testFrArithBN254.zkasm +113 -0
  214. package/test/testHalfPairingBN254.zkasm +285 -0
  215. package/test/testModExp.zkasm +586 -0
  216. package/test/testModExpReturn.zkasm +81 -0
  217. package/test/testPairingBN254.zkasm +463 -0
  218. package/test/testPointArithBN254.zkasm +270 -0
  219. package/test/testSHA256.zkasm +27 -0
  220. package/test/touched-assert.zkasm +59 -0
  221. package/test/utils-expAD.zkasm +48 -0
  222. package/test/utils-getLenBytes.zkasm +36 -0
  223. package/tools/audit-tools/registry-op-checker.js +71 -0
  224. package/tools/get-not-used-labels.js +31 -0
  225. package/tools/helpers/helpers.js +47 -0
  226. package/tools/modexp-utils/README.md +5 -0
  227. package/tools/modexp-utils/modexp-test-gen.js +168 -0
  228. package/tools/modexp-utils/modexp-test-int.sage +37 -0
  229. package/tools/parallel-testing/checker.sh +6 -0
  230. package/tools/parallel-testing/gen-parallel-tests.js +78 -0
  231. package/tools/parallel-testing/parallel-tests-sample/sample.test.js +136 -0
  232. package/tools/run-tests-zkasm.js +83 -0
@@ -0,0 +1,428 @@
1
+ ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
2
+ ;;
3
+ ;; halfPairingBN254:
4
+ ;; input: P ∈ G1 and Q ∈ G2
5
+ ;; output: It returns 1 if either P = 0 or Q = 0 and f_{r,Q}(P) ∈ Fp12 otherwise
6
+ ;;
7
+ ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
8
+
9
+ VAR GLOBAL halfPairingBN254_P_x
10
+ VAR GLOBAL halfPairingBN254_P_y
11
+ VAR GLOBAL halfPairingBN254_Q_x1
12
+ VAR GLOBAL halfPairingBN254_Q_x2
13
+ VAR GLOBAL halfPairingBN254_Q_y1
14
+ VAR GLOBAL halfPairingBN254_Q_y2
15
+
16
+ VAR GLOBAL halfPairingBN254_f11_x
17
+ VAR GLOBAL halfPairingBN254_f11_y
18
+ VAR GLOBAL halfPairingBN254_f12_x
19
+ VAR GLOBAL halfPairingBN254_f12_y
20
+ VAR GLOBAL halfPairingBN254_f13_x
21
+ VAR GLOBAL halfPairingBN254_f13_y
22
+ VAR GLOBAL halfPairingBN254_f21_x
23
+ VAR GLOBAL halfPairingBN254_f21_y
24
+ VAR GLOBAL halfPairingBN254_f22_x
25
+ VAR GLOBAL halfPairingBN254_f22_y
26
+ VAR GLOBAL halfPairingBN254_f23_x
27
+ VAR GLOBAL halfPairingBN254_f23_y
28
+
29
+ VAR GLOBAL halfPairingBN254_RR
30
+
31
+ VAR GLOBAL halfPairingBN254_P_x3
32
+ VAR GLOBAL halfPairingBN254_Q_RHS_x
33
+ VAR GLOBAL halfPairingBN254_Q_RHS_y
34
+ VAR GLOBAL halfPairingBN254_psi_x1
35
+ VAR GLOBAL halfPairingBN254_psi_x2
36
+ VAR GLOBAL halfPairingBN254_psi_y1
37
+ VAR GLOBAL halfPairingBN254_psi_y2
38
+
39
+ ; ERROR CODES (B)
40
+ ; 0 - no error
41
+ ; 1 - P_x is too big
42
+ ; 2 - P_y is too big
43
+ ; 3 - Q_x1 is too big
44
+ ; 4 - Q_x2 is too big
45
+ ; 5 - Q_y1 is too big
46
+ ; 6 - Q_y2 is too big
47
+ ; 7 - P is not in G1
48
+ ; 8 - Q is not in G2
49
+
50
+ halfPairingBN254:
51
+ RR :MSTORE(halfPairingBN254_RR)
52
+
53
+ %BN254_P_MINUS_ONE => A
54
+ $ => B :MLOAD(halfPairingBN254_P_x)
55
+ $ :LT, JMPC(halfPairingBN254_Px_too_big)
56
+ $ => B :MLOAD(halfPairingBN254_P_y)
57
+ $ :LT, JMPC(halfPairingBN254_Py_too_big)
58
+ $ => B :MLOAD(halfPairingBN254_Q_x1)
59
+ $ :LT, JMPC(halfPairingBN254_Qx1_too_big)
60
+ $ => B :MLOAD(halfPairingBN254_Q_x2)
61
+ $ :LT, JMPC(halfPairingBN254_Qx2_too_big)
62
+ $ => B :MLOAD(halfPairingBN254_Q_y1)
63
+ $ :LT, JMPC(halfPairingBN254_Qy1_too_big)
64
+ $ => B :MLOAD(halfPairingBN254_Q_y2)
65
+ $ :LT, JMPC(halfPairingBN254_Qy2_too_big)
66
+
67
+ ; Is P = O?
68
+ 0n => B
69
+ $ => A :MLOAD(halfPairingBN254_P_x)
70
+ $ :EQ, JMPNC(__halfPairingBN254_P_continue)
71
+ $ => A :MLOAD(halfPairingBN254_P_y)
72
+ $ :EQ, JMPC(halfPairingBN254_P_is_zero)
73
+ __halfPairingBN254_P_continue:
74
+
75
+ ; Is Q = O?
76
+ $ => A :MLOAD(halfPairingBN254_Q_x1)
77
+ $ :EQ, JMPNC(__halfPairingBN254_Q_continue1)
78
+ $ => A :MLOAD(halfPairingBN254_Q_x2)
79
+ $ :EQ, JMPNC(__halfPairingBN254_Q_continue1)
80
+ $ => A :MLOAD(halfPairingBN254_Q_y1)
81
+ $ :EQ, JMPNC(__halfPairingBN254_Q_continue1)
82
+ $ => A :MLOAD(halfPairingBN254_Q_y2)
83
+ $ :EQ, JMPC(halfPairingBN254_Q_is_zero)
84
+ __halfPairingBN254_Q_continue1:
85
+
86
+ :JMP(halfPairingBN254_P_subgroup_check)
87
+
88
+ halfPairingBN254_P_is_zero:
89
+ ; Is Q = O?
90
+ $ => A :MLOAD(halfPairingBN254_Q_x1)
91
+ $ :EQ, JMPNC(__halfPairingBN254_Q_continue2)
92
+ $ => A :MLOAD(halfPairingBN254_Q_x2)
93
+ $ :EQ, JMPNC(__halfPairingBN254_Q_continue2)
94
+ $ => A :MLOAD(halfPairingBN254_Q_y1)
95
+ $ :EQ, JMPNC(__halfPairingBN254_Q_continue2)
96
+ $ => A :MLOAD(halfPairingBN254_Q_y2)
97
+ $ :EQ, JMPC(halfPairingBN254_P_and_Q_are_zero)
98
+ __halfPairingBN254_Q_continue2:
99
+
100
+ ; Check that Q is in G2
101
+ ; Q in G2 iff Q in E' and psi(Q) == [6x²]Q as proven in Proposition 3 of 2022/352
102
+
103
+ ; 1] Check if Q is in E'(Fp2)
104
+ ; Q in E' iff (Q.y1 + Q.y2·u)² == (Q.x1 + Q.x2·u)³ + 3/(9+u)
105
+ ; 1.1] Compute LHS and RHS
106
+ $ => A :MLOAD(halfPairingBN254_Q_x1)
107
+ $ => B :MLOAD(halfPairingBN254_Q_x2), CALL(squareFp2BN254)
108
+ ; E + C·u = (Q.x1 + Q.x2·u)²
109
+
110
+ E => A
111
+ C => B
112
+ $ => C :MLOAD(halfPairingBN254_Q_x1)
113
+ $ => D :MLOAD(halfPairingBN254_Q_x2), CALL(mulFp2BN254)
114
+ ; E + C·u = (Q.x1 + Q.x2·u)³
115
+
116
+ E => A
117
+ C => B
118
+ %BN254_ETWISTED_B_X => C
119
+ %BN254_ETWISTED_B_Y => D :CALL(addFp2BN254)
120
+ ; E + C·u = (Q.x1 + Q.x2·u)³ + 3/(9+u)
121
+ E :MSTORE(halfPairingBN254_Q_RHS_x)
122
+ C :MSTORE(halfPairingBN254_Q_RHS_y)
123
+
124
+ $ => A :MLOAD(halfPairingBN254_Q_y1)
125
+ $ => B :MLOAD(halfPairingBN254_Q_y2), CALL(squareFp2BN254)
126
+ ; E + C·u = (Q.y1 + Q.y2·u)²
127
+
128
+ ; 1.2] Check if LHS == RHS
129
+ E => A
130
+ $ => B :MLOAD(halfPairingBN254_Q_RHS_x)
131
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
132
+
133
+ C => A
134
+ $ => B :MLOAD(halfPairingBN254_Q_RHS_y)
135
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
136
+
137
+ ; 2] Check if psi(Q) == [6x²]Q
138
+ ; 2.1] Compute psi(Q)
139
+ %BN254_P => A
140
+ $ => B :MLOAD(halfPairingBN254_Q_x2)
141
+ $ => D :SUB ; D = -Qx2
142
+ %FROBENIUS_GAMMA121 => A
143
+ %FROBENIUS_GAMMA122 => B
144
+ $ => C :MLOAD(halfPairingBN254_Q_x1), CALL(mulFp2BN254)
145
+ E :MSTORE(halfPairingBN254_psi_x1)
146
+ C :MSTORE(halfPairingBN254_psi_x2)
147
+
148
+ %BN254_P => A
149
+ $ => B :MLOAD(halfPairingBN254_Q_y2)
150
+ $ => D :SUB ; D = -Qy2
151
+ %FROBENIUS_GAMMA131 => A
152
+ %FROBENIUS_GAMMA132 => B
153
+ $ => C :MLOAD(halfPairingBN254_Q_y1), CALL(mulFp2BN254)
154
+ E :MSTORE(halfPairingBN254_psi_y1)
155
+ C :MSTORE(halfPairingBN254_psi_y2)
156
+
157
+ ; 2.2] Compute [6x²]Q
158
+ $ => A :MLOAD(halfPairingBN254_Q_x1)
159
+ $ => B :MLOAD(halfPairingBN254_Q_x2)
160
+ $ => C :MLOAD(halfPairingBN254_Q_y1)
161
+ $ => D :MLOAD(halfPairingBN254_Q_y2)
162
+ A :MSTORE(escalarMulBN254_P_x1)
163
+ B :MSTORE(escalarMulBN254_P_x2)
164
+ C :MSTORE(escalarMulBN254_P_y1)
165
+ D :MSTORE(escalarMulBN254_P_y2)
166
+ %BN254_SIX_TIMES_X_SQ :MSTORE(escalarMulBN254_k), CALL(escalarMulBN254)
167
+
168
+
169
+ ; 2.3] Check if psi(Q) == [6x²]Q
170
+ $ => A :MLOAD(halfPairingBN254_psi_x1)
171
+ $ => B :MLOAD(escalarMulBN254_Q_x1)
172
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
173
+
174
+ $ => A :MLOAD(halfPairingBN254_psi_x2)
175
+ $ => B :MLOAD(escalarMulBN254_Q_x2)
176
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
177
+
178
+ $ => A :MLOAD(halfPairingBN254_psi_y1)
179
+ $ => B :MLOAD(escalarMulBN254_Q_y1)
180
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
181
+
182
+ $ => A :MLOAD(halfPairingBN254_psi_y2)
183
+ $ => B :MLOAD(escalarMulBN254_Q_y2)
184
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
185
+
186
+ ; e(O,Q) = 1
187
+ 1n :MSTORE(halfPairingBN254_f11_x)
188
+ 0n :MSTORE(halfPairingBN254_f11_y)
189
+ 0n :MSTORE(halfPairingBN254_f12_x)
190
+ 0n :MSTORE(halfPairingBN254_f12_y)
191
+ 0n :MSTORE(halfPairingBN254_f13_x)
192
+ 0n :MSTORE(halfPairingBN254_f13_y)
193
+ 0n :MSTORE(halfPairingBN254_f21_x)
194
+ 0n :MSTORE(halfPairingBN254_f21_y)
195
+ 0n :MSTORE(halfPairingBN254_f22_x)
196
+ 0n :MSTORE(halfPairingBN254_f22_y)
197
+ 0n :MSTORE(halfPairingBN254_f23_x)
198
+ 0n :MSTORE(halfPairingBN254_f23_y)
199
+
200
+ 0 => B :JMP(halfPairingBN254_end)
201
+
202
+ halfPairingBN254_Q_is_zero:
203
+ ; Check that P is in G1
204
+ ; P in G1 iff (Py)² == (Px)³ + 3 (mod p)
205
+ ; 1] Compute LHS and RHS
206
+ $ => A,B :MLOAD(halfPairingBN254_P_x), CALL(mulFpBN254); C = (Px)²
207
+ C => A ; A = (Px)²
208
+ $ => B :MLOAD(halfPairingBN254_P_x), CALL(mulFpBN254); C = (Px)³
209
+
210
+ %BN254_E_B => A :CALL(addFpBN254) ; C = (Px)³ + 3
211
+ C :MSTORE(halfPairingBN254_P_x3) ; halfPairingBN254_P_x3 = (Px)³ + 3
212
+
213
+ $ => A,B :MLOAD(halfPairingBN254_P_y), CALL(mulFpBN254); C = (Py)²
214
+
215
+ ; 2] Check if LHS == RHS
216
+ C => A
217
+ $ => B :MLOAD(halfPairingBN254_P_x3)
218
+ $ :EQ, JMPNC(halfPairingBN254_P_is_not_in_G1)
219
+
220
+ ; e(P,O) = 1
221
+ 1n :MSTORE(halfPairingBN254_f11_x)
222
+ 0n :MSTORE(halfPairingBN254_f11_y)
223
+ 0n :MSTORE(halfPairingBN254_f12_x)
224
+ 0n :MSTORE(halfPairingBN254_f12_y)
225
+ 0n :MSTORE(halfPairingBN254_f13_x)
226
+ 0n :MSTORE(halfPairingBN254_f13_y)
227
+ 0n :MSTORE(halfPairingBN254_f21_x)
228
+ 0n :MSTORE(halfPairingBN254_f21_y)
229
+ 0n :MSTORE(halfPairingBN254_f22_x)
230
+ 0n :MSTORE(halfPairingBN254_f22_y)
231
+ 0n :MSTORE(halfPairingBN254_f23_x)
232
+ 0n :MSTORE(halfPairingBN254_f23_y)
233
+
234
+ 0 => B :JMP(halfPairingBN254_end)
235
+
236
+ halfPairingBN254_P_and_Q_are_zero:
237
+ ; e(O,O) = 1
238
+ 1n :MSTORE(halfPairingBN254_f11_x)
239
+ 0n :MSTORE(halfPairingBN254_f11_y)
240
+ 0n :MSTORE(halfPairingBN254_f12_x)
241
+ 0n :MSTORE(halfPairingBN254_f12_y)
242
+ 0n :MSTORE(halfPairingBN254_f13_x)
243
+ 0n :MSTORE(halfPairingBN254_f13_y)
244
+ 0n :MSTORE(halfPairingBN254_f21_x)
245
+ 0n :MSTORE(halfPairingBN254_f21_y)
246
+ 0n :MSTORE(halfPairingBN254_f22_x)
247
+ 0n :MSTORE(halfPairingBN254_f22_y)
248
+ 0n :MSTORE(halfPairingBN254_f23_x)
249
+ 0n :MSTORE(halfPairingBN254_f23_y)
250
+
251
+ 0 => B :JMP(halfPairingBN254_end)
252
+
253
+ halfPairingBN254_P_subgroup_check:
254
+ ; Check that P is in G1
255
+ ; P in G1 iff (Py)² == (Px)³ + 3 (mod p)
256
+ ; 1] Compute LHS and RHS
257
+ $ => A,B :MLOAD(halfPairingBN254_P_x), CALL(mulFpBN254); C = (Px)²
258
+ C => A ; A = (Px)²
259
+ $ => B :MLOAD(halfPairingBN254_P_x), CALL(mulFpBN254); C = (Px)³
260
+
261
+ %BN254_E_B => A :CALL(addFpBN254) ; C = (Px)³ + 3
262
+ C :MSTORE(halfPairingBN254_P_x3) ; halfPairingBN254_P_x3 = (Px)³ + 3
263
+
264
+ $ => A,B :MLOAD(halfPairingBN254_P_y), CALL(mulFpBN254); C = (Py)²
265
+
266
+ ; 2] Check if LHS == RHS
267
+ C => A
268
+ $ => B :MLOAD(halfPairingBN254_P_x3)
269
+ $ :EQ, JMPNC(halfPairingBN254_P_is_not_in_G1)
270
+
271
+ halfPairingBN254_Q_subgroup_check:
272
+ ; Check that Q is in G2
273
+ ; Q in G2 iff Q in E' and psi(Q) == [6x²]Q as proven in Proposition 3 of 2022/352
274
+
275
+ ; 1] Check if Q is in E'(Fp2)
276
+ ; Q in E' iff (Q.y1 + Q.y2·u)² == (Q.x1 + Q.x2·u)³ + 3/(9+u)
277
+ ; 1.1] Compute LHS and RHS
278
+ $ => A :MLOAD(halfPairingBN254_Q_x1)
279
+ $ => B :MLOAD(halfPairingBN254_Q_x2), CALL(squareFp2BN254)
280
+ ; E + C·u = (Q.x1 + Q.x2·u)²
281
+
282
+ E => A
283
+ C => B
284
+ $ => C :MLOAD(halfPairingBN254_Q_x1)
285
+ $ => D :MLOAD(halfPairingBN254_Q_x2), CALL(mulFp2BN254)
286
+ ; E + C·u = (Q.x1 + Q.x2·u)³
287
+
288
+ E => A
289
+ C => B
290
+ %BN254_ETWISTED_B_X => C
291
+ %BN254_ETWISTED_B_Y => D :CALL(addFp2BN254)
292
+ ; E + C·u = (Q.x1 + Q.x2·u)³ + 3/(9+u)
293
+ E :MSTORE(halfPairingBN254_Q_RHS_x)
294
+ C :MSTORE(halfPairingBN254_Q_RHS_y)
295
+
296
+ $ => A :MLOAD(halfPairingBN254_Q_y1)
297
+ $ => B :MLOAD(halfPairingBN254_Q_y2), CALL(squareFp2BN254)
298
+ ; E + C·u = (Q.y1 + Q.y2·u)²
299
+
300
+ ; 1.2] Check if LHS == RHS
301
+ E => A
302
+ $ => B :MLOAD(halfPairingBN254_Q_RHS_x)
303
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
304
+
305
+ C => A
306
+ $ => B :MLOAD(halfPairingBN254_Q_RHS_y)
307
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
308
+
309
+ ; 2] Check if psi(Q) == [6x²]Q
310
+ ; 2.1] Compute psi(Q)
311
+ %BN254_P => A
312
+ $ => B :MLOAD(halfPairingBN254_Q_x2)
313
+ $ => D :SUB ; D = -Qx2
314
+ %FROBENIUS_GAMMA121 => A
315
+ %FROBENIUS_GAMMA122 => B
316
+ $ => C :MLOAD(halfPairingBN254_Q_x1), CALL(mulFp2BN254)
317
+ E :MSTORE(halfPairingBN254_psi_x1)
318
+ C :MSTORE(halfPairingBN254_psi_x2)
319
+
320
+ %BN254_P => A
321
+ $ => B :MLOAD(halfPairingBN254_Q_y2)
322
+ $ => D :SUB ; D = -Qx2
323
+ %FROBENIUS_GAMMA131 => A
324
+ %FROBENIUS_GAMMA132 => B
325
+ $ => C :MLOAD(halfPairingBN254_Q_y1), CALL(mulFp2BN254)
326
+ E :MSTORE(halfPairingBN254_psi_y1)
327
+ C :MSTORE(halfPairingBN254_psi_y2)
328
+
329
+ ; 2.2] Compute [6x²]Q
330
+ $ => A :MLOAD(halfPairingBN254_Q_x1)
331
+ $ => B :MLOAD(halfPairingBN254_Q_x2)
332
+ $ => C :MLOAD(halfPairingBN254_Q_y1)
333
+ $ => D :MLOAD(halfPairingBN254_Q_y2)
334
+ A :MSTORE(escalarMulBN254_P_x1)
335
+ B :MSTORE(escalarMulBN254_P_x2)
336
+ C :MSTORE(escalarMulBN254_P_y1)
337
+ D :MSTORE(escalarMulBN254_P_y2)
338
+ %BN254_SIX_TIMES_X_SQ :MSTORE(escalarMulBN254_k), CALL(escalarMulBN254)
339
+
340
+
341
+ ; 2.3] Check if psi(Q) == [6x²]Q
342
+ $ => A :MLOAD(halfPairingBN254_psi_x1)
343
+ $ => B :MLOAD(escalarMulBN254_Q_x1)
344
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
345
+
346
+ $ => A :MLOAD(halfPairingBN254_psi_x2)
347
+ $ => B :MLOAD(escalarMulBN254_Q_x2)
348
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
349
+
350
+ $ => A :MLOAD(halfPairingBN254_psi_y1)
351
+ $ => B :MLOAD(escalarMulBN254_Q_y1)
352
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
353
+
354
+ $ => A :MLOAD(halfPairingBN254_psi_y2)
355
+ $ => B :MLOAD(escalarMulBN254_Q_y2)
356
+ $ :EQ, JMPNC(halfPairingBN254_Q_is_not_in_G2)
357
+
358
+ halfPairingBN254_Miller_loop:
359
+ $ => A :MLOAD(halfPairingBN254_P_x)
360
+ $ => B :MLOAD(halfPairingBN254_P_y)
361
+ A :MSTORE(millerLoopBN254_P_x)
362
+ B :MSTORE(millerLoopBN254_P_y)
363
+ $ => A :MLOAD(halfPairingBN254_Q_x1)
364
+ $ => B :MLOAD(halfPairingBN254_Q_x2)
365
+ $ => C :MLOAD(halfPairingBN254_Q_y1)
366
+ $ => D :MLOAD(halfPairingBN254_Q_y2)
367
+ A :MSTORE(millerLoopBN254_Q_x1)
368
+ B :MSTORE(millerLoopBN254_Q_x2)
369
+ C :MSTORE(millerLoopBN254_Q_y1)
370
+ D :MSTORE(millerLoopBN254_Q_y2), CALL(millerLoopBN254)
371
+ $ => A :MLOAD(millerLoopBN254_f11_x)
372
+ $ => B :MLOAD(millerLoopBN254_f11_y)
373
+ A :MSTORE(halfPairingBN254_f11_x)
374
+ B :MSTORE(halfPairingBN254_f11_y)
375
+ $ => A :MLOAD(millerLoopBN254_f12_x)
376
+ $ => B :MLOAD(millerLoopBN254_f12_y)
377
+ A :MSTORE(halfPairingBN254_f12_x)
378
+ B :MSTORE(halfPairingBN254_f12_y)
379
+ $ => A :MLOAD(millerLoopBN254_f13_x)
380
+ $ => B :MLOAD(millerLoopBN254_f13_y)
381
+ A :MSTORE(halfPairingBN254_f13_x)
382
+ B :MSTORE(halfPairingBN254_f13_y)
383
+ $ => A :MLOAD(millerLoopBN254_f21_x)
384
+ $ => B :MLOAD(millerLoopBN254_f21_y)
385
+ A :MSTORE(halfPairingBN254_f21_x)
386
+ B :MSTORE(halfPairingBN254_f21_y)
387
+ $ => A :MLOAD(millerLoopBN254_f22_x)
388
+ $ => B :MLOAD(millerLoopBN254_f22_y)
389
+ A :MSTORE(halfPairingBN254_f22_x)
390
+ B :MSTORE(halfPairingBN254_f22_y)
391
+ $ => A :MLOAD(millerLoopBN254_f23_x)
392
+ $ => B :MLOAD(millerLoopBN254_f23_y)
393
+ A :MSTORE(halfPairingBN254_f23_x)
394
+ B :MSTORE(halfPairingBN254_f23_y)
395
+
396
+ 0 => B :JMP(halfPairingBN254_end)
397
+
398
+ ; ERRORS
399
+ halfPairingBN254_Px_too_big:
400
+ 1 => B :JMP(halfPairingBN254_error)
401
+
402
+ halfPairingBN254_Py_too_big:
403
+ 2 => B :JMP(halfPairingBN254_error)
404
+
405
+ halfPairingBN254_Qx1_too_big:
406
+ 3 => B :JMP(halfPairingBN254_error)
407
+
408
+ halfPairingBN254_Qx2_too_big:
409
+ 4 => B :JMP(halfPairingBN254_error)
410
+
411
+ halfPairingBN254_Qy1_too_big:
412
+ 5 => B :JMP(halfPairingBN254_error)
413
+
414
+ halfPairingBN254_Qy2_too_big:
415
+ 6 => B :JMP(halfPairingBN254_error)
416
+
417
+ halfPairingBN254_P_is_not_in_G1:
418
+ 7 => B :JMP(halfPairingBN254_error)
419
+
420
+ halfPairingBN254_Q_is_not_in_G2:
421
+ 8 => B :JMP(halfPairingBN254_error)
422
+
423
+ halfPairingBN254_error:
424
+ 0 => A
425
+
426
+ halfPairingBN254_end:
427
+ $ => RR :MLOAD(halfPairingBN254_RR)
428
+ :RETURN
@@ -0,0 +1,75 @@
1
+ ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
2
+ ;;
3
+ ;; loopLengthBN254:
4
+ ;; output: A digit of the (little-endian) pseudobinary representation of the loop length
5
+ ;; of the optimal ate pairing over the BN254:
6
+ ;; 0001010-1001-100100110-10010-1000011100-100100000-1001100-1000110-1001011
7
+ ;;
8
+ ;; NOTE: The loop length is precisely 6·%BN254_X + 2, that is 29793968203157093288.
9
+ ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
10
+
11
+ loopLengthBN254:
12
+ 0 => B :RETURN
13
+ 0 => B :RETURN
14
+ 0 => B :RETURN
15
+ 1 => B :RETURN
16
+ 0 => B :RETURN
17
+ 1 => B :RETURN
18
+ 0 => B :RETURN
19
+ -1 => B :RETURN
20
+ 0 => B :RETURN
21
+ 0 => B :RETURN
22
+ 1 => B :RETURN
23
+ -1 => B :RETURN
24
+ 0 => B :RETURN
25
+ 0 => B :RETURN
26
+ 1 => B :RETURN
27
+ 0 => B :RETURN
28
+ 0 => B :RETURN
29
+ 1 => B :RETURN
30
+ 1 => B :RETURN
31
+ 0 => B :RETURN
32
+ -1 => B :RETURN
33
+ 0 => B :RETURN
34
+ 0 => B :RETURN
35
+ 1 => B :RETURN
36
+ 0 => B :RETURN
37
+ -1 => B :RETURN
38
+ 0 => B :RETURN
39
+ 0 => B :RETURN
40
+ 0 => B :RETURN
41
+ 0 => B :RETURN
42
+ 1 => B :RETURN
43
+ 1 => B :RETURN
44
+ 1 => B :RETURN
45
+ 0 => B :RETURN
46
+ 0 => B :RETURN
47
+ -1 => B :RETURN
48
+ 0 => B :RETURN
49
+ 0 => B :RETURN
50
+ 1 => B :RETURN
51
+ 0 => B :RETURN
52
+ 0 => B :RETURN
53
+ 0 => B :RETURN
54
+ 0 => B :RETURN
55
+ 0 => B :RETURN
56
+ -1 => B :RETURN
57
+ 0 => B :RETURN
58
+ 0 => B :RETURN
59
+ 1 => B :RETURN
60
+ 1 => B :RETURN
61
+ 0 => B :RETURN
62
+ 0 => B :RETURN
63
+ -1 => B :RETURN
64
+ 0 => B :RETURN
65
+ 0 => B :RETURN
66
+ 0 => B :RETURN
67
+ 1 => B :RETURN
68
+ 1 => B :RETURN
69
+ 0 => B :RETURN
70
+ -1 => B :RETURN
71
+ 0 => B :RETURN
72
+ 0 => B :RETURN
73
+ 1 => B :RETURN
74
+ 0 => B :RETURN
75
+ 1 => B :RETURN