solidity/libyul/AsmAnalysis.h

134 lines
4.6 KiB
C
Raw Normal View History

2017-02-15 13:52:53 +00:00
/*
This file is part of solidity.
solidity is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
solidity is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with solidity. If not, see <http://www.gnu.org/licenses/>.
*/
// SPDX-License-Identifier: GPL-3.0
2017-02-15 13:52:53 +00:00
/**
* Analysis part of inline assembly.
*/
#pragma once
#include <liblangutil/Exceptions.h>
#include <liblangutil/EVMVersion.h>
#include <libyul/ASTForward.h>
2020-11-25 18:10:31 +00:00
#include <libyul/Dialect.h>
#include <libyul/Scope.h>
2018-10-15 09:52:35 +00:00
#include <libyul/backends/evm/AbstractAssembly.h>
2019-02-21 20:56:30 +00:00
#include <libyul/backends/evm/EVMDialect.h>
2017-02-15 13:52:53 +00:00
#include <functional>
#include <list>
2017-02-15 13:52:53 +00:00
#include <memory>
#include <optional>
2020-04-01 03:04:29 +00:00
#include <utility>
2017-02-15 13:52:53 +00:00
2019-12-11 16:31:36 +00:00
namespace solidity::langutil
{
class ErrorReporter;
struct SourceLocation;
}
2019-12-11 16:31:36 +00:00
namespace solidity::yul
2017-02-15 13:52:53 +00:00
{
struct AsmAnalysisInfo;
2017-04-26 10:34:24 +00:00
/**
* Performs the full analysis stage, calls the ScopeFiller internally, then resolves
* references and performs other checks.
* If all these checks pass, code generation should not throw errors.
*/
class AsmAnalyzer
2017-02-15 13:52:53 +00:00
{
public:
2017-05-24 23:19:11 +00:00
explicit AsmAnalyzer(
AsmAnalysisInfo& _analysisInfo,
langutil::ErrorReporter& _errorReporter,
Dialect const& _dialect,
2020-04-01 03:04:29 +00:00
ExternalIdentifierAccess::Resolver _resolver = ExternalIdentifierAccess::Resolver(),
std::set<YulString> _dataNames = {}
):
2020-04-01 03:04:29 +00:00
m_resolver(std::move(_resolver)),
m_info(_analysisInfo),
m_errorReporter(_errorReporter),
m_dialect(_dialect),
2020-04-01 03:04:29 +00:00
m_dataNames(std::move(_dataNames))
2019-02-21 20:56:30 +00:00
{
if (EVMDialect const* evmDialect = dynamic_cast<EVMDialect const*>(&m_dialect))
2019-02-21 20:56:30 +00:00
m_evmVersion = evmDialect->evmVersion();
}
bool analyze(Block const& _block);
/// Performs analysis on the outermost code of the given object and returns the analysis info.
/// Asserts on failure.
static AsmAnalysisInfo analyzeStrictAssertCorrect(Dialect const& _dialect, Object const& _object);
2019-01-29 14:01:30 +00:00
std::vector<YulString> operator()(Literal const& _literal);
std::vector<YulString> operator()(Identifier const&);
void operator()(ExpressionStatement const&);
void operator()(Assignment const& _assignment);
void operator()(VariableDeclaration const& _variableDeclaration);
void operator()(FunctionDefinition const& _functionDefinition);
std::vector<YulString> operator()(FunctionCall const& _functionCall);
void operator()(If const& _if);
void operator()(Switch const& _switch);
void operator()(ForLoop const& _forLoop);
void operator()(Break const&) { }
void operator()(Continue const&) { }
void operator()(Leave const&) { }
void operator()(Block const& _block);
2017-02-15 13:52:53 +00:00
private:
/// Visits the expression, expects that it evaluates to exactly one value and
/// returns the type. Reports errors on errors and returns the default type.
YulString expectExpression(Expression const& _expr);
YulString expectUnlimitedStringLiteral(Literal const& _literal);
2020-01-16 17:56:05 +00:00
/// Vists the expression and expects it to return a single boolean value.
/// Reports an error otherwise.
void expectBoolExpression(Expression const& _expr);
2020-01-16 17:56:05 +00:00
/// Verifies that a variable to be assigned to exists, can be assigned to
/// and has the same type as the value.
void checkAssignment(Identifier const& _variable, YulString _valueType);
Scope& scope(Block const* _block);
2020-07-02 17:23:36 +00:00
void expectValidIdentifier(YulString _identifier, langutil::SourceLocation const& _location);
2019-12-19 16:58:20 +00:00
void expectValidType(YulString _type, langutil::SourceLocation const& _location);
2020-01-16 17:56:05 +00:00
void expectType(YulString _expectedType, YulString _givenType, langutil::SourceLocation const& _location);
2017-02-17 11:03:55 +00:00
bool validateInstructions(evmasm::Instruction _instr, langutil::SourceLocation const& _location);
bool validateInstructions(std::string const& _instrIdentifier, langutil::SourceLocation const& _location);
bool validateInstructions(FunctionCall const& _functionCall);
yul::ExternalIdentifierAccess::Resolver m_resolver;
2017-02-15 13:52:53 +00:00
Scope* m_currentScope = nullptr;
/// Variables that are active at the current point in assembly (as opposed to
/// "part of the scope but not yet declared")
std::set<Scope::Variable const*> m_activeVariables;
AsmAnalysisInfo& m_info;
langutil::ErrorReporter& m_errorReporter;
langutil::EVMVersion m_evmVersion;
Dialect const& m_dialect;
/// Names of data objects to be referenced by builtin functions with literal arguments.
std::set<YulString> m_dataNames;
ForLoop const* m_currentForLoop = nullptr;
2017-02-15 13:52:53 +00:00
};
}