/* 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 /** * Common code generator for translating Yul / inline assembly to EVM and EVM1.5. */ #include #include #include #include #include #include #include #include #include using namespace std; using namespace solidity; using namespace solidity::yul; using namespace solidity::util; void VariableReferenceCounter::operator()(Identifier const& _identifier) { increaseRefIfFound(_identifier.name); } void VariableReferenceCounter::operator()(FunctionDefinition const& _function) { Scope* originalScope = m_scope; yulAssert(m_info.virtualBlocks.at(&_function), ""); m_scope = m_info.scopes.at(m_info.virtualBlocks.at(&_function).get()).get(); yulAssert(m_scope, "Variable scope does not exist."); for (auto const& v: _function.returnVariables) increaseRefIfFound(v.name); VariableReferenceCounter{m_context, m_info}(_function.body); m_scope = originalScope; } void VariableReferenceCounter::operator()(ForLoop const& _forLoop) { Scope* originalScope = m_scope; // Special scoping rules. m_scope = m_info.scopes.at(&_forLoop.pre).get(); walkVector(_forLoop.pre.statements); visit(*_forLoop.condition); (*this)(_forLoop.body); (*this)(_forLoop.post); m_scope = originalScope; } void VariableReferenceCounter::operator()(Block const& _block) { Scope* originalScope = m_scope; m_scope = m_info.scopes.at(&_block).get(); ASTWalker::operator()(_block); m_scope = originalScope; } void VariableReferenceCounter::increaseRefIfFound(YulString _variableName) { m_scope->lookup(_variableName, GenericVisitor{ [&](Scope::Variable const& _var) { ++m_context.variableReferences[&_var]; }, [](Scope::Function const&) { } }); } CodeTransform::CodeTransform( AbstractAssembly& _assembly, AsmAnalysisInfo& _analysisInfo, Block const& _block, bool _allowStackOpt, EVMDialect const& _dialect, BuiltinContext& _builtinContext, bool _evm15, ExternalIdentifierAccess _identifierAccess, bool _useNamedLabelsForFunctions, shared_ptr _context ): m_assembly(_assembly), m_info(_analysisInfo), m_dialect(_dialect), m_builtinContext(_builtinContext), m_allowStackOpt(_allowStackOpt), m_evm15(_evm15), m_useNamedLabelsForFunctions(_useNamedLabelsForFunctions), m_identifierAccess(std::move(_identifierAccess)), m_context(std::move(_context)) { if (!m_context) { // initialize m_context = make_shared(); if (m_allowStackOpt) VariableReferenceCounter{*m_context, m_info}(_block); } } void CodeTransform::decreaseReference(YulString, Scope::Variable const& _var) { if (!m_allowStackOpt) return; unsigned& ref = m_context->variableReferences.at(&_var); yulAssert(ref >= 1, ""); --ref; if (ref == 0) m_variablesScheduledForDeletion.insert(&_var); } bool CodeTransform::unreferenced(Scope::Variable const& _var) const { return !m_context->variableReferences.count(&_var) || m_context->variableReferences[&_var] == 0; } void CodeTransform::freeUnusedVariables(bool _popUnusedSlotsAtStackTop) { if (!m_allowStackOpt) return; for (auto const& identifier: m_scope->identifiers) if (holds_alternative(identifier.second)) { Scope::Variable const& var = std::get(identifier.second); if (m_variablesScheduledForDeletion.count(&var)) deleteVariable(var); } if (_popUnusedSlotsAtStackTop) while (m_unusedStackSlots.count(m_assembly.stackHeight() - 1)) { yulAssert(m_unusedStackSlots.erase(m_assembly.stackHeight() - 1), ""); m_assembly.appendInstruction(evmasm::Instruction::POP); } } void CodeTransform::deleteVariable(Scope::Variable const& _var) { yulAssert(m_allowStackOpt, ""); yulAssert(m_context->variableStackHeights.count(&_var) > 0, ""); m_unusedStackSlots.insert(static_cast(m_context->variableStackHeights[&_var])); m_context->variableStackHeights.erase(&_var); m_context->variableReferences.erase(&_var); m_variablesScheduledForDeletion.erase(&_var); } void CodeTransform::operator()(VariableDeclaration const& _varDecl) { yulAssert(m_scope, ""); size_t const numVariables = _varDecl.variables.size(); auto heightAtStart = static_cast(m_assembly.stackHeight()); if (_varDecl.value) { std::visit(*this, *_varDecl.value); expectDeposit(static_cast(numVariables), static_cast(heightAtStart)); freeUnusedVariables(false); } else { m_assembly.setSourceLocation(_varDecl.location); size_t variablesLeft = numVariables; while (variablesLeft--) m_assembly.appendConstant(u256(0)); } m_assembly.setSourceLocation(_varDecl.location); bool atTopOfStack = true; for (size_t varIndex = 0; varIndex < numVariables; ++varIndex) { size_t varIndexReverse = numVariables - 1 - varIndex; YulString varName = _varDecl.variables[varIndexReverse].name; auto& var = std::get(m_scope->identifiers.at(varName)); m_context->variableStackHeights[&var] = heightAtStart + varIndexReverse; if (!m_allowStackOpt) continue; if (unreferenced(var)) { if (atTopOfStack) { m_context->variableStackHeights.erase(&var); m_assembly.appendInstruction(evmasm::Instruction::POP); } else m_variablesScheduledForDeletion.insert(&var); } else if (m_unusedStackSlots.empty()) atTopOfStack = false; else { auto slot = static_cast(*m_unusedStackSlots.begin()); m_unusedStackSlots.erase(m_unusedStackSlots.begin()); m_context->variableStackHeights[&var] = slot; if (size_t heightDiff = variableHeightDiff(var, varName, true)) m_assembly.appendInstruction(evmasm::swapInstruction(heightDiff - 1)); m_assembly.appendInstruction(evmasm::Instruction::POP); } } } void CodeTransform::stackError(StackTooDeepError _error, int _targetStackHeight) { m_assembly.appendInstruction(evmasm::Instruction::INVALID); // Correct the stack. while (m_assembly.stackHeight() > _targetStackHeight) m_assembly.appendInstruction(evmasm::Instruction::POP); while (m_assembly.stackHeight() < _targetStackHeight) m_assembly.appendConstant(u256(0)); // Store error. m_stackErrors.emplace_back(std::move(_error)); m_assembly.markAsInvalid(); } void CodeTransform::operator()(Assignment const& _assignment) { int height = m_assembly.stackHeight(); std::visit(*this, *_assignment.value); expectDeposit(static_cast(_assignment.variableNames.size()), height); m_assembly.setSourceLocation(_assignment.location); generateMultiAssignment(_assignment.variableNames); } void CodeTransform::operator()(ExpressionStatement const& _statement) { m_assembly.setSourceLocation(_statement.location); std::visit(*this, _statement.expression); } void CodeTransform::operator()(FunctionCall const& _call) { yulAssert(m_scope, ""); if (BuiltinFunctionForEVM const* builtin = m_dialect.builtin(_call.functionName.name)) builtin->generateCode(_call, m_assembly, m_builtinContext, [&](Expression const& _expression) { visitExpression(_expression); }); else { m_assembly.setSourceLocation(_call.location); EVMAssembly::LabelID returnLabel(numeric_limits::max()); // only used for evm 1.0 if (!m_evm15) { returnLabel = m_assembly.newLabelId(); m_assembly.appendLabelReference(returnLabel); } Scope::Function* function = nullptr; yulAssert(m_scope->lookup(_call.functionName.name, GenericVisitor{ [](Scope::Variable&) { yulAssert(false, "Expected function name."); }, [&](Scope::Function& _function) { function = &_function; } }), "Function name not found."); yulAssert(function, ""); yulAssert(function->arguments.size() == _call.arguments.size(), ""); for (auto const& arg: _call.arguments | boost::adaptors::reversed) visitExpression(arg); m_assembly.setSourceLocation(_call.location); if (m_evm15) m_assembly.appendJumpsub( functionEntryID(_call.functionName.name, *function), static_cast(function->arguments.size()), static_cast(function->returns.size()) ); else { m_assembly.appendJumpTo( functionEntryID(_call.functionName.name, *function), static_cast(function->returns.size() - function->arguments.size()) - 1, AbstractAssembly::JumpType::IntoFunction ); m_assembly.appendLabel(returnLabel); } } } void CodeTransform::operator()(Identifier const& _identifier) { m_assembly.setSourceLocation(_identifier.location); // First search internals, then externals. yulAssert(m_scope, ""); if (m_scope->lookup(_identifier.name, GenericVisitor{ [&](Scope::Variable& _var) { // TODO: opportunity for optimization: Do not DUP if this is the last reference // to the top most element of the stack if (size_t heightDiff = variableHeightDiff(_var, _identifier.name, false)) m_assembly.appendInstruction(evmasm::dupInstruction(heightDiff)); else // Store something to balance the stack m_assembly.appendConstant(u256(0)); decreaseReference(_identifier.name, _var); }, [](Scope::Function&) { yulAssert(false, "Function not removed during desugaring."); } })) { return; } yulAssert( m_identifierAccess.generateCode, "Identifier not found and no external access available." ); m_identifierAccess.generateCode(_identifier, IdentifierContext::RValue, m_assembly); } void CodeTransform::operator()(Literal const& _literal) { m_assembly.setSourceLocation(_literal.location); m_assembly.appendConstant(valueOfLiteral(_literal)); } void CodeTransform::operator()(If const& _if) { visitExpression(*_if.condition); m_assembly.setSourceLocation(_if.location); m_assembly.appendInstruction(evmasm::Instruction::ISZERO); AbstractAssembly::LabelID end = m_assembly.newLabelId(); m_assembly.appendJumpToIf(end); (*this)(_if.body); m_assembly.setSourceLocation(_if.location); m_assembly.appendLabel(end); } void CodeTransform::operator()(Switch const& _switch) { //@TODO use JUMPV in EVM1.5? visitExpression(*_switch.expression); int expressionHeight = m_assembly.stackHeight(); map caseBodies; AbstractAssembly::LabelID end = m_assembly.newLabelId(); for (Case const& c: _switch.cases) { if (c.value) { (*this)(*c.value); m_assembly.setSourceLocation(c.location); AbstractAssembly::LabelID bodyLabel = m_assembly.newLabelId(); caseBodies[&c] = bodyLabel; yulAssert(m_assembly.stackHeight() == expressionHeight + 1, ""); m_assembly.appendInstruction(evmasm::dupInstruction(2)); m_assembly.appendInstruction(evmasm::Instruction::EQ); m_assembly.appendJumpToIf(bodyLabel); } else // default case (*this)(c.body); } m_assembly.setSourceLocation(_switch.location); m_assembly.appendJumpTo(end); size_t numCases = caseBodies.size(); for (auto const& c: caseBodies) { m_assembly.setSourceLocation(c.first->location); m_assembly.appendLabel(c.second); (*this)(c.first->body); // Avoid useless "jump to next" for the last case. if (--numCases > 0) { m_assembly.setSourceLocation(c.first->location); m_assembly.appendJumpTo(end); } } m_assembly.setSourceLocation(_switch.location); m_assembly.appendLabel(end); m_assembly.appendInstruction(evmasm::Instruction::POP); } void CodeTransform::operator()(FunctionDefinition const& _function) { yulAssert(m_scope, ""); yulAssert(m_scope->identifiers.count(_function.name), ""); Scope::Function& function = std::get(m_scope->identifiers.at(_function.name)); size_t height = m_evm15 ? 0 : 1; yulAssert(m_info.scopes.at(&_function.body), ""); Scope* varScope = m_info.scopes.at(m_info.virtualBlocks.at(&_function).get()).get(); yulAssert(varScope, ""); for (auto const& v: _function.parameters | boost::adaptors::reversed) { auto& var = std::get(varScope->identifiers.at(v.name)); m_context->variableStackHeights[&var] = height++; } m_assembly.setSourceLocation(_function.location); int const stackHeightBefore = m_assembly.stackHeight(); if (m_evm15) m_assembly.appendBeginsub(functionEntryID(_function.name, function), static_cast(_function.parameters.size())); else m_assembly.appendLabel(functionEntryID(_function.name, function)); m_assembly.setStackHeight(static_cast(height)); for (auto const& v: _function.returnVariables) { auto& var = std::get(varScope->identifiers.at(v.name)); m_context->variableStackHeights[&var] = height++; // Preset stack slots for return variables to zero. m_assembly.appendConstant(u256(0)); } m_context->functionExitPoints.push( CodeTransformContext::JumpInfo{m_assembly.newLabelId(), m_assembly.stackHeight()} ); CodeTransform subTransform( m_assembly, m_info, _function.body, m_allowStackOpt, m_dialect, m_builtinContext, m_evm15, m_identifierAccess, m_useNamedLabelsForFunctions, m_context ); subTransform(_function.body); if (!subTransform.m_stackErrors.empty()) { m_assembly.markAsInvalid(); for (StackTooDeepError& stackError: subTransform.m_stackErrors) { if (stackError.functionName.empty()) stackError.functionName = _function.name; m_stackErrors.emplace_back(std::move(stackError)); } } m_assembly.appendLabel(m_context->functionExitPoints.top().label); m_context->functionExitPoints.pop(); { // The stack layout here is: // ? // But we would like it to be: // ? // So we have to append some SWAP and POP instructions. // This vector holds the desired target positions of all stack slots and is // modified parallel to the actual stack. vector stackLayout; if (!m_evm15) stackLayout.push_back(static_cast(_function.returnVariables.size())); // Move return label to the top stackLayout += vector(_function.parameters.size(), -1); // discard all arguments for (size_t i = 0; i < _function.returnVariables.size(); ++i) stackLayout.push_back(static_cast(i)); // Move return values down, but keep order. if (stackLayout.size() > 17) { StackTooDeepError error(_function.name, YulString{}, static_cast(stackLayout.size()) - 17); error << errinfo_comment( "The function " + _function.name.str() + " has " + to_string(stackLayout.size() - 17) + " parameters or return variables too many to fit the stack size." ); stackError(std::move(error), m_assembly.stackHeight() - static_cast(_function.parameters.size())); } else { while (!stackLayout.empty() && stackLayout.back() != static_cast(stackLayout.size() - 1)) if (stackLayout.back() < 0) { m_assembly.appendInstruction(evmasm::Instruction::POP); stackLayout.pop_back(); } else { m_assembly.appendInstruction(evmasm::swapInstruction(static_cast(stackLayout.size()) - static_cast(stackLayout.back()) - 1u)); swap(stackLayout[static_cast(stackLayout.back())], stackLayout.back()); } for (size_t i = 0; i < stackLayout.size(); ++i) yulAssert(i == static_cast(stackLayout[i]), "Error reshuffling stack."); } } if (m_evm15) m_assembly.appendReturnsub(static_cast(_function.returnVariables.size()), stackHeightBefore); else m_assembly.appendJump( stackHeightBefore - static_cast(_function.returnVariables.size()), AbstractAssembly::JumpType::OutOfFunction ); m_assembly.setStackHeight(stackHeightBefore); } void CodeTransform::operator()(ForLoop const& _forLoop) { Scope* originalScope = m_scope; // We start with visiting the block, but not finalizing it. m_scope = m_info.scopes.at(&_forLoop.pre).get(); int stackStartHeight = m_assembly.stackHeight(); visitStatements(_forLoop.pre.statements); AbstractAssembly::LabelID loopStart = m_assembly.newLabelId(); AbstractAssembly::LabelID postPart = m_assembly.newLabelId(); AbstractAssembly::LabelID loopEnd = m_assembly.newLabelId(); m_assembly.setSourceLocation(_forLoop.location); m_assembly.appendLabel(loopStart); visitExpression(*_forLoop.condition); m_assembly.setSourceLocation(_forLoop.location); m_assembly.appendInstruction(evmasm::Instruction::ISZERO); m_assembly.appendJumpToIf(loopEnd); int const stackHeightBody = m_assembly.stackHeight(); m_context->forLoopStack.emplace(Context::ForLoopLabels{ {postPart, stackHeightBody}, {loopEnd, stackHeightBody} }); (*this)(_forLoop.body); m_assembly.setSourceLocation(_forLoop.location); m_assembly.appendLabel(postPart); (*this)(_forLoop.post); m_assembly.setSourceLocation(_forLoop.location); m_assembly.appendJumpTo(loopStart); m_assembly.appendLabel(loopEnd); finalizeBlock(_forLoop.pre, stackStartHeight); m_context->forLoopStack.pop(); m_scope = originalScope; } int CodeTransform::appendPopUntil(int _targetDepth) { int const stackDiffAfter = m_assembly.stackHeight() - _targetDepth; for (int i = 0; i < stackDiffAfter; ++i) m_assembly.appendInstruction(evmasm::Instruction::POP); return stackDiffAfter; } void CodeTransform::operator()(Break const& _break) { yulAssert(!m_context->forLoopStack.empty(), "Invalid break-statement. Requires surrounding for-loop in code generation."); m_assembly.setSourceLocation(_break.location); Context::JumpInfo const& jump = m_context->forLoopStack.top().done; m_assembly.appendJumpTo(jump.label, appendPopUntil(jump.targetStackHeight)); } void CodeTransform::operator()(Continue const& _continue) { yulAssert(!m_context->forLoopStack.empty(), "Invalid continue-statement. Requires surrounding for-loop in code generation."); m_assembly.setSourceLocation(_continue.location); Context::JumpInfo const& jump = m_context->forLoopStack.top().post; m_assembly.appendJumpTo(jump.label, appendPopUntil(jump.targetStackHeight)); } void CodeTransform::operator()(Leave const& _leaveStatement) { yulAssert(!m_context->functionExitPoints.empty(), "Invalid leave-statement. Requires surrounding function in code generation."); m_assembly.setSourceLocation(_leaveStatement.location); Context::JumpInfo const& jump = m_context->functionExitPoints.top(); m_assembly.appendJumpTo(jump.label, appendPopUntil(jump.targetStackHeight)); } void CodeTransform::operator()(Block const& _block) { Scope* originalScope = m_scope; m_scope = m_info.scopes.at(&_block).get(); int blockStartStackHeight = m_assembly.stackHeight(); visitStatements(_block.statements); finalizeBlock(_block, blockStartStackHeight); m_scope = originalScope; } AbstractAssembly::LabelID CodeTransform::functionEntryID(YulString _name, Scope::Function const& _function) { if (!m_context->functionEntryIDs.count(&_function)) { AbstractAssembly::LabelID id = m_useNamedLabelsForFunctions ? m_assembly.namedLabel(_name.str()) : m_assembly.newLabelId(); m_context->functionEntryIDs[&_function] = id; } return m_context->functionEntryIDs[&_function]; } void CodeTransform::visitExpression(Expression const& _expression) { int height = m_assembly.stackHeight(); std::visit(*this, _expression); expectDeposit(1, height); } void CodeTransform::visitStatements(vector const& _statements) { std::optional jumpTarget = std::nullopt; for (auto const& statement: _statements) { freeUnusedVariables(); auto const* functionDefinition = std::get_if(&statement); if (functionDefinition && !jumpTarget) { m_assembly.setSourceLocation(locationOf(statement)); jumpTarget = m_assembly.newLabelId(); m_assembly.appendJumpTo(*jumpTarget, 0); } else if (!functionDefinition && jumpTarget) { m_assembly.appendLabel(*jumpTarget); jumpTarget = std::nullopt; } std::visit(*this, statement); } // we may have a leftover jumpTarget if (jumpTarget) m_assembly.appendLabel(*jumpTarget); freeUnusedVariables(); } void CodeTransform::finalizeBlock(Block const& _block, int blockStartStackHeight) { m_assembly.setSourceLocation(_block.location); freeUnusedVariables(); // pop variables yulAssert(m_info.scopes.at(&_block).get() == m_scope, ""); for (auto const& id: m_scope->identifiers) if (holds_alternative(id.second)) { Scope::Variable const& var = std::get(id.second); if (m_allowStackOpt) { yulAssert(!m_context->variableStackHeights.count(&var), ""); yulAssert(!m_context->variableReferences.count(&var), ""); } else m_assembly.appendInstruction(evmasm::Instruction::POP); } int deposit = m_assembly.stackHeight() - blockStartStackHeight; yulAssert(deposit == 0, "Invalid stack height at end of block: " + to_string(deposit)); } void CodeTransform::generateMultiAssignment(vector const& _variableNames) { yulAssert(m_scope, ""); for (auto const& variableName: _variableNames | boost::adaptors::reversed) generateAssignment(variableName); } void CodeTransform::generateAssignment(Identifier const& _variableName) { yulAssert(m_scope, ""); if (auto var = m_scope->lookup(_variableName.name)) { Scope::Variable const& _var = std::get(*var); if (size_t heightDiff = variableHeightDiff(_var, _variableName.name, true)) m_assembly.appendInstruction(evmasm::swapInstruction(heightDiff - 1)); m_assembly.appendInstruction(evmasm::Instruction::POP); decreaseReference(_variableName.name, _var); } else { yulAssert( m_identifierAccess.generateCode, "Identifier not found and no external access available." ); m_identifierAccess.generateCode(_variableName, IdentifierContext::LValue, m_assembly); } } size_t CodeTransform::variableHeightDiff(Scope::Variable const& _var, YulString _varName, bool _forSwap) { yulAssert(m_context->variableStackHeights.count(&_var), ""); size_t heightDiff = static_cast(m_assembly.stackHeight()) - m_context->variableStackHeights[&_var]; yulAssert(heightDiff > (_forSwap ? 1 : 0), "Negative stack difference for variable."); size_t limit = _forSwap ? 17 : 16; if (heightDiff > limit) { m_stackErrors.emplace_back(_varName, heightDiff - limit); m_stackErrors.back() << errinfo_comment( "Variable " + _varName.str() + " is " + to_string(heightDiff - limit) + " slot(s) too deep inside the stack." ); m_assembly.markAsInvalid(); return _forSwap ? 2 : 1; } return heightDiff; } void CodeTransform::expectDeposit(int _deposit, int _oldHeight) const { yulAssert(m_assembly.stackHeight() == _oldHeight + _deposit, "Invalid stack deposit."); }