/* 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 . */ // SPDX-License-Identifier: GPL-3.0 #pragma once #include #include #include #include namespace solidity::frontend::smt { /** * Stores the context of the SMT encoding. */ class EncodingContext { public: EncodingContext(); /// Resets the entire context except for symbolic variables which stay /// alive because of state variables and inlined function calls. /// To be used in the beginning of a root function visit. void reset(); /// Resets the fresh id for slack variables. void resetUniqueId(); /// Returns the current fresh slack id and increments it. unsigned newUniqueId(); /// Clears the entire context, erasing everything. /// To be used before a model checking engine starts. void clear(); /// Sets the current solver used by the current engine for /// SMT variable declaration. void setSolver(smtutil::SolverInterface* _solver) { solAssert(_solver, ""); m_solver = _solver; } /// Sets whether the context should conjoin assertions in the assertion stack. void setAssertionAccumulation(bool _acc) { m_accumulateAssertions = _acc; } /// Forwards variable creation to the solver. smtutil::Expression newVariable(std::string _name, smtutil::SortPointer _sort) { solAssert(m_solver, ""); return m_solver->newVariable(std::move(_name), std::move(_sort)); } struct IdCompare { bool operator()(ASTNode const* lhs, ASTNode const* rhs) const { return lhs->id() < rhs->id(); } }; /// Variables. //@{ /// @returns the symbolic representation of a program variable. std::shared_ptr variable(frontend::VariableDeclaration const& _varDecl); /// @returns all symbolic variables. std::map, IdCompare> const& variables() const { return m_variables; } /// Creates a symbolic variable and /// @returns true if a variable's type is not supported and is therefore abstract. bool createVariable(frontend::VariableDeclaration const& _varDecl); /// @returns true if variable was created. bool knownVariable(frontend::VariableDeclaration const& _varDecl); /// Resets a specific variable. void resetVariable(frontend::VariableDeclaration const& _variable); /// Resets a set of variables. void resetVariables(std::set const& _variables); /// Resets variables according to a predicate. void resetVariables(std::function const& _filter); ///Resets all variables. void resetAllVariables(); /// Allocates a new index for the declaration, updates the current /// index to this value and returns the expression. smtutil::Expression newValue(frontend::VariableDeclaration const& _decl); /// Sets the value of the declaration to zero. void setZeroValue(frontend::VariableDeclaration const& _decl); void setZeroValue(SymbolicVariable& _variable); /// Resets the variable to an unknown value (in its range). void setUnknownValue(frontend::VariableDeclaration const& decl); void setUnknownValue(SymbolicVariable& _variable); //@} /// Expressions. ////@{ /// @returns the symbolic representation of an AST node expression. std::shared_ptr expression(frontend::Expression const& _e); /// @returns all symbolic expressions. std::map, IdCompare> const& expressions() const { return m_expressions; } /// Creates the expression (value can be arbitrary). /// @returns true if type is not supported. bool createExpression(frontend::Expression const& _e, std::shared_ptr _symbExpr = nullptr); /// Checks if expression was created. bool knownExpression(frontend::Expression const& _e) const; //@} /// Global variables and functions. //@{ /// Global variables and functions. std::shared_ptr globalSymbol(std::string const& _name); /// @returns all symbolic globals. std::map> const& globalSymbols() const { return m_globalContext; } /// Defines a new global variable or function /// and @returns true if type was abstracted. bool createGlobalSymbol(std::string const& _name, frontend::Expression const& _expr); /// Checks if special variable or function was seen. bool knownGlobalSymbol(std::string const& _var) const; //@} /// Solver. //@{ /// @returns conjunction of all added assertions. smtutil::Expression assertions(); void pushSolver(); void popSolver(); void addAssertion(smtutil::Expression const& _e); size_t solverStackHeigh() { return m_assertions.size(); } const smtutil::SolverInterface* solver() { solAssert(m_solver, ""); return m_solver; } //@} SymbolicState& state() { return m_state; } private: /// Symbolic expressions. //{@ /// Symbolic variables. std::map, IdCompare> m_variables; /// Symbolic expressions. std::map, IdCompare> m_expressions; /// Symbolic representation of global symbols including /// variables and functions. std::map> m_globalContext; /// Symbolic representation of the blockchain state. SymbolicState m_state; //@} /// Solver related. //@{ /// Solver can be SMT solver or Horn solver in the future. smtutil::SolverInterface* m_solver = nullptr; /// Assertion stack. std::vector m_assertions; /// Whether to conjoin assertions in the assertion stack. bool m_accumulateAssertions = true; //@} /// Central source of unique ids. unsigned m_nextUniqueId = 0; }; }