-
Notifications
You must be signed in to change notification settings - Fork 6
Description
yAcademy RLN Review
Review Resources:
None beyond the code repositories.
Auditors:
- Chen Wen Kang
- Vincent Owen
Table of Contents
- Review Summary
- Scope
- Code Evaluation Matrix
- Findings Explanation
- Critical Findings
- High Findings
- Medium Findings
- Low Findings
- Informational Findings
- Final remarks
Review Summary
RLN
Rate limiting nullifier (RLN) is a construct based on zero-knowledge proofs that provides an anonymous rate-limited signaling/messaging framework suitable for decentralized (and centralized) environments. Anonymity refers to the unlinkability of messages to their owner.
RLN Repo were reviewed over 4 days. The code review was performed by 2 auditors between 11th June and 15th June, 2023. The review was limited to the latest commit at the start of the review. This was commit 37073131b9c5910228ad6bdf0fc50080e507166a for the RLN repo.
Scope
The scope of the review consisted of the following circuits at the specific commit:
rln.circomutils.circomwithdraw.circom
This review is a code review to identify potential vulnerabilities in the code. The reviewers did not investigate security practices or operational security and assumed that privileged accounts could be trusted. The reviewers did not evaluate the security of the code relative to a standard or specification. The review may not have identified all potential attack vectors or areas of vulnerability.
The auditors make no warranties regarding the security of the code and do not warrant that the code is free from defects. The auditors do not represent nor imply to third parties that the code has been audited nor that the code is free from defects. By deploying or using the code, RLN and users of the contracts agree to use the code at their own risk.
Code Evaluation Matrix
| Category | Mark | Description |
|---|---|---|
| Mathematics | Good | - |
| Complexity | Good | - |
| Libraries | Good | - |
| Code stability | Good | - |
| Documentation | Average | - |
| Testing and verification | Low | More test recommended |
Findings Explanation
Findings are broken down into sections by their respective impact:
- Critical, High, Medium, Low impact
- These are findings that range from attacks that may cause loss of funds, impact control/ownership of the contracts, or cause any unintended consequences/actions that are outside the scope of the requirements
- Informational
- Findings including recommendations and best practices
Critical Findings
None.
High Findings
None
Medium Findings
None.
Low Findings
1. Low - Missing non-zero check and range check for public input x
rln.circom has a public input x that is used to generate the identity commitment. The circuit does not check if the public input x is non-zero nor within a certain range, which will allow the prover to accept any value for x and generate a valid proof that might expose additional information.
Technical Details
When given a value of 0 for x, the circuit will assign y with the value of identitySecret + a1 * x, which resolves to identitySecret, exposing the user secret.
Given a large value like p for x, the y value might overflow as the calculation of identitySecret + a1 * x will result in a value larger than the field size.
This is a non-issue for verification as the verifier will only accept valid x value to the proof.
Impact
Low. Given that the proof generation is done on the client side, the client can ensure that the public input x is non-zero and poseidon hashed before generating the proof.
Recommendation
There are 2 possible solutions to this issue:
- Perform the hashing of
xin the circuit. - Add a check in the circuit to ensure that
xis non-zero.
Informational Findings
1. Informational - Unused Public Inputs Optimized Out
withdraw.circom has a public input address that will be optimized out by the compiler, as its not used as a constraint in the circuit.
This is not an issue as this circuit is used for utility, but if the circuit is used as a standalone circuit, the verifier will accept any value for public input address, allowing proof to be reuse for any address value.
Technical Details
None.
Impact
Informational.
Recommendation
Remove the public input address from the circuit.
2. Informational - Misleading Naming Convention for Utility Circuits
The withdraw.circom does not involve the generation of a proof to withdraw funds from the contract. Instead, it is a utility circuit that is used to generate the identity commitment from a private identity hash. The naming of the circuit is misleading.
Technical Details
NA.
Impact
Informational.
Recommendation
Rename the circuit to identity_commitment.circom to better reflect its purpose.
Developer Response
None
Final remarks
The circuits are well written and documented. There's no critical issues, only some low severity issues that can be easily fixed.