mirror of
				https://github.com/ethereum/solidity
				synced 2023-10-03 13:03:40 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			302 lines
		
	
	
		
			8.0 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			302 lines
		
	
	
		
			8.0 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| /*
 | |
| 	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
 | |
| 
 | |
| #pragma once
 | |
| 
 | |
| #include <libsolidity/formal/SSAVariable.h>
 | |
| #include <libsolidity/ast/Types.h>
 | |
| #include <libsolidity/ast/TypeProvider.h>
 | |
| 
 | |
| #include <libsmtutil/SolverInterface.h>
 | |
| 
 | |
| #include <map>
 | |
| #include <memory>
 | |
| 
 | |
| namespace solidity::frontend::smt
 | |
| {
 | |
| 
 | |
| class EncodingContext;
 | |
| class Type;
 | |
| 
 | |
| /**
 | |
|  * This abstract class represents the symbolic version of a program variable.
 | |
|  */
 | |
| class SymbolicVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicVariable(
 | |
| 		frontend::TypePointer _type,
 | |
| 		frontend::TypePointer _originalType,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 	SymbolicVariable(
 | |
| 		smtutil::SortPointer _sort,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 
 | |
| 	SymbolicVariable(SymbolicVariable&&) = default;
 | |
| 
 | |
| 	virtual ~SymbolicVariable() = default;
 | |
| 
 | |
| 	virtual smtutil::Expression currentValue(frontend::TypePointer const& _targetType = TypePointer{}) const;
 | |
| 	std::string currentName() const;
 | |
| 	virtual smtutil::Expression valueAtIndex(unsigned _index) const;
 | |
| 	virtual std::string nameAtIndex(unsigned _index) const;
 | |
| 	virtual smtutil::Expression resetIndex();
 | |
| 	virtual smtutil::Expression setIndex(unsigned _index);
 | |
| 	virtual smtutil::Expression increaseIndex();
 | |
| 	virtual smtutil::Expression operator()(std::vector<smtutil::Expression> /*_arguments*/) const
 | |
| 	{
 | |
| 		solAssert(false, "Function application to non-function.");
 | |
| 	}
 | |
| 
 | |
| 	unsigned index() const { return m_ssa->index(); }
 | |
| 	unsigned& index() { return m_ssa->index(); }
 | |
| 
 | |
| 	smtutil::SortPointer const& sort() const { return m_sort; }
 | |
| 	frontend::TypePointer const& type() const { return m_type; }
 | |
| 	frontend::TypePointer const& originalType() const { return m_originalType; }
 | |
| 
 | |
| protected:
 | |
| 	std::string uniqueSymbol(unsigned _index) const;
 | |
| 
 | |
| 	/// SMT sort.
 | |
| 	smtutil::SortPointer m_sort;
 | |
| 	/// Solidity type, used for size and range in number types.
 | |
| 	frontend::TypePointer m_type;
 | |
| 	/// Solidity original type, used for type conversion if necessary.
 | |
| 	frontend::TypePointer m_originalType;
 | |
| 	std::string m_uniqueName;
 | |
| 	EncodingContext& m_context;
 | |
| 	std::unique_ptr<SSAVariable> m_ssa;
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for Bool
 | |
|  */
 | |
| class SymbolicBoolVariable: public SymbolicVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicBoolVariable(
 | |
| 		frontend::TypePointer _type,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for Integers
 | |
|  */
 | |
| class SymbolicIntVariable: public SymbolicVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicIntVariable(
 | |
| 		frontend::TypePointer _type,
 | |
| 		frontend::TypePointer _originalType,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for Address
 | |
|  */
 | |
| class SymbolicAddressVariable: public SymbolicIntVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicAddressVariable(
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for FixedBytes
 | |
|  */
 | |
| class SymbolicFixedBytesVariable: public SymbolicIntVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicFixedBytesVariable(
 | |
| 		frontend::TypePointer _originalType,
 | |
| 		unsigned _numBytes,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for FunctionType.
 | |
|  * Besides containing a symbolic function declaration,
 | |
|  * it also has an integer used as abstraction.
 | |
|  * By default, the abstract representation is used when
 | |
|  * values are requested, and the function declaration is
 | |
|  * used when operator() is applied over arguments.
 | |
|  */
 | |
| class SymbolicFunctionVariable: public SymbolicVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicFunctionVariable(
 | |
| 		frontend::TypePointer _type,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 	SymbolicFunctionVariable(
 | |
| 		smtutil::SortPointer _sort,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 
 | |
| 	smtutil::Expression currentValue(frontend::TypePointer const& _targetType = TypePointer{}) const override;
 | |
| 
 | |
| 	// Explicit request the function declaration.
 | |
| 	smtutil::Expression currentFunctionValue() const;
 | |
| 
 | |
| 	smtutil::Expression valueAtIndex(unsigned _index) const override;
 | |
| 
 | |
| 	// Explicit request the function declaration.
 | |
| 	smtutil::Expression functionValueAtIndex(unsigned _index) const;
 | |
| 
 | |
| 	smtutil::Expression resetIndex() override;
 | |
| 	smtutil::Expression setIndex(unsigned _index) override;
 | |
| 	smtutil::Expression increaseIndex() override;
 | |
| 
 | |
| 	smtutil::Expression operator()(std::vector<smtutil::Expression> _arguments) const override;
 | |
| 
 | |
| private:
 | |
| 	/// Creates a new function declaration.
 | |
| 	void resetDeclaration();
 | |
| 
 | |
| 	/// Stores the current function declaration.
 | |
| 	smtutil::Expression m_declaration;
 | |
| 
 | |
| 	/// Abstract representation.
 | |
| 	SymbolicIntVariable m_abstract{
 | |
| 		TypeProvider::uint256(),
 | |
| 		TypeProvider::uint256(),
 | |
| 		m_uniqueName + "_abstract",
 | |
| 		m_context
 | |
| 	};
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for Enum
 | |
|  */
 | |
| class SymbolicEnumVariable: public SymbolicVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicEnumVariable(
 | |
| 		frontend::TypePointer _type,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for Tuple
 | |
|  */
 | |
| class SymbolicTupleVariable: public SymbolicVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicTupleVariable(
 | |
| 		frontend::TypePointer _type,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 	SymbolicTupleVariable(
 | |
| 		smtutil::SortPointer _sort,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 
 | |
| 	smtutil::Expression currentValue(frontend::TypePointer const& _targetType = TypePointer{}) const override;
 | |
| 
 | |
| 	std::vector<smtutil::SortPointer> const& components() const;
 | |
| 	smtutil::Expression component(
 | |
| 		size_t _index,
 | |
| 		TypePointer _fromType = nullptr,
 | |
| 		TypePointer _toType = nullptr
 | |
| 	) const;
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for Array
 | |
|  */
 | |
| class SymbolicArrayVariable: public SymbolicVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicArrayVariable(
 | |
| 		frontend::TypePointer _type,
 | |
| 		frontend::TypePointer _originalTtype,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 	SymbolicArrayVariable(
 | |
| 		smtutil::SortPointer _sort,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 
 | |
| 	SymbolicArrayVariable(SymbolicArrayVariable&&) = default;
 | |
| 
 | |
| 	smtutil::Expression currentValue(frontend::TypePointer const& _targetType = TypePointer{}) const override;
 | |
| 	smtutil::Expression valueAtIndex(unsigned _index) const override;
 | |
| 	smtutil::Expression resetIndex() override { SymbolicVariable::resetIndex(); return m_pair.resetIndex(); }
 | |
| 	smtutil::Expression setIndex(unsigned _index) override { SymbolicVariable::setIndex(_index); return m_pair.setIndex(_index); }
 | |
| 	smtutil::Expression increaseIndex() override { SymbolicVariable::increaseIndex(); return m_pair.increaseIndex(); }
 | |
| 	smtutil::Expression elements() const;
 | |
| 	smtutil::Expression length() const;
 | |
| 
 | |
| 	smtutil::SortPointer tupleSort() { return m_pair.sort(); }
 | |
| 
 | |
| private:
 | |
| 	SymbolicTupleVariable m_pair;
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * Specialization of SymbolicVariable for Struct.
 | |
|  */
 | |
| class SymbolicStructVariable: public SymbolicVariable
 | |
| {
 | |
| public:
 | |
| 	SymbolicStructVariable(
 | |
| 		frontend::TypePointer _type,
 | |
| 		std::string _uniqueName,
 | |
| 		EncodingContext& _context
 | |
| 	);
 | |
| 
 | |
| 	/// @returns the symbolic expression representing _member.
 | |
| 	smtutil::Expression member(std::string const& _member) const;
 | |
| 
 | |
| 	/// @returns the symbolic expression representing this struct
 | |
| 	/// with field _member updated.
 | |
| 	smtutil::Expression assignMember(std::string const& _member, smtutil::Expression const& _memberValue);
 | |
| 
 | |
| 	/// @returns the symbolic expression representing this struct
 | |
| 	/// with all fields updated with the given values.
 | |
| 	smtutil::Expression assignAllMembers(std::vector<smtutil::Expression> const& _memberValues);
 | |
| 
 | |
| private:
 | |
| 	std::map<std::string, unsigned> m_memberIndices;
 | |
| };
 | |
| 
 | |
| 
 | |
| 
 | |
| }
 |