solang-parser 0.2.1

Solang Solidity Parser
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

/*
	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/>.
*/
#pragma once

#include <libyul/AST.h>
#include <libyul/Dialect.h>
#include <libyul/Exceptions.h>

// because of instruction
#include <libyul/backends/evm/EVMDialect.h>

#include <libsmtutil/SolverInterface.h>

#include <memory>

namespace solidity::smtutil
{

class SolverInterface;
class Expression;
struct Sort;

}

namespace solidity::yul
{

/**
 * Base class for SMT based optimization steps.
 *
 * Works best when used with AST in SSA form.
 */
class SMTSolver
{
protected:
	SMTSolver(
		std::set<YulString> const& _ssaVariables,
		Dialect const& _dialect
	);

	/// Helper function that encodes VariableDeclaration
	void encodeVariableDeclaration(VariableDeclaration const& _varDecl);

	/// The encoding for a builtin. The type of encoding determines what we are
	/// solving for.
	virtual smtutil::Expression encodeEVMBuiltin(
		evmasm::Instruction _instruction,
		std::vector<Expression> const& _arguments
	) = 0;

	smtutil::Expression encodeExpression(Expression const& _expression);

	static smtutil::Expression int2bv(smtutil::Expression _arg);
	static smtutil::Expression bv2int(smtutil::Expression _arg);

	smtutil::Expression newVariable();
	virtual smtutil::Expression newRestrictedVariable(bigint _maxValue = (bigint(1) << 256) - 1);
	std::string uniqueName();

	virtual std::shared_ptr<smtutil::Sort> defaultSort() const;
	static smtutil::Expression booleanValue(smtutil::Expression _value);
	static smtutil::Expression constantValue(bigint _value);
	static smtutil::Expression literalValue(Literal const& _literal);
	static smtutil::Expression twosComplementToSigned(smtutil::Expression _value);
	static smtutil::Expression signedToTwosComplement(smtutil::Expression _value);
	smtutil::Expression wrap(smtutil::Expression _value);

	std::set<YulString> const& m_ssaVariables;
	std::unique_ptr<smtutil::SolverInterface> m_solver;
	std::map<YulString, smtutil::Expression> m_variables;

	Dialect const& m_dialect;

private:
	size_t m_varCounter = 0;
};

}