/* 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 . */ #include #include #include #include #include #include #include #include using namespace std; using namespace yul::test::yul_fuzzer; using namespace dev; string ProtoConverter::dictionaryToken(HexPrefix _p) { unsigned indexVar = m_inputSize * m_inputSize + counter(); std::string token = hexDictionary[indexVar % hexDictionary.size()]; yulAssert(token.size() <= 64, "Proto Fuzzer: Dictionary token too large"); return _p == HexPrefix::Add ? "0x" + token : token; } string ProtoConverter::createHex(string const& _hexBytes) { string tmp{_hexBytes}; if (!tmp.empty()) { boost::range::remove_erase_if(tmp, [=](char c) -> bool { return !std::isxdigit(c); }); tmp = tmp.substr(0, 64); } // We need this awkward if case because hex literals cannot be empty. // Use a dictionary token. if (tmp.empty()) tmp = dictionaryToken(HexPrefix::DontAdd); yulAssert(tmp.size() <= 64, "Proto Fuzzer: Dictionary token too large"); return tmp; } string ProtoConverter::createAlphaNum(string const& _strBytes) { string tmp{_strBytes}; if (!tmp.empty()) { boost::range::remove_erase_if(tmp, [=](char c) -> bool { return !(std::isalpha(c) || std::isdigit(c)); }); tmp = tmp.substr(0, 32); } return tmp; } string ProtoConverter::visit(Literal const& _x) { switch (_x.literal_oneof_case()) { case Literal::kIntval: return to_string(_x.intval()); case Literal::kHexval: return "0x" + createHex(_x.hexval()); case Literal::kStrval: return "\"" + createAlphaNum(_x.strval()) + "\""; case Literal::LITERAL_ONEOF_NOT_SET: return dictionaryToken(); } } bool ProtoConverter::varDeclAvailable() { if (m_inFunctionDef) return m_scopeVars.top().size() > 0; else return m_variables.size() > 0; } bool ProtoConverter::functionCallNotPossible(FunctionCall_Returns _type) { return _type == FunctionCall::SINGLE || (_type == FunctionCall::MULTIASSIGN && !varDeclAvailable()); } void ProtoConverter::visit(VarRef const& _x) { if (m_inFunctionDef) { // Ensure that there is at least one variable declaration to reference in function scope. yulAssert(m_scopeVars.top().size() > 0, "Proto fuzzer: No variables to reference."); m_output << m_scopeVars.top()[_x.varnum() % m_scopeVars.top().size()]; } else { // Ensure that there is at least one variable declaration to reference in nested scopes. yulAssert(m_variables.size() > 0, "Proto fuzzer: No variables to reference."); m_output << m_variables[_x.varnum() % m_variables.size()]; } } void ProtoConverter::visit(Expression const& _x) { switch (_x.expr_oneof_case()) { case Expression::kVarref: // If the expression requires a variable reference that we cannot provide // (because there are no variables in scope), we silently output a literal // expression from the optimizer dictionary. if (!varDeclAvailable()) m_output << dictionaryToken(); else visit(_x.varref()); break; case Expression::kCons: m_output << visit(_x.cons()); break; case Expression::kBinop: visit(_x.binop()); break; case Expression::kUnop: visit(_x.unop()); break; case Expression::kTop: visit(_x.top()); break; case Expression::kNop: visit(_x.nop()); break; case Expression::kFuncExpr: // FunctionCall must return a single value, otherwise // we output a trivial expression "1". if (_x.func_expr().ret() == FunctionCall::SINGLE) visit(_x.func_expr()); else m_output << dictionaryToken(); break; case Expression::kLowcall: visit(_x.lowcall()); break; case Expression::kCreate: visit(_x.create()); break; case Expression::EXPR_ONEOF_NOT_SET: m_output << dictionaryToken(); break; } } void ProtoConverter::visit(BinaryOp const& _x) { switch (_x.op()) { case BinaryOp::ADD: m_output << "add"; break; case BinaryOp::SUB: m_output << "sub"; break; case BinaryOp::MUL: m_output << "mul"; break; case BinaryOp::DIV: m_output << "div"; break; case BinaryOp::MOD: m_output << "mod"; break; case BinaryOp::XOR: m_output << "xor"; break; case BinaryOp::AND: m_output << "and"; break; case BinaryOp::OR: m_output << "or"; break; case BinaryOp::EQ: m_output << "eq"; break; case BinaryOp::LT: m_output << "lt"; break; case BinaryOp::GT: m_output << "gt"; break; case BinaryOp::SHR: m_output << "shr"; break; case BinaryOp::SHL: m_output << "shl"; break; case BinaryOp::SAR: m_output << "sar"; break; case BinaryOp::SDIV: m_output << "sdiv"; break; case BinaryOp::SMOD: m_output << "smod"; break; case BinaryOp::EXP: m_output << "exp"; break; case BinaryOp::SLT: m_output << "slt"; break; case BinaryOp::SGT: m_output << "sgt"; break; case BinaryOp::BYTE: m_output << "byte"; break; case BinaryOp::SI: m_output << "signextend"; break; case BinaryOp::KECCAK: m_output << "keccak256"; break; } m_output << "("; visit(_x.left()); m_output << ","; visit(_x.right()); m_output << ")"; } void ProtoConverter::visit(VarDecl const& _x) { string varName = newVarName(); m_output << "let " << varName << " := "; visit(_x.expr()); m_output << "\n"; m_scopeVars.top().push_back(varName); m_variables.push_back(varName); } void ProtoConverter::visit(TypedVarDecl const& _x) { string varName = newVarName(); m_output << "let " << varName; switch (_x.type()) { case TypedVarDecl::BOOL: m_output << ": bool := "; visit(_x.expr()); m_output << " : bool\n"; break; case TypedVarDecl::S8: m_output << ": s8 := "; visit(_x.expr()); m_output << " : s8\n"; break; case TypedVarDecl::S32: m_output << ": s32 := "; visit(_x.expr()); m_output << " : s32\n"; break; case TypedVarDecl::S64: m_output << ": s64 := "; visit(_x.expr()); m_output << " : s64\n"; break; case TypedVarDecl::S128: m_output << ": s128 := "; visit(_x.expr()); m_output << " : s128\n"; break; case TypedVarDecl::S256: m_output << ": s256 := "; visit(_x.expr()); m_output << " : s256\n"; break; case TypedVarDecl::U8: m_output << ": u8 := "; visit(_x.expr()); m_output << " : u8\n"; break; case TypedVarDecl::U32: m_output << ": u32 := "; visit(_x.expr()); m_output << " : u32\n"; break; case TypedVarDecl::U64: m_output << ": u64 := "; visit(_x.expr()); m_output << " : u64\n"; break; case TypedVarDecl::U128: m_output << ": u128 := "; visit(_x.expr()); m_output << " : u128\n"; break; case TypedVarDecl::U256: m_output << ": u256 := "; visit(_x.expr()); m_output << " : u256\n"; break; } m_scopeVars.top().push_back(varName); m_variables.push_back(varName); } void ProtoConverter::visit(UnaryOp const& _x) { switch (_x.op()) { case UnaryOp::NOT: m_output << "not"; break; case UnaryOp::MLOAD: m_output << "mload"; break; case UnaryOp::SLOAD: m_output << "sload"; break; case UnaryOp::ISZERO: m_output << "iszero"; break; case UnaryOp::CALLDATALOAD: m_output << "calldataload"; break; case UnaryOp::EXTCODESIZE: m_output << "extcodesize"; break; case UnaryOp::EXTCODEHASH: m_output << "extcodehash"; break; case UnaryOp::BALANCE: m_output << "balance"; break; case UnaryOp::BLOCKHASH: m_output << "blockhash"; break; } m_output << "("; visit(_x.operand()); m_output << ")"; } void ProtoConverter::visit(TernaryOp const& _x) { switch (_x.op()) { case TernaryOp::ADDM: m_output << "addmod"; break; case TernaryOp::MULM: m_output << "mulmod"; break; } m_output << "("; visit(_x.arg1()); m_output << ", "; visit(_x.arg2()); m_output << ", "; visit(_x.arg3()); m_output << ")"; } void ProtoConverter::visit(NullaryOp const& _x) { switch (_x.op()) { case NullaryOp::PC: m_output << "pc()"; break; case NullaryOp::MSIZE: m_output << "msize()"; break; case NullaryOp::GAS: m_output << "gas()"; break; case NullaryOp::CALLDATASIZE: m_output << "calldatasize()"; break; case NullaryOp::CODESIZE: m_output << "codesize()"; break; case NullaryOp::RETURNDATASIZE: m_output << "returndatasize()"; break; case NullaryOp::ADDRESS: m_output << "address()"; break; case NullaryOp::ORIGIN: m_output << "origin()"; break; case NullaryOp::CALLER: m_output << "caller()"; break; case NullaryOp::CALLVALUE: m_output << "callvalue()"; break; case NullaryOp::GASPRICE: m_output << "gasprice()"; break; case NullaryOp::COINBASE: m_output << "coinbase()"; break; case NullaryOp::TIMESTAMP: m_output << "timestamp()"; break; case NullaryOp::NUMBER: m_output << "number()"; break; case NullaryOp::DIFFICULTY: m_output << "difficulty()"; break; case NullaryOp::GASLIMIT: m_output << "gaslimit()"; break; } } void ProtoConverter::visit(CopyFunc const& _x) { switch (_x.ct()) { case CopyFunc::CALLDATA: m_output << "calldatacopy"; break; case CopyFunc::CODE: m_output << "codecopy"; break; case CopyFunc::RETURNDATA: m_output << "returndatacopy"; break; } m_output << "("; visit(_x.target()); m_output << ", "; visit(_x.source()); m_output << ", "; visit(_x.size()); m_output << ")\n"; } void ProtoConverter::visit(ExtCodeCopy const& _x) { m_output << "extcodecopy"; m_output << "("; visit(_x.addr()); m_output << ", "; visit(_x.target()); m_output << ", "; visit(_x.source()); m_output << ", "; visit(_x.size()); m_output << ")\n"; } void ProtoConverter::visit(LogFunc const& _x) { switch (_x.num_topics()) { case LogFunc::ZERO: m_output << "log0"; m_output << "("; visit(_x.pos()); m_output << ", "; visit(_x.size()); m_output << ")\n"; break; case LogFunc::ONE: m_output << "log1"; m_output << "("; visit(_x.pos()); m_output << ", "; visit(_x.size()); m_output << ", "; visit(_x.t1()); m_output << ")\n"; break; case LogFunc::TWO: m_output << "log2"; m_output << "("; visit(_x.pos()); m_output << ", "; visit(_x.size()); m_output << ", "; visit(_x.t1()); m_output << ", "; visit(_x.t2()); m_output << ")\n"; break; case LogFunc::THREE: m_output << "log3"; m_output << "("; visit(_x.pos()); m_output << ", "; visit(_x.size()); m_output << ", "; visit(_x.t1()); m_output << ", "; visit(_x.t2()); m_output << ", "; visit(_x.t3()); m_output << ")\n"; break; case LogFunc::FOUR: m_output << "log4"; m_output << "("; visit(_x.pos()); m_output << ", "; visit(_x.size()); m_output << ", "; visit(_x.t1()); m_output << ", "; visit(_x.t2()); m_output << ", "; visit(_x.t3()); m_output << ", "; visit(_x.t4()); m_output << ")\n"; break; } } void ProtoConverter::visit(AssignmentStatement const& _x) { visit(_x.ref_id()); m_output << " := "; visit(_x.expr()); m_output << "\n"; } void ProtoConverter::visitFunctionInputParams(FunctionCall const& _x, unsigned _numInputParams) { // We reverse the order of function input visits since it helps keep this switch case concise. switch (_numInputParams) { case 4: visit(_x.in_param4()); m_output << ", "; BOOST_FALLTHROUGH; case 3: visit(_x.in_param3()); m_output << ", "; BOOST_FALLTHROUGH; case 2: visit(_x.in_param2()); m_output << ", "; BOOST_FALLTHROUGH; case 1: visit(_x.in_param1()); BOOST_FALLTHROUGH; case 0: break; default: yulAssert(false, "Proto fuzzer: Function call with too many input parameters."); break; } } bool ProtoConverter::functionValid(FunctionCall_Returns _type, unsigned _numOutParams) { switch (_type) { case FunctionCall::ZERO: return _numOutParams == 0; case FunctionCall::SINGLE: return _numOutParams == 1; case FunctionCall::MULTIDECL: case FunctionCall::MULTIASSIGN: return _numOutParams > 1; } } void ProtoConverter::convertFunctionCall( FunctionCall const& _x, std::string _name, unsigned _numInParams, bool _newLine ) { m_output << _name << "("; visitFunctionInputParams(_x, _numInParams); m_output << ")"; if (_newLine) m_output << "\n"; } vector ProtoConverter::createVarDecls(unsigned _start, unsigned _end, bool _isAssignment) { m_output << "let "; vector varsVec = createVars(_start, _end); if (_isAssignment) m_output << " := "; else m_output << "\n"; return varsVec; } void ProtoConverter::visit(FunctionCall const& _x) { bool functionAvailable = m_functionSigMap.size() > 0; unsigned numInParams, numOutParams; string funcName; FunctionCall_Returns funcType = _x.ret(); if (functionAvailable) { yulAssert(m_functions.size() > 0, "Proto fuzzer: No function in scope"); funcName = m_functions[_x.func_index() % m_functions.size()]; auto ret = m_functionSigMap.at(funcName); numInParams = ret.first; numOutParams = ret.second; } else { // If there are no functions available, calls to functions that // return a single value may be replaced by a dictionary token. if (funcType == FunctionCall::SINGLE) m_output << dictionaryToken(); return; } // If function selected for function call does not meet interface // requirements (num output values) for the function type // specified, then we return early unless it is a function call // that returns a single value (which may be replaced by a // dictionary token. if (!functionValid(funcType, numOutParams)) { if (funcType == FunctionCall::SINGLE) m_output << dictionaryToken(); return; } // If we are here, it means that we have at least one valid // function for making the function call switch (funcType) { case FunctionCall::ZERO: convertFunctionCall(_x, funcName, numInParams); break; case FunctionCall::SINGLE: // Since functions that return a single value are used as expressions // we do not print a newline because it is done by the expression // visitor. convertFunctionCall(_x, funcName, numInParams, /*newLine=*/false); break; case FunctionCall::MULTIDECL: // Hack: Disallow (multi) variable declarations until scope extension // is implemented for "for-init" if (!m_inForInitScope) { // Ensure that the chosen function returns at most 4 values yulAssert( numOutParams <= 4, "Proto fuzzer: Function call with too many output params encountered." ); // Obtain variable name suffix unsigned startIdx = counter(); vector varsVec = createVarDecls( startIdx, startIdx + numOutParams, /*isAssignment=*/true ); // Create RHS of multi var decl convertFunctionCall(_x, funcName, numInParams); // Add newly minted vars in the multidecl statement to current scope addVarsToScope(varsVec); } break; case FunctionCall::MULTIASSIGN: // Ensure that the chosen function returns at most 4 values yulAssert( numOutParams <= 4, "Proto fuzzer: Function call with too many output params encountered." ); // Convert LHS of multi assignment // We reverse the order of out param visits since the order does not matter. // This helps reduce the size of this switch statement. switch (numOutParams) { case 4: visit(_x.out_param4()); m_output << ", "; BOOST_FALLTHROUGH; case 3: visit(_x.out_param3()); m_output << ", "; BOOST_FALLTHROUGH; case 2: visit(_x.out_param2()); m_output << ", "; visit(_x.out_param1()); break; default: yulAssert(false, "Proto fuzzer: Function call with too many or too few input parameters."); break; } m_output << " := "; // Convert RHS of multi assignment convertFunctionCall(_x, funcName, numInParams); break; } } void ProtoConverter::visit(LowLevelCall const& _x) { LowLevelCall_Type type = _x.callty(); switch (type) { case LowLevelCall::CALL: m_output << "call("; break; case LowLevelCall::CALLCODE: m_output << "callcode("; break; case LowLevelCall::DELEGATECALL: m_output << "delegatecall("; break; case LowLevelCall::STATICCALL: m_output << "staticcall("; break; } visit(_x.gas()); m_output << ", "; visit(_x.addr()); m_output << ", "; if (type == LowLevelCall::CALL || LowLevelCall::CALLCODE) { visit(_x.wei()); m_output << ", "; } visit(_x.in()); m_output << ", "; visit(_x.insize()); m_output << ", "; visit(_x.out()); m_output << ", "; visit(_x.outsize()); m_output << ")"; } void ProtoConverter::visit(Create const& _x) { Create_Type type = _x.createty(); switch (type) { case Create::CREATE: m_output << "create("; break; case Create::CREATE2: m_output << "create2("; break; } visit(_x.wei()); m_output << ", "; visit(_x.position()); m_output << ", "; visit(_x.size()); if (type == Create::CREATE2) { m_output << ", "; visit(_x.value()); } m_output << ")"; } void ProtoConverter::visit(IfStmt const& _x) { m_output << "if "; visit(_x.cond()); m_output << " "; visit(_x.if_body()); } void ProtoConverter::visit(StoreFunc const& _x) { switch (_x.st()) { case StoreFunc::MSTORE: m_output << "mstore("; break; case StoreFunc::SSTORE: m_output << "sstore("; break; case StoreFunc::MSTORE8: m_output << "mstore8("; break; } visit(_x.loc()); m_output << ", "; visit(_x.val()); m_output << ")\n"; } void ProtoConverter::visit(ForStmt const& _x) { bool wasInForBody = m_inForBodyScope; bool wasInForInit = m_inForInitScope; m_inForBodyScope = false; m_inForInitScope = true; m_output << "for "; visit(_x.for_init()); m_inForInitScope = false; visit(_x.for_cond()); visit(_x.for_post()); m_inForBodyScope = true; visit(_x.for_body()); m_inForBodyScope = wasInForBody; m_inForInitScope = wasInForInit; } void ProtoConverter::visit(BoundedForStmt const& _x) { // Boilerplate for loop that limits the number of iterations to a maximum of 4. std::string loopVarName("i_" + std::to_string(m_numNestedForLoops++)); m_output << "for { let " << loopVarName << " := 0 } " << "lt(" << loopVarName << ", 0x60) " << "{ " << loopVarName << " := add(" << loopVarName << ", 0x20) } "; // Store previous for body scope bool wasInForBody = m_inForBodyScope; bool wasInForInit = m_inForInitScope; m_inForBodyScope = true; m_inForInitScope = false; visit(_x.for_body()); // Restore previous for body scope and init m_inForBodyScope = wasInForBody; m_inForInitScope = wasInForInit; } void ProtoConverter::visit(CaseStmt const& _x) { string literal = visit(_x.case_lit()); // u256 value of literal u256 literalVal; // Convert string to u256 before looking for duplicate case literals if (_x.case_lit().has_strval()) { // Since string literals returned by the Literal visitor are enclosed within // double quotes (like this "\"\""), their size is at least two in the worst case // that is empty. Here we assert this invariant. yulAssert(literal.size() >= 2, "Proto fuzzer: String literal too short"); // This variable stores the part i.e., literal minus the first and last // double quote characters. This is used to compute the keccak256 hash of the // string literal. The hashing is done to check whether we are about to create // a case statement containing a case literal that has already been used in a // previous case statement. If the hash (u256 value) matches a previous hash, // then we simply don't create a new case statement. string noDoubleQuoteStr{""}; if (literal.size() > 2) { // Ensure that all characters in the string literal except the first // and the last (double quote characters) are alphanumeric. yulAssert( boost::algorithm::all_of(literal.begin() + 1, literal.end() - 2, [=](char c) -> bool { return std::isalpha(c) || std::isdigit(c); }), "Proto fuzzer: Invalid string literal encountered" ); // Make a copy because literal will need to be used later noDoubleQuoteStr = literal.substr(1, literal.size() - 2); } // Hash the result to check for duplicate case literal strings literalVal = u256(h256(noDoubleQuoteStr, h256::FromBinary, h256::AlignLeft)); // Make sure that an empty string literal evaluates to zero. This is to detect creation of // duplicate case literals like so // switch (x) // { // case "": { x := 0 } // case 0: { x:= 1 } // Case statement with duplicate literal is invalid // } // This snippet will not be parsed successfully. if (noDoubleQuoteStr.empty()) yulAssert(literalVal == 0, "Proto fuzzer: Empty string does not evaluate to zero"); } else literalVal = u256(literal); // Check if set insertion fails (case literal present) or succeeds (case literal // absent). bool isUnique = m_switchLiteralSetPerScope.top().insert(literalVal).second; // It is fine to bail out if we encounter a duplicate case literal because // we can be assured that the switch statement is well-formed i.e., contains // at least one case statement or a default block. if (isUnique) { m_output << "case " << literal << " "; visit(_x.case_block()); } } void ProtoConverter::visit(SwitchStmt const& _x) { if (_x.case_stmt_size() > 0 || _x.has_default_block()) { std::set s; m_switchLiteralSetPerScope.push(s); m_output << "switch "; visit(_x.switch_expr()); m_output << "\n"; for (auto const& caseStmt: _x.case_stmt()) visit(caseStmt); m_switchLiteralSetPerScope.pop(); if (_x.has_default_block()) { m_output << "default "; visit(_x.default_block()); } } } void ProtoConverter::visit(StopInvalidStmt const& _x) { switch (_x.stmt()) { case StopInvalidStmt::STOP: m_output << "stop()\n"; break; case StopInvalidStmt::INVALID: m_output << "invalid()\n"; break; } } void ProtoConverter::visit(RetRevStmt const& _x) { switch (_x.stmt()) { case RetRevStmt::RETURN: m_output << "return"; break; case RetRevStmt::REVERT: m_output << "revert"; break; } m_output << "("; visit(_x.pos()); m_output << ", "; visit(_x.size()); m_output << ")\n"; } void ProtoConverter::visit(SelfDestructStmt const& _x) { m_output << "selfdestruct"; m_output << "("; visit(_x.addr()); m_output << ")\n"; } void ProtoConverter::visit(TerminatingStmt const& _x) { switch (_x.term_oneof_case()) { case TerminatingStmt::kStopInvalid: visit(_x.stop_invalid()); break; case TerminatingStmt::kRetRev: visit(_x.ret_rev()); break; case TerminatingStmt::kSelfDes: visit(_x.self_des()); break; case TerminatingStmt::TERM_ONEOF_NOT_SET: break; } } void ProtoConverter::visit(Statement const& _x) { switch (_x.stmt_oneof_case()) { case Statement::kDecl: // Hack: Disallow (multi) variable declarations until scope extension is implemented for "for-init" if (!m_inForInitScope) visit(_x.decl()); break; case Statement::kAssignment: // Create an assignment statement only if there is at least one variable // declaration that is in scope. if (varDeclAvailable()) visit(_x.assignment()); break; case Statement::kIfstmt: visit(_x.ifstmt()); break; case Statement::kStorageFunc: visit(_x.storage_func()); break; case Statement::kBlockstmt: visit(_x.blockstmt()); break; case Statement::kForstmt: visit(_x.forstmt()); break; case Statement::kBoundedforstmt: visit(_x.boundedforstmt()); break; case Statement::kSwitchstmt: visit(_x.switchstmt()); break; case Statement::kBreakstmt: if (m_inForBodyScope) m_output << "break\n"; break; case Statement::kContstmt: if (m_inForBodyScope) m_output << "continue\n"; break; case Statement::kLogFunc: visit(_x.log_func()); break; case Statement::kCopyFunc: visit(_x.copy_func()); break; case Statement::kExtcodeCopy: visit(_x.extcode_copy()); break; case Statement::kTerminatestmt: visit(_x.terminatestmt()); break; case Statement::kFunctioncall: // Return early if a function call cannot be created if (functionCallNotPossible(_x.functioncall().ret())) return; visit(_x.functioncall()); break; case Statement::kFuncdef: if (!m_inForInitScope) visit(_x.funcdef()); break; case Statement::kPop: visit(_x.pop()); break; case Statement::STMT_ONEOF_NOT_SET: break; } } void ProtoConverter::openScope(vector const& _funcParams) { m_scopeVars.push({}); m_scopeFuncs.push({}); if (!_funcParams.empty()) addVarsToScope(_funcParams); } void ProtoConverter::updateFunctionMaps(string const& _var) { unsigned erased = m_functionSigMap.erase(_var); for (auto const& i: m_functionDefMap) if (i.second == _var) { erased += m_functionDefMap.erase(i.first); break; } yulAssert(erased == 2, "Proto fuzzer: Function maps not updated"); } void ProtoConverter::closeScope() { for (auto const& var: m_scopeVars.top()) { unsigned numVarsRemoved = m_variables.size(); m_variables.erase(remove(m_variables.begin(), m_variables.end(), var), m_variables.end()); numVarsRemoved -= m_variables.size(); yulAssert( numVarsRemoved == 1, "Proto fuzzer: Nothing or too much went out of scope" ); } m_scopeVars.pop(); for (auto const& f: m_scopeFuncs.top()) { unsigned numFuncsRemoved = m_functions.size(); m_functions.erase(remove(m_functions.begin(), m_functions.end(), f), m_functions.end()); numFuncsRemoved -= m_functions.size(); yulAssert( numFuncsRemoved == 1, "Proto fuzzer: Nothing or too much went out of scope" ); updateFunctionMaps(f); } m_scopeFuncs.pop(); } void ProtoConverter::addVarsToScope(vector const& _vars) { for (string const& i: _vars) { m_variables.push_back(i); m_scopeVars.top().push_back(i); } } void ProtoConverter::visit(Block const& _x, vector _funcParams) { openScope(_funcParams); // Register function declarations in this scope unless this // scope belongs to for-init (in which function declarations // are forbidden). for (auto const& statement: _x.statements()) if (statement.has_funcdef() && !m_inForInitScope) registerFunction(&statement.funcdef()); if (_x.statements_size() > 0) { m_output << "{\n"; for (auto const& st: _x.statements()) visit(st); m_output << "}\n"; } else m_output << "{}\n"; closeScope(); } vector ProtoConverter::createVars(unsigned _startIdx, unsigned _endIdx) { yulAssert(_endIdx > _startIdx, "Proto fuzzer: Variable indices not in range"); string varsStr = dev::suffixedVariableNameList("x_", _startIdx, _endIdx); m_output << varsStr; vector varsVec; boost::split( varsVec, varsStr, boost::algorithm::is_any_of(", "), boost::algorithm::token_compress_on ); yulAssert( varsVec.size() == (_endIdx - _startIdx), "Proto fuzzer: Variable count mismatch during function definition" ); m_counter += varsVec.size(); return varsVec; } void ProtoConverter::registerFunction(FunctionDef const* _x) { unsigned numInParams = _x->num_input_params() % s_modInputParams; unsigned numOutParams = _x->num_output_params() % s_modOutputParams; NumFunctionReturns numReturns; if (numOutParams == 0) numReturns = NumFunctionReturns::None; else if (numOutParams == 1) numReturns = NumFunctionReturns::Single; else numReturns = NumFunctionReturns::Multiple; // Generate function name string funcName = functionName(numReturns); // Register function auto ret = m_functionSigMap.emplace(make_pair(funcName, make_pair(numInParams, numOutParams))); yulAssert(ret.second, "Proto fuzzer: Function already exists."); m_functions.push_back(funcName); m_scopeFuncs.top().push_back(funcName); m_functionDefMap.emplace(make_pair(_x, funcName)); } void ProtoConverter::fillFunctionCallInput(unsigned _numInParams) { for (unsigned i = 0; i < _numInParams; i++) { // Throw a 4-sided dice to choose whether to populate function input // argument from a pseudo-randomly chosen slot in one of the following // locations: calldata, memory, storage, or yul optimizer dictionary. unsigned diceValue = counter() % 4; // Pseudo-randomly choose one of the first ten 32-byte // aligned slots. string slot = to_string((counter() % 10) * 32); switch (diceValue) { case 0: m_output << "calldataload(" << slot << ")"; break; case 1: m_output << "mload(" << slot << ")"; break; case 2: m_output << "sload(" << slot << ")"; break; case 3: // Call to dictionaryToken() automatically picks a token // at a pseudo-random location. m_output << dictionaryToken(); break; } if (i < _numInParams - 1) m_output << ","; } } void ProtoConverter::saveFunctionCallOutput(vector const& _varsVec) { for (auto const& var: _varsVec) { // Flip a dice to choose whether to save output values // in storage or memory. bool coinFlip = counter() % 2 == 0; // Pseudo-randomly choose one of the first ten 32-byte // aligned slots. string slot = to_string((counter() % 10) * 32); if (coinFlip) m_output << "sstore(" << slot << ", " << var << ")\n"; else m_output << "mstore(" << slot << ", " << var << ")\n"; } } void ProtoConverter::createFunctionCall( string _funcName, unsigned _numInParams, unsigned _numOutParams ) { vector varsVec{}; if (_numOutParams > 0) { unsigned startIdx = counter(); // Prints the following to output stream "let x_i,...,x_n := " varsVec = createVarDecls( startIdx, startIdx + _numOutParams, /*isAssignment=*/true ); } // Call the function with the correct number of input parameters m_output << _funcName << "("; if (_numInParams > 0) fillFunctionCallInput(_numInParams); m_output << ")\n"; if (!varsVec.empty()) { // Save values returned by function so that they are reflected // in the interpreter trace. saveFunctionCallOutput(varsVec); // Add newly minted vars to current scope addVarsToScope(varsVec); } else yulAssert(_numOutParams == 0, "Proto fuzzer: Function return value not saved"); } void ProtoConverter::createFunctionDefAndCall( FunctionDef const& _x, unsigned _numInParams, unsigned _numOutParams ) { yulAssert( ((_numInParams <= s_modInputParams - 1) && (_numOutParams <= s_modOutputParams - 1)), "Proto fuzzer: Too many function I/O parameters requested." ); // Obtain function name yulAssert(m_functionDefMap.count(&_x), "Proto fuzzer: Unregistered function"); string funcName = m_functionDefMap.at(&_x); vector varsVec = {}; m_output << "function " << funcName << "("; unsigned startIdx = counter(); if (_numInParams > 0) varsVec = createVars(startIdx, startIdx + _numInParams); m_output << ")"; vector outVarsVec = {}; // This creates -> x_n+1,...,x_r if (_numOutParams > 0) { m_output << " -> "; if (varsVec.empty()) { yulAssert(_numInParams == 0, "Proto fuzzer: Input parameters not processed correctly"); varsVec = createVars(startIdx, startIdx + _numOutParams); } else { outVarsVec = createVars(startIdx + _numInParams, startIdx + _numInParams + _numOutParams); varsVec.insert(varsVec.end(), outVarsVec.begin(), outVarsVec.end()); } } yulAssert(varsVec.size() == _numInParams + _numOutParams, "Proto fuzzer: Function parameters not processed correctly"); m_output << "\n"; // If function definition is in for-loop body, update bool wasInForBody = m_inForBodyScope; m_inForBodyScope = false; bool wasInFunctionDef = m_inFunctionDef; m_inFunctionDef = true; // Body visit(_x.block(), varsVec); m_inForBodyScope = wasInForBody; m_inFunctionDef = wasInFunctionDef; yulAssert( !m_inForInitScope, "Proto fuzzer: Trying to create function call inside for-init block" ); createFunctionCall(funcName, _numInParams, _numOutParams); } void ProtoConverter::visit(FunctionDef const& _x) { unsigned numInParams = _x.num_input_params() % s_modInputParams; unsigned numOutParams = _x.num_output_params() % s_modOutputParams; createFunctionDefAndCall(_x, numInParams, numOutParams); } void ProtoConverter::visit(PopStmt const& _x) { m_output << "pop("; visit(_x.expr()); m_output << ")\n"; } void ProtoConverter::visit(Program const& _x) { // Initialize input size m_inputSize = _x.ByteSizeLong(); /* Program template is as follows * Zero or more statements. If function definition is present, it is * called post definition. * Example: function foo(x_0) -> x_1 {} * x_2 := foo(calldataload(0)) * sstore(0, x_2) */ m_output << "{\n"; visit(_x.block()); m_output << "}\n"; } string ProtoConverter::programToString(Program const& _input) { visit(_input); return m_output.str(); } std::string ProtoConverter::functionTypeToString(NumFunctionReturns _type) { switch (_type) { case NumFunctionReturns::None: return "n"; case NumFunctionReturns::Single: return "s"; case NumFunctionReturns::Multiple: return "m"; } }