Shorten the revert strings to fit in 32 bytes. That will affect gas optimization.
C4-002 : Adding unchecked directive can save gas
Impact
For the arithmetic operations that will never over/underflow, using the unchecked directive (Solidity v0.8 has default overflow/underflow checks) can save some gas from the unnecessary internal over/underflow checks.
Proof of Concept
contracts/Basket.sol::43 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/Basket.sol::70 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/Basket.sol::93 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/NibblVault.sol::506 => for (uint256 i = 0; i < _assetAddresses.length; i++) {
contracts/NibblVault.sol::525 => for (uint256 i = 0; i < _assets.length; i++) {
contracts/NibblVault.sol::547 => for (uint256 i = 0; i < _assets.length; i++) {
Tools Used
None
Recommended Mitigation Steps
Consider applying unchecked arithmetic where overflow/underflow is not possible. Example can be seen from below.
Unchecked{i++};
C4-003 : Check if amount > 0 before token transfer can save gas
Impact
Since _amount can be 0. Checking if (_amount != 0) before the transfer can potentially save an external call and the unnecessary gas cost of a 0 token transfer.
C4-004 : There is no need to assign default values to variables
Impact - Gas Optimization
Boolean is default initialized to false. There is no need assign false to variable.
Proof of Concept
contracts/Bancor/BancorFormula.sol::285 => uint256 res = 0;
contracts/Bancor/BancorFormula.sol::312 => uint8 res = 0;
contracts/Bancor/BancorFormula.sol::369 => uint256 res = 0;
contracts/Bancor/BancorFormula.sol::419 => uint256 res = 0;
contracts/Bancor/BancorFormula.sol::460 => uint256 res = 0;
contracts/Basket.sol::43 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/Basket.sol::70 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/Basket.sol::93 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/NibblVault.sol::506 => for (uint256 i = 0; i < _assetAddresses.length; i++) {
contracts/NibblVault.sol::525 => for (uint256 i = 0; i < _assets.length; i++) {
contracts/NibblVault.sol::547 => for (uint256 i = 0; i < _assets.length; i++) {
Tools Used
Code Review
Recommended Mitigation Steps
bool x = false costs more gas than bool x without having any different functionality.
C4-005 : Using operator && used more gas
Impact
Using double require instead of operator && can save more gas.
C4-007 : Use Custom Errors instead of Revert Strings to save Gas
Custom errors from Solidity 0.8.4 are cheaper than revert strings (cheaper deployment cost and runtime cost when the revert condition is met)
Source Custom Errors in Solidity:
Starting from Solidity v0.8.4, there is a convenient and gas-efficient way to explain to users why an operation failed through the use of custom errors. Until now, you could already use strings to give more information about failures (e.g., revert("Insufficient funds.");), but they are rather expensive, especially when it comes to deploy cost, and it is difficult to use dynamic information in them.
Custom errors are defined using the error statement, which can be used inside and outside of contracts (including interfaces and libraries).
Instances include:
All require Statements
Tools Used
Code Review
Recommended Mitigation Steps
Recommended to replace revert strings with custom errors.
C4-008 : Use Shift Right/Left instead of Division/Multiplication if possible
Impact
A division/multiplication by any number x being a power of 2 can be calculated by shifting log2(x) to the right/left.
While the DIV opcode uses 5 gas, the SHR opcode only uses 3 gas. Furthermore, Solidity's division operation also includes a division-by-0 prevention which is bypassed using shifting.
Proof of Concept
Contracts
contracts/Bancor/BancorFormula.sol::344 => uint8 mid = (lo + hi) / 2;
Tools Used
None
Recommended Mitigation Steps
A division/multiplication by any number x being a power of 2 can be calculated by shifting log2(x) to the right/left.
C4-009 : Cache array length in for loops can save gas
Impact
Reading array length at each iteration of the loop takes 6 gas (3 for mload and 3 to place memory_offset) in the stack.
Caching the array length in the stack saves around 3 gas per iteration.
Proof of Concept
Navigate to the following smart contract line.
contracts/Basket.sol::43 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/Basket.sol::70 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/Basket.sol::93 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/NibblVault.sol::506 => for (uint256 i = 0; i < _assetAddresses.length; i++) {
contracts/NibblVault.sol::525 => for (uint256 i = 0; i < _assets.length; i++) {
contracts/NibblVault.sol::547 => for (uint256 i = 0; i < _assets.length; i++) {
Tools Used
None
Recommended Mitigation Steps
Consider to cache array length.
C4-010 : State Variables that can be changed to immutable
Impact
Solidity 0.6.5
introduced immutable as a major feature. It allows setting
contract-level variables at construction time which gets stored in code
rather than storage.
Consider the following generic example:
contract C {
/// The owner is set during contruction time, and never changed afterwards.
address public owner = msg.sender;
}
In the above example, each call to the function owner() reads from
storage, using a sload. After
EIP-2929, this costs 2100 gas
cold or 100 gas warm. However, the following snippet is more gas
efficient:
contract C {
/// The owner is set during contruction time, and never changed afterwards.
address public immutable owner = msg.sender;
}
In the above example, each storage read of the owner state variable is
replaced by the instruction push32 value, where value is set during
contract construction time. Unlike the last example, this costs only 3
gas.
C4-011 : Use calldata instead of memory for function parameters
Impact
In some cases, having function arguments in calldata instead of
memory is more optimal.
Consider the following generic example:
contract C {
function add(uint[] memory arr) external returns (uint sum) {
uint length = arr.length;
for (uint i = 0; i < arr.length; i++) {
sum += arr[i];
}
}
}
In the above example, the dynamic array arr has the storage location
memory. When the function gets called externally, the array values are
kept in calldata and copied to memory during ABI decoding (using the
opcode calldataload and mstore). And during the for loop, arr[i]
accesses the value in memory using a mload. However, for the above
example this is inefficient. Consider the following snippet instead:
contract C {
function add(uint[] calldata arr) external returns (uint sum) {
uint length = arr.length;
for (uint i = 0; i < arr.length; i++) {
sum += arr[i];
}
}
}
In the above snippet, instead of going via memory, the value is directly
read from calldata using calldataload. That is, there are no
intermediate memory operations that carries this value.
Gas savings: In the former example, the ABI decoding begins with
copying value from calldata to memory in a for loop. Each iteration
would cost at least 60 gas. In the latter example, this can be
completely avoided. This will also reduce the number of instructions and
therefore reduces the deploy time cost of the contract.
In short, use calldata instead of memory if the function argument
is only read.
Note that in older Solidity versions, changing some function arguments
from memory to calldata may cause "unimplemented feature error".
This can be avoided by using a newer (0.8.*) Solidity compiler.
Some parameters in examples given above are later hashed. It may be beneficial for those parameters to be in memory rather than calldata.
C4-012 : ++i is more gas efficient than i++ in loops forwarding
Impact
++i is more gas efficient than i++ in loops forwarding.
Proof of Concept
Navigate to the following contracts.
contracts/Basket.sol::43 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/Basket.sol::70 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/Basket.sol::93 => for (uint256 i = 0; i < _tokens.length; i++) {
contracts/NibblVault.sol::506 => for (uint256 i = 0; i < _assetAddresses.length; i++) {
contracts/NibblVault.sol::525 => for (uint256 i = 0; i < _assets.length; i++) {
contracts/NibblVault.sol::547 => for (uint256 i = 0; i < _assets.length; i++) {
Tools Used
Code Review
Recommended Mitigation Steps
It is recommend to use unchecked{++i} and change i declaration to uint256.
C4-013 : > 0 can be replaced with != 0 for gas optimization
Impact
!= 0 is a cheaper operation compared to > 0, when dealing with uint.
Consider to replace > 0 with != 0 for gas optimization.
C4-014 : Keccak functions in constants waste gas
Impact
The contracts assigns two constants to the result of a keccak operation, which results in gas waste since the expression is computed each time the constant is accessed.
Solidity 0.8.13 has some improvements too but not well tested.
Code Generator: Skip existence check for external contract if return data is expected. In this case, the ABI decoder will revert if the contract does not exist
[S]: Suggested optimation, save a decent amount of gas without compromising readability;
[M]: Minor optimation, the amount of gas saved is minor, change when you see fit;
[N]: Non-preferred, the amount of gas saved is at cost of readability, only apply when gas saving is a top priority.
ISSUE LIST
C4-001: Revert String Size Optimization [S]
C4-002 : Adding unchecked directive can save gas [S]
C4-003 : Check if amount > 0 before token transfer can save gas [S]
C4-004 : There is no need to assign default values to variables [S]
C4-005 : Using operator && used more gas [S]
C4-006 : Non-strict inequalities are cheaper than strict ones [M]
C4-007 : Use Custom Errors instead of Revert Strings to save Gas [S]
C4-008 : Use Shift Right/Left instead of Division/Multiplication if possible [S]
C4-009 : Cache array length in for loops can save gas [S]
C4-010 : State Variables that can be changed to immutable [S]
C4-011 : Use calldata instead of memory for function parameters [M]
C4-012 : ++i is more gas efficient than i++ in loops forwarding
C4-013 :
> 0
can be replaced with!= 0
for gas optimizationC4-014 : Keccak functions in constants waste gas [M]
C4-015 : Free gas savings for using solidity 0.8.10+ [S]
C4-001: Revert String Size Optimization
Impact
Shortening revert strings to fit in 32 bytes will decrease deploy time gas and will decrease runtime gas when the revert condition has been met.
Revert strings that are longer than 32 bytes require at least one additional mstore, along with additional overhead for computing memory offset, etc.
Proof of Concept
Revert strings > 32 bytes are here:
Tools Used
Manual Review
Recommended Mitigation Steps
Shorten the revert strings to fit in 32 bytes. That will affect gas optimization.
C4-002 : Adding unchecked directive can save gas
Impact
For the arithmetic operations that will never over/underflow, using the unchecked directive (Solidity v0.8 has default overflow/underflow checks) can save some gas from the unnecessary internal over/underflow checks.
Proof of Concept
Tools Used
None
Recommended Mitigation Steps
Consider applying unchecked arithmetic where overflow/underflow is not possible. Example can be seen from below.
C4-003 : Check if amount > 0 before token transfer can save gas
Impact
Since _amount can be 0. Checking if (_amount != 0) before the transfer can potentially save an external call and the unnecessary gas cost of a 0 token transfer.
Proof of Concept
All Contracts
Tools Used
None
Recommended Mitigation Steps
Consider checking amount != 0.
C4-004 : There is no need to assign default values to variables
Impact - Gas Optimization
Boolean is default initialized to false. There is no need assign false to variable.
Proof of Concept
Tools Used
Code Review
Recommended Mitigation Steps
bool x = false costs more gas than bool x without having any different functionality.
C4-005 : Using operator && used more gas
Impact
Using double require instead of operator && can save more gas.
Proof of Concept
Tools Used
Code Review
Recommended Mitigation Steps
Example
C4-006 : Non-strict inequalities are cheaper than strict ones
Impact
Strict inequalities add a check of non equality which costs around 3 gas.
Proof of Concept
Tools Used
Code Review
Recommended Mitigation Steps
Use >= or <= instead of > and < when possible.
C4-007 : Use Custom Errors instead of Revert Strings to save Gas
Custom errors from Solidity 0.8.4 are cheaper than revert strings (cheaper deployment cost and runtime cost when the revert condition is met)
Source Custom Errors in Solidity:
Starting from Solidity v0.8.4, there is a convenient and gas-efficient way to explain to users why an operation failed through the use of custom errors. Until now, you could already use strings to give more information about failures (e.g., revert("Insufficient funds.");), but they are rather expensive, especially when it comes to deploy cost, and it is difficult to use dynamic information in them.
Custom errors are defined using the error statement, which can be used inside and outside of contracts (including interfaces and libraries).
Instances include:
All require Statements
Tools Used
Code Review
Recommended Mitigation Steps
Recommended to replace revert strings with custom errors.
C4-008 : Use Shift Right/Left instead of Division/Multiplication if possible
Impact
A division/multiplication by any number x being a power of 2 can be calculated by shifting log2(x) to the right/left.
While the DIV opcode uses 5 gas, the SHR opcode only uses 3 gas. Furthermore, Solidity's division operation also includes a division-by-0 prevention which is bypassed using shifting.
Proof of Concept
Contracts
Tools Used
None
Recommended Mitigation Steps
A division/multiplication by any number x being a power of 2 can be calculated by shifting log2(x) to the right/left.
C4-009 : Cache array length in for loops can save gas
Impact
Reading array length at each iteration of the loop takes 6 gas (3 for mload and 3 to place memory_offset) in the stack.
Caching the array length in the stack saves around 3 gas per iteration.
Proof of Concept
Tools Used
None
Recommended Mitigation Steps
Consider to cache array length.
C4-010 : State Variables that can be changed to immutable
Impact
Solidity 0.6.5 introduced immutable as a major feature. It allows setting contract-level variables at construction time which gets stored in code rather than storage.
Consider the following generic example:
In the above example, each call to the function owner() reads from storage, using a sload. After EIP-2929, this costs 2100 gas cold or 100 gas warm. However, the following snippet is more gas efficient:
In the above example, each storage read of the owner state variable is replaced by the instruction push32 value, where value is set during contract construction time. Unlike the last example, this costs only 3 gas.
Code Location
https://github.com/NibblNFT/nibbl-smartcontracts/blob/master/contracts/NibblVault.sol#L60
Tools Used
None
Recommended Mitigation Steps
Consider using immutable variable.
C4-011 : Use calldata instead of memory for function parameters
Impact
In some cases, having function arguments in calldata instead of memory is more optimal.
Consider the following generic example:
In the above example, the dynamic array arr has the storage location memory. When the function gets called externally, the array values are kept in calldata and copied to memory during ABI decoding (using the opcode calldataload and mstore). And during the for loop, arr[i] accesses the value in memory using a mload. However, for the above example this is inefficient. Consider the following snippet instead:
In the above snippet, instead of going via memory, the value is directly read from calldata using calldataload. That is, there are no intermediate memory operations that carries this value.
Gas savings: In the former example, the ABI decoding begins with copying value from calldata to memory in a for loop. Each iteration would cost at least 60 gas. In the latter example, this can be completely avoided. This will also reduce the number of instructions and therefore reduces the deploy time cost of the contract.
In short, use calldata instead of memory if the function argument is only read.
Note that in older Solidity versions, changing some function arguments from memory to calldata may cause "unimplemented feature error". This can be avoided by using a newer (0.8.*) Solidity compiler.
Proof of Concept
Tools Used
None
Recommended Mitigation Steps
Some parameters in examples given above are later hashed. It may be beneficial for those parameters to be in memory rather than calldata.
C4-012 : ++i is more gas efficient than i++ in loops forwarding
Impact
++i is more gas efficient than i++ in loops forwarding.
Proof of Concept
Tools Used
Code Review
Recommended Mitigation Steps
It is recommend to use unchecked{++i} and change i declaration to uint256.
C4-013 :
> 0
can be replaced with!= 0
for gas optimizationImpact
!= 0
is a cheaper operation compared to> 0
, when dealing with uint.Proof of Concept
Tools Used
None
Recommended Mitigation Steps
Consider to replace
> 0
with!= 0
for gas optimization.C4-014 : Keccak functions in constants waste gas
Impact
The contracts assigns two constants to the result of a keccak operation, which results in gas waste since the expression is computed each time the constant is accessed.
See this issue for more context: ethereum/solidity#9232 (https://github.com/ethereum/solidity/issues/9232)
Proof of Concept
Tools Used
None
Recommended Mitigation Steps
Replace the constant directive with immutable, or assign the already hashed value to the constants.
C4-015 : Free gas savings for using solidity 0.8.10+
Impact
Using newer compiler versions and the optimizer gives gas optimizations and additional safety checks are available for free.
Proof of Concept
Solidity 0.8.10 has a useful change which reduced gas costs of external calls which expect a return value: https://blog.soliditylang.org/2021/11/09/solidity-0.8.10-release-announcement/
Solidity 0.8.13 has some improvements too but not well tested.
Code Generator: Skip existence check for external contract if return data is expected. In this case, the ABI decoder will revert if the contract does not exist
All Contracts
Tools Used
None
Recommended Mitigation Steps
Consider to upgrade pragma to at least 0.8.10.