Download audit report
This document presents the results of a security review conducted by Nethermind Security for Spiko MultiATM contract.
Spiko is a protocol for tokenizing securities on public blockchains, specifically focused on money market funds. The protocol enables the first fully-licensed money market funds in the EU to be issued on-chain.
MultiATM is a decentralized token swap contract designed as an Automated Token Machine (ATM) that facilitates atomic token exchanges using oracle-based pricing. As such, the contract enables multi-hop swap capabilities and supports meta-transactions.
The audit comprises 203 lines of Solidity code. The audit was performed using (a) manual analysis of the codebase, and (b) automated analysis tools.
Findings by severity
| # | Contract | LoC | Comments | Ratio | Blank | Total |
| 1 | token/MultiATM.sol | 203 | 36 | 17.7% | 37 | 276 |
| Total | 203 | 36 | 17.7% | 37 | 276 |
| # | Finding | Severity | Update |
| 1 | Lack of Slippage Protection can lead to Unfavorable Exchange Rates | Info | Fixed |
| 2 | The contract defaults to 18 decimals if the token does not implement the decimals(...) function. | Info | Fixed |
MultiATM is a decentralized token swap contract designed as an Automated Token Machine (ATM) that facilitates atomic token exchanges using oracle-based pricing. The contract implements an intricate pricing mechanism with Chainlink-style oracles, multi-hop swap capabilities, and meta-transaction support.
The MultiATM smart contract extends ERC2771 to support meta transactions. Additionally, the contract extends Multicall to allow batching of multiple function calls in a single transaction. The contract implements role-based access control.
The MultiATM contract registers token pairs and uses a commutative hash of both token addresses for identification, this enables bidirectional token swap using the same token configuration.
struct Pair {
IERC20 token1;
IERC20 token2;
Oracle oracle;
uint256 oracleTTL;
uint256 numerator;
uint256 denominator;
}The contract uses Chainlink-compatible oracles for price discovery and implements the following functionalities.
_getPrices() function to read the price information for conversion of input tokens to output tokensThe MultiATM contract supports the following swap types
Fees configuration and calculation within MultiATM contract is implemented as:
The risk rating methodology used by Nethermind Security follows the principles established by the OWASP Foundation. The severity of each finding is determined by two factors: Likelihood and Impact.
Likelihood measures how likely the finding is to be uncovered and exploited by an attacker. This factor will be one of the following values:
When defining the likelihood of a finding, other factors are also considered. These can include but are not limited to motive, opportunity, exploit accessibility, ease of discovery, and ease of exploit.
Impact is a measure of the damage that may be caused if an attacker exploits the finding. This factor will be one of the following values:
When defining the impact of a finding, other factors are also considered. These can include but are not limited to data and state integrity, loss of availability, financial loss, and reputation damage. After defining the likelihood and impact of an issue, the severity is determined according to the table below.
| Impact / Likelihood | Low | Medium | High |
| High | Medium | High | Critical |
| Medium | Low | Medium | High |
| Low | Info / Best Practices | Low | Medium |
| Undetermined | Undetermined | Undetermined | Undetermined |
To address issues that do not fit a High, Medium or Low severity, Nethermind Security also uses three more finding severities: Informational, Best Practices, and Undetermined.
| File | Fix commit | Type | Status |
MultiATM.sol | f283264 | Info | Fixed |
The MultiATM contract facilitates token swaps using functions like swapExactInput(...) and swapExactOutput(...). These functions determine the final exchanged amount by first calling a view function (e.g., previewExactInput(...)), which internally consults the on-chain Oracle to get the current price.
The contract does not include any mechanism, such as a user-specified minimum output amount or maximum input amount, to protect the user from price fluctuations (slippage) between when the transaction is signed and when it is executed and mined on the blockchain.
The flow for a swap, such as swapExactInputSingle(...), is as follows:
swapExactInputSingle(input, output, inputAmount, recipient).previewExactInputSingle(...) which uses the oracle price at that moment to calculate outputAmount._swapExact(...) using this calculated outputAmount.If the oracle price changes (naturally, due to new data published on the Chainlink feed) between the calculation and the execution of the transaction, the user's effective exchange rate will differ from the rate they initially calculated and expected. Since the contract executes the swap with the calculated amount, the user is forced to accept a potentially much worse rate.
For example, in swapExactInputSingle(...):
function swapExactInputSingle(IERC20 input, IERC20 output, uint256 inputAmount, address recipient)
public
virtual
restricted
returns (
uint256 /*outputAmount*/
)
{
uint256 outputAmount = previewExactInputSingle(input, output, inputAmount);
// @audit-issue outputAmount is calculated and executed without a user-defined slippage limit.
_swapExact(input, output, inputAmount, outputAmount, _msgSender(), recipient);
return outputAmount;
}If the price of output token drops (meaning the oracle rate decreases) between the two steps, the user will receive a lower amount of output token than expected, leading to an unfavorable exchange.
Recommendation
Consider introducing a slippage tolerance parameter to all swap functions. This is a standard security practice in DeFi protocols to protect users from unexpected price changes.
swapExactInput(...) and swapExactInputSingle(...)): Add a minOutputAmount parameter. The function should revert if the final received amount is less than this user-defined minimum.swapExactOutput(...) and swapExactOutputSingle(...)): Add a maxInputAmount parameter. The function should revert if the final required input amount exceeds this user-defined maximum.Resolution
Fixed 0231aee978de
decimals(...) function.| File | Fix commit | Type | Status |
MultiATM.sol | f283264 | Info | Fixed |
The tryFetchDecimals(...) function defaults to 18 decimals if the token contract does not implement the decimal(...) function as seen below:
function tryFetchDecimals(IERC20 token) view returns (uint8) {
try IERC20Metadata(address(token)).decimals() returns (uint8 result) {
return result;
} catch {
return 18;
}
}This function is used when setting token pairs via the setPair (...) function, which uses the returned token decimals to set the numerator and denominator variables, which are used in pricing of tokens during swaps.
As a result, if the default 18 decimals are not accurate as related to the token, this can lead to mispricing of token pairs.
Recommendation
Consider reverting if the token does not implement the decimals (...) function.
Resolution
Fixed 0231aee978de
Software documentation refers to the written or visual information that describes the functionality, architecture, design, and implementation of software. It provides a comprehensive overview of the software system and helps users, developers, and stakeholders understand how the software works, how to use it, and how to maintain it. Software documentation can take different forms, such as user manuals, system manuals, technical specifications, requirements documents, design documents, and code comments. Software documentation is critical in software development, enabling effective communication between developers, testers, users, and other stakeholders. It helps to ensure that everyone involved in the development process has a shared understanding of the software system and its functionality. Moreover, software documentation can improve software maintenance by providing a clear and complete understanding of the software system, making it easier for developers to maintain, modify, and update the software over time. Smart contracts can use various types of software documentation. Some of the most common types include:
These types of documentation are essential for smart contract development and maintenance. They help ensure that the contract is properly designed, implemented, and tested, and they provide a reference for developers who need to modify or maintain the contract in the future.
The Spiko team provided a clear and comprehensive overview of the MultiATM contract during the kick-off call. This was supported with written documentation detailing the different features present in the contracts.
All the relevant issues raised by the AuditAgent have been incorporated into this report. The AuditAgent is an AI-powered smart contract auditing tool that analyses code, detects vulnerabilities, and provides actionable fixes. It accelerates the security analysis process, complementing human expertise with advanced AI models to deliver efficient and comprehensive smart contract audits. Available at https://app.auditagent.nethermind.io.
| 276Tests passed | 0Failed |
The complete test output is in the full report.
As auditors, we recommend that any changes or updates made to the audited codebase undergo a re-audit or security review to address potential vulnerabilities or risks introduced by the modifications. By conducting a re-audit or security review of the modified codebase, you can significantly enhance the overall security of your system and reduce the likelihood of exploitation. However, we do not possess the authority or right to impose obligations or restrictions on our clients regarding codebase updates, modifications, or subsequent audits. Accordingly, the decision to seek a re-audit or security review lies solely with you.
This report is based on the scope of materials and documentation provided by you to Nethermind in order that Nethermind could conduct the security review outlined in 1. Executive Summary and 2. Audited Files. The results set out in this report may not be complete nor inclusive of all vulnerabilities. Nethermind has provided the review and this report on an as-is, where-is, and as-available basis. You agree that your access and/or use, including but not limited to any associated services, products, protocols, platforms, content, and materials, will be at your sole risk. Blockchain technology remains under development and is subject to unknown risks and flaws. The review does not extend to the compiler layer, or any other areas beyond the programming language, or other programming aspects that could present security risks. This report does not indicate the endorsement of any particular project or team, nor guarantee its security. No third party should rely on this report in any way, including for the purpose of making any decisions to buy or sell a product, service or any other asset. To the fullest extent permitted by law, Nethermind disclaims any liability in connection with this report, its content, and any related services and products and your use thereof, including, without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement. Nethermind does not warrant, endorse, guarantee, or assume responsibility for any product or service advertised or offered by a third party through the product, any open source or third-party software, code, libraries, materials, or information linked to, called by, referenced by or accessible through the report, its content, and the related services and products, any hyperlinked websites, any websites or mobile applications appearing on any advertising, and Nethermind will not be a party to or in any way be responsible for monitoring any transaction between you and any third-party providers of products or services. As with the purchase or use of a product or service through any medium or in any environment, you should use your best judgment and exercise caution where appropriate. FOR AVOIDANCE OF DOUBT, THE REPORT, ITS CONTENT, ACCESS, AND/OR USAGE THEREOF, INCLUDING ANY ASSOCIATED SERVICES OR MATERIALS, SHALL NOT BE CONSIDERED OR RELIED UPON AS ANY FORM OF FINANCIAL, INVESTMENT, TAX, LEGAL, REGULATORY, OR OTHER ADVICE.
The Leading Engineers of Blockchain Infrastructure