/* 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 /** * Interactive yul optimizer */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using namespace std; using namespace solidity; using namespace solidity::util; using namespace solidity::langutil; using namespace solidity::frontend; using namespace solidity::yul; namespace po = boost::program_options; class YulOpti { public: static void printErrors(CharStream const& _charStream, ErrorList const& _errors) { SourceReferenceFormatter{ cerr, SingletonCharStreamProvider(_charStream), true, false }.printErrorInformation(_errors); } void parse(string const& _input) { ErrorList errors; ErrorReporter errorReporter(errors); CharStream _charStream(_input, ""); try { m_ast = yul::Parser(errorReporter, m_dialect).parse(_charStream); if (!m_ast || !errorReporter.errors().empty()) { cerr << "Error parsing source." << endl; printErrors(_charStream, errors); throw std::runtime_error("Could not parse source."); } m_analysisInfo = make_unique(); AsmAnalyzer analyzer( *m_analysisInfo, errorReporter, m_dialect ); if (!analyzer.analyze(*m_ast) || !errorReporter.errors().empty()) { cerr << "Error analyzing source." << endl; printErrors(_charStream, errors); throw std::runtime_error("Could not analyze source."); } } catch(...) { cerr << "Fatal error during parsing: " << endl; printErrors(_charStream, errors); throw; } } void printUsageBanner( map const& _extraOptions, size_t _columns ) { yulAssert(_columns > 0); auto const& optimiserSteps = OptimiserSuite::stepAbbreviationToNameMap(); auto hasShorterString = [](auto const& a, auto const& b) { return a.second.size() < b.second.size(); }; size_t longestDescriptionLength = std::max( max_element(optimiserSteps.begin(), optimiserSteps.end(), hasShorterString)->second.size(), max_element(_extraOptions.begin(), _extraOptions.end(), hasShorterString)->second.size() ); vector overlappingAbbreviations = ranges::views::set_intersection(_extraOptions | ranges::views::keys, optimiserSteps | ranges::views::keys) | ranges::views::transform([](char _abbreviation){ return string(1, _abbreviation); }) | ranges::to(); yulAssert( overlappingAbbreviations.empty(), "ERROR: Conflict between yulopti controls and the following Yul optimizer step abbreviations: " + boost::join(overlappingAbbreviations, ", ") + ".\n" "This is most likely caused by someone adding a new step abbreviation to " "OptimiserSuite::stepNameToAbbreviationMap() and not realizing that it's used by yulopti.\n" "Please update the code to use a different character and recompile yulopti." ); vector> sortedOptions = ranges::views::concat(optimiserSteps, _extraOptions) | ranges::to>>() | ranges::actions::sort([](tuple const& _a, tuple const& _b) { return ( !boost::algorithm::iequals(get<1>(_a), get<1>(_b)) ? boost::algorithm::lexicographical_compare(get<1>(_a), get<1>(_b), boost::algorithm::is_iless()) : toLower(get<0>(_a)) < toLower(get<0>(_b)) ); }); yulAssert(sortedOptions.size() > 0); size_t rows = (sortedOptions.size() - 1) / _columns + 1; for (size_t row = 0; row < rows; ++row) { for (auto const& [key, name]: sortedOptions | ranges::views::drop(row) | ranges::views::stride(rows)) cout << key << ": " << setw(static_cast(longestDescriptionLength)) << setiosflags(ios::left) << name << " "; cout << endl; } } void disambiguate() { *m_ast = std::get(Disambiguator(m_dialect, *m_analysisInfo)(*m_ast)); m_analysisInfo.reset(); m_nameDispenser.reset(*m_ast); } void runSteps(string _source, string _steps) { parse(_source); disambiguate(); OptimiserSuite{m_context}.runSequence(_steps, *m_ast); cout << AsmPrinter{m_dialect}(*m_ast) << endl; } void runInteractive(string _source, bool _disambiguated = false) { bool disambiguated = _disambiguated; while (true) { parse(_source); disambiguated = disambiguated || (disambiguate(), true); map const& extraOptions = { // QUIT starts with a non-letter character on purpose to get it to show up on top of the list {'#', ">>> QUIT <<<"}, {',', "VarNameCleaner"}, {';', "StackCompressor"} }; printUsageBanner(extraOptions, 4); cout << "? "; cout.flush(); char option = static_cast(readStandardInputChar()); cout << ' ' << option << endl; try { switch (option) { case 4: case '#': return; case ',': VarNameCleaner::run(m_context, *m_ast); // VarNameCleaner destroys the unique names guarantee of the disambiguator. disambiguated = false; break; case ';': { Object obj; obj.code = m_ast; StackCompressor::run(m_dialect, obj, true, 16); break; } default: OptimiserSuite{m_context}.runSequence( std::string_view(&option, 1), *m_ast ); } _source = AsmPrinter{m_dialect}(*m_ast); } catch (...) { cerr << endl << "Exception during optimiser step:" << endl; cerr << boost::current_exception_diagnostic_information() << endl; } cout << "----------------------" << endl; cout << _source << endl; } } private: shared_ptr m_ast; Dialect const& m_dialect{EVMDialect::strictAssemblyForEVMObjects(EVMVersion{})}; unique_ptr m_analysisInfo; set const m_reservedIdentifiers = {}; NameDispenser m_nameDispenser{m_dialect, m_reservedIdentifiers}; OptimiserStepContext m_context{ m_dialect, m_nameDispenser, m_reservedIdentifiers, solidity::frontend::OptimiserSettings::standard().expectedExecutionsPerDeployment }; }; int main(int argc, char** argv) { try { bool nonInteractive = false; po::options_description options( R"(yulopti, yul optimizer exploration tool. Usage: yulopti [Options] Reads as yul code and applies optimizer steps to it, interactively read from stdin. In non-interactive mode a list of steps has to be provided. If is -, yul code is read from stdin and run non-interactively. Allowed options)", po::options_description::m_default_line_length, po::options_description::m_default_line_length - 23); options.add_options() ( "input-file", po::value(), "input file" ) ( "steps", po::value(), "steps to execute non-interactively" ) ( "non-interactive,n", po::bool_switch(&nonInteractive)->default_value(false), "stop after executing the provided steps" ) ("help,h", "Show this help screen."); // All positional options should be interpreted as input files po::positional_options_description filesPositions; filesPositions.add("input-file", 1); po::variables_map arguments; po::command_line_parser cmdLineParser(argc, argv); cmdLineParser.options(options).positional(filesPositions); po::store(cmdLineParser.run(), arguments); po::notify(arguments); if (arguments.count("help")) { cout << options; return 0; } string input; if (arguments.count("input-file")) { string filename = arguments["input-file"].as(); if (filename == "-") { nonInteractive = true; input = readUntilEnd(cin); } else input = readFileAsString(arguments["input-file"].as()); } else { cout << options; return 1; } if (nonInteractive && !arguments.count("steps")) { cout << options; return 1; } YulOpti yulOpti; bool disambiguated = false; if (!nonInteractive) cout << input << endl; if (arguments.count("steps")) { string sequence = arguments["steps"].as(); if (!nonInteractive) cout << "----------------------" << endl; yulOpti.runSteps(input, sequence); disambiguated = true; } if (!nonInteractive) yulOpti.runInteractive(input, disambiguated); return 0; } catch (po::error const& _exception) { cerr << _exception.what() << endl; return 1; } catch (FileNotFound const& _exception) { cerr << "File not found:" << _exception.comment() << endl; return 1; } catch (NotAFile const& _exception) { cerr << "Not a regular file:" << _exception.comment() << endl; return 1; } catch(...) { cerr << endl << "Exception:" << endl; cerr << boost::current_exception_diagnostic_information() << endl; return 1; } }